@gitwhy-cli/whyspec 0.1.0

package/dist/adapters/cursor.js

@@ -0,0 +1,220 @@
+import { WHYSPEC_COMMANDS, COMMAND_DESCRIPTIONS, } from "./types.js";
+/**
+ * Generate the Cursor command instructions for each WhySpec command.
+ * Cursor commands are plain markdown — no YAML frontmatter.
+ */
+function getCursorCommandContent(command) {
+    switch (command) {
+        case "plan":
+            return `# WhySpec Plan
+
+${COMMAND_DESCRIPTIONS.plan}
+
+## Objective
+
+Create a structured plan before coding — capturing intent, design decisions to make, and implementation tasks. This is the BEFORE side of the Decision Bridge.
+
+## Workflow
+
+1. Ask the developer 2-3 forcing questions:
+   - "What problem does this solve?"
+   - "What constraints exist?"
+   - "How will you know it works?"
+
+2. Call the WhySpec CLI to create the change folder:
+   \`\`\`bash
+   whyspec plan --json "<change-name>"
+   \`\`\`
+
+3. Parse the JSON response to get the folder path and templates.
+
+4. Create three files in the change folder:
+   - **intent.md** — Why this change exists, decisions to make, constraints, success criteria
+   - **design.md** — Technical approach, trade-off matrix, architecture, questions to resolve
+   - **tasks.md** — Verification criteria (defined FIRST), then implementation checklist
+
+5. Each decision-to-make should be a checkbox: \`- [ ] Token storage: cookie vs localStorage?\`
+
+## Important
+
+- Always call the CLI first — it handles path creation and validation.
+- Capture COMPLETE reasoning, not abbreviated summaries.
+- The "Decisions to Make" section in design.md is the BEFORE side of the Decision Bridge.`;
+        case "execute":
+            return `# WhySpec Execute
+
+${COMMAND_DESCRIPTIONS.execute}
+
+## Objective
+
+Implement a planned change using the plan files as context. Track progress through the task list and commit atomically.
+
+## Workflow
+
+1. Call the WhySpec CLI to get execution context:
+   \`\`\`bash
+   whyspec execute --json "<change-name>"
+   \`\`\`
+
+2. Parse the JSON response to get intent, design, tasks, and progress.
+
+3. Read intent.md and design.md for WHY context — understand the goal before coding.
+
+4. Work through tasks.md sequentially:
+   - Show progress: "Working on task 3/7: <description>"
+   - Implement the code changes
+   - Mark each task complete: \`- [ ]\` → \`- [x]\` in tasks.md
+   - Commit atomically (one commit per task or logical unit)
+
+5. On completion, prompt: "Ready to capture reasoning? Run /whyspec-capture"
+
+## Important
+
+- Use intent.md as context while implementing — it contains the WHY.
+- Track deviations from the plan — surprises are valuable for capture.
+- Do not skip tasks or mark them done without implementing.`;
+        case "capture":
+            return `# WhySpec Capture
+
+${COMMAND_DESCRIPTIONS.capture}
+
+## Objective
+
+After coding, capture the reasoning behind what was built — completing the Decision Bridge by recording which decisions were made and why.
+
+## Workflow
+
+1. Call the WhySpec CLI to get the capture template:
+   \`\`\`bash
+   whyspec capture --json "<change-name>"
+   \`\`\`
+
+2. Parse the JSON response to get the template, linked commits, and files changed.
+
+3. Read intent.md and design.md from the change folder.
+
+4. Create a context file with:
+   - Map each "Decision to Make" from design.md → "Decisions Made" with rationale
+   - Map each "Question to Resolve" → resolved answer
+   - Capture "Surprises" — decisions NOT in the plan
+   - Include story, rejected alternatives, trade-offs, verification, risks
+
+## Important
+
+- Include ALL decisions, not just the ones from the plan.
+- Surprises (unplanned decisions) are the most valuable part of the capture.
+- This completes the Decision Bridge: plan PREDICTED decisions, capture RECORDS them.`;
+        case "show":
+            return `# WhySpec Show
+
+${COMMAND_DESCRIPTIONS.show}
+
+## Objective
+
+Display the full story of a change — from intent through design, tasks, and captured reasoning — with the Decision Bridge delta highlighted.
+
+## Workflow
+
+1. Call the WhySpec CLI to get the full change data:
+   \`\`\`bash
+   whyspec show --json "<change-name>"
+   \`\`\`
+
+2. Parse the JSON response containing intent, design, tasks, context, and Decision Bridge delta.
+
+3. Display the change story in sections:
+   - **Intent** — WHY (from intent.md)
+   - **Design** — HOW (from design.md)
+   - **Tasks** — WHAT (from tasks.md with completion status)
+   - **Context** — REASONING (from captured context)
+   - **Decision Bridge Delta** — Decisions to Make vs Decisions Made
+
+## Important
+
+- The Decision Bridge delta is the unique value — always show it.
+- If context hasn't been captured yet, show intent + design + tasks and suggest running /whyspec-capture.`;
+        case "search":
+            return `# WhySpec Search
+
+${COMMAND_DESCRIPTIONS.search}
+
+## Objective
+
+Find past decisions and reasoning across all changes — building institutional knowledge that improves future work.
+
+## Workflow
+
+1. Call the WhySpec CLI to search:
+   \`\`\`bash
+   whyspec search --json "<query>"
+   \`\`\`
+
+2. Parse the JSON response containing scored results with snippets.
+
+3. Display results ranked by relevance:
+   - Title matches score highest (100 points)
+   - Reasoning/decision matches score next (30 points)
+   - File path matches score lower (20 points)
+
+4. For each result, show: title, change name, score, and a relevant snippet.
+
+## Important
+
+- Search covers both active changes and archived ones.
+- Search also finds intent.md and design.md — not just captured contexts.
+- Use this before starting new work: "Has anyone reasoned about this area before?"`;
+        case "debug":
+            return `# WhySpec Debug
+
+${COMMAND_DESCRIPTIONS.debug}
+
+## Objective
+
+Investigate a bug using the scientific method — capturing symptoms, hypotheses, evidence, root cause, fix, and prevention. Searches past decisions for related context.
+
+## Workflow
+
+1. Call the WhySpec CLI to create a debug session:
+   \`\`\`bash
+   whyspec debug --json "<bug-description>"
+   \`\`\`
+
+2. Parse the JSON response to get the debug folder path and related past contexts.
+
+3. Follow the scientific method:
+   - **Symptoms** — Expected vs actual behavior, error messages, reproduction steps
+   - **Related contexts** — Check past decisions in this area (from CLI response)
+   - **Hypotheses** — Form 3+ falsifiable hypotheses with "what would prove this wrong?"
+   - **Investigation** — Test each hypothesis with evidence gathering
+   - **Root cause** — Prove the diagnosis BEFORE proposing a fix (Iron Law)
+   - **Fix** — Apply the fix and verify
+   - **Prevention** — How to prevent this class of bug in the future
+
+4. Create debug.md with the full investigation trail.
+
+5. On completion, prompt: "Ready to capture debug reasoning? Run /whyspec-capture"
+
+## Important
+
+- No fix without root cause — this is the Iron Law.
+- Check related past contexts BEFORE forming hypotheses.
+- The debug.md persists across sessions so investigation survives context resets.`;
+    }
+}
+/**
+ * Generate Cursor custom slash command files for all 6 WhySpec commands.
+ *
+ * Creates .cursor/commands/whyspec-<command>.md files — plain markdown
+ * that Cursor discovers automatically as slash commands.
+ *
+ * @param projectRoot - Optional project root prefix for paths (default: "")
+ * @returns Array of GeneratedFile objects
+ */
+export function generateCursorCommands(projectRoot = "") {
+    const prefix = projectRoot ? `${projectRoot}/` : "";
+    return WHYSPEC_COMMANDS.map((command) => ({
+        path: `${prefix}.cursor/commands/whyspec-${command}.md`,
+        content: getCursorCommandContent(command) + "\n",
+    }));
+}
+//# sourceMappingURL=cursor.js.map

package/dist/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/adapters/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,EAChB,oBAAoB,GAErB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,SAAS,uBAAuB,CAAC,OAAuB;IACtD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO;;EAEX,oBAAoB,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0FA+B+D,CAAC;QAEvF,KAAK,SAAS;YACZ,OAAO;;EAEX,oBAAoB,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4DA6B8B,CAAC;QAEzD,KAAK,SAAS;YACZ,OAAO;;EAEX,oBAAoB,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;sFA2BwD,CAAC;QAEnF,KAAK,MAAM;YACT,OAAO;;EAEX,oBAAoB,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;0GAyB+E,CAAC;QAEvG,KAAK,QAAQ;YACX,OAAO;;EAEX,oBAAoB,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;mFA0BsD,CAAC;QAEhF,KAAK,OAAO;YACV,OAAO;;EAEX,oBAAoB,CAAC,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kFAgCsD,CAAC;IACjF,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAAsB,EAAE;IAExB,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEpD,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,EAAE,GAAG,MAAM,4BAA4B,OAAO,KAAK;QACvD,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAG,IAAI;KACjD,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/adapters/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A file to be generated by an adapter.
+ * Adapters return these; the caller handles writing to disk.
+ */
+export interface GeneratedFile {
+    /** Relative path from project root (e.g., ".claude/skills/whyspec-plan/SKILL.md") */
+    path: string;
+    /** File content */
+    content: string;
+}
+/** The 6 WhySpec commands that adapters generate config for. */
+export declare const WHYSPEC_COMMANDS: readonly ["plan", "execute", "capture", "show", "search", "debug"];
+export type WhySpecCommand = (typeof WHYSPEC_COMMANDS)[number];
+/** One-line descriptions for each command, used across all adapters. */
+export declare const COMMAND_DESCRIPTIONS: Record<WhySpecCommand, string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,oEAOnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAO/D,CAAC"}

package/dist/adapters/types.js

@@ -0,0 +1,19 @@
+/** The 6 WhySpec commands that adapters generate config for. */
+export const WHYSPEC_COMMANDS = [
+    "plan",
+    "execute",
+    "capture",
+    "show",
+    "search",
+    "debug",
+];
+/** One-line descriptions for each command, used across all adapters. */
+export const COMMAND_DESCRIPTIONS = {
+    plan: "Declare intent and plan decisions before coding",
+    execute: "Implement from plan with full reasoning context",
+    capture: "Save the reasoning behind what was built",
+    show: "View the full story of a change with Decision Bridge delta",
+    search: "Search past decisions and reasoning across all changes",
+    debug: "Debug with the scientific method and capture root cause",
+};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAWA,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM;IACN,SAAS;IACT,SAAS;IACT,MAAM;IACN,QAAQ;IACR,OAAO;CACC,CAAC;AAIX,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAmC;IAClE,IAAI,EAAE,iDAAiD;IACvD,OAAO,EAAE,iDAAiD;IAC1D,OAAO,EAAE,0CAA0C;IACnD,IAAI,EAAE,4DAA4D;IAClE,MAAM,EAAE,wDAAwD;IAChE,KAAK,EAAE,yDAAyD;CACjE,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { runInit } from "../commands/init.js";
+import { planCommand } from "../commands/plan.js";
+import { executeCommand } from "../commands/execute.js";
+import { captureCommand } from "../commands/capture.js";
+import { showCommand } from "../commands/show.js";
+import { searchCommand } from "../commands/search.js";
+import { debugCommand } from "../commands/debug.js";
+import { listCommand } from "../commands/list.js";
+import { statusCommand } from "../commands/status.js";
+import { templateCommand } from "../commands/template.js";
+const program = new Command();
+program
+    .name("whyspec")
+    .description("The reasoning layer for AI-assisted development — capture WHY code was built the way it was")
+    .version("0.1.0")
+    .option("--json", "Output structured JSON for agent consumption");
+// ── init ────────────────────────────────────────────────────────────────────
+program
+    .command("init")
+    .description("Initialize WhySpec in the current project")
+    .action(async () => {
+    await runInit();
+});
+// ── plan ────────────────────────────────────────────────────────────────────
+program
+    .command("plan")
+    .description("Create a change folder with intent, design, and task templates")
+    .argument("[name]", "Name of the change (e.g., add-jwt-auth)")
+    .action(async (name, _opts, cmd) => {
+    const json = cmd.optsWithGlobals().json;
+    await planCommand(name, { json });
+});
+// ── execute ─────────────────────────────────────────────────────────────────
+program
+    .command("execute")
+    .description("Get execution context from a plan (intent + design + tasks)")
+    .argument("[name]", "Name of the change to execute")
+    .action(async (name, _opts, cmd) => {
+    const json = cmd.optsWithGlobals().json;
+    await executeCommand(name, { json });
+});
+// ── capture ─────────────────────────────────────────────────────────────────
+program
+    .command("capture")
+    .description("Capture reasoning after implementation (creates ctx_<id>.md)")
+    .argument("[name]", "Name of the change to capture")
+    .action(async (name, _opts, cmd) => {
+    const json = cmd.optsWithGlobals().json;
+    await captureCommand(name, { json });
+});
+// ── show ────────────────────────────────────────────────────────────────────
+program
+    .command("show")
+    .description("Display the full story of a change with Decision Bridge delta")
+    .argument("<name>", "Name of the change to show")
+    .action(async (name, _opts, cmd) => {
+    const json = cmd.optsWithGlobals().json;
+    await showCommand(name, { json });
+});
+// ── search ──────────────────────────────────────────────────────────────────
+program
+    .command("search")
+    .description("Search past decisions and reasoning across all changes")
+    .argument("<query>", "Search query")
+    .option("--domain <domain>", "Filter by domain")
+    .option("--limit <n>", "Maximum results", "10")
+    .action(async (query, opts, cmd) => {
+    const json = cmd.optsWithGlobals().json;
+    await searchCommand(query, { json, domain: opts.domain, limit: opts.limit });
+});
+// ── debug ───────────────────────────────────────────────────────────────────
+program
+    .command("debug")
+    .description("Create a structured debug session (scientific method)")
+    .argument("[name]", "Name or description of the bug")
+    .action(async (name, _opts, cmd) => {
+    const json = cmd.optsWithGlobals().json;
+    await debugCommand(name, { json });
+});
+// ── list ────────────────────────────────────────────────────────────────────
+program
+    .command("list")
+    .description("List all active changes with status")
+    .action(async (_opts, cmd) => {
+    const json = cmd.optsWithGlobals().json;
+    await listCommand({ json });
+});
+// ── status ──────────────────────────────────────────────────────────────────
+program
+    .command("status")
+    .description("Get detailed status for a change")
+    .argument("<name>", "Name of the change")
+    .action(async (name, _opts, cmd) => {
+    const json = cmd.optsWithGlobals().json;
+    await statusCommand(name, { json });
+});
+// ── template ────────────────────────────────────────────────────────────────
+program
+    .command("template")
+    .description("Get a raw file template (intent, design, tasks, context, debug)")
+    .argument("<type>", "Template type: intent | design | tasks | context | debug")
+    .action(async (type, _opts, cmd) => {
+    const json = cmd.optsWithGlobals().json;
+    await templateCommand(type, { json });
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/capture.d.ts

@@ -0,0 +1,18 @@
+/**
+ * whyspec capture — Capture reasoning context for a change.
+ *
+ * --json mode: returns XML template + commits + files + Decision Bridge data.
+ * Non-JSON mode: writes ctx_<id>.md with metadata header + XML template.
+ */
+export interface CaptureJsonOutput {
+    template: string;
+    commits: string[];
+    files_changed: string[];
+    decisions_to_make: string[];
+    change_name: string;
+    change_path: string;
+}
+export declare function captureCommand(name: string | undefined, options: {
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=capture.d.ts.map

package/dist/commands/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAOD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CA0Ef"}

package/dist/commands/capture.js

@@ -0,0 +1,85 @@
+/**
+ * whyspec capture — Capture reasoning context for a change.
+ *
+ * --json mode: returns XML template + commits + files + Decision Bridge data.
+ * Non-JSON mode: writes ctx_<id>.md with metadata header + XML template.
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import chalk from "chalk";
+import { resolveChange } from "../utils/changes.js";
+import { getCurrentBranch, getCommitsSince, getFilesChanged, getRemoteUrl } from "../utils/git.js";
+import { generateContextId, renderContextXml, extractDecisions, getChangeFolderCreatedAt, } from "../core/context.js";
+function readFileOrEmpty(filePath) {
+    if (!existsSync(filePath))
+        return "";
+    return readFileSync(filePath, "utf-8");
+}
+export async function captureCommand(name, options) {
+    const gitwhyDir = join(process.cwd(), ".gitwhy");
+    const change = resolveChange(gitwhyDir, name);
+    // Read planning artifacts
+    const intentContent = readFileOrEmpty(join(change.path, "intent.md"));
+    const designContent = readFileOrEmpty(join(change.path, "design.md"));
+    // Extract Decision Bridge data from design.md
+    const decisions = extractDecisions(designContent);
+    // Also extract decisions from intent.md if it has a Decisions to Make section
+    const intentDecisions = extractDecisions(intentContent);
+    const allDecisions = [...new Set([...decisions, ...intentDecisions])];
+    // Auto-detect commits and files changed since the change folder was created
+    let commits = [];
+    let filesChanged = [];
+    try {
+        const createdAt = getChangeFolderCreatedAt(change.path);
+        commits = getCommitsSince(createdAt);
+        filesChanged = getFilesChanged(createdAt);
+    }
+    catch {
+        // Gracefully handle if git operations fail
+    }
+    if (options.json) {
+        const output = {
+            template: renderContextXml(),
+            commits,
+            files_changed: filesChanged,
+            decisions_to_make: allDecisions,
+            change_name: change.name,
+            change_path: `.gitwhy/changes/${change.name}`,
+        };
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
+    // Non-JSON mode: write ctx_<id>.md with GitWhy-compatible metadata header
+    const contextId = generateContextId();
+    const branch = getCurrentBranch();
+    const repository = getRemoteUrl();
+    const commitList = commits.length > 0 ? commits.map((c) => c.slice(0, 7)).join(", ") : "none";
+    const metadataHeader = [
+        `# ${change.name}`,
+        "",
+        `**Context ID:** ${contextId}`,
+        `**Agent:** whyspec`,
+        ...(repository ? [`**Repository:** ${repository}`] : []),
+        `**Branch:** ${branch}`,
+        `**Date:** ${new Date().toISOString()}`,
+        `**Change:** ${change.name}`,
+        `**Intent:** .gitwhy/changes/${change.name}/intent.md`,
+        `**Commits:** ${commitList}`,
+        "",
+        "---",
+        "",
+    ].join("\n");
+    const content = metadataHeader + renderContextXml() + "\n";
+    const fileName = `${contextId}.md`;
+    const filePath = join(change.path, fileName);
+    writeFileSync(filePath, content);
+    console.log(chalk.green("Captured context:") + ` ${fileName}`);
+    console.log(`  ${chalk.dim("change:")} ${change.name}`);
+    console.log(`  ${chalk.dim("branch:")} ${branch}`);
+    console.log(`  ${chalk.dim("commits:")} ${commitList}`);
+    if (allDecisions.length > 0) {
+        console.log(`  ${chalk.dim("decisions to map:")} ${allDecisions.length}`);
+        allDecisions.forEach((d) => console.log(`    - ${d}`));
+    }
+}
+//# sourceMappingURL=capture.js.map

package/dist/commands/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/commands/capture.ts"],"names":[],"mappings":"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"}

package/dist/commands/debug.d.ts

@@ -0,0 +1,16 @@
+/**
+ * whyspec debug — Create a structured debug session (scientific method).
+ *
+ * --json mode: returns path, template, and related past contexts.
+ * Non-JSON mode: creates debug.md, prints related contexts and next steps.
+ */
+import { type SearchResult } from "../core/search.js";
+export interface DebugJsonOutput {
+    path: string;
+    template: string;
+    related_contexts: SearchResult[];
+}
+export declare function debugCommand(name: string | undefined, options: {
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=debug.d.ts.map

package/dist/commands/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/commands/debug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,YAAY,EAAE,CAAC;CAClC;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoEf"}

package/dist/commands/debug.js

@@ -0,0 +1,74 @@
+/**
+ * whyspec debug — Create a structured debug session (scientific method).
+ *
+ * --json mode: returns path, template, and related past contexts.
+ * Non-JSON mode: creates debug.md, prints related contexts and next steps.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import chalk from "chalk";
+import { slugify } from "../utils/slugify.js";
+import { debugTemplate } from "../core/templates.js";
+import { searchChanges } from "../core/search.js";
+export async function debugCommand(name, options) {
+    if (!name) {
+        throw new Error("Bug description is required. Usage: whyspec debug \"description of the bug\"");
+    }
+    const repoRoot = process.cwd();
+    const slug = slugify(name);
+    const gitwhyDir = join(repoRoot, ".gitwhy");
+    const changePath = join(gitwhyDir, "changes", slug);
+    // Quick search for related contexts using first few words of the bug name.
+    const searchQuery = name.split(/\s+/).slice(0, 3).join(" ");
+    let relatedContexts = [];
+    try {
+        relatedContexts = searchChanges(repoRoot, searchQuery, { limit: 5 });
+    }
+    catch {
+        // Gracefully continue if search fails (e.g., no .gitwhy/ dir yet).
+    }
+    // Generate debug template.
+    const template = debugTemplate(name);
+    // Append related contexts section if any were found.
+    let fullTemplate = template;
+    if (relatedContexts.length > 0) {
+        fullTemplate += "\n## Related Contexts\n";
+        fullTemplate += "<!-- Past decisions and reasoning in this area -->\n";
+        for (const ctx of relatedContexts) {
+            fullTemplate += `- **${ctx.change_name}/${ctx.id}** (score: ${ctx.score}) — ${ctx.title}\n`;
+            fullTemplate += `  ${ctx.snippet}\n`;
+        }
+    }
+    if (options.json) {
+        const output = {
+            path: `.gitwhy/changes/${slug}`,
+            template: fullTemplate,
+            related_contexts: relatedContexts,
+        };
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
+    // Non-JSON mode: create directory and file.
+    mkdirSync(changePath, { recursive: true });
+    writeFileSync(join(changePath, ".started"), new Date().toISOString());
+    writeFileSync(join(changePath, "debug.md"), fullTemplate);
+    console.log(chalk.green("Created debug session:") + ` ${slug}`);
+    console.log(`  ${chalk.dim("path:")} .gitwhy/changes/${slug}/`);
+    console.log(`  ${chalk.dim("file:")} debug.md`);
+    if (relatedContexts.length > 0) {
+        console.log();
+        console.log(chalk.bold("Related past contexts:"));
+        for (const ctx of relatedContexts) {
+            const scoreColor = ctx.score >= 100 ? chalk.green : ctx.score >= 30 ? chalk.yellow : chalk.dim;
+            console.log(`  ${scoreColor(`[${ctx.score}]`)} ${ctx.change_name}/${ctx.id} — ${ctx.title}`);
+        }
+    }
+    console.log();
+    console.log(chalk.bold("Next steps:"));
+    console.log(`  1. Fill in ${chalk.cyan("Symptoms")} (expected vs actual)`);
+    console.log(`  2. Form 3+ ${chalk.cyan("Hypotheses")} with disproof criteria`);
+    console.log(`  3. ${chalk.cyan("Investigate")} each hypothesis with evidence`);
+    console.log(`  4. Verify ${chalk.cyan("Root Cause")} before fixing`);
+    console.log(`  5. Run ${chalk.cyan("whyspec capture")} to save debug reasoning`);
+}
+//# sourceMappingURL=debug.js.map

package/dist/commands/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/commands/debug.ts"],"names":[],"mappings":"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"}

package/dist/commands/execute.d.ts

@@ -0,0 +1,36 @@
+/**
+ * whyspec execute — Get execution context and track progress for a change.
+ *
+ * --json mode: returns plan file contents + task progress for agent consumption.
+ * Non-JSON mode: displays progress summary with task list.
+ */
+export interface PendingTask {
+    line: number;
+    description: string;
+}
+export interface TaskProgress {
+    total: number;
+    completed: number;
+    remaining: number;
+}
+export interface ExecuteJsonOutput {
+    change_name: string;
+    intent_content: string;
+    design_content: string;
+    tasks_content: string;
+    progress: TaskProgress;
+    pending_tasks: PendingTask[];
+}
+/**
+ * Parse tasks.md for checkbox items, scoped to the ## Tasks section only.
+ * Ignores checkboxes in ## Verification and other sections.
+ * Recognizes: - [x], - [X] (completed) and - [ ] (pending).
+ */
+export declare function parseTasks(content: string): {
+    progress: TaskProgress;
+    pending: PendingTask[];
+};
+export declare function executeCommand(name: string | undefined, options: {
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=execute.d.ts.map