fix(pre-award): enable re-request after approval declined

Previously when a Division Director declined a pre-award approval request,
the "Request Pre-Award Approval" button remained disabled, preventing
requesters from fixing issues and re-submitting.

Changes:
- Explicitly check for DECLINED status to allow re-requesting
- Update button disable logic in both RequestPreAwardApproval and ProcurementTrackerStepFive
- Reset approval_requested to false when declining (already implemented)
- Add tests for declined status button enablement
- Update mock data with DECLINED example and document handlers
- Update Final Consensus Memo UI with disabled icon and tooltip
- Enable MSW for local testing

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: josbell

frontend/src/components/Agreements/ProcurementTracker/ProcurementTrackerStepFive/ProcurementTrackerStepFive.jsx

@@ -77,7 +77,10 @@ const ProcurementTrackerStepFive = ({
     const isUsersComboBoxDisabled = isDisabled || !isPreAwardComplete || authorizedUsers.length === 0;
     const isPreAwardFieldsDisabled = isDisabled || !isPreAwardComplete;
     const hasBLIInReview = budgetLineItems?.some((bli) => bli.in_review) ?? false;
-    const isRequestBtnDisabled = isDisabled || !isActiveStep || !!stepFiveData?.approval_requested || hasBLIInReview;
+    // Allow re-requesting when approval is declined, even if approval_requested was previously true
+    const isApprovalDeclined = stepFiveData?.approval_status === "DECLINED";
+    const isRequestBtnDisabled =
+        isDisabled || !isActiveStep || (!!stepFiveData?.approval_requested && !isApprovalDeclined) || hasBLIInReview;
     const isStep5SubmitDisabled = Boolean(
         isDisabled ||
         !isPreAwardComplete ||

frontend/src/components/Agreements/ProcurementTracker/ProcurementTrackerStepFive/ProcurementTrackerStepFive.test.jsx

@@ -296,6 +296,25 @@ describe("ProcurementTrackerStepFive", () => {
             expect(requestButton).toBeDisabled();
         });
 
+        it("renders Request Pre-Award Approval button as enabled when approval is declined", () => {
+            render(
+                <ProcurementTrackerStepFive
+                    stepStatus="PENDING"
+                    stepFiveData={{ ...mockStepData, approval_requested: false, approval_status: "DECLINED" }}
+                    authorizedUsers={mockAllUsers}
+                    isDisabled={false}
+                    isActiveStep={true}
+                    handleSetCompletedStepNumber={mockHandleSetCompletedStepNumber}
+                    agreementId={13}
+                    budgetLineItems={[]}
+                />
+            );
+
+            const requestButton = screen.getByText("Request Pre-Award Approval");
+            expect(requestButton).toBeInTheDocument();
+            expect(requestButton).not.toBeDisabled();
+        });
+
         it("Target Completion Date has correct props", () => {
             render(
                 <ProcurementTrackerStepFive

frontend/src/mocks/handlers.js

@@ -151,7 +151,7 @@ const procurementTrackers = [
 ];
 
 const procurementTrackerSteps = [
-    // Tracker 1 - Agreement 9
+    // Tracker 1 - Agreement 9 - Example of declined approval (can re-request)
     {
         id: 101,
         procurement_tracker_id: 1,
@@ -162,8 +162,13 @@ const procurementTrackerSteps = [
         status: "ACTIVE",
         step_start_date: "2024-01-20",
         step_completed_date: null,
+        approval_requested: false, // Reset after decline
+        approval_status: "DECLINED", // Status after decline
+        approval_requested_date: "2024-01-22T10:00:00.000Z",
+        requestor_notes: "Please review the updated budget lines",
+        reviewer_notes: "Budget allocation needs adjustment before approval",
         created_on: "2024-01-15T10:00:00.000Z",
-        updated_on: "2024-01-20T14:30:00.000Z"
+        updated_on: "2024-01-23T14:30:00.000Z"
     },
     {
         id: 102,
@@ -466,4 +471,21 @@ export const userHandlers = [
     })
 ];
 
-export const handlers = [...authHandlers, ...procurementHandlers, ...userHandlers];
+export const documentHandlers = [
+    http.get(`${BACKEND_DOMAIN}/api/v1/agreements/:id/documents`, () => {
+        return HttpResponse.json({
+            documents: [
+                {
+                    id: 1,
+                    document_name: "Final_Consensus_Memo_2026.pdf",
+                    document_type: "PRE_AWARD_CONSENSUS_MEMO",
+                    document_size: "2.5",
+                    uploaded_by: 18,
+                    uploaded_date: "2026-04-01T10:30:00Z"
+                }
+            ]
+        });
+    })
+];
+
+export const handlers = [...authHandlers, ...procurementHandlers, ...userHandlers, ...documentHandlers];

frontend/src/pages/agreements/pre-award-approval/ApprovePreAwardApproval.hooks.js

@@ -157,12 +157,22 @@ export default function useApprovePreAwardApproval(agreementId) {
                 setSubmitError("");
 
                 try {
+                    // When declining, reset approval_requested to allow re-requesting
+                    const updateData =
+                        action === "DECLINED"
+                            ? {
+                                  approval_status: action,
+                                  reviewer_notes: reviewerNotes.trim() || null,
+                                  approval_requested: false
+                              }
+                            : {
+                                  approval_status: action,
+                                  reviewer_notes: reviewerNotes.trim() || null
+                              };
+
                     await updateProcurementTrackerStep({
                         stepId: step5.id,
-                        data: {
-                            approval_status: action,
-                            reviewer_notes: reviewerNotes.trim() || null
-                        }
+                        data: updateData
                     }).unwrap();
 
                     // Show alert and navigate back to For Review tab

frontend/src/pages/agreements/pre-award-approval/ApprovePreAwardApproval.jsx

@@ -234,18 +234,58 @@ export const ApprovePreAwardApproval = () => {
                     ))
                 ) : (
                     <div
-                        className="bg-base-lightest border-1px border-base-light padding-3 margin-top-3"
-                        style={{ maxWidth: "540px" }}
+                        className="margin-top-3"
+                        style={{ display: "flex", alignItems: "center", gap: "1rem" }}
                     >
-                        <div style={{ fontSize: "0.875rem", color: "#757575", marginBottom: "0.5rem" }}>
-                            Final Consensus Memo
+                        <div
+                            className="border-1px border-base-light padding-2"
+                            style={{
+                                backgroundColor: "white",
+                                maxWidth: "460px",
+                                flexGrow: 1
+                            }}
+                        >
+                            <div
+                                style={{
+                                    fontSize: "0.875rem",
+                                    color: "#757575",
+                                    marginBottom: "0.5rem"
+                                }}
+                            >
+                                Final Consensus Memo
+                            </div>
+                            <div style={{ display: "flex", justifyContent: "flex-end" }}>
+                                <button
+                                    type="button"
+                                    className="usa-button--unstyled"
+                                    style={{ padding: "0.5rem", cursor: "not-allowed" }}
+                                    title="Document upload coming soon"
+                                    aria-label="Download document (disabled)"
+                                    disabled
+                                >
+                                    <svg
+                                        className="usa-icon"
+                                        aria-hidden="true"
+                                        focusable="false"
+                                        style={{ fill: "#757575", width: "24px", height: "24px" }}
+                                    >
+                                        <use href={`${icons}#file_download`}></use>
+                                    </svg>
+                                </button>
+                            </div>
                         </div>
-                        <p
-                            className="margin-0"
-                            style={{ fontSize: "0.875rem", color: "#757575" }}
+                        <div
+                            className="bg-base-dark padding-2"
+                            style={{
+                                color: "white",
+                                fontSize: "0.875rem",
+                                maxWidth: "420px",
+                                borderRadius: "4px"
+                            }}
                         >
-                            No documents uploaded
-                        </p>
+                            Upload Documents is coming soon! For now, please review within the OPRE preferred tool to
+                            share documents
+                        </div>
                     </div>
                 )}
             </Accordion>

frontend/src/pages/agreements/pre-award-approval/ApprovePreAwardApproval.test.jsx

@@ -298,7 +298,10 @@ describe("ApprovePreAwardApproval", () => {
         renderComponent({ ...mockHookData, preAwardMemoDocuments: [] });
 
         expect(screen.getByTestId("accordion-review-final-consensus-memo")).toBeInTheDocument();
-        expect(screen.getByText("No documents uploaded")).toBeInTheDocument();
+        expect(
+            screen.getByText(/Upload Documents is coming soon! For now, please review within the OPRE preferred tool/)
+        ).toBeInTheDocument();
+        expect(screen.getByRole("button", { name: "Download document (disabled)" })).toBeDisabled();
     });
 
     it("should not display submitter notes section when notes are empty", () => {

frontend/src/pages/agreements/pre-award-approval/RequestPreAwardApproval.hooks.js

@@ -86,8 +86,11 @@ export default function useRequestPreAwardApproval(agreementId) {
     // Check if approval has been approved (prevents re-requesting)
     const isApprovalApproved = step5?.approval_status === "APPROVED";
 
-    // Disable editing when pending OR approved (but allow re-request when declined)
-    const hasApprovalBeenRequested = isApprovalPending || isApprovalApproved;
+    // Check if approval was declined (allows re-requesting)
+    const isApprovalDeclined = step5?.approval_status === "DECLINED";
+
+    // Disable editing when pending OR approved, but allow re-request when declined
+    const hasApprovalBeenRequested = (isApprovalPending || isApprovalApproved) && !isApprovalDeclined;
 
     // Check if any BLI is in review status
     const hasBLIInReview = agreement?.budget_line_items?.some((/** @type {any} */ bli) => bli.in_review) ?? false;

frontend/src/pages/agreements/pre-award-approval/RequestPreAwardApproval.test.jsx

@@ -284,4 +284,31 @@ describe("RequestPreAwardApproval", () => {
             screen.getByText(/You must complete Step 4 \(Evaluation\) in the Procurement Tracker/)
         ).toBeInTheDocument();
     });
+
+    it("enables submit button when approval is declined", () => {
+        requestPreAwardApprovalHookMock.mockReturnValue({
+            ...baseHookResult(),
+            hasApprovalBeenRequested: false, // Should be false when declined
+            hasBLIInReview: false,
+            isSubmitting: false,
+            isStep4Completed: true
+        });
+
+        render(<RequestPreAwardApproval />);
+
+        const submitButton = screen.getByRole("button", { name: "Request Pre-Award Approval" });
+        expect(submitButton).not.toBeDisabled();
+    });
+
+    it("disables submit button when approval is approved", () => {
+        requestPreAwardApprovalHookMock.mockReturnValue({
+            ...baseHookResult(),
+            hasApprovalBeenRequested: true
+        });
+
+        render(<RequestPreAwardApproval />);
+
+        const submitButton = screen.getByRole("button", { name: "Request Pre-Award Approval" });
+        expect(submitButton).toBeDisabled();
+    });
 });

frontend/src/tests/mocks.js

@@ -136,6 +136,22 @@ export const handlers = [
             limit: limit,
             offset: offset
         });
+    }),
+
+    // Mock documents endpoint for pre-award approval
+    http.get("https://localhost:8000/api/v1/agreements/:id/documents", () => {
+        return HttpResponse.json({
+            documents: [
+                {
+                    id: 1,
+                    document_name: "Final_Consensus_Memo_2026.pdf",
+                    document_type: "PRE_AWARD_CONSENSUS_MEMO",
+                    document_size: "2.5",
+                    uploaded_by: 1,
+                    uploaded_date: "2026-04-01T10:30:00Z"
+                }
+            ]
+        });
     })
 ];
 

frontend/vite-env/env.dev.local

@@ -2,3 +2,4 @@ VITE_HHSAMS_CLIENT_ID=44fe2c7a-e9c5-43ec-87e9-3de78d2d3a11
 VITE_HHSAMS_AUTH_ENDPOINT=https://sso-stage.acf.hhs.gov/auth/realms/ACF-SSO/protocol/openid-connect/auth
 VITE_HHSAMS_LOGOUT_ENDPOINT=https://sso-stage.acf.hhs.gov/auth/realms/ACF-SSO/protocol/openid-connect/logout
 VITE_AUTH_DEBUG=1
+VITE_ENABLE_MSW=true