@qduc/term2 0.26.1 → 0.27.0

package/dist/services/memory/distiller/promotion-policy.d.ts

@@ -0,0 +1,26 @@
+import type { CreateMemoryInput } from '../memory-store.js';
+type Record = {
+    sourceIndex: number;
+    role: string;
+    text: string;
+};
+type Lead = {
+    sourceIndex: number;
+    quote: string;
+    category: string;
+};
+type Evidence = {
+    sourceIndex: number;
+    quote: string;
+};
+type Decision = {
+    status: 'rejected' | 'noop';
+} | {
+    status: 'eligible' | 'candidate';
+    memory: CreateMemoryInput;
+    evidence: Evidence;
+};
+/** The model selects a lead; it never authors text that can become a memory. */
+export declare function validateDistilledOperation(value: unknown, records: readonly Record[], leads: readonly Lead[]): Decision;
+export {};
+//# sourceMappingURL=promotion-policy.d.ts.map

package/dist/services/memory/distiller/promotion-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-policy.d.ts","sourceRoot":"","sources":["../../../../source/services/memory/distiller/promotion-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,KAAK,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAClE,KAAK,IAAI,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AACrE,KAAK,QAAQ,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACvD,KAAK,QAAQ,GACT;IAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAAA;CAAE,GAC/B;IAAE,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAExF,gFAAgF;AAChF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,KAAK,EAAE,SAAS,IAAI,EAAE,GACrB,QAAQ,CA2CV"}

package/dist/services/memory/distiller/promotion-policy.js

@@ -0,0 +1,40 @@
+import { containsSecret } from './secret-redaction.js';
+/** The model selects a lead; it never authors text that can become a memory. */
+export function validateDistilledOperation(value, records, leads) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return { status: 'rejected' };
+    const raw = value;
+    if (raw.op === 'noop')
+        return { status: 'noop' };
+    if (raw.op !== 'create' ||
+        raw.scope !== 'project' ||
+        typeof raw.id !== 'string' ||
+        !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(raw.id) ||
+        !['preference', 'decision', 'correction', 'reference'].includes(raw.kind) ||
+        !Array.isArray(raw.evidence) ||
+        raw.evidence.length !== 1)
+        return { status: 'rejected' };
+    const evidence = raw.evidence[0];
+    if (!evidence ||
+        !Number.isSafeInteger(evidence.sourceIndex) ||
+        typeof evidence.quote !== 'string' ||
+        evidence.quote.length === 0 ||
+        evidence.quote.length > 280 ||
+        evidence.quote.includes('[REDACTED]') ||
+        containsSecret(evidence.quote) ||
+        !records.some((record) => record.role === 'user' && record.sourceIndex === evidence.sourceIndex && record.text === evidence.quote))
+        return { status: 'rejected' };
+    const quote = evidence.quote;
+    const lead = leads.find((candidate) => candidate.sourceIndex === evidence.sourceIndex && candidate.quote === quote);
+    const memory = { id: raw.id, title: quote, summary: quote, content: quote, tags: [raw.kind] };
+    return {
+        status: lead?.category === 'preference' &&
+            raw.kind === 'preference' &&
+            !/\b(?:for this task|for now|just this time|temporarily|today|this session|this one time)\b/i.test(quote)
+            ? 'eligible'
+            : 'candidate',
+        memory,
+        evidence: { sourceIndex: evidence.sourceIndex, quote },
+    };
+}
+//# sourceMappingURL=promotion-policy.js.map

package/dist/services/memory/distiller/promotion-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promotion-policy.js","sourceRoot":"","sources":["../../../../source/services/memory/distiller/promotion-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AASvD,gFAAgF;AAChF,MAAM,UAAU,0BAA0B,CACxC,KAAc,EACd,OAA0B,EAC1B,KAAsB;IAEtB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC/F,MAAM,GAAG,GAAG,KAAmC,CAAC;IAChD,IAAI,GAAG,CAAC,EAAE,KAAK,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjD,IACE,GAAG,CAAC,EAAE,KAAK,QAAQ;QACnB,GAAG,CAAC,KAAK,KAAK,SAAS;QACvB,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ;QAC1B,CAAC,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAc,CAAC;QACnF,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC5B,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAEzB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAA6B,CAAC;IAC7D,IACE,CAAC,QAAQ;QACT,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC3C,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ;QAClC,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAC3B,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG;QAC3B,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QACrC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC9B,CAAC,OAAO,CAAC,IAAI,CACX,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK,CAC1G;QAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAEhC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW,IAAI,SAAS,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACpH,MAAM,MAAM,GAAG,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,IAAc,CAAC,EAAE,CAAC;IACxG,OAAO;QACL,MAAM,EACJ,IAAI,EAAE,QAAQ,KAAK,YAAY;YAC/B,GAAG,CAAC,IAAI,KAAK,YAAY;YACzB,CAAC,4FAA4F,CAAC,IAAI,CAAC,KAAK,CAAC;YACvG,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,WAAW;QACjB,MAAM;QACN,QAAQ,EAAE,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAY,EAAE,KAAK,EAAE;KACxD,CAAC;AACJ,CAAC"}

package/dist/services/memory/distiller/secret-redaction.d.ts

@@ -0,0 +1,3 @@
+export declare function redactSecrets(text: string): string;
+export declare function containsSecret(text: string): boolean;
+//# sourceMappingURL=secret-redaction.d.ts.map

package/dist/services/memory/distiller/secret-redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-redaction.d.ts","sourceRoot":"","sources":["../../../../source/services/memory/distiller/secret-redaction.ts"],"names":[],"mappings":"AAqBA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAclD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/services/memory/distiller/secret-redaction.js

@@ -0,0 +1,40 @@
+/**
+ * Content-level secret redaction for text that leaves the machine or becomes
+ * durable memory. Key-name redaction (provider traffic) cannot see a token
+ * pasted into a chat message, so this matches credential shapes in prose.
+ *
+ * Tuned toward recall: a false positive only drops a sentence from a
+ * transcript excerpt or blocks one memory write.
+ */
+const PATTERNS = [
+    /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g,
+    /\bsk-(?:ant-|proj-|or-)?[A-Za-z0-9_-]{20,}/g,
+    /\b(?:ghp|gho|ghu|ghs|ghr|github_pat)_[A-Za-z0-9_]{20,}/g,
+    /\b(?:AKIA|ASIA)[A-Z0-9]{16}\b/g,
+    /\bxox[abprs]-[A-Za-z0-9-]{10,}/g,
+    /\bAIza[0-9A-Za-z_-]{30,}/g,
+    /\beyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}/g,
+    /\b(Bearer|Basic)\s+[A-Za-z0-9._~+/=-]{16,}/gi,
+    /\b[a-z][a-z0-9+.-]*:\/\/[^\s:/@]+:[^\s@/]{3,}@/gi,
+    /\b([A-Za-z0-9_]*(?:api[_-]?key|secret|token|passw(?:or)?d|credential)[A-Za-z0-9_]*)(\s*[:=]\s*)("[^"\n]{4,}"|'[^'\n]{4,}'|[^\s"',;]{8,})/gi,
+];
+export function redactSecrets(text) {
+    let result = text;
+    for (const pattern of PATTERNS) {
+        result = result.replace(pattern, (match, name, separator) => {
+            // Keep the key name so the surrounding sentence still reads.
+            // No-capture regexes pass the match offset and input string in these
+            // positions; only the assignment pattern supplies string captures here.
+            if (typeof name === 'string' && typeof separator === 'string' && /[:=]/.test(separator))
+                return `${name}${separator}[REDACTED]`;
+            if (/^(Bearer|Basic)\s/i.test(match))
+                return `${match.split(/\s+/)[0]} [REDACTED]`;
+            return '[REDACTED]';
+        });
+    }
+    return result;
+}
+export function containsSecret(text) {
+    return redactSecrets(text) !== text;
+}
+//# sourceMappingURL=secret-redaction.js.map

package/dist/services/memory/distiller/secret-redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret-redaction.js","sourceRoot":"","sources":["../../../../source/services/memory/distiller/secret-redaction.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,QAAQ,GAAa;IACzB,6EAA6E;IAC7E,6CAA6C;IAC7C,yDAAyD;IACzD,gCAAgC;IAChC,iCAAiC;IACjC,2BAA2B;IAC3B,kEAAkE;IAClE,8CAA8C;IAC9C,kDAAkD;IAClD,4IAA4I;CAC7I,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAwB,EAAE,SAA6B,EAAE,EAAE;YAClG,6DAA6D;YAC7D,qEAAqE;YACrE,wEAAwE;YACxE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;gBACrF,OAAO,GAAG,IAAI,GAAG,SAAS,YAAY,CAAC;YACzC,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YACnF,OAAO,YAAY,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AACtC,CAAC"}

package/dist/services/memory/memory-capabilities.d.ts

@@ -1,4 +1,5 @@
 import type { ISettingsService } from '../service-interfaces.js';
+import { FileMemoryStore } from './memory-store.js';
 import type { ToolDefinition } from '../../tools/types.js';
 export type MemoryAccess = 'none' | 'read' | 'write';
 export type MemoryCapabilitySubject = {
@@ -13,6 +14,15 @@ export type MemoryCapability = {
     guidance: string;
     context: string;
 };
+export type InjectedMemory = {
+    scope: 'global' | 'project';
+    id: string;
+    title: string;
+};
+export type TurnMemorySelection = {
+    text: string;
+    memories: InjectedMemory[];
+};
 /** Resolves role-specific memory authority and the bounded root-turn working set. */
 export declare class MemoryCapabilityBuilder {
     #private;
@@ -23,9 +33,18 @@ export declare class MemoryCapabilityBuilder {
     contextForTurn(query: string, options?: {
         projectPath?: string;
     }): Promise<string>;
+    /**
+     * The recall block for one user turn. `exclude` holds `recallKey`s already
+     * recalled into this conversation, so a memory is sent at most once.
+     */
+    selectForTurn(query: string, options?: {
+        projectPath?: string;
+        exclude?: ReadonlySet<string>;
+    }): Promise<TurnMemorySelection>;
     build(subject: MemoryCapabilitySubject, options?: {
         projectPath?: string;
         includeContext?: boolean;
     }): MemoryCapability;
+    projectStore(projectPath: string): FileMemoryStore;
 }
 //# sourceMappingURL=memory-capabilities.d.ts.map

package/dist/services/memory/memory-capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-capabilities.d.ts","sourceRoot":"","sources":["../../../source/services/memory/memory-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAErD,MAAM,MAAM,uBAAuB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAwFF,qFAAqF;AACrF,qBAAa,uBAAuB;;IAIlC,YAAY,QAAQ,EAAE,gBAAgB,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAO,EAG9F;IAED,+EAA+E;IACzE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC3F;IAED,KAAK,CACH,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAO,GAC/D,gBAAgB,CAqDlB;CA2CF"}
+{"version":3,"file":"memory-capabilities.d.ts","sourceRoot":"","sources":["../../../source/services/memory/memory-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAW3D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAErD,MAAM,MAAM,uBAAuB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACxF,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AA0H/E,qFAAqF;AACrF,qBAAa,uBAAuB;;IAIlC,YAAY,QAAQ,EAAE,gBAAgB,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAO,EAG9F;IAED,+EAA+E;IACzE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3F;IAED;;;OAGG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAAO,GACpE,OAAO,CAAC,mBAAmB,CAAC,CA4D9B;IAED,KAAK,CACH,OAAO,EAAE,uBAAuB,EAChC,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAO,GAC/D,gBAAgB,CAqDlB;IA0BD,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAWjD;CAmBF"}

package/dist/services/memory/memory-capabilities.js

@@ -4,10 +4,17 @@ import { createMemoryToolDefinitions } from '../../tools/memory/memory-tools.js'
 import { createHash } from 'node:crypto';
 import { execSync } from 'node:child_process';
 import path from 'node:path';
+import { MEMORY_RECALL_OVERHEAD, recallKey, renderMemoryRecall, renderRecallLine, } from '../../prompts/memory-recall-notice.js';
 const READ_TOOL_COUNT = 4;
+/**
+ * Per-turn recall now stays in history, so every recalled line is paid for on
+ * every later request of the session. Keep it to the few best matches.
+ */
+const TURN_RECALL_MAX_MEMORIES = 3;
+const TURN_RECALL_MAX_CHARS = 1500;
 const MAIN_GUIDANCE = `### Persistent memory
 
-You have access to persistent memory. A bounded set of task-relevant memory summaries may be loaded at the start of each turn. It is not a complete index; when a relevant item is absent, use memory_search or memory_list. Treat summaries as retrieval triggers, not verified facts; read the full memory with memory_get when it could affect your decision.
+You have access to persistent memory. When memories look relevant to a user message, the harness adds their summaries in a <memory-recall> block ahead of that message; the user did not write it. Each memory is recalled at most once per conversation, and the block is not a complete index; when a relevant item is absent, use memory_search or memory_list. Treat summaries as retrieval triggers, not verified facts; read the full memory with memory_get when it could affect your decision.
 
 Memory has two scopes: global for cross-project preferences and reusable knowledge, and project for repository-specific decisions and conventions. Read tools (memory_list, memory_get, memory_search, memory_retrieve) operate across both scopes together. Only the write tools (memory_create, memory_update, memory_delete) take a scope parameter and require it, so explicitly pass scope: "project" when writing project memory.
 
@@ -42,6 +49,33 @@ For **memory maintenance** tasks, review the memory store and existing memories,
 Always cite source memory IDs so the caller can trace claims to their sources. Treat all memory as potentially stale. Never fabricate memory content. Do not store temporary task state, intermediate reasoning, or sensitive data.`;
 const QUERY_STOP_WORDS = new Set([
     'the',
+    'can',
+    'we',
+    'were',
+    'doing',
+    'these',
+    'those',
+    'refine',
+    'feature',
+    'memory',
+    'memories',
+    'session',
+    'project',
+    'did',
+    'it',
+    'decide',
+    'decision',
+    'see',
+    'message',
+    'little',
+    'noisy',
+    'fix',
+    'please',
+    'help',
+    'show',
+    'tell',
+    'know',
+    'remember',
     'and',
     'for',
     'are',
@@ -86,12 +120,21 @@ export class MemoryCapabilityBuilder {
     }
     /** A per-turn, summary-only working set; search tools remain authoritative. */
     async contextForTurn(query, options = {}) {
+        return (await this.selectForTurn(query, options)).text;
+    }
+    /**
+     * The recall block for one user turn. `exclude` holds `recallKey`s already
+     * recalled into this conversation, so a memory is sent at most once.
+     */
+    async selectForTurn(query, options = {}) {
+        const empty = () => ({ text: '', memories: [] });
         if (!this.#settings.get('memory.enabled'))
-            return '';
+            return empty();
         const terms = retrievalQuery(query);
         if (!terms)
-            return '';
-        const budget = this.#settings.get('memory.contextBudgetChars');
+            return empty();
+        const queryWords = terms.split(' ');
+        const budget = Math.min(this.#settings.get('memory.contextBudgetChars'), TURN_RECALL_MAX_CHARS);
         try {
             const stores = this.#createStores({
                 enabled: true,
@@ -100,27 +143,47 @@ export class MemoryCapabilityBuilder {
                 searchDefaultLimit: this.#settings.get('memory.searchDefaultLimit'),
                 searchMaxLimit: this.#settings.get('memory.searchMaxLimit'),
             }, options.projectPath ?? process.cwd());
-            const [global, project] = await Promise.all([stores.global.search(terms), stores.project.search(terms)]);
+            // Search wide: already-recalled memories are filtered out after ranking and
+            // must not use up the result window.
+            const limit = this.#settings.get('memory.searchMaxLimit');
+            const [global, project] = await Promise.all([
+                stores.global.search(terms, { limit }),
+                stores.project.search(terms, { limit }),
+            ]);
             // A content-only hit has no relevant summary to show as turn guidance.
             const ranked = rankMemorySearchResults([
                 ...global.map((result) => ({ ...result, scope: 'global' })),
                 ...project.map((result) => ({ ...result, scope: 'project' })),
-            ]).filter((result) => result.matchedFields.some((field) => field !== 'content'));
-            if (!ranked.length)
-                return '';
-            const header = '## Relevant persistent memory (summaries, not verified facts)\n\nUse memory_get for full evidence; memory_search for other memories.\n';
-            let context = header;
+            ]).filter(({ scope, memory }) => {
+                // Require evidence in the injected metadata, not a substring hit in full content.
+                // Known conversational padding cannot make a topical match more or less eligible.
+                // Ambiguous follow-ups can still use memory tools instead of a guessed summary.
+                const words = new Set([memory.id, memory.title, ...memory.tags, memory.summary]
+                    .join(' ')
+                    .toLowerCase()
+                    .match(/[a-z0-9]+/g) ?? []);
+                return queryWords.some((word) => words.has(word)) && !options.exclude?.has(recallKey(scope, memory.id));
+            });
+            let used = MEMORY_RECALL_OVERHEAD;
+            const lines = [];
+            const memories = [];
             for (const { scope, memory } of ranked) {
-                const line = `- ${scope} / \`${memory.id}\` — ${memory.title.slice(0, 120)} — ${memory.summary}\n`;
-                if (context.length + line.length <= budget)
-                    context += line;
+                if (memories.length >= TURN_RECALL_MAX_MEMORIES)
+                    break;
+                const title = memory.title.slice(0, 120);
+                const line = renderRecallLine({ scope, id: memory.id, title, summary: memory.summary });
+                if (used + line.length + 1 <= budget) {
+                    used += line.length + 1;
+                    lines.push(line);
+                    memories.push({ scope, id: memory.id, title });
+                }
             }
-            return context === header ? '' : context;
+            return memories.length ? { text: renderMemoryRecall(lines), memories } : empty();
         }
         catch (error) {
             const detail = error instanceof Error ? error.message : String(error);
             this.#onWarning(`Persistent memory retrieval could not be loaded: ${detail}`);
-            return '';
+            return empty();
         }
     }
     build(subject, options = {}) {
@@ -201,6 +264,15 @@ export class MemoryCapabilityBuilder {
             project: new FileMemoryStore({ root: path.join(settings.directory, 'projects', projectId), ...options }),
         };
     }
+    projectStore(projectPath) {
+        return this.#createStores({
+            enabled: this.#settings.get('memory.enabled'),
+            directory: this.#settings.get('memory.directory'),
+            contextBudgetChars: this.#settings.get('memory.contextBudgetChars'),
+            searchDefaultLimit: this.#settings.get('memory.searchDefaultLimit'),
+            searchMaxLimit: this.#settings.get('memory.searchMaxLimit'),
+        }, projectPath).project;
+    }
     #resolveProjectId(projectPath) {
         try {
             const commonDir = execSync('git rev-parse --git-common-dir', {

package/dist/services/memory/memory-capabilities.js.map

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

package/dist/services/memory/memory-store.d.ts

@@ -1,4 +1,9 @@
 export type MemoryId = string;
+export interface MemoryProvenance {
+    at: string;
+    sessionId?: string;
+    reason: string;
+}
 export interface MemoryMetadata {
     id: MemoryId;
     title: string;
@@ -6,6 +11,7 @@ export interface MemoryMetadata {
     tags: string[];
     createdAt: string;
     updatedAt: string;
+    provenance?: MemoryProvenance;
 }
 export interface Memory extends MemoryMetadata {
     content: string;
@@ -22,6 +28,13 @@ export interface UpdateMemoryInput {
     summary?: string;
     content?: string;
     tags?: string[];
+    /** Correction of a fact rather than a cosmetic edit; preserves the prior version. */
+    supersede?: {
+        reason: string;
+    };
+}
+export interface MemoryHistoryEntry extends Memory {
+    supersededBy: MemoryProvenance;
 }
 export interface MemorySearchResult {
     memory: MemoryMetadata;
@@ -45,7 +58,10 @@ export interface MemoryStore {
         maxLimit: number;
     };
     create(input: CreateMemoryInput): Promise<Memory>;
-    update(id: MemoryId, input: UpdateMemoryInput): Promise<Memory>;
+    update(id: MemoryId, input: UpdateMemoryInput, context?: {
+        sessionId?: string;
+    }): Promise<Memory>;
+    history?(id: MemoryId): Promise<MemoryHistoryEntry[]>;
     remove(id: MemoryId): Promise<boolean>;
 }
 export declare class InvalidMemoryError extends Error {
@@ -95,6 +111,7 @@ export declare class FileMemoryStore implements MemoryStore {
         limit?: number;
     }): Promise<MemoryMetadata[]>;
     get(id: MemoryId): Promise<Memory | null>;
+    history(id: MemoryId): Promise<MemoryHistoryEntry[]>;
     search(query: string, options?: {
         limit?: number;
     }): Promise<MemorySearchResult[]>;
@@ -103,11 +120,16 @@ export declare class FileMemoryStore implements MemoryStore {
         maxLimit: number;
     };
     create(input: CreateMemoryInput): Promise<Memory>;
-    update(id: MemoryId, input: UpdateMemoryInput): Promise<Memory>;
+    /** A non-blocking, cross-process pilot lock; a busy/stale lock fails closed. */
+    createAutomatic(input: CreateMemoryInput, sessionId: string): Promise<Memory | null>;
+    update(id: MemoryId, input: UpdateMemoryInput, context?: {
+        sessionId?: string;
+    }): Promise<Memory>;
     remove(id: MemoryId): Promise<boolean>;
     context(budgetChars: number): Promise<string>;
     contextSync(budgetChars: number): string;
     private itemPath;
+    private historyPath;
     private load;
     private initialize;
     private initializeOnce;

package/dist/services/memory/memory-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../source/services/memory/memory-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../source/services/memory/memory-store.ts"],"names":[],"mappings":"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"}

package/dist/services/memory/memory-store.js

@@ -1,4 +1,4 @@
-import { mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, rename, rmdir, unlink, writeFile } from 'node:fs/promises';
 import { readFileSync } from 'node:fs';
 import { randomUUID } from 'node:crypto';
 import { join, resolve } from 'node:path';
@@ -137,6 +137,22 @@ export class FileMemoryStore {
             throw new MemoryStorageError(`Memory content is unavailable for '${id}'.`);
         }
     }
+    async history(id) {
+        validateId(id);
+        if (!(await this.load()).memories.some((entry) => entry.id === id))
+            return [];
+        try {
+            const entries = JSON.parse(await readFile(this.historyPath(id), 'utf8'));
+            if (!Array.isArray(entries) || !entries.every(validHistoryEntry))
+                throw new Error();
+            return entries;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw new MemoryStorageError(`Memory history is unavailable for '${id}'.`);
+        }
+    }
     async search(query, options = {}) {
         const terms = queryTerms(query);
         if (!terms.length)
@@ -182,9 +198,57 @@ export class FileMemoryStore {
             return memory;
         });
     }
-    async update(id, input) {
-        if (!Object.values(input).some((value) => value !== undefined))
+    /** A non-blocking, cross-process pilot lock; a busy/stale lock fails closed. */
+    async createAutomatic(input, sessionId) {
+        return this.mutate(async () => {
+            const normalized = normalizeCreate(input);
+            if (!sessionId.trim())
+                throw new InvalidMemoryError('Automatic memory requires a source session.');
+            await this.initialize();
+            const lock = join(this.root, '.automatic-canary.lock');
+            try {
+                await mkdir(lock);
+            }
+            catch (error) {
+                if (error.code === 'EEXIST')
+                    return null;
+                throw error;
+            }
+            try {
+                const index = await this.load();
+                if (index.memories.some((memory) => memory.id === normalized.id || memory.title === normalized.title))
+                    return null;
+                const timestamp = this.now().toISOString();
+                const memory = {
+                    ...normalized,
+                    createdAt: timestamp,
+                    updatedAt: timestamp,
+                    provenance: { at: timestamp, sessionId: sessionId.trim(), reason: normalized.content },
+                };
+                await writeFile(this.itemPath(memory.id), memory.content, { encoding: 'utf8', flag: 'wx' });
+                try {
+                    await this.writeIndex({ version: 1, memories: [...index.memories, metadata(memory)] });
+                }
+                catch (error) {
+                    // The primary index may have committed before its backup failed.
+                    // Only discard the item when a readable index proves it was not committed.
+                    const committed = await this.load().then((current) => current.memories.some((entry) => entry.id === memory.id), () => true);
+                    if (!committed)
+                        await unlink(this.itemPath(memory.id));
+                    throw error;
+                }
+                return memory;
+            }
+            finally {
+                await rmdir(lock);
+            }
+        });
+    }
+    async update(id, input, context) {
+        if (!Object.entries(input).some(([key, value]) => key !== 'supersede' && value !== undefined))
             throw new InvalidMemoryError('At least one field must be provided for a memory update.');
+        if (input.supersede && !input.supersede.reason?.trim())
+            throw new InvalidMemoryError('A correction requires a reason.');
         return this.mutate(async () => {
             validateId(id);
             const index = await this.load();
@@ -195,9 +259,19 @@ export class FileMemoryStore {
             if (!old)
                 throw new MemoryNotFoundError(id);
             const next = normalizeUpdate(old, input);
-            const memory = { ...next, updatedAt: this.now().toISOString() };
+            const timestamp = this.now().toISOString();
+            const provenance = input.supersede && {
+                at: timestamp,
+                ...(context?.sessionId?.trim() ? { sessionId: context.sessionId.trim() } : {}),
+                reason: input.supersede.reason.trim(),
+            };
+            const memory = { ...next, updatedAt: timestamp, ...(provenance ? { provenance } : {}) };
+            if (provenance) {
+                const history = await this.history(id);
+                await this.writeFileAtomically(this.historyPath(id), `${JSON.stringify([...history, { ...old, supersededBy: provenance }], null, 2)}\n`);
+            }
             if (input.content !== undefined && input.content !== old.content)
-                await writeFile(this.itemPath(id), memory.content, 'utf8');
+                await this.writeFileAtomically(this.itemPath(id), memory.content);
             await this.writeIndex({
                 version: 1,
                 memories: index.memories.map((entry) => (entry.id === id ? metadata(memory) : entry)),
@@ -216,6 +290,10 @@ export class FileMemoryStore {
                 if (error.code !== 'ENOENT')
                     throw new MemoryStorageError('Unable to remove memory content.');
             });
+            await unlink(this.historyPath(id)).catch((error) => {
+                if (error.code !== 'ENOENT')
+                    throw new MemoryStorageError('Unable to remove memory history.');
+            });
             return true;
         });
     }
@@ -238,6 +316,10 @@ export class FileMemoryStore {
         validateId(id);
         return join(this.itemsPath, `${id}.md`);
     }
+    historyPath(id) {
+        validateId(id);
+        return join(this.itemsPath, `${id}.history.json`);
+    }
     async load() {
         await this.initialize();
         let contents;
@@ -408,7 +490,8 @@ function validateIndex(value) {
                 !Array.isArray(entry.tags) ||
                 entry.tags.some((tag) => typeof tag !== 'string') ||
                 !isUtcTimestamp(entry.createdAt) ||
-                !isUtcTimestamp(entry.updatedAt))
+                !isUtcTimestamp(entry.updatedAt) ||
+                (entry.provenance !== undefined && !validProvenance(entry.provenance)))
                 throw new Error();
             ids.add(entry.id);
         }
@@ -418,6 +501,27 @@ function validateIndex(value) {
     }
     return index;
 }
+function validProvenance(value) {
+    const provenance = value;
+    return (!!provenance &&
+        isUtcTimestamp(provenance.at) &&
+        (provenance.sessionId === undefined ||
+            (typeof provenance.sessionId === 'string' && !!provenance.sessionId.trim())) &&
+        typeof provenance.reason === 'string' &&
+        !!provenance.reason.trim());
+}
+function validHistoryEntry(value) {
+    const entry = value;
+    if (!entry || typeof entry.content !== 'string' || !validProvenance(entry.supersededBy))
+        return false;
+    try {
+        validateIndex({ version: 1, memories: [metadata(entry)] });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 function isUtcTimestamp(value) {
     return (typeof value === 'string' &&
         /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(value) &&