FN-7514: withhold overseer actions under human control
Add a human-control guard so planner overseer recovery stays inert for paused or human-review tasks.
- Add a pure overseer human-control policy that treats explicit user pauses and autoMerge:false / human-review tasks as full withhold states.
- Thread settings through planner recovery ticks, skip action classification and pending confirmations when withheld, and emit deduped no-action run-audit events.
- Wire ProjectEngine audit recording and document the new guard, run-audit event, exports, and release note.
Files changed:
.changeset/fn-7514-overseer-human-control-guard.md | 7 +
AGENTS.md | 1 +
docs/architecture.md | 39 +++++
.../overseer-human-control-policy.test.ts | 86 +++++++++++
...anner-recovery-controller-human-control.test.ts | 170 +++++++++++++++++++++
packages/engine/src/index.ts | 7 +
.../engine/src/overseer-human-control-policy.ts | 88 +++++++++++
packages/engine/src/planner-recovery-controller.ts | 107 ++++++++++++-
packages/engine/src/project-engine.ts | 44 +++++-
packages/engine/src/run-audit.ts | 15 +-
10 files changed, 558 insertions(+), 6 deletions(-)
Fusion-Task-Id: FN-7514
Fusion-Task-Lineage: d4d3bd04-3f8e-4a05-9636-f177e050390b
Co-authored-by: Fusion (runfusion.ai) <noreply@runfusion.ai>