finance-ic-research-budget-variance-explainer

> Reads month-end actuals vs budget, explains variances with line-level evidence, surfaces the top 5 drivers.

Cell: finance.ic · Shape: research · Source: arx-reference

Reference agent conforming to MANIFEST_FRAMEWORK.md. Apache 2.0 — fork, modify, or replace; the governance layer underneath stays.

What it does

Given a list of cost center IDs:

1. Pulls supporting context through ARX-governed connectors
2. Applies the budget variance research logic
3. Returns a structured variance explanation for human review (or

auto-action if within declared low-risk scope)

1. Streams every action to the customer's hash-chained personnel record

Governance posture

• Onboarding — credentials issued at runtime, scoped per-call
• Supervision — writes to (none — read-only) require manager approval
• Evaluation — drift detection against manifests/job_description.yaml
• Records — every action to customer S3 personnel-record bucket
• Termination — one-button revoke + halt + exit attestation

Endpoints

| Method | Path | Description | | ------ | ----------- | ----------- | | POST | /act | Plan a budget variance research pass against cost center IDs | | POST | /execute | Execute the plan | | GET | /status | Liveness + manifest sha256 + cell + shape |

Run locally

``bash docker build -t finance-ic-research-budget-variance-explainer:dev . docker run --rm -p 8100:8100 finance-ic-research-budget-variance-explainer:dev curl -s http://localhost:8100/status | jq ``