@grainulation/wheat 1.0.3 → 1.0.5

package/lib/stats.js

@@ -9,42 +9,38 @@
  * Zero npm dependencies.
  */
 
-import fs from 'fs';
-import path from 'path';
+import fs from "fs";
+import path from "path";
+import { loadClaims } from "./load-claims.js";
 
 // ─── Helpers ──────────────────────────────────────────────────────────────────
 
-/** Safely parse JSON from a file path; returns null on failure. */
-function loadJSON(filePath) {
-  try {
-    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
 /** Find all claims.json files in repo (root + examples/). */
 function findAllClaims(dir) {
   const results = [];
 
   // Root-level claims.json
-  const rootClaims = path.join(dir, 'claims.json');
+  const rootClaims = path.join(dir, "claims.json");
   if (fs.existsSync(rootClaims)) {
-    results.push({ path: rootClaims, label: '.' });
+    results.push({ path: rootClaims, label: "." });
   }
 
   // examples/<name>/claims.json
-  const examplesDir = path.join(dir, 'examples');
+  const examplesDir = path.join(dir, "examples");
   if (fs.existsSync(examplesDir)) {
     try {
-      for (const entry of fs.readdirSync(examplesDir, { withFileTypes: true })) {
+      for (const entry of fs.readdirSync(examplesDir, {
+        withFileTypes: true,
+      })) {
         if (!entry.isDirectory()) continue;
-        const claimsPath = path.join(examplesDir, entry.name, 'claims.json');
+        const claimsPath = path.join(examplesDir, entry.name, "claims.json");
         if (fs.existsSync(claimsPath)) {
           results.push({ path: claimsPath, label: `examples/${entry.name}` });
         }
       }
-    } catch { /* skip if unreadable */ }
+    } catch {
+      /* skip if unreadable */
+    }
   }
 
   return results;
@@ -57,7 +53,7 @@ export async function run(dir, _args) {
 
   if (sprintFiles.length === 0) {
     console.log();
-    console.log('  No sprints found in this directory.');
+    console.log("  No sprints found in this directory.");
     console.log('  Run "wheat init" to start a research sprint.');
     console.log();
     process.exit(0);
@@ -72,12 +68,14 @@ export async function run(dir, _args) {
   const sprintSummaries = [];
 
   for (const sf of sprintFiles) {
-    const data = loadJSON(sf.path);
+    const sfDir = path.dirname(sf.path);
+    const sfFilename = path.basename(sf.path);
+    const { data } = loadClaims(sfDir, { filename: sfFilename });
     if (!data) continue;
 
     const meta = data.meta || {};
     const claims = data.claims || [];
-    const active = claims.filter(c => c.status === 'active');
+    const active = claims.filter((c) => c.status === "active");
 
     totalClaims += claims.length;
 
@@ -89,24 +87,25 @@ export async function run(dir, _args) {
 
     // Accumulate by phase_added
     for (const c of claims) {
-      const phase = c.phase_added || 'unknown';
+      const phase = c.phase_added || "unknown";
       byPhase[phase] = (byPhase[phase] || 0) + 1;
     }
 
     // Accumulate by type
     for (const c of claims) {
-      byType[c.type || 'unknown'] = (byType[c.type || 'unknown'] || 0) + 1;
+      byType[c.type || "unknown"] = (byType[c.type || "unknown"] || 0) + 1;
     }
 
     // Accumulate by evidence tier
     for (const c of claims) {
-      byEvidence[c.evidence || 'unknown'] = (byEvidence[c.evidence || 'unknown'] || 0) + 1;
+      byEvidence[c.evidence || "unknown"] =
+        (byEvidence[c.evidence || "unknown"] || 0) + 1;
     }
 
     sprintSummaries.push({
       label: sf.label,
-      question: (meta.question || '').slice(0, 60),
-      phase: meta.phase || 'unknown',
+      question: (meta.question || "").slice(0, 60),
+      phase: meta.phase || "unknown",
       claims: claims.length,
       active: active.length,
     });
@@ -115,8 +114,8 @@ export async function run(dir, _args) {
   // ─── Print ────────────────────────────────────────────────────────────────
 
   console.log();
-  console.log('  \x1b[1mwheat stats\x1b[0m — local sprint statistics');
-  console.log(`  ${'─'.repeat(50)}`);
+  console.log("  \x1b[1mwheat stats\x1b[0m — local sprint statistics");
+  console.log(`  ${"─".repeat(50)}`);
   console.log();
 
   // Sprint count
@@ -126,14 +125,24 @@ export async function run(dir, _args) {
   // Age
   if (earliestDate) {
     const days = Math.floor((Date.now() - earliestDate.getTime()) / 86400000);
-    console.log(`  Age:         ${days} days since first sprint (${earliestDate.toISOString().slice(0, 10)})`);
+    console.log(
+      `  Age:         ${days} days since first sprint (${earliestDate
+        .toISOString()
+        .slice(0, 10)})`
+    );
   }
 
   console.log();
 
   // By phase
-  console.log('  \x1b[1mClaims by phase:\x1b[0m');
-  const phaseOrder = ['define', 'research', 'prototype', 'evaluate', 'feedback'];
+  console.log("  \x1b[1mClaims by phase:\x1b[0m");
+  const phaseOrder = [
+    "define",
+    "research",
+    "prototype",
+    "evaluate",
+    "feedback",
+  ];
   const allPhases = [...new Set([...phaseOrder, ...Object.keys(byPhase)])];
   for (const p of allPhases) {
     if (byPhase[p]) {
@@ -144,8 +153,15 @@ export async function run(dir, _args) {
   console.log();
 
   // By type
-  console.log('  \x1b[1mClaims by type:\x1b[0m');
-  const typeOrder = ['constraint', 'factual', 'estimate', 'risk', 'recommendation', 'feedback'];
+  console.log("  \x1b[1mClaims by type:\x1b[0m");
+  const typeOrder = [
+    "constraint",
+    "factual",
+    "estimate",
+    "risk",
+    "recommendation",
+    "feedback",
+  ];
   const allTypes = [...new Set([...typeOrder, ...Object.keys(byType)])];
   for (const t of allTypes) {
     if (byType[t]) {
@@ -156,9 +172,11 @@ export async function run(dir, _args) {
   console.log();
 
   // By evidence tier
-  console.log('  \x1b[1mClaims by evidence:\x1b[0m');
-  const evidenceOrder = ['stated', 'web', 'documented', 'tested', 'production'];
-  const allEvidence = [...new Set([...evidenceOrder, ...Object.keys(byEvidence)])];
+  console.log("  \x1b[1mClaims by evidence:\x1b[0m");
+  const evidenceOrder = ["stated", "web", "documented", "tested", "production"];
+  const allEvidence = [
+    ...new Set([...evidenceOrder, ...Object.keys(byEvidence)]),
+  ];
   for (const e of allEvidence) {
     if (byEvidence[e]) {
       console.log(`    ${e.padEnd(14)} ${byEvidence[e]}`);
@@ -169,16 +187,24 @@ export async function run(dir, _args) {
 
   // Per-sprint table
   if (sprintFiles.length > 1) {
-    console.log('  \x1b[1mPer-sprint breakdown:\x1b[0m');
+    console.log("  \x1b[1mPer-sprint breakdown:\x1b[0m");
     for (const s of sprintSummaries) {
-      console.log(`    ${s.label.padEnd(30)} ${String(s.claims).padStart(4)} claims  (${s.active} active)  [${s.phase}]`);
+      console.log(
+        `    ${s.label.padEnd(30)} ${String(s.claims).padStart(4)} claims  (${
+          s.active
+        } active)  [${s.phase}]`
+      );
       if (s.question) {
-        console.log(`      "${s.question}${s.question.length >= 60 ? '...' : ''}"`);
+        console.log(
+          `      "${s.question}${s.question.length >= 60 ? "..." : ""}"`
+        );
       }
     }
     console.log();
   }
 
-  console.log('  No data leaves your machine. This is local self-inspection only.');
+  console.log(
+    "  No data leaves your machine. This is local self-inspection only."
+  );
   console.log();
 }

package/lib/status.js

@@ -7,34 +7,48 @@
  * Zero npm dependencies.
  */
 
-import fs from 'fs';
-import path from 'path';
-import { compile } from '../compiler/wheat-compiler.js';
+import fs from "fs";
+import path from "path";
+import { compile } from "../compiler/wheat-compiler.js";
+import { loadClaims } from "./load-claims.js";
 
 export async function run(dir, args) {
-  const jsonMode = args.includes('--json');
-  const claimsPath = path.join(dir, 'claims.json');
+  const jsonMode = args.includes("--json");
+  const claimsPath = path.join(dir, "claims.json");
 
   if (!fs.existsSync(claimsPath)) {
     if (jsonMode) {
-      console.log(JSON.stringify({ error: 'no_sprint', message: 'No sprint found in this directory.' }));
+      console.log(
+        JSON.stringify({
+          error: "no_sprint",
+          message: "No sprint found in this directory.",
+        })
+      );
       process.exit(0);
     }
     console.log();
-    console.log('  No sprint found in this directory.');
+    console.log("  No sprint found in this directory.");
     console.log('  Run "wheat init" to start a research sprint.');
     console.log();
     process.exit(0);
   }
 
-  const claimsData = JSON.parse(fs.readFileSync(claimsPath, 'utf8'));
-  const compilationPath = path.join(dir, 'compilation.json');
+  const { data: claimsData, errors: loadErrors } = loadClaims(dir);
+  if (!claimsData) {
+    const msg =
+      loadErrors.length > 0
+        ? loadErrors[0].message
+        : "Failed to load claims.json";
+    console.error(`  ${msg}`);
+    process.exit(1);
+  }
+  const compilationPath = path.join(dir, "compilation.json");
   const compilation = compile(claimsPath, compilationPath, dir);
 
   const meta = claimsData.meta || {};
   const claims = claimsData.claims || [];
-  const active = claims.filter(c => c.status === 'active');
-  const superseded = claims.filter(c => c.status === 'superseded');
+  const active = claims.filter((c) => c.status === "active");
+  const superseded = claims.filter((c) => c.status === "superseded");
 
   if (jsonMode) {
     const tiers = {};
@@ -43,9 +57,13 @@ export async function run(dir, args) {
     }
     const result = {
       question: meta.question || null,
-      phase: meta.phase || 'unknown',
+      phase: meta.phase || "unknown",
       status: compilation.status,
-      claims: { total: claims.length, active: active.length, superseded: superseded.length },
+      claims: {
+        total: claims.length,
+        active: active.length,
+        superseded: superseded.length,
+      },
       evidence: tiers,
     };
     if (compilation.conflicts) {
@@ -58,28 +76,35 @@ export async function run(dir, args) {
       result.topics = Object.keys(compilation.coverage);
     }
     if (meta.initiated) {
-      const days = Math.floor((Date.now() - new Date(meta.initiated).getTime()) / 86400000);
+      const days = Math.floor(
+        (Date.now() - new Date(meta.initiated).getTime()) / 86400000
+      );
       result.age = { days, initiated: meta.initiated };
     }
     console.log(JSON.stringify(result, null, 2));
     process.exit(0);
   }
 
-  const icon = compilation.status === 'ready' ? '\x1b[32m●\x1b[0m' : '\x1b[31m●\x1b[0m';
+  const icon =
+    compilation.status === "ready" ? "\x1b[32m●\x1b[0m" : "\x1b[31m●\x1b[0m";
 
   console.log();
-  console.log(`  ${icon} \x1b[1m${meta.question || 'No question set'}\x1b[0m`);
-  console.log(`  ${'─'.repeat(50)}`);
-  console.log(`  Phase:       ${meta.phase || 'unknown'}`);
+  console.log(`  ${icon} \x1b[1m${meta.question || "No question set"}\x1b[0m`);
+  console.log(`  ${"─".repeat(50)}`);
+  console.log(`  Phase:       ${meta.phase || "unknown"}`);
   console.log(`  Status:      ${compilation.status}`);
-  console.log(`  Claims:      ${claims.length} total, ${active.length} active, ${superseded.length} superseded`);
+  console.log(
+    `  Claims:      ${claims.length} total, ${active.length} active, ${superseded.length} superseded`
+  );
 
   // Evidence breakdown
   const tiers = {};
   for (const c of active) {
     tiers[c.evidence] = (tiers[c.evidence] || 0) + 1;
   }
-  const tierStr = Object.entries(tiers).map(([k, v]) => `${k}:${v}`).join('  ');
+  const tierStr = Object.entries(tiers)
+    .map(([k, v]) => `${k}:${v}`)
+    .join("  ");
   if (tierStr) {
     console.log(`  Evidence:    ${tierStr}`);
   }
@@ -88,46 +113,52 @@ export async function run(dir, args) {
   if (compilation.conflicts) {
     const { resolved, unresolved } = compilation.conflicts;
     if (resolved.length > 0 || unresolved.length > 0) {
-      console.log(`  Conflicts:   ${resolved.length} resolved, ${unresolved.length} unresolved`);
+      console.log(
+        `  Conflicts:   ${resolved.length} resolved, ${unresolved.length} unresolved`
+      );
     }
   }
 
   // Topics
   if (compilation.coverage) {
     const topics = Object.keys(compilation.coverage);
-    console.log(`  Topics:      ${topics.length} (${topics.join(', ')})`);
+    console.log(`  Topics:      ${topics.length} (${topics.join(", ")})`);
   }
 
   // Initiated
   if (meta.initiated) {
-    const days = Math.floor((Date.now() - new Date(meta.initiated).getTime()) / 86400000);
+    const days = Math.floor(
+      (Date.now() - new Date(meta.initiated).getTime()) / 86400000
+    );
     console.log(`  Age:         ${days} days (since ${meta.initiated})`);
   }
 
   console.log();
 
   // Suggest next steps based on state
-  console.log('  Next steps:');
+  console.log("  Next steps:");
 
   if (compilation.conflicts?.unresolved?.length > 0) {
-    console.log('    /resolve         — resolve unresolved conflicts');
+    console.log("    /resolve         — resolve unresolved conflicts");
   }
 
   const weakTopics = Object.entries(compilation.coverage || {})
-    .filter(([, d]) => d.max_evidence === 'stated' || d.max_evidence === 'web')
+    .filter(([, d]) => d.max_evidence === "stated" || d.max_evidence === "web")
     .map(([t]) => t);
 
   if (weakTopics.length > 0) {
-    console.log(`    /research        — strengthen weak topics: ${weakTopics.join(', ')}`);
+    console.log(
+      `    /research        — strengthen weak topics: ${weakTopics.join(", ")}`
+    );
   }
 
-  if (meta.phase === 'define') {
-    console.log('    /research <topic> — start investigating');
-  } else if (meta.phase === 'research') {
-    console.log('    /prototype       — test your findings');
-  } else if (meta.phase === 'prototype' || meta.phase === 'evaluate') {
-    if (compilation.status === 'ready') {
-      console.log('    /brief           — compile the decision document');
+  if (meta.phase === "define") {
+    console.log("    /research <topic> — start investigating");
+  } else if (meta.phase === "research") {
+    console.log("    /prototype       — test your findings");
+  } else if (meta.phase === "prototype" || meta.phase === "evaluate") {
+    if (compilation.status === "ready") {
+      console.log("    /brief           — compile the decision document");
     }
   }
 

package/lib/update.js

@@ -7,27 +7,27 @@
  * Zero npm dependencies.
  */
 
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 function packageRoot() {
-  return path.resolve(__dirname, '..');
+  return path.resolve(__dirname, "..");
 }
 
 export async function run(dir, args) {
-  const force = args.includes('--force');
-  const srcDir = path.join(packageRoot(), 'templates', 'commands');
-  const destDir = path.join(dir, '.claude', 'commands');
+  const force = args.includes("--force");
+  const srcDir = path.join(packageRoot(), "templates", "commands");
+  const destDir = path.join(dir, ".claude", "commands");
 
   fs.mkdirSync(destDir, { recursive: true });
 
   let files;
   try {
-    files = fs.readdirSync(srcDir).filter(f => f.endsWith('.md'));
+    files = fs.readdirSync(srcDir).filter((f) => f.endsWith(".md"));
   } catch (err) {
     console.error(`Cannot read command templates: ${err.message}`);
     process.exit(1);
@@ -46,10 +46,12 @@ export async function run(dir, args) {
 
     if (fs.existsSync(dest) && !force) {
       // Check if content differs
-      const srcContent = fs.readFileSync(src, 'utf8');
-      const destContent = fs.readFileSync(dest, 'utf8');
+      const srcContent = fs.readFileSync(src, "utf8");
+      const destContent = fs.readFileSync(dest, "utf8");
       if (srcContent !== destContent) {
-        console.log(`  \x1b[33m~\x1b[0m ${file} (differs, use --force to overwrite)`);
+        console.log(
+          `  \x1b[33m~\x1b[0m ${file} (differs, use --force to overwrite)`
+        );
         skipped++;
       } else {
         console.log(`  \x1b[2m= ${file} (up to date)\x1b[0m`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grainulation/wheat",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Research-driven development framework — structured claims, compiled evidence, deterministic output",
   "license": "MIT",
   "author": "grainulation contributors",
@@ -32,7 +32,8 @@
     "./server": "./lib/server.js",
     "./guard": "./lib/guard.js",
     "./connect": "./lib/connect.js",
-    "./mcp": "./lib/serve-mcp.js"
+    "./mcp": "./lib/serve-mcp.js",
+    "./load-claims": "./lib/load-claims.js"
   },
   "bin": {
     "wheat": "bin/wheat.js"
@@ -45,9 +46,12 @@
     "templates/"
   ],
   "scripts": {
-    "test": "node --test test/cli.test.js test/compiler.test.js test/guard.test.js test/init.test.js"
+    "test": "node --test test/cli.test.js test/compiler.test.js test/guard.test.js test/init.test.js test/migration.test.js"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.30.0"
   }
 }

package/templates/claude.md

@@ -23,32 +23,36 @@ When the user sends a plain message (no slash command), assess whether a Wheat c
 
 **Route by intent:**
 
-| User says something like... | Route to | Why |
-|---|---|---|
-| "look into X", "what about X", "explore X", "how does X work" | `/research X` | Information gathering |
-| "build X", "try X", "make a quick X", "test whether X" | `/prototype` | Hands-on validation |
-| "is p001 really true?", "I doubt X", "what if X is wrong" | `/challenge <id>` | Adversarial testing |
-| "check this: <url>", "does <url> support X", "verify X against <url>" | `/witness <id> <url>` | External corroboration |
-| "what are we missing", "any gaps?", "what haven't we considered" | `/blind-spot` | Structural gap analysis |
-| "where are we", "what's the status", "show me the dashboard" | `/status` | Sprint snapshot |
-| "write it up", "give me the recommendation", "summarize for the team" | `/brief` | Decision document |
-| "make slides", "prepare for the meeting" | `/present` | Stakeholder presentation |
-| "someone else is taking over", "hand this off", "document for successor" | `/handoff` | Knowledge transfer |
-| "combine with the other sprint", "merge these" | `/merge <path>` | Cross-sprint merge |
-| "how did we get here", "show the history", "what changed over time" | `/replay` | Sprint archaeology |
-| "we shipped, here's what happened", "actual results were X" | `/calibrate --outcome "X"` | Prediction scoring |
-| "the stakeholder said X", "new constraint: X", "change of direction" | `/feedback` | Stakeholder input |
-| "resolve the conflict", "pick between X and Y" | `/resolve` | Conflict adjudication |
-| "connect to <repo/jira/docs>" | `/connect <type> <target>` | External source linking |
+| User says something like...                                              | Route to                   | Why                         |
+| ------------------------------------------------------------------------ | -------------------------- | --------------------------- |
+| "look into X", "what about X", "explore X", "how does X work"            | `/research X`              | Information gathering       |
+| "build X", "try X", "make a quick X", "test whether X"                   | `/prototype`               | Hands-on validation         |
+| "is p001 really true?", "I doubt X", "what if X is wrong"                | `/challenge <id>`          | Adversarial testing         |
+| "check this: <url>", "does <url> support X", "verify X against <url>"    | `/witness <id> <url>`      | External corroboration      |
+| "what are we missing", "any gaps?", "what haven't we considered"         | `/blind-spot`              | Structural gap analysis     |
+| "where are we", "what's the status", "show me the dashboard"             | `/status`                  | Sprint snapshot             |
+| "write it up", "give me the recommendation", "summarize for the team"    | `/brief`                   | Decision document           |
+| "make slides", "prepare for the meeting"                                 | `/present`                 | Stakeholder presentation    |
+| "someone else is taking over", "hand this off", "document for successor" | `/handoff`                 | Knowledge transfer          |
+| "combine with the other sprint", "merge these"                           | `/merge <path>`            | Cross-sprint merge          |
+| "how did we get here", "show the history", "what changed over time"      | `/replay`                  | Sprint archaeology          |
+| "we shipped, here's what happened", "actual results were X"              | `/calibrate --outcome "X"` | Prediction scoring          |
+| "the stakeholder said X", "new constraint: X", "change of direction"     | `/feedback`                | Stakeholder input           |
+| "resolve the conflict", "pick between X and Y"                           | `/resolve`                 | Conflict adjudication       |
+| "connect to <repo/jira/docs>"                                            | `/connect <type> <target>` | External source linking     |
+| "publish to confluence", "push to wiki", "sync to slack"                 | `/sync <target>`           | Artifact publishing         |
+| "pull from deepwiki", "import from confluence", "backfill from repo"     | `/pull <source>`           | External knowledge backfill |
 
 **When NOT to route:** Questions about the framework itself ("how does the compiler work?"), code edits to wheat files, general conversation, ambiguous intent. When in doubt, ask: "That sounds like it could be a `/research` -- want me to run it as a full research pass, or just answer the question?"
 
 **Announce the routing:** Always tell the user what you're doing:
+
 > Running as `/research "SSE scalability"` -- this will create claims and compile. Say "just answer" if you wanted a quick response instead.
 
 This gives the user a chance to redirect before the full pipeline runs.
 
 ### Claims System (Bran IR)
+
 - All findings are tracked as typed claims in `claims.json`
 - Every slash command that produces findings MUST append claims
 - Every slash command that produces output artifacts MUST run `wheat compile` first
@@ -56,6 +60,7 @@ This gives the user a chance to redirect before the full pipeline runs.
 - The compiler is the enforcement layer -- if it says blocked, no artifact gets produced
 
 ### Claim Types
+
 - `constraint` -- hard requirements, non-negotiable boundaries
 - `factual` -- verifiable statements about the world
 - `estimate` -- projections, approximations, ranges
@@ -64,6 +69,7 @@ This gives the user a chance to redirect before the full pipeline runs.
 - `feedback` -- stakeholder input, opinions, direction changes
 
 ### Evidence Tiers (lowest to highest)
+
 1. `stated` -- stakeholder said it, no verification
 2. `web` -- found online, not independently verified
 3. `documented` -- in source code, official docs, or ADRs
@@ -71,6 +77,7 @@ This gives the user a chance to redirect before the full pipeline runs.
 5. `production` -- measured from live production systems
 
 ### Claim ID Prefixes
+
 - `d###` -- define phase (from /init)
 - `r###` -- research phase (from /research)
 - `p###` -- prototype phase (from /prototype)
@@ -83,6 +90,7 @@ This gives the user a chance to redirect before the full pipeline runs.
 - `<sprint-slug>-<prefix>###` -- merged claims keep original prefix with sprint slug (from /merge)
 
 ### Next Command Hints
+
 Every slash command MUST end its output with a "Next steps" section suggesting 2-4 concrete commands the user could run next, based on the current sprint state. Use this decision tree:
 
 - Unresolved conflicts exist -> suggest `/resolve`
@@ -92,10 +100,13 @@ Every slash command MUST end its output with a "Next steps" section suggesting 2
 - Sprint is late-phase with gaps -> suggest `/blind-spot`
 - Claims untested against reality -> suggest `/calibrate`
 - Sprint ready for output -> suggest `/brief`, `/present`, or `/handoff`
+- Sprint ready and external wiki configured -> suggest `/sync confluence`
+- Need external context -> suggest `/pull deepwiki <repo>` or `/pull confluence`
 - Multiple sprints exist -> suggest `/merge`
 - Want to understand history -> suggest `/replay`
 
 Format:
+
 ```
 Next steps:
   /challenge p001     -- stress-test the zero-deps claim
@@ -104,18 +115,21 @@ Next steps:
 ```
 
 ### Git Discipline
+
 - Every slash command that modifies claims.json auto-commits
 - Commit format: `wheat: /<command> <summary> -- added/updated <claim IDs>`
 - `git log --oneline claims.json` = the sprint event log
 - Compilation certificate references the claims hash for reproducibility
 
 ### Output Artifacts
+
 - HTML files are self-contained (inline CSS/JS, no external deps)
 - Use the dark scroll-snap template for explainers and presentations
 - Use the dashboard template for status and comparisons
 - PDFs generated via `node build-pdf.js <file.md>`
 
 ### Directory Structure
+
 - `research/` -- topic explainers (HTML + MD)
 - `prototypes/` -- working proof-of-concepts
 - `evidence/` -- evaluation results and comparison dashboards

package/templates/commands/blind-spot.md

@@ -1,10 +1,11 @@
 # /blind-spot — Analyze What's NOT Being Claimed
 
-You are scanning the claim set for structural gaps — not what's wrong, but what's *missing*. Read CLAUDE.md for sprint context, claims.json for existing claims, and compilation.json for coverage data.
+You are scanning the claim set for structural gaps — not what's wrong, but what's _missing_. Read CLAUDE.md for sprint context, claims.json for existing claims, and compilation.json for coverage data.
 
 ## Process
 
 1. **Run the compiler** to get fresh data:
+
    ```bash
    npx @grainulation/wheat compile --summary
    ```
@@ -14,20 +15,26 @@ You are scanning the claim set for structural gaps — not what's wrong, but wha
 3. **Analyze four categories of blind spots**:
 
 ### (a) Dependency gaps
+
 Scan claim content for topic-like nouns that are NOT in the current topic set. If claims reference concepts like "latency," "compliance," "security," "cost," or "performance" but no topic covers those, they're implicit dependencies never addressed.
 
 ### (b) Type monoculture
+
 Check `type_diversity` in coverage for each topic. Flag topics with < 2 distinct claim types. A topic with 5 factual claims but no risks is suspicious — where's the downside analysis?
 
 ### (c) Echo chambers
+
 Check `source_origins` and `source_count` in coverage for each topic. Flag topics where:
+
 - All claims come from a single source origin (e.g., all "research" with no external feedback)
 - Claims >= 3 but source_count == 1
 
 ### (d) Evidence ceiling
+
 Check `max_evidence` relative to the current sprint phase. If the sprint phase is `prototype` but a key topic is still at `stated` or `web` tier, that's a gap.
 
 Phase expectations:
+
 - `define`: `stated` is fine everywhere
 - `research`: key topics should be at least `web`
 - `prototype`: key topics should be at least `tested`
@@ -44,4 +51,4 @@ Phase expectations:
 - Remind them they can dismiss false-positive blind spots by adding to `meta.dismissed_blind_spots`
 - If no blind spots found, say so — a clean bill of health is valuable information
 
-$ARGUMENTS
+$ARGUMENTS