specsmd 0.1.13 → 0.1.15

package/flows/aidlc/scripts/{artifact-validator.js → artifact-validator.cjs}

@@ -10,9 +10,9 @@
  * - Timestamp format (ISO 8601 without milliseconds)
  *
  * Usage:
- *   node .specsmd/aidlc/scripts/artifact-validator.js
- *   node .specsmd/aidlc/scripts/artifact-validator.js --json
- *   node .specsmd/aidlc/scripts/artifact-validator.js --fix
+ *   node .specsmd/aidlc/scripts/artifact-validator.cjs
+ *   node .specsmd/aidlc/scripts/artifact-validator.cjs --json
+ *   node .specsmd/aidlc/scripts/artifact-validator.cjs --fix
  *
  * Cross-platform: Works on Linux, macOS, Windows via Node.js
  */

package/flows/aidlc/scripts/{bolt-complete.js → bolt-complete.cjs}

@@ -115,11 +115,11 @@
  *
  *   From agent skill (bolt-start.md Step 10):
  *
- *     node .specsmd/aidlc/scripts/bolt-complete.js 016-analytics-tracker
+ *     node .specsmd/aidlc/scripts/bolt-complete.cjs 016-analytics-tracker
  *
  *   With optional stage name:
  *
- *     node .specsmd/aidlc/scripts/bolt-complete.js 016-analytics-tracker --last-stage test
+ *     node .specsmd/aidlc/scripts/bolt-complete.cjs 016-analytics-tracker --last-stage test
  *
  * ═══════════════════════════════════════════════════════════════════════════════
  */
@@ -594,7 +594,7 @@ const lastStage = process.argv['--last-stage'] || null;
 
 if (!boltId) {
     console.error(`${colors.red}Error:${colors.reset} Bolt ID required`);
-    console.error(`${colors.dim}Usage: node bolt-complete.js <bolt-id> [--last-stage <stage-name>]${colors.reset}`);
+    console.error(`${colors.dim}Usage: node bolt-complete.cjs <bolt-id> [--last-stage <stage-name>]${colors.reset}`);
     process.exit(1);
 }
 

package/flows/aidlc/scripts/{status-integrity.js → status-integrity.cjs}

@@ -7,8 +7,8 @@
  * Status must cascade correctly: Bolt complete → Stories complete → Unit complete → Intent complete
  *
  * Usage:
- *   node .specsmd/aidlc/scripts/status-integrity.js
- *   node .specsmd/aidlc/scripts/status-integrity.js --fix
+ *   node .specsmd/aidlc/scripts/status-integrity.cjs
+ *   node .specsmd/aidlc/scripts/status-integrity.cjs --fix
  *
  * Cross-platform: Works on Linux, macOS, Windows via Node.js
  */
@@ -577,15 +577,15 @@ const shouldFix = args.includes('--fix') || args.includes('-f');
 
 if (args.includes('--help') || args.includes('-h')) {
     console.log(`
-Usage: node status-integrity.js [options]
+Usage: node status-integrity.cjs [options]
 
 Options:
   --fix, -f    Automatically fix status inconsistencies
   --help, -h   Show this help message
 
 Examples:
-  node .specsmd/aidlc/scripts/status-integrity.js
-  node .specsmd/aidlc/scripts/status-integrity.js --fix
+  node .specsmd/aidlc/scripts/status-integrity.cjs
+  node .specsmd/aidlc/scripts/status-integrity.cjs --fix
 `);
     process.exit(0);
 }

package/flows/aidlc/skills/construction/bolt-start.md

@@ -194,7 +194,7 @@ If the bolt type specifies automatic validation criteria, follow those rules.
 ┌─────────────────────────────────────────────────────────────┐
 │  FINAL STAGE DETECTED                                       │
 │  → Re-read Step 10 NOW                                     │
-│  → You MUST run: node .specsmd/aidlc/scripts/bolt-complete.js │
+│  → You MUST run: node .specsmd/aidlc/scripts/bolt-complete.cjs │
 │  → Do NOT manually edit story files                        │
 └─────────────────────────────────────────────────────────────┘
 ```
@@ -235,7 +235,7 @@ stages_completed:
 ⛔ HARD GATE - SCRIPT EXECUTION REQUIRED
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 You CANNOT report bolt completion without:
-1. Running the bolt-complete.js script
+1. Running the bolt-complete.cjs script
 2. Showing the script output to the user
 
 If you skip this, the memory-bank becomes inconsistent.
@@ -245,7 +245,7 @@ Do NOT manually edit story files - the script handles everything.
 **Run this command:**
 
 ```bash
-node .specsmd/aidlc/scripts/bolt-complete.js {bolt-id}
+node .specsmd/aidlc/scripts/bolt-complete.cjs {bolt-id}
 ```
 
 **What this command does (deterministically):**

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

@@ -20,8 +20,8 @@ You are the **Builder Agent** for FIRE (Fast Intent-Run Engineering).
   <constraint>ALWAYS create plan.md BEFORE implementation</constraint>
   <constraint>ALWAYS create test-report.md AFTER tests pass</constraint>
   <constraint>ALWAYS run code-review after tests complete</constraint>
-  <constraint>MUST use init-run.js to create runs — no mkdir</constraint>
-  <constraint>MUST use complete-run.js to finalize — no manual edits</constraint>
+  <constraint>MUST use init-run.cjs to create runs — no mkdir</constraint>
+  <constraint>MUST use complete-run.cjs to finalize — no manual edits</constraint>
 </constraints>
 
 <on_activation>
@@ -73,7 +73,7 @@ You are the **Builder Agent** for FIRE (Fast Intent-Run Engineering).
   <mode name="autopilot" checkpoints="0">
     <description>For bug fixes, minor updates, low-complexity tasks</description>
     <flow>
-      <step n="1">Call init-run.js to initialize run (creates run folder + run.md)</step>
+      <step n="1">Call init-run.cjs to initialize run (creates run folder + run.md)</step>
       <step n="2">Load work item and context</step>
       <step n="3">Create plan.md (no checkpoint pause)</step>
       <step n="4">Execute implementation directly</step>
@@ -81,14 +81,14 @@ You are the **Builder Agent** for FIRE (Fast Intent-Run Engineering).
       <step n="6">Create test-report.md</step>
       <step n="7">Run code-review skill</step>
       <step n="8">Generate walkthrough</step>
-      <step n="9">Call complete-run.js to finalize</step>
+      <step n="9">Call complete-run.cjs to finalize</step>
     </flow>
   </mode>
 
   <mode name="confirm" checkpoints="1">
     <description>For standard features, medium-complexity tasks</description>
     <flow>
-      <step n="1">Call init-run.js to initialize run</step>
+      <step n="1">Call init-run.cjs to initialize run</step>
       <step n="2">Load work item and context</step>
       <step n="3">Generate implementation plan → save to plan.md</step>
       <step n="4"><checkpoint>Present plan to user for approval</checkpoint></step>
@@ -97,14 +97,14 @@ You are the **Builder Agent** for FIRE (Fast Intent-Run Engineering).
       <step n="7">Create test-report.md</step>
       <step n="8">Run code-review skill</step>
       <step n="9">Generate walkthrough</step>
-      <step n="10">Call complete-run.js to finalize</step>
+      <step n="10">Call complete-run.cjs to finalize</step>
     </flow>
   </mode>
 
   <mode name="validate" checkpoints="2">
     <description>For security features, payments, core architecture</description>
     <flow>
-      <step n="1">Call init-run.js to initialize run</step>
+      <step n="1">Call init-run.cjs to initialize run</step>
       <step n="2">Load work item and design doc</step>
       <step n="3"><checkpoint>Design doc review (done by Planner)</checkpoint></step>
       <step n="4">Generate implementation plan → save to plan.md</step>
@@ -114,7 +114,7 @@ You are the **Builder Agent** for FIRE (Fast Intent-Run Engineering).
       <step n="8">Create test-report.md</step>
       <step n="9">Run code-review skill</step>
       <step n="10">Generate walkthrough</step>
-      <step n="11">Call complete-run.js to finalize</step>
+      <step n="11">Call complete-run.cjs to finalize</step>
     </flow>
   </mode>
 </execution_modes>
@@ -152,21 +152,21 @@ You are the **Builder Agent** for FIRE (Fast Intent-Run Engineering).
 
   | Action | Script | Direct Editing |
   |--------|--------|----------------|
-  | Initialize run | `node scripts/init-run.js ...` | ❌ FORBIDDEN |
-  | Complete work item | `node scripts/complete-run.js ... --complete-item` | ❌ FORBIDDEN |
-  | Complete run | `node scripts/complete-run.js ... --complete-run` | ❌ FORBIDDEN |
-  | Create run folder | (handled by init-run.js) | ❌ NO mkdir |
-  | Create run.md | (handled by init-run.js) | ❌ NO direct write |
+  | Initialize run | `node scripts/init-run.cjs ...` | ❌ FORBIDDEN |
+  | Complete work item | `node scripts/complete-run.cjs ... --complete-item` | ❌ FORBIDDEN |
+  | Complete run | `node scripts/complete-run.cjs ... --complete-run` | ❌ FORBIDDEN |
+  | Create run folder | (handled by init-run.cjs) | ❌ NO mkdir |
+  | Create run.md | (handled by init-run.cjs) | ❌ NO direct write |
   | Update state.yaml | (handled by scripts) | ❌ NO direct edit |
 
   <check if="about to mkdir .specs-fire/runs/run-XXX">
-    <action>STOP — use init-run.js instead</action>
+    <action>STOP — use init-run.cjs instead</action>
   </check>
   <check if="about to edit state.yaml directly">
-    <action>STOP — use complete-run.js instead</action>
+    <action>STOP — use complete-run.cjs instead</action>
   </check>
   <check if="about to write run.md directly">
-    <action>STOP — use init-run.js instead</action>
+    <action>STOP — use init-run.cjs instead</action>
   </check>
 </script_usage>
 
@@ -192,7 +192,7 @@ You are the **Builder Agent** for FIRE (Fast Intent-Run Engineering).
   <artifact_timing critical="true">
     | Artifact | Created By | When |
     |----------|------------|------|
-    | run.md | init-run.js script | At run START |
+    | run.md | init-run.cjs script | At run START |
     | plan.md | Agent (template) | BEFORE implementation |
     | test-report.md | Agent (template) | AFTER tests pass |
     | review-report.md | code-review skill | AFTER test report |

package/flows/fire/agents/builder/skills/run-execute/SKILL.md

@@ -80,7 +80,7 @@ Supports both single-item and multi-item (batch/wide) runs.
 </degrees_of_freedom>
 
 <llm critical="true">
-  <mandate>USE SCRIPTS — NEVER bypass init-run.js or complete-run.js</mandate>
+  <mandate>USE SCRIPTS — NEVER bypass init-run.cjs or complete-run.cjs</mandate>
   <mandate>ALWAYS CREATE plan.md — Create plan BEFORE implementation starts (ALL modes)</mandate>
   <mandate>ALWAYS CREATE test-report.md — Create test report AFTER tests complete</mandate>
   <mandate>ALWAYS RUN code-review — Invoke code-review skill after tests pass</mandate>
@@ -94,7 +94,7 @@ Supports both single-item and multi-item (batch/wide) runs.
 
   | Artifact | When Created | Created By |
   |----------|--------------|------------|
-  | run.md | Start of run | init-run.js script |
+  | run.md | Start of run | init-run.cjs script |
   | plan.md | BEFORE implementation (Step 4) | Agent using template |
   | test-report.md | AFTER tests pass (Step 6) | Agent using template |
   | review-report.md | AFTER test report (Step 6b) | code-review skill |
@@ -105,16 +105,16 @@ Supports both single-item and multi-item (batch/wide) runs.
 
 <flow>
   <step n="1" title="Initialize Run">
-    <critical>MUST call init-run.js script. DO NOT use mkdir directly.</critical>
+    <critical>MUST call init-run.cjs script. DO NOT use mkdir directly.</critical>
     <note>The script creates BOTH the folder AND run.md file.</note>
 
     <action>Prepare work items JSON array:</action>
     <code>
       # For single item:
-      node scripts/init-run.js {rootPath} {workItemId} {intentId} {mode}
+      node scripts/init-run.cjs {rootPath} {workItemId} {intentId} {mode}
 
       # For batch/wide (multiple items):
-      node scripts/init-run.js {rootPath} --batch '[
+      node scripts/init-run.cjs {rootPath} --batch '[
         {"id": "item-1", "intent": "intent-1", "mode": "autopilot"},
         {"id": "item-2", "intent": "intent-1", "mode": "confirm"}
       ]' --scope=batch
@@ -124,7 +124,7 @@ Supports both single-item and multi-item (batch/wide) runs.
     <action>Verify run.md was created in .specs-fire/runs/{run-id}/</action>
 
     <check if="run.md not found">
-      <error>init-run.js failed to create run.md. Check script output.</error>
+      <error>init-run.cjs failed to create run.md. Check script output.</error>
     </check>
   </step>
 
@@ -457,9 +457,9 @@ Supports both single-item and multi-item (batch/wide) runs.
     <substep n="7b" title="Route Based on Batch Status">
       <check if="scope in [batch, wide] AND pending_count > 0">
         <critical>DO NOT call --complete-run yet - more items remain!</critical>
-        <action>Call complete-run.js with --complete-item flag:</action>
+        <action>Call complete-run.cjs with --complete-item flag:</action>
         <code>
-          node scripts/complete-run.js {rootPath} {runId} --complete-item
+          node scripts/complete-run.cjs {rootPath} {runId} --complete-item
         </code>
         <action>Parse output JSON for nextItem and remainingItems</action>
         <output>
@@ -472,9 +472,9 @@ Supports both single-item and multi-item (batch/wide) runs.
 
       <check if="scope == single OR pending_count == 0">
         <action>All items complete - finalize the run</action>
-        <action>Call complete-run.js with --complete-run flag:</action>
+        <action>Call complete-run.cjs with --complete-run flag:</action>
         <code>
-          node scripts/complete-run.js {rootPath} {runId} --complete-run \
+          node scripts/complete-run.cjs {rootPath} {runId} --complete-run \
             --files-created='[{"path":"...","purpose":"..."}]' \
             --files-modified='[{"path":"...","changes":"..."}]' \
             --tests=5 --coverage=85
@@ -510,16 +510,16 @@ Supports both single-item and multi-item (batch/wide) runs.
 <scripts>
   | Script | Purpose | Usage |
   |--------|---------|-------|
-  | `scripts/init-run.js` | Initialize run record and folder | Creates run.md with all work items |
-  | `scripts/complete-run.js` | Finalize run and update state | `--complete-item` or `--complete-run` |
+  | `scripts/init-run.cjs` | Initialize run record and folder | Creates run.md with all work items |
+  | `scripts/complete-run.cjs` | Finalize run and update state | `--complete-item` or `--complete-run` |
 
-  <script name="init-run.js">
+  <script name="init-run.cjs">
     ```bash
     # Single work item
-    node scripts/init-run.js /project work-item-id intent-id autopilot
+    node scripts/init-run.cjs /project work-item-id intent-id autopilot
 
     # Batch/wide (multiple items)
-    node scripts/init-run.js /project --batch '[
+    node scripts/init-run.cjs /project --batch '[
       {"id": "wi-1", "intent": "int-1", "mode": "autopilot"},
       {"id": "wi-2", "intent": "int-1", "mode": "confirm"}
     ]' --scope=batch
@@ -539,13 +539,13 @@ Supports both single-item and multi-item (batch/wide) runs.
     </output_format>
   </script>
 
-  <script name="complete-run.js">
+  <script name="complete-run.cjs">
     ```bash
     # Complete current item (batch runs - moves to next item)
-    node scripts/complete-run.js /project run-001 --complete-item
+    node scripts/complete-run.cjs /project run-001 --complete-item
 
     # Complete entire run (single runs or final item in batch)
-    node scripts/complete-run.js /project run-001 --complete-run \
+    node scripts/complete-run.cjs /project run-001 --complete-run \
       --files-created='[{"path":"src/new.ts","purpose":"New feature"}]' \
       --files-modified='[{"path":"src/old.ts","changes":"Added import"}]' \
       --tests=5 --coverage=85
@@ -597,11 +597,11 @@ Supports both single-item and multi-item (batch/wide) runs.
 </file_tracking_format>
 
 <run_folder_structure>
-  After init-run.js creates a run:
+  After init-run.cjs creates a run:
 
   ```
   .specs-fire/runs/run-001/
-  ├── run.md           # Created by init-run.js, updated by complete-run.js
+  ├── run.md           # Created by init-run.cjs, updated by complete-run.cjs
   ├── plan.md          # Created BEFORE implementation (ALL modes - required)
   ├── test-report.md   # Created AFTER tests pass (required)
   ├── review-report.md # Created by code-review skill (Step 6b)
@@ -609,7 +609,7 @@ Supports both single-item and multi-item (batch/wide) runs.
   ```
 
   <timeline>
-    1. `run.md` — Created at run start by init-run.js
+    1. `run.md` — Created at run start by init-run.cjs
     2. `plan.md` — Created BEFORE implementation begins (Step 4)
     3. `test-report.md` — Created AFTER tests pass (Step 6)
     4. `review-report.md` — Created by code-review skill (Step 6b)
@@ -626,7 +626,7 @@ Supports both single-item and multi-item (batch/wide) runs.
 </run_folder_structure>
 
 <success_criteria>
-  <criterion>Run initialized via init-run.js script</criterion>
+  <criterion>Run initialized via init-run.cjs script</criterion>
   <criterion>Standards loaded with hierarchical resolution</criterion>
   <criterion>Constitution loaded from root (if exists)</criterion>
   <criterion>Module-specific standards applied to module files</criterion>
@@ -636,6 +636,6 @@ Supports both single-item and multi-item (batch/wide) runs.
   <criterion>test-report.md created AFTER tests pass</criterion>
   <criterion>code-review skill invoked and completed</criterion>
   <criterion>review-report.md created</criterion>
-  <criterion>Run completed via complete-run.js script</criterion>
+  <criterion>Run completed via complete-run.cjs script</criterion>
   <criterion>walkthrough.md generated</criterion>
 </success_criteria>

package/flows/fire/agents/builder/skills/run-execute/scripts/{complete-run.js → complete-run.cjs}

@@ -11,9 +11,9 @@
  *   - --complete-run: Marks all items done and finalizes entire run
  *
  * Usage:
- *   Complete current item:  node complete-run.js <rootPath> <runId> --complete-item [options]
- *   Complete entire run:    node complete-run.js <rootPath> <runId> --complete-run [options]
- *   Complete (single/auto): node complete-run.js <rootPath> <runId> [options]
+ *   Complete current item:  node complete-run.cjs <rootPath> <runId> --complete-item [options]
+ *   Complete entire run:    node complete-run.cjs <rootPath> <runId> --complete-run [options]
+ *   Complete (single/auto): node complete-run.cjs <rootPath> <runId> [options]
  *
  * Options:
  *   --files-created=JSON   - JSON array of {path, purpose}
@@ -678,9 +678,9 @@ function parseArgs(args) {
 
 function printUsage() {
   console.error('Usage:');
-  console.error('  Complete current item: node complete-run.js <rootPath> <runId> --complete-item [options]');
-  console.error('  Complete entire run:   node complete-run.js <rootPath> <runId> --complete-run [options]');
-  console.error('  Auto (single runs):    node complete-run.js <rootPath> <runId> [options]');
+  console.error('  Complete current item: node complete-run.cjs <rootPath> <runId> --complete-item [options]');
+  console.error('  Complete entire run:   node complete-run.cjs <rootPath> <runId> --complete-run [options]');
+  console.error('  Auto (single runs):    node complete-run.cjs <rootPath> <runId> [options]');
   console.error('');
   console.error('Arguments:');
   console.error('  rootPath  - Project root directory');
@@ -698,8 +698,8 @@ function printUsage() {
   console.error('  --coverage=N           - Coverage percentage');
   console.error('');
   console.error('Examples:');
-  console.error('  node complete-run.js /project run-003 --complete-item');
-  console.error('  node complete-run.js /project run-003 --complete-run --tests=5 --coverage=85');
+  console.error('  node complete-run.cjs /project run-003 --complete-item');
+  console.error('  node complete-run.cjs /project run-003 --complete-run --tests=5 --coverage=85');
 }
 
 // =============================================================================

package/flows/fire/agents/builder/skills/run-execute/scripts/{init-run.js → init-run.cjs}

@@ -11,12 +11,12 @@
  * - existing run folders in .specs-fire/runs/
  *
  * Usage:
- *   Single item: node init-run.js <rootPath> <workItemId> <intentId> <mode>
- *   Batch/Wide:  node init-run.js <rootPath> --batch '<workItemsJson>'
+ *   Single item: node init-run.cjs <rootPath> <workItemId> <intentId> <mode>
+ *   Batch/Wide:  node init-run.cjs <rootPath> --batch '<workItemsJson>'
  *
  * Examples:
- *   node init-run.js /project login-endpoint user-auth confirm
- *   node init-run.js /project --batch '[{"id":"wi-1","intent":"int-1","mode":"autopilot"}]'
+ *   node init-run.cjs /project login-endpoint user-auth confirm
+ *   node init-run.cjs /project --batch '[{"id":"wi-1","intent":"int-1","mode":"autopilot"}]'
  */
 
 const fs = require('fs');
@@ -377,8 +377,8 @@ function initRun(rootPath, workItems, scope) {
 
 function printUsage() {
   console.error('Usage:');
-  console.error('  Single item: node init-run.js <rootPath> <workItemId> <intentId> <mode>');
-  console.error('  Batch/Wide:  node init-run.js <rootPath> --batch \'<workItemsJson>\' [--scope=<scope>]');
+  console.error('  Single item: node init-run.cjs <rootPath> <workItemId> <intentId> <mode>');
+  console.error('  Batch/Wide:  node init-run.cjs <rootPath> --batch \'<workItemsJson>\' [--scope=<scope>]');
   console.error('');
   console.error('Arguments:');
   console.error('  rootPath      - Project root directory');
@@ -394,8 +394,8 @@ function printUsage() {
   console.error('  [{"id": "wi-1", "intent": "int-1", "mode": "autopilot"}, ...]');
   console.error('');
   console.error('Examples:');
-  console.error('  node init-run.js /project login-endpoint user-auth confirm');
-  console.error('  node init-run.js /project --batch \'[{"id":"wi-1","intent":"int-1","mode":"autopilot"}]\'');
+  console.error('  node init-run.cjs /project login-endpoint user-auth confirm');
+  console.error('  node init-run.cjs /project --batch \'[{"id":"wi-1","intent":"int-1","mode":"autopilot"}]\'');
 }
 
 if (require.main === module) {

package/flows/fire/memory-bank.yaml

@@ -97,7 +97,7 @@ naming:
     example: "run-001/"
     note: "Sequential 3-digit number, folder per run"
     contents:
-      - "run.md"           # Run log (created by init-run.js)
+      - "run.md"           # Run log (created by init-run.cjs)
       - "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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specsmd",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "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": {