@roackb2/heddle 0.0.27 → 0.0.29

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":"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"}

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"}

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

@@ -0,0 +1,94 @@
+import { readFile, stat } from 'node:fs/promises';
+import { basename, dirname, join, resolve } from 'node:path';
+import { DEFAULT_MEMORY_FOLDER_CATALOG_MAX_BYTES, DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES, bootstrapMemoryWorkspace, validateMemoryCatalogShape, } from './catalog.js';
+import { readPendingKnowledgeCandidates } from './maintainer.js';
+import { listMemoryNotePaths } from './visibility.js';
+export async function validateMemoryWorkspace(options) {
+    const memoryRoot = resolve(options.memoryRoot);
+    const issues = [];
+    const shape = validateMemoryCatalogShape({ memoryRoot });
+    for (const path of shape.missing) {
+        issues.push({
+            type: 'missing_catalog',
+            severity: 'error',
+            path,
+            message: `Missing required memory catalog: ${path}`,
+        });
+    }
+    const notes = await listMemoryNotePaths({ memoryRoot });
+    await appendOversizedCatalogIssues(memoryRoot, notes, issues);
+    await appendOrphanNoteIssues(memoryRoot, notes, issues);
+    const pending = await readPendingKnowledgeCandidates({ memoryRoot });
+    if (pending.length > 0) {
+        issues.push({
+            type: 'pending_candidates',
+            severity: 'info',
+            count: pending.length,
+            message: `${pending.length} pending memory candidate${pending.length === 1 ? '' : 's'} waiting for maintenance.`,
+        });
+    }
+    return {
+        memoryRoot,
+        ok: issues.every((issue) => issue.severity !== 'error'),
+        issueCount: issues.length,
+        issues,
+    };
+}
+export async function repairMissingMemoryCatalogs(options) {
+    return bootstrapMemoryWorkspace({ memoryRoot: options.memoryRoot });
+}
+async function appendOversizedCatalogIssues(memoryRoot, notes, issues) {
+    for (const path of notes.filter((note) => basename(note).toLowerCase() === 'readme.md')) {
+        const fullPath = join(memoryRoot, path);
+        const info = await stat(fullPath);
+        const maxBytes = path === 'README.md' ? DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES : DEFAULT_MEMORY_FOLDER_CATALOG_MAX_BYTES;
+        if (info.size <= maxBytes) {
+            continue;
+        }
+        issues.push({
+            type: 'oversized_catalog',
+            severity: 'warning',
+            path,
+            sizeBytes: info.size,
+            maxBytes,
+            message: `Memory catalog ${path} is ${info.size} bytes, above the ${maxBytes} byte cap.`,
+        });
+    }
+}
+async function appendOrphanNoteIssues(memoryRoot, notes, issues) {
+    const catalogPaths = notes.filter((note) => basename(note).toLowerCase() === 'readme.md');
+    const catalogTextByPath = new Map();
+    for (const catalogPath of catalogPaths) {
+        catalogTextByPath.set(catalogPath, await readFile(join(memoryRoot, catalogPath), 'utf8'));
+    }
+    for (const note of notes) {
+        if (basename(note).toLowerCase() === 'readme.md') {
+            continue;
+        }
+        const folderCatalog = catalogPathForNote(note);
+        const folderCatalogText = catalogTextByPath.get(folderCatalog) ?? '';
+        const rootCatalogText = catalogTextByPath.get('README.md') ?? '';
+        const localName = basename(note);
+        const linkedFromFolder = folderCatalogText.includes(localName) || folderCatalogText.includes(note);
+        const linkedFromRoot = rootCatalogText.includes(note);
+        if (linkedFromFolder || linkedFromRoot) {
+            continue;
+        }
+        issues.push({
+            type: 'orphan_note',
+            severity: 'warning',
+            path: note,
+            message: orphanNoteMessage(note, folderCatalog),
+        });
+    }
+}
+function catalogPathForNote(path) {
+    const folder = dirname(path);
+    return folder === '.' ? 'README.md' : join(folder, 'README.md');
+}
+function orphanNoteMessage(note, folderCatalog) {
+    return folderCatalog === 'README.md' ?
+        `Memory note ${note} is not linked from README.md.`
+        : `Memory note ${note} is not linked from ${folderCatalog} or README.md.`;
+}
+//# sourceMappingURL=validation.js.map

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

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