@planu/cli 0.90.2 → 0.92.0

package/dist/engine/estimation-calibrator.js

@@ -0,0 +1,176 @@
+// ---------------------------------------------------------------------------
+// Deviation calculation
+// ---------------------------------------------------------------------------
+/**
+ * Compute deviation percentage: positive = over estimate, negative = under estimate.
+ * Returns 0 when estimatedHours is 0 to avoid division by zero.
+ */
+export function computeDeviationPct(estimatedHours, actualHours) {
+    if (estimatedHours === 0) {
+        return 0;
+    }
+    return ((actualHours - estimatedHours) / estimatedHours) * 100;
+}
+// ---------------------------------------------------------------------------
+// Median helper
+// ---------------------------------------------------------------------------
+function median(values) {
+    if (values.length === 0) {
+        return 0;
+    }
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 0) {
+        const lo = sorted.at(mid - 1) ?? 0;
+        const hi = sorted.at(mid) ?? 0;
+        return (lo + hi) / 2;
+    }
+    return sorted.at(mid) ?? 0;
+}
+// ---------------------------------------------------------------------------
+// Scope breakdown
+// ---------------------------------------------------------------------------
+function buildScopeBreakdown(records) {
+    const grouped = new Map();
+    for (const r of records) {
+        const existing = grouped.get(r.specScope) ?? [];
+        existing.push(r.deviationPct);
+        grouped.set(r.specScope, existing);
+    }
+    const result = [];
+    for (const [scope, deviations] of grouped) {
+        const avg = deviations.reduce((s, v) => s + v, 0) / deviations.length;
+        // If consistently over by more than 20%, suggest increasing multiplier
+        const suggestedMultiplier = avg > 20 ? 1 + avg / 100 : 1;
+        result.push({
+            scope,
+            count: deviations.length,
+            avgDeviationPct: Math.round(avg * 10) / 10,
+            suggestedMultiplier: Math.round(suggestedMultiplier * 100) / 100,
+        });
+    }
+    return result.sort((a, b) => a.scope.localeCompare(b.scope));
+}
+// ---------------------------------------------------------------------------
+// Type breakdown
+// ---------------------------------------------------------------------------
+function buildTypeBreakdown(records) {
+    const grouped = new Map();
+    for (const r of records) {
+        const existing = grouped.get(r.specType) ?? [];
+        existing.push(r.deviationPct);
+        grouped.set(r.specType, existing);
+    }
+    const result = [];
+    for (const [type, deviations] of grouped) {
+        const avg = deviations.reduce((s, v) => s + v, 0) / deviations.length;
+        result.push({
+            type,
+            count: deviations.length,
+            avgDeviationPct: Math.round(avg * 10) / 10,
+        });
+    }
+    return result.sort((a, b) => a.type.localeCompare(b.type));
+}
+// ---------------------------------------------------------------------------
+// Report generation
+// ---------------------------------------------------------------------------
+export function generateAccuracyReport(projectId, records) {
+    const deviations = records.map((r) => r.deviationPct);
+    const avgDeviationPct = records.length > 0 ? deviations.reduce((s, v) => s + v, 0) / records.length : 0;
+    const outliers = records
+        .filter((r) => Math.abs(r.deviationPct) > 50)
+        .map((r) => ({ specId: r.specId, deviationPct: r.deviationPct }));
+    const chronological = [...records].sort((a, b) => a.recordedAt.localeCompare(b.recordedAt));
+    const trend = chronological.map((r) => ({
+        specId: r.specId,
+        recordedAt: r.recordedAt,
+        deviationPct: r.deviationPct,
+    }));
+    return {
+        projectId,
+        generatedAt: new Date().toISOString(),
+        totalRecords: records.length,
+        perSpec: chronological,
+        aggregate: {
+            avgDeviationPct: Math.round(avgDeviationPct * 10) / 10,
+            medianDeviationPct: Math.round(median(deviations) * 10) / 10,
+            outlierCount: outliers.length,
+            outliers,
+        },
+        byScope: buildScopeBreakdown(records),
+        byType: buildTypeBreakdown(records),
+        trend,
+    };
+}
+// ---------------------------------------------------------------------------
+// Calibration factor computation
+// ---------------------------------------------------------------------------
+/**
+ * Compute calibration factors from historical actuals.
+ * Only creates a multiplier when sample size >= minSamples.
+ * A positive avg deviation means we historically underestimate → multiplier > 1.
+ */
+export function computeCalibrationFactors(projectId, records, minSamples) {
+    const scopeGroups = new Map();
+    const typeGroups = new Map();
+    for (const r of records) {
+        const scopeList = scopeGroups.get(r.specScope) ?? [];
+        scopeList.push(r.deviationPct);
+        scopeGroups.set(r.specScope, scopeList);
+        const typeList = typeGroups.get(r.specType) ?? [];
+        typeList.push(r.deviationPct);
+        typeGroups.set(r.specType, typeList);
+    }
+    const scopeMultipliers = {};
+    const typeMultipliers = {};
+    const sampleSize = {};
+    for (const [scope, deviations] of scopeGroups) {
+        sampleSize[`scope:${scope}`] = deviations.length;
+        if (deviations.length >= minSamples) {
+            const avg = deviations.reduce((s, v) => s + v, 0) / deviations.length;
+            if (Math.abs(avg) > 20) {
+                scopeMultipliers[scope] = Math.round((1 + avg / 100) * 100) / 100;
+            }
+        }
+    }
+    for (const [type, deviations] of typeGroups) {
+        sampleSize[`type:${type}`] = deviations.length;
+        if (deviations.length >= minSamples) {
+            const avg = deviations.reduce((s, v) => s + v, 0) / deviations.length;
+            if (Math.abs(avg) > 20) {
+                typeMultipliers[type] = Math.round((1 + avg / 100) * 100) / 100;
+            }
+        }
+    }
+    return {
+        projectId,
+        updatedAt: new Date().toISOString(),
+        scopeMultipliers,
+        typeMultipliers,
+        sampleSize,
+    };
+}
+// ---------------------------------------------------------------------------
+// Apply calibration to an estimation
+// ---------------------------------------------------------------------------
+/**
+ * Apply stored calibration factors to a base estimation hours value.
+ * Returns the adjusted hours (or the original if no factor found).
+ */
+export function applyCalibration(baseHours, scope, type, factors) {
+    if (!factors) {
+        return baseHours;
+    }
+    let adjusted = baseHours;
+    const scopeFactor = factors.scopeMultipliers[scope];
+    if (scopeFactor !== undefined) {
+        adjusted *= scopeFactor;
+    }
+    const typeFactor = factors.typeMultipliers[type];
+    if (typeFactor !== undefined) {
+        adjusted *= typeFactor;
+    }
+    return Math.round(adjusted * 10) / 10;
+}
+//# sourceMappingURL=estimation-calibrator.js.map

package/dist/engine/estimation-calibrator.js.map

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

package/dist/engine/facilitate/context-loader.d.ts

@@ -0,0 +1,12 @@
+import type { LoadedFacilitateContext } from '../../types/index.js';
+/**
+ * Load spec context directly from disk — no MCP tool calls.
+ * Gracefully handles empty/missing project directories.
+ */
+export declare function loadContext(projectPath: string, keywords: string[]): Promise<LoadedFacilitateContext>;
+/**
+ * Load context from a planu/ specs directory (alternative path — reads spec.md frontmatter).
+ * Used when data/ is not available but planu/ is present.
+ */
+export declare function loadContextFromPlanuDir(planuSpecsDir: string, keywords: string[]): Promise<LoadedFacilitateContext>;
+//# sourceMappingURL=context-loader.d.ts.map

package/dist/engine/facilitate/context-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-loader.d.ts","sourceRoot":"","sources":["../../../src/engine/facilitate/context-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,sBAAsB,CAAC;AAyF9B;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,uBAAuB,CAAC,CAwBlC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,uBAAuB,CAAC,CAyClC"}

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