@planu/cli 0.90.2 → 0.92.0

package/dist/engine/facilitate/plan-parser.js

@@ -0,0 +1,115 @@
+// engine/facilitate/plan-parser.ts — SPEC-264 Plan Mode markdown parser
+// ---------------------------------------------------------------------------
+// Section extraction
+// ---------------------------------------------------------------------------
+const SECTION_HEADERS = /^#{1,3}\s+(.+)$/m;
+const PLAN_SECTION_RE = /^#{1,3}\s+(?:plan|approach|steps|implementation|solution)\s*$/im;
+const TITLE_RE = /^#\s+(.+)$/m;
+const CHECKBOX_RE = /^[-*]\s+\[[ x]\]\s+(.+)$/gim;
+const ARCHITECTURAL_TERMS = /\b(?:migrate|migration|replace|redesign|overhaul|rewrite|refactor architecture)\b/i;
+const COMPLEXITY_TERMS = /\b(?:service|worker|queue|cache|database|api|integration)\b/gi;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function extractTitle(markdown) {
+    const match = TITLE_RE.exec(markdown);
+    if (match?.[1]) {
+        return match[1].trim();
+    }
+    // Fallback: use first non-empty line
+    const firstLine = markdown.split('\n').find((l) => l.trim().length > 0);
+    return firstLine?.replace(/^#+\s*/, '').trim() ?? 'Untitled Plan';
+}
+function extractCheckboxes(markdown) {
+    const results = [];
+    let m;
+    const re = new RegExp(CHECKBOX_RE.source, CHECKBOX_RE.flags);
+    while ((m = re.exec(markdown)) !== null) {
+        if (m[1]) {
+            results.push(m[1].trim());
+        }
+    }
+    return results;
+}
+function extractBullets(section) {
+    const lines = section.split('\n');
+    return lines
+        .filter((l) => /^[-*]\s+(?!\[)/.test(l.trim()))
+        .map((l) => l.replace(/^[-*]\s+/, '').trim())
+        .filter((l) => l.length > 0);
+}
+function extractTechnicalNotes(markdown) {
+    const notes = [];
+    // Extract content from code blocks (language tag as note)
+    const blockRe = /```(\w+)/g;
+    let m;
+    while ((m = blockRe.exec(markdown)) !== null) {
+        if (m[1]) {
+            notes.push(`Code block: ${m[1]}`);
+        }
+    }
+    // Extract lines with technical hints (file paths, imports, type refs)
+    const techLineRe = /^[-*]\s+.{10,}(?:\.ts|\.js|import|export|interface|type |class )/gim;
+    let tm;
+    while ((tm = techLineRe.exec(markdown)) !== null) {
+        const note = tm[0].replace(/^[-*]\s+/, '').trim();
+        if (!notes.includes(note)) {
+            notes.push(note);
+        }
+    }
+    return notes.slice(0, 10);
+}
+function estimateComplexity(markdown, acCount) {
+    if (ARCHITECTURAL_TERMS.test(markdown)) {
+        return 'architectural';
+    }
+    // Create a fresh regex each call to avoid stateful `g` flag issues
+    const complexTerms = (markdown.match(new RegExp(COMPLEXITY_TERMS.source, 'gi')) ?? []).length;
+    if (acCount >= 5 || complexTerms >= 3) {
+        return 'feature';
+    }
+    if (acCount >= 2 || complexTerms >= 1) {
+        return 'simple';
+    }
+    return 'trivial';
+}
+function extractPlanSection(markdown) {
+    const match = PLAN_SECTION_RE.exec(markdown);
+    if (!match) {
+        return markdown;
+    }
+    const start = match.index + match[0].length;
+    // Find next section header at same or higher level
+    const remaining = markdown.slice(start);
+    const nextHeader = SECTION_HEADERS.exec(remaining);
+    return nextHeader ? remaining.slice(0, nextHeader.index) : remaining;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Extract structured spec data from Plan Mode markdown output.
+ * Returns null when the input is empty or not parseable as a plan.
+ */
+export function parsePlanContent(planMarkdown) {
+    if (!planMarkdown || planMarkdown.trim().length < 10) {
+        return null;
+    }
+    const title = extractTitle(planMarkdown);
+    // First try checkbox-style ACs
+    let acceptanceCriteria = extractCheckboxes(planMarkdown);
+    // Fallback: look for bullet lists inside plan/approach sections
+    if (acceptanceCriteria.length === 0) {
+        const section = extractPlanSection(planMarkdown);
+        acceptanceCriteria = extractBullets(section);
+    }
+    const technicalNotes = extractTechnicalNotes(planMarkdown);
+    const estimatedComplexity = estimateComplexity(planMarkdown, acceptanceCriteria.length);
+    return {
+        title,
+        acceptanceCriteria,
+        technicalNotes,
+        estimatedComplexity,
+    };
+}
+//# sourceMappingURL=plan-parser.js.map

package/dist/engine/facilitate/plan-parser.js.map

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

package/dist/engine/facilitate/router.d.ts

@@ -0,0 +1,6 @@
+import type { ClassifiedIntent, LoadedFacilitateContext, RouteDecision } from '../../types/index.js';
+/**
+ * Decide the best next action given classified intent and loaded context.
+ */
+export declare function route(intent: ClassifiedIntent, context: LoadedFacilitateContext, request: string): RouteDecision;
+//# sourceMappingURL=router.d.ts.map

package/dist/engine/facilitate/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/engine/facilitate/router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,EACd,MAAM,sBAAsB,CAAC;AAiC9B;;GAEG;AACH,wBAAgB,KAAK,CACnB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,MAAM,GACd,aAAa,CA8Cf"}

package/dist/engine/facilitate/router.js

@@ -0,0 +1,71 @@
+// engine/facilitate/router.ts — SPEC-264 Routing logic for facilitate orchestrator
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function findRelatedActiveSpec(context, keywords) {
+    const lowerKeywords = keywords.map((k) => k.toLowerCase());
+    for (const spec of context.activeSpecs) {
+        const titleLower = spec.title.toLowerCase();
+        if (lowerKeywords.some((kw) => titleLower.includes(kw))) {
+            return spec.id;
+        }
+    }
+    // No keyword match — return first active spec if only one
+    if (context.activeSpecs.length === 1 && context.activeSpecs[0]) {
+        return context.activeSpecs[0].id;
+    }
+    return null;
+}
+function buildSpecDescription(request, intent) {
+    const typePrefix = intent.type === 'bugfix' ? 'Fix: ' : '';
+    return `${typePrefix}${request}`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Decide the best next action given classified intent and loaded context.
+ */
+export function route(intent, context, request) {
+    // 1. Resume active work when there's a related spec in-progress
+    if (context.hasActiveWork) {
+        const relatedId = findRelatedActiveSpec(context, intent.keywords);
+        if (relatedId) {
+            const spec = context.activeSpecs.find((s) => s.id === relatedId);
+            return {
+                action: 'resume',
+                specId: relatedId,
+                reason: `Spec ${relatedId} "${spec?.title ?? ''}" is in progress and matches your request`,
+            };
+        }
+    }
+    // 2. Trivial requests → answer directly without creating a spec
+    if (intent.complexity === 'trivial') {
+        return {
+            action: 'direct',
+            reason: 'Request is trivial — no spec needed, handle inline',
+        };
+    }
+    // 3. Exploration and questions → direct answer
+    if (intent.type === 'exploration' || intent.type === 'question') {
+        return {
+            action: 'direct',
+            reason: 'Informational request — answer directly',
+        };
+    }
+    // 4. Ambiguous architectural requests → ask for clarification
+    if (intent.complexity === 'architectural' && intent.confidence < 0.7) {
+        return {
+            action: 'clarify',
+            question: 'This looks like a significant architectural change. ' +
+                'Could you describe the current pain point and the desired end state?',
+        };
+    }
+    // 5. Default → create a spec
+    return {
+        action: 'create-spec',
+        description: buildSpecDescription(request, intent),
+        type: intent.type,
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/engine/facilitate/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/engine/facilitate/router.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAQnF,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,qBAAqB,CAC5B,OAAgC,EAChC,QAAkB;IAElB,MAAM,aAAa,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3D,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACxD,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IACD,0DAA0D;IAC1D,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe,EAAE,MAAwB;IACrE,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,OAAO,GAAG,UAAU,GAAG,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,KAAK,CACnB,MAAwB,EACxB,OAAgC,EAChC,OAAe;IAEf,gEAAgE;IAChE,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClE,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;YACjE,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,QAAQ,SAAS,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,2CAA2C;aAC3F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,oDAAoD;SAC7D,CAAC;IACJ,CAAC;IAED,+CAA+C;IAC/C,IAAI,MAAM,CAAC,IAAI,KAAK,aAAa,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAChE,OAAO;YACL,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,yCAAyC;SAClD,CAAC;IACJ,CAAC;IAED,8DAA8D;IAC9D,IAAI,MAAM,CAAC,UAAU,KAAK,eAAe,IAAI,MAAM,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;QACrE,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,QAAQ,EACN,sDAAsD;gBACtD,sEAAsE;SACzE,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,WAAW,EAAE,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC;QAClD,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;AACJ,CAAC"}

package/dist/engine/hooks/context-injector.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Reads project specs and decisions from data/ and writes
+ * .planu/plan-context.md in the project root.
+ */
+export declare function injectPlanContext(projectPath: string, taskDescription: string | null): Promise<void>;
+/**
+ * Builds the markdown content for .planu/plan-context.md.
+ * Pure function for testability — does not write to disk.
+ */
+export declare function buildContextMarkdown(projectPath: string, taskDescription: string | null): Promise<string>;
+//# sourceMappingURL=context-injector.d.ts.map

package/dist/engine/hooks/context-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-injector.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/context-injector.ts"],"names":[],"mappings":"AAuFA;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GAAG,IAAI,GAC7B,OAAO,CAAC,MAAM,CAAC,CAyCjB"}

package/dist/engine/hooks/context-injector.js

@@ -0,0 +1,163 @@
+// engine/hooks/context-injector.ts — Reads project data and writes .planu/plan-context.md (SPEC-262)
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const ACTIVE_STATUSES = ['implementing', 'approved'];
+const MAX_RELATED_SPECS = 3;
+const MAX_RECENT_DECISIONS = 5;
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function hashProjectPath(projectPath) {
+    return createHash('sha256').update(projectPath).digest('hex').slice(0, 16);
+}
+/** Safely extract a string from an unknown value — returns '' when not a string */
+function str(val) {
+    return typeof val === 'string' ? val : '';
+}
+async function loadSpecs(projectPath) {
+    const projectId = hashProjectPath(projectPath);
+    const specsFile = join(projectPath, 'data', 'projects', projectId, 'specs.json');
+    try {
+        const raw = await readFile(specsFile, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return [];
+    }
+}
+async function loadDecisions(projectPath) {
+    const projectId = hashProjectPath(projectPath);
+    const decisionsFile = join(projectPath, 'data', 'projects', projectId, 'decisions.json');
+    try {
+        const raw = await readFile(decisionsFile, 'utf-8');
+        const data = JSON.parse(raw);
+        return data.decisions ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Scores a spec's relevance to the task description.
+ * Returns a score >= 0; higher is more relevant.
+ */
+function relevanceScore(spec, taskDescription) {
+    if (!taskDescription.trim()) {
+        return 0;
+    }
+    const specText = [str(spec.id), str(spec.title)].join(' ').toLowerCase();
+    const words = taskDescription
+        .toLowerCase()
+        .split(/\W+/)
+        .filter((w) => w.length > 2);
+    return words.reduce((score, word) => {
+        return specText.includes(word) ? score + 1 : score;
+    }, 0);
+}
+function formatDecisionSummary(d) {
+    const title = str(d.title);
+    const detail = str(d.summary) || str(d.rationale);
+    return [title, detail].filter(Boolean).join(': ');
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Reads project specs and decisions from data/ and writes
+ * .planu/plan-context.md in the project root.
+ */
+export async function injectPlanContext(projectPath, taskDescription) {
+    const md = await buildContextMarkdown(projectPath, taskDescription);
+    const planuDir = join(projectPath, '.planu');
+    await mkdir(planuDir, { recursive: true });
+    await writeFile(join(planuDir, 'plan-context.md'), md, 'utf-8');
+}
+/**
+ * Builds the markdown content for .planu/plan-context.md.
+ * Pure function for testability — does not write to disk.
+ */
+export async function buildContextMarkdown(projectPath, taskDescription) {
+    const [allSpecs, allDecisions] = await Promise.all([
+        loadSpecs(projectPath),
+        loadDecisions(projectPath),
+    ]);
+    // Active specs: implementing or approved
+    const activeSpecs = allSpecs
+        .filter((s) => ACTIVE_STATUSES.includes(str(s.status)))
+        .map((s) => ({ id: str(s.id), title: str(s.title), status: str(s.status) }));
+    // Related specs: non-active specs scored by keyword match
+    const desc = taskDescription ?? '';
+    const relatedSpecs = allSpecs
+        .filter((s) => !ACTIVE_STATUSES.includes(str(s.status)))
+        .map((s) => ({ spec: s, score: relevanceScore(s, desc) }))
+        .filter(({ score }) => score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, MAX_RELATED_SPECS)
+        .map(({ spec, score }) => ({
+        id: str(spec.id),
+        title: str(spec.title),
+        status: str(spec.status),
+        relevanceReason: `keyword match (score: ${score})`,
+    }));
+    // Recent decisions
+    const recentDecisions = allDecisions
+        .slice(-MAX_RECENT_DECISIONS)
+        .reverse()
+        .map(formatDecisionSummary)
+        .filter(Boolean);
+    const context = {
+        activeSpecs,
+        relatedSpecs,
+        recentDecisions,
+        generatedAt: new Date().toISOString(),
+    };
+    return renderMarkdown(context, taskDescription);
+}
+function renderMarkdown(ctx, taskDescription) {
+    const lines = [
+        '# Planu Context — Plan Mode',
+        '> Auto-generated by Planu. Claude: read this before exploring.',
+        '',
+    ];
+    if (taskDescription) {
+        lines.push('## Task', taskDescription, '');
+    }
+    lines.push('## Active Specs');
+    if (ctx.activeSpecs.length === 0) {
+        lines.push('_No specs currently implementing or approved._');
+    }
+    else {
+        for (const s of ctx.activeSpecs) {
+            lines.push(`- ${s.id}: ${s.title} (${s.status})`);
+        }
+    }
+    lines.push('');
+    lines.push('## Related Specs (semantic match)');
+    if (ctx.relatedSpecs.length === 0) {
+        lines.push('_No related specs found._');
+    }
+    else {
+        for (const s of ctx.relatedSpecs) {
+            const reason = s.relevanceReason ? ` — ${s.relevanceReason}` : '';
+            lines.push(`- ${s.id}: ${s.title}${reason}`);
+        }
+    }
+    lines.push('');
+    lines.push('## Recent Decisions');
+    if (ctx.recentDecisions.length === 0) {
+        lines.push('_No recent decisions recorded._');
+    }
+    else {
+        for (const d of ctx.recentDecisions) {
+            lines.push(`- ${d}`);
+        }
+    }
+    lines.push('');
+    lines.push('## Suggested next step', 'After exploring, call `facilitate` with your findings to create a spec.', '', `> Generated at: ${ctx.generatedAt}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=context-injector.js.map

package/dist/engine/hooks/context-injector.js.map

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

package/dist/engine/hooks/custom-commands-generator.d.ts

@@ -0,0 +1,11 @@
+import type { CustomCommand } from '../../types/hooks-advanced.js';
+/**
+ * Returns the four standard Planu slash commands for .claude/commands/.
+ */
+export declare function generateCustomCommands(projectPath: string): CustomCommand[];
+/**
+ * Writes command markdown files to <projectPath>/.claude/commands/.
+ * Creates the directory if it does not exist. Idempotent.
+ */
+export declare function writeCustomCommands(projectPath: string): void;
+//# sourceMappingURL=custom-commands-generator.d.ts.map

package/dist/engine/hooks/custom-commands-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-commands-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/custom-commands-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAoEnE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CAO3E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAS7D"}

package/dist/engine/hooks/custom-commands-generator.js

@@ -0,0 +1,88 @@
+// engine/hooks/custom-commands-generator.ts — .claude/commands/ generator (SPEC-265)
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Command content builders
+// ---------------------------------------------------------------------------
+function buildSpecCommand(projectPath) {
+    return {
+        name: 'spec',
+        description: 'Create a Planu spec for the described feature',
+        content: `---
+description: Create a Planu spec for the described feature
+---
+Use the mcp__planu__create_spec tool with projectPath: ${projectPath}
+and the user's description as the description parameter.
+Always wait for user approval before implementing.
+`,
+    };
+}
+function buildValidateCommand() {
+    return {
+        name: 'validate',
+        description: 'Validate the active Planu spec',
+        content: `---
+description: Validate the active Planu spec
+---
+Use the mcp__planu__validate tool with the current project path.
+Report any compliance gaps found.
+`,
+    };
+}
+function buildStatusCommand() {
+    return {
+        name: 'status',
+        description: 'Show Planu project status snapshot',
+        content: `---
+description: Show Planu project status snapshot
+---
+Use the mcp__planu__planu_status tool with the current project path.
+Show the active spec, git state, and pending queue in a concise summary.
+`,
+    };
+}
+function buildPlanuCommand() {
+    return {
+        name: 'planu',
+        description: 'Quick reference for the Planu SDD workflow',
+        content: `---
+description: Quick reference for the Planu SDD workflow
+---
+Explain the Spec Driven Development workflow:
+1. /spec <description> — create a spec and get approval
+2. Implement only after approval
+3. /validate — check implementation against spec
+4. /status — see what is active and pending
+
+Always use mcp__planu__* tools. Never write code without an approved spec.
+`,
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Returns the four standard Planu slash commands for .claude/commands/.
+ */
+export function generateCustomCommands(projectPath) {
+    return [
+        buildSpecCommand(projectPath),
+        buildValidateCommand(),
+        buildStatusCommand(),
+        buildPlanuCommand(),
+    ];
+}
+/**
+ * Writes command markdown files to <projectPath>/.claude/commands/.
+ * Creates the directory if it does not exist. Idempotent.
+ */
+export function writeCustomCommands(projectPath) {
+    const commandsDir = join(projectPath, '.claude', 'commands');
+    mkdirSync(commandsDir, { recursive: true });
+    const commands = generateCustomCommands(projectPath);
+    for (const cmd of commands) {
+        const filePath = join(commandsDir, `${cmd.name}.md`);
+        writeFileSync(filePath, cmd.content, 'utf8');
+    }
+}
+//# sourceMappingURL=custom-commands-generator.js.map

package/dist/engine/hooks/custom-commands-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-commands-generator.js","sourceRoot":"","sources":["../../../src/engine/hooks/custom-commands-generator.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,+CAA+C;QAC5D,OAAO,EAAE;;;yDAG4C,WAAW;;;CAGnE;KACE,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE;;;;;CAKZ;KACE,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,oCAAoC;QACjD,OAAO,EAAE;;;;;CAKZ;KACE,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE;;;;;;;;;;CAUZ;KACE,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO;QACL,gBAAgB,CAAC,WAAW,CAAC;QAC7B,oBAAoB,EAAE;QACtB,kBAAkB,EAAE;QACpB,iBAAiB,EAAE;KACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC7D,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACrD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC;QACrD,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/engine/hooks/effort-configurator.d.ts

@@ -0,0 +1,13 @@
+import type { EffortLevel, EffortRule } from '../../types/hooks-advanced.js';
+export declare const DEFAULT_EFFORT_RULES: EffortRule[];
+/**
+ * Returns the effort level for a given tool name by matching against rules.
+ * Uses the first matching rule. Falls back to 'medium' if no rule matches.
+ */
+export declare function getEffortForTool(toolName: string, rules?: EffortRule[]): EffortLevel;
+/**
+ * Builds a Record<toolNamePattern, EffortLevel> suitable for Claude Code settings.json.
+ * Keys are the raw pattern strings from the rules.
+ */
+export declare function buildEffortConfig(rules?: EffortRule[]): Record<string, EffortLevel>;
+//# sourceMappingURL=effort-configurator.d.ts.map

package/dist/engine/hooks/effort-configurator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effort-configurator.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/effort-configurator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAM7E,eAAO,MAAM,oBAAoB,EAAE,UAAU,EAqB5C,CAAC;AAMF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,UAAU,EAAyB,GACzC,WAAW,CAQb;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,GAAE,UAAU,EAAyB,GACzC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAM7B"}

package/dist/engine/hooks/effort-configurator.js

@@ -0,0 +1,54 @@
+// engine/hooks/effort-configurator.ts — Effort level configuration for Claude Code tools (SPEC-265)
+// ---------------------------------------------------------------------------
+// Default rules
+// ---------------------------------------------------------------------------
+export const DEFAULT_EFFORT_RULES = [
+    {
+        pattern: 'list_specs|usage_stats|license_status',
+        effort: 'low',
+        reason: 'read-only queries',
+    },
+    {
+        pattern: 'create_spec|update_status|validate',
+        effort: 'medium',
+        reason: 'standard operations',
+    },
+    {
+        pattern: 'challenge_spec|red_team|check_readiness',
+        effort: 'high',
+        reason: 'analysis tasks',
+    },
+    {
+        pattern: 'init_project|init_constitution|config_health',
+        effort: 'max',
+        reason: 'architectural decisions',
+    },
+];
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Returns the effort level for a given tool name by matching against rules.
+ * Uses the first matching rule. Falls back to 'medium' if no rule matches.
+ */
+export function getEffortForTool(toolName, rules = DEFAULT_EFFORT_RULES) {
+    for (const rule of rules) {
+        const regex = new RegExp(rule.pattern);
+        if (regex.test(toolName)) {
+            return rule.effort;
+        }
+    }
+    return 'medium';
+}
+/**
+ * Builds a Record<toolNamePattern, EffortLevel> suitable for Claude Code settings.json.
+ * Keys are the raw pattern strings from the rules.
+ */
+export function buildEffortConfig(rules = DEFAULT_EFFORT_RULES) {
+    const config = {};
+    for (const rule of rules) {
+        config[rule.pattern] = rule.effort;
+    }
+    return config;
+}
+//# sourceMappingURL=effort-configurator.js.map

package/dist/engine/hooks/effort-configurator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effort-configurator.js","sourceRoot":"","sources":["../../../src/engine/hooks/effort-configurator.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAIpG,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAiB;IAChD;QACE,OAAO,EAAE,uCAAuC;QAChD,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,mBAAmB;KAC5B;IACD;QACE,OAAO,EAAE,oCAAoC;QAC7C,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,qBAAqB;KAC9B;IACD;QACE,OAAO,EAAE,yCAAyC;QAClD,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,gBAAgB;KACzB;IACD;QACE,OAAO,EAAE,8CAA8C;QACvD,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,yBAAyB;KAClC;CACF,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,QAAsB,oBAAoB;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAsB,oBAAoB;IAE1C,MAAM,MAAM,GAAgC,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/engine/hooks/full-spectrum-generator.d.ts

@@ -0,0 +1,31 @@
+import type { FullSpectrumHookConfig, HookScript } from '../../types/hooks-advanced.js';
+/**
+ * Generates the Stop hook script — auto-commits planu/ on session end.
+ */
+export declare function generateStopHookScript(projectPath: string): string;
+/**
+ * Generates the PreCompact hook script — queues a session_checkpoint action.
+ */
+export declare function generatePreCompactHookScript(): string;
+/**
+ * Generates the UserPromptSubmit hook script — injects active spec context.
+ */
+export declare function generateUserPromptSubmitHookScript(): string;
+/**
+ * Generates the Notification hook script — shown when Claude is idle.
+ */
+export declare function generateNotificationHookScript(): string;
+/**
+ * Generates WorktreeCreate and WorktreeRemove hook scripts.
+ */
+export declare function generateWorktreeHookScripts(): {
+    create: string;
+    remove: string;
+};
+/**
+ * Generates all requested hook scripts based on the supplied config.
+ * Returns an array of HookScript objects, one per enabled hook type.
+ * The projectPath is used only for the Stop hook script.
+ */
+export declare function generateFullSpectrumHooks(config: FullSpectrumHookConfig, projectPath?: string): HookScript[];
+//# sourceMappingURL=full-spectrum-generator.d.ts.map

package/dist/engine/hooks/full-spectrum-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-spectrum-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/full-spectrum-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAMxF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAKrD;AAED;;GAEG;AACH,wBAAgB,kCAAkC,IAAI,MAAM,CAS3D;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAMvD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAYhF;AAMD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,sBAAsB,EAC9B,WAAW,SAAyB,GACnC,UAAU,EAAE,CAkDd"}