@roackb2/heddle 1.5.0 → 1.7.0

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

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

@@ -1,204 +1,144 @@
-import { appendFile, mkdir, readFile } from 'node:fs/promises';
-import { dirname, join, resolve } from 'node:path';
-import { AgentRunService } from '../agent/index.js';
-import { createLogger } from '../utils/logger.js';
-import { bootstrapMemoryWorkspace, loadMemoryRootCatalog, validateMemoryCatalogShape } from './catalog.js';
+import { isAbsolute, relative, resolve } from 'node:path';
+import { AgentRunService } from '../../core/agent/index.js';
+import { createLogger } from '../../core/utils/logger.js';
+import { MemoryCatalogService } from './catalog.js';
+import { MemoryMaintenanceRepository } from './maintenance-repository.js';
+import { MemoryMaintainerPrompt } from './maintainer-prompt.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);
-        }
+/**
+ * Owns the agent-backed memory maintenance workflow over pending candidates.
+ */
+export class MemoryMaintenanceService {
+    memoryRoot;
+    repository;
+    catalog;
+    constructor(memoryRoot, repository = new MemoryMaintenanceRepository(memoryRoot), catalog = new MemoryCatalogService(memoryRoot)) {
+        this.memoryRoot = memoryRoot;
+        this.repository = repository;
+        this.catalog = catalog;
     }
-    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).`;
+    async readPendingCandidates() {
+        return await this.repository.readPendingCandidates();
+    }
+    async run(options) {
+        const memoryRoot = resolve(this.memoryRoot);
+        this.catalog.bootstrap();
+        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) => !MemoryMaintenanceService.isMaintainerCandidateAllowed(candidate))
+            .map((candidate) => candidate.id);
+        const observations = options.observations.filter(MemoryMaintenanceService.isMaintainerCandidateAllowed);
+        if (observations.length === 0) {
+            const validation = this.catalog.validateShape();
+            const run = MemoryMaintenanceService.skippedRun({
+                runId,
+                startedAt,
+                finishedAt: now(),
+                source: options.source,
+                candidateIds,
+                skippedCandidateIds,
+                catalogValid: validation.ok,
+                catalogMissing: validation.missing,
+            });
+            await this.repository.appendMaintenanceRun(run);
+            return { run };
+        }
+        const rootCatalog = this.catalog.loadRootCatalog().content;
+        const result = await AgentRunService.run({
+            goal: MemoryMaintainerPrompt.buildMaintenanceGoal(observations),
+            llm: options.llm,
+            tools: createMemoryMaintainerTools({ memoryRoot }),
+            maxSteps: options.maxSteps ?? 40,
+            logger: createLogger({ console: false, level: 'silent' }),
+            systemContext: MemoryMaintainerPrompt.buildSystemContext(rootCatalog),
+        });
+        const validation = this.catalog.validateShape();
+        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: 'skipped',
-            summary,
+            outcome: result.outcome,
+            summary: result.summary,
             candidateIds,
-            processedCandidateIds: [],
-            failedCandidateIds: skippedCandidateIds,
+            processedCandidateIds,
+            failedCandidateIds,
             catalogValid: validation.ok,
             catalogMissing: validation.missing,
         };
-        await appendMaintenanceRun(memoryRoot, run);
-        return { run };
+        await this.repository.appendMaintenanceRun(run);
+        if (processedCandidateIds.length > 0) {
+            await this.repository.appendCandidateStatusEvents(processedCandidateIds, run.id, now);
+        }
+        return { run, result };
     }
-    const rootCatalog = loadMemoryRootCatalog({ memoryRoot }).content;
-    const goal = buildMaintenanceGoal(observations);
-    const systemContext = buildMaintainerSystemContext(rootCatalog);
-    const result = await AgentRunService.run({
-        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);
+    async runBacklog(options) {
+        return await this.run({
+            ...options,
+            observations: await this.readPendingCandidates(),
+        });
     }
-    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());
+    static isRecordableCandidateText(value) {
+        return !MemoryMaintenanceService.containsSecretLikeText(value);
     }
-    catch (error) {
-        if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
-            return [];
+    static isSafeSourceRef(value, memoryRoot) {
+        if (value.includes('\0')) {
+            return false;
+        }
+        if (value.startsWith('trace-') || value.startsWith('session-') || value.startsWith('command:')) {
+            return true;
+        }
+        if (/^[a-z][a-z0-9+.-]*:/i.test(value)) {
+            return false;
         }
-        throw error;
+        if (isAbsolute(value)) {
+            return false;
+        }
+        const normalizedSegments = value.replace(/\\/g, '/').split('/');
+        if (normalizedSegments.includes('..')) {
+            return false;
+        }
+        const workspaceRoot = resolve(memoryRoot, '..', '..');
+        const resolved = resolve(workspaceRoot, value);
+        const rel = relative(workspaceRoot, resolved);
+        return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel);
     }
-}
-function parseJsonObject(line) {
-    try {
-        const parsed = JSON.parse(line);
-        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : undefined;
+    static skippedRun(args) {
+        return {
+            id: args.runId,
+            startedAt: args.startedAt.toISOString(),
+            finishedAt: args.finishedAt.toISOString(),
+            source: args.source,
+            outcome: 'skipped',
+            summary: args.candidateIds.length === 0 ? 'No pending knowledge candidates.'
+                : `Skipped ${args.candidateIds.length} low-value, duplicate, or secret-like memory candidate(s).`,
+            candidateIds: args.candidateIds,
+            processedCandidateIds: [],
+            failedCandidateIds: args.skippedCandidateIds,
+            catalogValid: args.catalogValid,
+            catalogMissing: args.catalogMissing,
+        };
     }
-    catch {
-        return undefined;
+    static isMaintainerCandidateAllowed(candidate) {
+        return MemoryMaintenanceService.isRecordableCandidateText([
+            candidate.summary,
+            ...(candidate.evidence ?? []),
+            ...(candidate.sourceRefs ?? []),
+        ].join('\n'));
+    }
+    static 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-----');
     }
-}
-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

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

@@ -1,20 +1,23 @@
-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>;
+import { MemoryMaintenanceRepository } from './maintenance-repository.js';
+import { MemoryMaintenanceService } from './maintainer.js';
+import type { RunMaintenanceForRecordedCandidatesOptions, RunMaintenanceForRecordedCandidatesResult } from './types.js';
+/**
+ * Bridges turn traces into serialized memory maintenance runs.
+ */
+export declare class MemoryMaintenanceIntegrationService {
+    private readonly memoryRoot;
+    private readonly repository;
+    private readonly maintenance;
+    constructor(memoryRoot: string, repository?: MemoryMaintenanceRepository, maintenance?: MemoryMaintenanceService);
+    runForRecordedCandidates(options: Omit<RunMaintenanceForRecordedCandidatesOptions, 'memoryRoot'>): Promise<RunMaintenanceForRecordedCandidatesResult>;
+    private runNow;
+    private acquireLock;
+    private releaseLock;
+    private removeStaleLock;
+    private enqueue;
+    private static candidateIdsFromTrace;
+    private static createEvent;
+    private static nextMemoryStep;
+    private static sleep;
+}
 //# sourceMappingURL=maintenance-integration.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"maintenance-integration.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/maintenance-integration.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EACV,0CAA0C,EAC1C,yCAAyC,EAC1C,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,qBAAa,mCAAmC;IAE5C,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAFX,UAAU,EAAE,MAAM,EAClB,UAAU,8BAA8C,EACxD,WAAW,2BAAuD;IAG/E,wBAAwB,CAC5B,OAAO,EAAE,IAAI,CAAC,0CAA0C,EAAE,YAAY,CAAC,GACtE,OAAO,CAAC,yCAAyC,CAAC;YAIvC,MAAM;YA0EN,WAAW;YAyCX,WAAW;YAQX,eAAe;YAef,OAAO;IAqBrB,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAMpC,OAAO,CAAC,MAAM,CAAC,WAAW;IAO1B,OAAO,CAAC,MAAM,CAAC,cAAc;mBAIR,KAAK;CAG3B"}