@roackb2/heddle 0.0.28 → 0.0.30

package/dist/src/core/memory/maintainer-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintainer-tools.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/maintainer-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,EAAE,CAO7F"}

package/dist/src/core/memory/maintainer-tools.js

@@ -0,0 +1,10 @@
+import { createEditMemoryNoteTool, createListMemoryNotesTool, createReadMemoryNoteTool, createSearchMemoryNotesTool, } from '../tools/memory-notes.js';
+export function createMemoryMaintainerTools(options) {
+    return [
+        createListMemoryNotesTool({ memoryRoot: options.memoryRoot }),
+        createReadMemoryNoteTool({ memoryRoot: options.memoryRoot }),
+        createSearchMemoryNotesTool({ memoryRoot: options.memoryRoot }),
+        createEditMemoryNoteTool({ memoryRoot: options.memoryRoot }),
+    ];
+}
+//# sourceMappingURL=maintainer-tools.js.map

package/dist/src/core/memory/maintainer-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintainer-tools.js","sourceRoot":"","sources":["../../../../src/core/memory/maintainer-tools.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC;AAElC,MAAM,UAAU,2BAA2B,CAAC,OAA+B;IACzE,OAAO;QACL,yBAAyB,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC7D,wBAAwB,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC5D,2BAA2B,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;QAC/D,wBAAwB,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/src/core/memory/maintainer.d.ts

@@ -0,0 +1,45 @@
+import type { LlmAdapter } from '../llm/types.js';
+import type { RunResult } from '../types.js';
+export type KnowledgeCandidate = {
+    id: string;
+    recordedAt: string;
+    status: 'pending';
+    summary: string;
+    evidence?: string[];
+    categoryHint?: string;
+    importance?: 'low' | 'medium' | 'high';
+    confidence?: 'user-stated' | 'tool-verified' | 'inferred' | 'historical';
+    sourceRefs?: string[];
+};
+export type KnowledgeMaintenanceRunRecord = {
+    id: string;
+    startedAt: string;
+    finishedAt: string;
+    source: string;
+    outcome: RunResult['outcome'] | 'skipped';
+    summary: string;
+    candidateIds: string[];
+    processedCandidateIds: string[];
+    failedCandidateIds: string[];
+    catalogValid: boolean;
+    catalogMissing: string[];
+};
+export type RunKnowledgeMaintenanceOptions = {
+    memoryRoot: string;
+    observations: KnowledgeCandidate[];
+    llm: LlmAdapter;
+    source: string;
+    maxSteps?: number;
+    now?: () => Date;
+    nextRunId?: () => string;
+};
+export type RunKnowledgeMaintenanceResult = {
+    run: KnowledgeMaintenanceRunRecord;
+    result?: RunResult;
+};
+export declare function readPendingKnowledgeCandidates(options: {
+    memoryRoot: string;
+}): Promise<KnowledgeCandidate[]>;
+export declare function runKnowledgeMaintenance(options: RunKnowledgeMaintenanceOptions): Promise<RunKnowledgeMaintenanceResult>;
+export declare function runKnowledgeMaintenanceForBacklog(options: Omit<RunKnowledgeMaintenanceOptions, 'observations'>): Promise<RunKnowledgeMaintenanceResult>;
+//# sourceMappingURL=maintainer.d.ts.map

package/dist/src/core/memory/maintainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintainer.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/maintainer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,UAAU,CAAC,EAAE,aAAa,GAAG,eAAe,GAAG,UAAU,GAAG,YAAY,CAAC;IACzE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,GAAG,EAAE,6BAA6B,CAAC;IACnC,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAwBnH;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAoE7H;AAWD,wBAAsB,iCAAiC,CAAC,OAAO,EAAE,IAAI,CAAC,8BAA8B,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAG7J"}

package/dist/src/core/memory/maintainer.js

@@ -0,0 +1,204 @@
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { runAgent } from '../agent/run-agent.js';
+import { createLogger } from '../utils/logger.js';
+import { bootstrapMemoryWorkspace, loadMemoryRootCatalog, validateMemoryCatalogShape } from './catalog.js';
+import { createMemoryMaintainerTools } from './maintainer-tools.js';
+export async function readPendingKnowledgeCandidates(options) {
+    const memoryRoot = resolve(options.memoryRoot);
+    const candidatesPath = join(memoryRoot, '_maintenance', 'candidates.jsonl');
+    const lines = await readJsonlLines(candidatesPath);
+    const processed = new Set();
+    const pending = [];
+    for (const line of lines) {
+        const parsed = parseJsonObject(line);
+        if (!parsed) {
+            continue;
+        }
+        if (parsed.kind === 'candidate_status' && typeof parsed.candidateId === 'string' && parsed.status === 'processed') {
+            processed.add(parsed.candidateId);
+            continue;
+        }
+        if (isKnowledgeCandidate(parsed)) {
+            pending.push(parsed);
+        }
+    }
+    return pending.filter((candidate) => !processed.has(candidate.id));
+}
+export async function runKnowledgeMaintenance(options) {
+    const memoryRoot = resolve(options.memoryRoot);
+    bootstrapMemoryWorkspace({ memoryRoot });
+    const now = options.now ?? (() => new Date());
+    const startedAt = now();
+    const runId = options.nextRunId?.() ?? `memory-run-${startedAt.getTime()}`;
+    const candidateIds = options.observations.map((candidate) => candidate.id);
+    const skippedCandidateIds = options.observations
+        .filter((candidate) => !isMaintainerCandidateAllowed(candidate))
+        .map((candidate) => candidate.id);
+    const observations = options.observations.filter(isMaintainerCandidateAllowed);
+    if (observations.length === 0) {
+        const validation = validateMemoryCatalogShape({ memoryRoot });
+        const summary = candidateIds.length === 0 ? 'No pending knowledge candidates.'
+            : `Skipped ${candidateIds.length} low-value, duplicate, or secret-like memory candidate(s).`;
+        const run = {
+            id: runId,
+            startedAt: startedAt.toISOString(),
+            finishedAt: now().toISOString(),
+            source: options.source,
+            outcome: 'skipped',
+            summary,
+            candidateIds,
+            processedCandidateIds: [],
+            failedCandidateIds: skippedCandidateIds,
+            catalogValid: validation.ok,
+            catalogMissing: validation.missing,
+        };
+        await appendMaintenanceRun(memoryRoot, run);
+        return { run };
+    }
+    const rootCatalog = loadMemoryRootCatalog({ memoryRoot }).content;
+    const goal = buildMaintenanceGoal(observations);
+    const systemContext = buildMaintainerSystemContext(rootCatalog);
+    const result = await runAgent({
+        goal,
+        llm: options.llm,
+        tools: createMemoryMaintainerTools({ memoryRoot }),
+        maxSteps: options.maxSteps ?? 40,
+        logger: createLogger({ console: false, level: 'silent' }),
+        systemContext,
+    });
+    const validation = validateMemoryCatalogShape({ memoryRoot });
+    const processedCandidateIds = result.outcome === 'done' ? observations.map((candidate) => candidate.id) : [];
+    const failedCandidateIds = result.outcome === 'done' ? skippedCandidateIds : candidateIds;
+    const run = {
+        id: runId,
+        startedAt: startedAt.toISOString(),
+        finishedAt: now().toISOString(),
+        source: options.source,
+        outcome: result.outcome,
+        summary: result.summary,
+        candidateIds,
+        processedCandidateIds,
+        failedCandidateIds,
+        catalogValid: validation.ok,
+        catalogMissing: validation.missing,
+    };
+    await appendMaintenanceRun(memoryRoot, run);
+    if (processedCandidateIds.length > 0) {
+        await appendCandidateStatusEvents(memoryRoot, processedCandidateIds, run.id, now);
+    }
+    return { run, result };
+}
+function isMaintainerCandidateAllowed(candidate) {
+    const text = [
+        candidate.summary,
+        ...(candidate.evidence ?? []),
+        ...(candidate.sourceRefs ?? []),
+    ].join('\n');
+    return !containsSecretLikeText(text);
+}
+export async function runKnowledgeMaintenanceForBacklog(options) {
+    const observations = await readPendingKnowledgeCandidates({ memoryRoot: options.memoryRoot });
+    return await runKnowledgeMaintenance({ ...options, observations });
+}
+function buildMaintainerSystemContext(rootCatalog) {
+    return [
+        '## Memory Maintainer Mode',
+        '',
+        'You maintain Heddle workspace memory. You are not doing general coding work.',
+        'Use only memory tools. Do not ask for shell, code edit, web, or external tools.',
+        '',
+        'Hard invariants:',
+        '- Every durable note must be discoverable through the root catalog or a folder catalog.',
+        '- Read the root catalog first, then read the relevant folder catalog before writing.',
+        '- Search existing notes before creating a new note.',
+        '- Prefer updating existing notes over creating duplicates.',
+        '- Update folder catalogs whenever you create, rename, or retire a note.',
+        '- Update the root catalog only when a new high-value note or discovery path matters globally.',
+        '- Do not store secrets, credentials, private keys, tokens, or passwords.',
+        '- Skip low-value, duplicate, speculative, or one-turn scratch observations.',
+        '',
+        'Loaded root catalog:',
+        '',
+        rootCatalog,
+    ].join('\n');
+}
+function buildMaintenanceGoal(observations) {
+    return [
+        'Process these pending memory candidates into maintained cataloged memory.',
+        '',
+        ...observations.map((candidate, index) => [
+            `Candidate ${index + 1}: ${candidate.id}`,
+            `Summary: ${candidate.summary}`,
+            candidate.categoryHint ? `Category hint: ${candidate.categoryHint}` : undefined,
+            candidate.importance ? `Importance: ${candidate.importance}` : undefined,
+            candidate.confidence ? `Confidence: ${candidate.confidence}` : undefined,
+            candidate.evidence?.length ? `Evidence:\n${candidate.evidence.map((item) => `- ${item}`).join('\n')}` : undefined,
+            candidate.sourceRefs?.length ? `Source refs: ${candidate.sourceRefs.join(', ')}` : undefined,
+        ].filter((line) => Boolean(line)).join('\n')),
+        '',
+        'End with a concise summary of what memory notes or catalogs changed, or why candidates were skipped.',
+    ].join('\n\n');
+}
+async function appendMaintenanceRun(memoryRoot, run) {
+    const path = join(memoryRoot, '_maintenance', 'runs.jsonl');
+    await mkdir(dirname(path), { recursive: true });
+    await appendFile(path, `${JSON.stringify(run)}\n`, 'utf8');
+}
+async function appendCandidateStatusEvents(memoryRoot, candidateIds, runId, now) {
+    const path = join(memoryRoot, '_maintenance', 'candidates.jsonl');
+    await mkdir(dirname(path), { recursive: true });
+    const recordedAt = now().toISOString();
+    await appendFile(path, candidateIds.map((candidateId) => JSON.stringify({
+        kind: 'candidate_status',
+        candidateId,
+        status: 'processed',
+        runId,
+        recordedAt,
+    })).join('\n') + '\n', 'utf8');
+}
+async function readJsonlLines(path) {
+    try {
+        const raw = await readFile(path, 'utf8');
+        return raw.split(/\r?\n/u).filter((line) => line.trim());
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return [];
+        }
+        throw error;
+    }
+}
+function parseJsonObject(line) {
+    try {
+        const parsed = JSON.parse(line);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isKnowledgeCandidate(value) {
+    return typeof value.id === 'string'
+        && typeof value.recordedAt === 'string'
+        && value.status === 'pending'
+        && typeof value.summary === 'string'
+        && (value.evidence === undefined || isStringArray(value.evidence))
+        && (value.categoryHint === undefined || typeof value.categoryHint === 'string')
+        && (value.importance === undefined || value.importance === 'low' || value.importance === 'medium' || value.importance === 'high')
+        && (value.confidence === undefined || value.confidence === 'user-stated' || value.confidence === 'tool-verified' || value.confidence === 'inferred' || value.confidence === 'historical')
+        && (value.sourceRefs === undefined || isStringArray(value.sourceRefs));
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === 'string');
+}
+function containsSecretLikeText(value) {
+    const normalized = value.toLowerCase();
+    return /\b(api[_ -]?key|password|passwd|private[_ -]?key|access[_ -]?token|refresh[_ -]?token|bearer\s+[a-z0-9._~+/=-]{12,})\b/i.test(value)
+        || /\bsecret\s*[:=]\s*\S{8,}/i.test(value)
+        || /\bsk-[a-z0-9_-]{12,}\b/i.test(value)
+        || normalized.includes('-----begin private key-----')
+        || normalized.includes('-----begin rsa private key-----')
+        || normalized.includes('-----begin openssh private key-----');
+}
+//# sourceMappingURL=maintainer.js.map

package/dist/src/core/memory/maintainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintainer.js","sourceRoot":"","sources":["../../../../src/core/memory/maintainer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGnD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC3G,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AA2CpE,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,OAA+B;IAClF,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,OAAO,GAAyB,EAAE,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAClH,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QAED,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAAuC;IACnF,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,wBAAwB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC;IACxB,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,EAAE,EAAE,IAAI,cAAc,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;IAC3E,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC3E,MAAM,mBAAmB,GAAG,OAAO,CAAC,YAAY;SAC7C,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,4BAA4B,CAAC,SAAS,CAAC,CAAC;SAC/D,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACpC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAE/E,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAG,0BAA0B,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9D,MAAM,OAAO,GACX,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,kCAAkC;YAC9D,CAAC,CAAC,WAAW,YAAY,CAAC,MAAM,4DAA4D,CAAC;QAC/F,MAAM,GAAG,GAAG;YACV,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,SAAS,CAAC,WAAW,EAAE;YAClC,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;YAC/B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,SAAkB;YAC3B,OAAO;YACP,YAAY;YACZ,qBAAqB,EAAE,EAAE;YACzB,kBAAkB,EAAE,mBAAmB;YACvC,YAAY,EAAE,UAAU,CAAC,EAAE;YAC3B,cAAc,EAAE,UAAU,CAAC,OAAO;SACnC,CAAC;QACF,MAAM,oBAAoB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC5C,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,qBAAqB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC;IAClE,MAAM,IAAI,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,4BAA4B,CAAC,WAAW,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;QAC5B,IAAI;QACJ,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,2BAA2B,CAAC,EAAE,UAAU,EAAE,CAAC;QAClD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QACzD,aAAa;KACd,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,0BAA0B,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAC9D,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7G,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1F,MAAM,GAAG,GAAG;QACV,EAAE,EAAE,KAAK;QACT,SAAS,EAAE,SAAS,CAAC,WAAW,EAAE;QAClC,UAAU,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;QAC/B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,YAAY;QACZ,qBAAqB;QACrB,kBAAkB;QAClB,YAAY,EAAE,UAAU,CAAC,EAAE;QAC3B,cAAc,EAAE,UAAU,CAAC,OAAO;KACnC,CAAC;IAEF,MAAM,oBAAoB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC5C,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,2BAA2B,CAAC,UAAU,EAAE,qBAAqB,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,4BAA4B,CAAC,SAA6B;IACjE,MAAM,IAAI,GAAG;QACX,SAAS,CAAC,OAAO;QACjB,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC7B,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,EAAE,CAAC;KAChC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CAAC,OAA6D;IACnH,MAAM,YAAY,GAAG,MAAM,8BAA8B,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9F,OAAO,MAAM,uBAAuB,CAAC,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,4BAA4B,CAAC,WAAmB;IACvD,OAAO;QACL,2BAA2B;QAC3B,EAAE;QACF,8EAA8E;QAC9E,iFAAiF;QACjF,EAAE;QACF,kBAAkB;QAClB,yFAAyF;QACzF,sFAAsF;QACtF,qDAAqD;QACrD,4DAA4D;QAC5D,yEAAyE;QACzE,+FAA+F;QAC/F,0EAA0E;QAC1E,6EAA6E;QAC7E,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,WAAW;KACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,YAAkC;IAC9D,OAAO;QACL,2EAA2E;QAC3E,EAAE;QACF,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;YACxC,aAAa,KAAK,GAAG,CAAC,KAAK,SAAS,CAAC,EAAE,EAAE;YACzC,YAAY,SAAS,CAAC,OAAO,EAAE;YAC/B,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,kBAAkB,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS;YAC/E,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS;YACxE,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS;YACxE,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;YACjH,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,gBAAgB,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;SAC7F,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,EAAE;QACF,sGAAsG;KACvG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,UAAkB,EAAE,GAAkC;IACxF,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;IAC5D,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,2BAA2B,CAAC,UAAkB,EAAE,YAAsB,EAAE,KAAa,EAAE,GAAe;IACnH,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAClE,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,UAAU,CACd,IAAI,EACJ,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;QAC/C,IAAI,EAAE,kBAAkB;QACxB,WAAW;QACX,MAAM,EAAE,WAAW;QACnB,KAAK;QACL,UAAU;KACX,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EACrB,MAAM,CACP,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzE,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QAC3C,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAiC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAA8B;IAC1D,OAAO,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;WAC9B,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;WACpC,KAAK,CAAC,MAAM,KAAK,SAAS;WAC1B,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;WACjC,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;WAC/D,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC;WAC5E,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,KAAK,KAAK,IAAI,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC;WAC9H,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,KAAK,aAAa,IAAI,KAAK,CAAC,UAAU,KAAK,eAAe,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU,IAAI,KAAK,CAAC,UAAU,KAAK,YAAY,CAAC;WACtL,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,OAAO,yHAAyH,CAAC,IAAI,CAAC,KAAK,CAAC;WACvI,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC;WACvC,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC;WACrC,UAAU,CAAC,QAAQ,CAAC,6BAA6B,CAAC;WAClD,UAAU,CAAC,QAAQ,CAAC,iCAAiC,CAAC;WACtD,UAAU,CAAC,QAAQ,CAAC,qCAAqC,CAAC,CAAC;AAClE,CAAC"}

package/dist/src/core/memory/maintenance-integration.d.ts

@@ -0,0 +1,20 @@
+import type { LlmAdapter } from '../llm/types.js';
+import type { TraceEvent } from '../types.js';
+import { type RunKnowledgeMaintenanceResult } from './maintainer.js';
+export type RunMaintenanceForRecordedCandidatesOptions = {
+    memoryRoot: string;
+    llm: LlmAdapter;
+    source: string;
+    trace: TraceEvent[];
+    maxSteps?: number;
+    lockTimeoutMs?: number;
+    lockStaleAfterMs?: number;
+    onTraceEvent?: (event: TraceEvent) => void;
+};
+export type RunMaintenanceForRecordedCandidatesResult = {
+    candidateIds: string[];
+    maintenance?: RunKnowledgeMaintenanceResult;
+    events: TraceEvent[];
+};
+export declare function runMaintenanceForRecordedCandidates(options: RunMaintenanceForRecordedCandidatesOptions): Promise<RunMaintenanceForRecordedCandidatesResult>;
+//# sourceMappingURL=maintenance-integration.d.ts.map

package/dist/src/core/memory/maintenance-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-integration.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/maintenance-integration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,iBAAiB,CAAC;AAOzB,MAAM,MAAM,0CAA0C,GAAG;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,yCAAyC,GAAG;IACtD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,6BAA6B,CAAC;IAC5C,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,CAAC;AAEF,wBAAsB,mCAAmC,CACvD,OAAO,EAAE,0CAA0C,GAClD,OAAO,CAAC,yCAAyC,CAAC,CAEpD"}

package/dist/src/core/memory/maintenance-integration.js

@@ -0,0 +1,189 @@
+import { mkdir, open, readFile, rm } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { readPendingKnowledgeCandidates, runKnowledgeMaintenance, } from './maintainer.js';
+const DEFAULT_LOCK_STALE_AFTER_MS = 10 * 60 * 1000;
+const DEFAULT_LOCK_POLL_MS = 250;
+const DEFAULT_LOCK_TIMEOUT_MS = 30 * 1000;
+const maintenanceQueues = new Map();
+export async function runMaintenanceForRecordedCandidates(options) {
+    return await enqueueMaintenance(options.memoryRoot, () => runMaintenanceForRecordedCandidatesNow(options));
+}
+async function runMaintenanceForRecordedCandidatesNow(options) {
+    const candidateIds = [...new Set(options.trace
+            .filter((event) => event.type === 'memory.candidate_recorded')
+            .map((event) => event.candidateId))];
+    if (candidateIds.length === 0) {
+        return { candidateIds, events: [] };
+    }
+    const pending = await readPendingKnowledgeCandidates({ memoryRoot: options.memoryRoot });
+    const observations = pending.filter((candidate) => candidateIds.includes(candidate.id));
+    if (observations.length === 0) {
+        return { candidateIds, events: [] };
+    }
+    const runId = `memory-run-${Date.now()}`;
+    const started = createEvent({
+        type: 'memory.maintenance_started',
+        runId,
+        candidateIds: observations.map((candidate) => candidate.id),
+        step: nextMemoryStep(options.trace),
+    });
+    options.onTraceEvent?.(started);
+    let lock;
+    try {
+        lock = await acquireMemoryMaintenanceLock({
+            memoryRoot: options.memoryRoot,
+            staleAfterMs: options.lockStaleAfterMs,
+            timeoutMs: options.lockTimeoutMs,
+        });
+        const maintenance = await runKnowledgeMaintenance({
+            memoryRoot: options.memoryRoot,
+            observations,
+            llm: options.llm,
+            source: options.source,
+            maxSteps: options.maxSteps,
+            nextRunId: () => runId,
+        });
+        if (maintenance.run.outcome === 'error' || maintenance.run.outcome === 'max_steps' || maintenance.run.outcome === 'interrupted') {
+            const failed = createEvent({
+                type: 'memory.maintenance_failed',
+                runId: maintenance.run.id,
+                error: maintenance.run.summary,
+                candidateIds: observations.map((candidate) => candidate.id),
+                step: nextMemoryStep(options.trace),
+            });
+            options.onTraceEvent?.(failed);
+            return { candidateIds, maintenance, events: [started, failed] };
+        }
+        const finished = createEvent({
+            type: 'memory.maintenance_finished',
+            runId: maintenance.run.id,
+            outcome: maintenance.run.outcome,
+            summary: maintenance.run.summary,
+            processedCandidateIds: maintenance.run.processedCandidateIds,
+            failedCandidateIds: maintenance.run.failedCandidateIds,
+            step: nextMemoryStep(options.trace),
+        });
+        options.onTraceEvent?.(finished);
+        return { candidateIds, maintenance, events: [started, finished] };
+    }
+    catch (error) {
+        const failed = createEvent({
+            type: 'memory.maintenance_failed',
+            runId,
+            error: error instanceof Error ? error.message : String(error),
+            candidateIds: observations.map((candidate) => candidate.id),
+            step: nextMemoryStep(options.trace),
+        });
+        options.onTraceEvent?.(failed);
+        return { candidateIds, events: [started, failed] };
+    }
+    finally {
+        await lock?.release();
+    }
+}
+async function acquireMemoryMaintenanceLock(options) {
+    const memoryRoot = resolve(options.memoryRoot);
+    const lockPath = join(memoryRoot, '_maintenance', 'maintenance.lock');
+    const lockId = `${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    const startedAt = Date.now();
+    const timeoutMs = options.timeoutMs ?? DEFAULT_LOCK_TIMEOUT_MS;
+    const staleAfterMs = options.staleAfterMs ?? DEFAULT_LOCK_STALE_AFTER_MS;
+    await mkdir(dirname(lockPath), { recursive: true });
+    while (true) {
+        try {
+            const handle = await open(lockPath, 'wx');
+            await handle.writeFile(JSON.stringify({
+                id: lockId,
+                pid: process.pid,
+                acquiredAt: new Date().toISOString(),
+            }) + '\n', 'utf8');
+            await handle.close();
+            return {
+                async release() {
+                    await releaseMemoryMaintenanceLock(lockPath, lockId);
+                },
+            };
+        }
+        catch (error) {
+            if (!(error instanceof Error) || !('code' in error) || error.code !== 'EEXIST') {
+                throw error;
+            }
+            if (await removeStaleMemoryMaintenanceLock(lockPath, staleAfterMs)) {
+                continue;
+            }
+            if (Date.now() - startedAt >= timeoutMs) {
+                throw new Error(`Memory maintenance lock is busy: ${lockPath}`);
+            }
+            await sleep(DEFAULT_LOCK_POLL_MS);
+        }
+    }
+}
+async function releaseMemoryMaintenanceLock(lockPath, lockId) {
+    const current = await readMemoryMaintenanceLock(lockPath);
+    if (current?.id !== lockId) {
+        return;
+    }
+    await rm(lockPath, { force: true });
+}
+async function removeStaleMemoryMaintenanceLock(lockPath, staleAfterMs) {
+    const current = await readMemoryMaintenanceLock(lockPath);
+    if (!current) {
+        return false;
+    }
+    const acquiredAt = Date.parse(current.acquiredAt);
+    if (!Number.isFinite(acquiredAt) || Date.now() - acquiredAt < staleAfterMs) {
+        return false;
+    }
+    await rm(lockPath, { force: true });
+    return true;
+}
+async function readMemoryMaintenanceLock(lockPath) {
+    try {
+        const parsed = JSON.parse(await readFile(lockPath, 'utf8'));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return undefined;
+        }
+        const candidate = parsed;
+        return typeof candidate.id === 'string' && typeof candidate.acquiredAt === 'string' ?
+            { id: candidate.id, acquiredAt: candidate.acquiredAt }
+            : undefined;
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+            return undefined;
+        }
+        return undefined;
+    }
+}
+async function sleep(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function enqueueMaintenance(memoryRoot, run) {
+    const previous = maintenanceQueues.get(memoryRoot) ?? Promise.resolve();
+    let release;
+    const current = new Promise((resolve) => {
+        release = resolve;
+    });
+    const queued = previous.then(() => current, () => current);
+    maintenanceQueues.set(memoryRoot, queued);
+    await previous.catch(() => undefined);
+    try {
+        return await run();
+    }
+    finally {
+        release();
+        if (maintenanceQueues.get(memoryRoot) === queued) {
+            maintenanceQueues.delete(memoryRoot);
+        }
+    }
+}
+function createEvent(event) {
+    return {
+        ...event,
+        timestamp: new Date().toISOString(),
+    };
+}
+function nextMemoryStep(trace) {
+    return trace.reduce((max, event) => 'step' in event ? Math.max(max, event.step) : max, 0) + 1;
+}
+//# sourceMappingURL=maintenance-integration.js.map

package/dist/src/core/memory/maintenance-integration.js.map

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

package/dist/src/core/memory/templates.d.ts

@@ -0,0 +1,9 @@
+export declare function createMemoryNoteTemplate(options: {
+    title: string;
+    summary: string;
+    confidence?: string;
+    sourceRefs?: string[];
+    now?: Date;
+}): string;
+export declare function slugifyMemoryTitle(value: string): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/src/core/memory/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/templates.ts"],"names":[],"mappings":"AAAA,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,MAAM,CAiBT;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASxD"}

package/dist/src/core/memory/templates.js

@@ -0,0 +1,32 @@
+export function createMemoryNoteTemplate(options) {
+    const updatedAt = (options.now ?? new Date()).toISOString();
+    const sourceRefs = options.sourceRefs && options.sourceRefs.length > 0 ? options.sourceRefs : undefined;
+    return [
+        '---',
+        `title: ${quoteYaml(options.title)}`,
+        `updated: ${quoteYaml(updatedAt)}`,
+        options.confidence ? `confidence: ${quoteYaml(options.confidence)}` : undefined,
+        sourceRefs ? 'sourceRefs:' : undefined,
+        ...(sourceRefs?.map((sourceRef) => `  - ${quoteYaml(sourceRef)}`) ?? []),
+        '---',
+        '',
+        `# ${options.title}`,
+        '',
+        options.summary,
+        '',
+    ].filter((line) => line !== undefined).join('\n');
+}
+export function slugifyMemoryTitle(value) {
+    const slug = value
+        .toLowerCase()
+        .replace(/[`'"]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 80)
+        .replace(/-+$/g, '');
+    return slug || 'memory-note';
+}
+function quoteYaml(value) {
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=templates.js.map

package/dist/src/core/memory/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../../src/core/memory/templates.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB,CAAC,OAMxC;IACC,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IACxG,OAAO;QACL,KAAK;QACL,UAAU,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACpC,YAAY,SAAS,CAAC,SAAS,CAAC,EAAE;QAClC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;QAC/E,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;QACtC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QACxE,KAAK;QACL,EAAE;QACF,KAAK,OAAO,CAAC,KAAK,EAAE;QACpB,EAAE;QACF,OAAO,CAAC,OAAO;QACf,EAAE;KACH,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,IAAI,GAAG,KAAK;SACf,WAAW,EAAE;SACb,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvB,OAAO,IAAI,IAAI,aAAa,CAAC;AAC/B,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/src/core/memory/validation.d.ts

@@ -0,0 +1,39 @@
+export type MemoryValidationIssue = {
+    type: 'missing_catalog';
+    severity: 'error';
+    path: string;
+    message: string;
+} | {
+    type: 'oversized_catalog';
+    severity: 'warning';
+    path: string;
+    sizeBytes: number;
+    maxBytes: number;
+    message: string;
+} | {
+    type: 'orphan_note';
+    severity: 'warning';
+    path: string;
+    message: string;
+} | {
+    type: 'pending_candidates';
+    severity: 'info';
+    count: number;
+    message: string;
+};
+export type MemoryValidationResult = {
+    memoryRoot: string;
+    ok: boolean;
+    issueCount: number;
+    issues: MemoryValidationIssue[];
+};
+export declare function validateMemoryWorkspace(options: {
+    memoryRoot: string;
+}): Promise<MemoryValidationResult>;
+export declare function repairMissingMemoryCatalogs(options: {
+    memoryRoot: string;
+}): Promise<{
+    memoryRoot: string;
+    createdPaths: string[];
+}>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/core/memory/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/validation.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,qBAAqB,GAC7B;IACA,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,GACC;IACA,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,GACC;IACA,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,GACC;IACA,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEJ,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiC9G;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAE1I"}