specsmd 0.1.9 → 0.1.11

package/flows/fire/agents/builder/skills/run-execute/scripts/complete-run.js

@@ -248,25 +248,22 @@ function completeCurrentItem(rootPath, runId, params = {}) {
   const { statePath, runLogPath } = validateFireProject(rootPath, runId);
   const state = readState(statePath);
 
-  if (!state.active_run) {
+  // Find run in active runs list
+  const activeRuns = state.runs?.active || [];
+  const runIndex = activeRuns.findIndex(r => r.id === runId);
+
+  if (runIndex === -1) {
     throw fireError(
-      'No active run found in state.yaml.',
+      `Run "${runId}" not found in active runs.`,
       'COMPLETE_040',
       'The run may have already been completed or was never started.'
     );
   }
 
-  if (state.active_run.id !== runId) {
-    throw fireError(
-      `Run ID mismatch. Active run is "${state.active_run.id}" but trying to complete "${runId}".`,
-      'COMPLETE_041',
-      `Complete the active run "${state.active_run.id}" first.`
-    );
-  }
-
+  const activeRun = activeRuns[runIndex];
   const completedTime = new Date().toISOString();
-  const workItems = state.active_run.work_items || [];
-  const currentItemId = state.active_run.current_item;
+  const workItems = activeRun.work_items || [];
+  const currentItemId = activeRun.current_item;
 
   // Find and mark current item as completed
   let currentItemIndex = -1;
@@ -297,12 +294,13 @@ function completeCurrentItem(rootPath, runId, params = {}) {
     }
   }
 
-  // Update state
-  state.active_run.work_items = workItems;
-  state.active_run.current_item = nextItem ? nextItem.id : null;
+  // Update active run in list
+  activeRun.work_items = workItems;
+  activeRun.current_item = nextItem ? nextItem.id : null;
+  state.runs.active[runIndex] = activeRun;
 
   // Update run log
-  updateRunLog(runLogPath, state.active_run, completionParams, completedTime, false);
+  updateRunLog(runLogPath, activeRun, completionParams, completedTime, false);
 
   // Save state
   writeState(statePath, state);
@@ -335,25 +333,32 @@ function completeRun(rootPath, runId, params = {}) {
   const { statePath, runLogPath } = validateFireProject(rootPath, runId);
   const state = readState(statePath);
 
-  if (!state.active_run) {
-    throw fireError(
-      'No active run found in state.yaml.',
-      'COMPLETE_040',
-      'The run may have already been completed or was never started.'
-    );
+  // Initialize runs structure if needed
+  if (!state.runs) {
+    state.runs = { active: [], completed: [] };
+  }
+  if (!Array.isArray(state.runs.active)) {
+    state.runs.active = [];
+  }
+  if (!Array.isArray(state.runs.completed)) {
+    state.runs.completed = [];
   }
 
-  if (state.active_run.id !== runId) {
+  // Find run in active runs list
+  const runIndex = state.runs.active.findIndex(r => r.id === runId);
+
+  if (runIndex === -1) {
     throw fireError(
-      `Run ID mismatch. Active run is "${state.active_run.id}" but trying to complete "${runId}".`,
-      'COMPLETE_041',
-      `Complete the active run "${state.active_run.id}" first.`
+      `Run "${runId}" not found in active runs.`,
+      'COMPLETE_040',
+      'The run may have already been completed or was never started.'
     );
   }
 
+  const activeRun = state.runs.active[runIndex];
   const completedTime = new Date().toISOString();
-  const workItems = state.active_run.work_items || [];
-  const scope = state.active_run.scope || 'single';
+  const workItems = activeRun.work_items || [];
+  const scope = activeRun.scope || 'single';
 
   // Mark all items as completed
   for (const item of workItems) {
@@ -363,11 +368,11 @@ function completeRun(rootPath, runId, params = {}) {
     }
   }
 
-  state.active_run.work_items = workItems;
-  state.active_run.current_item = null;
+  activeRun.work_items = workItems;
+  activeRun.current_item = null;
 
   // Update run log
-  updateRunLog(runLogPath, state.active_run, completionParams, completedTime, true);
+  updateRunLog(runLogPath, activeRun, completionParams, completedTime, true);
 
   // Build completed run record
   const completedRun = {
@@ -378,15 +383,12 @@ function completeRun(rootPath, runId, params = {}) {
       intent: i.intent,
       mode: i.mode,
     })),
+    started: activeRun.started,
     completed: completedTime,
   };
 
-  // Get existing runs history or initialize
-  const existingRuns = state.runs || { completed: [] };
-  const existingCompleted = Array.isArray(existingRuns.completed) ? existingRuns.completed : [];
-
   // Check for duplicate (idempotency)
-  const alreadyRecorded = existingCompleted.some(r => r.id === runId);
+  const alreadyRecorded = state.runs.completed.some(r => r.id === runId);
 
   // Update work item status in intents
   if (Array.isArray(state.intents)) {
@@ -405,11 +407,11 @@ function completeRun(rootPath, runId, params = {}) {
     }
   }
 
-  // Update state
-  state.active_run = null;
-  state.runs = {
-    completed: alreadyRecorded ? existingCompleted : [...existingCompleted, completedRun],
-  };
+  // Remove from active runs and add to completed
+  state.runs.active.splice(runIndex, 1);
+  if (!alreadyRecorded) {
+    state.runs.completed.push(completedRun);
+  }
 
   // Save state
   writeState(statePath, state);

package/flows/fire/agents/builder/skills/run-execute/scripts/init-run.js

@@ -317,13 +317,15 @@ function initRun(rootPath, workItems, scope) {
   // Read state
   const state = readState(statePath);
 
-  // Check for existing active run
-  if (state.active_run) {
-    throw fireError(
-      `A run is already active: "${state.active_run.id}".`,
-      'INIT_080',
-      `Complete or cancel run "${state.active_run.id}" before starting a new one.`
-    );
+  // Initialize runs structure if needed
+  if (!state.runs) {
+    state.runs = { active: [], completed: [] };
+  }
+  if (!Array.isArray(state.runs.active)) {
+    state.runs.active = [];
+  }
+  if (!Array.isArray(state.runs.completed)) {
+    state.runs.completed = [];
   }
 
   // Generate run ID (checks both history AND file system)
@@ -345,14 +347,14 @@ function initRun(rootPath, workItems, scope) {
     status: index === 0 ? 'in_progress' : 'pending',
   }));
 
-  // Update state with active run
-  state.active_run = {
+  // Add to active runs list (supports multiple parallel runs)
+  state.runs.active.push({
     id: runId,
     scope: detectedScope,
     work_items: stateWorkItems,
     current_item: workItems[0].id,
     started: startTime,
-  };
+  });
 
   // Save state
   writeState(statePath, state);

package/flows/fire/agents/orchestrator/agent.md

@@ -22,7 +22,7 @@ You are the **Orchestrator Agent** for FIRE (Fast Intent-Run Engineering).
   When user invokes this agent:
 
   <step n="1" title="Load Configuration">
-    <action>Read `.specsmd/fire/fire-config.yaml` for schema</action>
+    <action>Read `.specsmd/fire/memory-bank.yaml` for schema</action>
   </step>
 
   <step n="2" title="Check Initialization">
@@ -79,23 +79,37 @@ You are the **Orchestrator Agent** for FIRE (Fast Intent-Run Engineering).
   ```yaml
   project:
     name: "project-name"
-    framework: fire-v1
+    fire_version: "0.1.8"
 
   workspace:
     type: brownfield
     structure: monolith
-    default_mode: confirm
+    autonomy_bias: balanced
 
   intents:
     - id: user-auth
+      title: "User Authentication"
       status: in_progress
       work_items:
         - id: login-endpoint
           status: completed
+          complexity: medium
+          mode: confirm
         - id: session-management
           status: pending
-
-  active_run: null  # or { id: run-001, work_item: session-management }
+          complexity: medium
+          mode: confirm
+
+  runs:
+    active: []  # List of active runs (supports multiple parallel runs)
+    completed:
+      - id: run-001
+        work_items:
+          - id: login-endpoint
+            intent: user-auth
+            mode: confirm
+            status: completed
+        completed: "2026-01-19T12:00:00Z"
   ```
 
 </state_schema>

package/flows/fire/agents/orchestrator/skills/project-init/SKILL.md

@@ -9,7 +9,7 @@ Initialize a new FIRE project by detecting workspace type and setting up standar
 </objective>
 
 <triggers>
-  - User runs `/fire` on uninitialized project
+  - User runs `/specsmd-fire` on uninitialized project
   - No `.specs-fire/state.yaml` exists
 </triggers>
 

package/flows/fire/agents/orchestrator/skills/route/SKILL.md

@@ -9,7 +9,7 @@ Analyze project state and route user to the appropriate agent.
 </objective>
 
 <triggers>
-  - User runs `/fire` on initialized project
+  - User runs `/specsmd-fire` on initialized project
   - After any agent completes its task
 </triggers>
 

package/flows/fire/agents/orchestrator/skills/status/SKILL.md

@@ -1,21 +1,38 @@
 ---
 name: status
-description: Display current FIRE project status including intents, work items, and active runs.
-version: 1.0.0
+description: Display current FIRE project status and validate integrity of intents, work items, and runs.
+version: 2.0.0
 ---
 
 <objective>
-Display current FIRE project status.
+Display current FIRE project status and validate integrity across state.yaml and file system.
+Detect inconsistencies and offer interactive resolution.
 </objective>
 
 <triggers>
-  - User runs `/fire status`
+  - User runs `/specsmd-fire status`
   - User asks "what's the status?"
+  - User asks to "check" or "validate" the project state
 </triggers>
 
+<degrees_of_freedom>
+  **LOW** — Report facts accurately. Never auto-fix without user confirmation.
+</degrees_of_freedom>
+
+<llm critical="true">
+  <mandate>NEVER auto-fix inconsistencies — ALWAYS ask user first</mandate>
+  <mandate>ALWAYS scan file system — state.yaml may be incomplete</mandate>
+  <mandate>Report ALL findings before offering fixes</mandate>
+  <mandate>state.yaml is source of truth for status — frontmatter may be stale</mandate>
+</llm>
+
 <flow>
   <step n="1" title="Read State">
     <action>Read .specs-fire/state.yaml</action>
+    <check if="state.yaml not found">
+      <output>No FIRE project found. Run `/specsmd-fire` to initialize.</output>
+      <exit/>
+    </check>
   </step>
 
   <step n="2" title="Display Status">
@@ -25,6 +42,7 @@ Display current FIRE project status.
       **Project**: {project.name}
       **Workspace**: {workspace.type} / {workspace.structure}
       **Autonomy**: {workspace.autonomy_bias}
+      **Version**: {project.fire_version}
 
       ## Intents
 
@@ -39,13 +57,18 @@ Display current FIRE project status.
 
       {/for}
 
-      ## Active Run
+      ## Active Runs
 
-      {if active_run}
+      {if runs.active is array and has items}
+      {for each active_run in runs.active}
+      - **Run**: {active_run.id} | **Scope**: {active_run.scope}
+      - **Current Item**: {active_run.current_item}
+      - **Started**: {active_run.started}
+      {/for}
+      {else if active_run exists (legacy singular)}
       - **Run**: {active_run.id}
       - **Work Item**: {active_run.work_item}
       - **Started**: {active_run.started}
-      - **Mode**: {active_run.mode}
       {else}
       No active run.
       {/if}
@@ -54,11 +77,546 @@ Display current FIRE project status.
 
       - Intents: {total_intents} ({completed_intents} completed)
       - Work Items: {total_work_items} ({completed_work_items} completed)
-      - Runs: {total_runs}
+      - Runs: {total_runs} completed
+    </output>
+  </step>
+
+  <!-- ═══════════════════════════════════════════════════════════════════════════ -->
+  <!-- INTEGRITY VALIDATION (NEW)                                                   -->
+  <!-- ═══════════════════════════════════════════════════════════════════════════ -->
+
+  <step n="3" title="Scan File System">
+    <critical>
+      File system may have artifacts not tracked in state.yaml.
+      state.yaml may reference artifacts that no longer exist on disk.
+    </critical>
+
+    <substep n="3a" title="Scan Intents">
+      <action>Glob: .specs-fire/intents/*/brief.md</action>
+      <action>Extract intent IDs from directory names</action>
+      <action>Store as: intents_on_disk[]</action>
+    </substep>
+
+    <substep n="3b" title="Scan Work Items">
+      <action>Glob: .specs-fire/intents/*/work-items/*.md</action>
+      <action>Exclude design docs (*-design.md)</action>
+      <action>Extract work item IDs and parent intents</action>
+      <action>Store as: work_items_on_disk[]</action>
+    </substep>
+
+    <substep n="3c" title="Scan Runs">
+      <action>Glob: .specs-fire/runs/run-*/run.md</action>
+      <action>Extract run IDs from directory names</action>
+      <action>For each run, check which artifacts exist:</action>
+      <substep>plan.md, test-report.md, review-report.md, walkthrough.md</substep>
+      <action>Store as: runs_on_disk[] with artifact_flags</action>
+    </substep>
+  </step>
+
+  <step n="4" title="Compare File System vs State">
+    <substep n="4a" title="Find Orphaned Artifacts (on disk but not in state)">
+      <action>Compare intents_on_disk with state.intents</action>
+      <action>Compare work_items_on_disk with state work_items</action>
+      <action>Compare runs_on_disk with state.runs.completed + state.runs.active</action>
+
+      <check if="intent on disk but not in state">
+        <add_issue type="orphaned_intent" severity="warning">
+          Intent '{id}' exists on disk but not tracked in state.yaml
+        </add_issue>
+      </check>
+
+      <check if="work item on disk but not in state">
+        <add_issue type="orphaned_work_item" severity="warning">
+          Work item '{id}' exists on disk but not tracked in state.yaml
+        </add_issue>
+      </check>
+
+      <check if="run folder on disk but not in state">
+        <add_issue type="orphaned_run" severity="warning">
+          Run '{id}' exists on disk but not tracked in state.yaml
+        </add_issue>
+      </check>
+    </substep>
+
+    <substep n="4b" title="Find Missing Files (in state but not on disk)">
+      <check if="intent in state but no brief.md on disk">
+        <add_issue type="missing_intent_file" severity="error">
+          Intent '{id}' tracked but brief.md not found on disk
+        </add_issue>
+      </check>
+
+      <check if="work item in state but no .md file on disk">
+        <add_issue type="missing_work_item_file" severity="error">
+          Work item '{id}' tracked but file not found on disk
+        </add_issue>
+      </check>
+
+      <check if="completed run in state but no folder on disk">
+        <add_issue type="missing_run_folder" severity="error">
+          Run '{id}' marked complete but folder not found on disk
+        </add_issue>
+      </check>
+    </substep>
+  </step>
+
+  <step n="5" title="Validate Status Cascade">
+    <critical>
+      Status must cascade correctly:
+      - Run completes work item → work item should be "completed"
+      - All work items completed → intent should be "completed"
+      - Any work item in_progress → intent should be "in_progress"
+    </critical>
+
+    <substep n="5a" title="Work Item Status Check">
+      <action>For each work item in state:</action>
+
+      <check if="work item in runs.completed but status != completed">
+        <add_issue type="status_mismatch" severity="error">
+          Work item '{id}' was completed in run '{run_id}' but status is '{current_status}'
+          Expected: completed
+        </add_issue>
+      </check>
+
+      <check if="work item in runs.active as current_item but status != in_progress">
+        <add_issue type="status_mismatch" severity="warning">
+          Work item '{id}' is currently executing in run '{run_id}' but status is '{current_status}'
+          Expected: in_progress
+        </add_issue>
+      </check>
+
+      <check if="work item status is completed but not found in any completed run">
+        <add_issue type="status_unverifiable" severity="warning" needs_code_check="true">
+          Work item '{id}' marked as completed but no completed run found
+          May have been done outside FIRE or run data is missing
+        </add_issue>
+      </check>
+    </substep>
+
+    <substep n="5b" title="Intent Status Check">
+      <action>For each intent in state:</action>
+
+      <derive_expected_status>
+        IF any work_item.status == "in_progress":
+          expected = "in_progress"
+        ELSE IF all work_items.status == "completed":
+          expected = "completed"
+        ELSE IF all work_items.status == "pending":
+          expected = "pending"
+        ELSE: # mixed pending/completed
+          expected = "in_progress"
+      </derive_expected_status>
+
+      <check if="intent.status != expected_status">
+        <add_issue type="intent_status_mismatch" severity="error">
+          Intent '{title}' has status '{current}' but should be '{expected}'
+          Based on work item statuses: {breakdown}
+        </add_issue>
+      </check>
+    </substep>
+  </step>
+
+  <step n="6" title="Validate Run Artifact Completeness">
+    <substep n="6a" title="Check Completed Runs">
+      <action>For each run in runs.completed (or runs_on_disk marked complete):</action>
+
+      <required_artifacts>
+        - run.md (mandatory)
+        - plan.md (mandatory for all modes)
+        - test-report.md (mandatory after tests)
+        - walkthrough.md (mandatory after completion)
+      </required_artifacts>
+
+      <optional_artifacts>
+        - review-report.md (created by code-review skill)
+      </optional_artifacts>
+
+      <check if="completed run missing required artifact">
+        <add_issue type="incomplete_run_artifacts" severity="warning">
+          Run '{id}' is marked complete but missing: {missing_artifacts}
+        </add_issue>
+      </check>
+    </substep>
+
+    <substep n="6b" title="Check Active Runs">
+      <action>For each run in runs.active:</action>
+
+      <check if="active run folder does not exist">
+        <add_issue type="active_run_missing" severity="error">
+          Active run '{id}' has no folder on disk
+          Run may have been deleted or never initialized properly
+        </add_issue>
+      </check>
+
+      <check if="active run has no run.md">
+        <add_issue type="active_run_corrupted" severity="error">
+          Active run '{id}' folder exists but run.md is missing
+          Run initialization may have failed
+        </add_issue>
+      </check>
+    </substep>
+  </step>
+
+  <step n="7" title="Detect Stale Runs">
+    <action>For each active run:</action>
+    <action>Calculate age: now - active_run.started</action>
+
+    <check if="active run started more than 24 hours ago">
+      <add_issue type="stale_run" severity="info" needs_user_decision="true">
+        Active run '{id}' was started {age} ago
+        Current item: {current_item}
+        Artifacts present: {artifact_list}
+        May be abandoned or work was done outside FIRE
+      </add_issue>
+    </check>
+
+    <check if="active run has plan.md but no test-report.md and age > 1 hour">
+      <add_issue type="interrupted_run" severity="warning" needs_user_decision="true">
+        Run '{id}' appears interrupted mid-execution
+        Has: plan.md
+        Missing: test-report.md, walkthrough.md
+        Execution may have been stopped before completion
+      </add_issue>
+    </check>
+  </step>
+
+  <step n="8" title="Check Frontmatter Sync">
+    <note>state.yaml is source of truth. Frontmatter may drift.</note>
+
+    <action>For each work item with status in state.yaml:</action>
+    <action>Read work item file, parse frontmatter</action>
+
+    <check if="frontmatter.status != state.yaml.status">
+      <add_issue type="frontmatter_drift" severity="info">
+        Work item '{id}' frontmatter says '{frontmatter_status}' but state.yaml says '{state_status}'
+        state.yaml is authoritative
+      </add_issue>
+    </check>
+  </step>
+
+  <step n="9" title="Report Findings">
+    <check if="no issues found">
+      <output>
+        ## ✅ Integrity Check Passed
+
+        All artifacts are consistent:
+        - {intent_count} intents tracked and verified
+        - {work_item_count} work items with correct status
+        - {run_count} runs with complete artifacts
+        - No orphaned or missing files detected
+      </output>
+      <exit/>
+    </check>
+
+    <check if="issues found">
+      <output>
+        ## ⚠️ Integrity Issues Detected
+
+        Found {issue_count} issue(s) requiring attention:
+
+        | # | Type | Location | Issue | Suggested Fix |
+        |---|------|----------|-------|---------------|
+        {for each issue, numbered}
+        | {n} | {severity_icon} | {location} | {description} | {fix_suggestion} |
+        {/for}
+
+        **Severity**: 🔴 Error | 🟡 Warning | 🔵 Info
+
+        ---
+
+        ### Actions
+
+        **[1] fix-all** — Apply all recommended fixes automatically
+        **[2] review** — Go through each issue one by one
+        **[3] skip** — Continue without fixing
+        {if any issue has needs_code_check}
+        **[4] check-code** — Verify by inspecting the codebase
+        {/if}
+
+        Choose an action [1/2/3{if check-code available}/4{/if}]:
+      </output>
+    </check>
+  </step>
+
+  <step n="10" title="Process User Choice">
+    <check if="response == 1 (fix-all)">
+      <goto step="11"/>
+    </check>
+
+    <check if="response == 2 (review)">
+      <goto step="12"/>
+    </check>
+
+    <check if="response == 3 (skip)">
+      <output>Skipping integrity fixes. Issues may cause unexpected behavior.</output>
+      <exit/>
+    </check>
+
+    <check if="response == 4 (check-code)">
+      <goto step="13"/>
+    </check>
+  </step>
+
+  <step n="11" title="Apply All Fixes">
+    <action>For each issue with a fix:</action>
+
+    <fix_actions>
+      <fix for="orphaned_intent">
+        Read brief.md frontmatter, add intent to state.yaml with status: pending
+      </fix>
+
+      <fix for="orphaned_work_item">
+        Read work item frontmatter, add to parent intent in state.yaml
+      </fix>
+
+      <fix for="orphaned_run">
+        Parse run.md, determine if complete or incomplete
+        If complete: add to runs.completed
+        If incomplete: offer to add to runs.active or delete
+      </fix>
+
+      <fix for="missing_intent_file">
+        Remove intent from state.yaml (data loss warning)
+        Or: Create placeholder brief.md from state data
+      </fix>
+
+      <fix for="status_mismatch">
+        Update state.yaml status to expected value
+      </fix>
+
+      <fix for="intent_status_mismatch">
+        Update intent status in state.yaml
+      </fix>
+
+      <fix for="frontmatter_drift">
+        Update work item frontmatter to match state.yaml
+      </fix>
+
+      <fix for="incomplete_run_artifacts">
+        Mark run as incomplete in state, or generate missing artifacts
+      </fix>
+
+      <fix for="stale_run">
+        User must decide: resume, abandon, or check code
+      </fix>
+    </fix_actions>
+
+    <output>
+      ## Fixes Applied
+
+      {for each fix applied}
+      ✓ {description}
+      {/for}
+
+      {if any fixes skipped}
+      ⏭️ Skipped (requires user decision):
+      {for each skipped}
+      - {description}
+      {/for}
+      {/if}
+    </output>
+
+    <goto step="14"/>
+  </step>
+
+  <step n="12" title="Interactive Review">
+    <action>For each issue:</action>
+
+    <output>
+      ## Issue {n} of {total}
+
+      **Type**: {type}
+      **Severity**: {severity}
+      **Location**: {location}
+
+      ### Details
+      {full_description}
+
+      ### Suggested Fix
+      {fix_suggestion}
+
+      ---
+
+      **[y]** Apply fix
+      **[n]** Skip this issue
+      **[c]** Check codebase for this item
+      **[q]** Quit review (remaining issues skipped)
+
+      Choice [y/n/c/q]:
+    </output>
+
+    <check if="response == y">
+      <action>Apply fix for this issue</action>
+      <output>✓ Fixed: {description}</output>
+    </check>
+
+    <check if="response == c">
+      <action>Invoke code check for this specific item</action>
+      <goto_substep>code-check for {item}</goto_substep>
+    </check>
+
+    <check if="response == q">
+      <output>Review ended. {remaining} issues skipped.</output>
+      <goto step="14"/>
+    </check>
+
+    <action>Continue to next issue</action>
+  </step>
+
+  <step n="13" title="Code Verification">
+    <critical>
+      This is a BEST EFFORT verification. AI will look for evidence
+      but may not catch everything. User should confirm findings.
+    </critical>
+
+    <ask>
+      I'll check the codebase for evidence that work items were completed.
+      This involves reading work item acceptance criteria and looking for
+      matching implementations.
+
+      Which items should I check?
+
+      {for each item with needs_code_check}
+      **[{n}]** {work_item_title}
+      {/for}
+      **[a]** All items
+      **[b]** Back to actions
+
+      Choice:
+    </ask>
+
+    <substep n="13a" title="Verify Single Work Item">
+      <action>Read work item file: .specs-fire/intents/{intent}/work-items/{id}.md</action>
+      <action>Extract acceptance criteria</action>
+      <action>Extract expected files/endpoints/components mentioned</action>
+
+      <verification_checks>
+        <check title="File Existence">
+          Look for files mentioned in the work item description
+          Example: "Create src/auth/login.ts" → check if file exists
+        </check>
+
+        <check title="Test Existence">
+          Look for test files for the component
+          Pattern: {filename}.test.ts, {filename}.spec.ts, __tests__/{filename}.ts
+        </check>
+
+        <check title="Implementation Markers">
+          If file exists, do a quick scan for expected functions/classes
+          Example: Work item mentions "login endpoint" → look for login handler
+        </check>
+      </verification_checks>
+
+      <output>
+        ## Code Verification: {work_item_title}
+
+        ### Expected (from acceptance criteria)
+        {list acceptance criteria}
+
+        ### Found in Codebase
+        {for each check}
+        {check_result_icon} {check_description}
+        {/for}
+
+        ### Assessment
+        {if all checks pass}
+        ✅ **Likely Complete** — Implementation evidence found
+        Recommend: Mark as completed in state.yaml
+        {else if some checks pass}
+        🟡 **Partially Complete** — Some evidence found
+        Missing: {missing_items}
+        Recommend: Review manually or continue implementation
+        {else}
+        ❌ **Not Found** — No implementation evidence
+        Recommend: Keep as pending, implementation needed
+        {/if}
+
+        ---
+
+        Apply this assessment? [y/n]:
+      </output>
+
+      <check if="response == y">
+        <action>Update state.yaml based on assessment</action>
+      </check>
+    </substep>
+  </step>
+
+  <step n="14" title="Log Maintenance">
+    <check if="any fixes were applied">
+      <action>Append to .specs-fire/maintenance-log.md (create if needed):</action>
+
+      <log_entry>
+        ## {ISO-8601-timestamp} - Integrity Check
+
+        **Triggered by**: status skill validation
+
+        | Issue | Fix Applied | Details |
+        |-------|-------------|---------|
+        {for each fix}
+        | {type} | {fix_description} | {location} |
+        {/for}
+
+        ---
+      </log_entry>
+
+      <output>
+        Changes logged to: .specs-fire/maintenance-log.md
+      </output>
+    </check>
+  </step>
+
+  <step n="15" title="Final Summary">
+    <output>
+      ## Status Check Complete
+
+      {if fixes applied}
+      **Fixes Applied**: {fix_count}
+      **Issues Remaining**: {remaining_count}
+      {/if}
+
+      {if all clean}
+      ✅ Project state is consistent and ready for work.
+      {else}
+      ⚠️ Some issues remain unresolved. Run `/specsmd-fire status` again to review.
+      {/if}
+
+      ---
+
+      **Next**: {suggest next action based on current state}
     </output>
   </step>
 </flow>
 
+<!-- ═══════════════════════════════════════════════════════════════════════════ -->
+<!-- ISSUE TYPE REFERENCE                                                         -->
+<!-- ═══════════════════════════════════════════════════════════════════════════ -->
+
+<issue_types>
+
+| Type | Severity | Auto-fixable | Description |
+|------|----------|--------------|-------------|
+| orphaned_intent | warning | yes | Intent on disk but not in state.yaml |
+| orphaned_work_item | warning | yes | Work item on disk but not in state.yaml |
+| orphaned_run | warning | partial | Run folder on disk but not tracked |
+| missing_intent_file | error | partial | Intent in state but file missing |
+| missing_work_item_file | error | partial | Work item in state but file missing |
+| missing_run_folder | error | no | Completed run in state but folder missing |
+| status_mismatch | error | yes | Work item status doesn't match run history |
+| status_unverifiable | warning | no | Status can't be verified from run data |
+| intent_status_mismatch | error | yes | Intent status inconsistent with work items |
+| incomplete_run_artifacts | warning | partial | Run missing required artifacts |
+| active_run_missing | error | no | Active run folder doesn't exist |
+| active_run_corrupted | error | no | Active run folder missing run.md |
+| stale_run | info | no | Active run is old, may be abandoned |
+| interrupted_run | warning | no | Run appears stopped mid-execution |
+| frontmatter_drift | info | yes | Frontmatter status differs from state |
+
+</issue_types>
+
+<!-- ═══════════════════════════════════════════════════════════════════════════ -->
+<!-- EXAMPLE OUTPUT                                                               -->
+<!-- ═══════════════════════════════════════════════════════════════════════════ -->
+
 <example_output>
 
   ```
@@ -67,6 +625,7 @@ Display current FIRE project status.
   **Project**: my-saas-app
   **Workspace**: brownfield / monolith
   **Autonomy**: balanced
+  **Version**: 0.1.8
 
   ## Intents
 
@@ -78,18 +637,42 @@ Display current FIRE project status.
   | session-management | in_progress | medium | confirm |
   | password-reset | pending | high | validate |
 
-  ## Active Run
+  ## Active Runs
 
-  - **Run**: run-002
-  - **Work Item**: session-management
+  - **Run**: run-002 | **Scope**: single
+  - **Current Item**: session-management
   - **Started**: 2026-01-19T10:30:00Z
-  - **Mode**: confirm
 
   ## Quick Stats
 
   - Intents: 1 (0 completed)
   - Work Items: 3 (1 completed)
-  - Runs: 2
+  - Runs: 1 completed
+
+  ---
+
+  ## ⚠️ Integrity Issues Detected
+
+  Found 3 issue(s) requiring attention:
+
+  | # | Type | Location | Issue | Suggested Fix |
+  |---|------|----------|-------|---------------|
+  | 1 | 🟡 | run-002 | Run started 3 days ago, may be stale | Resume or abandon |
+  | 2 | 🔵 | login-endpoint | Frontmatter says 'pending' but state says 'completed' | Sync frontmatter |
+  | 3 | 🟡 | analytics-dashboard.md | Work item on disk but not tracked | Add to state.yaml |
+
+  **Severity**: 🔴 Error | 🟡 Warning | 🔵 Info
+
+  ---
+
+  ### Actions
+
+  **[1] fix-all** — Apply all recommended fixes automatically
+  **[2] review** — Go through each issue one by one
+  **[3] skip** — Continue without fixing
+  **[4] check-code** — Verify by inspecting the codebase
+
+  Choose an action [1/2/3/4]:
   ```
 
 </example_output>
@@ -99,4 +682,15 @@ Display current FIRE project status.
   <criterion>All intents and work items displayed</criterion>
   <criterion>Active run status shown</criterion>
   <criterion>Quick stats accurate</criterion>
+  <criterion>File system scanned for all artifacts</criterion>
+  <criterion>Orphaned artifacts detected (disk → state)</criterion>
+  <criterion>Missing files detected (state → disk)</criterion>
+  <criterion>Status cascade validated (work items → intents)</criterion>
+  <criterion>Run artifact completeness checked</criterion>
+  <criterion>Stale/interrupted runs detected</criterion>
+  <criterion>Frontmatter sync checked</criterion>
+  <criterion>Issues reported in clear table format</criterion>
+  <criterion>User given choice: fix-all, review, skip, check-code</criterion>
+  <criterion>Fixes logged to maintenance-log.md</criterion>
+  <criterion>Code verification available for ambiguous cases</criterion>
 </success_criteria>

package/flows/fire/commands/fire-builder.md

@@ -19,7 +19,7 @@ You are now the **FIRE Builder Agent** for specsmd.
 
 ## Critical First Steps
 
-1. **Read Config**: `.specsmd/fire/fire-config.yaml`
+1. **Read Config**: `.specsmd/fire/memory-bank.yaml`
 2. **Read State**: `.specs-fire/state.yaml`
 3. **Determine Mode**:
    - Active run exists → Resume execution

package/flows/fire/commands/fire-planner.md

@@ -19,7 +19,7 @@ You are now the **FIRE Planner Agent** for specsmd.
 
 ## Critical First Steps
 
-1. **Read Config**: `.specsmd/fire/fire-config.yaml`
+1. **Read Config**: `.specsmd/fire/memory-bank.yaml`
 2. **Read State**: `.specs-fire/state.yaml`
 3. **Determine Mode**:
    - No active intent → `intent-capture` skill

package/flows/fire/commands/fire.md

@@ -19,7 +19,7 @@ You are now the **FIRE Orchestrator** for specsmd.
 
 ## Critical First Steps
 
-1. **Read Config**: `.specsmd/fire/fire-config.yaml`
+1. **Read Config**: `.specsmd/fire/memory-bank.yaml`
 2. **Check Initialization**: Verify `.specs-fire/state.yaml` exists
 3. **If NOT initialized** → Execute `project-init` skill
 4. **If initialized** → Execute `route` skill to determine next action

package/flows/fire/memory-bank.yaml

@@ -1,7 +1,7 @@
 # FIRE Flow Configuration
 # Fast Intent-Run Engineering - Simplified AI-native development
 
-# FIRE Flow Version (used by migrate skill to detect outdated projects)
+# FIRE Flow Version
 version: "0.1.8"
 
 # Artifact folder (created at project initialization)
@@ -55,14 +55,23 @@ state:
       - title: "Intent title"
       - status: "pending | in_progress | completed"
       - work_items: "List of work items"
-    active_run:
-      - id: "Current run ID"
-      - scope: "single | batch | wide"
-      - work_items: "List of work items in this run"
-      - current_item: "Work item currently being executed"
-      - started: "ISO 8601 timestamp"
+    # Each work item in intents[] has:
+    #   - id: "Work item identifier"
+    #   - title: "Work item title"
+    #   - status: "pending | in_progress | completed | blocked"
+    #   - complexity: "low | medium | high"
+    #   - mode: "autopilot | confirm | validate (derived from complexity + autonomy_bias)"
+    #   - depends_on: "List of work item IDs this depends on (optional)"
     runs:
+      - active: "List of currently active runs (supports multiple parallel runs)"
       - completed: "List of completed runs with id, work_item, intent, completed timestamp"
+    # Each run (active or completed) has:
+    #   - id: "Run ID (e.g., run-001)"
+    #   - scope: "single | batch | wide"
+    #   - work_items: "List of work items in this run"
+    #   - current_item: "Work item currently being executed (active runs only)"
+    #   - started: "ISO 8601 timestamp"
+    #   - completed: "ISO 8601 timestamp (completed runs only)"
 
 # Data Conventions
 conventions:
@@ -88,23 +97,31 @@ naming:
     example: "run-001/"
     note: "Sequential 3-digit number, folder per run"
     contents:
-      - "plan.md"         # Approved implementation plan (confirm/validate modes)
-      - "run.md"          # Run log
-      - "test-report.md"  # Test results and coverage
-      - "walkthrough.md"  # Implementation walkthrough
+      - "run.md"           # Run log (created by init-run.js)
+      - "plan.md"          # Implementation plan (ALL modes, created BEFORE implementation)
+      - "test-report.md"   # Test results and coverage (created AFTER tests pass)
+      - "review-report.md" # Code review findings (created by code-review skill)
+      - "walkthrough.md"   # Implementation walkthrough (created at run completion)
 
 # Schema Definition (Source of Truth for Agents)
 schema:
   state: ".specs-fire/state.yaml"
+  maintenance-log: ".specs-fire/maintenance-log.md"
+
+  # Intent Artifacts
   intents: ".specs-fire/intents/{intent-id}/"
   intent-brief: ".specs-fire/intents/{intent-id}/brief.md"
   work-items: ".specs-fire/intents/{intent-id}/work-items/"
   work-item: ".specs-fire/intents/{intent-id}/work-items/{work-item-id}.md"
+  design-doc: ".specs-fire/intents/{intent-id}/work-items/{work-item-id}-design.md"
+
+  # Run Artifacts
   runs: ".specs-fire/runs/"
   run-folder: ".specs-fire/runs/{run-id}/"
-  plan: ".specs-fire/runs/{run-id}/plan.md"
   run-log: ".specs-fire/runs/{run-id}/run.md"
+  plan: ".specs-fire/runs/{run-id}/plan.md"
   test-report: ".specs-fire/runs/{run-id}/test-report.md"
+  review-report: ".specs-fire/runs/{run-id}/review-report.md"
   walkthrough: ".specs-fire/runs/{run-id}/walkthrough.md"
 
   # Root Standards

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specsmd",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Multi-agent orchestration system for AI-native software development. Delivers AI-DLC, Agile, and custom SDLC flows as markdown-based agent systems.",
   "main": "lib/installer.js",
   "bin": {

package/flows/fire/agents/orchestrator/skills/project-migrate/SKILL.md

@@ -1,234 +0,0 @@
----
-name: project-migrate
-description: Migrate existing FIRE project to latest version. Adds constitution.md, updates schema, and optionally detects monorepo modules.
-version: 1.0.0
----
-
-<objective>
-Upgrade an existing FIRE project to the latest version, adding new features
-(constitution.md, hierarchical standards) while preserving all existing work.
-</objective>
-
-<triggers>
-  - User runs `/fire-migrate`
-  - Orchestrator detects outdated project version
-</triggers>
-
-<principles critical="true">
-  <principle>NEVER delete or modify existing intents/work-items/runs</principle>
-  <principle>Create backup before any changes</principle>
-  <principle>Migration is idempotent — safe to run multiple times</principle>
-  <principle>Show changes before applying</principle>
-</principles>
-
-<flow>
-  <step n="1" title="Detect Current Version">
-    <action>Check if .specs-fire/ exists</action>
-    <check if="no .specs-fire/">
-      <output>Not a FIRE project. Use /fire to initialize.</output>
-      <exit/>
-    </check>
-
-    <action>Read .specs-fire/state.yaml</action>
-    <action>Check project.fire_version field</action>
-    <action>Read FIRE flow version from memory-bank.yaml</action>
-
-    <version_detection>
-      | Check | Meaning |
-      |-------|---------|
-      | project.fire_version missing | Pre-0.1.8 project |
-      | project.fire_version < current | Needs migration |
-      | project.fire_version == current | Up to date |
-
-      Also check for feature indicators:
-      | Missing Feature | Added In |
-      |-----------------|----------|
-      | constitution.md | 0.1.8 |
-      | workspace.structure | 0.1.8 |
-    </version_detection>
-
-    <check if="already up to date">
-      <output>Project is already at the latest version ({current_version}). No migration needed.</output>
-      <exit/>
-    </check>
-
-    <output>
-      Current version: {project_fire_version or "pre-0.1.8"}
-      Latest version: {fire_flow_version}
-      Migration required.
-    </output>
-  </step>
-
-  <step n="2" title="Analyze Migration Scope">
-    <action>Determine what needs to be migrated:</action>
-
-    <check_constitution>
-      Does .specs-fire/standards/constitution.md exist?
-      If no → needs_constitution = true
-    </check_constitution>
-
-    <check_schema>
-      Does state.yaml have workspace.structure field?
-      If no → needs_schema_update = true
-    </check_schema>
-
-    <check_monorepo>
-      Is this actually a monorepo? Check for:
-      - nx.json, turbo.json, pnpm-workspace.yaml, lerna.json
-      - package.json with "workspaces"
-      - Multiple package/dependency manifests
-      If detected → is_monorepo = true
-    </check_monorepo>
-
-    <output>
-      Migration Plan:
-      ┌─────────────────────────────────────────────────────┐
-      │ Changes to be made:                                 │
-      {{#if needs_constitution}}
-      │ ✓ Create constitution.md (universal policies)      │
-      {{/if}}
-      {{#if needs_schema_update}}
-      │ ✓ Update state.yaml schema                         │
-      {{/if}}
-      {{#if is_monorepo}}
-      │ ? Monorepo detected — offer module standards       │
-      {{/if}}
-      │                                                     │
-      │ Will NOT change:                                    │
-      │ • Existing intents and work items                   │
-      │ • Existing runs and logs                            │
-      │ • Existing standards (only add new ones)            │
-      └─────────────────────────────────────────────────────┘
-    </output>
-  </step>
-
-  <step n="3" title="Create Backup">
-    <action>Create backup: cp -r .specs-fire .specs-fire-backup-{timestamp}</action>
-    <output>Backup created: .specs-fire-backup-{timestamp}</output>
-  </step>
-
-  <step n="4" title="Confirm Migration">
-    <ask>
-      Ready to migrate. Backup saved.
-
-      Proceed with migration? [Y/n]
-    </ask>
-  </step>
-
-  <step n="5" title="Add Constitution" if="needs_constitution">
-    <ask>
-      How should I create constitution.md?
-
-      [a] Auto-generate — analyze project (git, CI, existing patterns)
-      [d] Default — use standard template
-      [c] Custom — I'll provide the content
-    </ask>
-
-    <check if="response == a">
-      <action>Analyze project for constitution content:</action>
-      <substep>Check .gitignore, CI config for workflow hints</substep>
-      <substep>Check existing PR templates, CONTRIBUTING.md</substep>
-      <substep>Infer commit style from git log</substep>
-      <action>Generate constitution.md from findings</action>
-    </check>
-
-    <check if="response == d">
-      <action>Create constitution.md from default template</action>
-    </check>
-
-    <check if="response == c">
-      <ask>Please describe your key policies (git workflow, PR process, security).</ask>
-      <action>Generate constitution.md from input</action>
-    </check>
-
-    <action>Write to .specs-fire/standards/constitution.md</action>
-    <output>Created: .specs-fire/standards/constitution.md</output>
-  </step>
-
-  <step n="6" title="Update State Schema" if="needs_schema_update">
-    <action>Read current state.yaml</action>
-    <action>Add missing fields with defaults:</action>
-    <substep>project.fire_version: "{current_fire_flow_version}"</substep>
-    <substep>workspace.structure: "monolith" (or "monorepo" if detected)</substep>
-    <action>Write updated state.yaml (preserve all existing data)</action>
-    <output>Updated: .specs-fire/state.yaml</output>
-  </step>
-
-  <step n="7" title="Monorepo Module Setup" if="is_monorepo" optional="true">
-    <action>Discover modules (same as project-init):</action>
-    <substep>Check workspace config for project list</substep>
-    <substep>Scan packages/*, apps/*, services/*, libs/*</substep>
-    <substep>Analyze each module's tech stack</substep>
-
-    <ask>
-      This appears to be a monorepo. Found {{module_count}} modules:
-
-      {{#each modules}}
-      • {{path}} ({{language}})
-      {{/each}}
-
-      Create module-specific standards?
-      [y] Yes — create for all modules
-      [s] Select — choose which modules
-      [n] No — skip for now
-    </ask>
-
-    <check if="response == y or response == s">
-      <action>For each selected module:</action>
-      <substep>Create {module}/.specs-fire/standards/</substep>
-      <substep>Generate tech-stack.md with detected settings</substep>
-    </check>
-  </step>
-
-  <step n="8" title="Verify Migration">
-    <action>Verify migration completed:</action>
-    <substep>Read state.yaml — valid YAML?</substep>
-    <substep>Check new files exist</substep>
-    <substep>Ensure no existing files corrupted</substep>
-
-    <check if="verification fails">
-      <output>Migration failed. Restoring from backup...</output>
-      <action>rm -rf .specs-fire && mv .specs-fire-backup-{timestamp} .specs-fire</action>
-      <output>Restored. Please report this issue.</output>
-      <exit status="error"/>
-    </check>
-  </step>
-
-  <step n="9" title="Report">
-    <output>
-      Migration complete!
-
-      Changes made:
-      {{#each changes_made}}
-      ✓ {{description}}
-      {{/each}}
-
-      Backup preserved at: .specs-fire-backup-{timestamp}
-      (Delete once you've verified everything works)
-
-      New features available:
-      • Constitution: Universal policies in constitution.md
-      {{#if is_monorepo}}
-      • Monorepo: Module-specific standards supported
-      {{/if}}
-    </output>
-  </step>
-</flow>
-
-<safety_guarantees>
-  <guarantee>Backup created before any changes</guarantee>
-  <guarantee>Idempotent — running twice is safe</guarantee>
-  <guarantee>Verify after — validates migration succeeded</guarantee>
-  <guarantee>Restore on failure — automatic rollback</guarantee>
-  <guarantee>Never deletes — only adds, never removes</guarantee>
-</safety_guarantees>
-
-<success_criteria>
-  <criterion>Current version detected correctly</criterion>
-  <criterion>Backup created before changes</criterion>
-  <criterion>constitution.md added if missing</criterion>
-  <criterion>state.yaml schema updated if needed</criterion>
-  <criterion>Monorepo modules detected and offered (if applicable)</criterion>
-  <criterion>Migration verified successfully</criterion>
-  <criterion>No existing data lost or corrupted</criterion>
-</success_criteria>