@gitwhy-cli/whyspec 0.1.0

package/dist/core/context.js

@@ -0,0 +1,75 @@
+/**
+ * Context generation for WhySpec capture command.
+ * - Context ID: ctx_ + 8-char alphanumeric
+ * - SaaS XML format (GitWhy compatible)
+ * - Decision Bridge extraction from design.md
+ */
+import { randomBytes } from "node:crypto";
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { contextTemplate } from "./templates.js";
+/**
+ * Generate a context ID: ctx_ + 8 random alphanumeric characters.
+ * Matches GitWhy convention (FR-20).
+ */
+export function generateContextId() {
+    const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+    const bytes = randomBytes(8);
+    let id = "";
+    for (let i = 0; i < 8; i++) {
+        id += chars[bytes[i] % chars.length];
+    }
+    return `ctx_${id}`;
+}
+/**
+ * Render the SaaS-compatible XML context template.
+ */
+export function renderContextXml() {
+    return contextTemplate();
+}
+/**
+ * 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 function extractDecisions(designContent) {
+    const lines = designContent.split("\n");
+    const decisions = [];
+    let inSection = false;
+    for (const line of lines) {
+        // Start capturing when we hit the Decisions to Make heading
+        if (/^##\s+Decisions to Make/i.test(line)) {
+            inSection = true;
+            continue;
+        }
+        // Stop at the next heading
+        if (inSection && /^##\s/.test(line)) {
+            break;
+        }
+        // Capture checkbox items within the section
+        if (inSection) {
+            const match = line.match(/^-\s+\[[ xX]\]\s+(.+)/);
+            if (match) {
+                decisions.push(match[1].trim());
+            }
+        }
+    }
+    return decisions;
+}
+/**
+ * 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 function getChangeFolderCreatedAt(changePath) {
+    const startedFile = join(changePath, ".started");
+    if (existsSync(startedFile)) {
+        const ts = readFileSync(startedFile, "utf-8").trim();
+        const parsed = new Date(ts);
+        if (!isNaN(parsed.getTime()))
+            return parsed;
+    }
+    // Fallback to folder birthtime (less reliable across platforms)
+    const stat = statSync(changePath);
+    return stat.birthtime;
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,sCAAsC,CAAC;IACrD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,OAAO,EAAE,EAAE,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,aAAqB;IACpD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,4DAA4D;QAC5D,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,SAAS,GAAG,IAAI,CAAC;YACjB,SAAS;QACX,CAAC;QACD,2BAA2B;QAC3B,IAAI,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM;QACR,CAAC;QACD,4CAA4C;QAC5C,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAClD,IAAI,KAAK,EAAE,CAAC;gBACV,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAkB;IACzD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAAE,OAAO,MAAM,CAAC;IAC9C,CAAC;IACD,gEAAgE;IAChE,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,SAAS,CAAC;AACxB,CAAC"}

package/dist/core/search.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Search engine for WhySpec.
+ * Ported from GitWhy Go: internal/storage/tree.go
+ *   - splitMarkdownSections (tree.go:786-822)
+ *   - computeSearchScore (tree.go:736-781)
+ *   - SearchContexts (tree.go:648-732)
+ *
+ * Searches all .md files in .gitwhy/changes/ (ctx_*.md, intent.md, design.md)
+ * using weighted section scoring.
+ */
+export interface SearchResult {
+    id: string;
+    title: string;
+    change_name: string;
+    domain: string;
+    score: number;
+    matched_sections: string[];
+    path: string;
+    snippet: string;
+}
+/**
+ * Split a markdown document into named sections.
+ * Returns a map keyed by lowercase section name (H2 headers).
+ * The special key "title" holds the first H1 line text.
+ *
+ * Ported from tree.go:splitMarkdownSections (lines 786-822).
+ */
+export declare function splitMarkdownSections(content: string): Record<string, string>;
+/**
+ * Compute a relevance score for a document based on which markdown sections
+ * contain the query string (case-insensitive).
+ *
+ * Ported from tree.go:computeSearchScore (lines 736-781).
+ * Weights: title=100, prompt=50, reasoning=30, "what was done"=30, files=20, fallback=10.
+ */
+export declare function computeSearchScore(content: string, lowerQuery: string): {
+    score: number;
+    matchedSections: string[];
+};
+/**
+ * Search all .md files in .gitwhy/changes/ for a query string.
+ * Returns scored results sorted by score descending, then date descending.
+ *
+ * Searches ctx_*.md, intent.md, and design.md (FR-25).
+ * Supports domain filtering and result limit.
+ */
+export declare function searchChanges(repoRoot: string, query: string, options?: {
+    domain?: string;
+    limit?: number;
+}): SearchResult[];
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/core/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoC7E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,CA0C9C;AAiFD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,YAAY,EAAE,CAsEhB"}

package/dist/core/search.js

@@ -0,0 +1,235 @@
+/**
+ * Search engine for WhySpec.
+ * Ported from GitWhy Go: internal/storage/tree.go
+ *   - splitMarkdownSections (tree.go:786-822)
+ *   - computeSearchScore (tree.go:736-781)
+ *   - SearchContexts (tree.go:648-732)
+ *
+ * Searches all .md files in .gitwhy/changes/ (ctx_*.md, intent.md, design.md)
+ * using weighted section scoring.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { basename, join, relative } from "node:path";
+import { changesDir } from "./storage.js";
+import { autoCategorize } from "./categorize.js";
+/**
+ * Split a markdown document into named sections.
+ * Returns a map keyed by lowercase section name (H2 headers).
+ * The special key "title" holds the first H1 line text.
+ *
+ * Ported from tree.go:splitMarkdownSections (lines 786-822).
+ */
+export function splitMarkdownSections(content) {
+    const sections = {};
+    const lines = content.split("\n");
+    let currentSection = "";
+    let sectionLines = [];
+    for (const line of lines) {
+        // Capture the title (first H1).
+        if (!("title" in sections) && line.startsWith("# ")) {
+            sections["title"] = line.slice(2);
+            continue;
+        }
+        // Detect H2 section headers.
+        if (line.startsWith("## ")) {
+            // Flush the previous section.
+            if (currentSection) {
+                sections[currentSection] = sectionLines.join("\n");
+            }
+            currentSection = line.slice(3).toLowerCase();
+            sectionLines = [];
+            continue;
+        }
+        if (currentSection) {
+            sectionLines.push(line);
+        }
+    }
+    // Flush the last section.
+    if (currentSection) {
+        sections[currentSection] = sectionLines.join("\n");
+    }
+    return sections;
+}
+/**
+ * Compute a relevance score for a document based on which markdown sections
+ * contain the query string (case-insensitive).
+ *
+ * Ported from tree.go:computeSearchScore (lines 736-781).
+ * Weights: title=100, prompt=50, reasoning=30, "what was done"=30, files=20, fallback=10.
+ */
+export function computeSearchScore(content, lowerQuery) {
+    const sections = splitMarkdownSections(content);
+    let score = 0;
+    const matchedSections = [];
+    // Title match: first # line (100 points).
+    if (sections["title"] && sections["title"].toLowerCase().includes(lowerQuery)) {
+        score += 100;
+        matchedSections.push("title");
+    }
+    // Prompt section (50 points).
+    if (sections["prompt"] && sections["prompt"].toLowerCase().includes(lowerQuery)) {
+        score += 50;
+        matchedSections.push("prompt");
+    }
+    // Reasoning section (30 points).
+    if (sections["reasoning"] && sections["reasoning"].toLowerCase().includes(lowerQuery)) {
+        score += 30;
+        matchedSections.push("reasoning");
+    }
+    // What Was Done section (30 points).
+    if (sections["what was done"] && sections["what was done"].toLowerCase().includes(lowerQuery)) {
+        score += 30;
+        matchedSections.push("what was done");
+    }
+    // Files section (20 points).
+    if (sections["files"] && sections["files"].toLowerCase().includes(lowerQuery)) {
+        score += 20;
+        matchedSections.push("files");
+    }
+    // Fallback: if no specific section matched but the query IS in the content, give 10 points.
+    if (score === 0 && content.toLowerCase().includes(lowerQuery)) {
+        score += 10;
+        matchedSections.push("content");
+    }
+    return { score, matchedSections };
+}
+/**
+ * Walk a directory recursively and collect all .md file paths.
+ */
+function walkMarkdownFiles(dir) {
+    const results = [];
+    if (!existsSync(dir))
+        return results;
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...walkMarkdownFiles(fullPath));
+        }
+        else if (entry.name.startsWith("ctx_") && entry.name.endsWith(".md") ||
+            entry.name === "intent.md" ||
+            entry.name === "design.md") {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+/**
+ * Extract a snippet from the highest-scoring section content.
+ */
+function extractSnippet(content, lowerQuery, maxLen = 150) {
+    const lower = content.toLowerCase();
+    const idx = lower.indexOf(lowerQuery);
+    if (idx === -1)
+        return content.slice(0, maxLen).trim();
+    // Show context around the match.
+    const start = Math.max(0, idx - 40);
+    const end = Math.min(content.length, idx + lowerQuery.length + maxLen - 40);
+    let snippet = content.slice(start, end).replace(/\n/g, " ").trim();
+    if (start > 0)
+        snippet = "..." + snippet;
+    if (end < content.length)
+        snippet = snippet + "...";
+    return snippet;
+}
+/**
+ * Extract the title from markdown content (first H1 line).
+ */
+function extractTitle(content) {
+    const match = content.match(/^# (.+)/m);
+    return match ? match[1].trim() : "";
+}
+/**
+ * Extract file paths listed in a <files> tag or ## Files section.
+ */
+function extractFilePaths(content) {
+    const paths = [];
+    // Try XML <files> tag first.
+    const filesMatch = content.match(/<files>([\s\S]*?)<\/files>/);
+    if (filesMatch) {
+        const lines = filesMatch[1].split("\n").map((l) => l.trim()).filter(Boolean);
+        for (const line of lines) {
+            // Format: path/to/file — action — description
+            const parts = line.split(/\s+—\s+/);
+            if (parts[0])
+                paths.push(parts[0].trim());
+        }
+        return paths;
+    }
+    // Try ## Files section.
+    const sections = splitMarkdownSections(content);
+    if (sections["files"]) {
+        const lines = sections["files"].split("\n").map((l) => l.trim()).filter(Boolean);
+        for (const line of lines) {
+            const parts = line.split(/\s+—\s+/);
+            if (parts[0])
+                paths.push(parts[0].trim());
+        }
+    }
+    return paths;
+}
+/**
+ * Search all .md files in .gitwhy/changes/ for a query string.
+ * Returns scored results sorted by score descending, then date descending.
+ *
+ * Searches ctx_*.md, intent.md, and design.md (FR-25).
+ * Supports domain filtering and result limit.
+ */
+export function searchChanges(repoRoot, query, options) {
+    if (!query)
+        return [];
+    const dir = changesDir(repoRoot);
+    if (!existsSync(dir))
+        return [];
+    const lowerQuery = query.toLowerCase();
+    const limit = options?.limit ?? 10;
+    const results = [];
+    // Walk all change directories.
+    const changeDirs = readdirSync(dir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name);
+    for (const changeName of changeDirs) {
+        const changeDir = join(dir, changeName);
+        const mdFiles = walkMarkdownFiles(changeDir);
+        for (const filePath of mdFiles) {
+            const content = readFileSync(filePath, "utf-8");
+            const lowerContent = content.toLowerCase();
+            // Only proceed if the query matches somewhere in the file.
+            if (!lowerContent.includes(lowerQuery))
+                continue;
+            const { score, matchedSections } = computeSearchScore(content, lowerQuery);
+            const title = extractTitle(content) || changeName;
+            const filePaths = extractFilePaths(content);
+            const { domain } = autoCategorize(title, filePaths);
+            // Apply domain filter if specified.
+            if (options?.domain && domain !== options.domain)
+                continue;
+            // Derive ID from filename (without .md extension). Use path.basename for cross-platform safety.
+            const id = basename(filePath, ".md");
+            const snippet = extractSnippet(content, lowerQuery);
+            const relPath = relative(repoRoot, filePath);
+            const mtime = statSync(filePath).mtime;
+            results.push({
+                result: {
+                    id,
+                    title,
+                    change_name: changeName,
+                    domain,
+                    score,
+                    matched_sections: matchedSections,
+                    path: relPath,
+                    snippet,
+                },
+                mtime,
+            });
+        }
+    }
+    // Sort by score descending, then by date descending for ties.
+    results.sort((a, b) => {
+        if (a.result.score !== b.result.score)
+            return b.result.score - a.result.score;
+        return b.mtime.getTime() - a.mtime.getTime();
+    });
+    return results.slice(0, limit).map((r) => r.result);
+}
+//# sourceMappingURL=search.js.map

package/dist/core/search.js.map

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

package/dist/core/storage.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Storage module for WhySpec.
+ * Manages .gitwhy/ directory structure, reads/writes markdown files,
+ * generates context IDs.
+ */
+/**
+ * Generates a context ID: ctx_ + 8-char alphanumeric.
+ * Uses crypto.randomBytes for randomness.
+ */
+export declare function generateContextId(): string;
+/** Returns the .gitwhy directory path for a repo root. */
+export declare function gitwhyDir(repoRoot: string): string;
+/** Returns the changes directory path. */
+export declare function changesDir(repoRoot: string): string;
+/**
+ * Ensures the .gitwhy/ directory structure exists:
+ *   .gitwhy/
+ *   ├── changes/
+ *   ├── archive/
+ *   └── debug/
+ */
+export declare function ensureDirectoryStructure(repoRoot: string): void;
+/**
+ * Creates a change directory under .gitwhy/changes/<name>/.
+ * Returns the created path.
+ */
+export declare function createChangeDir(repoRoot: string, changeName: string): string;
+/** Reads a markdown file from a change directory. Returns null if not found. */
+export declare function readMarkdown(changeDir: string, filename: string): string | null;
+/** Writes a markdown file to a change directory. */
+export declare function writeMarkdown(changeDir: string, filename: string, content: string): void;
+/** Lists all change names in .gitwhy/changes/. */
+export declare function listChanges(repoRoot: string): string[];
+/** Checks if a specific change directory exists. */
+export declare function changeExists(repoRoot: string, changeName: string): boolean;
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/core/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAU/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAI5E;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI/E;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAExF;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAMtD;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE1E"}

package/dist/core/storage.js

@@ -0,0 +1,80 @@
+/**
+ * Storage module for WhySpec.
+ * Manages .gitwhy/ directory structure, reads/writes markdown files,
+ * generates context IDs.
+ */
+import { mkdirSync, readFileSync, writeFileSync, existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { randomBytes } from "node:crypto";
+const GITWHY_DIR = ".gitwhy";
+const CHANGES_DIR = "changes";
+const ARCHIVE_DIR = "archive";
+const DEBUG_DIR = "debug";
+/**
+ * Generates a context ID: ctx_ + 8-char alphanumeric.
+ * Uses crypto.randomBytes for randomness.
+ */
+export function generateContextId() {
+    const bytes = randomBytes(4);
+    return `ctx_${bytes.toString("hex")}`;
+}
+/** Returns the .gitwhy directory path for a repo root. */
+export function gitwhyDir(repoRoot) {
+    return join(repoRoot, GITWHY_DIR);
+}
+/** Returns the changes directory path. */
+export function changesDir(repoRoot) {
+    return join(repoRoot, GITWHY_DIR, CHANGES_DIR);
+}
+/**
+ * Ensures the .gitwhy/ directory structure exists:
+ *   .gitwhy/
+ *   ├── changes/
+ *   ├── archive/
+ *   └── debug/
+ */
+export function ensureDirectoryStructure(repoRoot) {
+    const dirs = [
+        join(repoRoot, GITWHY_DIR),
+        join(repoRoot, GITWHY_DIR, CHANGES_DIR),
+        join(repoRoot, GITWHY_DIR, ARCHIVE_DIR),
+        join(repoRoot, GITWHY_DIR, DEBUG_DIR),
+    ];
+    for (const dir of dirs) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Creates a change directory under .gitwhy/changes/<name>/.
+ * Returns the created path.
+ */
+export function createChangeDir(repoRoot, changeName) {
+    const dir = join(repoRoot, GITWHY_DIR, CHANGES_DIR, changeName);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+/** Reads a markdown file from a change directory. Returns null if not found. */
+export function readMarkdown(changeDir, filename) {
+    const path = join(changeDir, filename);
+    if (!existsSync(path))
+        return null;
+    return readFileSync(path, "utf-8");
+}
+/** Writes a markdown file to a change directory. */
+export function writeMarkdown(changeDir, filename, content) {
+    writeFileSync(join(changeDir, filename), content, "utf-8");
+}
+/** Lists all change names in .gitwhy/changes/. */
+export function listChanges(repoRoot) {
+    const dir = changesDir(repoRoot);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name);
+}
+/** Checks if a specific change directory exists. */
+export function changeExists(repoRoot, changeName) {
+    return existsSync(join(repoRoot, GITWHY_DIR, CHANGES_DIR, changeName));
+}
+//# sourceMappingURL=storage.js.map

package/dist/core/storage.js.map

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

package/dist/core/templates.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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 declare function intentTemplate(changeName: string): string;
+/** Template for design.md — technical approach with trade-offs. */
+export declare function designTemplate(changeName: string): string;
+/** Template for tasks.md — implementation checklist with goal-backward verification. */
+export declare function tasksTemplate(changeName: string): string;
+/**
+ * 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 declare function contextTemplate(options?: {
+    title?: string;
+    agent?: string;
+    tags?: string;
+}): string;
+/** Template for debug.md — structured debugging process. */
+export declare function debugTemplate(bugName: string): string;
+/** Returns a template by type name. */
+export declare function getTemplate(type: "intent" | "design" | "tasks" | "context" | "debug", name?: string): string;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAsBzD;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA6BzD;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAWxD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,CAuCT;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAuCrD;AAED,uCAAuC;AACvC,wBAAgB,WAAW,CACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,EACzD,IAAI,SAAK,GACR,MAAM,CAaR"}