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

package/index.mjs

@@ -890,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)
@@ -1224,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` 只查索引）。
  * 检索是确定性的：归一化后做子串匹配，不做正则、不做模糊。
  *
@@ -2151,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'] } } },
@@ -2177,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?'（列表有省略，优先核对最近结果）':''):'') ,
           },
         ]
@@ -2186,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
@@ -2213,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{
@@ -2229,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
 }
@@ -2740,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'
@@ -2816,8 +2881,14 @@ 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,
@@ -2922,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.3",
+  "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,131 +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-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",
@@ -162,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-privacy.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",
@@ -172,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": {

package/scripts/demo-source-recall.mjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+/**
+ * Offline, synthetic mechanics demonstration. Production tool handlers run in a
+ * scripted host, with a scripted validation response, NOT DSH or a real model.
+ * Each phase uses a separate Node process; no old conversation is replayed.
+ * Run without arguments for six output lines, or --json for the full receipt.
+ */
+import assert from 'node:assert/strict'
+import { spawnSync } from 'node:child_process'
+import { createHash } from 'node:crypto'
+import { mkdirSync, mkdtempSync, readFileSync, realpathSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { basename, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { apply } from '../index.mjs'
+import { scriptedNativeValidationLlm } from '../fixture-host.mjs'
+import { VERSION } from '../version.mjs'
+import { probeEnvironment } from './probe-env.mjs'
+
+const script = fileURLToPath(import.meta.url)
+const quote = '记住：本项目的交付说明统一用中文。'
+const summary = '本项目的交付说明统一用中文'
+const query = '交付说明'
+const sourceSession = 'synthetic-demo-write'
+
+async function phase(name, root) {
+  // The internal phase runner refuses a non-demo home, including a user's home.
+  assert.equal(realpathSync(tmpdir()), join(realpathSync(root), 'tmp'))
+  assert.match(basename(root), /^solopup-readme-demo-/)
+  assert.equal(process.env.DSH_HOME, join(root, 'home'))
+  assert.ok(['write', 'recall', 'other-project'].includes(name))
+  const handlers = [], tools = [], disposers = []
+  const session = { id: name === 'write' ? sourceSession : `synthetic-demo-${name}` }
+  const agent = { session, options: { provider: 'scripted-demo', model: 'scripted-demo' } }
+  let validationCalls = 0
+  const scripted = scriptedNativeValidationLlm()
+  const ctx = {
+    llm: { async prepareCall(config) { validationCalls++; return scripted.prepareCall(config) } },
+    systemPrompt: { context() {} },
+    workingDirectory: { get: () => join(root, name === 'other-project' ? 'project-b' : 'project-a') },
+    tools: { register: tool => tools.push(tool) },
+    on: (event, handler) => handlers.push([event, handler]),
+    effect: fn => { const dispose = fn(); if (typeof dispose === 'function') disposers.push(dispose) },
+  }
+  const emit = (event, ...args) => {
+    for (const [registered, handler] of handlers) if (registered === event) handler(...args)
+  }
+  apply(ctx, { autoCapture: { enabled: false, timeoutMs: 2000 } })
+  try {
+    if (name === 'write') {
+      const message = { id: 'synthetic-owner-message', role: 'user', source: { kind: 'user' }, content: [{ type: 'text', text: quote }] }
+      emit('agent/pre-step', { agent, turn: 1, step: 1, messages: [message] }, () => {})
+      emit('session/event', session, { type: 'user/message', seq: 1, data: message })
+      const args = { type: 'project', scope: 'project', summary, meaning: { kind: 'decision' } }
+      const callId = 'synthetic-demo-write-call'
+      emit('session/event', session, { type: 'tool/call', seq: 2, data: { callId, name: 'memory_write', arguments: JSON.stringify(args), turn: 1, step: 1 } })
+      const result = await tools.find(t => t.name === 'memory_write').execute(args, { agent, callId })
+      assert.equal(result.status, 'recorded')
+      assert.equal(validationCalls, 1)
+      return { sessionId: session.id, ownerMessage: quote, args, result, scriptedValidationCalls: validationCalls }
+    }
+    // No user-message events or old history are provided to these new processes.
+    const search = tools.find(t => t.name === 'memory_search')
+    const args = { query, mode: 'exact' }
+    const current = await search.execute(args, { agent })
+    const history = await search.execute({ ...args, view: 'history' }, { agent })
+    assert.equal(validationCalls, 0)
+    if (name === 'recall') {
+      assert.equal(current.hits.length, 1)
+      assert.equal(current.hits[0].scope, 'project')
+      assert.ok(current.hits[0].text.includes(summary))
+      assert.equal(history.hits.length, 1)
+      assert.equal(history.hits[0].history.sourceSessionId, sourceSession)
+      assert.deepEqual(history.hits[0].history.sourceMessageIds, [`${sourceSession}:1`])
+      assert.ok(history.hits[0].text.includes(quote))
+    } else {
+      assert.equal(current.hits.length, 0)
+      assert.equal(history.hits.length, 0)
+    }
+    return { sessionId: session.id, inheritedMessages: 0, args, current, history, scriptedValidationCalls: validationCalls }
+  } finally {
+    for (const dispose of disposers) dispose()
+  }
+}
+
+if (process.argv[2] === '--phase' && process.argv.length === 5) {
+  console.log(JSON.stringify(await phase(process.argv[3], process.argv[4])))
+} else {
+  assert.ok(process.argv.length === 2 || process.argv.length === 3 && process.argv[2] === '--json', 'usage: node scripts/demo-source-recall.mjs [--json]')
+  const root = realpathSync(mkdtempSync(join(tmpdir(), 'solopup-readme-demo-')))
+  const env = probeEnvironment(root)
+  for (const dir of [env.HOME, env.TMPDIR, join(root, 'project-a'), join(root, 'project-b')]) mkdirSync(dir)
+  for (const project of ['project-a', 'project-b']) writeFileSync(join(root, project, '.dsh-root'), '')
+  try {
+    const phases = {}
+    for (const name of ['write', 'recall', 'other-project']) {
+      const child = spawnSync(process.execPath, [script, '--phase', name, root], { env, encoding: 'utf8', timeout: 30000 })
+      assert.equal(child.status, 0, `demo ${name} failed: ${child.stderr}`)
+      phases[name] = JSON.parse(child.stdout)
+    }
+    const lines = [
+      `synthetic user: ${quote}`,
+      `memory_write: ${phases.write.result.status} (scope=project, meaning=decision)`,
+      `fresh process / memory_search("${query}"): ${phases.recall.current.hits.length} hit (scope=${phases.recall.current.hits[0].scope})`,
+      `current text: ${phases.recall.current.hits[0].text}`,
+      `history source: ${phases.recall.history.hits[0].history.sourceMessageIds.join(', ')}; quote: ${quote}`,
+      `other project / current + history: ${phases['other-project'].current.hits.length} + ${phases['other-project'].history.hits.length} hits`,
+    ]
+    const report = {
+      kind: 'synthetic-scripted-host-mechanics',
+      at: new Date().toISOString(), version: VERSION,
+      scriptSha256: createHash('sha256').update(readFileSync(script)).digest('hex'),
+      environment: { platform: process.platform, arch: process.arch, node: process.version },
+      realDshHost: false, realModel: false, networkRequests: 0,
+      isolatedTemporaryHome: true, separateProcesses: 3,
+      limitations: 'Scripted validator approves this synthetic candidate. This verifies persistence, source return and project filtering only, not model judgment, real DSH schema registration, or natural fresh-chat recall.',
+      lines, phases,
+    }
+    console.log(process.argv[2] === '--json' ? JSON.stringify(report, null, 2) : lines.join('\n'))
+  } finally {
+    rmSync(root, { recursive: true, force: true })
+  }
+}

package/scripts/detect.mjs

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * 记忆层检测 CLI（L0 不变量层）。只读，不调用模型。
+ *
+ *   node scripts/detect.mjs                 # 检查 ~/.dsh/memory
+ *   node scripts/detect.mjs --root DIR      # 指定记忆根
+ *   node scripts/detect.mjs --json          # 机器可读
+ *   node scripts/detect.mjs --check         # 有 error 则退出码 1（CI 门禁）
+ *   node scripts/detect.mjs --verbose       # 连 info 一起打印
+ */
+
+import { homedir } from 'node:os'
+import { existsSync } from 'node:fs'
+import { join, resolve } from 'node:path'
+
+import { detectRoot } from '../detect.mjs'
+
+const argv = process.argv.slice(2)
+const flag = (name) => argv.includes(name)
+const option = (name) => {
+  const at = argv.indexOf(name)
+  return at >= 0 ? argv[at + 1] : undefined
+}
+
+const root = resolve(option('--root') ?? join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'memory'))
+if (!existsSync(root)) {
+  console.error(`[detect] 记忆根不存在：${root}`)
+  process.exit(2)
+}
+
+const report = detectRoot(root)
+if (flag('--json')) {
+  process.stdout.write(JSON.stringify(report, null, 2) + '\n')
+} else {
+  const lines = []
+  lines.push(`SoloPup 记忆检测 v${report.version} · ${report.generatedAt}`)
+  lines.push(`根目录：${report.root}`)
+  lines.push(`总计：error ${report.summary.errors} · warning ${report.summary.warnings} · info ${report.summary.infos}`)
+  for (const store of report.stores) {
+    const label = store.scope === 'global' ? 'global' : 'project'
+    const metrics = store.metrics
+    lines.push('')
+    lines.push(`== ${label}：${store.dir}`)
+    if (metrics) {
+      lines.push(
+        `   索引 ${metrics.indexLines}/${metrics.limitLines} 行、${metrics.indexBytes}/${metrics.limitBytes} 字节；` +
+          `有效记录 ${metrics.activeRecords}、待审 ${metrics.pendingRecords}、过期行 ${metrics.expiredIndexLines}；` +
+          `库占用 ${(metrics.storeBytes / 1024).toFixed(1)}K/${metrics.storeLimitBytes / 1024}K`,
+      )
+    }
+    if (store.findings.length === 0) {
+      lines.push('   [ok] 未发现问题（“未发现”不等于“没有问题”，语义质量见 L2）')
+      continue
+    }
+    for (const finding of store.findings) {
+      if (finding.severity === 'info' && !flag('--verbose')) continue
+      const refs = (finding.refs ?? []).map((item) => (item.line === undefined ? item.file : `${item.file}:${item.line}`)).join(' ')
+      lines.push(`   [${finding.severity}] ${finding.id} ${finding.message}${refs ? ` (${refs})` : ''}`)
+      if (finding.fixHint && flag('--verbose')) lines.push(`          修复：${finding.fixHint}`)
+    }
+  }
+  for (const finding of report.crossFindings) {
+    if (finding.severity === 'info' && !flag('--verbose')) continue
+    lines.push(`   [${finding.severity}] ${finding.id} ${finding.message}`)
+  }
+  process.stdout.write(lines.join('\n') + '\n')
+}
+
+if (flag('--check') && report.summary.errors > 0) process.exit(1)