@itaila/archetype 0.3.30

package/dist/managed/knowledge.js

@@ -0,0 +1,174 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+export function createMarkdownKnowledgeAdapter(options) {
+    return {
+        async searchDocuments(input) {
+            const tokens = tokenize(input.query);
+            if (tokens.length === 0)
+                return [];
+            const files = await listMarkdownFiles(options.rootDir);
+            const docs = [];
+            for (const file of files) {
+                const doc = await readMarkdownKnowledgeDocument(file, options.rootDir);
+                if (!options.includeDrafts && doc.status === 'draft')
+                    continue;
+                const score = scoreDocument(doc, tokens);
+                if (score <= 0)
+                    continue;
+                docs.push({ ...doc, score });
+            }
+            return docs
+                .sort((a, b) => b.score - a.score || compareUpdatedAtDesc(a.updatedAt, b.updatedAt))
+                .slice(0, input.maxDocuments ?? 12)
+                .map(({ score: _score, ...doc }) => doc);
+        },
+        async getDocument(id) {
+            const files = await listMarkdownFiles(options.rootDir);
+            for (const file of files) {
+                const doc = await readMarkdownKnowledgeDocument(file, options.rootDir);
+                if (!options.includeDrafts && doc.status === 'draft')
+                    continue;
+                if (doc.id === id)
+                    return doc;
+            }
+            return null;
+        },
+    };
+}
+async function listMarkdownFiles(rootDir) {
+    const entries = await readdir(rootDir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const fullPath = path.join(rootDir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...await listMarkdownFiles(fullPath));
+            continue;
+        }
+        if (entry.isFile() && entry.name.toLowerCase().endsWith('.md')) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+async function readMarkdownKnowledgeDocument(filePath, rootDir) {
+    const raw = await readFile(filePath, 'utf8');
+    const fileStat = await stat(filePath);
+    const { frontmatter, body } = extractFrontmatter(raw);
+    const title = frontmatter.title ?? extractFirstHeading(body) ?? basenameTitle(filePath);
+    const id = frontmatter.id ?? slugify(path.relative(rootDir, filePath).replace(/\.md$/i, ''));
+    return {
+        id,
+        title,
+        content: body.trim(),
+        summary: frontmatter.summary,
+        tags: frontmatter.tags,
+        status: frontmatter.status,
+        updatedAt: fileStat.mtime.toISOString(),
+        path: filePath,
+    };
+}
+function extractFrontmatter(raw) {
+    if (!raw.startsWith('---\n'))
+        return { frontmatter: {}, body: raw };
+    const end = raw.indexOf('\n---\n', 4);
+    if (end === -1)
+        return { frontmatter: {}, body: raw };
+    const frontmatterBlock = raw.slice(4, end);
+    const body = raw.slice(end + 5);
+    const parsed = {};
+    for (const line of frontmatterBlock.split('\n')) {
+        const [rawKey, ...rawValue] = line.split(':');
+        if (!rawKey || rawValue.length === 0)
+            continue;
+        const key = rawKey.trim();
+        const value = rawValue.join(':').trim();
+        if (!value)
+            continue;
+        if (key === 'id')
+            parsed.id = stripQuotes(value);
+        if (key === 'title')
+            parsed.title = stripQuotes(value);
+        if (key === 'summary')
+            parsed.summary = stripQuotes(value);
+        if (key === 'status')
+            parsed.status = stripQuotes(value);
+        if (key === 'tags')
+            parsed.tags = parseTags(value);
+    }
+    return { frontmatter: parsed, body };
+}
+function parseTags(value) {
+    const trimmed = value.trim();
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        return trimmed
+            .slice(1, -1)
+            .split(',')
+            .map(part => stripQuotes(part.trim()))
+            .filter(Boolean);
+    }
+    return trimmed
+        .split(',')
+        .map(part => stripQuotes(part.trim()))
+        .filter(Boolean);
+}
+function extractFirstHeading(body) {
+    for (const line of body.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('# '))
+            return trimmed.slice(2).trim();
+    }
+    return null;
+}
+function basenameTitle(filePath) {
+    return path.basename(filePath, '.md')
+        .replace(/[-_]+/g, ' ')
+        .replace(/\b\w/g, ch => ch.toUpperCase());
+}
+function tokenize(text) {
+    return [...new Set(text
+            .toLowerCase()
+            .split(/[^a-z0-9]+/g)
+            .map(part => part.trim())
+            .filter(part => part.length >= 3))];
+}
+function scoreDocument(document, tokens) {
+    const title = document.title.toLowerCase();
+    const summary = document.summary?.toLowerCase() ?? '';
+    const body = document.content.toLowerCase();
+    const tags = (document.tags ?? []).join(' ').toLowerCase();
+    let score = 0;
+    for (const token of tokens) {
+        if (title.includes(token))
+            score += 8;
+        if (tags.includes(token))
+            score += 6;
+        if (summary.includes(token))
+            score += 5;
+        if (body.includes(token))
+            score += 2;
+    }
+    if (document.status === 'approved')
+        score += 2;
+    if (document.status === 'provisional')
+        score += 1;
+    return score;
+}
+function compareUpdatedAtDesc(a, b) {
+    if (!a && !b)
+        return 0;
+    if (!a)
+        return 1;
+    if (!b)
+        return -1;
+    return b.localeCompare(a);
+}
+function stripQuotes(value) {
+    return value.replace(/^['"]|['"]$/g, '');
+}
+function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/managed/knowledge.js.map

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

package/dist/managed/memory-manager.d.ts

@@ -0,0 +1,7 @@
+import type { StorageAdapter, Memory } from '../types.js';
+/**
+ * Load memories from storage adapter, formatted for prompt injection.
+ */
+export declare function loadMemories(adapter: StorageAdapter, budget?: number, pinnedFirst?: boolean): Promise<Memory[]>;
+export declare function expandPromptMemoryLoadBudget(budget: number): number;
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/managed/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../../src/managed/memory-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAIzD;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,MAAM,GAAE,MAAa,EACrB,WAAW,GAAE,OAAc,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKnE"}

package/dist/managed/memory-manager.js

@@ -0,0 +1,18 @@
+const PROMPT_MEMORY_LOAD_BUDGET_MULTIPLIER = 3;
+const PROMPT_MEMORY_LOAD_BUDGET_MIN = 12000;
+/**
+ * Load memories from storage adapter, formatted for prompt injection.
+ */
+export async function loadMemories(adapter, budget = 8000, pinnedFirst = true) {
+    return adapter.loadMemories({
+        // Adapters should return a candidate set, not the final prompt-trimmed slice.
+        // We intentionally overfetch here so Archetype's salience-aware selection can
+        // decide what survives the actual prompt budget.
+        budget: expandPromptMemoryLoadBudget(budget),
+        pinnedFirst,
+    });
+}
+export function expandPromptMemoryLoadBudget(budget) {
+    return Math.max(Math.ceil(budget * PROMPT_MEMORY_LOAD_BUDGET_MULTIPLIER), PROMPT_MEMORY_LOAD_BUDGET_MIN);
+}
+//# sourceMappingURL=memory-manager.js.map

package/dist/managed/memory-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.js","sourceRoot":"","sources":["../../src/managed/memory-manager.ts"],"names":[],"mappings":"AACA,MAAM,oCAAoC,GAAG,CAAC,CAAA;AAC9C,MAAM,6BAA6B,GAAG,KAAK,CAAA;AAE3C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAuB,EACvB,SAAiB,IAAI,EACrB,cAAuB,IAAI;IAE3B,OAAO,OAAO,CAAC,YAAY,CAAC;QAC1B,8EAA8E;QAC9E,8EAA8E;QAC9E,iDAAiD;QACjD,MAAM,EAAE,4BAA4B,CAAC,MAAM,CAAC;QAC5C,WAAW;KACZ,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,OAAO,IAAI,CAAC,GAAG,CACb,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,oCAAoC,CAAC,EACxD,6BAA6B,CAC9B,CAAA;AACH,CAAC"}

package/dist/managed/memory-review.d.ts

@@ -0,0 +1,45 @@
+import type { StorageAdapter, LLMProvider } from '../types.js';
+export interface MemoryReviewOptions {
+    adapter: StorageAdapter;
+    provider: LLMProvider;
+    /** Only review memories older than this many days (default: 7) */
+    maxAge?: number;
+    /** Preserve pinned memories from review (default: true) */
+    preservePinned?: boolean;
+    /** Memory budget for loading (default: 16000 — we load more than prompt budget for review) */
+    loadBudget?: number;
+    /** Explain what these memories are for across future conversations. */
+    memoryPurpose?: string;
+    /** Domain-specific memory categories with descriptions. */
+    categoryDescriptions?: Record<string, string>;
+    /** Memory scope to review: 'user' (default) or 'craft'. Craft memories use a higher bar for removal. */
+    scope?: 'user' | 'craft';
+}
+export interface MemoryReviewResult {
+    /** Number of old memories removed */
+    removed: number;
+    /** Number of reviewed memories created */
+    created: number;
+}
+/**
+ * Review old, non-pinned memories by sending them to the LLM for dedup/consolidation
+ * and anti-boxing cleanup.
+ *
+ * The app decides when to call this (manual trigger, schedule, etc.).
+ * Archetype provides the logic but not the scheduling.
+ *
+ * Flow:
+ * 1. Load all memories from adapter
+ * 2. Filter to old, non-pinned memories (candidates for review)
+ * 3. If no candidates, skip
+ * 4. Send to LLM for consolidation
+ * 5. Delete old candidates, save reviewed results
+ */
+export declare function reviewMemories(options: MemoryReviewOptions): Promise<MemoryReviewResult>;
+/** @deprecated Use reviewMemories instead */
+export declare const compactMemories: typeof reviewMemories;
+/** @deprecated Use MemoryReviewOptions instead */
+export type CompactMemoriesOptions = MemoryReviewOptions;
+/** @deprecated Use MemoryReviewResult instead */
+export type CompactMemoriesResult = MemoryReviewResult;
+//# sourceMappingURL=memory-review.d.ts.map

package/dist/managed/memory-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-review.d.ts","sourceRoot":"","sources":["../../src/managed/memory-review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAU,WAAW,EAAE,MAAM,aAAa,CAAA;AAEtE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAA;IACvB,QAAQ,EAAE,WAAW,CAAA;IACrB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,2DAA2D;IAC3D,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7C,wGAAwG;IACxG,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAA;CAChB;AAyCD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAoG7B;AAED,6CAA6C;AAC7C,eAAO,MAAM,eAAe,uBAAiB,CAAA;AAC7C,kDAAkD;AAClD,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,CAAA;AACxD,iDAAiD;AACjD,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAA"}

package/dist/managed/memory-review.js

@@ -0,0 +1,130 @@
+function buildReviewPrompt(options) {
+    const isCraft = options.scope === 'craft';
+    const sections = isCraft
+        ? [
+            'You are doing a quiet cleanup pass on an AI assistant\'s craft memories — professional growth observations about its own practice.',
+            'These memories are transferable across users. The bar for removal is higher than user memories: only remove genuine duplicates or observations that turned out to be situational noise, not real patterns.',
+        ]
+        : [
+            'You are doing a quiet memory cleanup pass for an AI assistant.',
+            'Your job is to turn a noisy list of extracted memories into the smaller, sharper set the assistant would actually want to carry forward into future conversations.',
+        ];
+    if (options.memoryPurpose?.trim()) {
+        sections.push(`MEMORY PURPOSE:\n${options.memoryPurpose.trim()}`);
+    }
+    if (options.categoryDescriptions && Object.keys(options.categoryDescriptions).length > 0) {
+        const categoryGuide = Object.entries(options.categoryDescriptions)
+            .map(([name, description]) => `- ${name}: ${description}`)
+            .join('\n');
+        sections.push(`MEMORY CATEGORIES:\n${categoryGuide}`);
+    }
+    sections.push(`CLEANUP GUIDANCE:
+- Merge only genuine duplicates and near-duplicates — two memories that say the same thing become the single strongest version. Two memories that say different things both stay.
+- Drop only memories that are pure transcript, changelog, or a one-off situational note with no lasting signal.
+- Everything else that would still help a future conversation stays. There is no target count and shrinking the list is not the goal — keep the set as large as the real, distinct, useful facts require. Sharpen, don't shrink.
+- A stated user fact is ground truth. A preference, routine, recipe (with its amounts), or aversion the user told you — especially source=user, stability=durable — may be tightened in wording but must NEVER be negated, inverted, weakened into something vaguer, merged into a different fact, or dropped. When unsure whether something is a firm preference or a rigid rule, treat it as a fact and keep it exactly.
+- Soften only genuine BEHAVIORAL boxing: a memory that hard-codes how the assistant must act in a situation regardless of context ("always suggest X when Y"). Rewrite those toward the underlying preference. Never confuse "the user always eats X" (a fact — keep it verbatim in meaning) with "always do X" (a rule — soften it). Getting this wrong inverts the person's real preferences, which is the worst thing this pass can do.
+- Respect memory metadata when present:
+  - source=user carries more authority than source=suggested
+  - stability=temporary should rarely survive unless the situation is still active
+  - contextHint should stay compact — keep only what is needed for future interpretation
+- Preserve the best-fit category, and preserve or improve source/stability/contextHint when useful.
+- Return valid JSON: { "compacted": [{ "content": "...", "category": "...", "source": "user|inferred|suggested", "stability": "durable|tentative|temporary", "contextHint": "..." }] }`);
+    return sections.join('\n\n');
+}
+/**
+ * Review old, non-pinned memories by sending them to the LLM for dedup/consolidation
+ * and anti-boxing cleanup.
+ *
+ * The app decides when to call this (manual trigger, schedule, etc.).
+ * Archetype provides the logic but not the scheduling.
+ *
+ * Flow:
+ * 1. Load all memories from adapter
+ * 2. Filter to old, non-pinned memories (candidates for review)
+ * 3. If no candidates, skip
+ * 4. Send to LLM for consolidation
+ * 5. Delete old candidates, save reviewed results
+ */
+export async function reviewMemories(options) {
+    const { adapter, provider, maxAge = 7, preservePinned = true, loadBudget = 16000, memoryPurpose, categoryDescriptions, scope = 'user', } = options;
+    // 1. Load all memories (scoped)
+    const allMemories = scope === 'craft' && adapter.loadCraftMemories
+        ? await adapter.loadCraftMemories({ budget: loadBudget })
+        : await adapter.loadMemories({ budget: loadBudget, pinnedFirst: false });
+    // 2. Filter candidates: old + non-pinned
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - maxAge);
+    const cutoffStr = cutoff.toISOString();
+    const candidates = allMemories.filter(m => {
+        if (preservePinned && m.pinned)
+            return false;
+        if (!m.createdAt)
+            return true; // no timestamp = old enough
+        return m.createdAt < cutoffStr;
+    });
+    if (candidates.length === 0) {
+        return { removed: 0, created: 0 };
+    }
+    // 3. Build prompt with candidates
+    const memoryList = candidates
+        .map(m => {
+        const meta = [];
+        if (m.source)
+            meta.push(`source:${m.source}`);
+        if (m.stability)
+            meta.push(`stability:${m.stability}`);
+        const metaText = meta.length > 0 ? ` | ${meta.join(' | ')}` : '';
+        const contextText = m.contextHint?.trim() ? ` (context: ${m.contextHint.trim()})` : '';
+        return `[${m.category}${metaText}] ${m.content}${contextText}`;
+    })
+        .join('\n');
+    const label = scope === 'craft' ? 'craft memories' : 'memories';
+    const message = `Here are ${candidates.length} ${label} to compact:\n\n${memoryList}`;
+    // 4. Call LLM
+    const response = await provider.chat({
+        systemPrompt: buildReviewPrompt({ memoryPurpose, categoryDescriptions, scope }),
+        history: [],
+        message,
+    });
+    // 5. Parse response
+    let compacted;
+    try {
+        const parsed = JSON.parse(response.text);
+        compacted = parsed.compacted ?? [];
+    }
+    catch {
+        console.error('[archetype] Failed to parse memory review response:', response.text);
+        return { removed: 0, created: 0 };
+    }
+    if (compacted.length === 0) {
+        return { removed: 0, created: 0 };
+    }
+    // 6. Delete old candidates
+    const deleteFn = scope === 'craft' && adapter.deleteCraftMemory
+        ? adapter.deleteCraftMemory.bind(adapter)
+        : adapter.deleteMemory.bind(adapter);
+    for (const m of candidates) {
+        await deleteFn(m.id);
+    }
+    // 7. Save reviewed memories
+    const saveFn = scope === 'craft' && adapter.saveCraftMemory
+        ? (mem) => adapter.saveCraftMemory(mem)
+        : (mem) => adapter.saveMemory(mem);
+    for (const m of compacted) {
+        await saveFn({
+            content: m.content,
+            category: m.category,
+            scope,
+            source: m.source,
+            stability: m.stability,
+            contextHint: m.contextHint,
+            pinned: false,
+            createdAt: new Date().toISOString(),
+        });
+    }
+    return { removed: candidates.length, created: compacted.length };
+}
+/** @deprecated Use reviewMemories instead */
+export const compactMemories = reviewMemories;
+//# sourceMappingURL=memory-review.js.map

package/dist/managed/memory-review.js.map

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

package/dist/managed/storage.d.ts

@@ -0,0 +1,2 @@
+export type { StorageAdapter, Conversation, Message, Memory, KnowledgeDocument, KnowledgeAdapter, KnowledgeSearchInput } from '../types.js';
+//# sourceMappingURL=storage.d.ts.map

package/dist/managed/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/managed/storage.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}

package/dist/managed/storage.js

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

package/dist/managed/storage.js.map

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

package/dist/managed/work-history.d.ts

@@ -0,0 +1,23 @@
+export type WorkHistorySource = 'self' | 'action' | 'world';
+export interface WorkHistoryEntry {
+    turn: number;
+    source: WorkHistorySource;
+    text: string;
+    /**
+     * Number of future turns that should see `text` before it decays to
+     * `staleText`. Defaults to durable text.
+     */
+    resultTurns?: number;
+    /**
+     * Compact recovery note shown after `resultTurns` has elapsed.
+     */
+    staleText?: string;
+}
+export interface RenderWorkHistoryOptions {
+    currentTurn: number;
+    maxEntries?: number;
+}
+export declare function renderWorkHistoryEntries(entries: readonly WorkHistoryEntry[], options: RenderWorkHistoryOptions): string[];
+export declare function renderWorkHistoryEntry(entry: WorkHistoryEntry, currentTurn: number): string;
+export declare function makeWorkHistoryEntry(input: WorkHistoryEntry): WorkHistoryEntry;
+//# sourceMappingURL=work-history.d.ts.map

package/dist/managed/work-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-history.d.ts","sourceRoot":"","sources":["../../src/managed/work-history.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,iBAAiB,CAAA;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,OAAO,EAAE,wBAAwB,GAChC,MAAM,EAAE,CAMV;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ3F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAM9E"}

package/dist/managed/work-history.js

@@ -0,0 +1,31 @@
+export function renderWorkHistoryEntries(entries, options) {
+    const maxEntries = options.maxEntries ?? 24;
+    const visible = entries.slice(-maxEntries);
+    if (visible.length === 0)
+        return ['(empty)'];
+    return visible.map(entry => renderWorkHistoryEntry(entry, options.currentTurn));
+}
+export function renderWorkHistoryEntry(entry, currentTurn) {
+    const source = entry.source;
+    const text = selectWorkHistoryText(entry, currentTurn);
+    const trimmed = text.trim();
+    if (trimmed.includes('\n')) {
+        return `turn ${entry.turn} · ${source}:\n${trimmed}`;
+    }
+    return `turn ${entry.turn} · ${source}: ${trimmed}`;
+}
+export function makeWorkHistoryEntry(input) {
+    return {
+        ...input,
+        text: input.text.trim(),
+        staleText: input.staleText?.trim(),
+    };
+}
+function selectWorkHistoryText(entry, currentTurn) {
+    if (!entry.staleText)
+        return entry.text;
+    const resultTurns = entry.resultTurns ?? 1;
+    const age = Math.max(0, currentTurn - entry.turn);
+    return age <= resultTurns ? entry.text : entry.staleText;
+}
+//# sourceMappingURL=work-history.js.map

package/dist/managed/work-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-history.js","sourceRoot":"","sources":["../../src/managed/work-history.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,wBAAwB,CACtC,OAAoC,EACpC,OAAiC;IAEjC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,EAAE,CAAA;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAA;IAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,SAAS,CAAC,CAAA;IAE5C,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAA;AACjF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAuB,EAAE,WAAmB;IACjF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;IAC3B,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,QAAQ,KAAK,CAAC,IAAI,MAAM,MAAM,MAAM,OAAO,EAAE,CAAA;IACtD,CAAC;IACD,OAAO,QAAQ,KAAK,CAAC,IAAI,MAAM,MAAM,KAAK,OAAO,EAAE,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAuB;IAC1D,OAAO;QACL,GAAG,KAAK;QACR,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;QACvB,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE;KACnC,CAAA;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAuB,EAAE,WAAmB;IACzE,IAAI,CAAC,KAAK,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC,IAAI,CAAA;IACvC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IACjD,OAAO,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAA;AAC1D,CAAC"}

package/dist/observability/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * archetype/observability — shared telemetry for autonomous-loop consumers.
+ *
+ * Two pieces today:
+ *   — createTurnReporter: onTurn hook that writes errors.jsonl +
+ *     diagnostics.md and emits loud stderr callouts. Replaces the
+ *     inline onTurn boilerplate every benchmark harness wrote.
+ *   — renderRunMarkdown: pure renderer that turns a collection of
+ *     prompt traces + errors + score into a turn-by-turn markdown
+ *     report. Host CLI owns file I/O (where traces come from, where
+ *     the report gets written).
+ */
+export * from './turn-reporter.js';
+export * from './render-run-markdown.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA"}

package/dist/observability/index.js

@@ -0,0 +1,15 @@
+/**
+ * archetype/observability — shared telemetry for autonomous-loop consumers.
+ *
+ * Two pieces today:
+ *   — createTurnReporter: onTurn hook that writes errors.jsonl +
+ *     diagnostics.md and emits loud stderr callouts. Replaces the
+ *     inline onTurn boilerplate every benchmark harness wrote.
+ *   — renderRunMarkdown: pure renderer that turns a collection of
+ *     prompt traces + errors + score into a turn-by-turn markdown
+ *     report. Host CLI owns file I/O (where traces come from, where
+ *     the report gets written).
+ */
+export * from './turn-reporter.js';
+export * from './render-run-markdown.js';
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA"}

package/dist/observability/render-run-markdown.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Render a benchmark run as a single turn-by-turn TURNS.md-style report.
+ *
+ * Purpose: the bug is almost always in the prompt the model received.
+ * Reading turn-by-turn should take ≤30 seconds and surface:
+ *   - the system prompt (deduped — appears once if constant across turns)
+ *   - per-turn input (as the model saw it)
+ *   - per-turn assistant emission (message verbatim + action summary)
+ *   - any errors (unknown action, schema fail) flagged inline
+ *   - a fingerprint header (turn count, action mix, errors)
+ *
+ * This module is pure: it takes structured data and returns a string.
+ * Path discovery (where traces live, where errors.jsonl sits, how to
+ * read a score) belongs to the host CLI — archetype/observability ships
+ * a renderer, not a file-system reader. See `parseTracePacket` if you
+ * want a quick way to hydrate traces from JSON files.
+ *
+ * Works in browsers and Node (no fs use here).
+ */
+export interface HistoryEntry {
+    role: string;
+    content: string | unknown;
+}
+export interface TracePacket {
+    traceGroup?: string;
+    transport?: string;
+    turn?: number;
+    phase?: string;
+    attempt?: number;
+    systemPrompt?: string;
+    message?: string;
+    history?: HistoryEntry[];
+    responseSchema?: unknown;
+}
+export interface AssistantAction {
+    name?: string;
+    params?: Record<string, unknown>;
+}
+export interface AssistantPayload {
+    message?: string;
+    actions?: AssistantAction[];
+    diagnostics?: string[];
+}
+export interface RunErrorEntry {
+    turn?: number;
+    kind?: string;
+    action?: string | null;
+    reason?: string;
+}
+export interface RunScoreSummary {
+    score?: number;
+    verdict?: string;
+    ship?: string;
+}
+export interface RenderRunMarkdownInput {
+    /** Run identifier for the report header. */
+    runId: string;
+    /** Optional run metadata (benchmarkId, artifactName, status). */
+    metadata?: {
+        benchmarkId?: string;
+        artifactName?: string;
+        status?: string;
+    };
+    /** Prompt traces for every turn (sorted by turn number ascending). */
+    traces: TracePacket[];
+    /** Error entries (as persisted to errors.jsonl). */
+    errors?: RunErrorEntry[];
+    /** Customer score (or any scoring surface) for the header. */
+    score?: RunScoreSummary | null;
+    /** Character budget per turn-input block. Default 1200. */
+    inputCharBudget?: number;
+}
+/**
+ * Render the final markdown. Returns the full TURNS.md body as a string.
+ * Host writes it wherever it wants.
+ */
+export declare function renderRunMarkdown(input: RenderRunMarkdownInput): string;
+/**
+ * Extract an AssistantPayload from a raw assistant-message string.
+ * Handles the common case of prose before a JSON object — everything
+ * before the first `{` is ignored.
+ */
+export declare function tryParseAssistantPayload(content: string): AssistantPayload | null;
+/**
+ * Compact one-line summary of an action: keeps reference keys (path,
+ * pattern, id, name, outcome, …) visible, drops bodies (content, stdout,
+ * image payloads). Used in the per-turn action list for fast scanning.
+ */
+export declare function summarizeAction(a: AssistantAction): string;
+//# sourceMappingURL=render-run-markdown.d.ts.map

package/dist/observability/render-run-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-run-markdown.d.ts","sourceRoot":"","sources":["../../src/observability/render-run-markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,iEAAiE;IACjE,QAAQ,CAAC,EAAE;QACT,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,sEAAsE;IACtE,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,oDAAoD;IACpD,MAAM,CAAC,EAAE,aAAa,EAAE,CAAA;IACxB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IAC9B,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CA0FvE;AAoFD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CASjF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CAmB1D"}