audrey 0.17.0 → 0.21.0

package/dist/src/llm.js

@@ -0,0 +1,167 @@
+import { describeHttpError, requireApiKey } from './utils.js';
+function extractJSON(text) {
+    const fenced = text.match(/```(?:json)?\s*\n?([\s\S]*?)```/);
+    return fenced ? fenced[1].trim() : text.trim();
+}
+const PROMPT_TYPE_KEYS = [
+    'principleExtraction',
+    'contradictionDetection',
+    'causalArticulation',
+    'contextResolution',
+];
+export class MockLLMProvider {
+    responses;
+    modelName;
+    modelVersion;
+    constructor({ responses = {} } = {}) {
+        this.responses = (responses ?? {});
+        this.modelName = 'mock-llm';
+        this.modelVersion = '1.0.0';
+    }
+    _matchPromptType(messages) {
+        const systemMsg = messages.find(m => m.role === 'system')?.content || '';
+        for (const key of PROMPT_TYPE_KEYS) {
+            if (systemMsg.includes(key))
+                return key;
+        }
+        return null;
+    }
+    async complete(messages) {
+        const promptType = this._matchPromptType(messages);
+        const cannedResponse = promptType ? this.responses[promptType] : undefined;
+        return { content: cannedResponse !== undefined ? JSON.stringify(cannedResponse) : '{}' };
+    }
+    async json(messages) {
+        const promptType = this._matchPromptType(messages);
+        const cannedResponse = promptType ? this.responses[promptType] : undefined;
+        return cannedResponse !== undefined ? cannedResponse : {};
+    }
+}
+export class AnthropicLLMProvider {
+    apiKey;
+    model;
+    maxTokens;
+    timeout;
+    modelName;
+    modelVersion;
+    constructor({ apiKey, model = 'claude-sonnet-4-6', maxTokens = 1024, timeout = 30000 } = {}) {
+        this.apiKey = apiKey || process.env.ANTHROPIC_API_KEY;
+        this.model = model ?? 'claude-sonnet-4-6';
+        this.maxTokens = maxTokens ?? 1024;
+        this.timeout = timeout ?? 30000;
+        this.modelName = this.model;
+        this.modelVersion = 'latest';
+    }
+    async complete(messages, options = {}) {
+        requireApiKey(this.apiKey, 'Anthropic LLM', 'ANTHROPIC_API_KEY');
+        const systemMsg = messages.find(m => m.role === 'system')?.content;
+        const nonSystemMsgs = messages.filter(m => m.role !== 'system');
+        const body = {
+            model: this.model,
+            max_tokens: options.maxTokens || this.maxTokens,
+            messages: nonSystemMsgs,
+        };
+        if (systemMsg)
+            body.system = systemMsg;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch('https://api.anthropic.com/v1/messages', {
+                method: 'POST',
+                headers: {
+                    'x-api-key': this.apiKey,
+                    'anthropic-version': '2023-06-01',
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Anthropic API error: ${await describeHttpError(response)}`);
+            }
+            const data = await response.json();
+            const text = data.content?.[0]?.text || '';
+            return { content: text };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async json(messages, options = {}) {
+        const result = await this.complete(messages, options);
+        try {
+            return JSON.parse(extractJSON(result.content));
+        }
+        catch {
+            throw new Error(`Failed to parse LLM response as JSON: ${result.content.slice(0, 200)}`);
+        }
+    }
+}
+export class OpenAILLMProvider {
+    apiKey;
+    model;
+    maxTokens;
+    timeout;
+    modelName;
+    modelVersion;
+    constructor({ apiKey, model = 'gpt-4o', maxTokens = 1024, timeout = 30000 } = {}) {
+        this.apiKey = apiKey || process.env.OPENAI_API_KEY;
+        this.model = model ?? 'gpt-4o';
+        this.maxTokens = maxTokens ?? 1024;
+        this.timeout = timeout ?? 30000;
+        this.modelName = this.model;
+        this.modelVersion = 'latest';
+    }
+    async complete(messages, options = {}) {
+        requireApiKey(this.apiKey, 'OpenAI LLM', 'OPENAI_API_KEY');
+        const body = {
+            model: this.model,
+            max_tokens: options.maxTokens || this.maxTokens,
+            messages,
+        };
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch('https://api.openai.com/v1/chat/completions', {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${this.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`OpenAI API error: ${await describeHttpError(response)}`);
+            }
+            const data = await response.json();
+            const text = data.choices?.[0]?.message?.content || '';
+            return { content: text };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async json(messages, options = {}) {
+        const result = await this.complete(messages, options);
+        try {
+            return JSON.parse(extractJSON(result.content));
+        }
+        catch {
+            throw new Error(`Failed to parse LLM response as JSON: ${result.content.slice(0, 200)}`);
+        }
+    }
+}
+export function createLLMProvider(config) {
+    switch (config.provider) {
+        case 'mock':
+            return new MockLLMProvider(config);
+        case 'anthropic':
+            return new AnthropicLLMProvider(config);
+        case 'openai':
+            return new OpenAILLMProvider(config);
+        default:
+            throw new Error(`Unknown LLM provider: ${config.provider}. Valid: mock, anthropic, openai`);
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/src/llm.js.map

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

package/dist/src/migrate.d.ts

@@ -0,0 +1,6 @@
+import Database from 'better-sqlite3';
+import type { EmbeddingProvider, ReembedCounts } from './types.js';
+export declare function reembedAll(db: Database.Database, embeddingProvider: EmbeddingProvider, { dropAndRecreate }?: {
+    dropAndRecreate?: boolean;
+}): Promise<ReembedCounts>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/src/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAsBnE,wBAAsB,UAAU,CAC9B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,iBAAiB,EAAE,iBAAiB,EACpC,EAAE,eAAuB,EAAE,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9D,OAAO,CAAC,aAAa,CAAC,CAuDxB"}

package/dist/src/migrate.js

@@ -0,0 +1,51 @@
+import { dropVec0Tables, createVec0Tables } from './db.js';
+export async function reembedAll(db, embeddingProvider, { dropAndRecreate = false } = {}) {
+    if (dropAndRecreate) {
+        dropVec0Tables(db);
+        createVec0Tables(db, embeddingProvider.dimensions);
+    }
+    const episodes = db.prepare('SELECT id, content, source, consolidated FROM episodes').all();
+    const semantics = db.prepare('SELECT id, content, state FROM semantics').all();
+    const procedures = db.prepare('SELECT id, content, state FROM procedures').all();
+    const episodeVectors = episodes.length > 0
+        ? await embeddingProvider.embedBatch(episodes.map(ep => ep.content))
+        : [];
+    const semanticVectors = semantics.length > 0
+        ? await embeddingProvider.embedBatch(semantics.map(s => s.content))
+        : [];
+    const procedureVectors = procedures.length > 0
+        ? await embeddingProvider.embedBatch(procedures.map(p => p.content))
+        : [];
+    const updateEpLegacy = db.prepare('UPDATE episodes SET embedding = ? WHERE id = ?');
+    const deleteVecEp = db.prepare('DELETE FROM vec_episodes WHERE id = ?');
+    const insertVecEp = db.prepare('INSERT INTO vec_episodes(id, embedding, source, consolidated) VALUES (?, ?, ?, ?)');
+    const updateSemLegacy = db.prepare('UPDATE semantics SET embedding = ? WHERE id = ?');
+    const deleteVecSem = db.prepare('DELETE FROM vec_semantics WHERE id = ?');
+    const insertVecSem = db.prepare('INSERT INTO vec_semantics(id, embedding, state) VALUES (?, ?, ?)');
+    const updateProcLegacy = db.prepare('UPDATE procedures SET embedding = ? WHERE id = ?');
+    const deleteVecProc = db.prepare('DELETE FROM vec_procedures WHERE id = ?');
+    const insertVecProc = db.prepare('INSERT INTO vec_procedures(id, embedding, state) VALUES (?, ?, ?)');
+    const writeTx = db.transaction(() => {
+        for (let i = 0; i < episodes.length; i++) {
+            const buf = embeddingProvider.vectorToBuffer(episodeVectors[i]);
+            updateEpLegacy.run(buf, episodes[i].id);
+            deleteVecEp.run(episodes[i].id);
+            insertVecEp.run(episodes[i].id, buf, episodes[i].source, BigInt(episodes[i].consolidated ?? 0));
+        }
+        for (let i = 0; i < semantics.length; i++) {
+            const buf = embeddingProvider.vectorToBuffer(semanticVectors[i]);
+            updateSemLegacy.run(buf, semantics[i].id);
+            deleteVecSem.run(semantics[i].id);
+            insertVecSem.run(semantics[i].id, buf, semantics[i].state);
+        }
+        for (let i = 0; i < procedures.length; i++) {
+            const buf = embeddingProvider.vectorToBuffer(procedureVectors[i]);
+            updateProcLegacy.run(buf, procedures[i].id);
+            deleteVecProc.run(procedures[i].id);
+            insertVecProc.run(procedures[i].id, buf, procedures[i].state);
+        }
+    });
+    writeTx();
+    return { episodes: episodes.length, semantics: semantics.length, procedures: procedures.length };
+}
+//# sourceMappingURL=migrate.js.map

package/dist/src/migrate.js.map

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

package/dist/src/preflight.d.ts

@@ -0,0 +1,51 @@
+import type { Audrey } from './audrey.js';
+import type { CapsuleMode, MemoryCapsule } from './capsule.js';
+import type { FailurePattern } from './events.js';
+import type { MemoryStatusResult } from './types.js';
+export type PreflightDecision = 'go' | 'caution' | 'block';
+export type PreflightSeverity = 'info' | 'low' | 'medium' | 'high';
+export type PreflightWarningType = 'recent_failure' | 'must_follow' | 'risk' | 'procedure' | 'contradiction' | 'uncertain' | 'memory_health';
+export interface PreflightOptions {
+    tool?: string;
+    sessionId?: string;
+    cwd?: string;
+    files?: string[];
+    strict?: boolean;
+    limit?: number;
+    budgetChars?: number;
+    mode?: CapsuleMode;
+    recentFailureWindowHours?: number;
+    recentChangeWindowHours?: number;
+    includeCapsule?: boolean;
+    includeStatus?: boolean;
+    recordEvent?: boolean;
+}
+export interface PreflightWarning {
+    type: PreflightWarningType;
+    severity: PreflightSeverity;
+    message: string;
+    reason: string;
+    evidence_id?: string;
+    recommended_action?: string;
+}
+export interface MemoryPreflight {
+    action: string;
+    query: string;
+    tool?: string;
+    cwd?: string;
+    generated_at: string;
+    decision: PreflightDecision;
+    verdict: 'clear' | 'caution' | 'blocked';
+    ok_to_proceed: boolean;
+    risk_score: number;
+    summary: string;
+    warnings: PreflightWarning[];
+    recent_failures: FailurePattern[];
+    status?: MemoryStatusResult;
+    recommended_actions: string[];
+    evidence_ids: string[];
+    preflight_event_id?: string;
+    capsule?: MemoryCapsule;
+}
+export declare function buildPreflight(audrey: Audrey, action: string, options?: PreflightOptions): Promise<MemoryPreflight>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/src/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAgB,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;AAC3D,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AACnE,MAAM,MAAM,oBAAoB,GAC5B,gBAAgB,GAChB,aAAa,GACb,MAAM,GACN,WAAW,GACX,eAAe,GACf,WAAW,GACX,eAAe,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AA+FD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAmK1B"}

package/dist/src/preflight.js

@@ -0,0 +1,201 @@
+const SEVERITY_SCORE = {
+    info: 0.1,
+    low: 0.25,
+    medium: 0.55,
+    high: 0.85,
+};
+function isNonEmptyText(value) {
+    return value.trim().length > 0;
+}
+function shorten(value, max = 320) {
+    const text = value.replace(/\s+/g, ' ').trim();
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max - 1)}...`;
+}
+function matchesToolOrAction(action, requestedTool, failedTool) {
+    if (!failedTool)
+        return false;
+    const failed = failedTool.toLowerCase();
+    const tool = requestedTool?.toLowerCase();
+    const actionText = action.toLowerCase();
+    return Boolean((tool && (failed === tool || failed.includes(tool) || tool.includes(failed)))
+        || actionText.includes(failed));
+}
+function warningFromEntry(type, severity, entry, fallbackAction) {
+    return {
+        type,
+        severity,
+        message: shorten(entry.content),
+        reason: entry.reason,
+        evidence_id: entry.memory_id,
+        recommended_action: entry.recommended_action ?? fallbackAction,
+    };
+}
+function addWarning(warnings, seen, warning) {
+    const key = `${warning.type}:${warning.evidence_id ?? warning.message}`;
+    if (seen.has(key))
+        return;
+    seen.add(key);
+    warnings.push(warning);
+}
+function recommendationFromWarning(warning) {
+    if (warning.recommended_action)
+        return warning.recommended_action;
+    switch (warning.type) {
+        case 'recent_failure':
+            return 'Review the prior failure before running the same tool again.';
+        case 'must_follow':
+            return 'Apply the must-follow memory before acting.';
+        case 'risk':
+            return 'Mitigate the remembered risk before proceeding.';
+        case 'procedure':
+            return 'Use the remembered procedure as the execution path.';
+        case 'contradiction':
+            return 'Resolve or scope the contradiction before relying on either claim.';
+        case 'uncertain':
+            return 'Treat the low-confidence memory as a check, not as settled truth.';
+        case 'memory_health':
+            return 'Repair memory health before relying on recall-sensitive decisions.';
+    }
+}
+function buildSummary(decision, warnings) {
+    if (warnings.length === 0) {
+        return 'No relevant memory risks, prior failures, or must-follow procedures were found.';
+    }
+    const high = warnings.filter(w => w.severity === 'high').length;
+    const medium = warnings.filter(w => w.severity === 'medium').length;
+    const parts = [`${warnings.length} memory signal${warnings.length === 1 ? '' : 's'}`];
+    if (high > 0)
+        parts.push(`${high} high severity`);
+    if (medium > 0)
+        parts.push(`${medium} medium severity`);
+    return `${decision === 'block' ? 'Blocked' : 'Caution'}: ${parts.join(', ')} found before acting.`;
+}
+export async function buildPreflight(audrey, action, options = {}) {
+    if (!isNonEmptyText(action)) {
+        throw new Error('action must be a non-empty string');
+    }
+    const queryParts = [
+        action.trim(),
+        options.tool ? `tool:${options.tool}` : '',
+        options.cwd ? `cwd:${options.cwd}` : '',
+    ].filter(Boolean);
+    const query = queryParts.join('\n');
+    const capsule = await audrey.capsule(query, {
+        limit: options.limit ?? 12,
+        budgetChars: options.budgetChars ?? 3000,
+        mode: options.mode ?? 'conservative',
+        recentChangeWindowHours: options.recentChangeWindowHours ?? 72,
+        includeRisks: true,
+        includeContradictions: true,
+    });
+    const warnings = [];
+    const seen = new Set();
+    const includeStatus = options.includeStatus ?? true;
+    const status = includeStatus ? audrey.memoryStatus() : undefined;
+    if (status && !status.healthy) {
+        addWarning(warnings, seen, {
+            type: 'memory_health',
+            severity: 'high',
+            message: 'Audrey memory index is unhealthy; recall may be incomplete or stale.',
+            reason: 'memoryStatus().healthy is false.',
+            recommended_action: 'Run npx audrey status and npx audrey reembed before depending on memory.',
+        });
+    }
+    else if (status?.reembed_recommended) {
+        addWarning(warnings, seen, {
+            type: 'memory_health',
+            severity: 'medium',
+            message: 'Audrey recommends re-embedding before recall-sensitive work.',
+            reason: 'memoryStatus().reembed_recommended is true.',
+            recommended_action: 'Run npx audrey reembed during a safe maintenance window.',
+        });
+    }
+    const since = new Date(Date.now() - (options.recentFailureWindowHours ?? 168) * 60 * 60 * 1000).toISOString();
+    const recentFailures = audrey.recentFailures({ since, limit: 20 });
+    const matchingFailures = [];
+    for (const failure of recentFailures) {
+        if (!matchesToolOrAction(action, options.tool, failure.tool_name))
+            continue;
+        matchingFailures.push(failure);
+        const toolLabel = failure.tool_name || options.tool || 'tool';
+        addWarning(warnings, seen, {
+            type: 'recent_failure',
+            severity: failure.failure_count >= 3 ? 'high' : 'medium',
+            message: failure.last_error_summary
+                ? `${toolLabel} failed ${failure.failure_count}x recently: ${shorten(failure.last_error_summary, 220)}`
+                : `${toolLabel} failed ${failure.failure_count}x recently.`,
+            reason: 'Matched a recent failed tool event for this action.',
+            evidence_id: `failure:${toolLabel}:${failure.last_failed_at}`,
+            recommended_action: `Before re-running ${toolLabel}, check what changed since the last failure.`,
+        });
+    }
+    for (const entry of capsule.sections.must_follow) {
+        addWarning(warnings, seen, warningFromEntry('must_follow', 'high', entry, 'Apply this must-follow rule before acting.'));
+    }
+    for (const entry of capsule.sections.risks) {
+        addWarning(warnings, seen, warningFromEntry(entry.memory_type === 'tool_failure' ? 'recent_failure' : 'risk', entry.memory_type === 'tool_failure' ? 'medium' : 'high', entry, 'Mitigate this remembered risk before proceeding.'));
+    }
+    for (const entry of capsule.sections.procedures) {
+        addWarning(warnings, seen, warningFromEntry('procedure', 'info', entry, 'Use this remembered procedure as guidance.'));
+    }
+    for (const entry of capsule.sections.contradictions) {
+        addWarning(warnings, seen, warningFromEntry('contradiction', 'high', entry, 'Resolve or scope this contradiction before acting.'));
+    }
+    for (const entry of capsule.sections.uncertain_or_disputed) {
+        addWarning(warnings, seen, warningFromEntry('uncertain', 'medium', entry, 'Treat this as uncertain context and verify before relying on it.'));
+    }
+    warnings.sort((a, b) => SEVERITY_SCORE[b.severity] - SEVERITY_SCORE[a.severity]);
+    const riskScore = warnings.reduce((score, warning) => Math.max(score, SEVERITY_SCORE[warning.severity]), 0);
+    const hasHigh = warnings.some(w => w.severity === 'high');
+    const hasMedium = warnings.some(w => w.severity === 'medium');
+    const decision = options.strict && hasHigh
+        ? 'block'
+        : hasHigh || hasMedium
+            ? 'caution'
+            : 'go';
+    const verdict = decision === 'go' ? 'clear' : decision === 'block' ? 'blocked' : 'caution';
+    const recommendedActions = [...new Set(warnings.map(recommendationFromWarning))];
+    if (decision === 'block') {
+        recommendedActions.unshift('Do not proceed until the high-severity memory warning is addressed.');
+    }
+    const preflightEvent = options.recordEvent && options.tool
+        ? audrey.observeTool({
+            event: 'PreToolUse',
+            tool: options.tool,
+            sessionId: options.sessionId,
+            input: { action: action.trim(), tool: options.tool },
+            outcome: 'unknown',
+            cwd: options.cwd,
+            files: options.files,
+            metadata: {
+                preflight_decision: decision,
+                preflight_warning_count: warnings.length,
+            },
+        }).event
+        : undefined;
+    return {
+        action: action.trim(),
+        query,
+        tool: options.tool,
+        cwd: options.cwd,
+        generated_at: new Date().toISOString(),
+        decision,
+        verdict,
+        ok_to_proceed: decision !== 'block',
+        risk_score: Number(riskScore.toFixed(2)),
+        summary: buildSummary(decision, warnings),
+        warnings,
+        recent_failures: matchingFailures,
+        ...(status ? { status } : {}),
+        recommended_actions: recommendedActions,
+        evidence_ids: [...new Set([
+                ...capsule.evidence_ids,
+                ...warnings.map(w => w.evidence_id).filter((id) => Boolean(id)),
+            ])],
+        ...(preflightEvent ? { preflight_event_id: preflightEvent.id } : {}),
+        ...(options.includeCapsule === false ? {} : { capsule }),
+    };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/src/preflight.js.map

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

package/dist/src/promote.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Memory-to-Behavior promotion — candidate scoring.
+ *
+ * A "candidate" is a memory (usually procedural, sometimes high-confidence
+ * semantic) that has earned the right to become an enforced project rule:
+ *   - repeated occurrence (multiple supporting episodes)
+ *   - low contradiction (active state, not disputed)
+ *   - durable (not recently superseded)
+ *   - not already promoted to this target
+ *
+ * Tool-failure context also boosts candidates: if the Bash tool has failed
+ * 3 times this week with errors mentioning "sqlite extension", a procedural
+ * memory about "initialize sqlite extension before tests" gets a
+ * failure_prevented score, which bubbles it up in the ranked list.
+ */
+import type Database from 'better-sqlite3';
+export type PromotionTarget = 'claude-rules' | 'agents-md' | 'playbook' | 'hook' | 'checklist';
+export interface PromotionCandidate {
+    candidate_id: string;
+    memory_id: string;
+    memory_type: 'semantic' | 'procedural';
+    content: string;
+    scope?: string;
+    confidence: number;
+    evidence_count: number;
+    usage_count: number;
+    failure_prevented: number;
+    tags: string[];
+    score: number;
+    reason: string;
+}
+export interface FindCandidatesOptions {
+    minConfidence?: number;
+    minEvidence?: number;
+    limit?: number;
+    target?: PromotionTarget;
+    since?: string;
+}
+export declare function findPromotionCandidates(db: Database.Database, options?: FindCandidatesOptions): PromotionCandidate[];
+//# sourceMappingURL=promote.d.ts.map

package/dist/src/promote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../src/promote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/F,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,UAAU,GAAG,YAAY,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA2GD,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,qBAA0B,GAClC,kBAAkB,EAAE,CA+HtB"}