Skip to main content

sdac-get-analysis-result

Purpose​

Retrieves one persisted analysis row for focused prompts such as fringe, salary, replacement, duplicate, or comment quality analysis.

Tool type​

Database retrieval

Tool ID​

sdac-get-analysis-result

Inputs​

  • report_id (string, required) -- Cost report identifier.
  • analysis_type (string, required) -- Analysis type such as FRINGE, SALARY, SOURCE_CODE, or COMMENT_QUALITY.
  • include_raw (boolean, optional, default: false) -- Includes the raw persisted ResultJson.
  • for_conversation (boolean, optional, default: true) -- Applies conversational visibility filtering.

Outputs​

  • report_id
  • analysis_type
  • success
  • status
  • passed
  • error_count
  • warning_count
  • records_checked
  • blocked_reason
  • result
  • summary
  • execution_time_ms

Example output​

{
  "report_id": "SDAC-2024-Q2-001",
  "analysis_type": "FRINGE",
  "success": true,
  "status": "completed",
  "passed": true,
  "error_count": 0,
  "warning_count": 0,
  "records_checked": 84,
  "blocked_reason": null,
  "result": null,
  "summary": "FRINGE: completed. Fringe increase appears proportional to salary increase.",
  "execution_time_ms": 14
}

Functional details​

  • Reads a single SDAC.analysis_Results row by (ReportId, AnalysisType).
  • Hides disabled or feature-flag-hidden analysis sections when for_conversation is true.
  • Uses the analysis registry summarizer to produce an agent-friendly summary.
  • Returns not_available for hidden conversational sections rather than telling the user that an internal flag is disabled.

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