solopup-memory 0.21.0-beta.2 → 0.22.0-beta.3

package/index.mjs

@@ -5,6 +5,7 @@ export {initializeManagedMemory,managedMemoryStatus} from './managed-access.mjs'
 import {createObservationTracker,observationRoots,OBSERVATION_REFERENCE_SCHEMA,OBSERVATION_LIST_SCHEMA} from './tool-observations.mjs'
 import {createToolInputTracker} from './tool-inputs.mjs'
 import {memoryProtocol} from './memory-protocol.mjs'
+import {privateMemory,publicMemoryRecords,publicMemoryIndex,PRIVATE_MEMORY_NOTICE} from './privacy.mjs'
 import {nativeOwnerEvidence,validateNativeWrite} from './native-write-validation.mjs'
 import {toolProposal} from './source-record.mjs'
 import {revisionMode,prepareValueRevision,inheritedRoots} from './field-lineage.mjs'
@@ -291,8 +292,9 @@ function renderScopeLocal(scope, dir) {
   let flagged = 0
   const kept = []
   const policy = withdrawalPolicy(dir)
-  const typed=activeMeanings(candidateSnapshot(dir,scope).records),assessmentRecords=effectiveSourceRecords(dir,scope)
+  const typed=activeMeanings(candidateSnapshot(dir,scope).records),assessmentRecords=publicMemoryRecords(effectiveSourceRecords(dir,scope))
   for (const line of filterWithdrawn(index.text, policy, true).split('\n')) {
+    if (privateMemory(meaningForLine(typed,line),line)) continue
     if (line.trim().startsWith('- [')) {
       if (isExpired(line, now)) {
         hidden += 1
@@ -888,7 +890,7 @@ function writeMemoryLocal({ type, dir, line, detail, summary, expires, supersede
     }
 
     // 相似度闸：改写同一件事却再叠一条，会让新旧两条同时被注入、给出矛盾信息。
-    // 0.95 以上直接拒绝并指出候选；0.85–0.95 放行但带警告（避免误伤「相似但不同」的条目）。
+    // 0.9 以上直接拒绝并指出候选；0.8–0.9 放行但带警告（避免误伤「相似但不同」的条目）。
     let similarWarning
     // 完全重复走 duplicate 分支（幂等返回），相似度闸只管「像但不是同一句」
     const alias = hasTopicDetail(cleanDetail) ? undefined : routeAlias(cleanLine, type)
@@ -1048,16 +1050,19 @@ function writeMemoryLocal({ type, dir, line, detail, summary, expires, supersede
       evidence: provenance?.evidence,
       basis: provenance?.basis,
     })
+    const privateLines=new Set(liveSourceRecords(dir,scope).filter(privateMemory).map(record=>record.indexLine).filter(Boolean))
+    const hiddenLine=line=>privateLines.has(line)||privateMemory(line)
+    const visibleWarnings=warnings.filter(w=>!privateMemory(w)&&![...privateLines].some(line=>w.includes(summaryOf(line))))
     return {
       path: indexFile,
       indexLine: cleanLine,
       duplicate: false,
       lineCount: next.split(/\r?\n/).length,
       ...(detailPath === undefined ? {} : { detailPath }),
-      ...(supersededLine === undefined ? {} : { superseded: supersededLine }),
+      ...(supersededLine === undefined||hiddenLine(supersededLine) ? {} : { superseded: supersededLine }),
       id: newId,
-      related,
-      ...(warnings.length === 0 ? {} : { warning: warnings.join('；') }),
+      related:related.filter(edge=>!hiddenLine(edge.line)),
+      ...(visibleWarnings.length === 0 ? {} : { warning: visibleWarnings.join('；') }),
     }
   }
   return lockToken === REVIEW_LOCK ? execute() : withLock(dir, execute)
@@ -1219,8 +1224,32 @@ function statusOfLocal(dir) {
 }
 
 /**
- * 在索引与主题文件里做子串检索。
- *
+ * L0 检测摘要：把 detect.mjs 的 findings 压成计数，避免状态输出膨胀。
+ * 动态导入是为了不形成 index ↔ detect 的静态循环（detect 依赖本文件的纯函数）。
+ */
+async function lintStatus(dir, scope) {
+  try {
+    const { detectStore } = await import('./detect.mjs')
+    const report = detectStore(dir, { scope })
+    const counts = new Map()
+    for (const finding of report.findings) {
+      if (finding.severity === 'info') continue
+      const row = counts.get(finding.id) ?? { id: finding.id, severity: finding.severity, count: 0 }
+      row.count += 1
+      counts.set(finding.id, row)
+    }
+    return {
+      errors: report.summary.errors,
+      warnings: report.summary.warnings,
+      checks: [...counts.values()].sort((left, right) => (left.id < right.id ? -1 : left.id > right.id ? 1 : 0)),
+    }
+  } catch {
+    // 检测器本身坏了不能伪装成“库没问题”。
+    return { errors: 0, warnings: 1, checks: [{ id: 'lint-unavailable', severity: 'warning', count: 1 }] }
+  }
+}
+
+/**
  * 存在的原因：索引超上限时，被省略的条目对模型完全不可见（`lookupLinks` 只查索引）。
  * 检索是确定性的：归一化后做子串匹配，不做正则、不做模糊。
  *
@@ -1245,7 +1274,7 @@ function effectiveSourceRecords(dir,scope,indexText,includeUntyped=false){
 }
 
 /** Current index-only legacy entries are visible as unclassified data, never inherited sources. */
-function validationCurrentRecords(dir,scope,records){
+function validationCurrentRecords(dir,scope,records,privateTarget){
  const policy=withdrawalPolicy(dir),index=filterWithdrawn(readTextSafe(join(dir,'MEMORY.md'))??'',policy,true)
  const known=new Set(records.map(r=>r.indexLine??indexLine(r.type,r.summary,r.expires,r.detail!==undefined))),rows=[...records]
  for(const line of new Set(index.split(/\r?\n/).map(line=>line.trim()))){
@@ -1253,7 +1282,7 @@ function validationCurrentRecords(dir,scope,records){
   const type=/^- \[(user|feedback|project|reference)\] /.exec(line)?.[1];if(!type)continue
   rows.push({id:createHash('sha256').update('memory-unclassified-current-index:'+scope+':'+line).digest('hex'),status:'recorded',scope,type,summary:summaryOf(line),indexLine:line,legacyIndexOnly:true,expires:/ \(exp:(\d{4}-\d{2}-\d{2})\)$/.exec(line)?.[1]})
  }
- return rows
+ return rows.filter(row=>!privateMemory(row)||typeof privateTarget==='string'&&privateTarget.length>0&&row.indexLine?.includes(privateTarget))
 }
 
 function publishIndexChange(dir,before,after,reason){
@@ -1269,6 +1298,7 @@ function searchHistoricalStores(stores,needle,options,context,task,limit,mode){
     const policy=withdrawalPolicy(dir),index=filterWithdrawn(readTextSafe(join(dir,'MEMORY.md'))??'',policy,true)
     const result=historyRows(dir,{scope,index,revoked:policy.revoked,atSequence:options.atSequence,asOf:options.asOf,expiredAt:isExpired});coverage.push(result.coverage)
     for(const {row,line,history}of result.rows){
+      if(options.includePrivate!==true&&privateMemory(row.source,row.line))continue
       const interpretation=row.source.meaning?meaningView(row.source,context,task):undefined
       if(interpretation?.applicability==='not-applicable')continue
       if(interpretation)interpretation.advice={action:'continue',reason:'historical-record-is-not-a-current-instruction',authority:'none'}
@@ -1298,6 +1328,7 @@ function searchScopedStoresLocal(stores, query, options = {}) {
   if (needle.length > 200) throw new Error('memory_search: query 太长（上限 200 字）')
   const limit = Math.max(1, Math.min(20, options.limit ?? 8))
   const mode = options.mode ?? 'ranked'
+  if(options.includePrivate!==undefined&&typeof options.includePrivate!=='boolean')throw Error('memory-search-invalid-private-option')
   if (mode !== 'exact' && mode !== 'ranked') throw new Error('memory_search: mode 必须是 exact 或 ranked')
   const context=normalizeContext(options.context),task=normalizeTask(options.task)
   if(options.view!==undefined&&!['current','history'].includes(options.view))throw new Error('memory-search-invalid-view')
@@ -1306,7 +1337,7 @@ function searchScopedStoresLocal(stores, query, options = {}) {
 
   const files = stores.flatMap(({ dir, scope }) => {
     const policy = withdrawalPolicy(dir)
-    const owned=liveSourceRecords(dir,scope).filter(record=>['recorded','adopted'].includes(record.status)),typed=activeMeanings(owned),assessmentRecords=effectiveSourceRecords(dir,scope)
+    const owned=liveSourceRecords(dir,scope).filter(record=>['recorded','adopted'].includes(record.status)),typed=activeMeanings(owned),assessmentRecords=options.includePrivate===true?effectiveSourceRecords(dir,scope):publicMemoryRecords(effectiveSourceRecords(dir,scope))
     return ['MEMORY.md', ...TYPES.map(type => `${type}.md`)].map(name => ({
       name, path: join(dir, name), policy, scope, typed, owned, assessmentRecords, key: scope === undefined ? name : `${scope}/${name}`,
     }))
@@ -1319,12 +1350,16 @@ function searchScopedStoresLocal(stores, query, options = {}) {
   for (const file of files) {
     const text = readTextSafe(file.path)
     if (text === undefined) continue
+    // Legacy topic paragraphs may span lines without record markers. Never
+    // return the unlabelled continuation of a recognized private paragraph.
+    if(file.name!=='MEMORY.md'&&options.includePrivate!==true&&privateMemory(text))continue
     let lineNumber = 0
     const filtered=filterWithdrawn(text,file.policy,file.name==='MEMORY.md'),details=file.name==='MEMORY.md'?undefined:detailedMeanings(file.owned,filtered)
     for (const raw of filtered.split('\n')) {
       lineNumber += 1
       if(file.name==='MEMORY.md'&&isExpired(raw))continue
       const record=file.name==='MEMORY.md'?meaningForLine(file.typed,raw):details.get(lineNumber)
+      if(options.includePrivate!==true&&privateMemory(record,raw))continue
       if(record?.expires&&isExpired(`placeholder (exp:${record.expires})`))continue
       const interpretation=record?.meaning?meaningView(record,context,task,file.assessmentRecords):undefined
       if(interpretation?.applicability==='not-applicable')continue
@@ -1599,6 +1634,8 @@ function readLog(dir) {
  * @param query - `{ id }` 或 `{ match }`（索引行子串，必须唯一）。
  */
 function lookupLinksLocal(dir, query) {
+  const hiddenLines=new Set(liveSourceRecords(dir).filter(privateMemory).map(record=>record.indexLine).filter(Boolean))
+  const hidden=line=>hiddenLines.has(line)||privateMemory(line)
   assertPublicationClear(dir)
   const policy = withdrawalPolicy(dir)
   const events = readLog(dir).filter((e) => !policy.memoryIds.includes(e.id) && !policy.lineHashes.includes(normalizedLineHash(String(e.line ?? ''))))
@@ -1607,7 +1644,7 @@ function lookupLinksLocal(dir, query) {
   const live = new Map()
   for (const line of current.split('\n')) {
     const trimmed = line.trim()
-    if (trimmed.startsWith('- [')) live.set(entryId(trimmed), trimmed)
+    if (trimmed.startsWith('- [')&&!hidden(trimmed)) live.set(entryId(trimmed), trimmed)
   }
 
   let key = query.id
@@ -1628,8 +1665,9 @@ function lookupLinksLocal(dir, query) {
   const inserted = events.filter((event) => event.op === 'insert' && event.id === key)
   const line = live.get(key) ?? inserted.at(-1)?.line ?? events.find((event) => event.id === key)?.line
   if (line === undefined) return { found: false, related: [], backlinks: [] }
+  if(hidden(line))return{found:false,related:[],backlinks:[]}
 
-  const related = inserted.at(-1)?.related ?? []
+  const related = (inserted.at(-1)?.related ?? []).filter(item=>!hidden(item.line))
 
   // 入边要顺着取代链找：指向被取代旧条目的边，等同指向新条目。
   // 否则「改了一条记忆」就等于把它从图上拔掉。
@@ -1640,6 +1678,7 @@ function lookupLinksLocal(dir, query) {
   const backlinks = []
   for (const event of events) {
     if (event.op !== 'insert' || lineage.has(event.id)) continue
+    if(hidden(event.line))continue
     if (!(event.related ?? []).some((item) => lineage.has(item.id))) continue
     if (backlinks.some((item) => item.id === event.id)) continue
     backlinks.push({ id: event.id, line: event.line })
@@ -1661,7 +1700,7 @@ function lookupLinksLocal(dir, query) {
     backlinks: backlinks.slice(0, RELATION_LIMIT),
     backlinksTotal: backlinks.length,
     ...(replaced?.supersededById === undefined ? {} : { supersededById: replaced.supersededById }),
-    ...(supersedesLine === undefined ? {} : { supersedesLine }),
+    ...(supersedesLine === undefined||hidden(supersedesLine) ? {} : { supersedesLine }),
   }
 }
 
@@ -1777,7 +1816,7 @@ async function admitNativeWrite(ctx,sourceInputs,config,args,exec,target){
   const revision=readOwned(()=>{
     const value=storeRevision(target.dir)
     const sourceRecords=effectiveSourceRecords(target.dir,target.scope,undefined,true)
-    currentRecords=validationCurrentRecords(target.dir,target.scope,sourceRecords)
+    currentRecords=validationCurrentRecords(target.dir,target.scope,sourceRecords,target.supersedes)
     if(target.supersedes!==undefined){
       const hits=(readTextSafe(join(target.dir,'MEMORY.md'))??'').split(/\r?\n/).filter(line=>line.trim().startsWith('- [')&&line.includes(target.supersedes));if(hits.length!==1)throw Error('memory-native-supersedes-not-unique')
       const compiled=prepareValueRevision(target,sourceRecords,hits[0].trim())
@@ -1946,6 +1985,7 @@ function defineSearchTool(ctx) {
     name: 'memory_search',
     description:
       '在记忆索引与主题文件里检索。默认 ranked 支持中英多词问题与有限英文词形归并；exact 用于精确子串定位；' +
+      '默认隐藏已识别的个人敏感内容。用户询问相关资料时才设includePrivate=true；返回内容会进入当前会话日志和模型请求，不能声称只在本地读取。' +
       '默认同时查当前项目和全局偏好，不查其他项目；可指定单库。view=history显式查询带来源的旧值、取代与移出记录，返回历史身份及覆盖范围，不能当当前指令。',
     parameters: {
       type: 'object',
@@ -1953,6 +1993,7 @@ function defineSearchTool(ctx) {
       required: ['query'],
       properties: {
         query: { type: 'string', description: '检索词，尽量具体（≤200 字）；也可给返回的完整64位recordId精确定位来源条目，不能用8位索引id' },
+        includePrivate:{type:'boolean',description:'仅在用户询问相关个人资料时明确设true，允许读取被自动降载的个人内容。默认false；不是文件访问权限或完整隐私识别器。'},
         mode: { type: 'string', enum: ['exact', 'ranked'], description: 'ranked 默认多词排序；exact 精确定位。不是语义向量检索，不支持完整同义词或英文词形分析' },
         view:{type:'string',enum:['current','history'],description:'current默认只查当前视图；history查受管历史档案（已撤回来源仍不可见）。旧日志不会被伪造成完整历史。'},
         atSequence:{type:'integer',description:'仅history：按选定单库的记录序号查询当时有效的条目，必须指定scope=project或global；不是跨库统一版本。'},
@@ -2000,10 +2041,10 @@ function defineSearchTool(ctx) {
         return searchScopedStores([
           { dir: resolveStoreDir(ctx, exec, 'memory_search', 'project'), scope: 'project' },
           { dir: resolveStoreDir(ctx, exec, 'memory_search', 'global'), scope: 'global' },
-        ], args.query, { limit: args.limit, mode: args.mode, context:args.context,task:args.task,view:args.view,atSequence:args.atSequence,asOf:args.asOf })
+        ], args.query, { includePrivate:args.includePrivate,limit: args.limit, mode: args.mode, context:args.context,task:args.task,view:args.view,atSequence:args.atSequence,asOf:args.asOf })
       }
       const dir = resolveStoreDir(ctx, exec, 'memory_search', args.scope)
-      return searchStore(dir, args.query, { limit: args.limit, mode: args.mode, context:args.context,task:args.task,view:args.view,atSequence:args.atSequence,asOf:args.asOf })
+      return searchStore(dir, args.query, { includePrivate:args.includePrivate,limit: args.limit, mode: args.mode, context:args.context,task:args.task,view:args.view,atSequence:args.atSequence,asOf:args.asOf })
     },
   }
 }
@@ -2134,6 +2175,29 @@ function defineStatusTool(ctx, sourceInputs) {
           expired: { type: 'integer' },
           duplicateGroups: { type: 'integer' },
           storeBytes: { type: 'integer' },
+          // L0 检测摘要：只给计数与检查项；明细走 `node scripts/detect.mjs --json`。
+          lint: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['errors', 'warnings', 'checks'],
+            properties: {
+              errors: { type: 'integer' },
+              warnings: { type: 'integer' },
+              checks: {
+                type: 'array',
+                items: {
+                  type: 'object',
+                  additionalProperties: false,
+                  required: ['id', 'severity', 'count'],
+                  properties: {
+                    id: { type: 'string' },
+                    severity: { type: 'string', enum: ['error', 'warning'] },
+                    count: { type: 'integer' },
+                  },
+                },
+              },
+            },
+          },
           sourceLedger: { type: 'object', additionalProperties: false,
             required: ['available', 'fullLimit', 'pendingLimit', 'retiredLimit', 'byteLimit'],
             properties: { available: { type: 'boolean' }, fullRecords: { type: 'integer' }, retiredRecords: { type: 'integer' }, pending: { type: 'integer' }, bytes: { type: 'integer' }, fullLimit: { type: 'integer' }, pendingLimit: { type: 'integer' }, retiredLimit: { type: 'integer' }, byteLimit: { type: 'integer' }, reason: { type: 'string', enum: ['source-ledger-unavailable'] } } },
@@ -2160,7 +2224,8 @@ function defineStatusTool(ctx, sourceInputs) {
             text:
               `索引 ${value.index.lines}/${value.index.limitLines} 行、${value.index.bytes}/${value.index.limitBytes} 字节；` +
               `类型：${types}；过期 ${value.expired} 条；重复组 ${value.duplicateGroups}；` +
-              `主题文件：${topics || '无'}；库占用 ${(value.storeBytes / 1024).toFixed(1)}K。\n` +
+              `主题文件：${topics || '无'}；库占用 ${(value.storeBytes / 1024).toFixed(1)}K。` +
+              (value.lint ? `\n检测（L0）：error ${value.lint.errors}、warning ${value.lint.warnings}` + (value.lint.checks.length ? '；' + value.lint.checks.map((check) => `${check.id}×${check.count}`).join('、') : '') + '（明细：node scripts/detect.mjs）' : '') + '\n' +
               (value.sourceLedger?.available ? `来源记录 ${value.sourceLedger.fullRecords}/${value.sourceLedger.fullLimit}；历史来源凭据 ${value.sourceLedger.retiredRecords}/${value.sourceLedger.retiredLimit}；待审 ${value.sourceLedger.pending}/${value.sourceLedger.pendingLimit}；来源占用 ${(value.sourceLedger.bytes / 1024).toFixed(1)}/${value.sourceLedger.byteLimit / 1024}K。\n` : '来源账本待修复，容量状态未知。\n') + value.dir+(value.capture?'\n捕获诊断（全局保留作业）：'+(!value.capture.available?'账本不可用，未知':value.capture.latest?.diagnostic?value.capture.latest.diagnostic.classification+'；解析拒绝'+value.capture.latest.diagnostic.parserRejected+'，截断'+value.capture.latest.diagnostic.deferred+'，准入拒绝'+value.capture.latest.diagnostic.admissionRejected+'，写入失败'+value.capture.latest.diagnostic.writeFailures+'；不证明没有漏记':value.capture.latest?'旧作业无细分诊断或仍未完成，不能推断空结果':'尚无捕获作业记录；不能推断没有长期信息'):'')+(value.capture?.blockedInput?'\n自动整理未执行：用户来源不完整；没有从截断的前半段建立记忆。':'')+(value.executionObservations?'\n可引用执行结果（复制callId及原文）：\n'+value.executionObservations.items.map(item=>JSON.stringify(item)).join('\n')+'\n'+value.executionObservations.note+(value.executionObservations.truncated?'（列表有省略，优先核对最近结果）':''):'') ,
           },
         ]
@@ -2169,6 +2234,7 @@ function defineStatusTool(ctx, sourceInputs) {
     async execute(args, exec) {
       const dir = resolveStoreDir(ctx, exec, 'memory_status', args.scope)
       const value={...statusOf(dir),capture:managedRead(storeRoot(),()=>captureJobStatus(storeRoot()))}
+      value.lint = await lintStatus(dir, dir === storeRoot() ? 'global' : 'project')
       if(args.includeObservations!==undefined&&typeof args.includeObservations!=='boolean')throw Error('memory-observation-invalid-list-option')
       if(args.includeObservations===true){if(!captureSessionEligible(exec?.agent?.session))throw Error('memory-observation-source-unavailable');return{...value,executionObservations:sourceInputs.availableForExecution(exec)}}
       return value
@@ -2196,7 +2262,7 @@ function defineStatusTool(ctx, sourceInputs) {
     if(args.scope!=='both')return singleExecute(args,exec)
     if(args.includeObservations!==undefined&&typeof args.includeObservations!=='boolean')throw Error('memory-observation-invalid-list-option')
     const root=storeRoot()
-    return managedRead(root,()=>{
+    const result=managedRead(root,()=>{
       const stores=[{scope:'global',available:true,status:statusOf(root)}];let project
       if(!exec?.agent||typeof ctx.workingDirectory?.get!=='function')project={scope:'project',available:false,reason:'no-current-project'}
       else{
@@ -2212,10 +2278,14 @@ function defineStatusTool(ctx, sourceInputs) {
         }catch{project={scope:'project',available:false,reason:'project-status-unavailable'}}
       }
       stores.push(project)
-      const value={scope:'both',stores,capture:captureJobStatus(root)}
-      if(args.includeObservations===true){if(!captureSessionEligible(exec?.agent?.session))throw Error('memory-observation-source-unavailable');value.executionObservations=sourceInputs.availableForExecution(exec)}
-      return value
+      return {scope:'both',stores,capture:captureJobStatus(root)}
     })
+    for(const row of result.stores){
+      if(!row.available)continue
+      row.status.lint=await lintStatus(row.status.dir,row.scope)
+    }
+    if(args.includeObservations===true){if(!captureSessionEligible(exec?.agent?.session))throw Error('memory-observation-source-unavailable');result.executionObservations=sourceInputs.availableForExecution(exec)}
+    return result
   }
   return definition
 }
@@ -2255,7 +2325,7 @@ function defineForgetTool(ctx) {
           text:
             value.removed === 0
               ? `没有匹配到任何索引行：${value.path}`
-              : `已删除 ${value.removed} 条（${value.path}）`,
+              : `已停止使用 ${value.removed} 条索引记忆（${value.path}）。原话、主题正文、会话日志、备份及已发送内容未由此清除；这不是历史数据擦除。`,
         },
       ],
     },
@@ -2430,13 +2500,14 @@ function setupAutoCapture(ctx, config) {
         const captureDirs=[storeRoot(),projectDir].filter(Boolean)
         const memorySnapshot=managedReadMany(captureDirs,()=>{
           const stores=captureDirs.map(dir=>{const scope=dir===storeRoot()?'global':'project',policy=withdrawalPolicy(dir);return{dir,scope,policy,records:effectiveSourceRecords(dir,scope,undefined,true),indexLines:filterWithdrawn(readTextSafe(join(dir,'MEMORY.md'))??'',policy,true).split('\n').map(line=>line.trim()).filter(line=>line.startsWith('- [')).slice(-60)}})
-          const projections=stores.flatMap(store=>store.records.flatMap(record=>{
+          for(const store of stores)store.indexLines=publicMemoryIndex(store.indexLines,store.records)
+          const projections=stores.flatMap(store=>publicMemoryRecords(store.records).flatMap(record=>{
             const line=record.indexLine??indexLine(record.type,record.summary,record.expires,record.detail!==undefined)
             if(!store.indexLines.includes(line))return[]
             const topic=filterWithdrawn(readTextSafe(join(store.dir,record.type+'.md'))??'',store.policy)
             return[captureProjection(record,store.scope,`[${store.scope}] ${line}`,topic)]
           })).slice(-60)
-          return{validationRecords:stores.flatMap(store=>validationCurrentRecords(store.dir,store.scope,store.records)),sourceRecords:stores.flatMap(store=>store.records),structuredRecords:projections,relationTargets:stores.flatMap(store=>store.records.filter(record=>['claim','belief'].includes(record.meaning?.kind)&&!record.meaning.relations?.length).map(record=>({scope:store.scope,recordId:record.id,kind:record.meaning.kind,summary:record.summary}))).slice(-60),revisions:new Map(captureDirs.map(dir=>[dir,{value:storeRevision(dir)}])),indexLines:stores.flatMap(store=>store.indexLines.map(line=>`[${store.scope}] ${line}`))}
+          return{validationRecords:stores.flatMap(store=>validationCurrentRecords(store.dir,store.scope,store.records)),sourceRecords:stores.flatMap(store=>store.records),structuredRecords:projections,relationTargets:stores.flatMap(store=>publicMemoryRecords(store.records).filter(record=>['claim','belief'].includes(record.meaning?.kind)&&!record.meaning.relations?.length).map(record=>({scope:store.scope,recordId:record.id,kind:record.meaning.kind,summary:record.summary}))).slice(-60),revisions:new Map(captureDirs.map(dir=>[dir,{value:storeRevision(dir)}])),indexLines:stores.flatMap(store=>store.indexLines.map(line=>`[${store.scope}] ${line}`))}
         })
         const revisions=memorySnapshot.revisions
         // 按类型分库：跨项目的偏好/纠正进全局库，项目决定进项目库。
@@ -2722,7 +2793,19 @@ function setupAutoCapture(ctx, config) {
     rememberSession(session)
     scheduleRestore(session)
   })
-  ctx.on('session/disposed', session => { observedSessions.delete(session.id); sessions.delete(session.id) })
+  ctx.on('session/disposed', session => {
+    // 短会话在结构上永远到不了 everyTurns；把“没整理”记成可观测事件，而不是静默丢弃。
+    const state = sessions.get(session?.id)
+    if (state && state.turns > 0 && state.turns < options.everyTurns && !state.running) {
+      try {
+        appendAudit(storeRoot(), { op: 'capture', outcome: 'skipped', reason: 'short-session-below-threshold', sessionId: session.id, turns: state.turns, everyTurns: options.everyTurns })
+      } catch {
+        /* 状态卸载路径上的审计是尽力而为，不能阻断 */
+      }
+    }
+    observedSessions.delete(session.id)
+    sessions.delete(session.id)
+  })
 
   queryService = watchOptionalService(ctx, 'sessionQuery', state => {
     const available = typeof state.value?.observeSession === 'function'
@@ -2798,12 +2881,18 @@ export function apply(ctx, config = {}) {
     }
   }
 
+  const history = setupMemoryHistory(ctx, renderForRuntime)
+  // The host waits for apply(): no contexts, tools or success marker are
+  // published until an asynchronous projection registration has succeeded.
+  return typeof history?.then === 'function' ? history.then(activate) : activate(history)
+
+  function activate(memoryHistory) {
+  if (ctx.fiber?.uid === null) return
   let calls = 0
-  const memoryHistory = setupMemoryHistory(ctx, renderForRuntime)
 
   ctx.systemPrompt.context({
     name: 'memory:protocol', order: CONTEXT_ORDER - 1, required: true,
-    interpolate: false, text: context => memoryProtocol(ctx, context),
+    interpolate: false, text: context => memoryProtocol(ctx, context)+'\n'+PRIVATE_MEMORY_NOTICE,
   })
 
   ctx.systemPrompt.context({
@@ -2904,6 +2993,7 @@ export function apply(ctx, config = {}) {
   } catch {
     /* 写不出来就算了：注入不依赖这两个文件 */
   }
+  }
 }
 
 installManagedMemoryInternals({indexLine,clearCache:()=>cache.clear(),storeRevision:storeRevisionLocal,withdrawManagedSourceKey:withdrawManagedSourceKeyLocal,recoverMemoryPublication:recoverMemoryPublicationLocal})

package/managed-policy.mjs

@@ -68,7 +68,9 @@ function openDb(paths,{write=false,requireExisting=false}={}){
  }
  const before=lstatSync(path);let db
  try{
-  db=new DatabaseSync(path,{readOnly:!write});db.exec('PRAGMA trusted_schema=OFF; PRAGMA busy_timeout=0;')
+  // Managed reads share the writer lock. Let brief contention clear without
+  // releasing transaction ownership or waiting indefinitely.
+  db=new DatabaseSync(path,{readOnly:!write});db.exec('PRAGMA trusted_schema=OFF; PRAGMA busy_timeout=750;')
   const now=lstatSync(path);if(now.isSymbolicLink()||now.ino!==before.ino||now.dev!==before.dev)fail('changed-database-file')
   if(created){db.exec('BEGIN IMMEDIATE; '+SCHEMA+'; PRAGMA application_id='+APPLICATION_ID+'; PRAGMA user_version=1; COMMIT;')}
   schema(db)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solopup-memory",
-  "version": "0.21.0-beta.2",
+  "version": "0.22.0-beta.3",
   "description": "SoloPup Memory — source-linked, layered text memory for DeepSeek Harness. Public beta.",
   "type": "module",
   "main": "index.mjs",
@@ -25,129 +25,145 @@
     "CHANGELOG.md",
     "scripts/",
     "COMPATIBILITY.md",
-    "test.mjs",
-    "test-security.mjs",
-    "test-adversarial.mjs",
-    "test-concurrency.mjs",
-    "test-supersede.mjs",
-    "test-history.mjs",
-    "test-smell.mjs",
-    "test-links.mjs",
-    "test-packaging.mjs",
-    "test-patch.mjs",
-    "test-compat.mjs",
+    "test/test.mjs",
+    "test/test-security.mjs",
+    "test/test-adversarial.mjs",
+    "test/test-concurrency.mjs",
+    "test/test-supersede.mjs",
+    "test/test-history.mjs",
+    "test/test-smell.mjs",
+    "test/test-links.mjs",
+    "test/test-packaging.mjs",
+    "test/test-patch.mjs",
+    "test/test-compat.mjs",
     "accept.mjs",
     "worker-write.mjs",
-    "test-conflict.mjs",
-    "test-usability.mjs",
-    "test-compaction-compat.mjs",
-    "test-schema.mjs",
+    "test/test-conflict.mjs",
+    "test/test-usability.mjs",
+    "test/test-compaction-compat.mjs",
+    "test/test-schema.mjs",
     "scripts/probe-load.mjs",
     "capture.mjs",
     "capture-llm.mjs",
     "capture-evidence.mjs",
     "capture-revision.mjs",
-    "test-capture-revision.mjs",
-    "test-capture.mjs",
-    "test-paired-analysis.mjs",
+    "test/test-capture-revision.mjs",
+    "test/test-capture.mjs",
+    "test/test-paired-analysis.mjs",
     "retrieval.mjs",
-    "test-retrieval.mjs",
+    "test/test-retrieval.mjs",
     "candidates.mjs",
-    "test-candidates.mjs",
+    "test/test-candidates.mjs",
     "publication.mjs",
-    "test-publication.mjs",
+    "test/test-publication.mjs",
     "withdrawal.mjs",
-    "test-withdrawal.mjs",
+    "test/test-withdrawal.mjs",
     "capture-jobs.mjs",
-    "test-capture-jobs.mjs",
+    "test/test-capture-jobs.mjs",
     "context-history.mjs",
-    "test-context-history.mjs",
+    "test/test-context-history.mjs",
     "capture-inputs.mjs",
-    "test-capture-inputs.mjs",
-    "test-inline-summary.mjs",
+    "test/test-capture-inputs.mjs",
+    "test/test-inline-summary.mjs",
     "managed-logs.mjs",
-    "test-withdrawal-archives.mjs",
+    "test/test-withdrawal-archives.mjs",
     "cordis.patch.yml",
     "plugin-config.mjs",
     "host-services.mjs",
-    "test-plugin-contract.mjs",
+    "test/test-plugin-contract.mjs",
     "project-stores.mjs",
-    "test-project-stores.mjs",
+    "test/test-project-stores.mjs",
     "service-readiness.mjs",
-    "test-service-readiness.mjs",
+    "test/test-service-readiness.mjs",
     "tool-inputs.mjs",
     "fixture-host.mjs",
-    "test-source-key.mjs",
-    "test-tool-inputs.mjs",
-    "test-tool-write-lifecycle.mjs",
-    "test-tool-write-guard.mjs",
+    "test/test-source-key.mjs",
+    "test/test-tool-inputs.mjs",
+    "test/test-tool-write-lifecycle.mjs",
+    "test/test-tool-write-guard.mjs",
     "source-retirement.mjs",
-    "test-source-retirement.mjs",
+    "test/test-source-retirement.mjs",
     "managed-policy.mjs",
     "managed-hooks.mjs",
     "managed-access.mjs",
     "store-lock-guard.mjs",
-    "test-managed-access.mjs",
+    "test/test-managed-access.mjs",
     "managed-activation.mjs",
-    "test-managed-activation.mjs",
+    "test/test-managed-activation.mjs",
     "runtime-startup.mjs",
-    "test-runtime-startup.mjs",
+    "test/test-runtime-startup.mjs",
     "meaning.mjs",
-    "test-meaning.mjs",
+    "test/test-meaning.mjs",
     "episodes.mjs",
     "source-record.mjs",
-    "test-episodes.mjs",
+    "test/test-episodes.mjs",
     "belief-revision.mjs",
-    "test-belief-revision.mjs",
+    "test/test-belief-revision.mjs",
     "tool-observations.mjs",
-    "test-tool-observations.mjs",
+    "test/test-tool-observations.mjs",
     "capture-diagnostics.mjs",
-    "test-capture-diagnostics.mjs",
+    "test/test-capture-diagnostics.mjs",
     "snapshots.mjs",
-    "test-snapshots.mjs",
+    "test/test-snapshots.mjs",
     "restore.mjs",
     "restoration-lock.mjs",
-    "test-restore.mjs",
-    "test-status-both.mjs",
-    "test-text-admission.mjs",
+    "test/test-restore.mjs",
+    "test/test-status-both.mjs",
+    "test/test-text-admission.mjs",
     "memory-policy.mjs",
     "capture-submission.mjs",
-    "test-capture-submission.mjs",
+    "test/test-capture-submission.mjs",
     "capture-projections.mjs",
-    "test-capture-projections.mjs",
+    "test/test-capture-projections.mjs",
     "capture-validation-contract.mjs",
     "capture-validation.mjs",
-    "test-capture-validation.mjs",
+    "test/test-capture-validation.mjs",
     "capture-validation-job.mjs",
-    "test-capture-validation-job.mjs",
-    "test-capture-validation-flow.mjs",
-    "test-capture-validation-lineage.mjs",
+    "test/test-capture-validation-job.mjs",
+    "test/test-capture-validation-flow.mjs",
+    "test/test-capture-validation-lineage.mjs",
     "native-write-validation.mjs",
-    "test-native-write-validation.mjs",
-    "test-native-service-lifecycle.mjs",
+    "test/test-native-write-validation.mjs",
+    "test/test-native-service-lifecycle.mjs",
     "field-lineage.mjs",
-    "test-field-lineage.mjs",
-    "test-capture-field-lineage.mjs",
+    "test/test-field-lineage.mjs",
+    "test/test-capture-field-lineage.mjs",
     "validation-transition-context.mjs",
-    "test-validation-transition-context.mjs",
+    "test/test-validation-transition-context.mjs",
     "memory-scope-policy.mjs",
     "control-schema.mjs",
-    "test-control-schema.mjs",
+    "test/test-control-schema.mjs",
     "revision-admission.mjs",
-    "test-revision-admission.mjs",
+    "test/test-revision-admission.mjs",
     "memory-rule-policy.mjs",
-    "test-rule-admission.mjs",
-    "test-validation-source-refs.mjs",
-    "test-source-completeness.mjs",
+    "test/test-rule-admission.mjs",
+    "test/test-validation-source-refs.mjs",
+    "test/test-source-completeness.mjs",
     "source-identity.mjs",
-    "test-legacy-source-identity.mjs",
+    "test/test-legacy-source-identity.mjs",
     "icon.svg",
     "locale/",
     "README.en.md",
     "RELEASE.md",
     "memory-protocol.mjs",
     "capture-source-aliases.mjs",
-    "test-explicit-memory.mjs"
+    "test/test-explicit-memory.mjs",
+    "privacy.mjs",
+    "test/test-privacy.mjs",
+    "detect.mjs",
+    "scripts/detect.mjs",
+    "scripts/telemetry.mjs",
+    "scripts/dream.mjs",
+    "eval/semantic-suite.mjs",
+    "eval/semantic/cases.json",
+    "eval/bench-detect.mjs",
+    "test/test-detect.mjs",
+    "test/test-telemetry.mjs",
+    "test/test-semantic-suite.mjs",
+    "test/test-dream-plan.mjs",
+    "DETECTION.md",
+    "DREAMING-DESIGN.md",
+    "test/test-dsh-registration.mjs"
   ],
   "engines": {
     "node": ">=24.9",
@@ -160,7 +176,7 @@
   },
   "license": "MIT",
   "scripts": {
-    "test": "node --test --test-concurrency=4 test.mjs test-security.mjs test-adversarial.mjs test-concurrency.mjs test-supersede.mjs test-history.mjs test-smell.mjs test-links.mjs test-packaging.mjs test-patch.mjs test-compat.mjs test-conflict.mjs test-usability.mjs test-compaction-compat.mjs test-schema.mjs test-capture.mjs test-paired-analysis.mjs test-retrieval.mjs test-candidates.mjs test-publication.mjs test-withdrawal.mjs test-capture-jobs.mjs test-context-history.mjs test-capture-inputs.mjs test-inline-summary.mjs test-withdrawal-archives.mjs test-plugin-contract.mjs test-project-stores.mjs test-service-readiness.mjs test-source-key.mjs test-tool-inputs.mjs test-tool-write-lifecycle.mjs test-tool-write-guard.mjs test-source-retirement.mjs test-managed-access.mjs test-managed-activation.mjs test-runtime-startup.mjs test-capture-revision.mjs test-meaning.mjs test-episodes.mjs test-belief-revision.mjs test-tool-observations.mjs test-capture-diagnostics.mjs test-snapshots.mjs test-restore.mjs test-status-both.mjs test-text-admission.mjs test-capture-submission.mjs test-capture-projections.mjs test-capture-validation.mjs test-capture-validation-job.mjs test-capture-validation-flow.mjs test-capture-validation-lineage.mjs test-native-write-validation.mjs test-native-service-lifecycle.mjs test-field-lineage.mjs test-capture-field-lineage.mjs test-validation-transition-context.mjs test-control-schema.mjs test-revision-admission.mjs test-rule-admission.mjs test-validation-source-refs.mjs test-source-completeness.mjs test-legacy-source-identity.mjs test-explicit-memory.mjs",
+    "test": "node --test --test-concurrency=4 test/test.mjs test/test-security.mjs test/test-adversarial.mjs test/test-concurrency.mjs test/test-supersede.mjs test/test-history.mjs test/test-smell.mjs test/test-links.mjs test/test-packaging.mjs test/test-patch.mjs test/test-compat.mjs test/test-conflict.mjs test/test-usability.mjs test/test-compaction-compat.mjs test/test-schema.mjs test/test-capture.mjs test/test-paired-analysis.mjs test/test-retrieval.mjs test/test-candidates.mjs test/test-publication.mjs test/test-withdrawal.mjs test/test-capture-jobs.mjs test/test-context-history.mjs test/test-capture-inputs.mjs test/test-inline-summary.mjs test/test-withdrawal-archives.mjs test/test-plugin-contract.mjs test/test-project-stores.mjs test/test-service-readiness.mjs test/test-source-key.mjs test/test-tool-inputs.mjs test/test-tool-write-lifecycle.mjs test/test-tool-write-guard.mjs test/test-source-retirement.mjs test/test-managed-access.mjs test/test-managed-activation.mjs test/test-runtime-startup.mjs test/test-capture-revision.mjs test/test-meaning.mjs test/test-episodes.mjs test/test-belief-revision.mjs test/test-tool-observations.mjs test/test-capture-diagnostics.mjs test/test-snapshots.mjs test/test-restore.mjs test/test-status-both.mjs test/test-text-admission.mjs test/test-capture-submission.mjs test/test-capture-projections.mjs test/test-capture-validation.mjs test/test-capture-validation-job.mjs test/test-capture-validation-flow.mjs test/test-capture-validation-lineage.mjs test/test-native-write-validation.mjs test/test-native-service-lifecycle.mjs test/test-field-lineage.mjs test/test-capture-field-lineage.mjs test/test-validation-transition-context.mjs test/test-control-schema.mjs test/test-revision-admission.mjs test/test-rule-admission.mjs test/test-validation-source-refs.mjs test/test-source-completeness.mjs test/test-legacy-source-identity.mjs test/test-explicit-memory.mjs test/test-privacy.mjs test/test-detect.mjs test/test-telemetry.mjs test/test-semantic-suite.mjs test/test-dream-plan.mjs test/test-dsh-registration.mjs",
     "eval": "node eval/run-eval.mjs",
     "gate": "node eval/run-eval.mjs --check",
     "verify": "node scripts/verify.mjs",
@@ -170,7 +186,14 @@
     "probe:package": "node scripts/probe-package.mjs",
     "projects": "node scripts/projects.mjs",
     "control": "node scripts/control.mjs",
-    "backup": "node scripts/backup.mjs"
+    "backup": "node scripts/backup.mjs",
+    "detect": "node scripts/detect.mjs",
+    "telemetry": "node scripts/telemetry.mjs",
+    "dream": "node scripts/dream.mjs",
+    "semantic": "node eval/semantic-suite.mjs --verbose",
+    "security": "node scripts/security-check.mjs",
+    "soak": "node scripts/soak.mjs",
+    "probe:history": "node scripts/probe-history.mjs"
   },
   "dshMemoryRestoreProtocol": 1,
   "dshMemoryDataSchemas": {