sdac-start-report-analysis

Purpose

Starts or reuses sdac-report-analysis for a cost report. Use this when an agent or route needs to ensure the persisted analysis packet is being generated.

Tool type

Workflow orchestration

Tool ID

sdac-start-report-analysis

Inputs

• report_id (string, required) -- Cost report identifier.
• use_ai_assist (boolean, optional, default: true) -- Enables AI-assisted linkage and AI-heavy analyses when runtime agents are available.
• max_ai_candidates (number, optional, default: 10) -- Maximum AI linkage candidates.

Outputs

• report_id
• success
• status
• current_phase
• completed_steps
• summary
• execution_time_ms

Example output

{
  "report_id": "SDAC-2024-Q2-001",
  "success": true,
  "status": "running",
  "current_phase": "linkage",
  "completed_steps": [
    "ingestion",
    "deterministic_linkage"
  ],
  "summary": "Report analysis started. Deterministic linkage completed and downstream analyses are queued.",
  "execution_time_ms": 96
}

Functional details

• Calls ensureSdacReportAnalysisRun() in packages/domain-sdac/src/workflows/report-analysis.runtime.ts.
• Reuses an existing completed packet when one is already persisted.
• Writes workflow state and final packet data to SDAC.analysis_Results.
• Intended for on-demand use; uploads also start the workflow after successful ingestion.

Code Location: packages/domain-sdac/src/tools/start-report-analysis.tool.ts