record_actual
Submit actual hours for a previous estimate to improve future accuracy and reduce estimation bias through automatic correction factors.
Instructions
Submit actual hours for a previous estimate to improve future accuracy.
Pairs with any estimation tool. The estimate_id comes from the estimate response. Actuals feed into the self-improvement loop — after enough samples, correction factors update automatically to reduce estimation bias.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"estimate_id": "<estimate_id>",
"actual_hours": "<actual_hours>"
},
"name": "record_actual"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unit | No | Unit actual_hours is expressed in. Normalized to hours at ingest (days=8h, weeks=40h workday convention, matching estimation.ts's toHours()). Defaults to hours when omitted. | |
| notes | No | Optional context. | |
| estimate_id | Yes | ID of the estimate to update. | |
| actual_hours | Yes | Actual hours spent. | |
| calibration_provenance | No | Optional explicit provenance classification for this actual, consumed by the shared exclusion predicate (synthetic/smoke are excluded from calibration math). auto_wallclock marks a wall-clock-derived actual auto-recorded at session end (never focused-effort-verified) — included in correction training by default but subject to a dedicated sanity gate and segmented separately in feedback_health. git_derived marks a cycle-time actual mined from git history by `epoch mine-git` (first-commit→merge dev window); git_derived_review_inclusive marks the open→merge window — both are sanity-gated and segmented separately, never blended with verified actuals. |