@roackb2/heddle 1.6.0 → 1.8.0

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

@@ -49,25 +49,91 @@ export const DEFAULT_MEMORY_CATEGORIES = [
         readWhen: 'Use when current behavior has historical causes or the task resembles a past incident or decision.',
     },
 ];
-export function bootstrapMemoryWorkspace(options) {
-    const memoryRoot = resolve(options.memoryRoot);
-    const createdPaths = [];
-    mkdirSync(memoryRoot, { recursive: true });
-    writeIfMissing(join(memoryRoot, 'README.md'), createRootCatalogTemplate(), createdPaths, memoryRoot);
-    for (const category of DEFAULT_MEMORY_CATEGORIES) {
-        const categoryRoot = join(memoryRoot, category.path);
-        mkdirSync(categoryRoot, { recursive: true });
-        writeIfMissing(join(categoryRoot, 'README.md'), createFolderCatalogTemplate(category), createdPaths, memoryRoot);
+/**
+ * Owns the cataloged memory workspace shape and the startup memory context.
+ */
+export class MemoryCatalogService {
+    memoryRoot;
+    constructor(memoryRoot) {
+        this.memoryRoot = memoryRoot;
     }
-    mkdirSync(join(memoryRoot, '_maintenance'), { recursive: true });
-    writeIfMissing(join(memoryRoot, '_maintenance', 'runs.jsonl'), '', createdPaths, memoryRoot);
-    return { memoryRoot, createdPaths };
-}
-export function loadMemoryRootCatalog(options) {
-    const memoryRoot = resolve(options.memoryRoot);
-    const maxBytes = options.maxBytes ?? DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES;
-    const catalogPath = join(memoryRoot, 'README.md');
-    if (!existsSync(catalogPath)) {
+    bootstrap() {
+        const memoryRoot = this.resolveRoot();
+        const createdPaths = [];
+        mkdirSync(memoryRoot, { recursive: true });
+        MemoryCatalogService.writeIfMissing(join(memoryRoot, 'README.md'), MemoryCatalogService.createRootCatalogTemplate(), createdPaths, memoryRoot);
+        for (const category of DEFAULT_MEMORY_CATEGORIES) {
+            const categoryRoot = join(memoryRoot, category.path);
+            mkdirSync(categoryRoot, { recursive: true });
+            MemoryCatalogService.writeIfMissing(join(categoryRoot, 'README.md'), MemoryCatalogService.createFolderCatalogTemplate(category), createdPaths, memoryRoot);
+        }
+        mkdirSync(join(memoryRoot, '_maintenance'), { recursive: true });
+        MemoryCatalogService.writeIfMissing(join(memoryRoot, '_maintenance', 'runs.jsonl'), '', createdPaths, memoryRoot);
+        return { memoryRoot, createdPaths };
+    }
+    loadRootCatalog(maxBytes = DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES) {
+        const memoryRoot = this.resolveRoot();
+        const catalogPath = join(memoryRoot, 'README.md');
+        if (!existsSync(catalogPath)) {
+            return MemoryCatalogService.missingRootCatalog(memoryRoot, catalogPath, maxBytes);
+        }
+        const original = readFileSync(catalogPath, 'utf8').trim();
+        const originalBytes = Buffer.byteLength(original, 'utf8');
+        const truncatedContent = MemoryCatalogService.truncateUtf8(original, maxBytes);
+        const truncated = originalBytes > Buffer.byteLength(truncatedContent, 'utf8');
+        const content = truncated ?
+            [
+                truncatedContent,
+                '',
+                `[Memory catalog truncated to ${maxBytes} bytes from ${originalBytes} bytes. Use read_memory_note on README.md for the full catalog.]`,
+            ].join('\n')
+            : original;
+        return {
+            memoryRoot,
+            catalogPath,
+            exists: true,
+            content,
+            truncated,
+            originalBytes,
+            maxBytes,
+        };
+    }
+    formatCatalogSystemContext(catalog) {
+        const header = catalog.exists ? '## Workspace Memory Catalog' : '## Workspace Memory Catalog Missing';
+        return [
+            header,
+            '',
+            `Source: ${catalog.catalogPath}`,
+            '',
+            catalog.content,
+            '',
+            'Startup memory policy: this is the only memory document loaded automatically. Use memory tools to read relevant folder catalogs or notes before relying on deeper memory.',
+        ].join('\n');
+    }
+    appendCatalogSystemContext(options) {
+        const catalog = this.loadRootCatalog(options.maxBytes);
+        const memoryContext = this.formatCatalogSystemContext(catalog);
+        const domainContext = buildMemoryDomainSystemContext();
+        const context = `${domainContext}\n\n${memoryContext}`;
+        return options.systemContext ? `${context}\n\n${options.systemContext}` : context;
+    }
+    validateShape() {
+        const memoryRoot = this.resolveRoot();
+        const requiredPaths = [
+            'README.md',
+            ...DEFAULT_MEMORY_CATEGORIES.map((category) => join(category.path, 'README.md')),
+        ];
+        const missing = requiredPaths.filter((relativePath) => !existsSync(join(memoryRoot, relativePath)));
+        return {
+            ok: missing.length === 0,
+            memoryRoot,
+            missing,
+        };
+    }
+    resolveRoot() {
+        return resolve(this.memoryRoot);
+    }
+    static missingRootCatalog(memoryRoot, catalogPath, maxBytes) {
         const content = [
             'No workspace memory catalog exists yet.',
             '',
@@ -86,145 +152,90 @@ export function loadMemoryRootCatalog(options) {
             maxBytes,
         };
     }
-    const original = readFileSync(catalogPath, 'utf8').trim();
-    const originalBytes = Buffer.byteLength(original, 'utf8');
-    const truncatedContent = truncateUtf8(original, maxBytes);
-    const truncated = originalBytes > Buffer.byteLength(truncatedContent, 'utf8');
-    const content = truncated ?
-        [
-            truncatedContent,
-            '',
-            `[Memory catalog truncated to ${maxBytes} bytes from ${originalBytes} bytes. Use read_memory_note on README.md for the full catalog.]`,
-        ].join('\n')
-        : original;
-    return {
-        memoryRoot,
-        catalogPath,
-        exists: true,
-        content,
-        truncated,
-        originalBytes,
-        maxBytes,
-    };
-}
-export function formatMemoryCatalogSystemContext(catalog) {
-    const header = catalog.exists ? '## Workspace Memory Catalog' : '## Workspace Memory Catalog Missing';
-    return [
-        header,
-        '',
-        `Source: ${catalog.catalogPath}`,
-        '',
-        catalog.content,
-        '',
-        'Startup memory policy: this is the only memory document loaded automatically. Use memory tools to read relevant folder catalogs or notes before relying on deeper memory.',
-    ].join('\n');
-}
-export function appendMemoryCatalogSystemContext(options) {
-    const catalog = loadMemoryRootCatalog({ memoryRoot: options.memoryRoot, maxBytes: options.maxBytes });
-    const memoryContext = formatMemoryCatalogSystemContext(catalog);
-    const domainContext = buildMemoryDomainSystemContext();
-    const context = `${domainContext}\n\n${memoryContext}`;
-    return options.systemContext ? `${context}\n\n${options.systemContext}` : context;
-}
-export function validateMemoryCatalogShape(options) {
-    const memoryRoot = resolve(options.memoryRoot);
-    const requiredPaths = [
-        'README.md',
-        ...DEFAULT_MEMORY_CATEGORIES.map((category) => join(category.path, 'README.md')),
-    ];
-    const missing = requiredPaths.filter((relativePath) => !existsSync(join(memoryRoot, relativePath)));
-    return {
-        ok: missing.length === 0,
-        memoryRoot,
-        missing,
-    };
-}
-function writeIfMissing(path, content, createdPaths, memoryRoot) {
-    if (existsSync(path)) {
-        return;
+    static writeIfMissing(path, content, createdPaths, memoryRoot) {
+        if (existsSync(path)) {
+            return;
+        }
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, content, 'utf8');
+        createdPaths.push(path.slice(memoryRoot.length).replace(/^\/+/, '') || '.');
     }
-    mkdirSync(dirname(path), { recursive: true });
-    writeFileSync(path, content, 'utf8');
-    createdPaths.push(toMemoryRelativePath(memoryRoot, path));
-}
-function createRootCatalogTemplate() {
-    return [
-        '# Workspace Memory',
-        '',
-        'Purpose: durable workspace knowledge that helps future agents become operational quickly.',
-        '',
-        '## Authority And Freshness',
-        '',
-        '- Live workspace evidence wins over memory when they disagree.',
-        '- Current-state notes with recent verification are stronger than older focused notes.',
-        '- Historical notes explain decisions and incidents but may be stale.',
-        '- Important stale, disputed, or superseded facts should be marked rather than silently removed.',
-        '',
-        '## Fast Reading Path',
-        '',
-        '- New non-trivial task: read `current-state/README.md`, then the category that matches the task.',
-        '- Coding or architecture task: read `domain/README.md`, `operations/README.md`, and relevant preferences.',
-        '- Workflow, release, PR, or incident task: read `workflows/README.md`, `operations/README.md`, and relevant history.',
-        '- Coordination-heavy task: read `relationships/README.md`.',
-        '',
-        '## Category Index',
-        '',
-        ...DEFAULT_MEMORY_CATEGORIES.map((category) => `- [${category.title}](${category.path}/README.md): ${category.purpose}`),
-        '',
-        '## High-Value Notes',
-        '',
-        '- Add links here when notes become important enough for every fresh agent to notice.',
-        '',
-        '## Stale Or Disputed Notes',
-        '',
-        '- Add links here when a note should be treated with caution.',
-        '',
-        '## Maintenance Instructions',
-        '',
-        '- Keep this catalog short and navigable.',
-        '- Every folder that contains memory notes needs its own `README.md` catalog.',
-        '- Every durable note should be discoverable through this catalog or a folder catalog.',
-        '- Prefer updating existing notes over scattering small one-off notes.',
-        '- Do not store secrets.',
-        '',
-    ].join('\n');
-}
-function createFolderCatalogTemplate(category) {
-    return [
-        `# ${category.title}`,
-        '',
-        `Purpose: ${category.purpose}`,
-        '',
-        `When to read: ${category.readWhen}`,
-        '',
-        '## Notes Index',
-        '',
-        '- Add note links here as this folder grows.',
-        '',
-        '## Related Folders',
-        '',
-        '- `../README.md`: root memory catalog.',
-        '',
-        '## Maintenance Rules',
-        '',
-        '- Keep this catalog short enough to scan quickly.',
-        '- Add notes only when they preserve durable context for future work.',
-        '- Update this catalog whenever adding, renaming, or retiring notes in this folder.',
-        '- Mark stale, disputed, or superseded knowledge explicitly.',
-        '',
-    ].join('\n');
-}
-function truncateUtf8(value, maxBytes) {
-    if (maxBytes <= 0) {
-        return '';
+    static createRootCatalogTemplate() {
+        return [
+            '# Workspace Memory',
+            '',
+            'Purpose: durable workspace knowledge that helps future agents become operational quickly.',
+            '',
+            '## Authority And Freshness',
+            '',
+            '- Live workspace evidence wins over memory when they disagree.',
+            '- Current-state notes with recent verification are stronger than older focused notes.',
+            '- Historical notes explain decisions and incidents but may be stale.',
+            '- Important stale, disputed, or superseded facts should be marked rather than silently removed.',
+            '',
+            '## Fast Reading Path',
+            '',
+            '- New non-trivial task: read `current-state/README.md`, then the category that matches the task.',
+            '- Coding or architecture task: read `domain/README.md`, `operations/README.md`, and relevant preferences.',
+            '- Workflow, release, PR, or incident task: read `workflows/README.md`, `operations/README.md`, and relevant history.',
+            '- Coordination-heavy task: read `relationships/README.md`.',
+            '',
+            '## Category Index',
+            '',
+            ...DEFAULT_MEMORY_CATEGORIES.map((category) => `- [${category.title}](${category.path}/README.md): ${category.purpose}`),
+            '',
+            '## High-Value Notes',
+            '',
+            '- Add links here when notes become important enough for every fresh agent to notice.',
+            '',
+            '## Stale Or Disputed Notes',
+            '',
+            '- Add links here when a note should be treated with caution.',
+            '',
+            '## Maintenance Instructions',
+            '',
+            '- Keep this catalog short and navigable.',
+            '- Every folder that contains memory notes needs its own `README.md` catalog.',
+            '- Every durable note should be discoverable through this catalog or a folder catalog.',
+            '- Prefer updating existing notes over scattering small one-off notes.',
+            '- Do not store secrets.',
+            '',
+        ].join('\n');
     }
-    const bytes = Buffer.from(value, 'utf8');
-    if (bytes.length <= maxBytes) {
-        return value;
+    static createFolderCatalogTemplate(category) {
+        return [
+            `# ${category.title}`,
+            '',
+            `Purpose: ${category.purpose}`,
+            '',
+            `When to read: ${category.readWhen}`,
+            '',
+            '## Notes Index',
+            '',
+            '- Add note links here as this folder grows.',
+            '',
+            '## Related Folders',
+            '',
+            '- `../README.md`: root memory catalog.',
+            '',
+            '## Maintenance Rules',
+            '',
+            '- Keep this catalog short enough to scan quickly.',
+            '- Add notes only when they preserve durable context for future work.',
+            '- Update this catalog whenever adding, renaming, or retiring a note in this folder.',
+            '- Mark stale, disputed, or superseded knowledge explicitly.',
+            '',
+        ].join('\n');
+    }
+    static truncateUtf8(value, maxBytes) {
+        if (maxBytes <= 0) {
+            return '';
+        }
+        const bytes = Buffer.from(value, 'utf8');
+        if (bytes.length <= maxBytes) {
+            return value;
+        }
+        return bytes.subarray(0, maxBytes).toString('utf8').replace(/\uFFFD+$/u, '').trimEnd();
     }
-    return bytes.subarray(0, maxBytes).toString('utf8').replace(/\uFFFD+$/u, '').trimEnd();
-}
-function toMemoryRelativePath(memoryRoot, path) {
-    return path.slice(memoryRoot.length).replace(/^\/+/, '') || '.';
 }
 //# sourceMappingURL=catalog.js.map

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

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

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

@@ -0,0 +1,14 @@
+export { DEFAULT_MEMORY_CATEGORIES, DEFAULT_MEMORY_FOLDER_CATALOG_MAX_BYTES, DEFAULT_MEMORY_FOLDER_CATALOG_TARGET_BYTES, DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES, DEFAULT_MEMORY_ROOT_CATALOG_TARGET_BYTES, MemoryCatalogService, } from './catalog.js';
+export { buildMemoryDomainSystemContext } from './domain-prompt.js';
+export { MemoryMaintenanceRepository } from './maintenance-repository.js';
+export { MemoryMaintainerPrompt } from './maintainer-prompt.js';
+export { MemoryMaintenanceService } from './maintainer.js';
+export { MemoryMaintenanceIntegrationService } from './maintenance-integration.js';
+export { createMemoryMaintainerTools } from './maintainer-tools.js';
+export { MemoryNoteService } from './note-service.js';
+export { MemorySchemas } from './schemas.js';
+export { createMemoryNoteTemplate, slugifyMemoryTitle } from './templates.js';
+export { MemoryValidationService } from './validation.js';
+export { MemoryVisibilityService } from './visibility.js';
+export type { BootstrapMemoryWorkspaceResult, KnowledgeCandidate, KnowledgeCandidateStatusRecord, KnowledgeMaintenanceRunRecord, ListMemoryNotesInput, MemoryCatalogLoadResult, MemoryCatalogShapeValidation, MemoryCategory, MemoryMaintenanceLockRecord, MemoryStatusView, MemoryValidationIssue, MemoryValidationResult, ReadMemoryNoteInput, RunKnowledgeMaintenanceOptions, RunKnowledgeMaintenanceResult, RunMaintenanceForRecordedCandidatesOptions, RunMaintenanceForRecordedCandidatesResult, SearchMemoryNotesInput, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,uCAAuC,EACvC,0CAA0C,EAC1C,qCAAqC,EACrC,wCAAwC,EACxC,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,mCAAmC,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EACV,8BAA8B,EAC9B,kBAAkB,EAClB,8BAA8B,EAC9B,6BAA6B,EAC7B,oBAAoB,EACpB,uBAAuB,EACvB,4BAA4B,EAC5B,cAAc,EACd,2BAA2B,EAC3B,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,8BAA8B,EAC9B,6BAA6B,EAC7B,0CAA0C,EAC1C,yCAAyC,EACzC,sBAAsB,GACvB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,13 @@
+export { DEFAULT_MEMORY_CATEGORIES, DEFAULT_MEMORY_FOLDER_CATALOG_MAX_BYTES, DEFAULT_MEMORY_FOLDER_CATALOG_TARGET_BYTES, DEFAULT_MEMORY_ROOT_CATALOG_MAX_BYTES, DEFAULT_MEMORY_ROOT_CATALOG_TARGET_BYTES, MemoryCatalogService, } from './catalog.js';
+export { buildMemoryDomainSystemContext } from './domain-prompt.js';
+export { MemoryMaintenanceRepository } from './maintenance-repository.js';
+export { MemoryMaintainerPrompt } from './maintainer-prompt.js';
+export { MemoryMaintenanceService } from './maintainer.js';
+export { MemoryMaintenanceIntegrationService } from './maintenance-integration.js';
+export { createMemoryMaintainerTools } from './maintainer-tools.js';
+export { MemoryNoteService } from './note-service.js';
+export { MemorySchemas } from './schemas.js';
+export { createMemoryNoteTemplate, slugifyMemoryTitle } from './templates.js';
+export { MemoryValidationService } from './validation.js';
+export { MemoryVisibilityService } from './visibility.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,uCAAuC,EACvC,0CAA0C,EAC1C,qCAAqC,EACrC,wCAAwC,EACxC,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,mCAAmC,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { KnowledgeCandidate } from './types.js';
+/**
+ * Owns the memory maintainer prompt text.
+ *
+ * Keep static instructions before dynamic catalog/candidate content so model
+ * providers can reuse token cache across maintenance runs.
+ */
+export declare class MemoryMaintainerPrompt {
+    private static readonly staticSystemContext;
+    static buildSystemContext(rootCatalog: string): string;
+    static buildMaintenanceGoal(observations: KnowledgeCandidate[]): string;
+    private static formatCandidates;
+}
+//# sourceMappingURL=maintainer-prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"maintainer-prompt.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/maintainer-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAcgC;IAE3E,MAAM,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQtD,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,kBAAkB,EAAE,GAAG,MAAM;IAUvE,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAmBhC"}

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

@@ -0,0 +1,58 @@
+/**
+ * Owns the memory maintainer prompt text.
+ *
+ * Keep static instructions before dynamic catalog/candidate content so model
+ * providers can reuse token cache across maintenance runs.
+ */
+export class MemoryMaintainerPrompt {
+    static staticSystemContext = `## 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.`;
+    static buildSystemContext(rootCatalog) {
+        return `${MemoryMaintainerPrompt.staticSystemContext}
+
+## Loaded Root Catalog
+
+${rootCatalog}`;
+    }
+    static buildMaintenanceGoal(observations) {
+        return `# Memory Maintenance Task
+
+Process these pending memory candidates into maintained cataloged memory.
+
+${MemoryMaintainerPrompt.formatCandidates(observations)}
+
+End with a concise summary of what memory notes or catalogs changed, or why candidates were skipped.`;
+    }
+    static formatCandidates(observations) {
+        return observations
+            .map((candidate, index) => {
+            const evidence = candidate.evidence?.length
+                ? `\n\n### Evidence\n\n${candidate.evidence.map((item) => `- ${item}`).join('\n')}`
+                : '';
+            const sourceRefs = candidate.sourceRefs?.length
+                ? `\n\n### Source Refs\n\n${candidate.sourceRefs.map((ref) => `- ${ref}`).join('\n')}`
+                : '';
+            const categoryHint = candidate.categoryHint ? `\n- Category hint: ${candidate.categoryHint}` : '';
+            const importance = candidate.importance ? `\n- Importance: ${candidate.importance}` : '';
+            const confidence = candidate.confidence ? `\n- Confidence: ${candidate.confidence}` : '';
+            return `## Candidate ${index + 1}: ${candidate.id}
+
+- Summary: ${candidate.summary}${categoryHint}${importance}${confidence}${evidence}${sourceRefs}`;
+        })
+            .join('\n\n');
+    }
+}
+//# sourceMappingURL=maintainer-prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"maintainer-prompt.js","sourceRoot":"","sources":["../../../../src/core/memory/maintainer-prompt.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IACzB,MAAM,CAAU,mBAAmB,GAAG;;;;;;;;;;;;;;4EAc4B,CAAC;IAE3E,MAAM,CAAC,kBAAkB,CAAC,WAAmB;QAC3C,OAAO,GAAG,sBAAsB,CAAC,mBAAmB;;;;EAItD,WAAW,EAAE,CAAC;IACd,CAAC;IAED,MAAM,CAAC,oBAAoB,CAAC,YAAkC;QAC5D,OAAO;;;;EAIT,sBAAsB,CAAC,gBAAgB,CAAC,YAAY,CAAC;;qGAE8C,CAAC;IACpG,CAAC;IAEO,MAAM,CAAC,gBAAgB,CAAC,YAAkC;QAChE,OAAO,YAAY;aAChB,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;YACxB,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,MAAM;gBACzC,CAAC,CAAC,uBAAuB,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACnF,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,EAAE,MAAM;gBAC7C,CAAC,CAAC,0BAA0B,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACtF,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,sBAAsB,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClG,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAEzF,OAAO,gBAAgB,KAAK,GAAG,CAAC,KAAK,SAAS,CAAC,EAAE;;aAE5C,SAAS,CAAC,OAAO,GAAG,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,EAAE,CAAC;QAC5F,CAAC,CAAC;aACD,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC"}

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

@@ -1,45 +1,21 @@
-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>;
+import { MemoryCatalogService } from './catalog.js';
+import { MemoryMaintenanceRepository } from './maintenance-repository.js';
+import type { KnowledgeCandidate, RunKnowledgeMaintenanceOptions, RunKnowledgeMaintenanceResult } from './types.js';
+/**
+ * Owns the agent-backed memory maintenance workflow over pending candidates.
+ */
+export declare class MemoryMaintenanceService {
+    private readonly memoryRoot;
+    private readonly repository;
+    private readonly catalog;
+    constructor(memoryRoot: string, repository?: MemoryMaintenanceRepository, catalog?: MemoryCatalogService);
+    readPendingCandidates(): Promise<KnowledgeCandidate[]>;
+    run(options: Omit<RunKnowledgeMaintenanceOptions, 'memoryRoot'>): Promise<RunKnowledgeMaintenanceResult>;
+    runBacklog(options: Omit<RunKnowledgeMaintenanceOptions, 'memoryRoot' | 'observations'>): Promise<RunKnowledgeMaintenanceResult>;
+    static isRecordableCandidateText(value: string): boolean;
+    static isSafeSourceRef(value: string, memoryRoot: string): boolean;
+    private static skippedRun;
+    private static isMaintainerCandidateAllowed;
+    private static containsSecretLikeText;
+}
 //# sourceMappingURL=maintainer.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"maintainer.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/maintainer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAG1E,OAAO,KAAK,EACV,kBAAkB,EAElB,8BAA8B,EAC9B,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,wBAAwB;IAEjC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,UAAU,EAAE,MAAM,EAClB,UAAU,8BAA8C,EACxD,OAAO,uBAAuC;IAG3D,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAItD,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,8BAA8B,EAAE,YAAY,CAAC,GAAG,OAAO,CAAC,6BAA6B,CAAC;IA+DxG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,8BAA8B,EAAE,YAAY,GAAG,cAAc,CAAC,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAOtI,MAAM,CAAC,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIxD,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IA4BlE,OAAO,CAAC,MAAM,CAAC,UAAU;IA2BzB,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAQ3C,OAAO,CAAC,MAAM,CAAC,sBAAsB;CAStC"}