@planu/cli 0.90.1 → 0.91.0

package/dist/engine/facilitate/context-loader.js

@@ -0,0 +1,156 @@
+// engine/facilitate/context-loader.ts — SPEC-264 Loads project context from disk
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+const ACTIVE_STATUSES = new Set(['implementing', 'approved', 'review']);
+/**
+ * Minimal frontmatter parser — reads YAML between `---` delimiters.
+ * Supports string scalar fields only (sufficient for our use case).
+ */
+function parseFrontmatter(content) {
+    const match = /^---\n([\s\S]*?)\n---/m.exec(content);
+    if (!match?.[1]) {
+        return {};
+    }
+    const result = {};
+    for (const line of match[1].split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1) {
+            continue;
+        }
+        const key = line.slice(0, colonIdx).trim();
+        const value = line
+            .slice(colonIdx + 1)
+            .trim()
+            .replace(/^["']|["']$/g, '');
+        if (key === 'id') {
+            result.id = value;
+        }
+        else if (key === 'title') {
+            result.title = value;
+        }
+        else if (key === 'status') {
+            result.status = value;
+        }
+    }
+    return result;
+}
+/**
+ * Compute project hash the same way base-store does (SHA-256, first 16 chars).
+ */
+function hashProjectPath(projectPath) {
+    return createHash('sha256').update(projectPath).digest('hex').slice(0, 16);
+}
+/**
+ * Check if two sets of keywords overlap (case-insensitive).
+ */
+function hasKeywordOverlap(title, keywords) {
+    const lower = title.toLowerCase();
+    return keywords.some((kw) => lower.includes(kw));
+}
+function toSpecRecord(s) {
+    if (typeof s.id === 'string' && typeof s.title === 'string' && typeof s.status === 'string') {
+        return { id: s.id, title: s.title, status: s.status };
+    }
+    return null;
+}
+async function loadSpecsFromFile(specsFile) {
+    try {
+        const raw = await readFile(specsFile, 'utf-8');
+        const all = JSON.parse(raw);
+        return all.flatMap((s) => {
+            const rec = toSpecRecord(s);
+            return rec ? [rec] : [];
+        });
+    }
+    catch {
+        return [];
+    }
+}
+async function loadCheckpoint(checkpointFile) {
+    try {
+        const raw = await readFile(checkpointFile, 'utf-8');
+        const state = JSON.parse(raw);
+        return typeof state.lastCheckpoint === 'string' ? state.lastCheckpoint : null;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Load spec context directly from disk — no MCP tool calls.
+ * Gracefully handles empty/missing project directories.
+ */
+export async function loadContext(projectPath, keywords) {
+    const projectId = hashProjectPath(projectPath);
+    const specsFile = join('data', 'projects', projectId, 'specs.json');
+    const checkpointFile = join('data', 'projects', projectId, 'session-state.json');
+    const specs = await loadSpecsFromFile(specsFile);
+    const lastCheckpoint = await loadCheckpoint(checkpointFile);
+    const activeSpecs = specs.filter((s) => ACTIVE_STATUSES.has(s.status));
+    const relatedSpecs = specs
+        .filter((s) => !ACTIVE_STATUSES.has(s.status) && hasKeywordOverlap(s.title, keywords))
+        .slice(0, 5)
+        .map((s) => ({
+        id: s.id,
+        title: s.title,
+        relevanceReason: 'Title matches keyword from request',
+    }));
+    return {
+        activeSpecs,
+        relatedSpecs,
+        hasActiveWork: activeSpecs.length > 0,
+        lastCheckpoint,
+    };
+}
+/**
+ * Load context from a planu/ specs directory (alternative path — reads spec.md frontmatter).
+ * Used when data/ is not available but planu/ is present.
+ */
+export async function loadContextFromPlanuDir(planuSpecsDir, keywords) {
+    let entries;
+    try {
+        entries = await readdir(planuSpecsDir);
+    }
+    catch {
+        return { activeSpecs: [], relatedSpecs: [], hasActiveWork: false, lastCheckpoint: null };
+    }
+    const activeSpecs = [];
+    const relatedSpecs = [];
+    for (const entry of entries) {
+        const specMdPath = join(planuSpecsDir, entry, 'spec.md');
+        try {
+            const content = await readFile(specMdPath, 'utf-8');
+            const fm = parseFrontmatter(content);
+            if (!fm.id || !fm.title || !fm.status) {
+                continue;
+            }
+            if (ACTIVE_STATUSES.has(fm.status)) {
+                activeSpecs.push({ id: fm.id, title: fm.title, status: fm.status });
+            }
+            else if (hasKeywordOverlap(fm.title, keywords) && relatedSpecs.length < 5) {
+                relatedSpecs.push({
+                    id: fm.id,
+                    title: fm.title,
+                    relevanceReason: 'Title matches keyword from request',
+                });
+            }
+        }
+        catch {
+            // Skip unreadable spec
+        }
+    }
+    return {
+        activeSpecs,
+        relatedSpecs,
+        hasActiveWork: activeSpecs.length > 0,
+        lastCheckpoint: null,
+    };
+}
+//# sourceMappingURL=context-loader.js.map

package/dist/engine/facilitate/context-loader.js.map

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

package/dist/engine/facilitate/intent-classifier.d.ts

@@ -0,0 +1,6 @@
+import type { ClassifiedIntent } from '../../types/index.js';
+/**
+ * Classify a natural-language request into type, complexity, and keywords.
+ */
+export declare function classifyIntent(request: string): ClassifiedIntent;
+//# sourceMappingURL=intent-classifier.d.ts.map

package/dist/engine/facilitate/intent-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-classifier.d.ts","sourceRoot":"","sources":["../../../src/engine/facilitate/intent-classifier.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAA0B,MAAM,sBAAsB,CAAC;AAuJrF;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAahE"}

package/dist/engine/facilitate/intent-classifier.js

@@ -0,0 +1,153 @@
+// engine/facilitate/intent-classifier.ts — SPEC-264 Request intent classifier
+// ---------------------------------------------------------------------------
+// Keyword patterns
+// ---------------------------------------------------------------------------
+const BUGFIX_RE = /\b(?:fix|bug|error|broken|crash|issue|fail|failing|exception|traceback)\b/i;
+// Note: "what is" removed — handled by short-question path instead
+const EXPLORATION_RE = /\b(?:explore|understand|how does|explain|learn|why does)\b/i;
+const REFACTOR_RE = /\b(?:refactor|clean up|reorganize|restructure|simplify|rename|move)\b/i;
+const ARCHITECTURAL_TERMS_RE = /\b(?:migrate|migration|replace|redesign|overhaul|rewrite|platform|framework)\b/i;
+const COMPLEXITY_TERMS_PATTERN = '\\b(?:service|worker|queue|cache|database|schema|api|endpoints?|integration|auth|payment)\\b';
+const TRIVIAL_THRESHOLD_WORDS = 15;
+// Minute estimates per complexity
+const MINUTES = {
+    trivial: 5,
+    simple: 30,
+    feature: 120,
+    architectural: 480,
+};
+// ---------------------------------------------------------------------------
+// Classification helpers
+// ---------------------------------------------------------------------------
+function classifyType(request) {
+    if (BUGFIX_RE.test(request)) {
+        return 'bugfix';
+    }
+    // Exploration takes priority when explicit exploration keywords present
+    if (EXPLORATION_RE.test(request)) {
+        return 'exploration';
+    }
+    // Short question without exploration keywords → question
+    const wordCount = request.trim().split(/\s+/).length;
+    if (request.trim().endsWith('?') && wordCount <= 8) {
+        return 'question';
+    }
+    if (REFACTOR_RE.test(request)) {
+        return 'refactor';
+    }
+    return 'feature';
+}
+function countComplexTerms(request) {
+    return (request.match(new RegExp(COMPLEXITY_TERMS_PATTERN, 'gi')) ?? []).length;
+}
+function classifyComplexity(request, type) {
+    const words = request.trim().split(/\s+/);
+    if (ARCHITECTURAL_TERMS_RE.test(request)) {
+        return 'architectural';
+    }
+    if (type === 'exploration' || type === 'question') {
+        return 'trivial';
+    }
+    const complexCount = countComplexTerms(request);
+    if (words.length <= TRIVIAL_THRESHOLD_WORDS && complexCount === 0) {
+        return 'trivial';
+    }
+    if (complexCount >= 2) {
+        return 'feature';
+    }
+    if (complexCount >= 1) {
+        return 'simple';
+    }
+    return 'feature';
+}
+function extractKeywords(request) {
+    // Remove common stop words and keep meaningful terms
+    const stopWords = new Set([
+        'a',
+        'an',
+        'the',
+        'and',
+        'or',
+        'but',
+        'in',
+        'on',
+        'at',
+        'to',
+        'for',
+        'of',
+        'with',
+        'by',
+        'from',
+        'is',
+        'it',
+        'i',
+        'we',
+        'my',
+        'our',
+        'this',
+        'that',
+        'be',
+        'are',
+        'was',
+        'were',
+        'will',
+        'can',
+        'do',
+        'does',
+        'how',
+        'what',
+        'why',
+        'when',
+        'where',
+        'want',
+        'need',
+        'have',
+        'would',
+        'should',
+        'could',
+    ]);
+    return request
+        .toLowerCase()
+        .replace(/[^\w\s]/g, ' ')
+        .split(/\s+/)
+        .filter((w) => w.length >= 3 && !stopWords.has(w))
+        .slice(0, 10);
+}
+function computeConfidence(request, type) {
+    // Higher confidence when multiple signals align
+    const signals = [
+        BUGFIX_RE.test(request) && type === 'bugfix',
+        EXPLORATION_RE.test(request) && type === 'exploration',
+        request.trim().endsWith('?') && type === 'question',
+        REFACTOR_RE.test(request) && type === 'refactor',
+        type === 'feature',
+    ];
+    const matching = signals.filter(Boolean).length;
+    if (matching >= 2) {
+        return 0.95;
+    }
+    if (matching === 1) {
+        return 0.8;
+    }
+    return 0.6;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Classify a natural-language request into type, complexity, and keywords.
+ */
+export function classifyIntent(request) {
+    const type = classifyType(request);
+    const complexity = classifyComplexity(request, type);
+    const keywords = extractKeywords(request);
+    const confidence = computeConfidence(request, type);
+    return {
+        type,
+        complexity,
+        estimatedMinutes: MINUTES[complexity],
+        keywords,
+        confidence,
+    };
+}
+//# sourceMappingURL=intent-classifier.js.map

package/dist/engine/facilitate/intent-classifier.js.map

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

package/dist/engine/facilitate/plan-parser.d.ts

@@ -0,0 +1,7 @@
+import type { ParsedPlan } from '../../types/index.js';
+/**
+ * Extract structured spec data from Plan Mode markdown output.
+ * Returns null when the input is empty or not parseable as a plan.
+ */
+export declare function parsePlanContent(planMarkdown: string): ParsedPlan | null;
+//# sourceMappingURL=plan-parser.d.ts.map

package/dist/engine/facilitate/plan-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-parser.d.ts","sourceRoot":"","sources":["../../../src/engine/facilitate/plan-parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,sBAAsB,CAAC;AAyGnE;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAyBxE"}

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"}