35 lines
2.1 KiB
Markdown
35 lines
2.1 KiB
Markdown
# Project: SF Autonomous Self-Healing
|
|
|
|
## What This Is
|
|
|
|
This project implements self-healing capabilities for the Singularity Forge (SF) autonomous execution loop. It addresses the issue of the loop halting silently when encountering blocking states, such as "needs-attention" validation verdicts, by introducing graduated escalation (notifications, self-feedback) and automated recovery (auto-remediation, auto-deferral).
|
|
|
|
## Core Value
|
|
|
|
The autonomous loop should never sit silently stuck. Every halt must be communicated to the operator and, where safe, attempts should be made to resolve the blockage autonomously.
|
|
|
|
## Current State
|
|
|
|
- S01 complete: HaltWatchdog detects forced 'stop' state and emits 'stuck' signal after threshold.
|
|
- S02 complete: Durable BLOCKING_NOTICE persists to .sf/notifications.jsonl with defensive initialization hardened.
|
|
- Remaining: S03 (self-feedback), S04 (remediation dispatcher), S05 (auto-defer confidence), S06 (E2E integration).
|
|
|
|
## Architecture / Key Patterns
|
|
|
|
- **Auto-Loop**: `src/resources/extensions/sf/auto/loop.js` manages iteration and phase dispatch.
|
|
- **Dispatch Rules**: `src/resources/extensions/sf/uok/auto-dispatch.js` determines the next action based on milestone/slice state.
|
|
- **Self-Feedback**: `src/resources/extensions/sf/self-feedback.js` provides the registry for anomalous behavior.
|
|
- **Notification Store**: `src/resources/extensions/sf/notification-store.js` persists notifications to `.sf/notifications.jsonl` (fail-open, idempotent init).
|
|
|
|
## Capability Contract
|
|
|
|
See `.sf/REQUIREMENTS.md` for the explicit capability contract, requirement status, and coverage mapping.
|
|
|
|
## Milestone Sequence
|
|
|
|
- [x] M003/S01: Idle Halt Detection — Loop watchdog detects persistent stop states.
|
|
- [x] M003/S02: Escalation Plumbing — Durable notifications land in `.sf/notifications.jsonl`.
|
|
- [ ] M003/S03: Halt Self-Feedback — Structured SELF-FEEDBACK.md entries after halt.
|
|
- [ ] M003/S04: Remediation Dispatcher — Auto-dispatch remediation slices on needs-attention.
|
|
- [ ] M003/S05: Auto-Defer Confidence — Low-confidence findings auto-deferred.
|
|
- [ ] M003/S06: End-to-End Integration — Full self-healing flow in headless run.
|