@gitwhy-cli/whyspec 0.1.0

package/dist/core/templates.js

@@ -0,0 +1,176 @@
+/**
+ * File templates for WhySpec change artifacts.
+ * Templates for: intent.md, design.md, tasks.md, context (SaaS XML format), debug.md
+ *
+ * The context template MUST match GitWhy SaaS XML format exactly.
+ * See: gitwhy/.claude/skills/gitwhy/SKILL.md
+ */
+/** Template for intent.md — declares intent before coding. */
+export function intentTemplate(changeName) {
+    return `# Intent: ${changeName}
+
+## Why This Change Exists
+<!-- Problem statement: what pain or gap does this address? -->
+
+## What It Enables
+<!-- Capabilities or outcomes this change unlocks -->
+
+## Decisions to Make
+<!-- Checkbox list of pending decisions (the Decision Bridge, "before" side) -->
+- [ ]
+
+## Constraints
+<!-- Technical or business constraints -->
+
+## Success Looks Like
+<!-- Acceptance criteria: how do we know this is done? -->
+
+## Assumptions
+<!-- What we're assuming is true -->
+`;
+}
+/** Template for design.md — technical approach with trade-offs. */
+export function designTemplate(changeName) {
+    return `# Design: ${changeName}
+
+## Approach
+<!-- Chosen technical direction -->
+
+## Trade-off Matrix
+<!-- Rows = options, Columns = evaluation criteria -->
+| Option | Pros | Cons | Decision |
+|--------|------|------|----------|
+|        |      |      |          |
+
+## Architecture
+<!-- ASCII diagram of the design -->
+
+## Decisions to Make
+<!-- THE DECISION BRIDGE: These checkboxes become "Decisions Made" after /whyspec:capture -->
+- [ ]
+
+## Questions to Resolve
+<!-- Open questions before coding -->
+- [ ]
+
+## Risks & Unknowns
+<!-- What could go wrong -->
+
+## Dependencies
+<!-- External dependencies -->
+`;
+}
+/** Template for tasks.md — implementation checklist with goal-backward verification. */
+export function tasksTemplate(changeName) {
+    return `# Tasks: ${changeName}
+
+## Verification
+<!-- What proves this works? Defined FIRST (goal-backward from GSD) -->
+- [ ]
+
+## Tasks
+<!-- Implementation checklist with sub-tasks -->
+- [ ]
+`;
+}
+/**
+ * Context template in GitWhy SaaS XML format.
+ * This is what agents fill in when capturing reasoning after coding.
+ * The CLI parses this XML and renders it into rich markdown for storage.
+ */
+export function contextTemplate(options) {
+    const title = options?.title ?? "Short title of what was done";
+    const agent = options?.agent ?? "claude-code (model)";
+    const tags = options?.tags ?? "keyword1, keyword2";
+    return `<context>
+  <title>${title}</title>
+  <story>
+    Phase 1 — Setup:
+    What was asked, what was done, challenges faced, how they were resolved.
+
+    Phase 2 — Implementation:
+    Technical details, decisions made during coding, problems solved.
+  </story>
+  <reasoning>
+    Why this approach was chosen.
+
+    <decisions>
+      - Decision — rationale
+    </decisions>
+
+    <rejected>
+      - Alternative — why rejected
+    </rejected>
+
+    <tradeoffs>
+      - Trade-off accepted — justification
+    </tradeoffs>
+  </reasoning>
+  <files>
+    path/to/file — new — Description
+    path/to/other — modified — Description
+  </files>
+  <agent>${agent}</agent>
+  <tags>${tags}</tags>
+  <verification>Test/build results</verification>
+  <risks>Open questions or risks</risks>
+</context>
+`;
+}
+/** Template for debug.md — structured debugging process. */
+export function debugTemplate(bugName) {
+    return `# Debug: ${bugName}
+
+## Symptoms
+<!-- Expected vs actual behavior -->
+**Expected:**
+
+**Actual:**
+
+**Error Messages:**
+
+**Reproduction Steps:**
+1.
+
+**Timeline:** When did this start?
+
+## Hypotheses
+<!-- 3+ falsifiable hypotheses with "what would prove this wrong?" -->
+1. **Hypothesis:**
+   **Disproof:**
+
+2. **Hypothesis:**
+   **Disproof:**
+
+3. **Hypothesis:**
+   **Disproof:**
+
+## Investigation
+<!-- Evidence trail: what was tested, what was found -->
+
+## Root Cause
+<!-- The verified root cause. No fix without root cause (Iron Law). -->
+
+## Fix
+<!-- What was done to fix the issue -->
+
+## Prevention
+<!-- How to avoid this in the future -->
+`;
+}
+/** Returns a template by type name. */
+export function getTemplate(type, name = "") {
+    switch (type) {
+        case "intent":
+            return intentTemplate(name);
+        case "design":
+            return designTemplate(name);
+        case "tasks":
+            return tasksTemplate(name);
+        case "context":
+            return contextTemplate({ title: name || undefined });
+        case "debug":
+            return debugTemplate(name);
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/core/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8DAA8D;AAC9D,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,OAAO,aAAa,UAAU;;;;;;;;;;;;;;;;;;;;CAoB/B,CAAC;AACF,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,OAAO,aAAa,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2B/B,CAAC;AACF,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,YAAY,UAAU;;;;;;;;;CAS9B,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAI/B;IACC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,8BAA8B,CAAC;IAC/D,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,qBAAqB,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,oBAAoB,CAAC;IAEnD,OAAO;WACE,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;WA2BL,KAAK;UACN,IAAI;;;;CAIb,CAAC;AACF,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,YAAY,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqC3B,CAAC;AACF,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,WAAW,CACzB,IAAyD,EACzD,IAAI,GAAG,EAAE;IAET,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,QAAQ;YACX,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;QAC9B,KAAK,OAAO;YACV,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7B,KAAK,SAAS;YACZ,OAAO,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC;QACvD,KAAK,OAAO;YACV,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/ui/ascii-logo.d.ts

@@ -0,0 +1,7 @@
+/**
+ * WhySpec ASCII logo — figlet "small" style.
+ * Raw string without color — callers apply styling.
+ */
+export declare const WHYSPEC_LOGO = "  __      ___           ____\n  \\ \\    / / |_ _  _ __|  _ \\ _ __  ___  ___\n   \\ \\/\\/ /| ' \\ || (_-< ___/| '_ \\/ -_)/ _|\n    \\_/\\_/ |_||_\\_, /__/|_|  | .__/\\___|\\__|\n               |__/          |_|";
+export declare function renderLogo(): string;
+//# sourceMappingURL=ascii-logo.d.ts.map

package/dist/ui/ascii-logo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii-logo.d.ts","sourceRoot":"","sources":["../../src/ui/ascii-logo.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,YAAY,0NAKQ,CAAC;AAElC,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/ui/ascii-logo.js

@@ -0,0 +1,15 @@
+import chalk from "chalk";
+/**
+ * WhySpec ASCII logo — figlet "small" style.
+ * Raw string without color — callers apply styling.
+ */
+export const WHYSPEC_LOGO = `\
+  __      ___           ____
+  \\ \\    / / |_ _  _ __|  _ \\ _ __  ___  ___
+   \\ \\/\\/ /| ' \\ || (_-< ___/| '_ \\/ -_)/ _|
+    \\_/\\_/ |_||_\\_, /__/|_|  | .__/\\___|\\__|
+               |__/          |_|`;
+export function renderLogo() {
+    return chalk.cyan(WHYSPEC_LOGO);
+}
+//# sourceMappingURL=ascii-logo.js.map

package/dist/ui/ascii-logo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ascii-logo.js","sourceRoot":"","sources":["../../src/ui/ascii-logo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;iCAKK,CAAC;AAElC,MAAM,UAAU,UAAU;IACxB,OAAO,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC"}

package/dist/ui/tool-picker.d.ts

@@ -0,0 +1,13 @@
+export interface ToolChoice {
+    name: string;
+    value: string;
+    /** Tools with skill support get .claude/skills/ or equivalent */
+    skillSupport: boolean;
+    /** Tools that read AGENTS.md for instructions */
+    usesAgentsMd: boolean;
+}
+export declare const AVAILABLE_TOOLS: ToolChoice[];
+export declare function promptToolPicker(): Promise<string[]>;
+export declare function getToolMeta(toolId: string): ToolChoice | undefined;
+export declare function needsAgentsMd(selectedTools: string[]): boolean;
+//# sourceMappingURL=tool-picker.d.ts.map

package/dist/ui/tool-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-picker.d.ts","sourceRoot":"","sources":["../../src/ui/tool-picker.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,YAAY,EAAE,OAAO,CAAC;IACtB,iDAAiD;IACjD,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,eAAe,EAAE,UAAU,EAiDvC,CAAC;AAEF,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAc1D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAElE;AAED,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAK9D"}

package/dist/ui/tool-picker.js

@@ -0,0 +1,76 @@
+import { checkbox } from "@inquirer/prompts";
+import chalk from "chalk";
+export const AVAILABLE_TOOLS = [
+    {
+        name: "Claude Code",
+        value: "claude-code",
+        skillSupport: true,
+        usesAgentsMd: false,
+    },
+    {
+        name: "Cursor",
+        value: "cursor",
+        skillSupport: true,
+        usesAgentsMd: false,
+    },
+    {
+        name: "GitHub Copilot",
+        value: "copilot",
+        skillSupport: false,
+        usesAgentsMd: true,
+    },
+    {
+        name: "Codex CLI",
+        value: "codex",
+        skillSupport: false,
+        usesAgentsMd: true,
+    },
+    {
+        name: "Windsurf",
+        value: "windsurf",
+        skillSupport: false,
+        usesAgentsMd: true,
+    },
+    {
+        name: "Cline",
+        value: "cline",
+        skillSupport: false,
+        usesAgentsMd: true,
+    },
+    {
+        name: "Amazon Q",
+        value: "amazon-q",
+        skillSupport: false,
+        usesAgentsMd: true,
+    },
+    {
+        name: "RooCode",
+        value: "roocode",
+        skillSupport: false,
+        usesAgentsMd: true,
+    },
+];
+export async function promptToolPicker() {
+    const selected = await checkbox({
+        message: "Select your AI tools (space to toggle, enter to confirm)",
+        choices: AVAILABLE_TOOLS.map((tool) => ({
+            name: tool.name,
+            value: tool.value,
+            checked: tool.value === "claude-code",
+        })),
+        theme: {
+            prefix: chalk.cyan("?"),
+        },
+    });
+    return selected;
+}
+export function getToolMeta(toolId) {
+    return AVAILABLE_TOOLS.find((t) => t.value === toolId);
+}
+export function needsAgentsMd(selectedTools) {
+    return selectedTools.some((id) => {
+        const tool = getToolMeta(id);
+        return tool?.usesAgentsMd;
+    });
+}
+//# sourceMappingURL=tool-picker.js.map

package/dist/ui/tool-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-picker.js","sourceRoot":"","sources":["../../src/ui/tool-picker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,MAAM,OAAO,CAAC;AAW1B,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,aAAa;QACpB,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,KAAK;KACpB;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,KAAK;KACpB;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,SAAS;QAChB,YAAY,EAAE,KAAK;QACnB,YAAY,EAAE,IAAI;KACnB;IACD;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,OAAO;QACd,YAAY,EAAE,KAAK;QACnB,YAAY,EAAE,IAAI;KACnB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,YAAY,EAAE,KAAK;QACnB,YAAY,EAAE,IAAI;KACnB;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,YAAY,EAAE,KAAK;QACnB,YAAY,EAAE,IAAI;KACnB;IACD;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,UAAU;QACjB,YAAY,EAAE,KAAK;QACnB,YAAY,EAAE,IAAI;KACnB;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,YAAY,EAAE,KAAK;QACnB,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC;QAC9B,OAAO,EAAE,0DAA0D;QACnE,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,KAAK,KAAK,aAAa;SACtC,CAAC,CAAC;QACH,KAAK,EAAE;YACL,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;SACxB;KACF,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,aAAuB;IACnD,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;QAC7B,OAAO,IAAI,EAAE,YAAY,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/ui/welcome.d.ts

@@ -0,0 +1,4 @@
+export declare function renderWelcomeScreen(): string;
+export declare function renderTelemetryNotice(): string;
+export declare function renderSuccessMessage(tools: string[]): string;
+//# sourceMappingURL=welcome.d.ts.map

package/dist/ui/welcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.d.ts","sourceRoot":"","sources":["../../src/ui/welcome.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,IAAI,MAAM,CAqB5C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAkB5D"}

package/dist/ui/welcome.js

@@ -0,0 +1,43 @@
+import chalk from "chalk";
+import { renderLogo } from "./ascii-logo.js";
+export function renderWelcomeScreen() {
+    const lines = [];
+    lines.push("");
+    lines.push(renderLogo());
+    lines.push("");
+    lines.push(chalk.bold("  The reasoning layer for AI coding"));
+    lines.push("");
+    lines.push(chalk.dim("  This will create:"));
+    lines.push(chalk.white("    .gitwhy/"));
+    lines.push(chalk.white("    \u251C\u2500\u2500 config.yaml"));
+    lines.push(chalk.white("    \u2514\u2500\u2500 changes/"));
+    lines.push("");
+    lines.push(chalk.dim("  Quick start after setup:"));
+    lines.push(`    ${chalk.green("/whyspec:plan")}      Plan before coding`);
+    lines.push(`    ${chalk.green("/whyspec:execute")}   Implement with context`);
+    lines.push(`    ${chalk.green("/whyspec:capture")}   Save your reasoning`);
+    lines.push(`    ${chalk.green("/whyspec:debug")}     Debug with science`);
+    lines.push("");
+    return lines.join("\n");
+}
+export function renderTelemetryNotice() {
+    return chalk.dim("  Telemetry: anonymous usage stats (opt-out: WHYSPEC_TELEMETRY=0)");
+}
+export function renderSuccessMessage(tools) {
+    const lines = [];
+    lines.push("");
+    lines.push(chalk.green.bold("  \u2713 WhySpec initialized!"));
+    lines.push("");
+    lines.push(chalk.dim("  Created:"));
+    lines.push(chalk.white("    .gitwhy/config.yaml"));
+    lines.push(chalk.white("    .gitwhy/changes/"));
+    if (tools.length > 0) {
+        lines.push("");
+        lines.push(chalk.dim(`  Tools configured: ${tools.join(", ")}`));
+    }
+    lines.push("");
+    lines.push(`  Ready! Try: ${chalk.cyan.bold("/whyspec:plan")}`);
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=welcome.js.map

package/dist/ui/welcome.js.map

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

package/dist/utils/changes.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Change folder operations for .gitwhy/changes/ directories.
+ */
+export interface ResolvedChange {
+    name: string;
+    path: string;
+}
+/**
+ * List all change folder names in .gitwhy/changes/.
+ */
+export declare function listChanges(gitwhyDir: string): string[];
+/**
+ * Resolve a change by name, or auto-detect if only one exists.
+ * - If name provided: validate the folder exists.
+ * - If no name + exactly 1 change: auto-select it.
+ * - If no name + 0 or multiple changes: throw with guidance.
+ */
+export declare function resolveChange(gitwhyDir: string, name?: string): ResolvedChange;
+//# sourceMappingURL=changes.d.ts.map

package/dist/utils/changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../src/utils/changes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAsBD;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAOvD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CA8BhB"}

package/dist/utils/changes.js

@@ -0,0 +1,63 @@
+/**
+ * Change folder operations for .gitwhy/changes/ directories.
+ */
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { join, normalize, relative, sep } from "node:path";
+import { slugify } from "./slugify.js";
+function normalizeChangeName(name) {
+    const trimmed = name.trim();
+    if (!trimmed) {
+        throw new Error("Invalid change name.");
+    }
+    const normalizedPath = normalize(trimmed);
+    if (normalizedPath === ".." ||
+        normalizedPath.startsWith(`..${sep}`) ||
+        normalizedPath.includes(`${sep}..${sep}`) ||
+        normalizedPath.endsWith(`${sep}..`) ||
+        normalizedPath.startsWith(sep)) {
+        throw new Error(`Invalid change name "${name}".`);
+    }
+    return slugify(trimmed);
+}
+/**
+ * List all change folder names in .gitwhy/changes/.
+ */
+export function listChanges(gitwhyDir) {
+    const changesDir = join(gitwhyDir, "changes");
+    if (!existsSync(changesDir))
+        return [];
+    return readdirSync(changesDir).filter((entry) => {
+        const full = join(changesDir, entry);
+        return statSync(full).isDirectory();
+    });
+}
+/**
+ * Resolve a change by name, or auto-detect if only one exists.
+ * - If name provided: validate the folder exists.
+ * - If no name + exactly 1 change: auto-select it.
+ * - If no name + 0 or multiple changes: throw with guidance.
+ */
+export function resolveChange(gitwhyDir, name) {
+    const changesDir = join(gitwhyDir, "changes");
+    if (name) {
+        const normalizedName = normalizeChangeName(name);
+        const changePath = join(changesDir, normalizedName);
+        const rel = relative(changesDir, changePath);
+        if (rel.startsWith("..") || rel === "") {
+            throw new Error(`Invalid change name "${name}".`);
+        }
+        if (!existsSync(changePath)) {
+            throw new Error(`Change "${normalizedName}" not found. Run \`whyspec plan "${normalizedName}"\` first.`);
+        }
+        return { name: normalizedName, path: changePath };
+    }
+    const changes = listChanges(gitwhyDir);
+    if (changes.length === 0) {
+        throw new Error("No changes found. Run `whyspec plan <name>` to create one.");
+    }
+    if (changes.length === 1) {
+        return { name: changes[0], path: join(changesDir, changes[0]) };
+    }
+    throw new Error(`Multiple changes found. Specify one:\n${changes.map((c) => `  - ${c}`).join("\n")}`);
+}
+//# sourceMappingURL=changes.js.map

package/dist/utils/changes.js.map

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

package/dist/utils/git.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Git utility functions for WhySpec.
+ * Wraps git CLI commands via execFileSync (no shell — safe from injection).
+ *
+ * Reference: GitWhy Go cmd/git-why/enable.go:512 (findRepoRoot)
+ */
+export interface Commit {
+    hash: string;
+    message: string;
+}
+/** Returns the git repository root directory. Throws if not in a git repo. */
+export declare function findRepoRoot(): string;
+/** Returns the current branch name. */
+export declare function getCurrentBranch(): string;
+/** Returns recent commits as { hash, message } pairs. */
+export declare function getRecentCommits(count?: number): Commit[];
+/** Returns commit SHAs since a given date. Used by capture to find commits since change creation. */
+export declare function getCommitsSince(since: Date): string[];
+/** Returns files changed since a given date. Used by capture to detect changed files. */
+export declare function getFilesChanged(since: Date): string[];
+/** Returns the remote origin URL (owner/repo format if GitHub, raw URL otherwise). */
+export declare function getRemoteUrl(): string;
+/**
+ * Adds an entry to .gitignore if not already present.
+ * Creates .gitignore if it doesn't exist.
+ */
+export declare function addToGitignore(repoRoot: string, entry: string): void;
+//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,IAAI,MAAM,CAWrC;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,KAAK,SAAK,GAAG,MAAM,EAAE,CAmBrD;AAED,qGAAqG;AACrG,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,CAWrD;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,CAWrD;AAED,sFAAsF;AACtF,wBAAgB,YAAY,IAAI,MAAM,CAarC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAcpE"}

package/dist/utils/git.js

@@ -0,0 +1,104 @@
+/**
+ * Git utility functions for WhySpec.
+ * Wraps git CLI commands via execFileSync (no shell — safe from injection).
+ *
+ * Reference: GitWhy Go cmd/git-why/enable.go:512 (findRepoRoot)
+ */
+import { execFileSync } from "node:child_process";
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+/** Returns the git repository root directory. Throws if not in a git repo. */
+export function findRepoRoot() {
+    try {
+        const out = execFileSync("git", ["rev-parse", "--show-toplevel"], {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return out.trim();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Not a git repository: ${msg}`, { cause: err });
+    }
+}
+/** Returns the current branch name. */
+export function getCurrentBranch() {
+    const out = execFileSync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"],
+    });
+    return out.trim();
+}
+/** Returns recent commits as { hash, message } pairs. */
+export function getRecentCommits(count = 10) {
+    const out = execFileSync("git", ["log", `--oneline`, `-${count}`], { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+    return out
+        .trim()
+        .split("\n")
+        .filter((line) => line.length > 0)
+        .map((line) => {
+        const spaceIdx = line.indexOf(" ");
+        if (spaceIdx === -1)
+            return { hash: line, message: "" };
+        return {
+            hash: line.slice(0, spaceIdx),
+            message: line.slice(spaceIdx + 1),
+        };
+    });
+}
+/** Returns commit SHAs since a given date. Used by capture to find commits since change creation. */
+export function getCommitsSince(since) {
+    try {
+        const out = execFileSync("git", ["log", `--since=${since.toISOString()}`, "--format=%H", "--max-count=100"], { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+        return out.trim().split("\n").filter((l) => l.length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+/** Returns files changed since a given date. Used by capture to detect changed files. */
+export function getFilesChanged(since) {
+    try {
+        const out = execFileSync("git", ["log", `--since=${since.toISOString()}`, "--format=", "--name-only", "--max-count=100"], { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] });
+        return [...new Set(out.trim().split("\n").filter((l) => l.length > 0))];
+    }
+    catch {
+        return [];
+    }
+}
+/** Returns the remote origin URL (owner/repo format if GitHub, raw URL otherwise). */
+export function getRemoteUrl() {
+    try {
+        const out = execFileSync("git", ["remote", "get-url", "origin"], {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const url = out.trim();
+        // Extract owner/repo from GitHub URLs
+        const match = url.match(/github\.com[:/](.+?)(?:\.git)?$/);
+        return match ? match[1] : url;
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Adds an entry to .gitignore if not already present.
+ * Creates .gitignore if it doesn't exist.
+ */
+export function addToGitignore(repoRoot, entry) {
+    const gitignorePath = join(repoRoot, ".gitignore");
+    if (existsSync(gitignorePath)) {
+        const content = readFileSync(gitignorePath, "utf-8");
+        const lines = content.split("\n");
+        if (lines.some((line) => line.trim() === entry.trim())) {
+            return; // Already present
+        }
+        const suffix = content.endsWith("\n") ? "" : "\n";
+        writeFileSync(gitignorePath, content + suffix + entry + "\n", "utf-8");
+    }
+    else {
+        writeFileSync(gitignorePath, entry + "\n", "utf-8");
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

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

package/dist/utils/slugify.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Slugify converts a string to a URL-friendly slug.
+ * Ported from GitWhy Go: internal/storage/categorize.go
+ *
+ * - Lowercase
+ * - Spaces replaced with hyphens
+ * - Special characters removed (only a-z, 0-9, hyphens kept)
+ * - Leading/trailing hyphens trimmed
+ * - Returns "general" for empty input
+ */
+export declare function slugify(input: string): string;
+//# sourceMappingURL=slugify.d.ts.map

package/dist/utils/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../src/utils/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAS7C"}

package/dist/utils/slugify.js

@@ -0,0 +1,21 @@
+/**
+ * Slugify converts a string to a URL-friendly slug.
+ * Ported from GitWhy Go: internal/storage/categorize.go
+ *
+ * - Lowercase
+ * - Spaces replaced with hyphens
+ * - Special characters removed (only a-z, 0-9, hyphens kept)
+ * - Leading/trailing hyphens trimmed
+ * - Returns "general" for empty input
+ */
+const SLUG_RE = /[^a-z0-9-]/g;
+export function slugify(input) {
+    if (!input)
+        return "general";
+    let s = input.toLowerCase();
+    s = s.replace(/ /g, "-");
+    s = s.replace(SLUG_RE, "");
+    s = s.replace(/^-+|-+$/g, "");
+    return s || "general";
+}
+//# sourceMappingURL=slugify.js.map

package/dist/utils/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../src/utils/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,OAAO,GAAG,aAAa,CAAC;AAE9B,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,IAAI,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACzB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE9B,OAAO,CAAC,IAAI,SAAS,CAAC;AACxB,CAAC"}