singularity/singularity-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
singularity-forge/.sf/PROJECT.md

2.1 KiB
Raw Blame History

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

  • M003/S01: Idle Halt Detection — Loop watchdog detects persistent stop states.
  • 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.