forgepm 0.7.0

package/dist/src/pm/pdca.d.ts

@@ -0,0 +1,27 @@
+import type { PdcaPhase, ModelTier, Result } from '../core/types.js';
+export interface PdcaState {
+    taskId: string;
+    currentPhase: PdcaPhase;
+    iteration: number;
+    maxRetries: number;
+    modelTier: ModelTier;
+    escalationCount: number;
+    failures: PdcaFailure[];
+}
+export interface PdcaFailure {
+    iteration: number;
+    phase: PdcaPhase;
+    reason: string;
+    modelUsed: ModelTier;
+    timestamp: string;
+}
+export type FailureType = 'reasoning' | 'prompt' | 'task_definition' | 'unknown';
+export declare class PdcaTracker {
+    private states;
+    startTask(taskId: string, complexity: number, maxRetries?: number): PdcaState;
+    recordFailure(taskId: string, reason: string, failureType: FailureType): Result<PdcaState>;
+    completeTask(taskId: string): Result<PdcaState>;
+    getState(taskId: string): PdcaState | undefined;
+    shouldEscalateModel(state: PdcaState): boolean;
+    private nextModelTier;
+}

package/dist/src/pm/pdca.js

@@ -0,0 +1,83 @@
+import { getModelTier } from '../core/types.js';
+const PHASE_ORDER = ['plan', 'do', 'check', 'act', 'done'];
+export class PdcaTracker {
+    states = new Map();
+    startTask(taskId, complexity, maxRetries = 3) {
+        const state = {
+            taskId,
+            currentPhase: 'plan',
+            iteration: 0,
+            maxRetries,
+            modelTier: getModelTier(complexity),
+            escalationCount: 0,
+            failures: [],
+        };
+        this.states.set(taskId, state);
+        return { ...state };
+    }
+    recordFailure(taskId, reason, failureType) {
+        const state = this.states.get(taskId);
+        if (!state) {
+            return { ok: false, error: 'Task not found', hint: `No PDCA state for taskId: ${taskId}` };
+        }
+        const failure = {
+            iteration: state.iteration,
+            phase: state.currentPhase,
+            reason,
+            modelUsed: state.modelTier,
+            timestamp: new Date().toISOString(),
+        };
+        state.failures.push(failure);
+        state.iteration += 1;
+        if (failureType === 'reasoning') {
+            if (this.shouldEscalateModel(state)) {
+                const next = this.nextModelTier(state.modelTier);
+                if (next === null) {
+                    // Already at opus — no higher model available, escalate to human
+                    state.currentPhase = 'escalated';
+                }
+                else {
+                    state.modelTier = next;
+                    state.escalationCount += 1;
+                    // Reset to plan phase on model escalation
+                    state.currentPhase = 'plan';
+                }
+            }
+            else if (state.iteration >= state.maxRetries && state.modelTier === 'opus') {
+                state.currentPhase = 'escalated';
+            }
+        }
+        else {
+            // 'prompt' or 'task_definition' or 'unknown' — no model escalation
+            if (state.iteration >= state.maxRetries) {
+                state.currentPhase = 'escalated';
+            }
+        }
+        return { ok: true, value: { ...state } };
+    }
+    completeTask(taskId) {
+        const state = this.states.get(taskId);
+        if (!state) {
+            return { ok: false, error: 'Task not found', hint: `No PDCA state for taskId: ${taskId}` };
+        }
+        state.currentPhase = 'done';
+        return { ok: true, value: { ...state } };
+    }
+    getState(taskId) {
+        const state = this.states.get(taskId);
+        return state ? { ...state } : undefined;
+    }
+    shouldEscalateModel(state) {
+        // Count reasoning failures for the current model tier
+        const reasoningFailuresForCurrentModel = state.failures.filter((f) => f.modelUsed === state.modelTier).length;
+        return reasoningFailuresForCurrentModel >= 2;
+    }
+    nextModelTier(current) {
+        if (current === 'haiku')
+            return 'sonnet';
+        if (current === 'sonnet')
+            return 'opus';
+        return null; // opus → needs human
+    }
+}
+//# sourceMappingURL=pdca.js.map

package/dist/src/pm/pdca.js.map

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

package/dist/src/pm/recall.d.ts

@@ -0,0 +1,23 @@
+import type { OverlayStore } from '../core/store.js';
+export interface RecallResult {
+    id: string;
+    type: 'task' | 'story' | 'epic' | 'session' | 'pdca' | 'lesson';
+    title: string;
+    excerpt: string;
+    relevanceScore: number;
+    status?: string;
+    created_at: string;
+    metadata?: Record<string, unknown>;
+}
+export interface RecallParams {
+    query: string;
+    entityTypes?: Array<'task' | 'story' | 'epic' | 'session' | 'pdca' | 'lesson'>;
+    statusFilter?: string;
+    limit?: number;
+}
+export declare class RecallEngine {
+    private store;
+    constructor(store: OverlayStore);
+    search(params: RecallParams): RecallResult[];
+    private buildQueries;
+}

package/dist/src/pm/recall.js

@@ -0,0 +1,126 @@
+const PER_ENTITY_LIMIT = 100;
+export class RecallEngine {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    search(params) {
+        const { query, entityTypes, statusFilter, limit = 10 } = params;
+        if (!query.trim())
+            return [];
+        const pattern = `%${query.replace(/%/g, '\\%').replace(/_/g, '\\_')}%`;
+        const now = new Date();
+        const types = entityTypes ?? ['task', 'story', 'epic', 'session', 'pdca', 'lesson'];
+        const queries = this.buildQueries(types, pattern, statusFilter);
+        const results = [];
+        for (const eq of queries) {
+            const rows = this.store.query(eq.sql, eq.params);
+            for (const row of rows) {
+                const r = eq.mapRow(row);
+                r.relevanceScore = scoreResult(query, [r.title, r.excerpt], r.created_at, now, r.status);
+                results.push(r);
+            }
+        }
+        results.sort((a, b) => b.relevanceScore - a.relevanceScore);
+        return results.slice(0, Math.min(limit, 50));
+    }
+    buildQueries(types, pattern, statusFilter) {
+        const queries = [];
+        const esc = `ESCAPE '\\'`;
+        const lim = `LIMIT ${PER_ENTITY_LIMIT}`;
+        if (types.includes('task')) {
+            const where = statusFilter
+                ? `(title LIKE ? ${esc} OR description LIKE ? ${esc} OR why LIKE ? ${esc} OR last_failure_reason LIKE ? ${esc}) AND status = ?`
+                : `(title LIKE ? ${esc} OR description LIKE ? ${esc} OR why LIKE ? ${esc} OR last_failure_reason LIKE ? ${esc})`;
+            const params = statusFilter ? [pattern, pattern, pattern, pattern, statusFilter] : [pattern, pattern, pattern, pattern];
+            queries.push({
+                type: 'task',
+                sql: `SELECT id, title, description, why, status, complexity, last_failure_reason, created_at FROM tasks WHERE ${where} ${lim}`,
+                params,
+                mapRow: (r) => ({
+                    id: r.id, type: 'task', title: r.title,
+                    excerpt: truncate([r.description, r.why, r.last_failure_reason].filter(Boolean).join(' — ')),
+                    relevanceScore: 0, status: r.status, created_at: r.created_at,
+                    metadata: { complexity: r.complexity },
+                }),
+            });
+        }
+        if (types.includes('story')) {
+            queries.push({
+                type: 'story',
+                sql: `SELECT id, title, user_story, why, status, created_at FROM stories WHERE title LIKE ? ${esc} OR user_story LIKE ? ${esc} OR why LIKE ? ${esc} ${lim}`,
+                params: [pattern, pattern, pattern],
+                mapRow: (r) => ({
+                    id: r.id, type: 'story', title: r.title,
+                    excerpt: truncate([r.user_story, r.why].filter(Boolean).join(' — ')),
+                    relevanceScore: 0, status: r.status, created_at: r.created_at,
+                }),
+            });
+        }
+        if (types.includes('epic')) {
+            queries.push({
+                type: 'epic',
+                sql: `SELECT id, title, description, why, status, created_at FROM epics WHERE title LIKE ? ${esc} OR description LIKE ? ${esc} OR why LIKE ? ${esc} ${lim}`,
+                params: [pattern, pattern, pattern],
+                mapRow: (r) => ({
+                    id: r.id, type: 'epic', title: r.title,
+                    excerpt: truncate([r.description, r.why].filter(Boolean).join(' — ')),
+                    relevanceScore: 0, status: r.status, created_at: r.created_at,
+                }),
+            });
+        }
+        if (types.includes('session')) {
+            queries.push({
+                type: 'session',
+                sql: `SELECT id, goal, status, started_at FROM sessions WHERE goal LIKE ? ${esc} ${lim}`,
+                params: [pattern],
+                mapRow: (r) => ({
+                    id: r.id, type: 'session', title: r.goal ?? 'Session',
+                    excerpt: truncate(r.goal ?? ''),
+                    relevanceScore: 0, status: r.status, created_at: r.started_at,
+                }),
+            });
+        }
+        if (types.includes('pdca')) {
+            queries.push({
+                type: 'pdca',
+                sql: `SELECT id, task_id, iteration, phase, model_used, failure_reason, outcome, timestamp FROM pdca_iterations WHERE failure_reason LIKE ? ${esc} OR outcome LIKE ? ${esc} ${lim}`,
+                params: [pattern, pattern],
+                mapRow: (r) => ({
+                    id: `PDCA-${r.id}`, type: 'pdca', title: `PDCA ${r.task_id} iter ${r.iteration}`,
+                    excerpt: truncate([r.failure_reason, r.outcome].filter(Boolean).join(' — ')),
+                    relevanceScore: 0, created_at: r.timestamp,
+                    metadata: { task_id: r.task_id, phase: r.phase, model_used: r.model_used },
+                }),
+            });
+        }
+        if (types.includes('lesson')) {
+            queries.push({
+                type: 'lesson',
+                sql: `SELECT id, source, entity_id, failure_type, description, action, created_at FROM lessons_learned WHERE description LIKE ? ${esc} OR action LIKE ? ${esc} ${lim}`,
+                params: [pattern, pattern],
+                mapRow: (r) => ({
+                    id: `LESSON-${r.id}`, type: 'lesson', title: `Lesson from ${r.source}: ${r.entity_id}`,
+                    excerpt: truncate([r.description, r.action].filter(Boolean).join(' — ')),
+                    relevanceScore: 0, created_at: r.created_at,
+                    metadata: { source: r.source, failure_type: r.failure_type },
+                }),
+            });
+        }
+        return queries;
+    }
+}
+function scoreResult(query, fields, timestamp, now, status) {
+    const terms = query.toLowerCase().split(/\s+/).filter(t => t.length > 0);
+    const text = fields.filter(Boolean).join(' ').toLowerCase();
+    const tfScore = terms.length > 0 ? terms.filter(t => text.includes(t)).length / terms.length : 0;
+    const ageMs = Math.max(0, now.getTime() - new Date(timestamp).getTime());
+    const recencyScore = Math.exp(-ageMs / (1000 * 60 * 60 * 24 * 30));
+    const statusBoostMap = { in_progress: 0.3, done: 0.1 };
+    const statusBoost = statusBoostMap[status ?? ''] ?? 0;
+    return tfScore * 0.6 + recencyScore * 0.3 + statusBoost * 0.1;
+}
+function truncate(text, max = 200) {
+    return text.length > max ? text.slice(0, max) + '...' : text;
+}
+//# sourceMappingURL=recall.js.map

package/dist/src/pm/recall.js.map

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

package/dist/src/pm/retrospective.d.ts

@@ -0,0 +1,35 @@
+import type { OverlayStore } from '../core/store.js';
+import type { EvmHealth } from '../core/types.js';
+export interface RetroReport {
+    session_id: string;
+    goal: string;
+    progress: {
+        done: number;
+        total: number;
+        percent: number;
+    };
+    evm: {
+        spi: number;
+        cpi: number;
+        health: EvmHealth;
+    };
+    tokens: {
+        spent: number;
+        budget: number;
+        percent: number;
+    };
+    velocity: number;
+    lessons: Array<{
+        source: string;
+        description: string;
+    }>;
+    went_well: string[];
+    recommendations: string[];
+}
+export declare class RetrospectiveEngine {
+    private store;
+    constructor(store: OverlayStore);
+    generate(sessionId?: string): RetroReport | null;
+    formatMarkdown(report: RetroReport): string;
+    private loadCalibration;
+}

package/dist/src/pm/retrospective.js

@@ -0,0 +1,104 @@
+import { EvmEngine } from './evm.js';
+import { CalibrationEngine } from './calibration.js';
+export class RetrospectiveEngine {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    generate(sessionId) {
+        // Find session
+        const session = sessionId
+            ? this.store.query('SELECT id, goal, token_budget, tokens_spent, velocity_points FROM sessions WHERE id = ?', [sessionId])[0]
+            : this.store.query('SELECT id, goal, token_budget, tokens_spent, velocity_points FROM sessions ORDER BY started_at DESC LIMIT 1')[0];
+        if (!session)
+            return null;
+        // Get session tasks
+        const taskIds = this.store.query('SELECT task_id FROM session_tasks WHERE session_id = ?', [session.id]);
+        const tasks = taskIds.length > 0
+            ? this.store.query(`SELECT id, status, complexity, model_tier FROM tasks WHERE id IN (${taskIds.map(() => '?').join(',')})`, taskIds.map(t => t.task_id))
+            : [];
+        const done = tasks.filter(t => t.status === 'done').length;
+        const total = tasks.length;
+        // EVM metrics
+        const calibration = this.loadCalibration();
+        const evm = new EvmEngine(calibration);
+        const evmTasks = tasks.map(t => {
+            const metrics = this.store.query('SELECT planned_tokens, actual_tokens FROM evm_metrics WHERE task_id = ?', [t.id])[0];
+            return {
+                taskId: t.id, complexity: t.complexity,
+                plannedTokens: metrics?.planned_tokens ?? calibration.getEstimate(t.complexity),
+                actualTokens: metrics?.actual_tokens ?? 0, status: t.status,
+            };
+        });
+        const evmMetrics = evm.calculateMetrics(evmTasks);
+        // Lessons from this session's tasks
+        const lessons = tasks.length > 0
+            ? this.store.query(`SELECT source, description FROM lessons_learned WHERE entity_id IN (${tasks.map(() => '?').join(',')}) ORDER BY created_at DESC LIMIT 50`, tasks.map(t => t.id))
+            : [];
+        // What went well
+        const wentWell = [];
+        if (done > 0)
+            wentWell.push(`${done} task${done > 1 ? 's' : ''} completed`);
+        if (evmMetrics.cpi >= 1.0)
+            wentWell.push('Under budget (CPI >= 1.0)');
+        if (evmMetrics.spi >= 1.0)
+            wentWell.push('On schedule (SPI >= 1.0)');
+        const escalatedCount = tasks.filter(t => t.status === 'blocked').length;
+        if (escalatedCount === 0 && total > 0)
+            wentWell.push('No escalations needed');
+        // Recommendations
+        const recommendations = [];
+        if (evmMetrics.cpi < 0.85)
+            recommendations.push('CPI below 0.85 — review token estimates for high-complexity tasks');
+        if (evmMetrics.spi < 0.85)
+            recommendations.push('SPI below 0.85 — consider reducing scope or splitting tasks');
+        if (escalatedCount > 0)
+            recommendations.push(`${escalatedCount} task(s) blocked — review escalation patterns`);
+        const highComplexity = tasks.filter(t => t.complexity >= 7).length;
+        if (highComplexity > 2)
+            recommendations.push(`${highComplexity} high-complexity tasks — consider decomposition`);
+        if (recommendations.length === 0)
+            recommendations.push('Session healthy — continue current approach');
+        const budget = session.token_budget ?? 0;
+        const spent = session.tokens_spent ?? 0;
+        return {
+            session_id: session.id,
+            goal: session.goal ?? 'No goal set',
+            progress: { done, total, percent: total === 0 ? 0 : Math.round((done / total) * 100) },
+            evm: { spi: Math.round(evmMetrics.spi * 100) / 100, cpi: Math.round(evmMetrics.cpi * 100) / 100, health: evmMetrics.health },
+            tokens: { spent, budget, percent: budget === 0 ? 0 : Math.round((spent / budget) * 100) },
+            velocity: session.velocity_points ?? 0,
+            lessons,
+            went_well: wentWell,
+            recommendations,
+        };
+    }
+    formatMarkdown(report) {
+        const lines = [
+            `## Retrospective: ${report.goal}`,
+            `### Progress: ${report.progress.done}/${report.progress.total} tasks (${report.progress.percent}%)`,
+            `### EVM: SPI ${report.evm.spi} | CPI ${report.evm.cpi} | Health: ${report.evm.health}`,
+            `### Token Budget: ${report.tokens.spent}/${report.tokens.budget} (${report.tokens.percent}% used)`,
+            `### Velocity: ${report.velocity} points`,
+        ];
+        if (report.went_well.length > 0) {
+            lines.push('### What Went Well:');
+            for (const item of report.went_well)
+                lines.push(`  - ${item}`);
+        }
+        if (report.lessons.length > 0) {
+            lines.push('### Lessons Learned:');
+            for (const l of report.lessons)
+                lines.push(`  - [${l.source}] ${l.description}`);
+        }
+        lines.push('### Recommendations:');
+        for (const r of report.recommendations)
+            lines.push(`  - ${r}`);
+        return lines.join('\n');
+    }
+    loadCalibration() {
+        const rows = this.store.query('SELECT complexity_score, avg_tokens, sample_count FROM calibration ORDER BY complexity_score');
+        return new CalibrationEngine(rows.length > 0 ? rows : undefined);
+    }
+}
+//# sourceMappingURL=retrospective.js.map

package/dist/src/pm/retrospective.js.map

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

package/dist/src/pm/sessions.d.ts

@@ -0,0 +1,36 @@
+export interface Session {
+    id: string;
+    goal: string;
+    tokenBudget: number;
+    tokensSpent: number;
+    taskIds: string[];
+    status: 'active' | 'completed';
+    startedAt: string;
+    completedAt?: string;
+    velocityPoints: number;
+}
+export interface SessionSummary {
+    id: string;
+    goal: string;
+    tasksCompleted: number;
+    tasksTotal: number;
+    tokensSpent: number;
+    tokenBudget: number;
+    tokensRemaining: number;
+    velocityPoints: number;
+    percentComplete: number;
+}
+export declare class SessionManager {
+    private currentSession;
+    private sessionCounter;
+    private completedTasks;
+    startSession(goal: string, tokenBudget: number): Session;
+    getCurrentSession(): Session | null;
+    addTask(taskId: string): void;
+    recordTokens(_taskId: string, tokens: number): void;
+    recordTaskCompletion(taskId: string, complexity: number): void;
+    getSummary(): SessionSummary | null;
+    endSession(): SessionSummary;
+    isOverBudget(): boolean;
+    autoStart(goal: string, defaultBudget: number): Session;
+}

package/dist/src/pm/sessions.js

@@ -0,0 +1,91 @@
+export class SessionManager {
+    currentSession = null;
+    sessionCounter = 0;
+    completedTasks = new Set();
+    startSession(goal, tokenBudget) {
+        this.sessionCounter += 1;
+        const id = `SESSION-${String(this.sessionCounter).padStart(3, '0')}`;
+        this.currentSession = {
+            id,
+            goal,
+            tokenBudget,
+            tokensSpent: 0,
+            taskIds: [],
+            status: 'active',
+            startedAt: new Date().toISOString(),
+            velocityPoints: 0,
+        };
+        this.completedTasks = new Set();
+        return { ...this.currentSession };
+    }
+    getCurrentSession() {
+        return this.currentSession ? { ...this.currentSession } : null;
+    }
+    addTask(taskId) {
+        if (!this.currentSession || this.currentSession.status !== 'active') {
+            throw new Error('No active session. Call startSession first.');
+        }
+        if (!this.currentSession.taskIds.includes(taskId)) {
+            this.currentSession.taskIds.push(taskId);
+        }
+    }
+    recordTokens(_taskId, tokens) {
+        if (!this.currentSession) {
+            throw new Error('No active session.');
+        }
+        this.currentSession.tokensSpent += tokens;
+    }
+    recordTaskCompletion(taskId, complexity) {
+        if (!this.currentSession) {
+            throw new Error('No active session.');
+        }
+        if (!this.completedTasks.has(taskId)) {
+            this.completedTasks.add(taskId);
+            this.currentSession.velocityPoints += complexity;
+        }
+    }
+    getSummary() {
+        if (!this.currentSession)
+            return null;
+        const s = this.currentSession;
+        const tasksTotal = s.taskIds.length;
+        const tasksCompleted = this.completedTasks.size;
+        const percentComplete = tasksTotal === 0 ? 0 : (tasksCompleted / tasksTotal) * 100;
+        return {
+            id: s.id,
+            goal: s.goal,
+            tasksCompleted,
+            tasksTotal,
+            tokensSpent: s.tokensSpent,
+            tokenBudget: s.tokenBudget,
+            tokensRemaining: s.tokenBudget - s.tokensSpent,
+            velocityPoints: s.velocityPoints,
+            percentComplete,
+        };
+    }
+    endSession() {
+        if (!this.currentSession) {
+            throw new Error('No active session to end.');
+        }
+        this.currentSession.status = 'completed';
+        this.currentSession.completedAt = new Date().toISOString();
+        const summary = this.getSummary();
+        if (!summary) {
+            throw new Error('Failed to generate summary.');
+        }
+        this.currentSession = null;
+        return summary;
+    }
+    isOverBudget() {
+        if (!this.currentSession)
+            return false;
+        return this.currentSession.tokensSpent > this.currentSession.tokenBudget;
+    }
+    autoStart(goal, defaultBudget) {
+        if (!this.currentSession || this.currentSession.status !== 'active') {
+            return this.startSession(goal, defaultBudget);
+        }
+        return { ...this.currentSession };
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/src/pm/sessions.js.map

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

package/dist/src/pm/tolerances.d.ts

@@ -0,0 +1,21 @@
+import type { TolerancePreset, ToleranceStatus } from '../core/types.js';
+export interface ToleranceConfig {
+    dimension: string;
+    target: number;
+    upperBound: number;
+    unit: string;
+}
+export interface ToleranceCheckResult {
+    dimension: string;
+    actual: number;
+    target: number;
+    upperBound: number;
+    status: ToleranceStatus;
+    percentUsed: number;
+}
+export declare const TOLERANCE_PRESETS: Record<TolerancePreset, ToleranceConfig[]>;
+export declare class ToleranceChecker {
+    check(planned: number, actual: number, config: ToleranceConfig): ToleranceCheckResult;
+    getPreset(preset: TolerancePreset): ToleranceConfig[];
+    checkTask(plannedTokens: number, actualTokens: number, preset: TolerancePreset): ToleranceCheckResult[];
+}

package/dist/src/pm/tolerances.js

@@ -0,0 +1,54 @@
+// Presets based on PM best practices (PRINCE2 Manage by Exception)
+export const TOLERANCE_PRESETS = {
+    'new-feature': [
+        { dimension: 'cost', target: 1.0, upperBound: 1.2, unit: 'ratio' }, // ±20%
+        { dimension: 'token_headroom', target: 1.0, upperBound: 1.25, unit: 'ratio' }, // ±25%
+    ],
+    'bug-fix': [
+        { dimension: 'cost', target: 1.0, upperBound: 1.05, unit: 'ratio' }, // ±5%
+        { dimension: 'token_headroom', target: 1.0, upperBound: 1.1, unit: 'ratio' }, // ±10%
+    ],
+    'refactor': [
+        { dimension: 'cost', target: 1.0, upperBound: 1.1, unit: 'ratio' }, // ±10%
+        { dimension: 'token_headroom', target: 1.0, upperBound: 1.3, unit: 'ratio' }, // ±30%
+    ],
+    'spike': [
+        { dimension: 'cost', target: 1.0, upperBound: 1.5, unit: 'ratio' }, // ±50%
+        { dimension: 'token_headroom', target: 1.0, upperBound: 2.0, unit: 'ratio' }, // ±100%
+    ],
+};
+export class ToleranceChecker {
+    check(planned, actual, config) {
+        // Calculate ratio = actual / planned
+        const ratio = planned === 0 ? 1.0 : actual / planned;
+        // percentUsed = ratio / upperBound as percentage
+        const percentUsed = config.upperBound === 0 ? 100 : (ratio / config.upperBound) * 100;
+        // at_risk: > 90% of upper bound; breached: > upper bound
+        let status;
+        if (ratio > config.upperBound) {
+            status = 'breached';
+        }
+        else if (ratio > config.upperBound * 0.9) {
+            status = 'at_risk';
+        }
+        else {
+            status = 'on_track';
+        }
+        return {
+            dimension: config.dimension,
+            actual: ratio,
+            target: config.target,
+            upperBound: config.upperBound,
+            status,
+            percentUsed,
+        };
+    }
+    getPreset(preset) {
+        return TOLERANCE_PRESETS[preset];
+    }
+    checkTask(plannedTokens, actualTokens, preset) {
+        const configs = this.getPreset(preset);
+        return configs.map((config) => this.check(plannedTokens, actualTokens, config));
+    }
+}
+//# sourceMappingURL=tolerances.js.map

package/dist/src/pm/tolerances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tolerances.js","sourceRoot":"","sources":["../../../src/pm/tolerances.ts"],"names":[],"mappings":"AAkBA,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAA+C;IAC3E,aAAa,EAAE;QACb,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAG,OAAO;QAC5E,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO;KACvF;IACD,SAAS,EAAE;QACT,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAG,MAAM;QAC5E,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAI,OAAO;KACxF;IACD,UAAU,EAAE;QACV,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAI,OAAO;QAC7E,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAI,OAAO;KACxF;IACD,OAAO,EAAE;QACP,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAI,OAAO;QAC7E,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAI,QAAQ;KACzF;CACF,CAAC;AAEF,MAAM,OAAO,gBAAgB;IAC3B,KAAK,CAAC,OAAe,EAAE,MAAc,EAAE,MAAuB;QAC5D,qCAAqC;QACrC,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC;QAErD,iDAAiD;QACjD,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC;QAEtF,yDAAyD;QACzD,IAAI,MAAuB,CAAC;QAC5B,IAAI,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;YAC9B,MAAM,GAAG,UAAU,CAAC;QACtB,CAAC;aAAM,IAAI,KAAK,GAAG,MAAM,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;YAC3C,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,UAAU,CAAC;QACtB,CAAC;QAED,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM;YACN,WAAW;SACZ,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,MAAuB;QAC/B,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,CACP,aAAqB,EACrB,YAAoB,EACpB,MAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAClF,CAAC;CACF"}