@itaila/archetype 0.3.30

package/dist/audit/prompt-dump.js

@@ -0,0 +1,269 @@
+/**
+ * Prompt-dump helpers — the "Line 2" of the audit mechanism.
+ *
+ * When auditPersona flags something you can't explain, or the trace looks
+ * fine but the AI's behavior doesn't match expectation — dump the exact
+ * prompt the LLM would receive and read it directly. Often the bug is
+ * obvious in two minutes of eyeballing the packet.
+ *
+ * Two entry points, same artifact shape:
+ *
+ *   dumpPromptForReview(config, input)
+ *     One-shot. Build the prompt for a single representative input,
+ *     get back a DumpedPrompt with system prompt, history, message,
+ *     plus an `artifact` string formatted for pasting into an AI
+ *     reviewer or attaching to a bug report.
+ *
+ *   createPromptTraceRecorder({ outDir })
+ *     Hook-compatible recorder for benchmark runs. Wires into
+ *     runAutonomousLoop's onBeforeChat (or any code path that
+ *     assembles a request). Writes one JSON file per turn. Replaces
+ *     per-persona reinventions of this pattern (foundry had one,
+ *     savor had three).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+import { buildChatLLMRequest, buildPromptedTurnLLMRequest, } from '../core/request-builder.js';
+// ─── one-shot dumpPromptForReview ────────────────────────────────────────────
+/**
+ * Assemble the exact prompt this persona would send for one input, and
+ * return it in a shape friendly for human or AI review.
+ *
+ * Use this during the debugging loop when auditPersona findings need
+ * context, or when you want a second opinion from another AI on the
+ * actual packet.
+ */
+export function dumpPromptForReview(config, input, options) {
+    const mode = options?.mode ?? 'chat';
+    if (mode === 'chat') {
+        const { request } = buildChatLLMRequest(config, input);
+        return {
+            systemPrompt: request.systemPrompt,
+            history: request.history,
+            message: request.message,
+            attachments: request.attachments,
+            responseSchema: request.responseSchema,
+            mode,
+            promptMode: request.promptMode,
+            promptOrigin: request.promptOrigin,
+            artifact: formatAsArtifact({
+                systemPrompt: request.systemPrompt,
+                history: request.history,
+                message: request.message,
+                mode,
+                promptMode: request.promptMode,
+                promptOrigin: request.promptOrigin,
+                attachments: request.attachments,
+            }),
+        };
+    }
+    // prompted-turn / retrospect share the same builder
+    const { request } = buildPromptedTurnLLMRequest(config, input);
+    return {
+        systemPrompt: request.systemPrompt,
+        history: request.history,
+        message: request.message,
+        attachments: request.attachments,
+        responseSchema: request.responseSchema,
+        mode,
+        promptMode: request.promptMode,
+        promptOrigin: request.promptOrigin,
+        artifact: formatAsArtifact({
+            systemPrompt: request.systemPrompt,
+            history: request.history,
+            message: request.message,
+            mode,
+            promptMode: request.promptMode,
+            promptOrigin: request.promptOrigin,
+            attachments: request.attachments,
+        }),
+    };
+}
+const TRACE_STRING_LIMIT = 200_000;
+export function createPromptTraceRecorder(options) {
+    const baseDir = options.traceGroup
+        ? path.join(options.outDir, options.traceGroup)
+        : options.outDir;
+    mkdirSync(baseDir, { recursive: true });
+    const format = options.format ?? 'json';
+    const writeTurn = (params) => {
+        const fileName = `turn-${String(params.turn).padStart(2, '0')}-${params.phase}-attempt-${params.attempt}`;
+        if (format === 'json' || format === 'both') {
+            const payload = {
+                turn: params.turn,
+                phase: params.phase,
+                attempt: params.attempt,
+                tag: options.tag ?? null,
+                traceGroup: options.traceGroup ?? null,
+                mode: params.mode ?? 'chat',
+                promptMode: params.promptMode ?? null,
+                systemPrompt: params.systemPrompt,
+                message: params.message,
+                history: params.history,
+                attachments: params.attachments ?? [],
+                responseSchema: params.responseSchema ?? null,
+            };
+            writeFileSync(path.join(baseDir, `${fileName}.json`), JSON.stringify(payload, null, 2));
+        }
+        if (format === 'artifact' || format === 'both') {
+            const artifact = formatAsArtifact({
+                systemPrompt: params.systemPrompt,
+                history: params.history,
+                message: params.message,
+                mode: params.mode ?? 'chat',
+                promptMode: params.promptMode,
+                attachments: params.attachments,
+            });
+            writeFileSync(path.join(baseDir, `${fileName}.txt`), artifact);
+        }
+    };
+    const resultFileName = (input) => `turn-${String(input.turn).padStart(2, '0')}-${input.phase ?? 'initial'}-attempt-${input.attempt ?? 1}.json`;
+    const appendResult = (input) => {
+        const filePath = path.join(baseDir, resultFileName(input));
+        const existing = existsSync(filePath)
+            ? JSON.parse(readFileSync(filePath, 'utf8'))
+            : {
+                turn: input.turn,
+                phase: input.phase ?? 'initial',
+                attempt: input.attempt ?? 1,
+                tag: options.tag ?? null,
+                traceGroup: options.traceGroup ?? null,
+                mode: 'chat',
+            };
+        const payload = {
+            ...existing,
+            result: {
+                rawResponse: compactTraceValue(input.rawResponse ?? null),
+                message: input.message,
+                trace: compactTraceValue(input.trace ?? null),
+                actions: compactTraceValue(input.actions ?? []),
+                actionResults: compactTraceValue(input.actionResults ?? []),
+                historyAfterTurn: compactTraceValue(input.historyAfterTurn ?? null),
+                nextMessage: compactTraceValue(input.nextMessage ?? null),
+                notes: input.notes ?? [],
+            },
+        };
+        writeFileSync(filePath, JSON.stringify(payload, null, 2));
+    };
+    return {
+        outDir: baseDir,
+        onBeforeChat: (info) => {
+            writeTurn({
+                turn: info.turn,
+                attempt: info.attempt,
+                phase: 'initial',
+                systemPrompt: info.request.systemPrompt,
+                message: info.request.message,
+                history: info.request.history,
+                responseSchema: info.request.responseSchema,
+                attachments: info.request.attachments,
+                promptMode: info.request.promptMode,
+            });
+        },
+        record: ({ turn, attempt = 1, phase = 'initial', dumped }) => {
+            writeTurn({
+                turn,
+                attempt,
+                phase,
+                systemPrompt: dumped.systemPrompt,
+                message: dumped.message,
+                history: dumped.history,
+                responseSchema: dumped.responseSchema,
+                attachments: dumped.attachments,
+                mode: dumped.mode,
+                promptMode: dumped.promptMode,
+            });
+        },
+        recordTurnResult: appendResult,
+    };
+}
+function compactTraceValue(value) {
+    if (typeof value === 'string') {
+        const bytes = Buffer.byteLength(value, 'utf8');
+        if (bytes <= TRACE_STRING_LIMIT)
+            return value;
+        return {
+            omitted: true,
+            bytes,
+            sha256: createHash('sha256').update(value).digest('hex'),
+            preview: value.slice(0, 2000),
+            note: `String exceeded prompt-trace limit of ${TRACE_STRING_LIMIT} bytes; preview plus hash retained.`,
+        };
+    }
+    if (Array.isArray(value))
+        return value.map(item => compactTraceValue(item));
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, compactTraceValue(child)]));
+    }
+    return value;
+}
+// ─── artifact formatter (shared) ─────────────────────────────────────────────
+function formatAsArtifact(input) {
+    const bar = '═'.repeat(72);
+    const thin = '─'.repeat(72);
+    const lines = [];
+    lines.push(bar);
+    lines.push(`  ARCHETYPE PROMPT DUMP — path: ${input.mode}; prompt mode: ${input.promptMode ?? 'unknown'}`);
+    lines.push(bar);
+    lines.push('');
+    lines.push(thin);
+    lines.push('  SYSTEM PROMPT');
+    lines.push(thin);
+    lines.push('');
+    lines.push(input.systemPrompt);
+    lines.push('');
+    lines.push(thin);
+    lines.push('  HISTORY');
+    lines.push(thin);
+    lines.push('');
+    lines.push('Conversation turns sent outside the system prompt. Empty means no chat transcript was sent for this request.');
+    if (input.history.length === 0) {
+        lines.push('(empty)');
+    }
+    else {
+        for (const m of input.history) {
+            lines.push(`[${formatHistoryRole(m.role)}]`);
+            lines.push(m.content);
+            lines.push('');
+        }
+    }
+    lines.push(thin);
+    const currentHeader = input.promptOrigin === 'app' ? '  CURRENT APP EVENT' : '  USER MESSAGE';
+    const currentDescription = input.promptOrigin === 'app'
+        ? 'App/runtime-initiated current event. This is still model-visible input; read it as live continuity, not as a new external user request.'
+        : 'Current user-visible message sent to the model for this turn.';
+    lines.push(currentHeader);
+    lines.push(thin);
+    lines.push('');
+    lines.push(currentDescription);
+    lines.push('');
+    lines.push(input.message);
+    lines.push('');
+    lines.push(thin);
+    lines.push('  ATTACHMENTS');
+    lines.push(thin);
+    lines.push('');
+    lines.push('Multimodal payloads sent with this request. Binary/base64 data is omitted from the dump; metadata is retained so reviewers can tell what the model saw.');
+    const attachments = input.attachments ?? [];
+    if (attachments.length === 0) {
+        lines.push('(none)');
+    }
+    else {
+        attachments.forEach((attachment, index) => {
+            lines.push(`${index + 1}. ${formatAttachmentSummary(attachment)}`);
+        });
+    }
+    lines.push('');
+    lines.push(bar);
+    return lines.join('\n');
+}
+function formatHistoryRole(role) {
+    return role === 'user' ? 'USER TURN' : 'ASSISTANT TURN';
+}
+function formatAttachmentSummary(attachment) {
+    const bytes = Buffer.byteLength(attachment.data, 'base64');
+    return `${attachment.type}; ${attachment.mimeType}; ${bytes} byte(s) decoded`;
+}
+export { formatAsArtifact };
+//# sourceMappingURL=prompt-dump.js.map

package/dist/audit/prompt-dump.js.map

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

package/dist/audit/trace-integrity.d.ts

@@ -0,0 +1,33 @@
+/**
+ * auditTraceIntegrity — the "Line 3" integrity floor.
+ *
+ * Every TurnTrace should be a complete, honest record of what happened
+ * during a turn. If the pipeline silently dropped an action, swallowed an
+ * error, or took a repair/retry path without surfacing it, this audit
+ * catches it. Silent failures in the pipeline make every upper-layer
+ * audit (auditPersona, auditPrompt, etc.) potentially look at a lie.
+ *
+ * Invariants checked:
+ *
+ *   1. parseOk=false implies errors is non-empty (parse failures named)
+ *   2. repairAttempted=true implies repairSucceeded is defined (not
+ *      undefined — the outcome must be recorded)
+ *   3. Every action with status 'invalid' has a non-empty error
+ *   4. Every crudAction with status 'invalid' or 'failed' has a non-empty
+ *      error
+ *   5. Every executionResult has status 'executed' or 'failed'
+ *   6. Every domainAction has status 'executed', 'failed', or 'skipped'
+ *   7. If repairSucceeded=false, errors array contains at least one
+ *      entry explaining why
+ *   8. unknown_action status implies the name is not empty
+ *
+ * Returns findings in the same shape as auditPersona for unified handling.
+ */
+import type { TurnTrace } from '../types.js';
+import type { AuditFinding } from './audit-persona.js';
+export interface TraceIntegrityResult {
+    pass: boolean;
+    findings: AuditFinding[];
+}
+export declare function auditTraceIntegrity(trace: TurnTrace): TraceIntegrityResult;
+//# sourceMappingURL=trace-integrity.d.ts.map

package/dist/audit/trace-integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-integrity.d.ts","sourceRoot":"","sources":["../../src/audit/trace-integrity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAA;IACb,QAAQ,EAAE,YAAY,EAAE,CAAA;CACzB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,oBAAoB,CAmH1E"}

package/dist/audit/trace-integrity.js

@@ -0,0 +1,109 @@
+export function auditTraceIntegrity(trace) {
+    const findings = [];
+    const traceId = trace.traceId;
+    // Invariant 1: parse failure must be explained.
+    if (!trace.parseOk && trace.errors.length === 0) {
+        findings.push({
+            severity: 'error',
+            audit: 'trace-integrity',
+            principle: 'parse-failure-silent',
+            message: `Trace ${traceId}: parseOk=false but errors array is empty. Parse failure was not explained.`,
+        });
+    }
+    // Invariant 2: repair outcome must be recorded.
+    if (trace.repairAttempted && trace.repairSucceeded === undefined) {
+        findings.push({
+            severity: 'error',
+            audit: 'trace-integrity',
+            principle: 'repair-outcome-missing',
+            message: `Trace ${traceId}: repairAttempted=true but repairSucceeded is undefined. Repair took a path that didn't record its outcome.`,
+        });
+    }
+    // Invariant 7: failed repair must leave an error trail.
+    if (trace.repairAttempted && trace.repairSucceeded === false) {
+        const hasRepairError = trace.errors.some(e => e.toLowerCase().includes('repair'));
+        if (!hasRepairError) {
+            findings.push({
+                severity: 'warn',
+                audit: 'trace-integrity',
+                principle: 'repair-failure-unexplained',
+                message: `Trace ${traceId}: repairSucceeded=false but no repair-related entry in errors. The reason the repair failed is not traceable.`,
+            });
+        }
+    }
+    // Invariant 3: invalid actions must have an error.
+    for (const action of trace.actions) {
+        if (action.status === 'invalid' && (!action.error || action.error.length === 0)) {
+            findings.push({
+                severity: 'error',
+                audit: 'trace-integrity',
+                principle: 'invalid-action-no-error',
+                message: `Trace ${traceId}: action "${action.name}" has status 'invalid' but no error explanation.`,
+            });
+        }
+        // Invariant 8
+        if (action.status === 'unknown_action' && (!action.name || action.name.length === 0)) {
+            findings.push({
+                severity: 'error',
+                audit: 'trace-integrity',
+                principle: 'unknown-action-no-name',
+                message: `Trace ${traceId}: action has status 'unknown_action' but name is empty.`,
+            });
+        }
+    }
+    // Invariant 4: invalid/failed crud must have an error.
+    for (const crud of trace.crudActions) {
+        if ((crud.status === 'invalid' || crud.status === 'failed') && (!crud.error || crud.error.length === 0)) {
+            findings.push({
+                severity: 'error',
+                audit: 'trace-integrity',
+                principle: 'crud-failure-no-error',
+                message: `Trace ${traceId}: crud ${crud.operation} ${crud.entity} has status '${crud.status}' but no error explanation.`,
+            });
+        }
+    }
+    // Invariant 5: execution results must have valid status.
+    for (const result of trace.executionResults) {
+        if (result.status !== 'executed' && result.status !== 'failed') {
+            findings.push({
+                severity: 'error',
+                audit: 'trace-integrity',
+                principle: 'bad-execution-status',
+                message: `Trace ${traceId}: executionResult for ${result.operation} ${result.entity} has unexpected status '${result.status}' (expected 'executed' or 'failed').`,
+            });
+        }
+        if (result.status === 'failed' && (!result.error || result.error.length === 0)) {
+            findings.push({
+                severity: 'error',
+                audit: 'trace-integrity',
+                principle: 'crud-failure-no-error',
+                message: `Trace ${traceId}: executionResult ${result.operation} ${result.entity} failed but no error explanation.`,
+            });
+        }
+    }
+    // Invariant 6: domain actions must have valid status.
+    const allowedDomainStatus = new Set(['executed', 'failed', 'skipped']);
+    for (const domain of trace.domainActions) {
+        if (!allowedDomainStatus.has(domain.status)) {
+            findings.push({
+                severity: 'error',
+                audit: 'trace-integrity',
+                principle: 'bad-domain-status',
+                message: `Trace ${traceId}: domainAction "${domain.name}" has unexpected status '${domain.status}'.`,
+            });
+        }
+        if (domain.status === 'failed' && (!domain.error || domain.error.length === 0)) {
+            findings.push({
+                severity: 'error',
+                audit: 'trace-integrity',
+                principle: 'domain-failure-no-error',
+                message: `Trace ${traceId}: domainAction "${domain.name}" failed but no error explanation.`,
+            });
+        }
+    }
+    return {
+        pass: findings.every(f => f.severity !== 'error'),
+        findings,
+    };
+}
+//# sourceMappingURL=trace-integrity.js.map

package/dist/audit/trace-integrity.js.map

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

package/dist/audit/types.d.ts

@@ -0,0 +1,92 @@
+import type { PersonaConfig, Memory, PromptMode } from '../types.js';
+export interface PromptAuditInput {
+    /** API key for the judge LLM (Gemini). */
+    apiKey: string;
+    /** The persona config to audit. */
+    config: PersonaConfig;
+    /** Optional context to assemble the full prompt (profile, todayStatus, etc.). */
+    context?: Record<string, unknown>;
+    /** Optional memories to include in the assembled prompt. */
+    memories?: Memory[];
+    /**
+     * Which prompt mode to assemble for the audit. Defaults to 'conversation'
+     * (the chat-style assembly). Set to 'focus' or 'operational' to audit the
+     * variant that the benchmark/runtime actually sends. Without this the
+     * audit can pass while the real prompt has latent contradictions in a
+     * mode the consumer is actively using.
+     */
+    promptMode?: PromptMode;
+    /** Optional primary Gemini model. Default: gemini-3.5-flash. */
+    model?: string;
+    /** Optional fallback model chain. When the primary is unavailable (503/overload), the audit will try these in order. Default: ['gemini-3.1-pro-preview', 'gemini-3.1-flash-lite']. */
+    fallbackModels?: string[];
+}
+export interface PromptAuditFailure {
+    /** Which keystone principle is violated. */
+    principle: string;
+    /** The exact problematic text from the prompt. */
+    text: string;
+    /** Why this is a problem — in terms the developer can act on. */
+    issue: string;
+    /** A scenario-first rewrite suggestion. */
+    suggestion: string;
+}
+export interface PromptAuditResult {
+    /** Config version hash — changes when the prompt-affecting config changes. */
+    configVersion: string;
+    /** Explicit list of keystone violations found in the prompt. */
+    failures: PromptAuditFailure[];
+    /** One-paragraph summary for the developer. */
+    summary: string;
+}
+export interface ConversationAuditInput {
+    /** API key for the judge LLM (Gemini). */
+    apiKey: string;
+    /** The persona config (for understanding intent). */
+    config: PersonaConfig;
+    /** Recent conversation history to audit. */
+    history: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+    /** Optional context the persona had available. */
+    context?: Record<string, unknown>;
+}
+export interface ConversationAuditFailure {
+    /** Which keystone principle the behavior violates. */
+    principle: string;
+    /** Which turn (0-indexed) the failure occurs in. */
+    turn: number;
+    /** What went wrong. */
+    issue: string;
+    /** Direct quote from the conversation as evidence. */
+    evidence: string;
+}
+export interface ConversationAuditResult {
+    /** Config version hash — changes when the prompt-affecting config changes. */
+    configVersion: string;
+    /** Explicit list of behavioral failures. */
+    failures: ConversationAuditFailure[];
+    /** One-paragraph summary. */
+    summary: string;
+}
+export interface AuditInput {
+    /** API key for the judge LLM. */
+    apiKey: string;
+    /** Optional conversation history — if provided, runs conversation audit too. */
+    history?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+    /** Optional context for prompt assembly. */
+    context?: Record<string, unknown>;
+    /** Optional memories for prompt assembly. */
+    memories?: Memory[];
+}
+export interface AuditResult {
+    /** Prompt-level keystone failures. */
+    prompt: PromptAuditResult;
+    /** Conversation-level behavioral failures (null if no history provided). */
+    conversation: ConversationAuditResult | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/audit/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAI/E,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,MAAM,EAAE,aAAa,CAAA;IACrB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sLAAsL;IACtL,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAA;IACb,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAA;IACrB,gEAAgE;IAChE,QAAQ,EAAE,kBAAkB,EAAE,CAAA;IAC9B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAA;CAChB;AAID,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,MAAM,EAAE,aAAa,CAAA;IACrB,4CAA4C;IAC5C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC/D,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAA;IACrB,4CAA4C;IAC5C,QAAQ,EAAE,wBAAwB,EAAE,CAAA;IACpC,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;CAChB;AAID,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChE,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,MAAM,EAAE,iBAAiB,CAAA;IACzB,4EAA4E;IAC5E,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAA;CAC7C"}

package/dist/audit/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/audit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/audit/types.ts"],"names":[],"mappings":""}

package/dist/audit/version.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Config versioning — deterministic hash of the persona config fields
+ * that affect the assembled prompt.
+ *
+ * Used by the audit system to tag results. When the config changes,
+ * the version changes, and previous audit results are stale.
+ */
+import type { PersonaConfig } from '../types.js';
+/**
+ * Derive a version hash from the prompt-affecting parts of a PersonaConfig.
+ * Returns a truncated hex string (first 12 chars of SHA-256).
+ */
+export declare function configVersion(config: PersonaConfig): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/audit/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/audit/version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGhD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAiB3D"}

package/dist/audit/version.js

@@ -0,0 +1,65 @@
+/**
+ * Config versioning — deterministic hash of the persona config fields
+ * that affect the assembled prompt.
+ *
+ * Used by the audit system to tag results. When the config changes,
+ * the version changes, and previous audit results are stale.
+ */
+import { createHash } from 'node:crypto';
+import { resolvePersonaConfigBrain } from '../brain.js';
+/**
+ * Derive a version hash from the prompt-affecting parts of a PersonaConfig.
+ * Returns a truncated hex string (first 12 chars of SHA-256).
+ */
+export function configVersion(config) {
+    const resolvedConfig = resolvePersonaConfigBrain(config);
+    const relevant = {
+        identity: resolvedConfig.identity,
+        voice: resolvedConfig.voice,
+        brain: resolvedConfig.brain ? serializeBrain(resolvedConfig.brain) : undefined,
+        methodology: resolvedConfig.methodology,
+        directives: resolvedConfig.directives,
+        actions: resolvedConfig.actions ? serializeActions(resolvedConfig.actions) : undefined,
+        contextInputs: resolvedConfig.contextInputs,
+        eq: resolvedConfig.eq,
+        memory: resolvedConfig.memory ? { ...resolvedConfig.memory } : undefined,
+        craftMemory: resolvedConfig.craftMemory ? { ...resolvedConfig.craftMemory } : undefined,
+    };
+    const json = JSON.stringify(sortValue(relevant));
+    return createHash('sha256').update(json).digest('hex').slice(0, 12);
+}
+function serializeBrain(brain) {
+    if (brain.source !== 'loaded') {
+        return { markdown: JSON.stringify(brain) };
+    }
+    return {
+        metadata: brain.metadata,
+        sections: brain.sections,
+    };
+}
+/**
+ * Serialize action definitions to a stable representation.
+ * Zod schemas aren't JSON-serializable, so we extract the description + confidence.
+ */
+function serializeActions(actions) {
+    const result = {};
+    for (const [name, def] of Object.entries(actions)) {
+        result[name] = {
+            description: def.description ?? '',
+            confidence: def.confidence ?? 'medium',
+        };
+    }
+    return result;
+}
+function sortValue(value) {
+    if (Array.isArray(value)) {
+        return value.map(item => sortValue(item));
+    }
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.keys(value)
+            .sort()
+            .map(key => [key, sortValue(value[key])]));
+    }
+    return value;
+}
+//# sourceMappingURL=version.js.map

package/dist/audit/version.js.map

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

package/dist/brain.d.ts

@@ -0,0 +1,7 @@
+import type { LoadedBrainArtifact, PersonaBrain, PersonaConfig } from './types.js';
+export declare function parseBrainMarkdown(markdown: string, sourcePath?: string): LoadedBrainArtifact;
+export declare function loadBrainFile(path: string): LoadedBrainArtifact;
+export declare function resolvePersonaBrain(brain?: PersonaBrain): LoadedBrainArtifact | undefined;
+export declare function getBrainSection(brain: PersonaBrain | undefined, sectionName: string): string | undefined;
+export declare function resolvePersonaConfigBrain(config: PersonaConfig): PersonaConfig;
+//# sourceMappingURL=brain.d.ts.map

package/dist/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAyBlF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAkC7F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAI/D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,mBAAmB,GAAG,SAAS,CAKzF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxG;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAK9E"}