@planu/cli 0.15.2

package/dist/engine/token-tracker.js

@@ -0,0 +1,176 @@
+// ---------------------------------------------------------------------------
+// Static tool classification (local/template/light-llm/full-llm)
+// ---------------------------------------------------------------------------
+const TOOL_MODES = {
+    // local — zero LLM tokens, pure logic
+    list_specs: 'local',
+    update_status: 'local',
+    set_locale: 'local',
+    manage_context: 'local',
+    manage_git: 'local',
+    capture_learning: 'local',
+    // template — minimal tokens, mostly template filling
+    create_spec: 'template',
+    generate_docs: 'template',
+    generate_checklist: 'template',
+    generate_skills: 'template',
+    clarify_requirements: 'template',
+    // light-llm — moderate reasoning required
+    estimate: 'light-llm',
+    suggest_stack: 'light-llm',
+    challenge_spec: 'light-llm',
+    validate: 'light-llm',
+    suggest_tooling: 'light-llm',
+    suggest_mcps: 'light-llm',
+    learn_pattern: 'light-llm',
+    // full-llm — complex reasoning
+    audit: 'full-llm',
+    orchestrate: 'full-llm',
+    reverse_engineer: 'full-llm',
+    init_project: 'full-llm',
+    update_spec: 'full-llm',
+    fetch_web: 'full-llm',
+};
+// Estimated tokens per mode (conservative baseline)
+const TOKENS_BY_MODE = {
+    local: 0,
+    template: 500,
+    'light-llm': 2000,
+    'full-llm': 8000,
+};
+// Naive baseline — assume every operation would be full-llm
+const NAIVE_TOKENS = 8000;
+// Sonnet pricing per million tokens (output)
+const COST_PER_TOKEN = 3 / 1_000_000;
+// Budget warning threshold
+const WARNING_THRESHOLD = 0.8;
+// ---------------------------------------------------------------------------
+// Model recommendations by operation type
+// ---------------------------------------------------------------------------
+const TOOL_MODEL = {
+    // haiku: read-only, search, simple lookups
+    list_specs: 'haiku',
+    manage_context: 'haiku',
+    fetch_web: 'haiku',
+    learn_pattern: 'haiku',
+    capture_learning: 'haiku',
+    // sonnet: implementation, writing, refactoring
+    create_spec: 'sonnet',
+    generate_docs: 'sonnet',
+    generate_checklist: 'sonnet',
+    generate_skills: 'sonnet',
+    clarify_requirements: 'sonnet',
+    update_spec: 'sonnet',
+    suggest_stack: 'sonnet',
+    suggest_tooling: 'sonnet',
+    suggest_mcps: 'sonnet',
+    validate: 'sonnet',
+    estimate: 'sonnet',
+    challenge_spec: 'sonnet',
+    update_status: 'sonnet',
+    manage_git: 'sonnet',
+    // opus: architecture, complex debugging, multi-system design
+    audit: 'opus',
+    orchestrate: 'opus',
+    reverse_engineer: 'opus',
+    init_project: 'opus',
+};
+// ---------------------------------------------------------------------------
+// classifyOperation
+// ---------------------------------------------------------------------------
+export function classifyOperation(tool) {
+    return TOOL_MODES[tool] ?? 'full-llm';
+}
+// ---------------------------------------------------------------------------
+// recommendModel
+// ---------------------------------------------------------------------------
+export function recommendModel(tool) {
+    return TOOL_MODEL[tool] ?? 'sonnet';
+}
+// ---------------------------------------------------------------------------
+// estimateTokensForOperation
+// ---------------------------------------------------------------------------
+export function estimateTokensForOperation(tool) {
+    const mode = classifyOperation(tool);
+    return TOKENS_BY_MODE[mode];
+}
+// ---------------------------------------------------------------------------
+// estimateCostUsd
+// ---------------------------------------------------------------------------
+export function estimateCostUsd(tokensUsed) {
+    return Math.round(tokensUsed * COST_PER_TOKEN * 100_000) / 100_000;
+}
+// ---------------------------------------------------------------------------
+// calculateSavingsVsNaive
+// ---------------------------------------------------------------------------
+export function calculateSavingsVsNaive(usages) {
+    if (usages.length === 0) {
+        return 0;
+    }
+    const actualTokens = usages.reduce((sum, u) => sum + u.tokensUsed, 0);
+    const naiveTokens = usages.length * NAIVE_TOKENS;
+    if (naiveTokens === 0) {
+        return 0;
+    }
+    const savings = ((naiveTokens - actualTokens) / naiveTokens) * 100;
+    return Math.max(0, Math.round(savings));
+}
+// ---------------------------------------------------------------------------
+// getBudgetStatus
+// ---------------------------------------------------------------------------
+export function getBudgetStatus(monthlyLimitUsd, usages) {
+    // Filter to current calendar month
+    const now = new Date();
+    const monthStart = new Date(now.getFullYear(), now.getMonth(), 1).toISOString();
+    const monthUsages = usages.filter((u) => u.timestamp >= monthStart);
+    const currentUsageUsd = monthUsages.reduce((sum, u) => sum + u.costUsd, 0);
+    const percentUsed = monthlyLimitUsd > 0 ? Math.round((currentUsageUsd / monthlyLimitUsd) * 100) : 0;
+    // Reset date = first day of next month
+    const nextMonth = new Date(now.getFullYear(), now.getMonth() + 1, 1);
+    return {
+        monthlyLimitUsd,
+        currentUsageUsd: Math.round(currentUsageUsd * 10000) / 10000,
+        percentUsed,
+        resetDate: nextMonth.toISOString().slice(0, 10),
+        isWarning: percentUsed >= WARNING_THRESHOLD * 100,
+        isExceeded: percentUsed >= 100,
+    };
+}
+// ---------------------------------------------------------------------------
+// formatSavingsDashboard
+// ---------------------------------------------------------------------------
+export function formatSavingsDashboard(usages) {
+    if (usages.length === 0) {
+        return 'No token usage recorded yet.';
+    }
+    const savings = calculateSavingsVsNaive(usages);
+    const totalTokens = usages.reduce((sum, u) => sum + u.tokensUsed, 0);
+    const totalCost = usages.reduce((sum, u) => sum + u.costUsd, 0);
+    const byMode = {};
+    for (const u of usages) {
+        const m = byMode[u.mode] ?? { count: 0, tokens: 0 };
+        m.count += 1;
+        m.tokens += u.tokensUsed;
+        byMode[u.mode] = m;
+    }
+    const modeLines = Object.entries(byMode)
+        .map(([mode, { count, tokens }]) => `  ${mode}: ${String(count)} ops, ${String(tokens)} tokens`)
+        .join('\n');
+    return [
+        `Token Optimization Dashboard`,
+        `Operations: ${String(usages.length)} | Total tokens: ${String(totalTokens)} | Cost: $${totalCost.toFixed(4)}`,
+        `Savings vs naive (all full-llm): ${String(savings)}%`,
+        `Breakdown by mode:`,
+        modeLines,
+    ].join('\n');
+}
+// ---------------------------------------------------------------------------
+// getOperationHistory
+// ---------------------------------------------------------------------------
+export function getOperationHistory(usages, tool) {
+    if (!tool) {
+        return usages;
+    }
+    return usages.filter((u) => u.tool === tool);
+}
+//# sourceMappingURL=token-tracker.js.map

package/dist/engine/token-tracker.js.map

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

package/dist/engine/upgrade-planner/breaking-change-parser.d.ts

@@ -0,0 +1,6 @@
+import type { UpgradeBreakingChange } from '../../types/index.js';
+/**
+ * Parse changelog text and extract breaking changes between fromVersion and toVersion.
+ */
+export declare function parseBreakingChanges(changelogText: string, fromVersion: string, toVersion: string): UpgradeBreakingChange[];
+//# sourceMappingURL=breaking-change-parser.d.ts.map

package/dist/engine/upgrade-planner/breaking-change-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breaking-change-parser.d.ts","sourceRoot":"","sources":["../../../src/engine/upgrade-planner/breaking-change-parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAyFlE;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,qBAAqB,EAAE,CA4BzB"}

package/dist/engine/upgrade-planner/breaking-change-parser.js

@@ -0,0 +1,101 @@
+// ---------------------------------------------------------------------------
+// Section header patterns that signal breaking changes
+// ---------------------------------------------------------------------------
+const BREAKING_SECTION_PATTERNS = [
+    /#{1,3}\s*(?:breaking\s*changes?|BREAKING\s*CHANGES?)/i,
+    /#{1,3}\s*(?:removed|REMOVED)/i,
+    /#{1,3}\s*(?:migration\s*guide|MIGRATION\s*GUIDE)/i,
+    /⚠️/,
+    /!{2,}/,
+    /BREAKING:/,
+];
+const BREAKING_INLINE_PATTERNS = [
+    /\bBREAKING\b/,
+    /\bremoved?\b.*\bAPI\b/i,
+    /\bdeprecated?\b.*\bremoved?\b/i,
+    /\bmust\s+update\b/i,
+    /\bno\s+longer\s+support/i,
+    /\bwill\s+throw\b/i,
+];
+// ---------------------------------------------------------------------------
+// Version range extraction
+// ---------------------------------------------------------------------------
+function isInVersionRange(sectionTitle, fromVersion, toVersion) {
+    const versionPattern = /v?(\d+\.\d+[\d.]*)/g;
+    const versionMatches = Array.from(sectionTitle.matchAll(versionPattern));
+    if (versionMatches.length === 0) {
+        return true;
+    }
+    for (const m of versionMatches) {
+        const ver = m[1];
+        if (ver && isVersionBetween(ver, fromVersion, toVersion)) {
+            return true;
+        }
+    }
+    return false;
+}
+function toVersionNum(v) {
+    const parts = v.replace(/^v/, '').split('.').map(Number);
+    /* v8 ignore next */
+    return (parts[0] ?? 0) * 1_000_000 + (parts[1] ?? 0) * 1_000 + (parts[2] ?? 0);
+}
+function isVersionBetween(ver, from, to) {
+    const verNum = toVersionNum(ver);
+    const fromNum = toVersionNum(from);
+    const toNum = toVersionNum(to);
+    return verNum > fromNum && verNum <= toNum;
+}
+// ---------------------------------------------------------------------------
+// Line extraction
+// ---------------------------------------------------------------------------
+function extractBreakingLines(lines) {
+    const found = [];
+    let inBreakingSection = false;
+    for (const line of lines) {
+        const isHeader = /^#{1,4}/.test(line);
+        if (isHeader) {
+            inBreakingSection = BREAKING_SECTION_PATTERNS.some((p) => p.test(line));
+            continue;
+        }
+        if (inBreakingSection && line.trim().length > 0) {
+            found.push(line.trim());
+            continue;
+        }
+        if (BREAKING_INLINE_PATTERNS.some((p) => p.test(line)) && line.trim().length > 10) {
+            found.push(line.trim());
+        }
+    }
+    return found;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse changelog text and extract breaking changes between fromVersion and toVersion.
+ */
+export function parseBreakingChanges(changelogText, fromVersion, toVersion) {
+    if (!changelogText.trim()) {
+        return [];
+    }
+    const lines = changelogText.split('\n');
+    const relevantLines = [];
+    let currentSectionInRange = false;
+    for (const line of lines) {
+        const isHeader = /^#{1,4}/.test(line);
+        if (isHeader) {
+            currentSectionInRange = isInVersionRange(line, fromVersion, toVersion);
+        }
+        if (currentSectionInRange) {
+            relevantLines.push(line);
+        }
+    }
+    const targetLines = relevantLines.length > 5 ? relevantLines : lines;
+    const breakingLines = extractBreakingLines(targetLines);
+    return breakingLines.slice(0, 20).map((description) => ({
+        description: description.replace(/^[-*]\s*/, ''),
+        affectedPattern: '',
+        migrationAction: 'Review changelog and update affected code',
+        impact: 'unknown',
+    }));
+}
+//# sourceMappingURL=breaking-change-parser.js.map

package/dist/engine/upgrade-planner/breaking-change-parser.js.map

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

package/dist/engine/upgrade-planner/impact-analyzer.d.ts

@@ -0,0 +1,7 @@
+import type { UpgradeBreakingChange } from '../../types/index.js';
+/**
+ * For each breaking change, scan the project source files to determine
+ * whether the project is actually impacted (sets impact field).
+ */
+export declare function analyzeImpact(projectPath: string, breakingChanges: UpgradeBreakingChange[]): Promise<UpgradeBreakingChange[]>;
+//# sourceMappingURL=impact-analyzer.d.ts.map

package/dist/engine/upgrade-planner/impact-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-analyzer.d.ts","sourceRoot":"","sources":["../../../src/engine/upgrade-planner/impact-analyzer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AA0ClE;;;GAGG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,qBAAqB,EAAE,GACvC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA2BlC"}

package/dist/engine/upgrade-planner/impact-analyzer.js

@@ -0,0 +1,65 @@
+// impact-analyzer.ts — Scan project for code affected by breaking changes (SPEC-041)
+import { readFile } from 'node:fs/promises';
+import { glob } from 'glob';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_EXTENSIONS = ['ts', 'tsx', 'js', 'jsx', 'mjs', 'cjs'];
+const EXCLUDE_DIRS = ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.git/**'];
+// ---------------------------------------------------------------------------
+// File scanner
+// ---------------------------------------------------------------------------
+async function findSourceFiles(projectPath) {
+    const patterns = DEFAULT_EXTENSIONS.map((ext) => `${projectPath}/**/*.${ext}`);
+    const results = [];
+    for (const pattern of patterns) {
+        const files = await glob(pattern, { ignore: EXCLUDE_DIRS });
+        results.push(...files);
+    }
+    return [...new Set(results)];
+}
+async function fileMatchesPattern(filePath, pattern) {
+    /* v8 ignore next */
+    if (!pattern) {
+        return false;
+    }
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const regex = new RegExp(pattern, 'i');
+        return regex.test(content);
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * For each breaking change, scan the project source files to determine
+ * whether the project is actually impacted (sets impact field).
+ */
+export async function analyzeImpact(projectPath, breakingChanges) {
+    if (breakingChanges.length === 0) {
+        return [];
+    }
+    const sourceFiles = await findSourceFiles(projectPath);
+    const results = await Promise.all(breakingChanges.map(async (bc) => {
+        if (!bc.affectedPattern) {
+            return { ...bc, impact: 'unknown' };
+        }
+        let impacted = false;
+        for (const file of sourceFiles) {
+            if (await fileMatchesPattern(file, bc.affectedPattern)) {
+                impacted = true;
+                break;
+            }
+        }
+        return {
+            ...bc,
+            impact: (impacted ? 'impacted' : 'not_impacted'),
+        };
+    }));
+    return results;
+}
+//# sourceMappingURL=impact-analyzer.js.map

package/dist/engine/upgrade-planner/impact-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-analyzer.js","sourceRoot":"","sources":["../../../src/engine/upgrade-planner/impact-analyzer.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAEpE,MAAM,YAAY,GAAG,CAAC,oBAAoB,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;AAEvF,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,KAAK,UAAU,eAAe,CAAC,WAAmB;IAChD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,WAAW,SAAS,GAAG,EAAE,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAAe;IACjE,oBAAoB;IACpB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,eAAwC;IAExC,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAkC,EAAE;QAC/D,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC;YACxB,OAAO,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,SAAkB,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,MAAM,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;gBACvD,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,CAAC;QACD,OAAO;YACL,GAAG,EAAE;YACL,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAoC;SACpF,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/engine/upgrade-planner/index.d.ts

@@ -0,0 +1,11 @@
+import type { UpgradeBreakingChange, UpgradePlan } from '../../types/index.js';
+/** Estimate effort in hours based on breaking changes impact. */
+export declare function estimateEffort(breakingChanges: UpgradeBreakingChange[]): number;
+/** Build a structured UpgradePlan from parsed/analysed data. */
+export declare function buildUpgradePlan(packageName: string, fromVer: string, toVer: string, breakingChanges: UpgradeBreakingChange[]): UpgradePlan;
+/**
+ * Plan an upgrade for a specific package.
+ * If no changelogText is provided, returns a minimal plan with a warning.
+ */
+export declare function planUpgrade(projectPath: string, packageName: string, fromVersion: string, toVersion: string, changelogText?: string): Promise<UpgradePlan>;
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/upgrade-planner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/upgrade-planner/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAoB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAyCjG,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,eAAe,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAU/E;AAMD,gEAAgE;AAChE,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,qBAAqB,EAAE,GACvC,WAAW,CAmCb;AAMD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,WAAW,CAAC,CAetB"}

package/dist/engine/upgrade-planner/index.js

@@ -0,0 +1,102 @@
+import { parseBreakingChanges } from './breaking-change-parser.js';
+import { analyzeImpact } from './impact-analyzer.js';
+import { parseSemver } from '../stack-auditor/health-scorer.js';
+// ---------------------------------------------------------------------------
+// Risk assessment
+// ---------------------------------------------------------------------------
+function determineRiskLevel(fromVersion, toVersion, breakingChanges) {
+    const from = parseSemver(fromVersion);
+    const to = parseSemver(toVersion);
+    const impactedCount = breakingChanges.filter((bc) => bc.impact === 'impacted').length;
+    if (impactedCount > 0) {
+        return 'breaking';
+    }
+    if (from && to && to.major > from.major) {
+        return 'high';
+    }
+    if (breakingChanges.length > 5) {
+        return 'high';
+    }
+    if (breakingChanges.length > 0) {
+        return 'medium';
+    }
+    if (from && to && to.minor > from.minor) {
+        return 'medium';
+    }
+    return 'low';
+}
+// ---------------------------------------------------------------------------
+// Effort estimation
+// ---------------------------------------------------------------------------
+/** Estimate effort in hours based on breaking changes impact. */
+export function estimateEffort(breakingChanges) {
+    let hours = 0;
+    for (const bc of breakingChanges) {
+        if (bc.impact === 'impacted') {
+            hours += 0.5;
+        }
+        else if (bc.impact === 'unknown') {
+            hours += 0.1;
+        }
+    }
+    return Math.max(0.5, Math.round(hours * 10) / 10);
+}
+// ---------------------------------------------------------------------------
+// Plan builder
+// ---------------------------------------------------------------------------
+/** Build a structured UpgradePlan from parsed/analysed data. */
+export function buildUpgradePlan(packageName, fromVer, toVer, breakingChanges) {
+    const riskLevel = determineRiskLevel(fromVer, toVer, breakingChanges);
+    const estimatedEffortHours = estimateEffort(breakingChanges);
+    const isAutoSafe = riskLevel === 'low' && breakingChanges.length === 0;
+    const steps = [
+        `Update ${packageName} to ${toVer} in package.json`,
+        'Run pnpm install (or npm/yarn install)',
+        'Run full test suite',
+        'Check for TypeScript compilation errors',
+    ];
+    if (breakingChanges.length > 0) {
+        steps.splice(2, 0, `Fix ${breakingChanges.length} breaking change(s) — see list below`);
+    }
+    const testingChecklist = [
+        'Unit tests pass',
+        'Integration tests pass',
+        `Verify ${packageName} API calls work as expected`,
+        'Check for deprecation warnings in logs',
+    ];
+    return {
+        packageName,
+        fromVersion: fromVer,
+        toVersion: toVer,
+        riskLevel,
+        estimatedEffortHours,
+        isAutoSafe,
+        breakingChanges,
+        steps,
+        rollbackProcedure: `Revert ${packageName} to ${fromVer} in package.json and run pnpm install`,
+        testingChecklist,
+    };
+}
+// ---------------------------------------------------------------------------
+// Orchestrator
+// ---------------------------------------------------------------------------
+/**
+ * Plan an upgrade for a specific package.
+ * If no changelogText is provided, returns a minimal plan with a warning.
+ */
+export async function planUpgrade(projectPath, packageName, fromVersion, toVersion, changelogText) {
+    if (!changelogText) {
+        return buildUpgradePlan(packageName, fromVersion, toVersion, [
+            {
+                description: 'No changelog provided — manual review required before upgrading',
+                affectedPattern: '',
+                migrationAction: 'Consult the official changelog or release notes',
+                impact: 'unknown',
+            },
+        ]);
+    }
+    const rawBreakingChanges = parseBreakingChanges(changelogText, fromVersion, toVersion);
+    const analyzed = await analyzeImpact(projectPath, rawBreakingChanges);
+    return buildUpgradePlan(packageName, fromVersion, toVersion, analyzed);
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/upgrade-planner/index.js.map

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

package/dist/engine/validator/analyzer.d.ts

@@ -0,0 +1,22 @@
+import type { Spec, AuditFinding, CodeState } from '../../types/index.js';
+/**
+ * Scan the project directory to build a CodeState for the given spec.
+ */
+export declare function scanCodeForSpec(spec: Spec, projectPath: string): Promise<CodeState>;
+/**
+ * Check whether a single criterion is satisfied in the given code state.
+ */
+export declare function checkCriterion(criterion: string, projectPath: string, codeState: CodeState): Promise<boolean>;
+/**
+ * Classify the severity of a missing criterion based on its content.
+ */
+export declare function classifyDriftSeverity(criterion: string): 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Run lightweight quality checks on a single file and return any findings.
+ */
+export declare function quickQualityCheck(file: string, projectPath: string): Promise<AuditFinding[]>;
+/**
+ * Check if scope and difficulty rating are consistent with each other.
+ */
+export declare function validateScopeDifficulty(scope: string, difficulty: number): boolean;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/engine/validator/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../../src/engine/validator/analyzer.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE1E;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CA6CzF;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,OAAO,CAAC,CAmElB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAY/F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CA8EzB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAalF"}