Capability Smoke Test

- id: tie_out_check
  name: Tie the invoice line items to its stated total
  tools: [run_analysis, list_skills, search_scratchpad, get_note, write_note, compute]
  required_inputs:
    - from_step: threshold_gate
  instructions:
    - Find the primary vendor invoice note written by read_documents. Sum its
      line items with compute — never by eye.
    - Call run_analysis(skill="capability_math_check", inputs={book_total: the
      summed line items, external_total: the invoice's own stated total,
      tolerance_pct: threshold_gate's tolerance_pct}). You already know both
      figures, so pass them directly — do not describe them in prose.
    - Write ONE cited note labelled "tie_out" holding the difference,
      difference_pct, tie_out_status and the engine's audit_id.
  output_schema:
    book_total: number
    external_total: number
    tolerance_pct: number
    difference: number
    difference_pct: number
    tie_out_status: string
    tie_out_audit_id: string
  required_outputs: [book_total, external_total, tolerance_pct, difference, tie_out_status]
  produces_notes: [tie_out]
  human_input_after:
    title: Confirm the invoice tie-out
    fields:
      - { name: confirm, kind: bool, required: true }
    review:
      mode: approve_edit_rerun
      max_refine_rounds: 2
      editable_fields: [book_total, external_total, tolerance_pct]
      recompute_on_edit:
        engine: capability_math_check
        audit_key: tie_out_audit_id
        input_map:
          book_total: book_total
          external_total: external_total
          tolerance_pct: tolerance_pct
        output_map:
          difference: difference
          difference_pct: difference_pct
          tie_out_status: tie_out_status
        trigger_fields: [book_total, external_total, tolerance_pct]

- id: ledger_bulk_scan
  name: Scan the general ledger for exceptions
  tools: [list_tables, describe_table, capability_row_scan, list_engines,
          describe_engine, search_scratchpad]
  required_inputs:
    - from_step: threshold_gate
  instructions:
    - Call list_tables, then describe_table on the general-ledger table to
      confirm its columns and control total.
    - Call capability_row_scan directly. Its inputs are bound below — pass the
      {"$table": "the ledger table", "map": {date: Date, particulars:
      Particulars, amount: Amount}} handle as rows and nothing else; the
      platform supplies fy and threshold.
  engine_bindings:
    - engine: capability_row_scan
      mode: direct
      mandatory: true
      constants:
        fy: "$param.financial_year"
        threshold: "$step.threshold_gate.major_threshold"
      outputs:
        total_amount: total_amount
        exceptions_count: exceptions_count
        exceptions: exceptions
  output_schema:
    total_amount: number
    exceptions_count: number
    exceptions: list
  required_outputs: [total_amount, exceptions_count, exceptions]
  produces_notes:
    - label: ledger_scan
      from_output: true
      include: [total_amount, exceptions_count, exceptions]

- id: rowset_bulk_scan
  name: Scan the disbursements sheet for exceptions
  skip_when: "intake_gate.bulk_data_path:table_corpus"
  tools: [list_documents, ingest_rows, set_column_mapping, for_each,
          search_scratchpad, write_note, compute]
  required_inputs:
    - from_step: threshold_gate
  instructions:
    - Call ingest_rows on the disbursements sheet, then set_column_mapping
      confirming the sheet's own column names.
    - Call for_each(action="compute", engine="capability_row_scan",
      rowset_id=the ingested rowset) — the mapping below builds every row's
      payload; do not re-type rows yourself.
    - After it returns, total the exceptions across the per-row notes with
      compute, then write_note(label="rowset_scan_summary", ...) ONE
      consolidated note.
  engine_bindings:
    - engine: capability_row_scan
      mode: for_each_rowset
      input_map:
        date: Date
        particulars: Narration
        amount: Amount
      enum_map:
        field: channel
        from_field: Mode
        values: { NEFT: bank, UPI: bank, Cash: cash, Journal: adjustment }
      constants:
        fy: "$param.financial_year"
        threshold: "$step.threshold_gate.minor_threshold"
  output_schema:
    exceptions_count: number
    total_amount: number
  produces_notes: [rowset_scan_summary]