@asermax/tachikoma 2.0.0

package/dist/extensions/memory/extraction.js

@@ -0,0 +1,218 @@
+import { localIsoDate } from "./dates.js";
+import { storeDir, sweepEmptyMarkdown } from "./layout.js";
+import { CLASSIFICATION_EXAMPLES_SECTION, CONTEXT_DEDUP_SECTION, INDEX_UPDATE_SECTION, STORE_PURPOSE_SECTION, scopeSection, WORKSPACE_VALIDATION_SECTION, } from "./prompts.js";
+import { loadConversation } from "./transcript.js";
+export const MEMORY_FILE_TOOLS = ["read", "grep", "find", "ls", "edit", "write"];
+const EPISODIC_BASE_PROMPT = `You are a memory extraction agent. Your task is to analyze the conversation that just ended and create or update the episodic memory file for today.
+
+Today's date is {date}.
+
+## Instructions
+
+1. **Read existing files** in \`$WORKSPACE/memories/episodic/\` to see what's there.
+
+2. Analyze the conversation for meaningful events, discussions, and activities.
+
+3. **Write to exactly one file per day: \`{date}.md\`.**
+   - The ONLY valid filename is the date itself. No suffixes, no variants. \`{date}.md\` is correct. \`{date}-consolidated.md\`, \`{date}-final.md\`, \`{date}-updated.md\` are ALL WRONG — never create files like these.
+   - If \`{date}.md\` already exists, READ it first, then EDIT it to merge the new information into the existing content. Do not create a second file.
+   - If it does not exist, create \`{date}.md\`.
+
+4. **Keep entries short and scannable:**
+   - One heading per session or topic, not per conversational turn
+   - 2-5 bullet points per heading capturing key outcomes
+   - Target: 30-80 lines per day, even for busy days with many sessions
+   - DO NOT include: verbatim quotes, step-by-step technical details, full lists of files changed, implementation specifics, or routine activity status
+
+5. **Cleanup duty**: If you see files that don't match the \`YYYY-MM-DD.md\` pattern (e.g., files with \`-consolidated\`, \`-final\`, \`-updated\` suffixes), merge any useful content into the correct \`YYYY-MM-DD.md\` file and empty the variant so it gets cleaned up. This corrects filename format violations — episodic entries are never deleted based on their content.
+
+6. **Important constraints**:
+   - Only create or modify files within \`$WORKSPACE/memories/episodic/\`
+   - If the conversation was trivial or contained no meaningful information, it is perfectly acceptable to create no files
+
+Remember: These memories help the assistant maintain context across sessions. Focus on what would be useful to remember, not a transcript of what happened.`;
+const FACTS_BASE_PROMPT = `You are a memory extraction agent. Your task is to analyze the conversation and extract or update factual information that would be useful to remember for future conversations.
+
+## Instructions
+
+1. **Read existing files** in \`$WORKSPACE/memories/facts/\` to see what facts are already stored.
+
+2. Analyze the conversation for STABLE REFERENCE INFORMATION — things that stay true across conversations:
+   - Personal details about the user (job, location, family, contacts)
+   - Important dates, deadlines, or upcoming events
+   - Stable routines or commitments (structure only, not daily logs)
+   - Key people and their roles/relationships
+   - Technical decisions or configurations that affect future work
+   - Account info, service subscriptions, tool setups
+
+   DO NOT store as facts:
+   - Daily activity logs or status updates (that's episodic memory)
+   - One-time events: bug fixes, security incidents, feature completions, outages, deployment events — these happened once on a specific date and belong in episodic memory, not here
+   - Full design documents, specs, or game mechanics (project files)
+   - Anything longer than ~40 lines — if it needs that much space, it's not a fact, it's a document
+
+3. **Before creating a new file**, search for existing overlap:
+   - Use the grep tool to search existing files for the key topic or keywords
+   - If an existing file covers the same topic, UPDATE that file instead of creating a new one
+   - If information is spread across multiple files about the same topic, MERGE them into one file and delete the others
+
+4. **File Consolidation at Write Time**:
+   Before creating any new file, follow this mandatory sequence:
+   - First, list the target directory \`$WORKSPACE/memories/facts/\` with the ls tool.
+   - Identify which existing file (if any) covers the broadest topic that encompasses the new information. Match by project name, system name, tool, or domain — not by incident, date, or specific event.
+   - If a broad-topic file exists, UPDATE that file. Do NOT create an incident- or date-specific sibling alongside it (e.g., if \`<project>.md\` exists, do not also create \`<project>-<bug-description>-<YYYY-MM-DD>.md\`).
+   - If multiple existing files cover overlapping aspects of the same topic, prefer the most specific existing file that still covers the new information broadly — and consider merging the narrower ones into it.
+   - Only create a new file when NO existing file covers the topic. When you do create one, choose a broad topic name that future related extracts can merge into — \`<project>.md\`, \`<system>.md\`, \`<tool>.md\`, \`<domain>.md\` — never a name scoped to one incident, bug, patch, or date.
+   - Positive examples (broad, future-mergeable): \`<project>.md\`, \`<system>.md\`, \`<tool>.md\`, \`<domain>.md\`, \`work-info.md\`, \`tech-stack.md\`.
+   - Negative examples (forbidden — too narrow): \`<project>-<bug-description>-<YYYY-MM-DD>.md\`, \`<project>-patch-<issue-id>.md\`, \`<system>-<incident>-<date>.md\`, \`<topic>-session-<date>.md\`.
+
+5. Manage the fact files:
+   - Create new files with descriptive names ONLY when no existing file covers the topic
+   - Update existing files when new information extends what's there
+   - **Merge** files that overlap in topic — combine into one, delete the rest
+   - **Delete** files that are outdated, redundant, or better covered elsewhere
+   - When updating a file, READ it first. If a section already covers what you're about to add, update that section rather than appending a duplicate
+
+6. **Prune stale and redundant entries**:
+   - After reading existing files, actively look for entries that may be outdated or no longer accurate based on the conversation:
+     - Information contradicted by new statements (e.g., file says "works at Company A" but conversation reveals a move to Company B)
+     - References to completed projects, past roles, or expired commitments that the conversation confirms are done
+     - Entries about tools, services, or setups the user no longer uses
+   - When you find stale entries: update them if new information replaces the old, or delete the file if the entire topic is no longer relevant
+   - **Do NOT prune based on**: vague hints ("I might switch..."), old dates alone (age is not staleness), or assumptions not backed by conversation evidence
+
+7. Each fact file should contain:
+   - Clear, factual statements
+   - Relevant context or details
+   - Keep files under 40 lines. If a topic needs more detail, the detail probably belongs in a project file, not in facts memory.
+
+8. **Important constraints**:
+   - Only create or modify files within \`$WORKSPACE/memories/facts/\`
+   - Use descriptive, topic-based filenames (not dates). Good names: \`work-info.md\`, \`key-people.md\`, \`tech-stack.md\`. Bad names that indicate the content belongs in episodic: \`2026-04-15-outage.md\`, \`bug-fix-session.md\`, \`security-incident-april.md\`. For per-incident fragmentation patterns to avoid, see step 4's negative examples.
+   - If no new factual information emerged from the conversation, it is perfectly acceptable to create no files
+   - Do not infer facts that weren't explicitly stated — only record what was actually shared or discussed
+   - Before writing a fact, ask: "Will this still be useful in a month?" If no — it describes something that happened once, has a specific date, or is a record of an event — it belongs in episodic memory, not here
+
+Remember: These memories help the assistant maintain context across sessions. Focus on accurate, stable reference information — not activity logs or documents.`;
+const PREFERENCES_BASE_PROMPT = `You are a memory extraction agent. Your task is to analyze the conversation and extract or update the user's expressed preferences.
+
+## Instructions
+
+1. **Read existing files** in \`$WORKSPACE/memories/preferences/\` to see what preferences are already stored. Also read \`$WORKSPACE/AGENTS.md\` if it exists — this file contains operational instructions and workflow preferences. If it doesn't exist or is empty, proceed normally — this check is purely to avoid duplication.
+
+2. Analyze the conversation for SUBJECTIVE CHOICES about how things should be done:
+   - How they like things done (communication style, workflows, formats)
+   - Approaches they prefer or want to avoid
+   - Tool, framework, or methodology preferences
+   - Scheduling or organizational preferences
+
+   A preference is NOT:
+   - A factual detail (job title, project architecture) → facts memory
+   - A design decision or spec (game mechanics, system rules) → project files
+   - A behavioral instruction for the assistant → AGENTS.md context file
+   - A detailed description of a system or project → too detailed for prefs
+   - An implementation detail or system behavior (how something works technically) → facts memory or project docs
+   - A bug report, resolved issue, or one-time fix → transient, not a lasting preference
+   - **Financial reference data** (payment structures, rates, fee schedules, reconciliation procedures) → facts memory
+   - **Technical specifications** (environment variables, SDK/API limitations, tool capabilities, system requirements) → facts memory
+   - **Procedural workflows** (cleanup steps, diagnostic procedures, deployment sequences) → facts memory
+   - **System configuration records** (what was configured, where, with what values) → facts memory
+
+2b. **Classification self-check**: Before writing any file, ask yourself: "Is this describing HOW SOMETHING WORKS (a fact) or HOW THE USER WANTS IT DONE (a preference)?"
+   - "How it works" → route to facts memory — do NOT create a preferences file
+   - "How the user wants it done" → valid preference, proceed
+   - When uncertain, prefer facts over preferences — objective information does not become a preference just because the user mentioned it
+
+3. **Before creating a new file**, search for existing overlap:
+   - Use the grep tool to search existing files for the key topic or keywords
+   - Also search \`$WORKSPACE/AGENTS.md\` for the same topic. If AGENTS.md already captures the preference (even in different words), skip creating a new file — the information is already stored where it belongs
+   - If an existing file covers the same topic, UPDATE that file instead of creating a new one
+   - If the same preference appears in multiple files, consolidate into the most specific file and remove it from the others
+
+4. **File Consolidation at Write Time**:
+   Before creating any new file, follow this mandatory sequence:
+   - First, list the target directory \`$WORKSPACE/memories/preferences/\` with the ls tool.
+   - Identify which existing file (if any) covers the broadest preference topic that encompasses the new information. Match by topic area (style, workflow, communication, tooling), project, system, or domain — not by a specific occasion, date, or one-off interaction.
+   - If a broad-topic file exists, UPDATE that file. Do NOT create an occasion- or date-specific sibling alongside it (e.g., if \`<topic-area>-style.md\` exists, do not also create \`<topic-area>-feedback-<YYYY-MM-DD>.md\`).
+   - If multiple existing files cover overlapping aspects of the same topic, prefer the most specific existing file that still covers the new information broadly — and consider merging the narrower ones into it.
+   - Only create a new file when NO existing file covers the topic. When you do create one, choose a broad topic name that future related extracts can merge into — \`<topic-area>-style.md\`, \`<topic-area>-workflow.md\`, \`<domain>.md\`, \`<project>.md\` — never a name scoped to one occasion, feedback moment, or date.
+   - Positive examples (broad, future-mergeable): \`<topic-area>-style.md\`, \`<topic-area>-workflow.md\`, \`<domain>.md\`, \`<project>.md\`, \`communication-style.md\`, \`code-formatting.md\`.
+   - Negative examples (forbidden — too narrow): \`<topic-area>-feedback-<YYYY-MM-DD>.md\`, \`<project>-preference-<issue-id>.md\`, \`<topic-area>-session-<date>.md\`, \`<one-off>-incident-<date>.md\`.
+
+5. Manage the preference files:
+   - Create new files with descriptive names ONLY when no existing file covers the topic
+   - When updating a file, READ it first. If it already says what you're about to add, do not add it again. If it says something similar in different words, REPLACE the old version — don't add a second version.
+   - Delete or merge files that overlap
+   - Each file should have ONE clear statement per preference, not multiple sections restating the same thing in different words
+
+6. **Prune stale and reversed preferences**:
+   - After reading existing files, actively look for preferences that may no longer reflect the user's current stance:
+     - Reversed preferences (e.g., file says "prefers dark mode" but user now says "I switched to light mode")
+     - Preferences about tools or workflows the user has explicitly moved away from
+     - Preferences that the conversation contradicts with clear, stated alternatives
+   - When you find stale preferences: update the file if the user expressed a new preference on the same topic, or delete the file if the preference topic is no longer relevant
+   - **Do NOT prune based on**: vague hints ("I might try..."), single exceptions to general rules, or assumptions not backed by conversation evidence
+
+7. Each preference file should contain:
+   - A clear statement of the preference
+   - Brief context or an example (1-2 sentences)
+   - When appropriate, how strongly the preference is held
+   - Keep files under 30 lines. A preference that takes more to express is probably a spec or design document, not a preference.
+
+8. **Important constraints**:
+   - Only create or modify files within \`$WORKSPACE/memories/preferences/\`
+   - Use descriptive, topic-based filenames (not dates). Good names: \`communication-style.md\`, \`code-formatting.md\`, \`<topic-area>-workflow.md\`. For per-occasion fragmentation patterns to avoid, see step 4's negative examples.
+   - If no preference-related information emerged from the conversation, it is perfectly acceptable to create no files
+   - Do not infer preferences from silence — only record what the user actually expressed
+
+Remember: These memories help the assistant tailor its approach to the user's preferences. Focus on genuine, stated choices — not facts, specs, or instructions.`;
+const STORE_PROMPTS = {
+    episodic: [EPISODIC_BASE_PROMPT, scopeSection("episodic")].join("\n\n"),
+    facts: [
+        FACTS_BASE_PROMPT,
+        CLASSIFICATION_EXAMPLES_SECTION,
+        STORE_PURPOSE_SECTION,
+        CONTEXT_DEDUP_SECTION,
+        WORKSPACE_VALIDATION_SECTION,
+        INDEX_UPDATE_SECTION,
+        scopeSection("facts"),
+    ].join("\n\n"),
+    preferences: [
+        PREFERENCES_BASE_PROMPT,
+        CLASSIFICATION_EXAMPLES_SECTION,
+        STORE_PURPOSE_SECTION,
+        CONTEXT_DEDUP_SECTION,
+        WORKSPACE_VALIDATION_SECTION,
+        INDEX_UPDATE_SECTION,
+        scopeSection("preferences"),
+    ].join("\n\n"),
+};
+export const extractionSystemPrompt = (store, workspaceRoot) => STORE_PROMPTS[store].replaceAll("$WORKSPACE", workspaceRoot).replaceAll("{date}", localIsoDate());
+export const conversationPrompt = (conversation) => `The following conversation with the user just ended:\n\n<conversation>\n${conversation}\n</conversation>\n\nFollow your instructions and update the memory files accordingly.`;
+/**
+ * Session-close extraction: re-reads the session transcript and runs a headless
+ * agent with file tools to fold the conversation into one memory store.
+ */
+export const createExtractionProcessor = (store, { side, workspaceRoot, maxTranscriptChars }) => ({
+    name: `memory-${store}`,
+    phase: "main",
+    async process({ transcriptPath, log }) {
+        if (transcriptPath == null) {
+            log.debug({ store }, "no transcript — skipping memory extraction");
+            return;
+        }
+        const conversation = await loadConversation(transcriptPath, maxTranscriptChars);
+        if (conversation === "") {
+            log.debug({ store }, "empty conversation — skipping memory extraction");
+            return;
+        }
+        await side.run({
+            tools: MEMORY_FILE_TOOLS,
+            system: extractionSystemPrompt(store, workspaceRoot),
+            prompt: conversationPrompt(conversation),
+            tier: "processor",
+        });
+        await sweepEmptyMarkdown(storeDir(workspaceRoot, store), log);
+    },
+});
+//# sourceMappingURL=extraction.js.map

package/dist/extensions/memory/extraction.js.map

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

package/dist/extensions/memory/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Long-term memory: a git-versioned markdown store under workspace `memories/`
+ * (episodic, facts, preferences, transcripts). Injects a static index of the
+ * store on every message, extracts memories at session close, archives the pi
+ * transcript, and consolidates the store on a nightly schedule.
+ */
+declare const _default: import("../api.ts").TachikomaExtension<{
+    enabled: boolean;
+    maxTranscriptChars: number;
+    maintenance: {
+        enabled: boolean;
+        recentDays: number;
+        weeklyThresholdMonths: number;
+        monthlyThresholdMonths: number;
+        episodicSchedule: string;
+        factsSchedule: string;
+        preferencesSchedule: string;
+    };
+}>;
+export default _default;

package/dist/extensions/memory/index.js

@@ -0,0 +1,67 @@
+import { Type } from "typebox";
+import { defineExtension } from "../api.js";
+import { createCoreContextProcessor } from "../context/processor.js";
+import { createTranscriptArchiveProcessor } from "./archive.js";
+import { createExtractionProcessor } from "./extraction.js";
+import { createMemoryIndexProvider } from "./indexes.js";
+import { ensureMemoryLayout, MEMORY_STORES } from "./layout.js";
+import { runMaintenanceTick } from "./maintenance.js";
+const MemoryConfigSchema = Type.Object({
+    enabled: Type.Boolean({ default: true }),
+    /** Cap on the rendered conversation injected into extraction prompts (tail-priority). */
+    maxTranscriptChars: Type.Number({ default: 24000 }),
+    maintenance: Type.Object({
+        enabled: Type.Boolean({ default: true }),
+        // Staggered so the three headless agent runs don't pile up at the same minute.
+        episodicSchedule: Type.String({ default: "0 3 * * *" }),
+        factsSchedule: Type.String({ default: "20 3 * * *" }),
+        preferencesSchedule: Type.String({ default: "40 3 * * *" }),
+        recentDays: Type.Number({ default: 15 }),
+        weeklyThresholdMonths: Type.Number({ default: 3 }),
+        monthlyThresholdMonths: Type.Number({ default: 12 }),
+    }, { default: {} }),
+});
+/**
+ * Long-term memory: a git-versioned markdown store under workspace `memories/`
+ * (episodic, facts, preferences, transcripts). Injects a static index of the
+ * store on every message, extracts memories at session close, archives the pi
+ * transcript, and consolidates the store on a nightly schedule.
+ */
+export default defineExtension({
+    name: "memory",
+    configSchema: MemoryConfigSchema,
+    setup(app) {
+        if (!app.extensionConfig.enabled) {
+            app.log.info("memory extension disabled by configuration");
+            return;
+        }
+        const workspaceRoot = app.workspace.root;
+        app.bootstrap("init-memory-layout", () => ensureMemoryLayout(workspaceRoot, app.log));
+        app.agent.provideContext(createMemoryIndexProvider(workspaceRoot));
+        const extraction = {
+            side: app.agent.side,
+            workspaceRoot,
+            maxTranscriptChars: app.extensionConfig.maxTranscriptChars,
+        };
+        for (const store of MEMORY_STORES) {
+            app.sessions.registerProcessor(createExtractionProcessor(store, extraction));
+        }
+        // Registered here for now — once the context extension grows its own
+        // processor wiring this registration belongs in context/index.ts.
+        app.sessions.registerProcessor(createCoreContextProcessor({
+            side: app.agent.side,
+            workspaceRoot,
+            dataDir: app.workspace.dataDir,
+            maxTranscriptChars: app.extensionConfig.maxTranscriptChars,
+        }));
+        app.sessions.registerProcessor(createTranscriptArchiveProcessor(workspaceRoot));
+        const { maintenance } = app.extensionConfig;
+        if (maintenance.enabled) {
+            const deps = { side: app.agent.side, workspaceRoot, settings: maintenance, log: app.log };
+            app.scheduler.cron("memory-episodic-maintenance", maintenance.episodicSchedule, () => runMaintenanceTick("episodic", deps));
+            app.scheduler.cron("memory-facts-maintenance", maintenance.factsSchedule, () => runMaintenanceTick("facts", deps));
+            app.scheduler.cron("memory-preferences-maintenance", maintenance.preferencesSchedule, () => runMaintenanceTick("preferences", deps));
+        }
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/extensions/memory/index.js.map

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

package/dist/extensions/memory/indexes.d.ts

@@ -0,0 +1,14 @@
+import type { ContextProvider } from "../api.ts";
+import { type MemoryStore } from "./layout.ts";
+/**
+ * Format a MEMORY.md file's raw content into an injectable section. Entries
+ * must match "[Name](./path.md): description"; malformed lines are skipped.
+ * Returns null when the file has no usable entries.
+ */
+export declare const formatMemoryIndex: (store: MemoryStore, rawContent: string) => string | null;
+/**
+ * Static memory index injection: the workspace layout plus the parsed facts and
+ * preferences MEMORY.md indexes, so the agent knows what exists and reads files
+ * on demand instead of getting everything inlined.
+ */
+export declare const createMemoryIndexProvider: (workspaceRoot: string) => ContextProvider;

package/dist/extensions/memory/indexes.js

@@ -0,0 +1,64 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { fileExists, INDEXED_STORES, MEMORY_INDEX_FILENAME, memoriesRoot, storeDir, } from "./layout.js";
+const INDEX_ENTRY_RE = /^\[([^\]]+)\]\(\.\/([^)]+\.md)\):\s*(.+)$/gm;
+const STORE_DESCRIPTIONS = {
+    facts: "Stable reference information: personal details, key people, technical decisions.\nBrowse the entries below. When a file seems relevant to the current conversation,\nread it with the read tool to get the full content.",
+    preferences: "Subjective choices about how things should be done.\nBrowse the entries below. When a file seems relevant to the current conversation,\nread it with the read tool to get the full content.",
+};
+const LAYOUT_SECTION = `## Memory
+
+The workspace keeps long-term memory as markdown files under \`memories/\`:
+
+- \`memories/episodic/\` — date-stamped conversation summaries (\`YYYY-MM-DD.md\`, plus weekly \`YYYY-WNN.md\` and monthly \`YYYY-MM.md\` rollups)
+- \`memories/facts/\` — stable reference information, one topic per file, indexed in \`MEMORY.md\`
+- \`memories/preferences/\` — the user's expressed preferences, one topic per file, indexed in \`MEMORY.md\`
+
+None of these files are loaded automatically. When the conversation touches a topic that might be covered there, grep or read the relevant memory files on demand.`;
+const capitalize = (value) => value.charAt(0).toUpperCase() + value.slice(1);
+/**
+ * Format a MEMORY.md file's raw content into an injectable section. Entries
+ * must match "[Name](./path.md): description"; malformed lines are skipped.
+ * Returns null when the file has no usable entries.
+ */
+export const formatMemoryIndex = (store, rawContent) => {
+    const entries = [...rawContent.matchAll(INDEX_ENTRY_RE)].map((match) => match[0]);
+    if (entries.length === 0)
+        return null;
+    const description = STORE_DESCRIPTIONS[store] ??
+        "Browse the entries below. When a file seems relevant, read it with the read tool.";
+    return [
+        `## ${capitalize(store)} Index`,
+        "",
+        description,
+        "",
+        ...entries.map((entry) => `- ${entry}`),
+    ].join("\n");
+};
+/**
+ * Static memory index injection: the workspace layout plus the parsed facts and
+ * preferences MEMORY.md indexes, so the agent knows what exists and reads files
+ * on demand instead of getting everything inlined.
+ */
+export const createMemoryIndexProvider = (workspaceRoot) => ({
+    name: "memory-index",
+    async provide() {
+        if (!(await fileExists(memoriesRoot(workspaceRoot))))
+            return null;
+        const sections = [LAYOUT_SECTION];
+        for (const store of INDEXED_STORES) {
+            let raw;
+            try {
+                raw = await readFile(join(storeDir(workspaceRoot, store), MEMORY_INDEX_FILENAME), "utf8");
+            }
+            catch {
+                continue;
+            }
+            const formatted = formatMemoryIndex(store, raw);
+            if (formatted != null)
+                sections.push(formatted);
+        }
+        return { tag: "memories", content: sections.join("\n\n") };
+    },
+});
+//# sourceMappingURL=indexes.js.map

package/dist/extensions/memory/indexes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.js","sourceRoot":"","sources":["../../../src/extensions/memory/indexes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EACL,UAAU,EACV,cAAc,EACd,qBAAqB,EAErB,YAAY,EACZ,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,MAAM,cAAc,GAAG,6CAA6C,CAAC;AAErE,MAAM,kBAAkB,GAAyC;IAC/D,KAAK,EACH,0NAA0N;IAC5N,WAAW,EACT,6LAA6L;CAChM,CAAC;AAEF,MAAM,cAAc,GAAG;;;;;;;;mKAQ4I,CAAC;AAEpK,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE7F;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAkB,EAAE,UAAkB,EAAiB,EAAE;IACzF,MAAM,OAAO,GAAG,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAElF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,WAAW,GACf,kBAAkB,CAAC,KAAK,CAAC;QACzB,mFAAmF,CAAC;IAEtF,OAAO;QACL,MAAM,UAAU,CAAC,KAAK,CAAC,QAAQ;QAC/B,EAAE;QACF,WAAW;QACX,EAAE;QACF,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC;KACxC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,aAAqB,EAAmB,EAAE,CAAC,CAAC;IACpF,IAAI,EAAE,cAAc;IAEpB,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAElE,MAAM,QAAQ,GAAG,CAAC,cAAc,CAAC,CAAC;QAElC,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACnC,IAAI,GAAW,CAAC;YAEhB,IAAI,CAAC;gBACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,qBAAqB,CAAC,EAAE,MAAM,CAAC,CAAC;YAC5F,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAChD,IAAI,SAAS,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7D,CAAC;CACF,CAAC,CAAC"}

package/dist/extensions/memory/layout.d.ts

@@ -0,0 +1,20 @@
+import type { Logger } from "../../log.ts";
+export declare const MEMORY_STORES: readonly ["episodic", "facts", "preferences"];
+export type MemoryStore = (typeof MEMORY_STORES)[number];
+export declare const INDEXED_STORES: readonly ["facts", "preferences"];
+export declare const MEMORY_INDEX_FILENAME = "MEMORY.md";
+export declare const memoriesRoot: (workspaceRoot: string) => string;
+export declare const storeDir: (workspaceRoot: string, store: MemoryStore) => string;
+export declare const transcriptsDir: (workspaceRoot: string) => string;
+export declare const fileExists: (path: string) => Promise<boolean>;
+/**
+ * Create the memory directory layout and seed MEMORY.md indexes (idempotent).
+ * Pre-existing memory files get placeholder index entries; the maintenance
+ * ticks regenerate proper descriptions later.
+ */
+export declare const ensureMemoryLayout: (workspaceRoot: string, log: Logger) => Promise<void>;
+/**
+ * The extraction/maintenance agents have no delete tool — they empty files
+ * instead, and the host removes those leftovers here after each run.
+ */
+export declare const sweepEmptyMarkdown: (dir: string, log: Logger) => Promise<void>;

package/dist/extensions/memory/layout.js

@@ -0,0 +1,79 @@
+import { mkdir, readdir, readFile, stat, unlink, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+export const MEMORY_STORES = ["episodic", "facts", "preferences"];
+export const INDEXED_STORES = ["facts", "preferences"];
+export const MEMORY_INDEX_FILENAME = "MEMORY.md";
+export const memoriesRoot = (workspaceRoot) => join(workspaceRoot, "memories");
+export const storeDir = (workspaceRoot, store) => join(memoriesRoot(workspaceRoot), store);
+export const transcriptsDir = (workspaceRoot) => join(memoriesRoot(workspaceRoot), "transcripts");
+export const fileExists = async (path) => {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const titleFromFilename = (filename) => filename
+    .replace(/\.md$/, "")
+    .split(/[-_]/)
+    .filter((part) => part !== "")
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(" ");
+const listMarkdown = async (dir) => {
+    const names = await readdir(dir);
+    return names.filter((name) => name.endsWith(".md") && name !== MEMORY_INDEX_FILENAME).sort();
+};
+/**
+ * Create the memory directory layout and seed MEMORY.md indexes (idempotent).
+ * Pre-existing memory files get placeholder index entries; the maintenance
+ * ticks regenerate proper descriptions later.
+ */
+export const ensureMemoryLayout = async (workspaceRoot, log) => {
+    const dirs = [
+        ...MEMORY_STORES.map((store) => storeDir(workspaceRoot, store)),
+        transcriptsDir(workspaceRoot),
+    ];
+    for (const dir of dirs)
+        await mkdir(dir, { recursive: true });
+    for (const store of INDEXED_STORES) {
+        const indexPath = join(storeDir(workspaceRoot, store), MEMORY_INDEX_FILENAME);
+        if (await fileExists(indexPath))
+            continue;
+        const entries = (await listMarkdown(storeDir(workspaceRoot, store))).map((name) => `[${titleFromFilename(name)}](./${name}): Description pending update`);
+        const content = `${["# Memory Index", "", ...entries].join("\n").trimEnd()}\n`;
+        await writeFile(indexPath, content, "utf8");
+        log.info({ store, entries: entries.length }, "memory index created");
+    }
+};
+/**
+ * The extraction/maintenance agents have no delete tool — they empty files
+ * instead, and the host removes those leftovers here after each run.
+ */
+export const sweepEmptyMarkdown = async (dir, log) => {
+    let names;
+    try {
+        names = await readdir(dir);
+    }
+    catch {
+        return;
+    }
+    for (const name of names) {
+        if (!name.endsWith(".md"))
+            continue;
+        const path = join(dir, name);
+        try {
+            const info = await stat(path);
+            const blank = info.size === 0 || (info.size <= 64 && (await readFile(path, "utf8")).trim() === "");
+            if (!blank)
+                continue;
+            await unlink(path);
+            log.info({ path }, "removed emptied memory file");
+        }
+        catch (error) {
+            log.warn({ path, err: error }, "failed to sweep memory file");
+        }
+    }
+};
+//# sourceMappingURL=layout.js.map

package/dist/extensions/memory/layout.js.map

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

package/dist/extensions/memory/maintenance.d.ts

@@ -0,0 +1,21 @@
+import type { Logger } from "../../log.ts";
+import { type Runner } from "./extraction.ts";
+import { type MemoryStore } from "./layout.ts";
+export interface MaintenanceThresholds {
+    recentDays: number;
+    weeklyThresholdMonths: number;
+    monthlyThresholdMonths: number;
+}
+export interface MaintenanceDeps {
+    side: Runner;
+    workspaceRoot: string;
+    settings: MaintenanceThresholds;
+    log: Logger;
+    /** Injectable clock for tests — Sunday triggers the full index rebuild. */
+    now?: () => Date;
+}
+/** Names-only listing of the other stores so the maintenance agent can reconcile across them. */
+export declare const buildCrossStoreManifest: (workspaceRoot: string, current: MemoryStore) => Promise<string | null>;
+export declare const maintenanceSystemPrompt: (store: MemoryStore, { workspaceRoot, settings, now }: Pick<MaintenanceDeps, "workspaceRoot" | "settings" | "now">) => Promise<string>;
+/** Daily maintenance pass over one memory store: consolidate, prune, keep indexes in sync. */
+export declare const runMaintenanceTick: (store: MemoryStore, deps: MaintenanceDeps) => Promise<void>;