@planu/cli 1.11.0 → 1.13.0

package/dist/engine/ears/spec-linter.js

@@ -0,0 +1,127 @@
+// engine/ears/spec-linter.ts — EARS-based spec linting (SPEC-410)
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { glob } from 'glob';
+import { scoreCriterion, gradeSpec } from './criterion-scorer.js';
+// Regex to extract acceptance criteria lines (checkbox format)
+const AC_LINE_REGEX = /^\s*-\s+\[[ xX]\]\s+(.+)$/;
+/**
+ * Extract acceptance criteria texts from spec.md content.
+ * Recognizes lines formatted as "- [ ] criterion" or "- [x] criterion".
+ */
+function extractCriteria(content) {
+    return content
+        .split('\n')
+        .map((line) => AC_LINE_REGEX.exec(line))
+        .filter((m) => m !== null)
+        .map((m) => {
+        const text = m[1];
+        // This is safe: AC_LINE_REGEX always captures group 1 when match succeeds
+        return (text ?? '').trim();
+    })
+        .filter((t) => t.length > 0);
+}
+function buildSpecReport(specId, criteria) {
+    if (criteria.length === 0) {
+        return {
+            specId,
+            criteriaCount: 0,
+            overallScore: 0,
+            compliantCount: 0,
+            partialCount: 0,
+            nonCompliantCount: 0,
+            criteria: [],
+            grade: 'F',
+        };
+    }
+    const overallScore = Math.round((criteria.reduce((sum, c) => sum + c.overallScore, 0) / criteria.length) * 10) / 10;
+    const compliantCount = criteria.filter((c) => c.earsCompliant).length;
+    const nonCompliantCount = criteria.filter((c) => !c.earsCompliant).length;
+    const partialCount = 0; // reserved for future partial-match detection
+    return {
+        specId,
+        criteriaCount: criteria.length,
+        overallScore,
+        compliantCount,
+        partialCount,
+        nonCompliantCount,
+        criteria,
+        grade: gradeSpec(overallScore),
+    };
+}
+/**
+ * Lint a single spec by ID — reads spec.md from the planu/specs directory.
+ */
+export async function lintSpec(specId, projectPath) {
+    const specDir = join(projectPath, 'planu', 'specs');
+    const pattern = `${specId}-*/spec.md`;
+    const matches = await glob(pattern, { cwd: specDir, absolute: false });
+    if (matches.length === 0) {
+        // Try exact match without trailing glob
+        const directPath = join(specDir, specId, 'spec.md');
+        if (existsSync(directPath)) {
+            const content = await readFile(directPath, 'utf-8');
+            const extracted = extractCriteria(content);
+            return buildSpecReport(specId, extracted.map(scoreCriterion));
+        }
+        return buildSpecReport(specId, []);
+    }
+    const specPath = join(specDir, matches[0] ?? '');
+    try {
+        const content = await readFile(specPath, 'utf-8');
+        const extracted = extractCriteria(content);
+        return buildSpecReport(specId, extracted.map(scoreCriterion));
+    }
+    catch {
+        // Unreadable — return empty report
+        return buildSpecReport(specId, []);
+    }
+}
+// Lint all specs in the project — reads all planu/specs/SPEC-NNN/spec.md files.
+export async function lintAllSpecs(projectPath) {
+    const specDir = join(projectPath, 'planu', 'specs');
+    const specFiles = await glob('*/spec.md', { cwd: specDir, absolute: false });
+    const specReports = [];
+    for (const relPath of specFiles) {
+        const specDirName = relPath.split('/')[0] ?? '';
+        // Extract SPEC-XXX from directory name like "SPEC-042-some-slug"
+        const specIdMatch = /^(SPEC-\d+)/i.exec(specDirName);
+        const specId = specIdMatch?.[1] ?? specDirName;
+        const fullPath = join(specDir, relPath);
+        let extracted;
+        try {
+            const content = await readFile(fullPath, 'utf-8');
+            extracted = extractCriteria(content);
+        }
+        catch {
+            continue;
+        }
+        if (extracted.length > 0) {
+            const report = buildSpecReport(specId, extracted.map(scoreCriterion));
+            specReports.push(report);
+        }
+    }
+    const totalSpecs = specReports.length;
+    const averageScore = totalSpecs > 0
+        ? Math.round((specReports.reduce((sum, r) => sum + r.overallScore, 0) / totalSpecs) * 10) / 10
+        : 0;
+    // Collect all criteria across specs and find the 10 worst by overallScore
+    const allCriteria = [];
+    for (const report of specReports) {
+        for (const c of report.criteria) {
+            allCriteria.push({ criterion: c.text, specId: report.specId, score: c.overallScore });
+        }
+    }
+    allCriteria.sort((a, b) => a.score - b.score);
+    const topWorstCriteria = allCriteria.slice(0, 10);
+    return {
+        projectPath,
+        totalSpecs,
+        averageScore,
+        topWorstCriteria,
+        specReports,
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=spec-linter.js.map

package/dist/engine/ears/spec-linter.js.map

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

package/dist/engine/health/auto-fixer.d.ts

@@ -0,0 +1,7 @@
+import type { AutoFixResult } from '../../types/health.js';
+/**
+ * Reads health check output and applies deterministic fixes where possible.
+ * When dryRun=true, reports what would be fixed without writing any files.
+ */
+export declare function autoFixHealth(projectPath: string, projectId: string, dryRun?: boolean): Promise<AutoFixResult>;
+//# sourceMappingURL=auto-fixer.d.ts.map

package/dist/engine/health/auto-fixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-fixer.d.ts","sourceRoot":"","sources":["../../../src/engine/health/auto-fixer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAyB,MAAM,uBAAuB,CAAC;AAqHlF;;;GAGG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,UAAQ,GACb,OAAO,CAAC,aAAa,CAAC,CAiCxB"}

package/dist/engine/health/auto-fixer.js

@@ -0,0 +1,130 @@
+// engine/health/auto-fixer.ts — Auto-fix for health check issues (SPEC-408)
+import { mkdir, writeFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+import { specStore } from '../../storage/index.js';
+import { computeSpecHealth } from '../validation-loop.js';
+async function collectHealthIssues(projectPath, projectId) {
+    const specs = await specStore.listSpecs(projectId);
+    const issues = [];
+    const scores = await Promise.all(specs.map(async (spec) => {
+        const score = await computeSpecHealth(projectPath, spec);
+        return { spec, score };
+    }));
+    for (const { spec, score } of scores) {
+        if (score.breakdown.specComplete < 20) {
+            issues.push({
+                type: 'incomplete-spec',
+                specId: spec.id,
+                specPath: spec.specPath,
+                projectPath,
+            });
+        }
+        if (score.breakdown.testsExist < 20) {
+            issues.push({ type: 'no-tests', specId: spec.id, projectPath });
+        }
+        if (score.breakdown.noDrift < 20) {
+            issues.push({ type: 'drift-detected', specId: spec.id, projectPath });
+        }
+    }
+    return issues;
+}
+// ---------------------------------------------------------------------------
+// Fix handlers
+// ---------------------------------------------------------------------------
+async function fixMissingProgress(issue, dryRun) {
+    const specId = issue.specId;
+    const progressPath = join(issue.projectPath, 'planu', 'specs', specId, 'progress.md');
+    try {
+        await access(progressPath);
+        return null; // Already exists
+    }
+    catch {
+        // Does not exist — create it
+        if (!dryRun) {
+            await mkdir(join(issue.projectPath, 'planu', 'specs', specId), { recursive: true });
+            const content = `# ${specId} — Progress\n\nstatus: draft\n\n## Tasks\n\n- [ ] Define acceptance criteria\n`;
+            await writeFile(progressPath, content, 'utf-8');
+        }
+        return {
+            issue: 'missing-progress.md',
+            action: dryRun
+                ? 'would create progress.md from template'
+                : 'created progress.md from template',
+            affectedItem: specId,
+            success: true,
+        };
+    }
+}
+function buildSkipForIncompleteSpec(specId) {
+    return {
+        issue: `incomplete-spec: ${specId}`,
+        reason: 'Missing required spec fields cannot be auto-fixed — human authoring required',
+        manualSteps: [
+            `Open planu/specs/${specId}/spec.md`,
+            'Add title, description, and at least one acceptance criterion',
+            'Re-run health_check_all to verify',
+        ],
+    };
+}
+function buildSkipForNoTests(specId) {
+    return {
+        issue: `no-tests: ${specId}`,
+        reason: 'Test files must be authored by a developer — cannot auto-generate without implementation context',
+        manualSteps: [
+            `Create tests/ file referencing ${specId}`,
+            'Implement at least one test case covering a key acceptance criterion',
+            'Run pnpm test to confirm',
+        ],
+    };
+}
+function buildSkipForDrift(specId) {
+    return {
+        issue: `drift-detected: ${specId}`,
+        reason: 'Drift requires manual reconciliation between spec and implementation',
+        manualSteps: [
+            `Run detect_drift with specId: "${specId}" for a detailed report`,
+            'Review which criteria are no longer implemented',
+            'Either update the spec or fix the code to match',
+        ],
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Reads health check output and applies deterministic fixes where possible.
+ * When dryRun=true, reports what would be fixed without writing any files.
+ */
+export async function autoFixHealth(projectPath, projectId, dryRun = false) {
+    const issues = await collectHealthIssues(projectPath, projectId);
+    const fixes = [];
+    const skipped = [];
+    for (const issue of issues) {
+        switch (issue.type) {
+            case 'missing-progress': {
+                const fix = await fixMissingProgress(issue, dryRun);
+                if (fix) {
+                    fixes.push(fix);
+                }
+                break;
+            }
+            case 'incomplete-spec':
+                skipped.push(buildSkipForIncompleteSpec(issue.specId));
+                break;
+            case 'no-tests':
+                skipped.push(buildSkipForNoTests(issue.specId));
+                break;
+            case 'drift-detected':
+                skipped.push(buildSkipForDrift(issue.specId));
+                break;
+        }
+    }
+    return {
+        fixedCount: fixes.filter((f) => f.success).length,
+        skippedCount: skipped.length,
+        fixes,
+        skipped,
+        executedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=auto-fixer.js.map

package/dist/engine/health/auto-fixer.js.map

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

package/dist/engine/hook-generator/ai-hook-templates.d.ts

@@ -0,0 +1,8 @@
+import type { HookSection } from '../../types/index.js';
+/**
+ * Returns HookSection entries specific to the given AI tool.
+ * Returns an empty array for unknown / unsupported tools — extensible by
+ * adding entries to AI_HOOK_REGISTRY.
+ */
+export declare function getAIHookSections(aiTool: string): HookSection[];
+//# sourceMappingURL=ai-hook-templates.d.ts.map

package/dist/engine/hook-generator/ai-hook-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-hook-templates.d.ts","sourceRoot":"","sources":["../../../src/engine/hook-generator/ai-hook-templates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAyCxD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAG/D"}

package/dist/engine/hook-generator/ai-hook-templates.js

@@ -0,0 +1,43 @@
+// engine/hook-generator/ai-hook-templates.ts — AI-tool-specific hook sections (SPEC-416)
+// ---------------------------------------------------------------------------
+// Claude Code — post-spec-create validation hook comment reminder
+// ---------------------------------------------------------------------------
+const CLAUDE_SECTIONS = [
+    {
+        id: 'claude-validate-on-commit',
+        phase: 'pre-commit',
+        stack: 'claude',
+        content: '# Claude Code: run planu validate before committing spec changes\n' +
+            '# Configure via .claude/settings.json PostToolUse hooks',
+        description: 'Claude Code spec validation reminder',
+    },
+];
+// ---------------------------------------------------------------------------
+// Kiro — hooks YAML reminder
+// ---------------------------------------------------------------------------
+const KIRO_SECTIONS = [
+    {
+        id: 'kiro-spec-sync',
+        phase: 'pre-commit',
+        stack: 'kiro',
+        content: '# Kiro: ensure .kiro/hooks/*.yaml is committed with spec changes',
+        description: 'Kiro hooks YAML sync reminder',
+    },
+];
+// ---------------------------------------------------------------------------
+// Registry
+// ---------------------------------------------------------------------------
+const AI_HOOK_REGISTRY = {
+    claude: CLAUDE_SECTIONS,
+    kiro: KIRO_SECTIONS,
+};
+/**
+ * Returns HookSection entries specific to the given AI tool.
+ * Returns an empty array for unknown / unsupported tools — extensible by
+ * adding entries to AI_HOOK_REGISTRY.
+ */
+export function getAIHookSections(aiTool) {
+    const sections = AI_HOOK_REGISTRY[aiTool];
+    return sections !== undefined ? [...sections] : [];
+}
+//# sourceMappingURL=ai-hook-templates.js.map

package/dist/engine/hook-generator/ai-hook-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-hook-templates.js","sourceRoot":"","sources":["../../../src/engine/hook-generator/ai-hook-templates.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAIzF,8EAA8E;AAC9E,kEAAkE;AAClE,8EAA8E;AAE9E,MAAM,eAAe,GAAkB;IACrC;QACE,EAAE,EAAE,2BAA2B;QAC/B,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,QAAQ;QACf,OAAO,EACL,oEAAoE;YACpE,yDAAyD;QAC3D,WAAW,EAAE,sCAAsC;KACpD;CACF,CAAC;AAEF,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,MAAM,aAAa,GAAkB;IACnC;QACE,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,kEAAkE;QAC3E,WAAW,EAAE,+BAA+B;KAC7C;CACF,CAAC;AAEF,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E,MAAM,gBAAgB,GAAkC;IACtD,MAAM,EAAE,eAAe;IACvB,IAAI,EAAE,aAAa;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC"}

package/dist/engine/hook-generator/hook-merger.d.ts

@@ -0,0 +1,13 @@
+import type { HookSection, MergeResult, HookPreview } from '../../types/index.js';
+/**
+ * Previews what mergeHooks would do WITHOUT writing any files.
+ */
+export declare function previewHooks(projectPath: string, sections: HookSection[]): Promise<HookPreview[]>;
+/**
+ * Merges HookSection entries into the appropriate hook files.
+ * Uses idempotent markers so manual edits outside markers are preserved.
+ *
+ * @param dryRun When true, computes results but does NOT write to disk.
+ */
+export declare function mergeHooks(projectPath: string, sections: HookSection[], dryRun: boolean): Promise<MergeResult[]>;
+//# sourceMappingURL=hook-merger.d.ts.map

package/dist/engine/hook-generator/hook-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-merger.d.ts","sourceRoot":"","sources":["../../../src/engine/hook-generator/hook-merger.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAa,MAAM,sBAAsB,CAAC;AAuG7F;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,WAAW,EAAE,GACtB,OAAO,CAAC,WAAW,EAAE,CAAC,CA+BxB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,WAAW,EAAE,EACvB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,WAAW,EAAE,CAAC,CAkCxB"}

package/dist/engine/hook-generator/hook-merger.js

@@ -0,0 +1,148 @@
+// engine/hook-generator/hook-merger.ts — Idempotent hook file merge engine (SPEC-416)
+import { readFile, writeFile, access, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { markerStart, markerEnd } from './stack-hook-templates.js';
+// ---------------------------------------------------------------------------
+// File path resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolves the path to the hook file for a given phase.
+ * Prefers .husky/ when the directory exists, falls back to .git/hooks/.
+ */
+async function hookFilePath(projectPath, phase) {
+    const huskyDir = join(projectPath, '.husky');
+    try {
+        await access(huskyDir);
+        return join(huskyDir, phase);
+    }
+    catch {
+        return join(projectPath, '.git', 'hooks', phase);
+    }
+}
+// ---------------------------------------------------------------------------
+// File I/O helpers
+// ---------------------------------------------------------------------------
+/** Reads an existing hook file. Returns null if it does not exist. */
+async function readHookFile(filePath) {
+    try {
+        return await readFile(filePath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Returns a minimal shell script header for new hook files. */
+function shellHeader() {
+    return '#!/usr/bin/env sh\n';
+}
+/**
+ * Injects a HookSection into existing hook file content using planu markers.
+ *
+ * - If markers already present with IDENTICAL body → 'skipped'
+ * - If markers present with different body → 'updated' (replaces between markers)
+ * - If no markers → 'added' (appends block at end)
+ */
+function injectSection(content, section) {
+    const start = markerStart(section.id);
+    const end = markerEnd(section.id);
+    const block = [`\n${start}`, `# ${section.description}`, section.content, end].join('\n');
+    const startIdx = content.indexOf(start);
+    const endIdx = content.indexOf(end);
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        // Markers exist — extract current body between them
+        const currentBlock = content.slice(startIdx, endIdx + end.length);
+        if (currentBlock === block.trimStart()) {
+            return { content, action: 'skipped' };
+        }
+        // Replace the existing block
+        const updated = content.slice(0, startIdx) + block.trimStart() + content.slice(endIdx + end.length);
+        return { content: updated, action: 'updated' };
+    }
+    // No markers — append
+    const sep = content.endsWith('\n') ? '' : '\n';
+    return { content: content + sep + block + '\n', action: 'added' };
+}
+// ---------------------------------------------------------------------------
+// Group sections by phase
+// ---------------------------------------------------------------------------
+function groupByPhase(sections) {
+    const map = new Map();
+    for (const section of sections) {
+        const existing = map.get(section.phase) ?? [];
+        existing.push(section);
+        map.set(section.phase, existing);
+    }
+    return map;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Previews what mergeHooks would do WITHOUT writing any files.
+ */
+export async function previewHooks(projectPath, sections) {
+    const grouped = groupByPhase(sections);
+    const previews = [];
+    for (const [phase, phaseSections] of grouped) {
+        const filePath = await hookFilePath(projectPath, phase);
+        const currentContent = await readHookFile(filePath);
+        const conflicts = [];
+        const proposedAdditions = [];
+        for (const section of phaseSections) {
+            const start = markerStart(section.id);
+            if (currentContent?.includes(start) === true) {
+                conflicts.push(section.id);
+            }
+            else {
+                proposedAdditions.push(section);
+            }
+        }
+        previews.push({
+            phase,
+            filePath,
+            currentContent,
+            proposedAdditions,
+            wouldModify: proposedAdditions.length > 0 || conflicts.length > 0,
+            conflicts,
+        });
+    }
+    return previews;
+}
+/**
+ * Merges HookSection entries into the appropriate hook files.
+ * Uses idempotent markers so manual edits outside markers are preserved.
+ *
+ * @param dryRun When true, computes results but does NOT write to disk.
+ */
+export async function mergeHooks(projectPath, sections, dryRun) {
+    const grouped = groupByPhase(sections);
+    const results = [];
+    for (const [phase, phaseSections] of grouped) {
+        const filePath = await hookFilePath(projectPath, phase);
+        const existing = await readHookFile(filePath);
+        let content = existing ?? shellHeader();
+        const sectionsAdded = [];
+        const sectionsUpdated = [];
+        const sectionsSkipped = [];
+        for (const section of phaseSections) {
+            const outcome = injectSection(content, section);
+            content = outcome.content;
+            if (outcome.action === 'added') {
+                sectionsAdded.push(section.id);
+            }
+            else if (outcome.action === 'updated') {
+                sectionsUpdated.push(section.id);
+            }
+            else {
+                sectionsSkipped.push(section.id);
+            }
+        }
+        if (!dryRun && (sectionsAdded.length > 0 || sectionsUpdated.length > 0)) {
+            await mkdir(dirname(filePath), { recursive: true });
+            await writeFile(filePath, content, { encoding: 'utf8', mode: 0o755 });
+        }
+        results.push({ filePath, sectionsAdded, sectionsUpdated, sectionsSkipped, content });
+    }
+    return results;
+}
+//# sourceMappingURL=hook-merger.js.map

package/dist/engine/hook-generator/hook-merger.js.map

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

package/dist/engine/hook-generator/stack-hook-templates.d.ts

@@ -0,0 +1,10 @@
+import type { HookSection } from '../../types/index.js';
+export declare function markerStart(id: string): string;
+export declare function markerEnd(id: string): string;
+export declare const STACK_HOOK_TEMPLATES: Record<string, HookSection[]>;
+/**
+ * Returns all HookSection entries matching the requested stack tokens.
+ * Unknown tokens are silently skipped.
+ */
+export declare function getHookSectionsForStack(stack: string[]): HookSection[];
+//# sourceMappingURL=stack-hook-templates.d.ts.map

package/dist/engine/hook-generator/stack-hook-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-hook-templates.d.ts","sourceRoot":"","sources":["../../../src/engine/hook-generator/stack-hook-templates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMxD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAMD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAyE9D,CAAC;AAMF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAStE"}

package/dist/engine/hook-generator/stack-hook-templates.js

@@ -0,0 +1,105 @@
+// engine/hook-generator/stack-hook-templates.ts — Git hook templates per stack (SPEC-416)
+// ---------------------------------------------------------------------------
+// Marker helpers — used by hook-merger for idempotent injection
+// ---------------------------------------------------------------------------
+export function markerStart(id) {
+    return `# <!-- planu:generated:${id} -->`;
+}
+export function markerEnd(id) {
+    return `# <!-- /planu:generated:${id} -->`;
+}
+// ---------------------------------------------------------------------------
+// Templates
+// ---------------------------------------------------------------------------
+export const STACK_HOOK_TEMPLATES = {
+    typescript: [
+        {
+            id: 'typescript-typecheck',
+            phase: 'pre-commit',
+            stack: 'typescript',
+            content: 'pnpm typecheck || exit 1',
+            description: 'TypeScript type checking',
+        },
+    ],
+    eslint: [
+        {
+            id: 'eslint-fix',
+            phase: 'pre-commit',
+            stack: 'eslint',
+            content: 'pnpm lint --fix || exit 1',
+            description: 'ESLint auto-fix',
+        },
+    ],
+    prettier: [
+        {
+            id: 'prettier-format',
+            phase: 'pre-commit',
+            stack: 'prettier',
+            content: 'pnpm format || exit 1',
+            description: 'Prettier formatting',
+        },
+    ],
+    vitest: [
+        {
+            id: 'vitest-coverage',
+            phase: 'pre-push',
+            stack: 'vitest',
+            content: 'pnpm test:coverage || exit 1',
+            description: 'Vitest coverage threshold check',
+        },
+    ],
+    jest: [
+        {
+            id: 'jest-coverage',
+            phase: 'pre-push',
+            stack: 'jest',
+            content: 'pnpm test --coverage || exit 1',
+            description: 'Jest coverage check',
+        },
+    ],
+    python: [
+        {
+            id: 'python-ruff',
+            phase: 'pre-commit',
+            stack: 'python',
+            content: 'ruff check --fix . || exit 1',
+            description: 'Python ruff linting',
+        },
+    ],
+    go: [
+        {
+            id: 'go-vet',
+            phase: 'pre-commit',
+            stack: 'go',
+            content: 'go vet ./... || exit 1',
+            description: 'Go vet check',
+        },
+    ],
+    commitlint: [
+        {
+            id: 'commitlint',
+            phase: 'commit-msg',
+            stack: 'commitlint',
+            content: 'npx --no -- commitlint --edit "$1" || exit 1',
+            description: 'Conventional commits validation',
+        },
+    ],
+};
+// ---------------------------------------------------------------------------
+// Public helper
+// ---------------------------------------------------------------------------
+/**
+ * Returns all HookSection entries matching the requested stack tokens.
+ * Unknown tokens are silently skipped.
+ */
+export function getHookSectionsForStack(stack) {
+    const sections = [];
+    for (const token of stack) {
+        const templates = STACK_HOOK_TEMPLATES[token];
+        if (templates !== undefined) {
+            sections.push(...templates);
+        }
+    }
+    return sections;
+}
+//# sourceMappingURL=stack-hook-templates.js.map

package/dist/engine/hook-generator/stack-hook-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-hook-templates.js","sourceRoot":"","sources":["../../../src/engine/hook-generator/stack-hook-templates.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAI1F,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,0BAA0B,EAAE,MAAM,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,2BAA2B,EAAE,MAAM,CAAC;AAC7C,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAkC;IACjE,UAAU,EAAE;QACV;YACE,EAAE,EAAE,sBAAsB;YAC1B,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,0BAA0B;YACnC,WAAW,EAAE,0BAA0B;SACxC;KACF;IACD,MAAM,EAAE;QACN;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,2BAA2B;YACpC,WAAW,EAAE,iBAAiB;SAC/B;KACF;IACD,QAAQ,EAAE;QACR;YACE,EAAE,EAAE,iBAAiB;YACrB,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,uBAAuB;YAChC,WAAW,EAAE,qBAAqB;SACnC;KACF;IACD,MAAM,EAAE;QACN;YACE,EAAE,EAAE,iBAAiB;YACrB,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,8BAA8B;YACvC,WAAW,EAAE,iCAAiC;SAC/C;KACF;IACD,IAAI,EAAE;QACJ;YACE,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,gCAAgC;YACzC,WAAW,EAAE,qBAAqB;SACnC;KACF;IACD,MAAM,EAAE;QACN;YACE,EAAE,EAAE,aAAa;YACjB,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,8BAA8B;YACvC,WAAW,EAAE,qBAAqB;SACnC;KACF;IACD,EAAE,EAAE;QACF;YACE,EAAE,EAAE,QAAQ;YACZ,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,wBAAwB;YACjC,WAAW,EAAE,cAAc;SAC5B;KACF;IACD,UAAU,EAAE;QACV;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,8CAA8C;YACvD,WAAW,EAAE,iCAAiC;SAC/C;KACF;CACF,CAAC;AAEF,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAe;IACrD,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}