sdac-get-analysis-packet

Purpose

Retrieves the precomputed report analysis packet for a cost report. The Coordinator Release Agent should call this before raw validation tools for broad review prompts.

Tool type

Database retrieval

Tool ID

sdac-get-analysis-packet

Inputs

• report_id (string, required) -- Cost report identifier.
• sections (string[], optional) -- Limits returned analysis sections by name match.
• include_raw (boolean, optional, default: false) -- Includes raw ResultJson payloads.
• for_conversation (boolean, optional, default: true) -- Applies conversational visibility filtering.
• start_if_missing (boolean, optional, default: true) -- Starts the workflow when no packet is available.

Outputs

• report_id
• success
• status
• packet
• summary
• execution_time_ms

Example output

{
  "report_id": "SDAC-2024-Q2-001",
  "success": true,
  "status": "completed",
  "packet": {
    "report": {
      "district_name": "Example R-II School District",
      "quarter": "Q2",
      "year": 2024
    },
    "analyses": [
      {
        "analysis_type": "FRINGE",
        "status": "completed",
        "passed": true,
        "summary": "Fringe increase appears proportional to salary."
      },
      {
        "analysis_type": "REPLACEMENT",
        "status": "completed",
        "passed": false,
        "summary": "One replacement link is invalid."
      }
    ]
  },
  "summary": "2 visible analyses loaded for conversation use.",
  "execution_time_ms": 31
}

Functional details

• Reads the REPORT_ANALYSIS_PACKET row from SDAC.analysis_Results.
• Applies visibility filtering when for_conversation is true.
• Recomputes narrative lines when sections filters the packet.
• Starts sdac-report-analysis when the packet is missing and start_if_missing is true.

Code Location: packages/domain-sdac/src/tools/get-analysis-packet.tool.ts