forgepm 0.7.0

package/dist/src/mcp/tool-handlers.js

@@ -0,0 +1,123 @@
+import { getModelTier } from '../core/types.js';
+import { RecallEngine } from '../pm/recall.js';
+import { RetrospectiveEngine } from '../pm/retrospective.js';
+function jsonResult(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+function errorResult(error, hint) {
+    return { content: [{ type: 'text', text: JSON.stringify({ error, hint }, null, 2) }], isError: true };
+}
+export function handleStatus(forge, includeInternal) {
+    return jsonResult(forge.getStatus(includeInternal ?? false));
+}
+export function handleStart(forge, taskId, complexity) {
+    const result = forge.startTask(taskId, complexity);
+    if (!result.ok)
+        return errorResult(result.error, result.hint);
+    return jsonResult({ ...result.value, next_action: `Work on ${taskId}. Call forge_done when complete.` });
+}
+export function handleDone(forge, taskId, actualTokens, inputTokens, outputTokens, notes) {
+    let tokens;
+    let tokenSource;
+    if (inputTokens !== undefined && outputTokens !== undefined) {
+        tokens = inputTokens + outputTokens;
+        tokenSource = 'reported';
+    }
+    else if (actualTokens !== undefined) {
+        tokens = actualTokens;
+        tokenSource = 'reported';
+    }
+    else {
+        const rows = forge.store.query('SELECT complexity FROM tasks WHERE id = ?', [taskId]);
+        tokens = forge.calibration.getEstimate(rows[0]?.complexity ?? 3);
+        tokenSource = 'estimated';
+    }
+    forge.store.run('UPDATE tasks SET token_source = ? WHERE id = ?', [tokenSource, taskId]);
+    const result = forge.completeTask(taskId, tokens);
+    if (!result.ok)
+        return errorResult(result.error, result.hint);
+    return jsonResult({ ...result.value, token_source: tokenSource, next_action: 'Call forge_status to see next task.' });
+}
+export function handleSession(forge, action, goal, tokenBudget) {
+    if (action === 'start') {
+        if (!goal)
+            return errorResult('goal is required for action=start');
+        return jsonResult(forge.sessions.startSession(goal, tokenBudget ?? 100_000));
+    }
+    if (action === 'end') {
+        try {
+            return jsonResult(forge.sessions.endSession());
+        }
+        catch (err) {
+            return errorResult(err instanceof Error ? err.message : String(err));
+        }
+    }
+    return jsonResult(forge.sessions.getSummary() ?? { status: 'no active session' });
+}
+export function handleEscalate(forge, taskId, reason, failureType) {
+    const result = forge.failTask(taskId, reason, failureType ?? 'unknown');
+    if (!result.ok)
+        return errorResult(result.error, result.hint);
+    const { escalated, newModel } = result.value;
+    return jsonResult({
+        taskId, reason, escalated, newModel,
+        options: escalated
+            ? ['Break task into smaller subtasks', 'Request human review', 'Adjust acceptance criteria']
+            : [`Retry with model: ${newModel ?? 'current'}`, 'Refine approach and retry'],
+        next_action: escalated ? 'Task blocked — human intervention required.' : `Retry ${taskId} with adjusted approach.`,
+    });
+}
+export function handleCreate(forge, type, title, complexity, why, storyId, dependsOn) {
+    const prefixMap = { task: 'TASK', story: 'STORY', epic: 'EPIC' };
+    const prefix = prefixMap[type] ?? 'TASK';
+    const id = forge.store.nextId(prefix);
+    const now = new Date().toISOString();
+    if (type === 'task') {
+        const comp = complexity ?? 3;
+        insertTask(forge, id, title, comp, why, storyId, dependsOn, now);
+    }
+    else if (type === 'story') {
+        forge.store.run('INSERT INTO stories (id, title, why, status, created_at) VALUES (?, ?, ?, ?, ?)', [id, title, why ?? '', 'backlog', now]);
+    }
+    else {
+        forge.store.run('INSERT INTO epics (id, title, why, status, created_at) VALUES (?, ?, ?, ?, ?)', [id, title, why ?? '', 'open', now]);
+    }
+    return jsonResult({ id, type, title, complexity: type === 'task' ? (complexity ?? 3) : undefined, why, status: type === 'epic' ? 'open' : 'backlog' });
+}
+function insertTask(forge, id, title, comp, why, storyId, dependsOn, now) {
+    const ts = now ?? new Date().toISOString();
+    forge.store.run(`INSERT INTO tasks (id, title, why, complexity, model_tier, story_id, depends_on, status, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, 'backlog', ?, ?)`, [id, title, why ?? '', comp, getModelTier(comp), storyId ?? '', JSON.stringify(dependsOn ?? []), ts, ts]);
+    forge.store.run('INSERT OR IGNORE INTO evm_metrics (task_id, planned_tokens, actual_tokens, updated_at) VALUES (?, ?, 0, ?)', [id, forge.calibration.getEstimate(comp), ts]);
+}
+export function handleRecall(forge, query, entityTypes, statusFilter, limit, includeFailures) {
+    const engine = new RecallEngine(forge.store);
+    // If includeFailures is true and pdca not already in entityTypes, add it
+    let types = entityTypes;
+    if (includeFailures && types && !types.includes('pdca')) {
+        types = [...types, 'pdca'];
+    }
+    const results = engine.search({ query, entityTypes: types, statusFilter, limit });
+    return jsonResult({
+        query, resultCount: results.length, results,
+        next_action: results.length > 0 ? 'Use these insights to inform your current task.' : 'No matching results found.',
+    });
+}
+export function handleRetro(forge, sessionId, format) {
+    const engine = new RetrospectiveEngine(forge.store);
+    const report = engine.generate(sessionId);
+    if (!report)
+        return errorResult('No session found', sessionId ? `No session with id ${sessionId}` : 'No sessions in database');
+    if (format === 'markdown')
+        return jsonResult({ markdown: engine.formatMarkdown(report) });
+    return jsonResult({ ...report, next_action: 'Review lessons and apply recommendations to next session.' });
+}
+export function handleDecompose(_forge, description, maxComplexity, _maxTasks) {
+    return jsonResult({
+        action: 'agent_decompose',
+        description,
+        maxComplexity: maxComplexity ?? 5,
+        hint: 'Decompose this description into sub-tasks yourself, then call forge_create for each one.',
+        next_action: 'Break the description into concrete tasks and create each with forge_create.',
+    });
+}
+//# sourceMappingURL=tool-handlers.js.map

package/dist/src/mcp/tool-handlers.js.map

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

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

@@ -0,0 +1,13 @@
+export interface CalibrationEntry {
+    complexity_score: number;
+    avg_tokens: number;
+    sample_count: number;
+}
+export declare const DEFAULT_CALIBRATION: CalibrationEntry[];
+export declare class CalibrationEngine {
+    private data;
+    constructor(seedData?: CalibrationEntry[]);
+    getEstimate(complexity: number): number;
+    update(complexity: number, actualTokens: number): CalibrationEntry;
+    getAll(): CalibrationEntry[];
+}

package/dist/src/pm/calibration.js

@@ -0,0 +1,56 @@
+const ALPHA = 0.3; // smoothing factor
+export const DEFAULT_CALIBRATION = [
+    { complexity_score: 1, avg_tokens: 300, sample_count: 0 },
+    { complexity_score: 2, avg_tokens: 500, sample_count: 0 },
+    { complexity_score: 3, avg_tokens: 800, sample_count: 0 },
+    { complexity_score: 4, avg_tokens: 1200, sample_count: 0 },
+    { complexity_score: 5, avg_tokens: 1800, sample_count: 0 },
+    { complexity_score: 6, avg_tokens: 2500, sample_count: 0 },
+    { complexity_score: 7, avg_tokens: 3500, sample_count: 0 },
+    { complexity_score: 8, avg_tokens: 5000, sample_count: 0 },
+    { complexity_score: 9, avg_tokens: 7000, sample_count: 0 },
+    { complexity_score: 10, avg_tokens: 10000, sample_count: 0 },
+];
+export class CalibrationEngine {
+    data;
+    constructor(seedData) {
+        this.data = new Map();
+        const seed = seedData ?? DEFAULT_CALIBRATION;
+        for (const entry of seed) {
+            this.data.set(entry.complexity_score, { ...entry });
+        }
+    }
+    getEstimate(complexity) {
+        const clamped = Math.max(1, Math.min(10, Math.round(complexity)));
+        const entry = this.data.get(clamped);
+        return entry?.avg_tokens ?? 1800; // fallback to complexity 5 default
+    }
+    update(complexity, actualTokens) {
+        const clamped = Math.max(1, Math.min(10, Math.round(complexity)));
+        const existing = this.data.get(clamped);
+        if (existing) {
+            const newAvg = ALPHA * actualTokens + (1 - ALPHA) * existing.avg_tokens;
+            const updated = {
+                complexity_score: clamped,
+                avg_tokens: newAvg,
+                sample_count: existing.sample_count + 1,
+            };
+            this.data.set(clamped, updated);
+            return updated;
+        }
+        else {
+            // New entry: no prior average, use actual as starting point
+            const entry = {
+                complexity_score: clamped,
+                avg_tokens: actualTokens,
+                sample_count: 1,
+            };
+            this.data.set(clamped, entry);
+            return entry;
+        }
+    }
+    getAll() {
+        return Array.from(this.data.values()).sort((a, b) => a.complexity_score - b.complexity_score);
+    }
+}
+//# sourceMappingURL=calibration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calibration.js","sourceRoot":"","sources":["../../../src/pm/calibration.ts"],"names":[],"mappings":"AAAA,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,mBAAmB;AAQtC,MAAM,CAAC,MAAM,mBAAmB,GAAuB;IACrD,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE;IACzD,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE;IACzD,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE;IACzD,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE;IAC1D,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE;IAC1D,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE;IAC1D,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE;IAC1D,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE;IAC1D,EAAE,gBAAgB,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE;IAC1D,EAAE,gBAAgB,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE;CAC7D,CAAC;AAEF,MAAM,OAAO,iBAAiB;IACpB,IAAI,CAAgC;IAE5C,YAAY,QAA6B;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,QAAQ,IAAI,mBAAmB,CAAC;QAC7C,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,WAAW,CAAC,UAAkB;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,KAAK,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC,mCAAmC;IACvE,CAAC;IAED,MAAM,CAAC,UAAkB,EAAE,YAAoB;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAExC,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC;YACxE,MAAM,OAAO,GAAqB;gBAChC,gBAAgB,EAAE,OAAO;gBACzB,UAAU,EAAE,MAAM;gBAClB,YAAY,EAAE,QAAQ,CAAC,YAAY,GAAG,CAAC;aACxC,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAChC,OAAO,OAAO,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,4DAA4D;YAC5D,MAAM,KAAK,GAAqB;gBAC9B,gBAAgB,EAAE,OAAO;gBACzB,UAAU,EAAE,YAAY;gBACxB,YAAY,EAAE,CAAC;aAChB,CAAC;YACF,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACxC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAClD,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,66 @@
+import type { EvmHealth } from '../core/types.js';
+import type { ToleranceCheckResult } from './tolerances.js';
+export interface TaskBrief {
+    id: string;
+    title: string;
+    status: string;
+    complexity: number;
+}
+export interface CallSheet {
+    projectName: string;
+    goal: string;
+    progress: {
+        done: number;
+        total: number;
+        percent: number;
+        bar: string;
+    };
+    tasks: TaskBrief[];
+    nextTask: TaskBrief | null;
+    issues: string[];
+    estimate: string;
+    githubUrl?: string;
+}
+export interface InternalMetrics {
+    spi: number;
+    cpi: number;
+    health: EvmHealth;
+    signal: string;
+    driftAlerts?: Array<{
+        driftType: string;
+        expected: string;
+        actual: string;
+        severity: string;
+    }>;
+}
+export interface RawTaskInput {
+    id: string;
+    title: string;
+    taskStatus: string;
+    complexity: number;
+}
+export interface CallSheetInput {
+    projectName: string;
+    goal: string;
+    tasks: RawTaskInput[];
+    tokensRemaining: number;
+    avgTokensPerMinute: number;
+    toleranceBreaches?: ToleranceCheckResult[];
+    escalations?: string[];
+    blockers?: string[];
+    spi?: number;
+    cpi?: number;
+    health?: EvmHealth;
+    evmSignal?: string;
+    githubUrl?: string;
+}
+export declare class CallSheetGenerator {
+    generateForHuman(data: CallSheetInput): CallSheet;
+    generateForAgent(data: CallSheetInput): CallSheet & {
+        internal: InternalMetrics;
+    };
+    formatProgressBar(percent: number, width?: number): string;
+    formatEstimate(remainingTokens: number, avgTokensPerMinute: number): string;
+    private buildTaskBriefs;
+    private buildIssues;
+}

package/dist/src/pm/callsheet.js

@@ -0,0 +1,91 @@
+function taskStatusEmoji(taskStatus) {
+    switch (taskStatus) {
+        case 'done': return '✅ Done';
+        case 'in_progress': return '🔄 In Progress';
+        case 'blocked': return '🚫 Blocked';
+        default: return '⬚ Todo';
+    }
+}
+export class CallSheetGenerator {
+    generateForHuman(data) {
+        const tasks = this.buildTaskBriefs(data.tasks);
+        const done = data.tasks.filter((t) => t.taskStatus === 'done').length;
+        const total = data.tasks.length;
+        const percent = total === 0 ? 0 : (done / total) * 100;
+        const issues = this.buildIssues(data);
+        const estimate = this.formatEstimate(data.tokensRemaining, data.avgTokensPerMinute);
+        const nextTask = tasks.find((t) => t.status !== '✅ Done') ?? null;
+        return {
+            projectName: data.projectName,
+            goal: data.goal,
+            progress: {
+                done,
+                total,
+                percent,
+                bar: this.formatProgressBar(percent),
+            },
+            tasks,
+            nextTask,
+            issues,
+            estimate,
+            githubUrl: data.githubUrl,
+        };
+    }
+    generateForAgent(data) {
+        const sheet = this.generateForHuman(data);
+        const internal = {
+            spi: data.spi ?? 1.0,
+            cpi: data.cpi ?? 1.0,
+            health: data.health ?? 'GREEN',
+            signal: data.evmSignal ?? 'On track. Continue current approach.',
+        };
+        return { ...sheet, internal };
+    }
+    formatProgressBar(percent, width = 10) {
+        const filled = Math.round((percent / 100) * width);
+        return '█'.repeat(filled) + '░'.repeat(width - filled);
+    }
+    formatEstimate(remainingTokens, avgTokensPerMinute) {
+        if (avgTokensPerMinute <= 0)
+            return 'unknown';
+        const minutes = Math.round(remainingTokens / avgTokensPerMinute);
+        if (minutes < 60)
+            return '~' + minutes + ' min remaining';
+        const hours = Math.floor(minutes / 60);
+        const mins = minutes % 60;
+        return '~' + hours + 'h ' + mins + 'm remaining';
+    }
+    buildTaskBriefs(tasks) {
+        return tasks.map((t) => ({
+            id: t.id,
+            title: t.title,
+            status: taskStatusEmoji(t.taskStatus),
+            complexity: t.complexity,
+        }));
+    }
+    buildIssues(data) {
+        const issues = [];
+        if (data.toleranceBreaches) {
+            for (const breach of data.toleranceBreaches) {
+                if (breach.status === 'breached') {
+                    issues.push(`Tolerance breached on ${breach.dimension}: ${(breach.actual * 100).toFixed(0)}% of limit (limit ${(breach.upperBound * 100).toFixed(0)}%)`);
+                }
+                else if (breach.status === 'at_risk') {
+                    issues.push(`Tolerance at risk on ${breach.dimension}: ${breach.percentUsed.toFixed(0)}% of limit used`);
+                }
+            }
+        }
+        if (data.escalations && data.escalations.length > 0) {
+            for (const taskId of data.escalations) {
+                issues.push(`Task ${taskId} escalated to human: requires manual intervention`);
+            }
+        }
+        if (data.blockers && data.blockers.length > 0) {
+            for (const blocker of data.blockers) {
+                issues.push(`Blocker: ${blocker}`);
+            }
+        }
+        return issues;
+    }
+}
+//# sourceMappingURL=callsheet.js.map

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

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

package/dist/src/pm/drift-detector.d.ts

@@ -0,0 +1,38 @@
+import type { EventPlugin } from '../core/event-plugins.js';
+import type { DomainEvent } from '../core/types.js';
+import type { OverlayStore } from '../core/store.js';
+export interface DriftThresholds {
+    tokenVelocityMultiplier: number;
+    failureStreakMax: number;
+    wipLimit: number;
+    sessionOverrunPercent: number;
+}
+export declare const DEFAULT_DRIFT_THRESHOLDS: DriftThresholds;
+export type DriftType = 'token_velocity' | 'model_mismatch' | 'failure_streak' | 'wip_overflow' | 'session_overrun';
+export interface DriftAlert {
+    taskId: string | null;
+    driftType: DriftType;
+    expected: string;
+    actual: string;
+    severity: 'warning' | 'critical';
+}
+export declare class DriftDetector implements EventPlugin {
+    name: string;
+    private thresholds;
+    private recentAlerts;
+    private rateLimitMs;
+    constructor(thresholds?: Partial<DriftThresholds>);
+    onEvent(event: DomainEvent, store: OverlayStore): void;
+    checkTokenVelocity(taskId: string, store: OverlayStore): DriftAlert[];
+    checkModelMismatch(taskId: string, store: OverlayStore): DriftAlert[];
+    checkFailureStreak(taskId: string, store: OverlayStore): DriftAlert[];
+    checkWipOverflow(store: OverlayStore): DriftAlert[];
+    getRecentAlerts(store: OverlayStore, limit?: number): Array<{
+        type: string;
+        entity_id: string;
+        data: string;
+        timestamp: string;
+    }>;
+    private isRateLimited;
+    private recordAlert;
+}

package/dist/src/pm/drift-detector.js

@@ -0,0 +1,111 @@
+import { getModelTier } from '../core/types.js';
+export const DEFAULT_DRIFT_THRESHOLDS = {
+    tokenVelocityMultiplier: 2.0,
+    failureStreakMax: 3,
+    wipLimit: 3,
+    sessionOverrunPercent: 120,
+};
+export class DriftDetector {
+    name = 'drift-detector';
+    thresholds;
+    recentAlerts = new Map(); // key → timestamp for rate limiting
+    rateLimitMs = 60_000; // 1 minute per (taskId, driftType)
+    constructor(thresholds) {
+        this.thresholds = { ...DEFAULT_DRIFT_THRESHOLDS, ...thresholds };
+    }
+    onEvent(event, store) {
+        const alerts = [];
+        if (event.type === 'task.completed') {
+            alerts.push(...this.checkTokenVelocity(event.taskId, store));
+            alerts.push(...this.checkModelMismatch(event.taskId, store));
+        }
+        if (event.type === 'task.failed') {
+            alerts.push(...this.checkFailureStreak(event.taskId, store));
+        }
+        if (event.type === 'task.started') {
+            alerts.push(...this.checkWipOverflow(store));
+        }
+        for (const alert of alerts) {
+            if (this.isRateLimited(alert))
+                continue;
+            this.recordAlert(alert);
+            store.appendEvent({
+                type: 'agent.drift.detected',
+                taskId: alert.taskId ?? '',
+                driftType: alert.driftType,
+                expected: alert.expected,
+                actual: alert.actual,
+                severity: alert.severity,
+            });
+        }
+    }
+    checkTokenVelocity(taskId, store) {
+        const row = store.query('SELECT planned_tokens, actual_tokens FROM evm_metrics WHERE task_id = ?', [taskId])[0];
+        if (!row || row.planned_tokens === 0)
+            return [];
+        const ratio = row.actual_tokens / row.planned_tokens;
+        if (ratio > this.thresholds.tokenVelocityMultiplier) {
+            return [{
+                    taskId, driftType: 'token_velocity',
+                    expected: `<= ${row.planned_tokens * this.thresholds.tokenVelocityMultiplier}`,
+                    actual: String(row.actual_tokens),
+                    severity: ratio > this.thresholds.tokenVelocityMultiplier * 1.5 ? 'critical' : 'warning',
+                }];
+        }
+        return [];
+    }
+    checkModelMismatch(taskId, store) {
+        const row = store.query('SELECT complexity, model_tier FROM tasks WHERE id = ?', [taskId])[0];
+        if (!row)
+            return [];
+        const expectedTier = getModelTier(row.complexity);
+        if (row.model_tier !== expectedTier) {
+            return [{
+                    taskId, driftType: 'model_mismatch',
+                    expected: expectedTier, actual: row.model_tier,
+                    severity: 'warning',
+                }];
+        }
+        return [];
+    }
+    checkFailureStreak(taskId, store) {
+        const rows = store.query('SELECT failure_reason FROM pdca_iterations WHERE task_id = ? AND failure_reason IS NOT NULL ORDER BY id DESC', [taskId]);
+        if (rows.length >= this.thresholds.failureStreakMax) {
+            return [{
+                    taskId, driftType: 'failure_streak',
+                    expected: `< ${this.thresholds.failureStreakMax} consecutive failures`,
+                    actual: `${rows.length} failures`,
+                    severity: rows.length >= this.thresholds.failureStreakMax * 2 ? 'critical' : 'warning',
+                }];
+        }
+        return [];
+    }
+    checkWipOverflow(store) {
+        const rows = store.query("SELECT COUNT(*) as cnt FROM tasks WHERE status = 'in_progress'");
+        const wip = rows[0]?.cnt ?? 0;
+        if (wip > this.thresholds.wipLimit) {
+            return [{
+                    taskId: null, driftType: 'wip_overflow',
+                    expected: `<= ${this.thresholds.wipLimit}`,
+                    actual: String(wip),
+                    severity: 'warning',
+                }];
+        }
+        return [];
+    }
+    getRecentAlerts(store, limit = 10) {
+        return store.query("SELECT type, entity_id, data, timestamp FROM events WHERE type = 'agent.drift.detected' ORDER BY id DESC LIMIT ?", [limit]);
+    }
+    isRateLimited(alert) {
+        const key = `${alert.taskId ?? 'global'}:${alert.driftType}`;
+        const lastTime = this.recentAlerts.get(key);
+        if (lastTime && Date.now() - lastTime < this.rateLimitMs)
+            return true;
+        return false;
+    }
+    recordAlert(alert) {
+        const key = `${alert.taskId ?? 'global'}:${alert.driftType}`;
+        this.recentAlerts.set(key, Date.now());
+    }
+}
+//# sourceMappingURL=drift-detector.js.map

package/dist/src/pm/drift-detector.js.map

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

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

@@ -0,0 +1,31 @@
+import type { EvmHealth } from '../core/types.js';
+import type { CalibrationEngine } from './calibration.js';
+export interface EvmTaskData {
+    taskId: string;
+    complexity: number;
+    plannedTokens: number;
+    actualTokens: number;
+    status: string;
+}
+export interface EvmMetrics {
+    pv: number;
+    ev: number;
+    ac: number;
+    spi: number;
+    cpi: number;
+    health: EvmHealth;
+    signal: string;
+}
+export declare const EVM_ALERTS: {
+    SPI_GREEN: number;
+    SPI_YELLOW: number;
+    CPI_GREEN: number;
+    CPI_YELLOW: number;
+};
+export declare class EvmEngine {
+    private calibration;
+    constructor(calibration: CalibrationEngine);
+    calculateMetrics(tasks: EvmTaskData[]): EvmMetrics;
+    getTaskPlannedTokens(complexity: number): number;
+    generateSignal(spi: number, cpi: number): string;
+}

package/dist/src/pm/evm.js

@@ -0,0 +1,58 @@
+// Alert thresholds — aligned with calculateMetrics health logic
+export const EVM_ALERTS = {
+    SPI_GREEN: 0.9, // >= 0.9 = GREEN
+    SPI_YELLOW: 0.8, // >= 0.8 = YELLOW
+    CPI_GREEN: 0.85, // >= 0.85 = GREEN
+    CPI_YELLOW: 0.7, // >= 0.7 = YELLOW (below = RED)
+};
+export class EvmEngine {
+    calibration;
+    constructor(calibration) {
+        this.calibration = calibration;
+    }
+    calculateMetrics(tasks) {
+        // PV = sum of plannedTokens for ALL tasks
+        const pv = tasks.reduce((sum, t) => sum + t.plannedTokens, 0);
+        // EV = sum of plannedTokens for DONE tasks only (binary: done=PV, not done=0)
+        const ev = tasks
+            .filter((t) => t.status === 'done')
+            .reduce((sum, t) => sum + t.plannedTokens, 0);
+        // AC = sum of actualTokens for all tasks with actual > 0
+        const ac = tasks
+            .filter((t) => t.actualTokens > 0)
+            .reduce((sum, t) => sum + t.actualTokens, 0);
+        // SPI = EV/PV, handle division by zero → 1.0
+        const spi = pv === 0 ? 1.0 : ev / pv;
+        // CPI = EV/AC, handle division by zero → 1.0
+        const cpi = ac === 0 ? 1.0 : ev / ac;
+        // Health: GREEN if SPI>=0.9 && CPI>=0.85, YELLOW if SPI>=0.8 || CPI>=0.7, RED otherwise
+        let health;
+        if (spi >= 0.9 && cpi >= 0.85) {
+            health = 'GREEN';
+        }
+        else if (spi >= 0.8 || cpi >= 0.7) {
+            health = 'YELLOW';
+        }
+        else {
+            health = 'RED';
+        }
+        const signal = this.generateSignal(spi, cpi);
+        return { pv, ev, ac, spi, cpi, health, signal };
+    }
+    getTaskPlannedTokens(complexity) {
+        return this.calibration.getEstimate(complexity);
+    }
+    generateSignal(spi, cpi) {
+        if (spi >= 0.9 && cpi >= 0.85) {
+            return 'On track. Continue current approach.';
+        }
+        if (spi >= 0.8 && cpi >= 0.85) {
+            return 'Slightly behind schedule. Consider simplifying.';
+        }
+        if (spi >= 0.9 && cpi < 0.85) {
+            return 'Over budget. Simplify approach or reduce scope.';
+        }
+        return 'Critical: falling behind and over budget.';
+    }
+}
+//# sourceMappingURL=evm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evm.js","sourceRoot":"","sources":["../../../src/pm/evm.ts"],"names":[],"mappings":"AAqBA,gEAAgE;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS,EAAE,GAAG,EAAK,iBAAiB;IACpC,UAAU,EAAE,GAAG,EAAI,kBAAkB;IACrC,SAAS,EAAE,IAAI,EAAI,kBAAkB;IACrC,UAAU,EAAE,GAAG,EAAI,gCAAgC;CACpD,CAAC;AAEF,MAAM,OAAO,SAAS;IACA;IAApB,YAAoB,WAA8B;QAA9B,gBAAW,GAAX,WAAW,CAAmB;IAAG,CAAC;IAEtD,gBAAgB,CAAC,KAAoB;QACnC,0CAA0C;QAC1C,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAE9D,8EAA8E;QAC9E,MAAM,EAAE,GAAG,KAAK;aACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;aAClC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAEhD,yDAAyD;QACzD,MAAM,EAAE,GAAG,KAAK;aACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC;aACjC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAE/C,6CAA6C;QAC7C,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;QAErC,6CAA6C;QAC7C,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;QAErC,wFAAwF;QACxF,IAAI,MAAiB,CAAC;QACtB,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAC9B,MAAM,GAAG,OAAO,CAAC;QACnB,CAAC;aAAM,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;YACpC,MAAM,GAAG,QAAQ,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,KAAK,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAE7C,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAClD,CAAC;IAED,oBAAoB,CAAC,UAAkB;QACrC,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAED,cAAc,CAAC,GAAW,EAAE,GAAW;QACrC,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAC9B,OAAO,sCAAsC,CAAC;QAChD,CAAC;QACD,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAC9B,OAAO,iDAAiD,CAAC;QAC3D,CAAC;QACD,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;YAC7B,OAAO,iDAAiD,CAAC;QAC3D,CAAC;QACD,OAAO,2CAA2C,CAAC;IACrD,CAAC;CACF"}