-
Notifications
You must be signed in to change notification settings - Fork 3
Emit reflection artifacts for halted or stagnating execution #111
Copy link
Copy link
Open
Labels
enhancementProduct improvement or enhancementProduct improvement or enhancementexecutionTask execution, run orchestration, and loopsTask execution, run orchestration, and loopsfuturePost-v1 roadmap backlogPost-v1 roadmap backlogobservabilityLogging, explainability, and inspection visibilityLogging, explainability, and inspection visibilityresearchResearch spike or investigative workResearch spike or investigative work
Milestone
Description
Problem
When a bounded execution loop halts, SpecForge currently returns the decision but does not yet produce a dedicated reflection artifact describing why progress stopped and what input is needed next.
Why it matters
Without a structured reflection output, users are left to infer whether the stop condition came from policy, environment, spec ambiguity, or repeated non-progress.
Proposed solution
Emit a dedicated reflection/diagnostic artifact when execution halts or stagnates.
The artifact should summarize:
- attempts made
- what changed vs did not change
- repeated failing signals
- likely root-cause class
- what manual input or clarification is needed next
Acceptance criteria
- A structured artifact is emitted for halted or stagnating bounded loops.
- The artifact is grounded in prior attempt evidence and critic/task results.
- The reflection summary is consumable by both CLI output and notifier adapters.
- Tests cover ordinary halt and stagnation-specific reflection cases.
Related phase
Future / Research
Related subsystem/component
diagnostics / execution reflection
Related artifacts or commands
criticRalphLoop; sf explain; task execution results; critic results
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
enhancementProduct improvement or enhancementProduct improvement or enhancementexecutionTask execution, run orchestration, and loopsTask execution, run orchestration, and loopsfuturePost-v1 roadmap backlogPost-v1 roadmap backlogobservabilityLogging, explainability, and inspection visibilityLogging, explainability, and inspection visibilityresearchResearch spike or investigative workResearch spike or investigative work