@planu/cli 0.63.6 → 0.64.0

package/dist/engine/spec-reader.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Attempt to read the content of a spec file from disk.
+ * Returns null when specPath is undefined, the file does not exist, or a read
+ * error occurs. Callers should substitute a placeholder when null is returned.
+ */
+export declare function readSpecContent(specPath: string | undefined): Promise<string | null>;
+//# sourceMappingURL=spec-reader.d.ts.map

package/dist/engine/spec-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-reader.d.ts","sourceRoot":"","sources":["../../src/engine/spec-reader.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAY1F"}

package/dist/engine/spec-reader.js

@@ -0,0 +1,23 @@
+// engine/spec-reader.ts — Shared helper for reading spec file content from disk
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+/**
+ * Attempt to read the content of a spec file from disk.
+ * Returns null when specPath is undefined, the file does not exist, or a read
+ * error occurs. Callers should substitute a placeholder when null is returned.
+ */
+export async function readSpecContent(specPath) {
+    if (specPath === undefined) {
+        return null;
+    }
+    try {
+        if (existsSync(specPath)) {
+            return await readFile(specPath, 'utf-8');
+        }
+    }
+    catch {
+        // ignore filesystem errors — callers handle null
+    }
+    return null;
+}
+//# sourceMappingURL=spec-reader.js.map

package/dist/engine/spec-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-reader.js","sourceRoot":"","sources":["../../src/engine/spec-reader.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAA4B;IAChE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/engine/spec-repair.d.ts

@@ -0,0 +1,10 @@
+import type { RepairResult } from '../types/index.js';
+/**
+ * Detect and optionally fix common spec problems.
+ *
+ * @param specContent - Raw markdown content of the spec.md file.
+ * @param dryRun - When true, detects issues but does not apply fixes.
+ * @returns RepairResult with all detected fixes and (if !dryRun) repaired content.
+ */
+export declare function repairSpec(specContent: string, dryRun?: boolean): RepairResult;
+//# sourceMappingURL=spec-repair.d.ts.map

package/dist/engine/spec-repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-repair.d.ts","sourceRoot":"","sources":["../../src/engine/spec-repair.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAiZjE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,YAAY,CA2C5E"}

package/dist/engine/spec-repair.js

@@ -0,0 +1,388 @@
+// engine/spec-repair.ts — Auto-detect and fix common spec problems (SPEC-164)
+// Pure function module: no I/O, no side effects.
+import { parseFrontmatter, updateFrontmatterField } from './frontmatter-parser.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Required YAML frontmatter fields for a well-formed spec. */
+const REQUIRED_FRONTMATTER_FIELDS = ['id', 'title', 'type', 'status'];
+/** Vague phrases that indicate an untestable acceptance criterion. */
+const VAGUE_AC_PATTERNS = [
+    /\bshould work( well)?\b/i,
+    /\bworks? correctly\b/i,
+    /\bworks? (as expected|properly|fine)\b/i,
+    /\bfunctions? (correctly|properly|well)\b/i,
+    /\bis (fast|quick|efficient|smooth)\b/i,
+    /\buser.?friendly\b/i,
+    /\beasy to use\b/i,
+    /\bgood (performance|ux|experience)\b/i,
+    /\bsomething\b/i,
+    /\betc\.?\b/i,
+];
+/** Required markdown sections for a complete spec. */
+const REQUIRED_SECTIONS = ['## Acceptance Criteria', '## Description'];
+/**
+ * Tag keywords mapped to tag suggestions.
+ * Each keyword is matched as a whole word (word boundary) in the spec content.
+ */
+const TAG_KEYWORD_MAP = [
+    { pattern: /\bauth(entication)?\b/i, tag: 'authentication' },
+    { pattern: /\blogin\b/i, tag: 'authentication' },
+    { pattern: /\boauth\b/i, tag: 'authentication' },
+    { pattern: /\bpayment\b/i, tag: 'billing' },
+    { pattern: /\bbilling\b/i, tag: 'billing' },
+    { pattern: /\bstripe\b/i, tag: 'billing' },
+    { pattern: /\bnotification\b/i, tag: 'notifications' },
+    { pattern: /\bdashboard\b/i, tag: 'ui' },
+    { pattern: /\bfrontend\b/i, tag: 'frontend' },
+    { pattern: /\bbackend\b/i, tag: 'backend' },
+    { pattern: /\bapi\b/i, tag: 'api' },
+    { pattern: /\bdatabase\b/i, tag: 'database' },
+    { pattern: /\bmigration\b/i, tag: 'migration' },
+    { pattern: /\bsecurity\b/i, tag: 'security' },
+    { pattern: /\baudit\b/i, tag: 'security' },
+    { pattern: /\bperformance\b/i, tag: 'performance' },
+    { pattern: /\bcache\b/i, tag: 'performance' },
+    { pattern: /\bci\/cd\b|\bpipeline\b/i, tag: 'ci' },
+    { pattern: /\bdocker\b/i, tag: 'devops' },
+    { pattern: /\bdeploy(ment)?\b/i, tag: 'devops' },
+];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Find 1-based line number of the first line that matches a string pattern.
+ * Returns 0 if not found.
+ */
+function findLineNumber(content, search) {
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i]?.includes(search)) {
+            return i + 1;
+        }
+    }
+    return 0;
+}
+/**
+ * Check whether the frontmatter block is syntactically malformed
+ * (missing closing `---`, or opening delimiter not on first line).
+ */
+function detectMalformedFrontmatter(content) {
+    const lines = content.split('\n');
+    if (lines[0]?.trim() !== '---') {
+        return null; // No frontmatter at all — handled by missing-field checks
+    }
+    const closingIdx = lines.findIndex((l, i) => i > 0 && l.trim() === '---');
+    if (closingIdx === -1) {
+        const fix = {
+            type: 'frontmatter-malformed',
+            description: 'Frontmatter block is missing closing --- delimiter',
+            before: lines.slice(0, 5).join('\n'),
+            after: '',
+            line: 1,
+        };
+        return fix;
+    }
+    return null;
+}
+/**
+ * Check for missing required frontmatter fields.
+ * Returns one fix per missing field.
+ */
+function detectMissingFrontmatterFields(content, parsed) {
+    const fixes = [];
+    for (const field of REQUIRED_FRONTMATTER_FIELDS) {
+        if (parsed.metadata[field] === undefined || parsed.metadata[field] === null) {
+            fixes.push({
+                type: 'frontmatter-missing-field',
+                description: `Required frontmatter field "${field}" is missing`,
+                before: '',
+                after: `${field}: (fill in)`,
+                line: findLineNumber(content, '---'),
+            });
+        }
+    }
+    return fixes;
+}
+/**
+ * Detect acceptance criteria lines that use vague/untestable language.
+ * Matches checkbox lines (`- [ ]`) containing vague patterns.
+ */
+function detectVagueAcs(content) {
+    const fixes = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        const isAcLine = /^\s*-\s*\[[ x]\]\s+/i.test(line);
+        if (!isAcLine) {
+            continue;
+        }
+        for (const pattern of VAGUE_AC_PATTERNS) {
+            if (pattern.test(line)) {
+                const trimmed = line.trim();
+                const rewritten = trimmed.replace(/^(-\s*\[[ x]\]\s*)/i, '$1[REWRITE] Given <context>, when <action>, then <measurable outcome> — ');
+                fixes.push({
+                    type: 'ac-vague',
+                    description: `Acceptance criterion on line ${String(i + 1)} uses vague language ("${pattern.source}")`,
+                    before: trimmed,
+                    after: rewritten,
+                    line: i + 1,
+                });
+                break; // One fix per line
+            }
+        }
+    }
+    return fixes;
+}
+/**
+ * Detect missing required markdown sections.
+ */
+function detectMissingSections(content) {
+    const fixes = [];
+    for (const section of REQUIRED_SECTIONS) {
+        if (!content.includes(section)) {
+            fixes.push({
+                type: 'section-missing',
+                description: `Required section "${section}" is missing from the spec`,
+                before: '',
+                after: `${section}\n\n(Add content here)\n`,
+                line: 0,
+            });
+        }
+    }
+    return fixes;
+}
+/**
+ * Extract array values from a frontmatter field that may have hyphenated keys.
+ * Reads directly from the raw content because the frontmatter parser's KV regex
+ * only supports \w+ keys (no hyphens).
+ */
+function extractFrontmatterArray(content, field) {
+    const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n/;
+    const match = FRONTMATTER_RE.exec(content);
+    if (!match?.[1]) {
+        return [];
+    }
+    const escaped = field.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const fieldRe = new RegExp(`^${escaped}:\\s*\\[(.*)\\]`, 'm');
+    const fieldMatch = fieldRe.exec(match[1]);
+    if (!fieldMatch?.[1]) {
+        return [];
+    }
+    return fieldMatch[1]
+        .split(',')
+        .map((s) => s.trim().replace(/^["']|["']$/g, ''))
+        .filter((s) => s.length > 0);
+}
+/**
+ * Detect broken cross-references: `depends-on` or `blockedBy` values pointing
+ * to spec IDs that don't look like valid SPEC-NNN identifiers.
+ */
+function detectBrokenCrossReferences(content, parsed) {
+    const fixes = [];
+    const SPEC_ID_RE = /^SPEC-\d+$/;
+    // Fields accessible via standard parser (no hyphens)
+    const standardFields = [
+        { field: 'blockedBy', values: parsed.metadata.blockedBy },
+        { field: 'dependencies', values: parsed.metadata.dependencies },
+    ];
+    for (const { field, values } of standardFields) {
+        if (!Array.isArray(values)) {
+            continue;
+        }
+        for (const v of values) {
+            if (typeof v === 'string' && v.length > 0 && !SPEC_ID_RE.test(v)) {
+                fixes.push({
+                    type: 'cross-reference-broken',
+                    description: `Cross-reference "${v}" in "${field}" does not match SPEC-NNN format`,
+                    before: v,
+                    after: 'SPEC-??? (verify or remove)',
+                    line: findLineNumber(content, v),
+                });
+            }
+        }
+    }
+    // Handle hyphenated key `depends-on` via raw content parsing
+    const dependsOnValues = extractFrontmatterArray(content, 'depends-on');
+    for (const v of dependsOnValues) {
+        if (!SPEC_ID_RE.test(v)) {
+            fixes.push({
+                type: 'cross-reference-broken',
+                description: `Cross-reference "${v}" in "depends-on" does not match SPEC-NNN format`,
+                before: v,
+                after: 'SPEC-??? (verify or remove)',
+                line: findLineNumber(content, v),
+            });
+        }
+    }
+    return fixes;
+}
+/**
+ * Extract the searchable content for tag analysis: frontmatter + Description section only.
+ * Excludes Acceptance Criteria and other sections to reduce false positives.
+ */
+function extractTagSearchContent(content) {
+    // Use frontmatter block + Description section only
+    const parts = [];
+    // Frontmatter
+    const fmMatch = /^---\n([\s\S]*?)\n---\n/.exec(content);
+    if (fmMatch?.[1]) {
+        parts.push(fmMatch[1]);
+    }
+    // Description section (up to the next ## heading)
+    const descMatch = /##\s+Description\n([\s\S]*?)(?=\n##\s|$)/.exec(content);
+    if (descMatch?.[1]) {
+        parts.push(descMatch[1]);
+    }
+    // Fall back to first 30 lines if no description section found
+    if (parts.length === 0) {
+        parts.push(content.split('\n').slice(0, 30).join('\n'));
+    }
+    return parts.join('\n');
+}
+/**
+ * Suggest missing tags based on content analysis.
+ * Returns at most one fix listing all recommended tags.
+ */
+function detectMissingTags(content, parsed) {
+    const existingTags = new Set(Array.isArray(parsed.metadata.tags) ? parsed.metadata.tags : []);
+    const searchContent = extractTagSearchContent(content);
+    const recommended = [];
+    for (const { pattern, tag } of TAG_KEYWORD_MAP) {
+        if (!existingTags.has(tag) && pattern.test(searchContent) && !recommended.includes(tag)) {
+            recommended.push(tag);
+        }
+    }
+    if (recommended.length === 0) {
+        return [];
+    }
+    const allTags = [...existingTags, ...recommended];
+    const tagsStr = `[${allTags.join(', ')}]`;
+    return [
+        {
+            type: 'tags-missing',
+            description: `Suggested tags based on content analysis: ${recommended.join(', ')}`,
+            before: Array.isArray(parsed.metadata.tags)
+                ? `[${parsed.metadata.tags.join(', ')}]`
+                : '(none)',
+            after: tagsStr,
+            line: findLineNumber(content, 'tags:'),
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Apply fixes helpers
+// ---------------------------------------------------------------------------
+/**
+ * Apply a single fix to the content string.
+ * Returns the updated content.
+ */
+function applyFix(content, fix) {
+    switch (fix.type) {
+        case 'frontmatter-malformed': {
+            // Add closing delimiter after the last frontmatter line if missing
+            const lines = content.split('\n');
+            const startIdx = lines.findIndex((l) => l.trim() === '---');
+            if (startIdx === -1) {
+                return content;
+            }
+            // Find empty line or end of file after opening ---
+            let insertAt = lines.length;
+            for (let i = startIdx + 1; i < lines.length; i++) {
+                if (lines[i]?.trim() === '' && i > startIdx + 1) {
+                    insertAt = i;
+                    break;
+                }
+            }
+            lines.splice(insertAt, 0, '---');
+            return lines.join('\n');
+        }
+        case 'frontmatter-missing-field': {
+            // Extract field name from description
+            const match = /field "(\w+)"/.exec(fix.description);
+            if (!match?.[1]) {
+                return content;
+            }
+            return updateFrontmatterField(content, match[1], '(fill in)');
+        }
+        case 'ac-vague': {
+            // Replace vague AC line with the rewritten version
+            const lines = content.split('\n');
+            const lineIdx = fix.line - 1;
+            const currentLine = lines[lineIdx];
+            if (lineIdx >= 0 && lineIdx < lines.length && currentLine?.includes(fix.before)) {
+                lines[lineIdx] = currentLine.replace(fix.before, fix.after);
+            }
+            return lines.join('\n');
+        }
+        case 'section-missing': {
+            // Append missing section before the last heading or at end
+            if (content.trimEnd().endsWith('\n')) {
+                return `${content}${fix.after}`;
+            }
+            return `${content}\n\n${fix.after}`;
+        }
+        case 'cross-reference-broken': {
+            // Cannot auto-fix — user must verify the referenced spec ID
+            return content;
+        }
+        case 'tags-missing': {
+            // Update tags in frontmatter
+            return updateFrontmatterField(content, 'tags', fix.after);
+        }
+        case 'ac-format': {
+            // Cannot auto-fix ac-format issues automatically
+            return content;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Detect and optionally fix common spec problems.
+ *
+ * @param specContent - Raw markdown content of the spec.md file.
+ * @param dryRun - When true, detects issues but does not apply fixes.
+ * @returns RepairResult with all detected fixes and (if !dryRun) repaired content.
+ */
+export function repairSpec(specContent, dryRun = false) {
+    const parsed = parseFrontmatter(specContent);
+    const malformedFix = detectMalformedFrontmatter(specContent);
+    const fixes = [
+        ...(malformedFix ? [malformedFix] : []),
+        ...detectMissingFrontmatterFields(specContent, parsed),
+        ...detectVagueAcs(specContent),
+        ...detectMissingSections(specContent),
+        ...detectBrokenCrossReferences(specContent, parsed),
+        ...detectMissingTags(specContent, parsed),
+    ];
+    if (dryRun || fixes.length === 0) {
+        return {
+            fixes,
+            repairedContent: specContent,
+            fixCount: fixes.length,
+            dryRun,
+        };
+    }
+    // Apply fixes sequentially — skip cross-reference-broken (manual fix required)
+    let repaired = specContent;
+    let applied = 0;
+    for (const fix of fixes) {
+        if (fix.type === 'cross-reference-broken') {
+            continue; // Cannot auto-fix
+        }
+        const before = repaired;
+        repaired = applyFix(repaired, fix);
+        if (repaired !== before) {
+            applied++;
+        }
+    }
+    return {
+        fixes,
+        repairedContent: repaired,
+        fixCount: applied,
+        dryRun: false,
+    };
+}
+//# sourceMappingURL=spec-repair.js.map

package/dist/engine/spec-repair.js.map

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

package/dist/engine/spec-summary-html.js

@@ -253,7 +253,7 @@ function getInlineScript() {
     });
     if (search) search.placeholder = lang === 'es' ? 'Buscar specs\\u2026' : 'Search specs\\u2026';
     langBtns.forEach(function(b) { b.classList.toggle('active', b.dataset.lang === lang); });
-    try { localStorage.setItem('planu-lang', lang); } catch(e) {}
+    try { localStorage.setItem('planu-lang', lang); } catch(e) { /* localStorage unavailable in private browsing — ignore */ }
     applyFilters();
   }
 
@@ -272,7 +272,7 @@ function getInlineScript() {
   });
 
   var saved = null;
-  try { saved = localStorage.getItem('planu-lang'); } catch(e) {}
+  try { saved = localStorage.getItem('planu-lang'); } catch(e) { /* localStorage unavailable in private browsing — ignore */ }
   var autoLang = saved || (navigator.language.startsWith('es') ? 'es' : 'en');
   setLang(autoLang);
 })();`;

package/dist/engine/spec-versioning/brancher.d.ts

@@ -0,0 +1,17 @@
+import type { SpecBranch, CreateSpecBranchInput } from '../../types/index.js';
+/** Validate branch name: lowercase kebab-case, non-empty. */
+export declare function isValidBranchName(name: string): boolean;
+/** Load a branch. Returns null if not found. */
+export declare function loadBranch(dataDir: string, specId: string, branchName: string): Promise<SpecBranch | null>;
+/**
+ * Create a new spec branch.
+ * Throws if branch name is invalid, already exists, or fromVersion is not found.
+ */
+export declare function createBranch(dataDir: string, input: CreateSpecBranchInput): Promise<SpecBranch>;
+/** Update the content of an existing branch. Throws if not found. */
+export declare function updateBranchContent(dataDir: string, specId: string, branchName: string, newContent: string): Promise<SpecBranch>;
+/** List all branches for a spec. Returns empty array if none found. */
+export declare function listBranches(dataDir: string, specId: string): Promise<SpecBranch[]>;
+/** Delete a branch after a successful merge. Returns true if deleted, false if not found. */
+export declare function deleteBranch(dataDir: string, specId: string, branchName: string): Promise<boolean>;
+//# sourceMappingURL=brancher.d.ts.map

package/dist/engine/spec-versioning/brancher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brancher.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-versioning/brancher.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAe9E,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,gDAAgD;AAChD,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAQ5B;AAYD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,UAAU,CAAC,CA6BrB;AAED,qEAAqE;AACrE,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED,uEAAuE;AACvE,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA0BzF;AAED,6FAA6F;AAC7F,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/engine/spec-versioning/brancher.js

@@ -0,0 +1,113 @@
+// engine/spec-versioning/brancher.ts — Create, list, and delete spec branches
+import { readFile, writeFile, mkdir, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { getVersionsDir, getLatestVersionTag } from './version-store.js';
+const BRANCHES_SUBDIR = 'branches';
+/** Build the path to a branch JSON file. */
+function getBranchFilePath(dataDir, specId, branchName) {
+    return join(getVersionsDir(dataDir, specId), BRANCHES_SUBDIR, `${branchName}.json`);
+}
+/** Build the branches directory for a spec. */
+function getBranchesDir(dataDir, specId) {
+    return join(getVersionsDir(dataDir, specId), BRANCHES_SUBDIR);
+}
+/** Validate branch name: lowercase kebab-case, non-empty. */
+export function isValidBranchName(name) {
+    return /^[a-z][a-z0-9-]*$/.test(name) && name.length <= 100;
+}
+/** Load a branch. Returns null if not found. */
+export async function loadBranch(dataDir, specId, branchName) {
+    const filePath = getBranchFilePath(dataDir, specId, branchName);
+    try {
+        const raw = await readFile(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Persist a branch to disk. Creates directories as needed. */
+async function saveBranch(dataDir, branch) {
+    const dir = getBranchesDir(dataDir, branch.specId);
+    if (!existsSync(dir)) {
+        await mkdir(dir, { recursive: true });
+    }
+    const filePath = getBranchFilePath(dataDir, branch.specId, branch.name);
+    await writeFile(filePath, JSON.stringify(branch, null, 2), 'utf-8');
+}
+/**
+ * Create a new spec branch.
+ * Throws if branch name is invalid, already exists, or fromVersion is not found.
+ */
+export async function createBranch(dataDir, input) {
+    const { specId, branchName, content } = input;
+    if (!isValidBranchName(branchName)) {
+        throw new Error(`Invalid branch name "${branchName}". Use lowercase kebab-case (e.g., "auth-refactor").`);
+    }
+    const existing = await loadBranch(dataDir, specId, branchName);
+    if (existing !== null) {
+        throw new Error(`Branch "${branchName}" already exists for spec ${specId}. Choose a different name.`);
+    }
+    const fromVersion = input.fromVersion ?? (await getLatestVersionTag(dataDir, specId)) ?? 'unversioned';
+    const branch = {
+        name: branchName,
+        specId,
+        createdAt: new Date().toISOString(),
+        fromVersion,
+        content,
+    };
+    await saveBranch(dataDir, branch);
+    return branch;
+}
+/** Update the content of an existing branch. Throws if not found. */
+export async function updateBranchContent(dataDir, specId, branchName, newContent) {
+    const existing = await loadBranch(dataDir, specId, branchName);
+    if (existing === null) {
+        throw new Error(`Branch "${branchName}" not found for spec ${specId}.`);
+    }
+    const updated = { ...existing, content: newContent };
+    await saveBranch(dataDir, updated);
+    return updated;
+}
+/** List all branches for a spec. Returns empty array if none found. */
+export async function listBranches(dataDir, specId) {
+    const { readdir } = await import('node:fs/promises');
+    const dir = getBranchesDir(dataDir, specId);
+    if (!existsSync(dir)) {
+        return [];
+    }
+    try {
+        const files = await readdir(dir);
+        const branches = [];
+        for (const file of files) {
+            if (!file.endsWith('.json')) {
+                continue;
+            }
+            const filePath = join(dir, file);
+            try {
+                const raw = await readFile(filePath, 'utf-8');
+                branches.push(JSON.parse(raw));
+            }
+            catch {
+                // Skip corrupt files
+            }
+        }
+        return branches.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    catch {
+        return [];
+    }
+}
+/** Delete a branch after a successful merge. Returns true if deleted, false if not found. */
+export async function deleteBranch(dataDir, specId, branchName) {
+    const filePath = getBranchFilePath(dataDir, specId, branchName);
+    try {
+        await unlink(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=brancher.js.map

package/dist/engine/spec-versioning/brancher.js.map

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

package/dist/engine/spec-versioning/differ.d.ts

@@ -0,0 +1,19 @@
+import type { SpecVersionDiff } from '../../types/index.js';
+import { extractAcceptanceCriteria } from '../shared/ac-extractor.js';
+import { computeLineDiff } from '../shared/line-diff.js';
+export { extractAcceptanceCriteria, computeLineDiff };
+/** Compute AC-level diff between two sets of criteria. */
+export declare function computeAcDiff(fromCriteria: string[], toCriteria: string[]): SpecVersionDiff['criteriaChanges'];
+/** Detect which sections changed between two spec contents. */
+export declare function detectSectionChanges(fromContent: string, toContent: string): string[];
+/**
+ * Diff two spec versions stored on disk.
+ * Throws if either version tag is not found.
+ */
+export declare function diffVersions(dataDir: string, specId: string, fromTag: string, toTag: string): Promise<SpecVersionDiff>;
+/**
+ * Diff two spec content strings directly (no disk lookup).
+ * Used before merging to show what will change.
+ */
+export declare function diffContents(specId: string, fromTag: string, toTag: string, fromContent: string, toContent: string): SpecVersionDiff;
+//# sourceMappingURL=differ.d.ts.map

package/dist/engine/spec-versioning/differ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../../../src/engine/spec-versioning/differ.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,CAAC;AAUtD,0DAA0D;AAC1D,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,EAAE,MAAM,EAAE,GACnB,eAAe,CAAC,iBAAiB,CAAC,CA8BpC;AAmDD,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBrF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,eAAe,CAgBjB"}