@furongjun1999/dsh-memory 0.9.22 → 0.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (179) hide show
  1. package/CHANGELOG.en.md +450 -0
  2. package/CHANGELOG.md +112 -0
  3. package/README.en.md +244 -0
  4. package/README.md +272 -260
  5. package/codebuddy/CODEBUDDY.md +1 -1
  6. package/docs/README.md +2 -0
  7. package/docs/discipline/templates/full.md.tmpl +1 -1
  8. package/docs/discipline/templates/rules.mdc.tmpl +1 -1
  9. package/docs/en/README.md +190 -0
  10. package/docs/en/TRANSLATION.md +78 -0
  11. package/docs/en/TRANSLATION_MANIFEST.json +170 -0
  12. package/docs/en/TRANSLATION_REPORT.md +11 -0
  13. package/docs/en/dev/README.md +10 -0
  14. package/docs/en/dev/coding-testing.md +72 -0
  15. package/docs/en/dev/switch-matrix.md +10 -0
  16. package/docs/en/glossary.md +97 -0
  17. package/docs/en/harnesses/claude.md +100 -0
  18. package/docs/en/harnesses/codebuddy.md +93 -0
  19. package/docs/en/harnesses/codex.md +88 -0
  20. package/docs/en/harnesses/dsh.md +84 -0
  21. package/docs/en/harnesses/zcode.md +42 -0
  22. package/docs/en/mdcg/ccg.md +32 -0
  23. package/docs/en/mdcg/generated-docs.md +20 -0
  24. package/docs/en/mdcg/guardrail-charter.md +170 -0
  25. package/docs/en/mdcg/mcp-tool-names.md +43 -0
  26. package/docs/en/mdcg/multi-harness.md +43 -0
  27. package/docs/en/mdcg/recall-metadata.md +30 -0
  28. package/docs/en/mdcg/world-model-endpoint.md +379 -0
  29. package/docs/en/mdcg/write-aliases.md +130 -0
  30. package/docs/en/ops/README.md +11 -0
  31. package/docs/en/ops/environment-known-issues.md +244 -0
  32. package/docs/en/ops/install.md +72 -0
  33. package/docs/en/ops/operations-troubleshooting.md +86 -0
  34. package/docs/en/ops/permissions-review.md +79 -0
  35. package/docs/en/ops/release-governance.md +49 -0
  36. package/docs/en/ops/tool-name-migration.md +30 -0
  37. package/docs/en/ops/ui-install-troubleshooting.md +53 -0
  38. package/docs/en/standards/ai-coding-standard-checklist.md +71 -0
  39. package/docs/en/standards/ai-coding-standard-lingshu.md +47 -0
  40. package/docs/en/standards/ai-coding-standard.md +185 -0
  41. package/docs/en/ui/minimal.md +62 -0
  42. package/docs/mdcg/cogmap_ops.md +16 -15
  43. package/lib/client.js +29 -3
  44. package/lib/hooks.d.ts +34 -0
  45. package/lib/hooks.js +167 -33
  46. package/lib/index.js +19 -3
  47. package/lib/lib/console_web.mjs +30 -3
  48. package/lib/lib/hook_audit.d.ts +3 -2
  49. package/lib/lib/hook_audit.js +14 -4
  50. package/lib/lib/mdcg_client.d.ts +5 -2
  51. package/lib/lib/mdcg_client.js +8 -4
  52. package/lib/lib/prompt_safety.d.ts +24 -0
  53. package/lib/lib/prompt_safety.js +77 -1
  54. package/lib/lib/token_store.js +5 -2
  55. package/lib/tools.js +5 -3
  56. package/md_cg/bucketindex.py +231 -0
  57. package/md_cg/bucketscope.py +339 -0
  58. package/md_cg/config_registry_bulk.py +19 -10
  59. package/md_cg/config_validate.py +14 -2
  60. package/md_cg/detrerank.py +137 -0
  61. package/md_cg/fsutil.py +215 -25
  62. package/md_cg/govern/__init__.py +23 -0
  63. package/md_cg/iface/__init__.py +46 -0
  64. package/md_cg/iface/_verify.py +609 -0
  65. package/md_cg/iface/contracts.py +337 -0
  66. package/md_cg/judgment_manifest.py +14 -0
  67. package/md_cg/kernel/__init__.py +27 -0
  68. package/md_cg/mcp_server.py +457 -23
  69. package/md_cg/mdcg.py +1034 -79
  70. package/md_cg/mdcos.py +263 -21
  71. package/md_cg/metacognition.py +66 -13
  72. package/md_cg/mutate_extract_shipped.py +126 -0
  73. package/md_cg/mutate_ledger_e2e.py +100 -0
  74. package/md_cg/nodefile.py +147 -23
  75. package/md_cg/op_table.py +22 -4
  76. package/md_cg/probe_c_ledger_integrity.py +258 -0
  77. package/md_cg/probe_d_retirement_discipline.py +263 -0
  78. package/md_cg/reconcile.py +9 -11
  79. package/md_cg/review_cli.py +6 -1
  80. package/md_cg/rollback.py +16 -1
  81. package/md_cg/run_tests.py +30 -1
  82. package/md_cg/scopeselect.py +214 -0
  83. package/md_cg/scrub.py +160 -23
  84. package/md_cg/security.py +4 -2
  85. package/md_cg/state_extract.py +149 -0
  86. package/md_cg/state_slots.py +58 -10
  87. package/md_cg/structboost.py +179 -0
  88. package/md_cg/test_alternatives_historical.py +162 -0
  89. package/md_cg/test_b2_sensitivity_landing.py +226 -223
  90. package/md_cg/test_b3_merge_keeps_content.py +608 -583
  91. package/md_cg/test_bucket_cards.py +85 -0
  92. package/md_cg/test_bucket_day_order.py +74 -0
  93. package/md_cg/test_bucket_quota.py +79 -0
  94. package/md_cg/test_bucket_recency_guards.py +75 -0
  95. package/md_cg/test_bucket_three_causes.py +83 -0
  96. package/md_cg/test_bucketindex.py +130 -0
  97. package/md_cg/test_bucketscope_early.py +71 -0
  98. package/md_cg/test_cond_term_fold.py +183 -0
  99. package/md_cg/test_cond_term_fold_gate.py +1210 -0
  100. package/md_cg/test_cond_term_neg_scope.py +147 -0
  101. package/md_cg/test_cond_terms_colon.py +348 -0
  102. package/md_cg/test_detrerank.py +157 -0
  103. package/md_cg/test_gate_four_kpi.py +136 -0
  104. package/md_cg/test_generation_guard.py +76 -43
  105. package/md_cg/test_issue192_move_layer_indices_guard.py +48 -0
  106. package/md_cg/test_issue362_neg_condition.py +44 -7
  107. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  108. package/md_cg/test_issue413_preimage_failclosed.py +147 -9
  109. package/md_cg/test_issue444_scrub_evidence_plaintext.py +14 -8
  110. package/md_cg/test_issue677_flush_batch_io.py +139 -0
  111. package/md_cg/test_issue677_info_fast.py +82 -0
  112. package/md_cg/test_issue677_remember_dedupe.py +106 -0
  113. package/md_cg/test_issue712_tokens_sessions_read.py +199 -0
  114. package/md_cg/test_issue722_strict_conditions.py +96 -0
  115. package/md_cg/test_issue730_narrowing_audit.py +121 -0
  116. package/md_cg/test_issue733_verify_override.py +193 -0
  117. package/md_cg/test_issue733_verify_override_and_overwrite_inherit.py +315 -0
  118. package/md_cg/test_issue740_filelock_fd_leak.py +218 -0
  119. package/md_cg/test_issue741_content_hash_same_source.py +158 -0
  120. package/md_cg/test_issue747_slot_contradiction.py +125 -0
  121. package/md_cg/test_issue754_nested_root_guard.py +197 -0
  122. package/md_cg/test_issue757_index_hash_compare.py +85 -0
  123. package/md_cg/test_issue758_disk_hash_single.py +67 -0
  124. package/md_cg/test_issue759_twophase_hash.py +67 -0
  125. package/md_cg/test_issue768_overwrite_time_window_anchor.py +135 -0
  126. package/md_cg/test_issue789_log_plaintext_probe.py +100 -0
  127. package/md_cg/test_issue790_verb_negation.py +77 -0
  128. package/md_cg/test_issue810_root_guard.py +71 -0
  129. package/md_cg/test_issue812_info_index_stale.py +78 -0
  130. package/md_cg/test_issue827_weaken_dedup.py +361 -0
  131. package/md_cg/test_issue829_calibration_positive_gate.py +473 -0
  132. package/md_cg/test_kernel_iface_contracts.py +18 -0
  133. package/md_cg/test_md_cg_no_hive_dep.py +238 -17
  134. package/md_cg/test_n204_n205_n226_n227_n228_n229_exit_gates.py +545 -542
  135. package/md_cg/test_n209_verify_write_face_gates.py +5 -2
  136. package/md_cg/test_neg_condition_hits.py +336 -333
  137. package/md_cg/test_probe_cd_shipped.py +385 -0
  138. package/md_cg/test_recent_tail.py +93 -0
  139. package/md_cg/test_run_tests_entry_gates.py +110 -0
  140. package/md_cg/test_scopeselect.py +70 -0
  141. package/md_cg/test_scopeselect_clock.py +70 -0
  142. package/md_cg/test_scrub_source_line_false_positive.py +64 -0
  143. package/md_cg/test_session_attribution_consistency.py +835 -813
  144. package/md_cg/test_state_extract_shipped.py +162 -0
  145. package/md_cg/test_state_ledger_chain.py +207 -0
  146. package/md_cg/test_state_ledger_e2e.py +145 -0
  147. package/md_cg/test_structboost.py +102 -0
  148. package/md_cg/test_timeboost.py +83 -0
  149. package/md_cg/test_timeboost_relativedate.py +71 -0
  150. package/md_cg/test_topicagg.py +129 -0
  151. package/md_cg/test_twophase.py +286 -286
  152. package/md_cg/timeboost.py +223 -0
  153. package/md_cg/tokens.py +55 -7
  154. package/md_cg/topicagg.py +142 -0
  155. package/md_cg/twophase.py +15 -6
  156. package/md_cg/whitebox_kb/wisdom/code_compose.py +33 -5
  157. package/md_cg/whitebox_kb/wisdom/compose_engine.py +5 -1
  158. package/md_cg/whitebox_kb/wisdom/role_compose.py +271 -268
  159. package/md_cg/writepipe.py +35 -3
  160. package/package.json +4 -1
  161. package/scripts/workspace_index.py +2 -0
  162. package/src/hooks.ts +182 -34
  163. package/src/index.ts +19 -3
  164. package/src/lib/console_web.mjs +30 -3
  165. package/src/lib/hook_audit.ts +15 -5
  166. package/src/lib/mdcg_client.ts +8 -4
  167. package/src/lib/prompt_safety.ts +73 -1
  168. package/src/lib/token_store.ts +5 -2
  169. package/src/tools.ts +5 -3
  170. package/ui/minimal/integrity.json +2 -2
  171. package/ui/minimal/payload/build-ui.mjs +41 -2
  172. package/ui/minimal/payload/lib/client.js +29 -3
  173. package/ui/minimal/payload/lib/lib/console_web.mjs +30 -3
  174. package/ui/minimal/payload/src/lib/console_web.mjs +30 -3
  175. package/ui/minimal/payload/web/app.js +3 -1
  176. package/ui/minimal/payload/web/client.js +30 -3
  177. package/web/app.js +3 -1
  178. package/web/client.js +30 -3
  179. package/zcode/AGENTS.md +1 -1
@@ -1,9 +1,36 @@
1
1
  const React = require('react');
2
+ const PANEL_HTML = __PANEL_HTML__; // build-ui.mjs 打包时内联(index.html + style.css + 桥 + app.js)
2
3
  function Icon({size=16}) {
3
- return React.createElement('svg', {width:size,height:size,viewBox:'0 0 24 24',fill:'none',stroke:'currentColor',strokeWidth:1.5,'aria-hidden':true}, React.createElement('path',{d:'M7 4h10v16H7z M10 8h4 M10 12h4 M10 16h2'}));
4
+ return React.createElement('svg', {width:size,height:size,viewBox:'0 0 24 24',fill:'none',stroke:'currentColor',strokeWidth:1.5,'aria-hidden':true}, React.createElement('path',{d:'M12 3v18M5 7l14 10M19 7L5 17'}));
5
+ }
6
+ // issue #791:桌面版(dsh-app://)下 iframe 子 frame 拿不到 x-dsh-desktop-renderer ⇒ 403 白屏。
7
+ // 改法:面板用 srcdoc 内嵌同一份 UI,页面里的 fetch 全部经 postMessage 由**主 frame** 代发
8
+ // (主 frame 的请求带 marker,能过 host 的 web-document 门);/lingshu 直连路由保持不变。
9
+ // 桥的状态必须在**模块级**:ref 每次渲染都是新函数,若状态写在 Panel 内会重复绑 listener(复核 0077)。
10
+ const BRIDGE = { frame: null, bound: false };
11
+ function onFrameRef(node) {
12
+ BRIDGE.frame = node;
13
+ if (!node || BRIDGE.bound) return;
14
+ BRIDGE.bound = true;
15
+ window.addEventListener('message', (ev) => {
16
+ const d = ev.data || {};
17
+ if (d.__lingshu !== 'req') return;
18
+ if (BRIDGE.frame && ev.source !== BRIDGE.frame.contentWindow) return;
19
+ const reply = (payload) => {
20
+ try { BRIDGE.frame.contentWindow.postMessage(Object.assign({ __lingshu: 'res', id: d.id }, payload), '*'); } catch (e) { /* frame 已卸载 */ }
21
+ };
22
+ fetch(d.url, { method: d.method || 'GET', body: (d.body == null ? undefined : d.body), headers: d.headers || {}, credentials: 'same-origin' })
23
+ .then(async (r) => reply({ ok: r.ok, status: r.status, text: await r.text() }))
24
+ .catch((e) => reply({ error: String((e && e.message) || e) }));
25
+ });
4
26
  }
5
27
  function Panel() {
6
- return React.createElement('iframe', {title:'灵枢 · 认知工作台',src:'/lingshu',style:{width:'100%',height:'100%',border:0,display:'block',background:'#f8f9f7'}});
28
+ return React.createElement('iframe', {
29
+ title: '灵枢 · 认知工作台',
30
+ srcDoc: PANEL_HTML,
31
+ ref: onFrameRef,
32
+ style: {width:'100%',height:'100%',border:0,display:'block',background:'#f8f9f7'},
33
+ });
7
34
  }
8
35
  module.exports = {
9
36
  inject:['slots'],
@@ -11,4 +38,4 @@ module.exports = {
11
38
  ctx.slots.inject('main',()=>ctx.slots.register({name:'main',key:'lingshu'},Panel));
12
39
  ctx.slots.inject('sidebar.panellist',()=>ctx.slots.register({name:'sidebar.panellist',id:'lingshu',order:20,label:'灵枢'},Icon));
13
40
  },
14
- };
41
+ };
package/web/app.js CHANGED
@@ -64,7 +64,9 @@
64
64
  async function overview(token) {
65
65
  $('main').innerHTML=title('让认知,有迹可循。','COGNITIVE WORKSPACE','记忆、目标与自我,在同一张认知图中延续。','<button id="new-memory" class="button primary">+ 记录记忆</button>')+loading();
66
66
  $('new-memory').onclick=()=>navigate('memory',true);
67
- const results=await Promise.allSettled([call('cg',{op:'info'}),call('stg',{op:'timeline',limit:5,desc:true})]);
67
+ // issue #801(#677 B 的契约变更后续):面板要读 os.goals / os.review_pending / os.protection,
68
+ // 而 info 缺省**不再返回** os(仅 full=true 才回)⇒ 面板取数必须显式带 full:true,否则整片显示「—」。
69
+ const results=await Promise.allSettled([call('cg',{op:'info',full:true}),call('stg',{op:'timeline',limit:5,desc:true})]);
68
70
  if(token!==generation)return;
69
71
  if(results[0].status==='rejected') throw results[0].reason;
70
72
  info=results[0].value; const os=info.os||{}, who=info.whoami?.principal||{}; const timeline=results[1].status==='fulfilled'?results[1].value:null;
package/web/client.js CHANGED
@@ -1,9 +1,36 @@
1
1
  const React = require('react');
2
+ const PANEL_HTML = __PANEL_HTML__; // build-ui.mjs 打包时内联(index.html + style.css + 桥 + app.js)
2
3
  function Icon({size=16}) {
3
- return React.createElement('svg', {width:size,height:size,viewBox:'0 0 24 24',fill:'none',stroke:'currentColor',strokeWidth:1.5,'aria-hidden':true}, React.createElement('path',{d:'M7 4h10v16H7z M10 8h4 M10 12h4 M10 16h2'}));
4
+ return React.createElement('svg', {width:size,height:size,viewBox:'0 0 24 24',fill:'none',stroke:'currentColor',strokeWidth:1.5,'aria-hidden':true}, React.createElement('path',{d:'M12 3v18M5 7l14 10M19 7L5 17'}));
5
+ }
6
+ // issue #791:桌面版(dsh-app://)下 iframe 子 frame 拿不到 x-dsh-desktop-renderer ⇒ 403 白屏。
7
+ // 改法:面板用 srcdoc 内嵌同一份 UI,页面里的 fetch 全部经 postMessage 由**主 frame** 代发
8
+ // (主 frame 的请求带 marker,能过 host 的 web-document 门);/lingshu 直连路由保持不变。
9
+ // 桥的状态必须在**模块级**:ref 每次渲染都是新函数,若状态写在 Panel 内会重复绑 listener(复核 0077)。
10
+ const BRIDGE = { frame: null, bound: false };
11
+ function onFrameRef(node) {
12
+ BRIDGE.frame = node;
13
+ if (!node || BRIDGE.bound) return;
14
+ BRIDGE.bound = true;
15
+ window.addEventListener('message', (ev) => {
16
+ const d = ev.data || {};
17
+ if (d.__lingshu !== 'req') return;
18
+ if (BRIDGE.frame && ev.source !== BRIDGE.frame.contentWindow) return;
19
+ const reply = (payload) => {
20
+ try { BRIDGE.frame.contentWindow.postMessage(Object.assign({ __lingshu: 'res', id: d.id }, payload), '*'); } catch (e) { /* frame 已卸载 */ }
21
+ };
22
+ fetch(d.url, { method: d.method || 'GET', body: (d.body == null ? undefined : d.body), headers: d.headers || {}, credentials: 'same-origin' })
23
+ .then(async (r) => reply({ ok: r.ok, status: r.status, text: await r.text() }))
24
+ .catch((e) => reply({ error: String((e && e.message) || e) }));
25
+ });
4
26
  }
5
27
  function Panel() {
6
- return React.createElement('iframe', {title:'灵枢 · 认知工作台',src:'/lingshu',style:{width:'100%',height:'100%',border:0,display:'block',background:'#f8f9f7'}});
28
+ return React.createElement('iframe', {
29
+ title: '灵枢 · 认知工作台',
30
+ srcDoc: PANEL_HTML,
31
+ ref: onFrameRef,
32
+ style: {width:'100%',height:'100%',border:0,display:'block',background:'#f8f9f7'},
33
+ });
7
34
  }
8
35
  module.exports = {
9
36
  inject:['slots'],
@@ -11,4 +38,4 @@ module.exports = {
11
38
  ctx.slots.inject('main',()=>ctx.slots.register({name:'main',key:'lingshu'},Panel));
12
39
  ctx.slots.inject('sidebar.panellist',()=>ctx.slots.register({name:'sidebar.panellist',id:'lingshu',order:20,label:'灵枢'},Icon));
13
40
  },
14
- };
41
+ };
package/zcode/AGENTS.md CHANGED
@@ -326,7 +326,7 @@
326
326
 
327
327
  三条调用铁律:
328
328
  1. **`op` 必填**——漏传会触发参数签名推导兜底(返回标记 `op_derived: true`),复杂任务中也必须显式传,防静默执行错误意图。
329
- 2. **返回 `moved_to: "review_queue"` / `verdict: DEFER` 时不要重试**——这是校验闸门的正常行为(返回自带 `hint` 说明下一步);落盘须经裁决(`op=review` 的 `decision=accept/reject/edit/merge/noop`,本机工具:`python scripts/review_cli.py list`)。**裁决权(2026-09-28 使用者裁定)**:写入者不得自裁——不得自己写、自己判、无复核一路到底;**经蜂群或验证端复核后,agent 可自行执行裁决**,不必每次转告使用者。**三类例外不适用该授权,必须转交使用者并止步**:①不适用于智能论这类重要协议真源的修改;②不适用于向外部发送信息和数据;③不适用于可能造成信息泄露/病毒/恶意操纵的动作。**`verdict: REJECT` 分两类,处置相反**:① 命中禁止规则(内容政策违规)→ 内容本身不该入库,重试同样结果;② 缺必需要素(`text` 类缺 CCG 六要素)→ **可修正**,按 `verdict.evidence` / `verdict.detail.missing` 给出的**完整缺失清单**补齐六要素后**重写**即落盘(本条未入库、已记入负记忆)——不要把它当「闸门故障」或「重试无用」。
329
+ 2. **返回 `moved_to: "review_queue"` / `verdict: DEFER` 时不要重试**——这是校验闸门的正常行为(返回自带 `hint` 说明下一步);落盘须经裁决(`op=review` 的 `decision=accept/reject/edit/merge/noop`,本机工具:`python -m md_cg.review_cli list`)。**裁决权(2026-09-28 使用者裁定)**:写入者不得自裁——不得自己写、自己判、无复核一路到底;**经蜂群或验证端复核后,agent 可自行执行裁决**,不必每次转告使用者。**三类例外不适用该授权,必须转交使用者并止步**:①不适用于智能论这类重要协议真源的修改;②不适用于向外部发送信息和数据;③不适用于可能造成信息泄露/病毒/恶意操纵的动作。**`verdict: REJECT` 分两类,处置相反**:① 命中禁止规则(内容政策违规)→ 内容本身不该入库,重试同样结果;② 缺必需要素(`text` 类缺 CCG 六要素)→ **可修正**,按 `verdict.evidence` / `verdict.detail.missing` 给出的**完整缺失清单**补齐六要素后**重写**即落盘(本条未入库、已记入负记忆)——不要把它当「闸门故障」或「重试无用」。
330
330
  3. `stg` 同理经 `op` 分发(`timeline` / `relation` / `anchors` 等)。
331
331
 
332
332
  ## 收尾强制流程(任务完成时不可跳过)