@gitwhy-cli/whyspec 0.1.0

package/dist/commands/show.js

@@ -0,0 +1,145 @@
+/**
+ * whyspec show — Display the full story of a change with Decision Bridge delta.
+ *
+ * --json mode: returns all file contents + decision bridge delta.
+ * Non-JSON mode: formatted markdown output with sections and color-coded Decision Bridge.
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import chalk from "chalk";
+import { resolveChange } from "../utils/changes.js";
+import { extractDecisions } from "../core/context.js";
+import { parseTasks } from "./execute.js";
+/**
+ * Extract decisions from a ctx_*.md context file.
+ * Parses the <decisions> XML tag within <reasoning>.
+ * Each line starting with "- " is a decision.
+ */
+function extractContextDecisions(ctxContent) {
+    const match = ctxContent.match(/<decisions>([\s\S]*?)<\/decisions>/);
+    if (!match)
+        return [];
+    return match[1]
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.startsWith("- "))
+        .map((l) => l.slice(2).trim());
+}
+/**
+ * Detect "surprises" — decisions in context files that were NOT planned in design.md.
+ * Uses case-insensitive substring matching for fuzzy comparison.
+ */
+function detectSurprises(planned, decided) {
+    const lowerPlanned = planned.map((p) => p.toLowerCase());
+    return decided.filter((d) => {
+        const lowerD = d.toLowerCase();
+        // A decision is a surprise if no planned decision contains a key overlap.
+        // We check if any planned decision shares significant words with this decision.
+        return !lowerPlanned.some((p) => {
+            // Extract key words (>3 chars) from both.
+            const dWords = lowerD.split(/\W+/).filter((w) => w.length > 3);
+            return dWords.some((w) => p.includes(w));
+        });
+    });
+}
+function readFileOrEmpty(filePath) {
+    if (!existsSync(filePath))
+        return "";
+    return readFileSync(filePath, "utf-8");
+}
+export async function showCommand(name, options) {
+    const gitwhyDir = join(process.cwd(), ".gitwhy");
+    const change = resolveChange(gitwhyDir, name);
+    // Read all files.
+    const intent = readFileOrEmpty(join(change.path, "intent.md"));
+    const design = readFileOrEmpty(join(change.path, "design.md"));
+    const tasks = readFileOrEmpty(join(change.path, "tasks.md"));
+    // Find all ctx_*.md files.
+    const ctxFiles = existsSync(change.path)
+        ? readdirSync(change.path)
+            .filter((f) => f.startsWith("ctx_") && f.endsWith(".md"))
+            .sort()
+        : [];
+    const contexts = ctxFiles.map((f) => ({
+        id: f.replace(/\.md$/, ""),
+        content: readFileOrEmpty(join(change.path, f)),
+    }));
+    // Compute Decision Bridge delta.
+    const planned = extractDecisions(design);
+    // Also extract from intent.md if it has decisions.
+    const intentDecisions = extractDecisions(intent);
+    const allPlanned = [...new Set([...planned, ...intentDecisions])];
+    // Collect all decided items from all context files.
+    const allDecided = [];
+    for (const ctx of contexts) {
+        allDecided.push(...extractContextDecisions(ctx.content));
+    }
+    const surprises = detectSurprises(allPlanned, allDecided);
+    if (options.json) {
+        const output = {
+            change_name: change.name,
+            intent,
+            design,
+            tasks,
+            contexts,
+            decision_bridge_delta: {
+                planned: allPlanned,
+                decided: allDecided,
+                surprises,
+            },
+        };
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
+    // Non-JSON mode: formatted output.
+    console.log(chalk.bold.underline(`Change: ${change.name}`));
+    console.log();
+    // Intent section.
+    if (intent) {
+        console.log(chalk.bold.blue("── Intent ──────────────────────────────────────"));
+        console.log(intent.trim());
+        console.log();
+    }
+    // Design section.
+    if (design) {
+        console.log(chalk.bold.blue("── Design ──────────────────────────────────────"));
+        console.log(design.trim());
+        console.log();
+    }
+    // Tasks section.
+    if (tasks) {
+        const { progress } = parseTasks(tasks);
+        const pct = progress.total > 0 ? Math.round((progress.completed / progress.total) * 100) : 0;
+        console.log(chalk.bold.blue("── Tasks ───────────────────────────────────────"));
+        console.log(`Progress: ${pct}% (${progress.completed}/${progress.total})`);
+        console.log(tasks.trim());
+        console.log();
+    }
+    // Contexts section.
+    if (contexts.length > 0) {
+        console.log(chalk.bold.blue("── Contexts ────────────────────────────────────"));
+        for (const ctx of contexts) {
+            console.log(chalk.dim(`--- ${ctx.id} ---`));
+            console.log(ctx.content.trim());
+            console.log();
+        }
+    }
+    // Decision Bridge delta.
+    console.log(chalk.bold.magenta("── Decision Bridge ─────────────────────────────"));
+    if (allPlanned.length > 0) {
+        console.log(chalk.bold("Planned decisions:"));
+        allPlanned.forEach((d) => console.log(`  ${chalk.dim("○")} ${d}`));
+    }
+    if (allDecided.length > 0) {
+        console.log(chalk.bold("\nDecisions made:"));
+        allDecided.forEach((d) => console.log(`  ${chalk.green("●")} ${d}`));
+    }
+    if (surprises.length > 0) {
+        console.log(chalk.bold.yellow("\nSurprises (not in plan):"));
+        surprises.forEach((d) => console.log(`  ${chalk.yellow("⚡")} ${d}`));
+    }
+    if (allPlanned.length === 0 && allDecided.length === 0) {
+        console.log(chalk.dim("  No decisions tracked yet."));
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/show.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,29 @@
+/**
+ * whyspec status — Get detailed status for a change.
+ *
+ * --json mode: returns file presence, task progress, commits, Decision Bridge state.
+ * Non-JSON mode: rich formatted status card.
+ */
+export interface StatusJsonOutput {
+    name: string;
+    files: {
+        intent: boolean;
+        design: boolean;
+        tasks: boolean;
+        contexts: string[];
+        debug: boolean;
+    };
+    progress: {
+        completed: number;
+        total: number;
+    };
+    commits: number;
+    decision_bridge: {
+        to_make: number;
+        made: number;
+    };
+}
+export declare function statusCommand(name: string, options: {
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QACL,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAcD,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CA0Gf"}

package/dist/commands/status.js

@@ -0,0 +1,125 @@
+/**
+ * whyspec status — Get detailed status for a change.
+ *
+ * --json mode: returns file presence, task progress, commits, Decision Bridge state.
+ * Non-JSON mode: rich formatted status card.
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import chalk from "chalk";
+import { resolveChange } from "../utils/changes.js";
+import { readMarkdown } from "../core/storage.js";
+import { extractDecisions, getChangeFolderCreatedAt } from "../core/context.js";
+import { getCommitsSince } from "../utils/git.js";
+import { parseTasks } from "./execute.js";
+/**
+ * Extract decisions from context file <decisions> tags.
+ */
+function extractContextDecisionCount(ctxContent) {
+    const match = ctxContent.match(/<decisions>([\s\S]*?)<\/decisions>/);
+    if (!match)
+        return 0;
+    return match[1]
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.startsWith("- ")).length;
+}
+export async function statusCommand(name, options) {
+    const gitwhyDir = join(process.cwd(), ".gitwhy");
+    const change = resolveChange(gitwhyDir, name);
+    // Check file presence.
+    const hasIntent = existsSync(join(change.path, "intent.md"));
+    const hasDesign = existsSync(join(change.path, "design.md"));
+    const hasTasks = existsSync(join(change.path, "tasks.md"));
+    const hasDebug = existsSync(join(change.path, "debug.md"));
+    // Find ctx_*.md files.
+    const ctxFiles = existsSync(change.path)
+        ? readdirSync(change.path)
+            .filter((f) => f.startsWith("ctx_") && f.endsWith(".md"))
+            .sort()
+        : [];
+    // Parse task progress.
+    const tasksContent = readMarkdown(change.path, "tasks.md");
+    const { progress } = parseTasks(tasksContent ?? "");
+    // Count commits since creation.
+    let commitCount = 0;
+    try {
+        const createdAt = getChangeFolderCreatedAt(change.path);
+        const commits = getCommitsSince(createdAt);
+        commitCount = commits.length;
+    }
+    catch {
+        // Gracefully handle if git operations fail.
+    }
+    // Decision Bridge state.
+    const designContent = readMarkdown(change.path, "design.md") ?? "";
+    const intentContent = readMarkdown(change.path, "intent.md") ?? "";
+    const plannedDecisions = [
+        ...new Set([...extractDecisions(designContent), ...extractDecisions(intentContent)]),
+    ];
+    let madeDecisions = 0;
+    for (const ctxFile of ctxFiles) {
+        const ctxContent = readMarkdown(change.path, ctxFile) ?? "";
+        madeDecisions += extractContextDecisionCount(ctxContent);
+    }
+    if (options.json) {
+        const output = {
+            name: change.name,
+            files: {
+                intent: hasIntent,
+                design: hasDesign,
+                tasks: hasTasks,
+                contexts: ctxFiles.map((f) => f.replace(/\.md$/, "")),
+                debug: hasDebug,
+            },
+            progress: { completed: progress.completed, total: progress.total },
+            commits: commitCount,
+            decision_bridge: { to_make: plannedDecisions.length, made: madeDecisions },
+        };
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
+    // Non-JSON mode: rich status card.
+    console.log(chalk.bold.underline(`Status: ${change.name}`));
+    console.log();
+    // Files.
+    const check = (present) => (present ? chalk.green("✓") : chalk.red("✗"));
+    console.log(chalk.bold("Files:"));
+    console.log(`  ${check(hasIntent)} intent.md`);
+    console.log(`  ${check(hasDesign)} design.md`);
+    console.log(`  ${check(hasTasks)} tasks.md`);
+    console.log(`  ${check(hasDebug)} debug.md`);
+    if (ctxFiles.length > 0) {
+        for (const f of ctxFiles) {
+            console.log(`  ${chalk.green("✓")} ${f}`);
+        }
+    }
+    else {
+        console.log(`  ${chalk.dim("○")} no context files yet`);
+    }
+    console.log();
+    // Progress.
+    if (progress.total > 0) {
+        const pct = Math.round((progress.completed / progress.total) * 100);
+        const barLen = 30;
+        const filled = Math.round((pct / 100) * barLen);
+        const bar = chalk.green("█".repeat(filled)) + chalk.dim("░".repeat(barLen - filled));
+        console.log(chalk.bold("Tasks:"));
+        console.log(`  ${bar} ${pct}% (${progress.completed}/${progress.total})`);
+    }
+    else {
+        console.log(chalk.bold("Tasks:") + chalk.dim(" none defined"));
+    }
+    console.log();
+    // Commits.
+    console.log(chalk.bold("Commits:") + ` ${commitCount} since creation`);
+    console.log();
+    // Decision Bridge.
+    console.log(chalk.bold("Decision Bridge:"));
+    console.log(`  ${chalk.dim("To make:")} ${plannedDecisions.length}`);
+    console.log(`  ${chalk.dim("Made:")}    ${madeDecisions}`);
+    if (plannedDecisions.length > 0 && madeDecisions === 0) {
+        console.log(chalk.yellow("  → Run `whyspec capture` to record decisions"));
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/template.d.ts

@@ -0,0 +1,14 @@
+/**
+ * whyspec template — Return a raw file template by type.
+ *
+ * --json mode: returns { type, content }.
+ * Non-JSON mode: prints the raw template content.
+ */
+export interface TemplateJsonOutput {
+    type: string;
+    content: string;
+}
+export declare function templateCommand(type: string, options: {
+    json?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/commands/template.js

@@ -0,0 +1,25 @@
+/**
+ * whyspec template — Return a raw file template by type.
+ *
+ * --json mode: returns { type, content }.
+ * Non-JSON mode: prints the raw template content.
+ */
+import { getTemplate } from "../core/templates.js";
+const VALID_TYPES = ["intent", "design", "tasks", "context", "debug"];
+function isValidType(type) {
+    return VALID_TYPES.includes(type);
+}
+export async function templateCommand(type, options) {
+    if (!isValidType(type)) {
+        const valid = VALID_TYPES.join(", ");
+        throw new Error(`Invalid template type "${type}". Valid types: ${valid}`);
+    }
+    const content = getTemplate(type);
+    if (options.json) {
+        const output = { type, content };
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
+    console.log(content);
+}
+//# sourceMappingURL=template.js.map

package/dist/commands/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/commands/template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AAG/E,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAQ,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,OAA2B;IAE3B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,mBAAmB,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAElC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,MAAM,GAAuB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC"}

package/dist/core/categorize.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Domain/topic detection from file paths.
+ * Ported from GitWhy Go: internal/storage/categorize.go
+ *
+ * AutoCategorize uses majority-vote across file paths to determine
+ * a domain, and slugifies the title to produce a topic.
+ */
+interface CategoryRule {
+    pattern: RegExp;
+    domain: string;
+}
+/**
+ * Rules ordered: file-suffix patterns first (most specific),
+ * then directory-prefix patterns.
+ */
+declare const categoryRules: CategoryRule[];
+/** Classifies a single file path into a domain, or empty string if no match. */
+declare function classifyPath(filePath: string): string;
+/**
+ * AutoCategorize determines a domain and topic from a title and file paths.
+ *
+ * Domain: chosen by majority vote across all file paths. "uncategorized" if none match.
+ * Topic: derived from title via slugify. "general" if title is empty.
+ */
+export declare function autoCategorize(title: string, filePaths: string[]): {
+    domain: string;
+    topic: string;
+};
+export { classifyPath, categoryRules };
+//# sourceMappingURL=categorize.d.ts.map

package/dist/core/categorize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categorize.d.ts","sourceRoot":"","sources":["../../src/core/categorize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,UAAU,YAAY;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,QAAA,MAAM,aAAa,EAAE,YAAY,EAehC,CAAC;AAEF,gFAAgF;AAChF,iBAAS,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EAAE,GAClB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA+BnC;AAED,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/core/categorize.js

@@ -0,0 +1,72 @@
+/**
+ * Domain/topic detection from file paths.
+ * Ported from GitWhy Go: internal/storage/categorize.go
+ *
+ * AutoCategorize uses majority-vote across file paths to determine
+ * a domain, and slugifies the title to produce a topic.
+ */
+import { slugify } from "../utils/slugify.js";
+/**
+ * Rules ordered: file-suffix patterns first (most specific),
+ * then directory-prefix patterns.
+ */
+const categoryRules = [
+    // File-suffix rules first (most specific)
+    { pattern: /_test\.go$/, domain: "testing" },
+    { pattern: /\.test\.(ts|tsx|js|jsx)$/, domain: "testing" },
+    { pattern: /\.spec\.(ts|tsx|js|jsx)$/, domain: "testing" },
+    { pattern: /\.md$/, domain: "documentation" },
+    { pattern: /(^|\/)Dockerfile$/, domain: "infrastructure" },
+    // Directory-prefix rules
+    { pattern: /^(src\/auth|internal\/auth|auth)\//, domain: "authentication" },
+    { pattern: /^(src\/db|internal\/db|db|migrations)\//, domain: "database" },
+    { pattern: /^(src\/api|api|routes)\//, domain: "api-design" },
+    { pattern: /^(src\/ui|web|frontend|components)\//, domain: "frontend" },
+    { pattern: /^(test|tests)\//, domain: "testing" },
+    { pattern: /^docs\//, domain: "documentation" },
+    { pattern: /^(infra|deploy|\.github)\//, domain: "infrastructure" },
+];
+/** Classifies a single file path into a domain, or empty string if no match. */
+function classifyPath(filePath) {
+    for (const rule of categoryRules) {
+        if (rule.pattern.test(filePath)) {
+            return rule.domain;
+        }
+    }
+    return "";
+}
+/**
+ * AutoCategorize determines a domain and topic from a title and file paths.
+ *
+ * Domain: chosen by majority vote across all file paths. "uncategorized" if none match.
+ * Topic: derived from title via slugify. "general" if title is empty.
+ */
+export function autoCategorize(title, filePaths) {
+    const topic = slugify(title);
+    if (!filePaths || filePaths.length === 0) {
+        return { domain: "uncategorized", topic };
+    }
+    // Count votes for each domain
+    const votes = {};
+    for (const fp of filePaths) {
+        const d = classifyPath(fp);
+        if (d) {
+            votes[d] = (votes[d] ?? 0) + 1;
+        }
+    }
+    if (Object.keys(votes).length === 0) {
+        return { domain: "uncategorized", topic };
+    }
+    // Pick domain with highest vote count
+    let bestDomain = "";
+    let bestCount = 0;
+    for (const [domain, count] of Object.entries(votes)) {
+        if (count > bestCount) {
+            bestDomain = domain;
+            bestCount = count;
+        }
+    }
+    return { domain: bestDomain, topic };
+}
+export { classifyPath, categoryRules };
+//# sourceMappingURL=categorize.js.map

package/dist/core/categorize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categorize.js","sourceRoot":"","sources":["../../src/core/categorize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAO9C;;;GAGG;AACH,MAAM,aAAa,GAAmB;IACpC,0CAA0C;IAC1C,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE;IAC5C,EAAE,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,SAAS,EAAE;IAC1D,EAAE,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,SAAS,EAAE;IAC1D,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE;IAC7C,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,gBAAgB,EAAE;IAC1D,yBAAyB;IACzB,EAAE,OAAO,EAAE,oCAAoC,EAAE,MAAM,EAAE,gBAAgB,EAAE;IAC3E,EAAE,OAAO,EAAE,yCAAyC,EAAE,MAAM,EAAE,UAAU,EAAE;IAC1E,EAAE,OAAO,EAAE,0BAA0B,EAAE,MAAM,EAAE,YAAY,EAAE;IAC7D,EAAE,OAAO,EAAE,sCAAsC,EAAE,MAAM,EAAE,UAAU,EAAE;IACvE,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,SAAS,EAAE;IACjD,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE;IAC/C,EAAE,OAAO,EAAE,4BAA4B,EAAE,MAAM,EAAE,gBAAgB,EAAE;CACpE,CAAC;AAEF,gFAAgF;AAChF,SAAS,YAAY,CAAC,QAAgB;IACpC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,SAAmB;IAEnB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7B,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED,8BAA8B;IAC9B,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,CAAC,EAAE,CAAC;YACN,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;IAC5C,CAAC;IAED,sCAAsC;IACtC,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;YACtB,UAAU,GAAG,MAAM,CAAC;YACpB,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * WhySpec config.yaml reader/writer with Zod validation.
+ * Reads/writes .gitwhy/config.yaml in the project root.
+ */
+import { z } from "zod";
+/** Zod schema for .gitwhy/config.yaml */
+export declare const ConfigSchema: z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    project: z.ZodDefault<z.ZodObject<{
+        name: z.ZodDefault<z.ZodString>;
+        description: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+    telemetry: z.ZodDefault<z.ZodBoolean>;
+    default_agent: z.ZodDefault<z.ZodString>;
+    tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    context: z.ZodDefault<z.ZodString>;
+    rules: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type WhySpecConfig = z.infer<typeof ConfigSchema>;
+/** Reads and validates .gitwhy/config.yaml. Returns defaults if file doesn't exist. */
+export declare function readConfig(repoRoot: string): WhySpecConfig;
+/** Writes a validated config to .gitwhy/config.yaml. */
+export declare function writeConfig(repoRoot: string, config: Partial<WhySpecConfig>): void;
+/** Returns the default config as a YAML string (for init). */
+export declare function defaultConfigYaml(projectName?: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,yCAAyC;AACzC,eAAO,MAAM,YAAY;;;;;;;;;;;iBAavB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AASzD,uFAAuF;AACvF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAS1D;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAIlF;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,WAAW,SAAK,GAAG,MAAM,CAK1D"}

package/dist/core/config.js

@@ -0,0 +1,52 @@
+/**
+ * WhySpec config.yaml reader/writer with Zod validation.
+ * Reads/writes .gitwhy/config.yaml in the project root.
+ */
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { z } from "zod";
+import YAML from "yaml";
+/** Zod schema for .gitwhy/config.yaml */
+export const ConfigSchema = z.object({
+    version: z.string().default("1.0"),
+    project: z
+        .object({
+        name: z.string().default(""),
+        description: z.string().default(""),
+    })
+        .default(() => ({ name: "", description: "" })),
+    telemetry: z.boolean().default(true),
+    default_agent: z.string().default("claude-code"),
+    tools: z.array(z.string()).default(["claude-code"]),
+    context: z.string().default(""),
+    rules: z.string().default(""),
+});
+const CONFIG_DIR = ".gitwhy";
+const CONFIG_FILE = "config.yaml";
+function configPath(repoRoot) {
+    return join(repoRoot, CONFIG_DIR, CONFIG_FILE);
+}
+/** Reads and validates .gitwhy/config.yaml. Returns defaults if file doesn't exist. */
+export function readConfig(repoRoot) {
+    const path = configPath(repoRoot);
+    if (!existsSync(path)) {
+        return ConfigSchema.parse({});
+    }
+    const raw = readFileSync(path, "utf-8");
+    const parsed = YAML.parse(raw) ?? {};
+    return ConfigSchema.parse(parsed);
+}
+/** Writes a validated config to .gitwhy/config.yaml. */
+export function writeConfig(repoRoot, config) {
+    const validated = ConfigSchema.parse(config);
+    const yamlStr = YAML.stringify(validated);
+    writeFileSync(configPath(repoRoot), yamlStr, "utf-8");
+}
+/** Returns the default config as a YAML string (for init). */
+export function defaultConfigYaml(projectName = "") {
+    const config = ConfigSchema.parse({
+        project: { name: projectName },
+    });
+    return YAML.stringify(config);
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,yCAAyC;AACzC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAClC,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACpC,CAAC;SACD,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC9B,CAAC,CAAC;AAIH,MAAM,UAAU,GAAG,SAAS,CAAC;AAC7B,MAAM,WAAW,GAAG,aAAa,CAAC;AAElC,SAAS,UAAU,CAAC,QAAgB;IAClC,OAAO,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AACjD,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACrC,OAAO,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,MAA8B;IAC1E,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAC1C,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB,CAAC,WAAW,GAAG,EAAE;IAChD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC;QAChC,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;KAC/B,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/core/context.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Context generation for WhySpec capture command.
+ * - Context ID: ctx_ + 8-char alphanumeric
+ * - SaaS XML format (GitWhy compatible)
+ * - Decision Bridge extraction from design.md
+ */
+/**
+ * Generate a context ID: ctx_ + 8 random alphanumeric characters.
+ * Matches GitWhy convention (FR-20).
+ */
+export declare function generateContextId(): string;
+/**
+ * Render the SaaS-compatible XML context template.
+ */
+export declare function renderContextXml(): string;
+/**
+ * Extract decision items from design.md's "## Decisions to Make" section.
+ * Parses checkbox lines: `- [ ] description` and `- [x] description`.
+ * Returns the description text of each decision item.
+ */
+export declare function extractDecisions(designContent: string): string[];
+/**
+ * Get the start time of a change (used for commit range detection).
+ * Reads .started file written by `whyspec plan`. Falls back to folder birthtime.
+ */
+export declare function getChangeFolderCreatedAt(changePath: string): Date;
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAQ1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBhE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAUjE"}