swarm-engine 1.0.0

package/dist/runtime/templates.d.ts

@@ -0,0 +1,77 @@
+import type { ExecutionTrace } from './traces.js';
+export interface TemplateParameter {
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required?: boolean;
+    default?: unknown;
+    enum?: string[];
+    example?: string;
+}
+export interface TemplateAgentOverride {
+    extra_rules?: string[];
+    model?: string;
+    backend?: string;
+    permissionProfile?: string;
+}
+export interface TemplateVerification {
+    name: string;
+    command: string;
+    optional?: boolean;
+}
+export interface TemplateConfig {
+    name: string;
+    description: string;
+    parameters: Record<string, TemplateParameter>;
+    pattern: string;
+    context_files?: string[];
+    agents?: Record<string, TemplateAgentOverride>;
+    verification?: TemplateVerification[];
+    success_criteria?: string[];
+    tags?: string[];
+}
+export declare class TemplateRegistry {
+    private templates;
+    register(config: TemplateConfig): void;
+    get(name: string): TemplateConfig | undefined;
+    list(): TemplateConfig[];
+    /**
+     * Load templates from a directory of .yml/.yaml files.
+     */
+    loadDirectory(dir: string): number;
+    /**
+     * Load templates with resolution chain: project → global → builtins.
+     */
+    loadWithResolution(cwd: string): number;
+    get count(): number;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    resolved: Record<string, unknown>;
+}
+/**
+ * Validate and resolve template parameters.
+ */
+export declare function validateParameters(template: TemplateConfig, provided: Record<string, unknown>): ValidationResult;
+/**
+ * Convert a template + parameters into task prompt and pattern options
+ * that can be passed to engine.runPattern().
+ */
+export declare function resolveTemplate(template: TemplateConfig, params: Record<string, unknown>): {
+    task: string;
+    pattern: string;
+    agentOverrides: Record<string, TemplateAgentOverride>;
+    contextFiles: string[];
+    verification: TemplateVerification[];
+    successCriteria: string[];
+};
+/**
+ * Extract a reusable template from a successful execution trace.
+ * Detects parameters from the task description and builds a template config.
+ */
+export declare function extractTemplateFromTrace(trace: ExecutionTrace, name: string, description?: string): TemplateConfig;
+/**
+ * Save a template to disk as a YAML file.
+ */
+export declare function saveTemplate(template: TemplateConfig, dir: string): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/runtime/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/runtime/templates.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC/C,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA0C;IAE3D,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAItC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,IAAI,IAAI,cAAc,EAAE;IAIxB;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IA2BlC;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAWvC,IAAI,KAAK,IAAI,MAAM,CAElB;CACF;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,gBAAgB,CAqClB;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B;IACD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IACtD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAqCA;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB,cAAc,CAkEhB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO1E"}

package/dist/runtime/templates.js

@@ -0,0 +1,221 @@
+import { existsSync, readFileSync, readdirSync, mkdirSync, writeFileSync } from 'fs';
+import { join, extname } from 'path';
+import { homedir } from 'os';
+import yaml from 'js-yaml';
+import { getBuiltinTemplatesDir } from '../utils/paths.js';
+import { TemplateConfigSchema } from '../utils/schemas.js';
+// ─── Template Registry ────────────────────────────────────────
+export class TemplateRegistry {
+    templates = new Map();
+    register(config) {
+        this.templates.set(config.name, config);
+    }
+    get(name) {
+        return this.templates.get(name);
+    }
+    list() {
+        return [...this.templates.values()];
+    }
+    /**
+     * Load templates from a directory of .yml/.yaml files.
+     */
+    loadDirectory(dir) {
+        if (!existsSync(dir))
+            return 0;
+        let loaded = 0;
+        const files = readdirSync(dir).filter(f => ['.yml', '.yaml'].includes(extname(f)));
+        for (const file of files) {
+            try {
+                const content = readFileSync(join(dir, file), 'utf-8');
+                const parsed = yaml.load(content, { schema: yaml.DEFAULT_SCHEMA });
+                // Validate template against schema (advisory — warns but doesn't block)
+                const validation = TemplateConfigSchema.safeParse(parsed);
+                if (!validation.success) {
+                    const errors = validation.error.issues.map(i => `${i.path.join('.')}: ${i.message}`).join(', ');
+                    console.warn(`Warning: Template ${file}: ${errors}`);
+                }
+                if (parsed && typeof parsed === 'object' && parsed.name) {
+                    this.register(parsed);
+                    loaded++;
+                }
+            }
+            catch {
+                console.warn(`Warning: Failed to load template ${file}`);
+            }
+        }
+        return loaded;
+    }
+    /**
+     * Load templates with resolution chain: project → global → builtins.
+     */
+    loadWithResolution(cwd) {
+        let loaded = 0;
+        // Project templates (highest priority)
+        loaded += this.loadDirectory(join(cwd, '.swarm', 'templates'));
+        // Global templates
+        loaded += this.loadDirectory(join(homedir(), '.swarm', 'templates'));
+        // Built-in templates
+        loaded += this.loadDirectory(getBuiltinTemplatesDir());
+        return loaded;
+    }
+    get count() {
+        return this.templates.size;
+    }
+}
+/**
+ * Validate and resolve template parameters.
+ */
+export function validateParameters(template, provided) {
+    const errors = [];
+    const resolved = {};
+    for (const [key, spec] of Object.entries(template.parameters)) {
+        const value = provided[key];
+        if (value === undefined || value === null || value === '') {
+            if (spec.required !== false && spec.default === undefined) {
+                errors.push(`Missing required parameter: ${key} — ${spec.description}`);
+                continue;
+            }
+            resolved[key] = spec.default;
+            continue;
+        }
+        // Type validation
+        if (spec.type === 'number' && typeof value !== 'number') {
+            const parsed = Number(value);
+            if (isNaN(parsed)) {
+                errors.push(`Parameter ${key} must be a number`);
+                continue;
+            }
+            resolved[key] = parsed;
+        }
+        else if (spec.type === 'boolean' && typeof value !== 'boolean') {
+            resolved[key] = value === 'true' || value === '1' || value === 'yes';
+        }
+        else {
+            resolved[key] = value;
+        }
+        // Enum validation
+        if (spec.enum && !spec.enum.includes(String(resolved[key]))) {
+            errors.push(`Parameter ${key} must be one of: ${spec.enum.join(', ')}`);
+        }
+    }
+    return { valid: errors.length === 0, errors, resolved };
+}
+// ─── Template → Orchestration Conversion ──────────────────────
+/**
+ * Convert a template + parameters into task prompt and pattern options
+ * that can be passed to engine.runPattern().
+ */
+export function resolveTemplate(template, params) {
+    // Build the task prompt from template description + parameters
+    const paramLines = Object.entries(params)
+        .filter(([, v]) => v !== undefined && v !== null)
+        .map(([k, v]) => `- ${k}: ${v}`)
+        .join('\n');
+    // Substitute ${param} in success criteria and agent rules
+    const substitute = (text) => {
+        let result = text;
+        for (const [key, value] of Object.entries(params)) {
+            const placeholder = '${' + key + '}';
+            result = result.split(placeholder).join(String(value));
+        }
+        return result;
+    };
+    const task = `## Template: ${template.name}\n${template.description}\n\n## Parameters\n${paramLines}`;
+    const agentOverrides = {};
+    if (template.agents) {
+        for (const [agent, override] of Object.entries(template.agents)) {
+            agentOverrides[agent] = {
+                ...override,
+                extra_rules: override.extra_rules?.map(substitute),
+            };
+        }
+    }
+    return {
+        task,
+        pattern: template.pattern,
+        agentOverrides,
+        contextFiles: template.context_files ?? [],
+        verification: template.verification ?? [],
+        successCriteria: (template.success_criteria ?? []).map(substitute),
+    };
+}
+// ─── Trace → Template Extraction ──────────────────────────────
+/**
+ * Extract a reusable template from a successful execution trace.
+ * Detects parameters from the task description and builds a template config.
+ */
+export function extractTemplateFromTrace(trace, name, description) {
+    // Detect potential parameters from the task
+    // Look for quoted strings, file paths, specific values that vary between runs
+    const detectedParams = {};
+    // Extract quoted strings as potential parameters
+    const quotedStrings = trace.task.match(/"([^"]+)"|'([^']+)'/g);
+    if (quotedStrings) {
+        for (let i = 0; i < quotedStrings.length; i++) {
+            const value = quotedStrings[i].replace(/["']/g, '');
+            const key = `param${i + 1}`;
+            detectedParams[key] = {
+                type: 'string',
+                description: `Detected from task: "${value}"`,
+                required: true,
+                example: value,
+            };
+        }
+    }
+    // Extract file paths as potential scope parameters
+    const filePaths = trace.task.match(/(?:[\w./]+\.(?:ts|js|py|go|rs|java|rb|md))/g);
+    if (filePaths && filePaths.length > 0) {
+        detectedParams['target_file'] = {
+            type: 'string',
+            description: 'Target file or directory',
+            required: false,
+            example: filePaths[0],
+        };
+    }
+    // Build agent overrides from trace phase data
+    const agentOverrides = {};
+    for (const phase of trace.phases) {
+        // If a phase used specific agents, capture their type
+        if (phase.confidence === 'high') {
+            // This was a successful agent config — worth preserving
+        }
+    }
+    // Build context_files from files mentioned in reflections
+    const contextFiles = [];
+    for (const reflection of trace.reflections) {
+        const paths = reflection.match(/(?:[\w./]+\/[\w./]+\.(?:ts|js|py|go|rs))/g);
+        if (paths)
+            contextFiles.push(...paths);
+    }
+    // Build verification from the pattern
+    const verification = [];
+    // Auto-detect based on what we know about the project
+    // These would ideally come from the verifier's detected commands
+    return {
+        name,
+        description: description ?? `Template extracted from: ${trace.task.slice(0, 80)}`,
+        parameters: detectedParams,
+        pattern: trace.pattern,
+        context_files: [...new Set(contextFiles)].slice(0, 10),
+        agents: Object.keys(agentOverrides).length > 0 ? agentOverrides : undefined,
+        verification: verification.length > 0 ? verification : undefined,
+        success_criteria: [
+            `Orchestration completes successfully using ${trace.pattern} pattern`,
+            `All verification checks pass`,
+        ],
+        tags: [trace.pattern, 'auto-extracted'],
+    };
+}
+/**
+ * Save a template to disk as a YAML file.
+ */
+export function saveTemplate(template, dir) {
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const safeName = template.name.replace(/[^a-zA-Z0-9._-]/g, '-');
+    const filePath = join(dir, `${safeName}.yml`);
+    const content = yaml.dump(template, { lineWidth: 120, noRefs: true });
+    writeFileSync(filePath, content);
+    return filePath;
+}
+//# sourceMappingURL=templates.js.map

package/dist/runtime/templates.js.map

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

package/dist/runtime/traces.d.ts

@@ -0,0 +1,60 @@
+export interface ExecutionTrace {
+    id?: number;
+    orchestrationId: string;
+    task: string;
+    pattern: string;
+    status: 'completed' | 'failed' | 'cancelled';
+    totalTokens: number;
+    costUsd: number;
+    durationMs: number;
+    phaseCount: number;
+    agentCount: number;
+    phases: TracePhase[];
+    reflections: string[];
+    createdAt?: string;
+}
+export interface TracePhase {
+    name: string;
+    status: string;
+    agentCount: number;
+    tokens: number;
+    durationMs: number;
+    confidence: string;
+}
+export declare class TraceStore {
+    private db;
+    constructor(dbPath?: string);
+    private initSchema;
+    /** Store a completed orchestration trace */
+    store(trace: ExecutionTrace): number;
+    /** Find similar past traces using FTS5 */
+    findSimilar(task: string, limit?: number): ExecutionTrace[];
+    /** Get most recent traces regardless of pattern */
+    getRecent(limit?: number): ExecutionTrace[];
+    /** Get traces by pattern */
+    getByPattern(pattern: string, limit?: number): ExecutionTrace[];
+    /** Get success rate for a pattern */
+    getPatternSuccessRate(pattern: string): {
+        total: number;
+        succeeded: number;
+        rate: number;
+    };
+    /** Get overall stats */
+    stats(): {
+        totalTraces: number;
+        byPattern: Record<string, number>;
+        avgTokens: number;
+        avgDuration: number;
+    };
+    close(): void;
+    private rowToTrace;
+}
+/**
+ * Extract key learnings from an execution trace and format as memory entries.
+ */
+export declare function traceToMemoryEntries(trace: ExecutionTrace): Array<{
+    type: 'decision' | 'learning' | 'outcome';
+    title: string;
+    content: string;
+}>;
+//# sourceMappingURL=traces.d.ts.map

package/dist/runtime/traces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../../src/runtime/traces.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,CAAC,EAAE,MAAM;IAW3B,OAAO,CAAC,UAAU;IAwBlB,4CAA4C;IAC5C,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM;IAapC,0CAA0C;IAC1C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,cAAc,EAAE;IAkB9D,mDAAmD;IACnD,SAAS,CAAC,KAAK,GAAE,MAAW,GAAG,cAAc,EAAE;IAQ/C,4BAA4B;IAC5B,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,cAAc,EAAE;IAQnE,qCAAqC;IACrC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAa1F,wBAAwB;IACxB,KAAK,IAAI;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAiB3G,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,UAAU;CAiBnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,CAAC;IACjE,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAqCD"}

package/dist/runtime/traces.js

@@ -0,0 +1,166 @@
+import Database from 'better-sqlite3';
+import { existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { redactSecrets } from '../utils/redact.js';
+export class TraceStore {
+    db;
+    constructor(dbPath) {
+        const path = dbPath ?? join(homedir(), '.swarm', 'data', 'traces.db');
+        const dir = dirname(path);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true, mode: 0o700 });
+        this.db = new Database(path);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('busy_timeout = 5000');
+        this.initSchema();
+    }
+    initSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS traces (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        orchestration_id TEXT NOT NULL,
+        task TEXT NOT NULL,
+        pattern TEXT NOT NULL,
+        status TEXT NOT NULL,
+        total_tokens INTEGER DEFAULT 0,
+        cost_usd REAL DEFAULT 0,
+        duration_ms INTEGER DEFAULT 0,
+        phase_count INTEGER DEFAULT 0,
+        agent_count INTEGER DEFAULT 0,
+        phases_json TEXT,
+        reflections_json TEXT,
+        created_at TEXT DEFAULT (datetime('now'))
+      );
+      CREATE VIRTUAL TABLE IF NOT EXISTS traces_fts USING fts5(task, pattern, content=traces, content_rowid=id);
+      CREATE TRIGGER IF NOT EXISTS traces_ai AFTER INSERT ON traces BEGIN
+        INSERT INTO traces_fts(rowid, task, pattern) VALUES (new.id, new.task, new.pattern);
+      END;
+    `);
+    }
+    /** Store a completed orchestration trace */
+    store(trace) {
+        const result = this.db.prepare(`
+      INSERT INTO traces (orchestration_id, task, pattern, status, total_tokens, cost_usd, duration_ms, phase_count, agent_count, phases_json, reflections_json)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(trace.orchestrationId, redactSecrets(trace.task), trace.pattern, trace.status, trace.totalTokens, trace.costUsd, trace.durationMs, trace.phaseCount, trace.agentCount, JSON.stringify(trace.phases), JSON.stringify(trace.reflections.map(r => redactSecrets(r))));
+        return result.lastInsertRowid;
+    }
+    /** Find similar past traces using FTS5 */
+    findSimilar(task, limit = 5) {
+        try {
+            const safeQuery = '"' + task.replace(/"/g, '').slice(0, 500) + '"';
+            const rows = this.db.prepare(`
+        SELECT t.*, rank
+        FROM traces_fts fts
+        JOIN traces t ON t.id = fts.rowid
+        WHERE traces_fts MATCH ?
+        ORDER BY rank
+        LIMIT ?
+      `).all(safeQuery, limit);
+            return rows.map(r => this.rowToTrace(r));
+        }
+        catch {
+            return []; // Malformed FTS query
+        }
+    }
+    /** Get most recent traces regardless of pattern */
+    getRecent(limit = 10) {
+        const rows = this.db.prepare(`
+      SELECT * FROM traces ORDER BY created_at DESC LIMIT ?
+    `).all(limit);
+        return rows.map(r => this.rowToTrace(r));
+    }
+    /** Get traces by pattern */
+    getByPattern(pattern, limit = 10) {
+        const rows = this.db.prepare(`
+      SELECT * FROM traces WHERE pattern = ? ORDER BY created_at DESC LIMIT ?
+    `).all(pattern, limit);
+        return rows.map(r => this.rowToTrace(r));
+    }
+    /** Get success rate for a pattern */
+    getPatternSuccessRate(pattern) {
+        const row = this.db.prepare(`
+      SELECT COUNT(*) as total, SUM(CASE WHEN status = 'completed' THEN 1 ELSE 0 END) as succeeded
+      FROM traces WHERE pattern = ?
+    `).get(pattern);
+        return {
+            total: row.total,
+            succeeded: row.succeeded,
+            rate: row.total > 0 ? row.succeeded / row.total : 0,
+        };
+    }
+    /** Get overall stats */
+    stats() {
+        const total = this.db.prepare('SELECT COUNT(*) as count FROM traces').get().count;
+        const byPattern = {};
+        const patternRows = this.db.prepare('SELECT pattern, COUNT(*) as count FROM traces GROUP BY pattern').all();
+        for (const r of patternRows)
+            byPattern[r.pattern] = r.count;
+        const avgs = this.db.prepare('SELECT AVG(total_tokens) as avg_tokens, AVG(duration_ms) as avg_duration FROM traces').get();
+        return {
+            totalTraces: total,
+            byPattern,
+            avgTokens: Math.round(avgs.avg_tokens ?? 0),
+            avgDuration: Math.round(avgs.avg_duration ?? 0),
+        };
+    }
+    close() {
+        this.db.close();
+    }
+    rowToTrace(row) {
+        return {
+            id: row.id,
+            orchestrationId: row.orchestration_id,
+            task: row.task,
+            pattern: row.pattern,
+            status: row.status,
+            totalTokens: row.total_tokens,
+            costUsd: row.cost_usd,
+            durationMs: row.duration_ms,
+            phaseCount: row.phase_count,
+            agentCount: row.agent_count,
+            phases: JSON.parse(row.phases_json ?? '[]'),
+            reflections: JSON.parse(row.reflections_json ?? '[]'),
+            createdAt: row.created_at,
+        };
+    }
+}
+/**
+ * Extract key learnings from an execution trace and format as memory entries.
+ */
+export function traceToMemoryEntries(trace) {
+    const entries = [];
+    // Outcome: what happened
+    entries.push({
+        type: 'outcome',
+        title: redactSecrets(`${trace.pattern}: ${trace.task.slice(0, 60)}`),
+        content: [
+            `Pattern: ${trace.pattern}`,
+            `Status: ${trace.status}`,
+            `Agents: ${trace.agentCount}, Phases: ${trace.phaseCount}`,
+            `Tokens: ${trace.totalTokens}, Cost: $${trace.costUsd.toFixed(4)}, Duration: ${Math.round(trace.durationMs / 1000)}s`,
+            '',
+            ...trace.phases.map(p => `- ${p.name}: ${p.status} (${p.agentCount} agents, ${p.tokens} tokens, ${p.confidence} confidence)`),
+        ].join('\n'),
+    });
+    // Learning from reflections
+    if (trace.reflections.length > 0) {
+        entries.push({
+            type: 'learning',
+            title: `Lessons from ${trace.pattern}: ${trace.task.slice(0, 40)}`,
+            content: trace.reflections.join('\n\n'),
+        });
+    }
+    // Decision: which pattern worked/failed
+    if (trace.status === 'failed') {
+        const failedPhases = trace.phases.filter(p => p.status === 'failed');
+        entries.push({
+            type: 'decision',
+            title: `Pattern ${trace.pattern} failed for: ${trace.task.slice(0, 40)}`,
+            content: `Failed at phase(s): ${failedPhases.map(p => p.name).join(', ')}. Consider a different pattern or approach for similar tasks.`,
+        });
+    }
+    return entries;
+}
+//# sourceMappingURL=traces.js.map

package/dist/runtime/traces.js.map

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

package/dist/runtime/verifier.d.ts

@@ -0,0 +1,54 @@
+import { EventBus } from '../core/event-bus.js';
+export interface VerificationResult {
+    step: string;
+    passed: boolean;
+    output: string;
+    durationMs: number;
+}
+export interface VerifierConfig {
+    enabled: boolean;
+    commands: VerificationCommand[];
+    timeout: number;
+}
+export interface VerificationCommand {
+    name: string;
+    command: string;
+    args: string[];
+    optional?: boolean;
+}
+export declare const DEFAULT_VERIFIER: VerifierConfig;
+export declare class Verifier {
+    private config;
+    private cwd;
+    constructor(cwd: string, config?: Partial<VerifierConfig>);
+    /** Run all verification commands and return results */
+    verify(): Promise<VerificationResult[]>;
+    /** Check if all verifications passed */
+    isGreen(): Promise<boolean>;
+    /** Get a summary string of verification results */
+    static summarize(results: VerificationResult[]): string;
+    /** Auto-detect verification commands from project files */
+    private detectCommands;
+    /** Get configured commands */
+    getCommands(): VerificationCommand[];
+}
+/**
+ * Continuous verification — runs checks after file changes with debounce.
+ * Like Aider's auto lint+test, but integrated with the event bus.
+ */
+export declare class ContinuousVerifier {
+    private verifier;
+    private bus;
+    private debounceTimer;
+    private debounceMs;
+    private lastResults;
+    constructor(verifier: Verifier, bus: EventBus, debounceMs?: number);
+    /** Start monitoring for file changes */
+    start(): void;
+    /** Stop monitoring */
+    stop(): void;
+    /** Get last verification results */
+    getLastResults(): VerificationResult[];
+    private scheduleVerification;
+}
+//# sourceMappingURL=verifier.d.ts.map

package/dist/runtime/verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../src/runtime/verifier.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIhD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,gBAAgB,EAAE,cAI9B,CAAC;AAEF,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAUzD,uDAAuD;IACjD,MAAM,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAkC7C,wCAAwC;IAClC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAKjC,mDAAmD;IACnD,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM;IAOvD,2DAA2D;IAC3D,OAAO,CAAC,cAAc;IAiDtB,8BAA8B;IAC9B,WAAW,IAAI,mBAAmB,EAAE;CAGrC;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAA4B;gBAEnC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,GAAE,MAAa;IAMxE,wCAAwC;IACxC,KAAK,IAAI,IAAI;IAYb,sBAAsB;IACtB,IAAI,IAAI,IAAI;IAOZ,oCAAoC;IACpC,cAAc,IAAI,kBAAkB,EAAE;IAItC,OAAO,CAAC,oBAAoB;CAoB7B"}