principles-disciple 1.7.5 → 1.7.8

package/dist/core/trajectory.d.ts

@@ -89,7 +89,9 @@ export interface TrajectorySessionInput {
     sessionId: string;
     startedAt?: string;
 }
-export interface EvolutionTaskInput {
+export type TaskKind = 'pain_diagnosis' | 'sleep_reflection' | 'model_eval';
+export type TaskPriority = 'high' | 'medium' | 'low';
+interface EvolutionTaskInputBase {
     taskId: string;
     traceId: string;
     source: string;
@@ -103,6 +105,16 @@ export interface EvolutionTaskInput {
     createdAt?: string;
     updatedAt?: string;
 }
+interface EvolutionTaskInputV2 extends EvolutionTaskInputBase {
+    taskKind?: TaskKind;
+    priority?: TaskPriority;
+    retryCount?: number;
+    maxRetries?: number;
+    lastError?: string | null;
+    resultRef?: string | null;
+}
+export type EvolutionTaskInput = EvolutionTaskInputV2;
+export { EvolutionTaskInputV2 };
 export interface EvolutionEventInput {
     traceId: string;
     taskId?: string | null;
@@ -127,6 +139,12 @@ export interface EvolutionTaskRecord {
     resolution: string | null;
     createdAt: string;
     updatedAt: string;
+    taskKind: TaskKind | null;
+    priority: TaskPriority | null;
+    retryCount: number | null;
+    maxRetries: number | null;
+    lastError: string | null;
+    resultRef: string | null;
 }
 export interface EvolutionEventRecord {
     id: number;
@@ -205,12 +223,36 @@ export declare class TrajectoryDatabase {
     recordEvolutionTask(input: EvolutionTaskInput): void;
     updateEvolutionTask(taskId: string, updates: Partial<Omit<EvolutionTaskInput, 'taskId' | 'traceId' | 'source'>>): void;
     recordEvolutionEvent(input: EvolutionEventInput): void;
+    /**
+     * List evolution tasks with optional filtering.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     listEvolutionTasks(filters?: EvolutionTaskFilters): EvolutionTaskRecord[];
+    /**
+     * List evolution events for a trace or globally.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     listEvolutionEvents(traceId?: string, filters?: {
         limit?: number;
         offset?: number;
     }): EvolutionEventRecord[];
+    /**
+     * Get evolution task by trace ID.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     getEvolutionTaskByTraceId(traceId: string): EvolutionTaskRecord | null;
+    /**
+     * Get evolution task statistics.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     getEvolutionStats(): {
         total: number;
         pending: number;
@@ -218,14 +260,120 @@ export declare class TrajectoryDatabase {
         completed: number;
         failed: number;
     };
+    /**
+     * List recent sessions from the trajectory database.
+     *
+     * Returns: Recent session records ordered by most recently updated.
+     *
+     * @param options.limit - Maximum number of sessions to return (default: 20)
+     * @param options.dateFrom - Only return sessions updated after this date
+     * @param options.dateTo - Only return sessions updated before this date
+     */
+    listRecentSessions(options?: {
+        limit?: number;
+        dateFrom?: string;
+        dateTo?: string;
+    }): Array<{
+        sessionId: string;
+        startedAt: string;
+        updatedAt: string;
+    }>;
+    /**
+     * List assistant turns for a session.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     listAssistantTurns(sessionId: string): AssistantTurnRecord[];
+    /**
+     * List tool calls for a session.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
+    listToolCallsForSession(sessionId: string): Array<{
+        id: number;
+        toolName: string;
+        outcome: string;
+        filePath: string | null;
+        durationMs: number | null;
+        exitCode: number | null;
+        errorType: string | null;
+        errorMessage: string | null;
+        gfiBefore: number | null;
+        gfiAfter: number | null;
+        createdAt: string;
+    }>;
+    /**
+     * List pain events for a session.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
+    listPainEventsForSession(sessionId: string): Array<{
+        id: number;
+        source: string;
+        score: number;
+        reason: string | null;
+        severity: string | null;
+        origin: string | null;
+        confidence: number | null;
+        createdAt: string;
+    }>;
+    /**
+     * List user turns for a session.
+     * Returns sanitized/reduced fields for nocturnal use — NO raw text.
+     */
+    listUserTurnsForSession(sessionId: string): Array<{
+        id: number;
+        turnIndex: number;
+        correctionDetected: boolean;
+        correctionCue: string | null;
+        createdAt: string;
+    }>;
+    /**
+     * List correction samples with optional review status filter.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     listCorrectionSamples(status?: CorrectionSampleReviewStatus): CorrectionSampleRecord[];
+    /**
+     * List gate blocks for a session.
+     * Returns minimal fields for nocturnal use — no raw text.
+     */
+    listGateBlocksForSession(sessionId: string): Array<{
+        id: number;
+        toolName: string;
+        filePath: string | null;
+        reason: string;
+        planStatus: string | null;
+        createdAt: string;
+    }>;
     reviewCorrectionSample(sampleId: string, status: Exclude<CorrectionSampleReviewStatus, 'pending'>, note?: string): CorrectionSampleRecord;
+    /**
+     * Export correction samples to JSONL file.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     exportCorrections(opts: {
         mode: CorrectionExportMode;
         approvedOnly: boolean;
     }): TrajectoryExportResult;
+    /**
+     * Export analytics data to JSON file.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     exportAnalytics(): TrajectoryExportResult;
+    /**
+     * Get trajectory database statistics.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     getDataStats(): TrajectoryDataStats;
     cleanupBlobStorage(): {
         removedFiles: number;
@@ -234,6 +382,12 @@ export declare class TrajectoryDatabase {
     private initSchema;
     private importLegacyArtifacts;
     private migrateSchema;
+    /**
+     * Get daily metrics for analytics.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     private dailyMetrics;
     private importLegacySessions;
     private importLegacyEvents;

package/dist/core/trajectory.js

@@ -4,6 +4,16 @@ import path from 'path';
 import crypto from 'crypto';
 import { withLock } from '../utils/file-lock.js';
 import { resolvePdPath } from './paths.js';
+import { SampleNotFoundError } from '../config/index.js';
+/**
+ * Trajectory database stores HISTORICAL and ANALYTICS data.
+ *
+ * PURPOSE: Track task outcomes, trust changes, and evolution progress over time.
+ * USAGE: Insights, trends, and Phase 3 supporting evidence (where explicitly allowed).
+ * NOT FOR: Control decisions, Phase 3 eligibility, or real-time operations.
+ *
+ * Runtime truth comes from: queue state, workspace trust scorecard, active sessions
+ */
 const DEFAULT_INLINE_THRESHOLD = 16 * 1024;
 const DEFAULT_BUSY_TIMEOUT_MS = 5000;
 const DEFAULT_ORPHAN_BLOB_GRACE_DAYS = 7;
@@ -105,6 +115,9 @@ export class TrajectoryDatabase {
     recordToolCall(input) {
         this.recordSession({ sessionId: input.sessionId, startedAt: input.createdAt });
         const createdAt = input.createdAt ?? nowIso();
+        // Extract filePath from paramsJson if provided and is an object with filePath
+        const paramsObj = input.paramsJson;
+        const filePath = paramsObj && typeof paramsObj.filePath === 'string' ? paramsObj.filePath : null;
         const rowId = this.withWrite(() => {
             const result = this.db.prepare(`
         INSERT INTO tool_calls (
@@ -163,23 +176,34 @@ export class TrajectoryDatabase {
     }
     recordEvolutionTask(input) {
         const now = nowIso();
+        // Cast to V2 to access new fields
+        const v2 = input;
         this.withWrite(() => {
             this.db.prepare(`
         INSERT INTO evolution_tasks (
           task_id, trace_id, source, reason, score, status,
-          enqueued_at, started_at, completed_at, resolution, created_at, updated_at
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+          enqueued_at, started_at, completed_at, resolution, created_at, updated_at,
+          task_kind, priority, retry_count, max_retries, last_error, result_ref
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
         ON CONFLICT(task_id) DO UPDATE SET
           status = excluded.status,
           started_at = excluded.started_at,
           completed_at = excluded.completed_at,
           resolution = excluded.resolution,
-          updated_at = excluded.updated_at
-      `).run(input.taskId, input.traceId, input.source, input.reason ?? null, input.score ?? 0, input.status ?? 'pending', input.enqueuedAt ?? null, input.startedAt ?? null, input.completedAt ?? null, input.resolution ?? null, input.createdAt ?? now, input.updatedAt ?? now);
+          updated_at = excluded.updated_at,
+          task_kind = excluded.task_kind,
+          priority = excluded.priority,
+          retry_count = excluded.retry_count,
+          max_retries = excluded.max_retries,
+          last_error = excluded.last_error,
+          result_ref = excluded.result_ref
+      `).run(input.taskId, input.traceId, input.source, input.reason ?? null, input.score ?? 0, input.status ?? 'pending', input.enqueuedAt ?? null, input.startedAt ?? null, input.completedAt ?? null, input.resolution ?? null, input.createdAt ?? now, input.updatedAt ?? now, v2.taskKind ?? null, v2.priority ?? null, v2.retryCount ?? null, v2.maxRetries ?? null, v2.lastError ?? null, v2.resultRef ?? null);
         });
     }
     updateEvolutionTask(taskId, updates) {
         const now = nowIso();
+        // Cast to V2 to access new fields
+        const v2Updates = updates;
         this.withWrite(() => {
             const setClauses = ['updated_at = ?'];
             const values = [now];
@@ -203,6 +227,31 @@ export class TrajectoryDatabase {
                 setClauses.push('score = ?');
                 values.push(updates.score);
             }
+            // V2 fields
+            if (v2Updates.taskKind !== undefined) {
+                setClauses.push('task_kind = ?');
+                values.push(v2Updates.taskKind);
+            }
+            if (v2Updates.priority !== undefined) {
+                setClauses.push('priority = ?');
+                values.push(v2Updates.priority);
+            }
+            if (v2Updates.retryCount !== undefined) {
+                setClauses.push('retry_count = ?');
+                values.push(v2Updates.retryCount);
+            }
+            if (v2Updates.maxRetries !== undefined) {
+                setClauses.push('max_retries = ?');
+                values.push(v2Updates.maxRetries);
+            }
+            if (v2Updates.lastError !== undefined) {
+                setClauses.push('last_error = ?');
+                values.push(v2Updates.lastError);
+            }
+            if (v2Updates.resultRef !== undefined) {
+                setClauses.push('result_ref = ?');
+                values.push(v2Updates.resultRef);
+            }
             values.push(taskId);
             this.db.prepare(`
         UPDATE evolution_tasks SET ${setClauses.join(', ')} WHERE task_id = ?
@@ -217,6 +266,12 @@ export class TrajectoryDatabase {
       `).run(input.traceId, input.taskId ?? null, input.stage, input.level ?? 'info', input.message, input.summary ?? null, safeJson(input.metadata), input.createdAt ?? nowIso());
         });
     }
+    /**
+     * List evolution tasks with optional filtering.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     listEvolutionTasks(filters = {}) {
         const conditions = [];
         const values = [];
@@ -237,7 +292,8 @@ export class TrajectoryDatabase {
         const offset = filters.offset ?? 0;
         const rows = this.db.prepare(`
       SELECT id, task_id, trace_id, source, reason, score, status,
-             enqueued_at, started_at, completed_at, resolution, created_at, updated_at
+             enqueued_at, started_at, completed_at, resolution, created_at, updated_at,
+             task_kind, priority, retry_count, max_retries, last_error, result_ref
       FROM evolution_tasks
       ${whereClause}
       ORDER BY created_at DESC
@@ -257,8 +313,20 @@ export class TrajectoryDatabase {
             resolution: row.resolution ? String(row.resolution) : null,
             createdAt: String(row.created_at),
             updatedAt: String(row.updated_at),
+            taskKind: row.task_kind ? row.task_kind : null,
+            priority: row.priority ? row.priority : null,
+            retryCount: row.retry_count != null ? Number(row.retry_count) : null,
+            maxRetries: row.max_retries != null ? Number(row.max_retries) : null,
+            lastError: row.last_error ? String(row.last_error) : null,
+            resultRef: row.result_ref ? String(row.result_ref) : null,
         }));
     }
+    /**
+     * List evolution events for a trace or globally.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     listEvolutionEvents(traceId, filters = {}) {
         const limit = filters.limit ?? 100;
         const offset = filters.offset ?? 0;
@@ -292,10 +360,17 @@ export class TrajectoryDatabase {
             createdAt: String(row.created_at),
         }));
     }
+    /**
+     * Get evolution task by trace ID.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     getEvolutionTaskByTraceId(traceId) {
         const row = this.db.prepare(`
       SELECT id, task_id, trace_id, source, reason, score, status,
-             enqueued_at, started_at, completed_at, resolution, created_at, updated_at
+             enqueued_at, started_at, completed_at, resolution, created_at, updated_at,
+             task_kind, priority, retry_count, max_retries, last_error, result_ref
       FROM evolution_tasks
       WHERE trace_id = ?
       LIMIT 1
@@ -316,8 +391,20 @@ export class TrajectoryDatabase {
             resolution: row.resolution ? String(row.resolution) : null,
             createdAt: String(row.created_at),
             updatedAt: String(row.updated_at),
+            taskKind: row.task_kind ? row.task_kind : null,
+            priority: row.priority ? row.priority : null,
+            retryCount: row.retry_count != null ? Number(row.retry_count) : null,
+            maxRetries: row.max_retries != null ? Number(row.max_retries) : null,
+            lastError: row.last_error ? String(row.last_error) : null,
+            resultRef: row.result_ref ? String(row.result_ref) : null,
         };
     }
+    /**
+     * Get evolution task statistics.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     getEvolutionStats() {
         const rows = this.db.prepare(`
       SELECT status, COUNT(*) as count FROM evolution_tasks GROUP BY status
@@ -336,6 +423,47 @@ export class TrajectoryDatabase {
         }
         return stats;
     }
+    /**
+     * List recent sessions from the trajectory database.
+     *
+     * Returns: Recent session records ordered by most recently updated.
+     *
+     * @param options.limit - Maximum number of sessions to return (default: 20)
+     * @param options.dateFrom - Only return sessions updated after this date
+     * @param options.dateTo - Only return sessions updated before this date
+     */
+    listRecentSessions(options = {}) {
+        const conditions = [];
+        const values = [];
+        if (options.dateFrom) {
+            conditions.push('updated_at >= ?');
+            values.push(options.dateFrom);
+        }
+        if (options.dateTo) {
+            conditions.push('updated_at <= ?');
+            values.push(options.dateTo);
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limit = options.limit ?? 20;
+        const rows = this.db.prepare(`
+      SELECT session_id, started_at, updated_at
+      FROM sessions
+      ${whereClause}
+      ORDER BY updated_at DESC
+      LIMIT ?
+    `).all(...values, limit);
+        return rows.map((row) => ({
+            sessionId: String(row.session_id),
+            startedAt: String(row.started_at),
+            updatedAt: String(row.updated_at),
+        }));
+    }
+    /**
+     * List assistant turns for a session.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     listAssistantTurns(sessionId) {
         const rows = this.db.prepare(`
       SELECT id, session_id, run_id, provider, model, raw_text, sanitized_text, blob_ref, created_at
@@ -355,6 +483,98 @@ export class TrajectoryDatabase {
             createdAt: String(row.created_at),
         }));
     }
+    /**
+     * List tool calls for a session.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
+    listToolCallsForSession(sessionId) {
+        const rows = this.db.prepare(`
+      SELECT id, tool_name, outcome, params_json, duration_ms, exit_code, error_type, error_message,
+             gfi_before, gfi_after, created_at
+      FROM tool_calls
+      WHERE session_id = ?
+      ORDER BY id ASC
+    `).all(sessionId);
+        return rows.map((row) => {
+            // Extract filePath from params_json if present
+            let filePath = null;
+            if (row.params_json && typeof row.params_json === 'string') {
+                try {
+                    const params = JSON.parse(row.params_json);
+                    if (params && typeof params.filePath === 'string') {
+                        filePath = params.filePath;
+                    }
+                }
+                catch {
+                    // Ignore malformed JSON
+                }
+            }
+            return {
+                id: Number(row.id),
+                toolName: String(row.tool_name),
+                outcome: String(row.outcome),
+                filePath,
+                durationMs: row.duration_ms != null ? Number(row.duration_ms) : null,
+                exitCode: row.exit_code != null ? Number(row.exit_code) : null,
+                errorType: row.error_type ? String(row.error_type) : null,
+                errorMessage: row.error_message ? String(row.error_message) : null,
+                gfiBefore: row.gfi_before != null ? Number(row.gfi_before) : null,
+                gfiAfter: row.gfi_after != null ? Number(row.gfi_after) : null,
+                createdAt: String(row.created_at),
+            };
+        });
+    }
+    /**
+     * List pain events for a session.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
+    listPainEventsForSession(sessionId) {
+        const rows = this.db.prepare(`
+      SELECT id, source, score, reason, severity, origin, confidence, created_at
+      FROM pain_events
+      WHERE session_id = ?
+      ORDER BY created_at ASC
+    `).all(sessionId);
+        return rows.map((row) => ({
+            id: Number(row.id),
+            source: String(row.source),
+            score: Number(row.score),
+            reason: row.reason ? String(row.reason) : null,
+            severity: row.severity ? String(row.severity) : null,
+            origin: row.origin ? String(row.origin) : null,
+            confidence: row.confidence != null ? Number(row.confidence) : null,
+            createdAt: String(row.created_at),
+        }));
+    }
+    /**
+     * List user turns for a session.
+     * Returns sanitized/reduced fields for nocturnal use — NO raw text.
+     */
+    listUserTurnsForSession(sessionId) {
+        const rows = this.db.prepare(`
+      SELECT id, turn_index, correction_detected, correction_cue, created_at
+      FROM user_turns
+      WHERE session_id = ?
+      ORDER BY turn_index ASC
+    `).all(sessionId);
+        return rows.map((row) => ({
+            id: Number(row.id),
+            turnIndex: Number(row.turn_index),
+            correctionDetected: Boolean(row.correction_detected),
+            correctionCue: row.correction_cue ? String(row.correction_cue) : null,
+            createdAt: String(row.created_at),
+        }));
+    }
+    /**
+     * List correction samples with optional review status filter.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     listCorrectionSamples(status = 'pending') {
         const rows = this.db.prepare(`
       SELECT sample_id, session_id, bad_assistant_turn_id, user_correction_turn_id,
@@ -379,6 +599,26 @@ export class TrajectoryDatabase {
             updatedAt: String(row.updated_at),
         }));
     }
+    /**
+     * List gate blocks for a session.
+     * Returns minimal fields for nocturnal use — no raw text.
+     */
+    listGateBlocksForSession(sessionId) {
+        const rows = this.db.prepare(`
+      SELECT id, tool_name, file_path, reason, plan_status, created_at
+      FROM gate_blocks
+      WHERE session_id = ?
+      ORDER BY id ASC
+    `).all(sessionId);
+        return rows.map((row) => ({
+            id: Number(row.id),
+            toolName: String(row.tool_name),
+            filePath: row.file_path ? String(row.file_path) : null,
+            reason: String(row.reason),
+            planStatus: row.plan_status ? String(row.plan_status) : null,
+            createdAt: String(row.created_at),
+        }));
+    }
     reviewCorrectionSample(sampleId, status, note) {
         const updatedAt = nowIso();
         const updated = this.withWrite(() => {
@@ -397,7 +637,7 @@ export class TrajectoryDatabase {
             return true;
         });
         if (!updated) {
-            throw new Error(`Correction sample not found: ${sampleId}`);
+            throw new SampleNotFoundError(sampleId);
         }
         const record = this.db.prepare(`
       SELECT sample_id, session_id, bad_assistant_turn_id, user_correction_turn_id,
@@ -407,7 +647,7 @@ export class TrajectoryDatabase {
       WHERE sample_id = ?
     `).get(sampleId);
         if (!record) {
-            throw new Error(`Correction sample not found after review update: ${sampleId}`);
+            throw new SampleNotFoundError(`${sampleId} (after update)`);
         }
         return {
             sampleId: String(record.sample_id),
@@ -424,6 +664,12 @@ export class TrajectoryDatabase {
             updatedAt: String(record.updated_at),
         };
     }
+    /**
+     * Export correction samples to JSONL file.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     exportCorrections(opts) {
         const rows = this.db.prepare(`
       SELECT cs.sample_id, cs.session_id, cs.recovery_tool_span_json, cs.diff_excerpt, cs.quality_score,
@@ -462,6 +708,12 @@ export class TrajectoryDatabase {
         this.recordExportAudit('corrections', opts.mode, opts.approvedOnly, exportPath, rows.length);
         return { filePath: exportPath, count: rows.length, mode: opts.mode };
     }
+    /**
+     * Export analytics data to JSON file.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     exportAnalytics() {
         const payload = {
             generatedAt: nowIso(),
@@ -476,6 +728,12 @@ export class TrajectoryDatabase {
         this.recordExportAudit('analytics', 'raw', true, exportPath, Array.isArray(payload.dailyMetrics) ? payload.dailyMetrics.length : 0);
         return { filePath: exportPath, count: Array.isArray(payload.dailyMetrics) ? payload.dailyMetrics.length : 0 };
     }
+    /**
+     * Get trajectory database statistics.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     getDataStats() {
         const getCount = (table, where) => {
             const sql = where ? `SELECT COUNT(*) as count FROM ${table} WHERE ${where}` : `SELECT COUNT(*) as count FROM ${table}`;
@@ -658,6 +916,26 @@ export class TrajectoryDatabase {
         metadata_json TEXT,
         created_at TEXT NOT NULL
       );
+    `);
+        // V2 migration: Add V2 columns to evolution_tasks if they don't exist
+        // SQLite does not support IF NOT EXISTS for ADD COLUMN, so we must check manually
+        // before each ALTER to avoid "duplicate column name" errors on existing DBs
+        const v2Columns = [
+            { name: 'task_kind', type: 'TEXT' },
+            { name: 'priority', type: 'TEXT' },
+            { name: 'retry_count', type: 'INTEGER' },
+            { name: 'max_retries', type: 'INTEGER' },
+            { name: 'last_error', type: 'TEXT' },
+            { name: 'result_ref', type: 'TEXT' },
+        ];
+        for (const col of v2Columns) {
+            const exists = this.db.prepare(`PRAGMA table_info(evolution_tasks)`).all()
+                .some((row) => row.name === col.name);
+            if (!exists) {
+                this.db.exec(`ALTER TABLE evolution_tasks ADD COLUMN ${col.name} ${col.type}`);
+            }
+        }
+        this.db.exec(`
       CREATE VIEW IF NOT EXISTS v_error_clusters AS
       SELECT tool_name, COALESCE(error_type, 'unknown') AS error_type, COUNT(*) AS occurrences
       FROM tool_calls
@@ -729,6 +1007,12 @@ export class TrajectoryDatabase {
       LEFT JOIN correction_daily ON correction_daily.day = tool_daily.day;
     `);
     }
+    /**
+     * Get daily metrics for analytics.
+     *
+     * Returns: Analytics data aggregated from trajectory database.
+     * Not: Runtime truth or real-time queue state.
+     */
     dailyMetrics() {
         return this.db.prepare('SELECT * FROM v_daily_metrics ORDER BY day ASC').all();
     }

package/dist/core/workspace-context.d.ts

@@ -2,7 +2,6 @@ import { PD_FILES } from './paths.js';
 import { PainConfig } from './config.js';
 import { EventLog } from './event-log.js';
 import { PainDictionary } from './dictionary.js';
-import { TrustEngine } from './trust-engine.js';
 import { HygieneTracker } from './hygiene/tracker.js';
 import { EvolutionReducerImpl } from './evolution-reducer.js';
 import { TrajectoryDatabase } from './trajectory.js';
@@ -18,7 +17,6 @@ export declare class WorkspaceContext {
     private _config?;
     private _eventLog?;
     private _dictionary?;
-    private _trust?;
     private _hygiene?;
     private _evolutionReducer?;
     private _trajectory?;
@@ -35,10 +33,6 @@ export declare class WorkspaceContext {
      * Pain dictionary service for this workspace.
      */
     get dictionary(): PainDictionary;
-    /**
-     * Trust engine service bound to this workspace.
-     */
-    get trust(): TrustEngine;
     /**
      * Hygiene tracking service for this workspace.
      */