@planu/cli 0.27.0 → 0.29.0

package/dist/engine/mermaid-generator.js

@@ -1,278 +1,6 @@
-// Planu — Mermaid Diagram Generator
-// Generates Mermaid diagrams based on spec type, scope, and project context
+// Planu — Mermaid Diagram Generator (facade)
+// Re-exports from mermaid/ subdirectory + mermaid-extended.ts for backward compatibility.
+export { generateDiagrams, generateDataFlowDiagram, formatDiagramsAsMarkdown, } from './mermaid/core.js';
+export { generateErDiagram, generateSequenceDiagram, generateComponentDiagram, generateStateDiagram, generateArchitectureDiagram, } from './mermaid/diagram-generators.js';
 export { generateClassDiagram, generateGanttDiagram, generatePieDiagram, } from './mermaid-extended.js';
-import { generateClassDiagram, generateGanttDiagram, generatePieDiagram, } from './mermaid-extended.js';
-/**
- * Generate all applicable diagrams for a spec based on its scope and context.
- */
-export function generateDiagrams(spec, knowledge, options) {
-    const diagrams = [];
-    // Data flow diagram for ALL specs (except trivial)
-    if (spec.scope !== 'trivial') {
-        diagrams.push(generateDataFlowDiagram(spec, knowledge));
-    }
-    // ER diagram if database changes
-    if (options.hasDatabase) {
-        diagrams.push(generateErDiagram(spec, knowledge));
-    }
-    // Sequence diagram if scope >= cross-module
-    if (isScopeAtLeast(spec.scope, 'cross-module')) {
-        diagrams.push(generateSequenceDiagram(spec, knowledge));
-    }
-    // Component diagram if UI
-    if (options.hasUi) {
-        diagrams.push(generateComponentDiagram(spec, knowledge));
-    }
-    // State machine diagram if transitions
-    if (options.hasTransitions) {
-        diagrams.push(generateStateDiagram(spec));
-    }
-    // Architecture diagram if scope = architectural
-    if (spec.scope === 'architectural') {
-        diagrams.push(generateArchitectureDiagram(spec, knowledge));
-    }
-    // Class diagram for cross-module+ backend/shared specs
-    if (isScopeAtLeast(spec.scope, 'cross-module') &&
-        (spec.target === 'backend' || spec.target === 'shared' || spec.target === 'fullstack')) {
-        diagrams.push(generateClassDiagram(spec));
-    }
-    // Gantt diagram for larger specs (> 8 dev hours)
-    if (spec.estimation.devHours > 8) {
-        diagrams.push(generateGanttDiagram(spec));
-    }
-    // Pie chart for effort distribution (always for per-spec reports)
-    diagrams.push(generatePieDiagram(spec));
-    return diagrams;
-}
-/**
- * Generate a data flow diagram: Client -> Action -> Service -> Repo -> DB
- */
-export function generateDataFlowDiagram(spec, knowledge) {
-    const layers = buildLayers(spec.target, knowledge);
-    const lines = ['graph LR'];
-    layers.forEach((from, i) => {
-        const to = layers[i + 1];
-        if (to) {
-            lines.push(`  ${from.id}[${from.label}] --> ${to.id}[${to.label}]`);
-        }
-    });
-    return {
-        type: 'data-flow',
-        title: `Data Flow — ${spec.title}`,
-        format: 'mermaid',
-        content: lines.join('\n'),
-        description: 'Data flow diagram showing how data moves through the system layers.',
-    };
-}
-/**
- * Generate an ER diagram for database changes.
- */
-export function generateErDiagram(spec, knowledge) {
-    const dbEngine = knowledge?.database ?? 'unknown';
-    const lines = [
-        'erDiagram',
-        `  %% Database: ${dbEngine}`,
-        `  %% Spec: ${spec.title}`,
-        '  ENTITY_A {',
-        '    string id PK',
-        '    string name',
-        '    datetime created_at',
-        '  }',
-        '  ENTITY_B {',
-        '    string id PK',
-        '    string entity_a_id FK',
-        '    string value',
-        '  }',
-        '  ENTITY_A ||--o{ ENTITY_B : "has many"',
-    ];
-    return {
-        type: 'er',
-        title: `Entity Relationship — ${spec.title}`,
-        format: 'mermaid',
-        content: lines.join('\n'),
-        description: 'Entity-relationship diagram for database schema changes. Customize entities to match your domain.',
-    };
-}
-/**
- * Generate a sequence diagram for cross-module interactions.
- */
-export function generateSequenceDiagram(spec, knowledge) {
-    const participants = buildParticipants(spec.target, knowledge);
-    const lines = ['sequenceDiagram'];
-    for (const p of participants) {
-        lines.push(`  participant ${p.id} as ${p.label}`);
-    }
-    // Generate basic request-response flow
-    const first = participants[0];
-    const second = participants[1];
-    if (first && second) {
-        lines.push(`  ${first.id}->>+${second.id}: Request`);
-        const third = participants[2];
-        if (third) {
-            lines.push(`  ${second.id}->>+${third.id}: Process`);
-            lines.push(`  ${third.id}-->>-${second.id}: Result`);
-        }
-        lines.push(`  ${second.id}-->>-${first.id}: Response`);
-    }
-    return {
-        type: 'sequence',
-        title: `Sequence Diagram — ${spec.title}`,
-        format: 'mermaid',
-        content: lines.join('\n'),
-        description: 'Sequence diagram showing interactions between modules. Customize messages to match your flow.',
-    };
-}
-/**
- * Generate a component diagram for UI specs.
- */
-export function generateComponentDiagram(spec, knowledge) {
-    const framework = knowledge?.framework ?? 'UI';
-    const lines = [
-        'graph TD',
-        `  Page["${spec.title} Page"]`,
-        `  Page --> Header[Header]`,
-        `  Page --> Main[Main Content]`,
-        `  Page --> Footer[Footer]`,
-        `  Main --> CompA["Component A"]`,
-        `  Main --> CompB["Component B"]`,
-        `  CompA --> Store["${framework} State"]`,
-        `  CompB --> Store`,
-    ];
-    return {
-        type: 'component',
-        title: `Component Diagram — ${spec.title}`,
-        format: 'mermaid',
-        content: lines.join('\n'),
-        description: 'UI component hierarchy diagram. Customize components to match your design.',
-    };
-}
-/**
- * Generate a state machine diagram for transitions.
- */
-export function generateStateDiagram(spec) {
-    const lines = [
-        'stateDiagram-v2',
-        `  [*] --> Initial`,
-        `  Initial --> Processing: Start`,
-        `  Processing --> Success: Complete`,
-        `  Processing --> Error: Fail`,
-        `  Error --> Processing: Retry`,
-        `  Success --> [*]`,
-    ];
-    return {
-        type: 'state-machine',
-        title: `State Machine — ${spec.title}`,
-        format: 'mermaid',
-        content: lines.join('\n'),
-        description: 'State machine diagram showing state transitions. Customize states to match your domain.',
-    };
-}
-/**
- * Generate an architecture diagram for architectural specs.
- */
-export function generateArchitectureDiagram(spec, knowledge) {
-    const arch = knowledge?.architecture;
-    const pattern = arch ? arch.primary : 'layered';
-    const externalServices = knowledge?.externalServices ?? [];
-    const externalLabel = externalServices.length > 0 ? externalServices.slice(0, 2).join(' / ') : 'External Services';
-    const lines = [
-        'graph TB',
-        `  subgraph "${spec.title}"`,
-        `    direction TB`,
-        `    Client["Client Layer"]`,
-        `    API["API Gateway"]`,
-        `    Service["Service Layer"]`,
-        `    Data["Data Layer"]`,
-        `    Client --> API`,
-        `    API --> Service`,
-        `    Service --> Data`,
-        `  end`,
-        `  External["${externalLabel}"]`,
-        `  Service --> External`,
-        `  %% Architecture: ${pattern}`,
-    ];
-    return {
-        type: 'architecture',
-        title: `Architecture — ${spec.title}`,
-        format: 'mermaid',
-        content: lines.join('\n'),
-        description: `Architecture diagram using ${pattern} pattern. Customize to match your system.`,
-    };
-}
-/**
- * Format diagrams as Mermaid code blocks for inclusion in markdown.
- */
-export function formatDiagramsAsMarkdown(diagrams) {
-    if (diagrams.length === 0) {
-        return '';
-    }
-    const sections = [];
-    for (const diagram of diagrams) {
-        sections.push(`### ${diagram.title}`);
-        sections.push('');
-        sections.push(`> ${diagram.description}`);
-        sections.push('');
-        sections.push('```mermaid');
-        sections.push(diagram.content);
-        sections.push('```');
-        sections.push('');
-    }
-    return sections.join('\n');
-}
-// === Internal helpers ===
-function isScopeAtLeast(scope, threshold) {
-    const order = {
-        trivial: 0,
-        feature: 1,
-        'cross-module': 2,
-        architectural: 3,
-    };
-    return order[scope] >= order[threshold];
-}
-function buildLayers(target, knowledge) {
-    // If knowledge has real architecture layers, prefer them over target-inferred ones
-    if (knowledge && knowledge.architecture.layers.length > 0) {
-        return knowledge.architecture.layers.map((l) => ({
-            id: l.name.replace(/[^a-zA-Z0-9]/g, '_'),
-            label: l.name,
-        }));
-    }
-    const framework = knowledge?.framework ?? '';
-    const layers = [];
-    if (target === 'frontend' || target === 'fullstack') {
-        layers.push({ id: 'Client', label: framework ? `Client (${framework})` : 'Client' });
-    }
-    if (target !== 'database' && target !== 'infrastructure') {
-        layers.push({ id: 'Action', label: 'Action/Controller' });
-        layers.push({ id: 'Service', label: 'Service' });
-    }
-    if (target === 'backend' || target === 'fullstack' || target === 'database') {
-        layers.push({ id: 'Repo', label: 'Repository' });
-        const dbRaw = knowledge?.database ?? 'DB';
-        const db = dbRaw === 'unknown' ? 'DB' : dbRaw;
-        layers.push({ id: 'DB', label: db });
-    }
-    if (target === 'infrastructure') {
-        layers.push({ id: 'Infra', label: 'Infrastructure' });
-        layers.push({ id: 'Cloud', label: 'Cloud Provider' });
-    }
-    // Fallback if empty
-    if (layers.length === 0) {
-        layers.push({ id: 'Input', label: 'Input' }, { id: 'Process', label: 'Process' }, { id: 'Output', label: 'Output' });
-    }
-    return layers;
-}
-function buildParticipants(target, knowledge) {
-    const participants = [];
-    if (target === 'frontend' || target === 'fullstack') {
-        participants.push({ id: 'UI', label: 'UI' });
-    }
-    participants.push({ id: 'API', label: 'API' });
-    participants.push({ id: 'SVC', label: 'Service' });
-    if (target === 'backend' || target === 'fullstack' || target === 'database') {
-        const db = knowledge?.database ?? 'DB';
-        participants.push({ id: 'DB', label: db });
-    }
-    return participants;
-}
 //# sourceMappingURL=mermaid-generator.js.map

package/dist/engine/mermaid-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid-generator.js","sourceRoot":"","sources":["../../src/engine/mermaid-generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mermaid-generator.js","sourceRoot":"","sources":["../../src/engine/mermaid-generator.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,0FAA0F;AAE1F,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC"}

package/dist/engine/model-router/complexity-analyzer.d.ts

@@ -0,0 +1,26 @@
+import type { ComplexitySignals, NormalisedSignals, PartialSignals } from '../../types/index.js';
+/**
+ * Extract complexity signals from a text description (spec content or task description).
+ * Missing signals are filled with sensible defaults.
+ */
+export declare function extractSignals(text: string, overrides?: PartialSignals): ComplexitySignals;
+/** Build signals entirely from an explicit partial object (no text analysis). */
+export declare function buildSignalsFromPartial(partial: PartialSignals): ComplexitySignals;
+/** Normalise raw numeric signals to the 0-1 range. */
+export declare function normaliseSignals(raw: {
+    criteriaCount: number;
+    fileCount: number;
+    dependencyDepth: number;
+    crossLayerCount: number;
+    estimatedHours: number;
+    hasNewTypes: boolean;
+    hasDBChanges: boolean;
+    hasSecurityImplications: boolean;
+    isReadOnly: boolean;
+}): NormalisedSignals;
+/**
+ * Compute a weighted overall complexity score (0-1) from normalised signals.
+ * Higher = more complex.
+ */
+export declare function computeOverallScore(n: NormalisedSignals): number;
+//# sourceMappingURL=complexity-analyzer.d.ts.map

package/dist/engine/model-router/complexity-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity-analyzer.d.ts","sourceRoot":"","sources":["../../../src/engine/model-router/complexity-analyzer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAiK9B;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,cAAc,GAAG,iBAAiB,CAO1F;AAED,iFAAiF;AACjF,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB,CAElF;AAED,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,OAAO,CAAC;IACtB,uBAAuB,EAAE,OAAO,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG,iBAAiB,CAYpB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAmBhE"}

package/dist/engine/model-router/complexity-analyzer.js

@@ -0,0 +1,182 @@
+// engine/model-router/complexity-analyzer.ts — Extract and normalise complexity signals.
+// SPEC-076 AC-01
+// ---------------------------------------------------------------------------
+// Normalisation ceilings (signals are clamped to 0-1 using these maximums)
+// ---------------------------------------------------------------------------
+const MAX_CRITERIA = 40;
+const MAX_FILES = 30;
+const MAX_DEPTH = 6;
+const MAX_CROSS_LAYER = 5;
+const MAX_HOURS = 80;
+/** Clamp a value into [0, 1] by dividing by its ceiling. */
+function norm(value, ceiling) {
+    if (ceiling <= 0) {
+        return 0;
+    }
+    return Math.min(Math.max(value / ceiling, 0), 1);
+}
+// ---------------------------------------------------------------------------
+// Signal extraction from text
+// ---------------------------------------------------------------------------
+const TASK_KEYWORDS = {
+    search: ['search', 'find', 'explore', 'list', 'read', 'summarize', 'grep'],
+    generation: ['generate', 'create', 'implement', 'write', 'build', 'add', 'scaffold'],
+    architecture: ['architect', 'design', 'restructure', 'system', 'plan', 'rfc'],
+    debugging: ['debug', 'fix', 'investigate', 'trace', 'diagnose', 'bug', 'error'],
+    refactor: ['refactor', 'rename', 'extract', 'simplify', 'clean', 'reorganize', 'move'],
+};
+const SECURITY_KEYWORDS = [
+    'security',
+    'auth',
+    'permission',
+    'rbac',
+    'encryption',
+    'token',
+    'jwt',
+    'cors',
+    'csrf',
+    'xss',
+    'injection',
+    'sanitize',
+    'pii',
+    'gdpr',
+];
+const DB_KEYWORDS = [
+    'database',
+    'migration',
+    'schema',
+    'table',
+    'column',
+    'index',
+    'query',
+    'sql',
+    'postgres',
+    'mysql',
+    'mongo',
+    'redis',
+    'prisma',
+    'drizzle',
+];
+/** Infer a TaskType from a text description. */
+function inferTaskType(text) {
+    const lower = text.toLowerCase();
+    let bestType = 'generation';
+    let bestScore = 0;
+    for (const [type, keywords] of Object.entries(TASK_KEYWORDS)) {
+        const score = keywords.filter((kw) => lower.includes(kw)).length;
+        if (score > bestScore) {
+            bestScore = score;
+            bestType = type;
+        }
+    }
+    return bestType;
+}
+/** Count how many keywords from a list appear in a text. */
+function keywordHits(text, keywords) {
+    const lower = text.toLowerCase();
+    return keywords.filter((kw) => lower.includes(kw)).length;
+}
+/** Count acceptance criteria by looking for AC- or numbered list patterns. */
+function countCriteria(text) {
+    const acMatches = text.match(/\bAC-\d+/g);
+    if (acMatches) {
+        return acMatches.length;
+    }
+    // Fallback: count markdown list items that look like criteria
+    const listItems = text.match(/^[-*]\s+/gm);
+    return listItems ? Math.ceil(listItems.length / 2) : 0;
+}
+/** Estimate file count from technical sheet patterns. */
+function countFiles(text) {
+    const fileRefs = text.match(/`[^`]+\.(ts|js|json|md|tsx|jsx|py|go|rs)`/g);
+    return fileRefs ? fileRefs.length : 0;
+}
+/** Count distinct architectural layers referenced. */
+function countLayers(text) {
+    const layers = ['types/', 'engine/', 'tools/', 'storage/', 'config/', 'resources/'];
+    return layers.filter((l) => text.includes(l)).length;
+}
+// ---------------------------------------------------------------------------
+// Internal helpers to reduce extractSignals complexity
+// ---------------------------------------------------------------------------
+/** Extract boolean and categorical signals from text, applying overrides. */
+function extractQualitativeSignals(text, overrides) {
+    return {
+        hasNewTypes: overrides?.hasNewTypes ?? text.includes('types/'),
+        hasDBChanges: overrides?.hasDBChanges ?? keywordHits(text, DB_KEYWORDS) >= 2,
+        hasSecurityImplications: overrides?.hasSecurityImplications ?? keywordHits(text, SECURITY_KEYWORDS) >= 2,
+        isReadOnly: overrides?.isReadOnly ?? false,
+        taskType: overrides?.taskType ?? inferTaskType(text),
+    };
+}
+/** Extract raw signal values from text, applying overrides. */
+function extractRawSignals(text, overrides) {
+    const criteriaCount = overrides?.criteriaCount ?? countCriteria(text);
+    const fileCount = overrides?.fileCount ?? countFiles(text);
+    const crossLayerCount = overrides?.crossLayerCount ?? countLayers(text);
+    const dependencyDepth = overrides?.dependencyDepth ?? Math.min(crossLayerCount, MAX_DEPTH);
+    const estimatedHours = overrides?.estimatedHours ?? criteriaCount * 0.5;
+    const qualitative = extractQualitativeSignals(text, overrides);
+    return {
+        criteriaCount,
+        fileCount,
+        dependencyDepth,
+        crossLayerCount,
+        estimatedHours,
+        ...qualitative,
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Extract complexity signals from a text description (spec content or task description).
+ * Missing signals are filled with sensible defaults.
+ */
+export function extractSignals(text, overrides) {
+    const raw = extractRawSignals(text, overrides);
+    const normalised = normaliseSignals(raw);
+    const overallScore = computeOverallScore(normalised);
+    return { ...raw, overallScore };
+}
+/** Build signals entirely from an explicit partial object (no text analysis). */
+export function buildSignalsFromPartial(partial) {
+    return extractSignals('', partial);
+}
+/** Normalise raw numeric signals to the 0-1 range. */
+export function normaliseSignals(raw) {
+    return {
+        criteriaCount: norm(raw.criteriaCount, MAX_CRITERIA),
+        fileCount: norm(raw.fileCount, MAX_FILES),
+        dependencyDepth: norm(raw.dependencyDepth, MAX_DEPTH),
+        crossLayerCount: norm(raw.crossLayerCount, MAX_CROSS_LAYER),
+        estimatedHours: norm(raw.estimatedHours, MAX_HOURS),
+        hasNewTypes: raw.hasNewTypes ? 1 : 0,
+        hasDBChanges: raw.hasDBChanges ? 1 : 0,
+        hasSecurityImplications: raw.hasSecurityImplications ? 1 : 0,
+        isReadOnly: raw.isReadOnly ? 1 : 0,
+    };
+}
+/**
+ * Compute a weighted overall complexity score (0-1) from normalised signals.
+ * Higher = more complex.
+ */
+export function computeOverallScore(n) {
+    const weights = {
+        criteriaCount: 0.25,
+        fileCount: 0.15,
+        dependencyDepth: 0.1,
+        crossLayerCount: 0.15,
+        estimatedHours: 0.1,
+        hasNewTypes: 0.05,
+        hasDBChanges: 0.05,
+        hasSecurityImplications: 0.1,
+        isReadOnly: -0.05, // read-only reduces complexity
+    };
+    let score = 0;
+    for (const [key, weight] of Object.entries(weights)) {
+        score += n[key] * weight;
+    }
+    return Math.min(Math.max(score, 0), 1);
+}
+//# sourceMappingURL=complexity-analyzer.js.map

package/dist/engine/model-router/complexity-analyzer.js.map

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

package/dist/engine/model-router/cost-estimator.d.ts

@@ -0,0 +1,6 @@
+import type { ComplexitySignals, CostEstimate, ModelTier } from '../../types/index.js';
+/** Calculate the cost estimate for a given model tier and complexity signals. */
+export declare function calculateCost(tier: ModelTier, signals: ComplexitySignals): CostEstimate;
+/** Calculate costs for all three tiers so the user can compare. */
+export declare function calculateAllTierCosts(signals: ComplexitySignals): Record<ModelTier, CostEstimate>;
+//# sourceMappingURL=cost-estimator.d.ts.map

package/dist/engine/model-router/cost-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimator.d.ts","sourceRoot":"","sources":["../../../src/engine/model-router/cost-estimator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,SAAS,EAEV,MAAM,sBAAsB,CAAC;AAkD9B,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAYvF;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAMjG"}

package/dist/engine/model-router/cost-estimator.js

@@ -0,0 +1,60 @@
+// engine/model-router/cost-estimator.ts — Token and USD cost estimation per model tier.
+// SPEC-076 AC-04
+import pricingJson from '../../config/ai-model-pricing.json' with { type: 'json' };
+// ---------------------------------------------------------------------------
+// Pricing lookup
+// ---------------------------------------------------------------------------
+const MODEL_IDS = {
+    haiku: 'claude-haiku-3-5',
+    sonnet: 'claude-sonnet-4',
+    opus: 'claude-opus-4',
+};
+function getPricing(tier) {
+    const modelId = MODEL_IDS[tier];
+    const entry = pricingJson.models.find((m) => m.id === modelId);
+    /* c8 ignore next 3 */
+    if (!entry) {
+        return { id: modelId, inputPricePerMillion: 3, outputPricePerMillion: 15 };
+    }
+    return entry;
+}
+// ---------------------------------------------------------------------------
+// Token estimation heuristic
+// ---------------------------------------------------------------------------
+/** Base token estimates per complexity range (overall score brackets). */
+function estimateTokens(signals) {
+    const score = signals.overallScore;
+    // Read-only tasks consume less output
+    const outputMultiplier = signals.isReadOnly ? 0.3 : 1;
+    if (score < 0.3) {
+        return { input: 2_000, output: Math.round(1_000 * outputMultiplier) };
+    }
+    if (score < 0.6) {
+        return { input: 8_000, output: Math.round(5_000 * outputMultiplier) };
+    }
+    return { input: 20_000, output: Math.round(15_000 * outputMultiplier) };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Calculate the cost estimate for a given model tier and complexity signals. */
+export function calculateCost(tier, signals) {
+    const pricing = getPricing(tier);
+    const tokens = estimateTokens(signals);
+    const inputCost = (tokens.input / 1_000_000) * pricing.inputPricePerMillion;
+    const outputCost = (tokens.output / 1_000_000) * pricing.outputPricePerMillion;
+    return {
+        estimatedTokens: tokens.input + tokens.output,
+        estimatedUSD: Math.round((inputCost + outputCost) * 10_000) / 10_000,
+        breakdown: { input: tokens.input, output: tokens.output },
+    };
+}
+/** Calculate costs for all three tiers so the user can compare. */
+export function calculateAllTierCosts(signals) {
+    return {
+        haiku: calculateCost('haiku', signals),
+        sonnet: calculateCost('sonnet', signals),
+        opus: calculateCost('opus', signals),
+    };
+}
+//# sourceMappingURL=cost-estimator.js.map

package/dist/engine/model-router/cost-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-estimator.js","sourceRoot":"","sources":["../../../src/engine/model-router/cost-estimator.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,iBAAiB;AASjB,OAAO,WAAW,MAAM,oCAAoC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEnF,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,SAAS,GAA8B;IAC3C,KAAK,EAAE,kBAAkB;IACzB,MAAM,EAAE,iBAAiB;IACzB,IAAI,EAAE,eAAe;CACtB,CAAC;AAEF,SAAS,UAAU,CAAC,IAAe;IACjC,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAI,WAAW,CAAC,MAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAEnF,sBAAsB;IACtB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,EAAE,qBAAqB,EAAE,EAAE,EAAE,CAAC;IAC7E,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,0EAA0E;AAC1E,SAAS,cAAc,CAAC,OAA0B;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC;IAEnC,sCAAsC;IACtC,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAChB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,KAAK,GAAG,GAAG,EAAE,CAAC;QAChB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAAC,EAAE,CAAC;IACxE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,gBAAgB,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,IAAe,EAAE,OAA0B;IACvE,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAEvC,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAC5E,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAE/E,OAAO;QACL,eAAe,EAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM;QAC7C,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM;QACpE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;KAC1D,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,qBAAqB,CAAC,OAA0B;IAC9D,OAAO;QACL,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC;QACtC,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC;QACxC,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/engine/model-router/historical-learner.d.ts

@@ -0,0 +1,26 @@
+import type { HistoricalAdjustment, ModelOutcome, ModelTier } from '../../types/index.js';
+/** Record a model outcome for future learning. */
+export declare function recordOutcome(outcome: ModelOutcome): void;
+/** Get all recorded outcomes (for testing / export). */
+export declare function getOutcomes(): readonly ModelOutcome[];
+/** Clear all outcomes (for testing). */
+export declare function clearOutcomes(): void;
+/** Load outcomes from an external source (e.g. JSON file). */
+export declare function loadOutcomes(loaded: ModelOutcome[]): void;
+/**
+ * Find outcomes whose taskSignature matches the given signature.
+ * Uses exact match for now; vector similarity can be added later (SPEC-075).
+ */
+export declare function findSimilarOutcomes(taskSignature: string): ModelOutcome[];
+/**
+ * Compute a task signature from a description or spec ID.
+ * For now this is a simple normalisation; in the future it can use embeddings.
+ */
+export declare function computeTaskSignature(text: string): string;
+/**
+ * Given the rules engine recommendation and a task signature,
+ * adjust the tier based on historical outcomes.
+ * Maximum adjustment: plus or minus 1 tier.
+ */
+export declare function adjustFromHistory(recommendedModel: ModelTier, taskSignature: string): HistoricalAdjustment;
+//# sourceMappingURL=historical-learner.d.ts.map

package/dist/engine/model-router/historical-learner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historical-learner.d.ts","sourceRoot":"","sources":["../../../src/engine/model-router/historical-learner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAuB1F,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAEzD;AAED,wDAAwD;AACxD,wBAAgB,WAAW,IAAI,SAAS,YAAY,EAAE,CAErD;AAED,wCAAwC;AACxC,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY,EAAE,CAEzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,SAAS,EAC3B,aAAa,EAAE,MAAM,GACpB,oBAAoB,CA6CtB"}