@furongjun1999/dsh-memory 0.9.23 → 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 (94) hide show
  1. package/CHANGELOG.en.md +450 -404
  2. package/CHANGELOG.md +67 -0
  3. package/README.en.md +244 -240
  4. package/README.md +272 -262
  5. package/codebuddy/CODEBUDDY.md +1 -1
  6. package/docs/discipline/templates/full.md.tmpl +1 -1
  7. package/docs/discipline/templates/rules.mdc.tmpl +1 -1
  8. package/docs/en/mdcg/world-model-endpoint.md +1 -1
  9. package/docs/mdcg/cogmap_ops.md +16 -15
  10. package/lib/client.js +29 -3
  11. package/lib/hooks.d.ts +12 -0
  12. package/lib/hooks.js +43 -1
  13. package/md_cg/bucketindex.py +231 -0
  14. package/md_cg/bucketscope.py +339 -0
  15. package/md_cg/config_registry_bulk.py +19 -10
  16. package/md_cg/config_validate.py +14 -2
  17. package/md_cg/detrerank.py +137 -0
  18. package/md_cg/fsutil.py +135 -0
  19. package/md_cg/govern/__init__.py +23 -0
  20. package/md_cg/iface/__init__.py +46 -0
  21. package/md_cg/iface/_verify.py +609 -0
  22. package/md_cg/iface/contracts.py +337 -0
  23. package/md_cg/judgment_manifest.py +14 -0
  24. package/md_cg/kernel/__init__.py +27 -0
  25. package/md_cg/mcp_server.py +5991 -5761
  26. package/md_cg/mdcg.py +474 -16
  27. package/md_cg/mdcos.py +228 -11
  28. package/md_cg/metacognition.py +66 -13
  29. package/md_cg/mutate_extract_shipped.py +126 -0
  30. package/md_cg/mutate_ledger_e2e.py +100 -0
  31. package/md_cg/op_table.py +8 -0
  32. package/md_cg/probe_c_ledger_integrity.py +258 -0
  33. package/md_cg/probe_d_retirement_discipline.py +263 -0
  34. package/md_cg/review_cli.py +6 -1
  35. package/md_cg/run_tests.py +30 -1
  36. package/md_cg/scopeselect.py +214 -0
  37. package/md_cg/scrub.py +66 -9
  38. package/md_cg/state_extract.py +149 -0
  39. package/md_cg/state_slots.py +58 -10
  40. package/md_cg/structboost.py +179 -0
  41. package/md_cg/test_alternatives_historical.py +162 -0
  42. package/md_cg/test_b2_sensitivity_landing.py +226 -223
  43. package/md_cg/test_b3_merge_keeps_content.py +608 -583
  44. package/md_cg/test_bucket_cards.py +85 -0
  45. package/md_cg/test_bucket_day_order.py +74 -0
  46. package/md_cg/test_bucket_quota.py +79 -0
  47. package/md_cg/test_bucket_recency_guards.py +75 -0
  48. package/md_cg/test_bucket_three_causes.py +83 -0
  49. package/md_cg/test_bucketindex.py +130 -0
  50. package/md_cg/test_bucketscope_early.py +71 -0
  51. package/md_cg/test_cond_term_fold_gate.py +1210 -0
  52. package/md_cg/test_cond_term_neg_scope.py +147 -0
  53. package/md_cg/test_detrerank.py +157 -0
  54. package/md_cg/test_gate_four_kpi.py +136 -0
  55. package/md_cg/test_generation_guard.py +14 -2
  56. package/md_cg/test_issue192_move_layer_indices_guard.py +48 -0
  57. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  58. package/md_cg/test_issue413_preimage_failclosed.py +147 -9
  59. package/md_cg/test_issue768_overwrite_time_window_anchor.py +135 -0
  60. package/md_cg/test_issue789_log_plaintext_probe.py +100 -0
  61. package/md_cg/test_issue790_verb_negation.py +77 -0
  62. package/md_cg/test_issue810_root_guard.py +71 -0
  63. package/md_cg/test_issue812_info_index_stale.py +78 -0
  64. package/md_cg/test_issue827_weaken_dedup.py +361 -0
  65. package/md_cg/test_issue829_calibration_positive_gate.py +473 -0
  66. package/md_cg/test_kernel_iface_contracts.py +18 -0
  67. package/md_cg/test_md_cg_no_hive_dep.py +238 -17
  68. package/md_cg/test_probe_cd_shipped.py +385 -0
  69. package/md_cg/test_recent_tail.py +93 -0
  70. package/md_cg/test_run_tests_entry_gates.py +110 -0
  71. package/md_cg/test_scopeselect.py +70 -0
  72. package/md_cg/test_scopeselect_clock.py +70 -0
  73. package/md_cg/test_session_attribution_consistency.py +835 -813
  74. package/md_cg/test_state_extract_shipped.py +162 -0
  75. package/md_cg/test_state_ledger_chain.py +207 -0
  76. package/md_cg/test_state_ledger_e2e.py +145 -0
  77. package/md_cg/test_structboost.py +102 -0
  78. package/md_cg/test_timeboost.py +83 -0
  79. package/md_cg/test_timeboost_relativedate.py +71 -0
  80. package/md_cg/test_topicagg.py +129 -0
  81. package/md_cg/timeboost.py +223 -0
  82. package/md_cg/topicagg.py +142 -0
  83. package/md_cg/whitebox_kb/wisdom/code_compose.py +33 -5
  84. package/md_cg/whitebox_kb/wisdom/compose_engine.py +5 -1
  85. package/md_cg/whitebox_kb/wisdom/role_compose.py +271 -268
  86. package/package.json +137 -137
  87. package/src/hooks.ts +43 -1
  88. package/ui/minimal/payload/build-ui.mjs +41 -2
  89. package/ui/minimal/payload/lib/client.js +29 -3
  90. package/ui/minimal/payload/web/app.js +3 -1
  91. package/ui/minimal/payload/web/client.js +30 -3
  92. package/web/app.js +3 -1
  93. package/web/client.js +30 -3
  94. package/zcode/AGENTS.md +1 -1
@@ -263,8 +263,8 @@ CONST_ROWS = [
263
263
  ('MAX_CP', 'CALIB', 'calib', 'const', True, '1114111', 'int', '见 default(上限/条数)', '', '', 'const_assign', 'scripts/gen_id_charset_blocks.py', 'MAX_CP', 'uncalibrated', '无(未见标定注记)', 'unknown', ''),
264
264
  ('ACTIVE_WINDOW_S', 'TUNE', 'tune', 'const', True, '300', 'int', '见 default(超时/时间窗)', '', '', 'const_assign', 'scripts/mdcg_verify_render_meta.py', 'ACTIVE_WINDOW_S', 'uncalibrated', '无(未见标定注记)', 'unknown', '源码注释:「新鲜写入」窗口:重建后落入此窗的旧 render 即活跃污染证据'),
265
265
  ('SNIPPET_MAX', 'CALIB', 'calib', 'const', True, '30', 'int', '见 default(上限/条数)', '', '', 'const_assign', 'scripts/probe_b_state_events_v4.py', 'SNIPPET_MAX', 'uncalibrated', '无(未见标定注记)', 'unknown', '源码注释:证据短证硬上限(≤30 字)'),
266
- ('BIG_LIMIT', 'TUNE', 'tune', 'const', True, '1000000000', 'int', '见 default(上限/条数)', '', '', 'const_assign', 'scripts/probe_c_ledger_integrity.py', 'BIG_LIMIT', 'uncalibrated', '无(未见标定注记)', 'unknown', ''),
267
- ('ANCHOR_WINDOW', 'TUNE', 'tune', 'const', False, '[1.0, 100000000000.0]', 'list', '见 default(枚举/表)', '', '', 'const_assign', 'scripts/probe_d_retirement_discipline.py', 'ANCHOR_WINDOW', 'uncalibrated', '无(未见标定注记)', 'unknown', ''),
266
+ ('BIG_LIMIT', 'TUNE', 'tune', 'const', True, '1000000000', 'int', '见 default(上限/条数)', '', '', 'const_assign', 'md_cg/probe_c_ledger_integrity.py', 'BIG_LIMIT', 'uncalibrated', '无(未见标定注记)', 'unknown', ''),
267
+ ('ANCHOR_WINDOW', 'TUNE', 'tune', 'const', False, '[1.0, 100000000000.0]', 'list', '见 default(枚举/表)', '', '', 'const_assign', 'md_cg/probe_d_retirement_discipline.py', 'ANCHOR_WINDOW', 'uncalibrated', '无(未见标定注记)', 'unknown', ''),
268
268
  ('FULL_WINDOW_HI', 'TUNE', 'tune', 'const', True, '9999999999.0', 'float', '见 default(超时/时间窗)', '', '', 'const_assign', 'scripts/retr_time_coverage.py', 'FULL_WINDOW_HI', 'uncalibrated', '无(未见标定注记)', 'unknown', ''),
269
269
  ('MAX_FILES', 'CALIB', 'calib', 'const', True, '500', 'int', '见 default(上限/条数)', '', '', 'const_assign', 'scripts/review_reconcile.py', 'MAX_FILES', 'uncalibrated', '无(未见标定注记)', 'unknown', ''),
270
270
  ('MAX_ITEMS', 'CALIB', 'calib', 'const', True, '2000', 'int', '见 default(上限/条数)', '', '', 'const_assign', 'scripts/review_reconcile.py', 'MAX_ITEMS', 'uncalibrated', '无(未见标定注记)', 'unknown', ''),
@@ -349,6 +349,21 @@ ENV_ROWS = [
349
349
  ('MDCG_PREFILTER', 'TUNE', 'tune', 'env', True, "'0'", 'str', 'value', 'MDCG_PREFILTER', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-10-21 手补:PR 内新增开关(未设=开/缺省即字面量)', 'unknown', ''),
350
350
  ('MDCG_PREFILTER_MIN', 'TUNE', 'tune', 'env', True, "'50'", 'str', 'value', 'MDCG_PREFILTER_MIN', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-10-21 手补:PR 内新增开关(未设=开/缺省即字面量)', 'unknown', ''),
351
351
  ('MDCG_RECONCILE_BG', 'TUNE', 'tune', 'env', True, "'1'", 'str', 'value', 'MDCG_RECONCILE_BG', 'value', 'env_literal', 'md_cg/mcp_server.py', '', 'uncalibrated', '2026-10-21 手补:PR 内新增开关', 'unknown', ''),
352
+ ('MDCG_RECENT_TAIL', 'TUNE', 'tune', 'env', True, "'6'", 'str', 'value', 'MDCG_RECENT_TAIL', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-11-07:search_rrf 的 cutoff 邻近保障(Ornn8 测评建议②),0=关'),
353
+ ('MDCG_TOPIC_AGG', 'TUNE', 'tune', 'env', True, "'1'", 'str', 'value', 'MDCG_TOPIC_AGG', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-11-07:跨轮状态聚合(Ornn8 测评建议①),0=关'),
354
+ ('MDCG_DET_RERANK', 'TUNE', 'tune', 'env', True, "'0'", 'str', 'value', 'MDCG_DET_RERANK', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-11-07:确定性四信号重排(向量只给参考),0=关'),
355
+ ('MDCG_DET_MODE', 'TUNE', 'tune', 'env', True, "'tiebreak'", 'str', 'value', 'MDCG_DET_MODE', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-11-08:确定性重排模式 tiebreak|window|replace(缺省 tiebreak)'),
356
+ ('MDCG_TOPIC_AGG_TAGFALLBACK', 'TUNE', 'tune', 'env', True, "'0'", 'str', 'value', 'MDCG_TOPIC_AGG_TAGFALLBACK', 'value', 'env_literal', 'md_cg/topicagg.py', '', 'uncalibrated', '2026-11-08:topicagg 的 tag 召回兜底(缺省关;开启需接受泛词噪声)'),
357
+ ('MDCG_STRUCT_BOOST', 'TUNE', 'tune', 'env', True, "'0'", 'str', 'value', 'MDCG_STRUCT_BOOST', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-11-09:结构信号重排(章节路由+元素覆盖),0=关;需入库期 ch:N 盖章'),
358
+ ('MDCG_TIME_BOOST', 'TUNE', 'tune', 'env', True, "'0'", 'str', 'value', 'MDCG_TIME_BOOST', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-11-09:时间桶重排(主库章节=写入日期),0=关;需调用方显式给 now'),
359
+ ('MDCG_BUCKET_SCOPE', 'TUNE', 'tune', 'env', True, "'1'", 'str', 'value', 'MDCG_BUCKET_SCOPE', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-11-09:日/会话桶作用域召回(通用默认开,0=关),会话优先+日倒排'),
360
+
361
+
362
+ ('MDCG_SCOPE_SELECT', 'TUNE', 'tune', 'env', True, "'1'", 'str', 'value', 'MDCG_SCOPE_SELECT', 'value', 'env_literal', 'md_cg/bucketscope.py', '', 'uncalibrated', '2026-11-09:范围选择(槽位共现推断时间桶),0=回落最近优先'),
363
+ ('MDCG_SCOPESEL_COOC', 'TUNE', 'tune', 'env', True, "'1'", 'str', 'value', 'MDCG_SCOPESEL_COOC', 'value', 'env_literal', 'md_cg/scopeselect.py', '', 'uncalibrated', '2026-11-09:共现打分路(默认开——bench 生产侧 97.83%,idf 对照 35.33%)'),
364
+ ('MDCG_BUCKET_AUTO', 'TUNE', 'tune', 'env', True, "'1'", 'str', 'value', 'MDCG_BUCKET_AUTO', 'value', 'env_literal', 'md_cg/bucketindex.py', '', 'uncalibrated', '2026-11-09:桶索引每日自动重建(info 触发),0=关'),
365
+ ('MDCG_BUCKET_INTERVAL_H', 'TUNE', 'tune', 'env', True, "'20'", 'str', 'value', 'MDCG_BUCKET_INTERVAL_H', 'value', 'env_literal', 'md_cg/bucketindex.py', '', 'uncalibrated', '2026-11-09:重建间隔小时(缺省 20;0=强制)'),
366
+
352
367
  ('MDCG_MIN_SCORE', 'TUNE', 'tune', 'env', True, "'0'", 'str', 'value', 'MDCG_MIN_SCORE', 'value', 'env_literal', 'md_cg/mdcg.py', '', 'uncalibrated', '2026-10-23 手补:issue #637 可配最低分(0=关)', 'unknown', ''),
353
368
  ('MDCG_RECALL_MIN_SCORE', 'TUNE', 'tune', 'env', True, "'-1'", 'str', 'value', 'MDCG_RECALL_MIN_SCORE', 'value', 'env_literal', 'md_cg/mdcos.py', '', 'uncalibrated', '2026-10-23 手补:issue #637 召回面最低分(-1=关)', 'unknown', ''),
354
369
  ]
@@ -402,7 +417,6 @@ ENV_CATEGORY_ROWS = [
402
417
  ('LINGSHU_KB', 'env', 'dsh-memory-main', '目录路径', ''),
403
418
  ('LINGSHU_PYTHON / LINGSHU_REPO', 'env', 'dsh-memory-main', '解释器路径 / 目录', ''),
404
419
  ('MAGICK_HOME / ImageMagick_HOME', 'env', 'dsh-memory-main', '目录路径', '经 *_ENV 常量间接读取,朴素字面量扫描抓不到'),
405
- ('MDCG_ACTOR', 'env', 'dsh-memory-main', '字符串', '★ 两处默认值不同(同一 env 名,默认分叉)'),
406
420
  ('MDCG_ALLOW_ROOT_ISSUE', 'env', 'dsh-memory-main', '开关(1/true/yes/on 放行管理级令牌自铸)', '★ #543 签发授权闸的运维逃生口;缺省未设=关(tokens.py:471)'),
407
421
  ('MDCG_ARCHIVE_ROOT', 'env', 'dsh-memory-main', '目录路径', ''),
408
422
  ('MDCG_AUX_ROOT', 'env', 'dsh-memory-main', '目录路径', ''),
@@ -410,16 +424,13 @@ ENV_CATEGORY_ROWS = [
410
424
  ('MDCG_CAN_ADMIN', 'env', 'dsh-memory-main', 'bool 字符串 {1,true,True}', ''),
411
425
  ('MDCG_CAN_WRITE', 'env', 'dsh-memory-main', 'bool 字符串', ''),
412
426
  ('MDCG_CHILD_CWD', 'env', 'dsh-memory-main', '目录路径', '只在 TS 面定义/传递'),
413
- ('MDCG_CLEARANCE', 'env', 'dsh-memory-main', '枚举 {public,internal,restricted,private,secret}', ''),
414
427
  ('MDCG_CODE_TEST_CMD / MDCG_CODE_TEST_TIMEOUT', 'env', 'dsh-memory-main', '命令串 / 秒(int)', 'CODE_TEST_CMD 属权限面(执行外部命令)'),
415
428
  ('MDCG_DATA_ROOT', 'env', 'dsh-memory-main', '目录路径', ''),
416
429
  ('MDCG_DSH_SESSIONS_ROOT', 'env', 'dsh-memory-main', '目录路径', ''),
417
- ('MDCG_EXPORT_ROOT', 'env', 'dsh-memory-main', 'path 列表(os.pathsep 分隔)', '部署期写路径白名单'),
418
430
  ('MDCG_FRESHNESS_NOW', 'env', 'dsh-memory-main', 'float(可复算冻结口)', '供两侧探针逐位比对'),
419
431
  ('MDCG_GATE_SANDBOX_DIR', 'env', 'dsh-memory-main', '目录路径', ''),
420
432
  ('MDCG_HARNESS / MDCG_UNIT', 'env', 'dsh-memory-main', '字符串', '服务端身份面(同样有 MDCG_NODE_ID/MDCG_SWARM_DIR 归因面)'),
421
433
  ('MDCG_HIVE_JOBS', 'env', 'dsh-memory-main', '目录路径', ''),
422
- ('MDCG_INGEST_ROOT', 'env', 'dsh-memory-main', 'path 列表(os.pathsep 分隔)', '部署期写路径白名单'),
423
434
  ('MDCG_JUDGMENT_MANIFEST', 'env', 'dsh-memory-main', '文件路径', ''),
424
435
  ('MDCG_LEGACY_ENV_ADMIN', 'env', 'dsh-memory-main', 'bool 字符串', ''),
425
436
  ('MDCG_LEGACY_ENV_AUTH', 'env', 'dsh-memory-main', 'bool 字符串 {1,true,True}', ''),
@@ -429,7 +440,6 @@ ENV_CATEGORY_ROWS = [
429
440
  ('MDCG_LLM_KEY / MDCG_LLM_BASE / MDCG_LLM_MODEL', 'env', 'dsh-memory-main', '密钥 / URL / 模型名', ''),
430
441
  ('MDCG_QMD_LLM_BASE / MDCG_QMD_LLM_MODEL / MDCG_QMD_LLM_KEY', 'env', 'dsh-memory-main', 'URL / 模型名 / 密钥(敏感)', 'QMD 的 LLM 接入(md_cg/qmd_llm.py);三者缺一即 LLMUnavailable,不回落 MDCG_LLM_KEY / DEEPSEEK_API_KEY'),
431
442
  ('MDCG_MASTER_KEY', 'env', 'dsh-memory-main', '密钥(敏感,hex)', '敏感值不回显'),
432
- ('MDCG_MCP_SURFACE', 'env', 'dsh-memory-main', '枚举 {kernel, full}', 'kernel 只暴露 cg/stg 两基元'),
433
443
  ('MDCG_POLICY_FILE', 'env', 'dsh-memory-main', '文件路径', ''),
434
444
  ('MDCG_PYTHON', 'env', 'dsh-memory-main', '解释器路径', '★ 动态键读取,朴素 grep 抓不到'),
435
445
  ('MDCG_REACH_INDEX', 'env', 'dsh-memory-main', '文件路径', ''),
@@ -439,10 +449,11 @@ ENV_CATEGORY_ROWS = [
439
449
  ('MDCG_SESSION', 'env', 'dsh-memory-main', '字符串', 'TS 面已改为「请求声明归因」优先(见 src/tools.ts 注)'),
440
450
  ('MDCG_SIGNERS_FILE / MDCG_SIGNER_KEY_FILE / MDCG_SIGNER_MODULE', 'env', 'dsh-memory-main', '文件路径 / 文件路径 / 模块名', ''),
441
451
  ('MDCG_STATE_ROOT', 'env', 'dsh-memory-main', '目录路径', ''),
452
+ ('MDCG_STATE_EXTRACT', 'env', 'dsh-memory-main', '开关', 'L2 状态台账抽取开关:缺省开,置 0 关闭(md_cg/state_extract.py:76;recent·add 接线)'),
453
+ ('MDCG_STATE_SUBJECT', 'env', 'dsh-memory-main', '字符串', 'L2 台账抽取主体覆盖,缺省「我」(md_cg/state_extract.py:108)'),
442
454
  ('MDCG_SUSTAIN_DIR', 'env', 'dsh-memory-main', '目录路径', ''),
443
455
  ('MDCG_SUSTAIN_NAME', 'env', 'dsh-memory-main', '字符串', ''),
444
456
  ('MDCG_SWARM_DIR', 'env', 'dsh-memory-main', '目录路径', ''),
445
- ('MDCG_TENANT', 'env', 'dsh-memory-main', '租户名', "★ 注意:src/index.ts 另有 MDCG_TENANT 默认 'default'(插件 config.mdcg.tenant)"),
446
457
  ('MDCG_TENANT_REGISTRY', 'env', 'dsh-memory-main', '文件路径', ''),
447
458
  ('MDCG_TESTLOG_DIR', 'env', 'dsh-memory-main', '目录路径', ''),
448
459
  ('MDCG_THEORY_FILE / MDCG_THEORY', 'env', 'dsh-memory-main', '文件路径', ''),
@@ -476,9 +487,7 @@ ENV_CATEGORY_ROWS = [
476
487
  ('GITHUB_ACTIONS / PR_TITLE', 'env', 'lingshu', '字符串', ''),
477
488
  ('LINGSHU_COMPONENT_ROOT', 'env', 'lingshu', '路径', ''),
478
489
  ('LINGSHU_DATA_ROOT', 'env', 'lingshu', '路径', ''),
479
- ('MDCG_BRAIN_PYTHONPATH', 'env', 'lingshu', '路径列表', ''),
480
490
  ('MDCG_LEGACY_ENV_AUTH / MDCG_CAN_ADMIN / MDCG_LEGACY_ENV_ADMIN', 'env', 'lingshu', 'bool 语义', ''),
481
- ('MDCG_ROOT', 'env', 'lingshu', '路径', ''),
482
491
  ('PYTHONUTF8 / PYTHONIOENCODING', 'env', 'lingshu', '字符串', ''),
483
492
  ('MDCG_REPLAY_NEG_MAX_COVERAGE', 'env', 'dsh-memory-main', 'float(正数;非法/非正回落默认)', 'issue #278:consolidate neg_separated 的词面覆盖率阈值(默认 0.5)'),
484
493
  ]
@@ -26,12 +26,17 @@ RULES = {
26
26
  'MDCG_AUTO_SCRUB': {'bool_like': True, 'type': 'bool'},
27
27
  'MDCG_AUTO_TIDY': {'bool_like': True, 'type': 'bool'},
28
28
  'MDCG_BM25': {'bool_like': True, 'true_literals': ['1'], 'type': 'bool'},
29
+ 'MDCG_BUCKET_AUTO': {'type': 'str'},
30
+ 'MDCG_BUCKET_INTERVAL_H': {'type': 'str'},
29
31
  'MDCG_BUCKET_MIN_SIM': {'max': 1.0, 'min': 0.0, 'type': 'float'},
32
+ 'MDCG_BUCKET_SCOPE': {'type': 'str'},
30
33
  'MDCG_BUCKET_TOPK': {'type': 'str'},
31
34
  'MDCG_CHAIN_TYPES': {'type': 'str'},
32
35
  'MDCG_CLEARANCE': {'enum': ['public', 'internal', 'restricted', 'private', 'secret'],
33
36
  'type': 'str'},
34
37
  'MDCG_CN_GRAMS': {'bool_like': True, 'true_literals': ['1'], 'type': 'bool'},
38
+ 'MDCG_DET_MODE': {'type': 'str'},
39
+ 'MDCG_DET_RERANK': {'type': 'str'},
35
40
  'MDCG_D_META': {'bool_like': True, 'type': 'bool'},
36
41
  'MDCG_EN_ATOMS': {'enum': ['norm', 'raw'], 'type': 'str'},
37
42
  'MDCG_EXPLORE_BUDGET_MAX': {'type': 'str'},
@@ -67,11 +72,14 @@ RULES = {
67
72
  'MDCG_REACH_TTL': {'min': 0.0, 'type': 'float'},
68
73
  'MDCG_READ_CACHE': {'bool_like': True, 'true_literals': ['1'], 'type': 'bool'},
69
74
  'MDCG_RECALL_MIN_SCORE': {'type': 'str'},
75
+ 'MDCG_RECENT_TAIL': {'type': 'str'},
70
76
  'MDCG_RECONCILE': {'bool_like': True, 'type': 'bool'},
71
77
  'MDCG_RECONCILE_BG': {'type': 'str'},
72
78
  'MDCG_RELOAD_MIN_INTERVAL': {'type': 'str'},
73
79
  'MDCG_RETRIEVAL_PIPELINE': {'bool_like': True, 'true_literals': ['1'], 'type': 'bool'},
74
80
  'MDCG_S7_FRESHNESS': {'bool_like': True, 'true_literals': ['1'], 'type': 'bool'},
81
+ 'MDCG_SCOPESEL_COOC': {'type': 'str'},
82
+ 'MDCG_SCOPE_SELECT': {'type': 'str'},
75
83
  'MDCG_SCORE_MODE': {'enum': ['legacy', 'jaccard'], 'type': 'str'},
76
84
  'MDCG_SEMANTIC': {'bool_like': True, 'true_literals': ['1'], 'type': 'bool'},
77
85
  'MDCG_SLEEP': {'bool_like': True, 'type': 'bool'},
@@ -85,12 +93,16 @@ RULES = {
85
93
  'MDCG_SPREAD_GAIN': {'max': 1.0, 'min': 0.0, 'type': 'float'},
86
94
  'MDCG_SPREAD_HOPS': {'min': 1, 'type': 'int'},
87
95
  'MDCG_STATUS_HEAD': {'bool_like': True, 'true_literals': ['1'], 'type': 'bool'},
96
+ 'MDCG_STRUCT_BOOST': {'type': 'str'},
88
97
  'MDCG_SUSTAIN': {'bool_like': True, 'type': 'bool'},
89
98
  'MDCG_SUSTAIN_AUTOHEAL': {'bool_like': True, 'type': 'bool'},
90
99
  'MDCG_SUSTAIN_BEAT_THREAD': {'bool_like': True, 'type': 'bool'},
91
100
  'MDCG_TEMPORAL_GAMMA': {'min': 0.0, 'type': 'float'},
92
101
  'MDCG_TENANT': {'type': 'str'},
102
+ 'MDCG_TIME_BOOST': {'type': 'str'},
93
103
  'MDCG_TOOL_FACE': {'bool_like': True, 'true_literals': ['1'], 'type': 'bool'},
104
+ 'MDCG_TOPIC_AGG': {'type': 'str'},
105
+ 'MDCG_TOPIC_AGG_TAGFALLBACK': {'type': 'str'},
94
106
  'MDCG_UNIFY_QUERY': {'bool_like': True, 'true_literals': ['1'], 'type': 'bool'},
95
107
  'MDCG_WARM_SEARCH': {'type': 'str'},
96
108
  'MDCG_WRITELIMIT': {'bool_like': True, 'type': 'bool'},
@@ -231,6 +243,8 @@ RULES = {
231
243
  'dsh-memory-main::md_cg/predict.py::PREFERENCE_THRESHOLD': {'type': 'float'},
232
244
  'dsh-memory-main::md_cg/predict.py::SEMANTIC_MIN_SIM': {'type': 'float'},
233
245
  'dsh-memory-main::md_cg/predict.py::SEMANTIC_TOP_K': {'type': 'int'},
246
+ 'dsh-memory-main::md_cg/probe_c_ledger_integrity.py::BIG_LIMIT': {'type': 'int'},
247
+ 'dsh-memory-main::md_cg/probe_d_retirement_discipline.py::ANCHOR_WINDOW': {'type': 'str'},
234
248
  'dsh-memory-main::md_cg/progressive.py::MIN_DISCRIM': {'type': 'float'},
235
249
  'dsh-memory-main::md_cg/provenance.py::DEFAULT_FIND_LIMIT': {'type': 'int'},
236
250
  'dsh-memory-main::md_cg/provenance.py::MAX_FIND_LIMIT': {'type': 'int'},
@@ -322,8 +336,6 @@ RULES = {
322
336
  'dsh-memory-main::scripts/gen_id_charset_blocks.py::MAX_CP': {'type': 'int'},
323
337
  'dsh-memory-main::scripts/mdcg_verify_render_meta.py::ACTIVE_WINDOW_S': {'type': 'int'},
324
338
  'dsh-memory-main::scripts/probe_b_state_events_v4.py::SNIPPET_MAX': {'type': 'int'},
325
- 'dsh-memory-main::scripts/probe_c_ledger_integrity.py::BIG_LIMIT': {'type': 'int'},
326
- 'dsh-memory-main::scripts/probe_d_retirement_discipline.py::ANCHOR_WINDOW': {'type': 'str'},
327
339
  'dsh-memory-main::scripts/retr_time_coverage.py::FULL_WINDOW_HI': {'type': 'float'},
328
340
  'dsh-memory-main::scripts/review_reconcile.py::MAX_FILES': {'type': 'int'},
329
341
  'dsh-memory-main::scripts/review_reconcile.py::MAX_ITEMS': {'type': 'int'},
@@ -0,0 +1,137 @@
1
+ # -*- coding: utf-8 -*-
2
+ """确定性重排(detrerank)——检索结论的**唯一裁决口**。
3
+
4
+ 裁定(structural: mem_ruling_vector_ref_deterministic):
5
+ 向量/语义相似度 **只提供参考**(候选扩展),结论必须由**词法·时间·空间·交互**
6
+ 四类确定性信号重排,且**必须由确定性规则裁决**:固定常量 + 可数信号,
7
+ 同输入同输出(可对拍、可回放)。
8
+
9
+ 为什么这样切:相似度回答「像不像」,因果观察三元组(时间/空间/交互)回答
10
+ 「是不是真的发生过」,词法回答「原文对不对得上」。三者性质不同,
11
+ 用一个浮点分数混合会让「像」压过「真」——这正是 #753/#790 那类 fail-open 的同源病。
12
+
13
+ 确定性约束(本模块的三条硬纪律):
14
+ 1. **无模型分**:函数体不得出现 embedding / 相似度 / 模型调用;
15
+ 2. **时钟显式**:`now` 必须由调用方传入(不内部取 time.time()),否则不可回放;
16
+ 3. **全序**:分数相同按 id 字典序兜底,保证任意两次结果逐位相同。
17
+ """
18
+ from __future__ import annotations
19
+
20
+ import re
21
+
22
+ #: 四信号权重(固定常量;改值等于改裁决口径,必须走评审 + 读数)。
23
+ WEIGHTS = {
24
+ "lexical": 4, # 词法最重:原文对得上才算证据
25
+ "interaction": 3, # 交互次之:真的发生过作用
26
+ "spatial": 2, # 空间可达:在同域/同链路里
27
+ "temporal": 1, # 时间只做轻微加权(新旧不代表对错)
28
+ }
29
+
30
+ #: 时间衰减半衰期(天)——与 temporal 路同源口径,固定常量,不随环境变。
31
+ TEMPORAL_HALF_LIFE_D = 30.0
32
+
33
+ #: window 模式:只在融合前 WINDOW_SIZE 名内允许有界上浮(防弱条目顶上第一)。
34
+ WINDOW_SIZE = 8
35
+
36
+
37
+ def _terms(text) -> list:
38
+ return [t.lower() for t in re.split(r"[\s,,、;;。!?::()()\[\]【】]+", text or "")
39
+ if len(t) >= 2]
40
+
41
+
42
+ def _snippet(node, limit: int = 1200) -> str:
43
+ parts = [str(node.get("content") or "")[:limit]]
44
+ fm = node.get("frontmatter") or {}
45
+ for key in ("tags", "title", "conditions"):
46
+ val = fm.get(key)
47
+ if val:
48
+ parts.append(str(val))
49
+ return " ".join(parts).lower()
50
+
51
+
52
+ def signals(node, query_terms, now, session=None) -> dict:
53
+ """四信号取值(全部确定性可数)。"""
54
+ text = _snippet(node)
55
+ # 词法:query 词项在原文/标签里的命中数(整数)
56
+ lexical = sum(1 for t in query_terms if t in text)
57
+ fm = node.get("frontmatter") or {}
58
+ # 交互:出边数 + 入标记(edges 是「真的发生过作用」的痕迹)
59
+ edges = fm.get("edges")
60
+ out_edges = len(edges) if isinstance(edges, list) else 0
61
+ refs = fm.get("derived_from") or fm.get("alias_of") or []
62
+ refs_n = len(refs) if isinstance(refs, (list, tuple)) else (1 if refs else 0)
63
+ interaction = out_edges + refs_n
64
+ # 空间:同会话(同域)+ 同层(结构可达)——两个可数布尔
65
+ same_session = 1 if (session and str(fm.get("session") or "") == str(session)) else 0
66
+ layer = str(fm.get("layer") or "")
67
+ spatial = same_session + (1 if layer in ("knowledge", "structural") else 0)
68
+ # 时间:按半衰期衰减到 [0,1] 后取整到 3 位(确定性,无时钟读取)
69
+ try:
70
+ created = float(fm.get("created_at") or 0)
71
+ except (TypeError, ValueError):
72
+ created = 0.0
73
+ if created > 0 and now:
74
+ age_days = max(0.0, (float(now) - created) / 86400.0)
75
+ temporal = round(0.5 ** (age_days / TEMPORAL_HALF_LIFE_D), 3)
76
+ else:
77
+ temporal = 0.0
78
+ return {"lexical": lexical, "interaction": interaction,
79
+ "spatial": spatial, "temporal": temporal}
80
+
81
+
82
+ def score(sig: dict) -> float:
83
+ """加权和(整数权重 × 确定性信号),保留 6 位。"""
84
+ total = 0.0
85
+ for key, weight in WEIGHTS.items():
86
+ total += float(weight) * float(sig.get(key) or 0)
87
+ return round(total, 6)
88
+
89
+
90
+ def rerank(results, query, now, session=None):
91
+ """对 [(node, fused_score, qual, prov), ...] 做确定性重排。
92
+
93
+ 返回新列表(不改入参):按 (det_score desc, id asc) 全序。
94
+ `now` 必须由调用方给(时钟显式,可回放)。
95
+ """
96
+ terms = _terms(query)
97
+ scored = []
98
+ for item in results or ():
99
+ node = item[0]
100
+ sig = signals(node, terms, now, session=session)
101
+ scored.append((score(sig), str(node.get("id") or ""), sig, item))
102
+ scored.sort(key=lambda x: (-x[0], x[1]))
103
+ return [(item, det, sig) for det, _nid, sig, item in scored]
104
+
105
+
106
+ def rerank_v2(results, query, now, mode="tiebreak", session=None):
107
+ """v2:**保留 RRF 为主序**,四信号只做有界修正。
108
+
109
+ bench 读数(hive-memory-bench · e2e-simple/蜂巢指南 38 题 · 块级词面覆盖):
110
+ v1(replace,按 det 总分重排):cov@1 **0.625 → 0.313**(g1 28 → 11)。
111
+ 原因:词法计数奖励「长块/词多」,与「这段是否解答了问题」无关;
112
+ 把 RRF 的候选质量丢掉,等于用一个更粗的信号覆盖更细的信号。
113
+
114
+ 三种模式:
115
+ · `tiebreak`(**缺省**):fused 相同才看四信号——零风险,只在并列时用证据说话;
116
+ · `window`:融合前 WINDOW_SIZE 名内、词法 ≥ 2 的条目允许上浮(有界);
117
+ · `replace`:v1 行为,保留以便复现上述读数,**不建议**。
118
+ """
119
+ terms = _terms(query)
120
+ scored = []
121
+ for idx, item in enumerate(results or ()):
122
+ node = item[0]
123
+ sig = signals(node, terms, now, session=session)
124
+ fused = float(item[1]) if len(item) > 1 and isinstance(item[1], (int, float)) else 0.0
125
+ scored.append({"idx": idx, "id": str(node.get("id") or ""), "sig": sig,
126
+ "det": score(sig), "fused": fused, "item": item})
127
+ if mode == "replace":
128
+ scored.sort(key=lambda x: (-x["det"], x["id"]))
129
+ elif mode == "window":
130
+ scored.sort(key=lambda x: (-x["fused"], x["idx"]))
131
+ head, tail = scored[:WINDOW_SIZE], scored[WINDOW_SIZE:]
132
+ head.sort(key=lambda x: (0 if x["sig"]["lexical"] >= 2 else 1,
133
+ -x["det"], -x["fused"], x["id"]))
134
+ scored = head + tail
135
+ else: # tiebreak(缺省,零风险)
136
+ scored.sort(key=lambda x: (-x["fused"], -x["det"], x["id"]))
137
+ return [(x["item"], x["det"], x["sig"]) for x in scored]
package/md_cg/fsutil.py CHANGED
@@ -999,6 +999,36 @@ def ensure_shard_dir(directory: str, where: str = "append") -> bool:
999
999
 
1000
1000
 
1001
1001
  # 生效条件:directory 经 abspath 存入 self.dir 后经 ensure_shard_dir(self.dir, "init") 保证目录存在(首建不记账;失败抛 ShardDirError 而非裸 OSError),实例分片文件名由 os.getpid() 与 uuid.uuid4().hex[:8] 拼成 "{pid}-{hex8}.log",append 时各写者只写自己这一分片,从而不共享写入点。
1002
+ #: 增量游标回看最后一个换行的**有界**扫描窗口,以及总上限。
1003
+ #: 窗口内找不到换行(超长行)时退一个窗口继续;累计到上限仍未找到 ⇒ 记 0
1004
+ #: (安全方向:下次整片重读,重放幂等,不会漏记录)。
1005
+ _CURSOR_CHUNK = 64 * 1024
1006
+ _CURSOR_SCAN_CAP = 8 * 1024 * 1024
1007
+
1008
+
1009
+ # 生效条件:path 存在且 size>0 时,从 size 起向前回看找最后一个 "\n" 并返回其字节后一位(即已提交行边界);回看到 _CURSOR_SCAN_CAP 仍未找到、或读失败时返回 0(全片重读,安全方向)。
1010
+ def _last_newline_boundary(path: str, size: int) -> int:
1011
+ """分片「已提交行边界」字节水位(只认完整行,与 read_jsonl_tail 同口径)。"""
1012
+ scanned = 0
1013
+ end = size
1014
+ try:
1015
+ with open(path, "rb") as f:
1016
+ while end > 0 and scanned < _CURSOR_SCAN_CAP:
1017
+ start = max(0, end - _CURSOR_CHUNK)
1018
+ f.seek(start)
1019
+ buf = f.read(end - start)
1020
+ if not buf:
1021
+ break
1022
+ i = buf.rfind(b"\n")
1023
+ if i >= 0:
1024
+ return start + i + 1
1025
+ scanned += len(buf)
1026
+ end = start
1027
+ except OSError:
1028
+ return 0
1029
+ return 0
1030
+
1031
+
1002
1032
  class ShardedLog:
1003
1033
  """每写者独占一个分片的 append-only 日志——不能丢记录时用它。
1004
1034
 
@@ -1142,6 +1172,111 @@ class ShardedLog:
1142
1172
  recs.sort(key=lambda r: (_norm(r.get("_t", 0)), _norm(r.get("_s", 0))))
1143
1173
  return recs
1144
1174
 
1175
+ @staticmethod
1176
+ # 生效条件:directory 为目录时返回 dict(分片文件名 -> 该文件当前**已提交行边界**的字节水位);文件不存在/不可读的条目跳过;目录不可列时返回 {}。
1177
+ def committed_cursor(directory: str):
1178
+ """各分片**已提交行边界**的字节水位(增量重载的基线游标)。
1179
+
1180
+ 只需知道「整行到哪里为止」,不必解析内容。做法:从文件尾回看一个
1181
+ 有界窗口找最后一个 `\\n`;窗口内找不到(超长行)则退一个窗口继续,
1182
+ 最多回看 `_CURSOR_SCAN_CAP` 字节,仍未找到就记 0——**记 0 是安全方向**:
1183
+ 下次增量会重读整片,重放幂等,只是慢一点,不会漏记录。
1184
+
1185
+ 调用方的使用约束(**安全方向**):本函数返回的水位必须在
1186
+ `read_all()` **之前**取。取在前 ⇒ 水位 ⊆ 实际被消费的记录 ⇒ 下次
1187
+ 至多重放已应用过的记录(幂等,last-wins)。取在后则可能把「尚未
1188
+ 消费的记录」也算进水位,造成**漏重放**(静默丢写入)。
1189
+ """
1190
+ out = {}
1191
+ if not os.path.isdir(directory):
1192
+ return out
1193
+ try:
1194
+ names = sorted(os.listdir(directory))
1195
+ except OSError:
1196
+ return out
1197
+ for fn in names:
1198
+ if not fn.endswith(".log"):
1199
+ continue
1200
+ p = os.path.join(directory, fn)
1201
+ try:
1202
+ size = os.stat(p).st_size
1203
+ except OSError:
1204
+ continue
1205
+ if size == 0:
1206
+ out[fn] = 0
1207
+ continue
1208
+ out[fn] = _last_newline_boundary(p, size)
1209
+ return out
1210
+
1211
+ @staticmethod
1212
+ # 生效条件:directory 为目录且 cursor 为 dict(分片文件名 -> 已消费字节水位)时,逐分片读**新增尾部**并按 (_t,_s) 排序返回 (记录列表, 新游标);游标里的分片已消失(被 compact 清走)、或某分片当前大小小于其水位(被截断/重建)时返回 (None, None) 表示**不可增量**,调用方须回退全量重放;directory 不是目录时返回 ([], {})。
1213
+ def read_tails(directory: str, cursor: dict):
1214
+ """读分片日志的**新增尾部**(issue #766 增量化:W3 读侧重载成本)。
1215
+
1216
+ 为什么必须有它:`flush()` 只 append 分片、**从不清**;只有
1217
+ `close()`→`compact_index` 才 `ShardedLog.clear`。故长期存活写方
1218
+ (MCP serve 本体即 `autoflush=1 只 flush 不 close`)的分片日志
1219
+ **只增不减**,而 `read_all` 每次都把全部记录重读重解析一遍 ⇒
1220
+ 单次重载成本随「该库写入总量」无界增长(实测 300 节点、日志
1221
+ 2000→12000 条,单次 `_load_index` 65→258 ms,斜率约 18ms/千条)。
1222
+ 增量后该成本降为 O(新增)。
1223
+
1224
+ **正确性边界(诚实声明)**:本函数只负责「读到并排序新增记录」,
1225
+ **不判**这些记录能否安全叠加上已有物化态——排序水位判定、快照
1226
+ 是否变过、盘面是否被非合作写者改过,全在调用方(`MdCG._load_index`)。
1227
+ 返回 `(None, None)` 的三类情形即「无法证明增量正确」,一律回退。
1228
+
1229
+ `read_jsonl_tail` 只认**完整行**(末行无换行属未提交,留在水位内
1230
+ 下次再读),故并发写者正写到一半时不会读到半截 JSON,也不会把
1231
+ 水位推过它——与 `append_jsonl` 的 ends_mid_line 同一防线。
1232
+ """
1233
+ if not os.path.isdir(directory):
1234
+ return [], {}
1235
+
1236
+ def _norm(v):
1237
+ return v if (isinstance(v, (int, float)) and v == v) else 0
1238
+
1239
+ try:
1240
+ names = sorted(os.listdir(directory))
1241
+ except OSError:
1242
+ return None, None
1243
+
1244
+ present = set()
1245
+ recs, new_cursor = [], {}
1246
+ for fn in names:
1247
+ if not fn.endswith(".log"):
1248
+ continue
1249
+ present.add(fn)
1250
+ p = os.path.join(directory, fn)
1251
+ try:
1252
+ size = os.stat(p).st_size
1253
+ except OSError:
1254
+ continue # delete-pending:视同消失,交由下面的校验判
1255
+ off = cursor.get(fn, 0)
1256
+ if size < off:
1257
+ # 分片被截断/重建:水位之后的内容已不可信,全量重放
1258
+ return None, None
1259
+ if size == off:
1260
+ new_cursor[fn] = off
1261
+ continue
1262
+ batch, nxt = read_jsonl_tail(p, off)
1263
+ if nxt is None:
1264
+ return None, None
1265
+ new_cursor[fn] = nxt
1266
+ recs.extend(batch)
1267
+
1268
+ # 游标里记着、盘上已没有的分片:只可能是 compact 清走了(记录已并入
1269
+ # 快照)⇒ 快照必已重写、物化态作废,不可增量。
1270
+ if set(cursor) - present:
1271
+ return None, None
1272
+
1273
+ bad = [r for r in recs if not isinstance(r, dict)]
1274
+ if bad:
1275
+ note_nonobject_rows([(directory, 0, r) for r in bad])
1276
+ recs = [r for r in recs if isinstance(r, dict)]
1277
+ recs.sort(key=lambda r: (_norm(r.get("_t", 0)), _norm(r.get("_s", 0))))
1278
+ return recs, new_cursor
1279
+
1145
1280
  @staticmethod
1146
1281
  # 生效条件:directory 是目录时,遍历 os.listdir(directory),对以 ".log" 结尾且不满足「keep 为真值且 os.path.abspath(p) == keep」的条目调用 os.remove(keep 为 None/空串等假值时该排除条件恒不成立,所有 ".log" 条目都会被删),删除时的 OSError 被忽略;directory 不是目录时直接返回。
1147
1282
  def clear(directory: str, keep: str = None):
@@ -0,0 +1,23 @@
1
+ # -*- coding: utf-8 -*-
2
+ """灵枢 1.0 治理层(govern)——W1 骨架,无实现。
3
+
4
+ 真源:docs/architecture/灵枢1.0_建设路线_v0.1.md §2 / §5 M4。
5
+
6
+ 治理层职责(路线稿 §2):
7
+ 生命周期四档 · 审计台账 · 回滚/2PC · 资格判定(DEFER/BLINDSPOT)
8
+
9
+ **本包为 W1 骨架(M1)**:只放类型与协议。M4 才把 revise/retire/rollback
10
+ 真正切换过来;届时 `rollback` 必须**覆盖正文**——该能力已由
11
+ `md_cg/rollback.py` 实现(`method=preimage`,逐字节回前像),M4 的验收是
12
+ **回归保持全绿**,不是重新实现(详见路线稿 §4 注)。
13
+
14
+ 与内核层的关系:治理层可依赖内核层;内核层**不得**反向依赖本包。
15
+ 打分层不得输出 ``state``(#111 既定契约)——`state` 只由治理层给出。
16
+ """
17
+
18
+ __all__ = ["GOVERN_LAYER", "LIFECYCLE_STATES"]
19
+
20
+ GOVERN_LAYER = "govern"
21
+
22
+ #: 生命周期四档(路线稿 §2 的「生命周期四档」;具体语义在 M4 落定)。
23
+ LIFECYCLE_STATES = ("active", "dormant", "retired", "tombstoned")
@@ -0,0 +1,46 @@
1
+ # -*- coding: utf-8 -*-
2
+ """灵枢 1.0 接口层(iface)——四个契约的唯一出口。
3
+
4
+ 真源:docs/architecture/灵枢1.0_建设路线_v0.1.md §3。
5
+
6
+ 适配层(dsh 插件 / MCP server / hive worker)**只允许**从本包导入契约类型;
7
+ 不得直接 import 内核层或治理层的实现模块(路线稿 §2 禁止项)。
8
+ """
9
+
10
+ from .contracts import (
11
+ CONTRACT_NAMES,
12
+ IFACE_LAYER,
13
+ ContractViolation,
14
+ GovernContract,
15
+ ReadContract,
16
+ ReadItem,
17
+ ReadRequest,
18
+ RecordState,
19
+ SelfCheckContract,
20
+ SelfCheckReport,
21
+ WriteContract,
22
+ WriteReceipt,
23
+ WriteRequest,
24
+ reject_state_in_scoring,
25
+ require_provenance,
26
+ require_why,
27
+ )
28
+
29
+ __all__ = [
30
+ "CONTRACT_NAMES",
31
+ "IFACE_LAYER",
32
+ "ContractViolation",
33
+ "WriteContract",
34
+ "ReadContract",
35
+ "GovernContract",
36
+ "SelfCheckContract",
37
+ "WriteRequest",
38
+ "WriteReceipt",
39
+ "ReadRequest",
40
+ "ReadItem",
41
+ "SelfCheckReport",
42
+ "RecordState",
43
+ "require_provenance",
44
+ "require_why",
45
+ "reject_state_in_scoring",
46
+ ]