@furongjun1999/dsh-memory 0.8.1 → 0.9.6
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.
- package/README.md +662 -659
- package/codebuddy/README.md +1 -1
- package/data/policy.json +17 -6
- package/docs/README.md +18 -2
- package/docs/discipline/harnesses.yaml +1 -1
- package/docs/discipline/templates/spec.txt.tmpl +23 -0
- package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
- package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
- package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
- package/dsh/README.md +1 -1
- package/dsh/cordis.yml.example +1 -1
- package/hive/README.md +705 -0
- package/hive/id_charset_blocks.txt +147 -0
- package/lib/bridge.d.ts +3 -0
- package/lib/bridge.js +32 -11
- package/lib/cli.js +14 -17
- package/lib/hooks.d.ts +18 -3
- package/lib/hooks.js +147 -18
- package/lib/index.d.ts +2 -2
- package/lib/index.js +18 -4
- package/lib/init.js +21 -21
- package/lib/lib/datapath.d.ts +56 -0
- package/lib/lib/datapath.js +102 -9
- package/lib/lib/hook_audit.d.ts +0 -1
- package/lib/lib/hook_audit.js +13 -1
- package/lib/lib/mdcg_client.d.ts +4 -1
- package/lib/lib/mdcg_client.js +10 -2
- package/lib/lib/mutual.js +61 -15
- package/lib/lib/prompt_safety.js +16 -1
- package/lib/lib/roleplay_web.js +30 -2
- package/lib/lib/token_store.d.ts +25 -6
- package/lib/lib/token_store.js +224 -33
- package/lib/tools.d.ts +8 -2
- package/lib/tools.js +22 -3
- package/md_cg/_guard_kit.py +121 -0
- package/md_cg/admission.py +718 -718
- package/md_cg/anchor.py +114 -0
- package/md_cg/audit.py +22 -5
- package/md_cg/autonomy.py +433 -288
- package/md_cg/autonomy_modes.py +781 -642
- package/md_cg/bench_beir_bm25.py +154 -0
- package/md_cg/bench_beir_scifact.py +170 -0
- package/md_cg/bench_bm25_blockmax.py +134 -0
- package/md_cg/bench_bm25_incremental.py +246 -0
- package/md_cg/bench_ccg_heading.py +118 -0
- package/md_cg/bench_csre_correctness.py +145 -0
- package/md_cg/bench_excerpt_budget.py +94 -0
- package/md_cg/bench_fuzzy_substrings.py +299 -0
- package/md_cg/bench_memory_rsi.py +358 -0
- package/md_cg/bench_memory_rsi_latency.py +82 -0
- package/md_cg/bench_memory_rsi_public.py +116 -0
- package/md_cg/bench_memory_rsi_tools.py +229 -0
- package/md_cg/bench_rrf_candidates.py +212 -0
- package/md_cg/bench_rrf_public.py +100 -0
- package/md_cg/bench_text_projections.py +221 -0
- package/md_cg/bench_timeanchor.py +357 -0
- package/md_cg/bm25.py +601 -0
- package/md_cg/branches.py +404 -327
- package/md_cg/build_postings.py +74 -73
- package/md_cg/ccgc.py +4 -2
- package/md_cg/chain.py +572 -379
- package/md_cg/coldverify.py +531 -292
- package/md_cg/condaccept.py +263 -0
- package/md_cg/condgate.py +308 -0
- package/md_cg/config_registry.py +329 -0
- package/md_cg/config_registry_bulk.py +482 -0
- package/md_cg/config_registry_guard.py +487 -0
- package/md_cg/config_render.py +354 -0
- package/md_cg/config_validate.py +455 -0
- package/md_cg/conformance.py +21 -0
- package/md_cg/conformance_core.py +753 -0
- package/md_cg/consistency.py +1278 -955
- package/md_cg/consolidate.py +180 -20
- package/md_cg/crypto.py +794 -472
- package/md_cg/datapath.py +137 -12
- package/md_cg/eval_common.py +522 -575
- package/md_cg/evidence.py +946 -585
- package/md_cg/evidence_delivery.py +101 -0
- package/md_cg/experience_consolidation.py +317 -0
- package/md_cg/export.py +329 -222
- package/md_cg/forgetting.py +1050 -922
- package/md_cg/freshness.py +601 -548
- package/md_cg/fsutil.py +1120 -824
- package/md_cg/goal_gen.py +458 -0
- package/md_cg/hotcache.py +107 -9
- package/md_cg/hyperedge.py +14 -3
- package/md_cg/identity.py +573 -391
- package/md_cg/imgskill.py +1712 -0
- package/md_cg/insight.py +540 -521
- package/md_cg/interface_schema.py +146 -0
- package/md_cg/interop.py +20 -0
- package/md_cg/judgment_manifest.py +24 -1
- package/md_cg/lifecycle.py +86 -5
- package/md_cg/links.py +27 -6
- package/md_cg/logref.py +332 -327
- package/md_cg/mcp_server.py +5227 -4449
- package/md_cg/mdcg.py +1301 -203
- package/md_cg/mdcos.py +7104 -5440
- package/md_cg/memory_rsi.py +308 -0
- package/md_cg/metacognition.py +726 -591
- package/md_cg/nodefile.py +151 -3
- package/md_cg/op_table.py +1128 -0
- package/md_cg/postings.py +524 -300
- package/md_cg/predict.py +4 -1
- package/md_cg/probe_memory_rsi.py +95 -0
- package/md_cg/probe_memory_rsi_mcp.py +66 -0
- package/md_cg/protect.py +188 -28
- package/md_cg/protocol.py +492 -411
- package/md_cg/provenance.py +7 -1
- package/md_cg/qmd.py +477 -0
- package/md_cg/qmd_llm.py +334 -0
- package/md_cg/query_excerpt.py +171 -0
- package/md_cg/queue_health.py +130 -0
- package/md_cg/reach.py +470 -453
- package/md_cg/readcache.py +115 -3
- package/md_cg/reconcile.py +239 -228
- package/md_cg/refindex.py +1191 -1042
- package/md_cg/refine.py +12 -3
- package/md_cg/retrieve.py +128 -0
- package/md_cg/review_cli.py +204 -26
- package/md_cg/revise.py +140 -0
- package/md_cg/rollback.py +256 -19
- package/md_cg/rollback_cli.py +21 -1
- package/md_cg/rotate.py +347 -0
- package/md_cg/routing.py +62 -1
- package/md_cg/rrf_candidates.py +204 -0
- package/md_cg/run_tests.py +19 -1
- package/md_cg/scrub.py +177 -23
- package/md_cg/security.py +269 -17
- package/md_cg/self_state.py +1053 -1029
- package/md_cg/self_surface.py +50 -0
- package/md_cg/semantic/canonical.py +1 -1
- package/md_cg/semantic/export_en_zh_map.py +2 -2
- package/md_cg/semantic/zh_en_atoms.py +2 -0
- package/md_cg/session5.py +106 -0
- package/md_cg/signer.py +76 -2
- package/md_cg/sleep.py +1779 -1583
- package/md_cg/sources.py +273 -15
- package/md_cg/state_events.py +75 -10
- package/md_cg/state_slots.py +312 -221
- package/md_cg/stg.py +82 -16
- package/md_cg/stgidx.py +537 -281
- package/md_cg/subgraph.py +851 -729
- package/md_cg/sustain.py +458 -19
- package/md_cg/task_memory.py +367 -0
- package/md_cg/test_action_derive.py +210 -203
- package/md_cg/test_audit_heartbeat_20261015.py +417 -0
- package/md_cg/test_audit_protection_20261015.py +483 -0
- package/md_cg/test_audit_rotate_parity.py +280 -0
- package/md_cg/test_audit_state_20261015.py +253 -0
- package/md_cg/test_audit_write_20261015.py +161 -0
- package/md_cg/test_auto_defaults.py +43 -4
- package/md_cg/test_autonomy_emotion.py +328 -0
- package/md_cg/test_autonomy_modes.py +43 -3
- package/md_cg/test_b1_foreign_read.py +245 -0
- package/md_cg/test_bm25.py +438 -0
- package/md_cg/test_bm25_hydration_refill.py +265 -0
- package/md_cg/test_bm25_incremental.py +241 -0
- package/md_cg/test_bm25_incremental_mutations.py +160 -0
- package/md_cg/test_bm25_mutations.py +205 -0
- package/md_cg/test_bm25_pool_view.py +196 -0
- package/md_cg/test_boot_openblas_guard.py +218 -197
- package/md_cg/test_boundary_hit.py +1 -1
- package/md_cg/test_branches_sensitivity.py +375 -0
- package/md_cg/test_c8_search_rrf_gates.py +1 -1
- package/md_cg/test_canonical_timezones.py +211 -0
- package/md_cg/test_ccg_heading_parser.py +73 -0
- package/md_cg/test_chain_best_first.py +403 -0
- package/md_cg/test_chain_candidate_scope.py +227 -0
- package/md_cg/test_cn_recall_grams.py +206 -0
- package/md_cg/test_coldverify_drain.py +127 -0
- package/md_cg/test_condaccept.py +156 -0
- package/md_cg/test_condgate.py +141 -0
- package/md_cg/test_config_registry.py +55 -0
- package/md_cg/test_crypto_rotate.py +257 -0
- package/md_cg/test_csre_correctness.py +297 -0
- package/md_cg/test_csre_index_import_guard.py +161 -0
- package/md_cg/test_csre_mutations.py +34 -0
- package/md_cg/test_csre_session.py +69 -0
- package/md_cg/test_curiosity_budget.py +468 -0
- package/md_cg/test_d17_autostart_toolface.py +453 -0
- package/md_cg/test_datapath_tilde_home.py +271 -0
- package/md_cg/test_derived_cache_generations.py +256 -0
- package/md_cg/test_evidence_delivery_compact.py +54 -0
- package/md_cg/test_exact_text_cache.py +191 -0
- package/md_cg/test_excerpt_budget.py +188 -0
- package/md_cg/test_experience_consolidation.py +112 -0
- package/md_cg/test_export_default_collision.py +138 -0
- package/md_cg/test_export_snapshots.py +322 -0
- package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
- package/md_cg/test_gain_gate.py +16 -5
- package/md_cg/test_goal_gen.py +355 -0
- package/md_cg/test_h2_session_view_norm.py +251 -233
- package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
- package/md_cg/test_heartbeat_ledger.py +557 -0
- package/md_cg/test_hierarchy_audit_graph.py +237 -0
- package/md_cg/test_i50c_meta_passthrough.py +628 -608
- package/md_cg/test_i50e_readside_protection.py +6 -4
- package/md_cg/test_identity_attribution.py +96 -2
- package/md_cg/test_identity_contract.py +329 -0
- package/md_cg/test_imgskill.py +1444 -0
- package/md_cg/test_index_snapshot_shape.py +240 -0
- package/md_cg/test_interop_judgment.py +258 -228
- package/md_cg/test_issue111_gate_order.py +77 -0
- package/md_cg/test_issue111_scoring_contract.py +87 -0
- package/md_cg/test_issue121_calibration_bounds.py +293 -0
- package/md_cg/test_issue128_session_env_authority.py +246 -0
- package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
- package/md_cg/test_issue131_postings_content_staleness.py +424 -0
- package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
- package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
- package/md_cg/test_issue147_pack_id_escape.py +378 -0
- package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
- package/md_cg/test_issue149_accel_default_face.py +249 -0
- package/md_cg/test_issue150_empty_query_terms.py +328 -0
- package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
- package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
- package/md_cg/test_issue152_sealed_postings.py +309 -0
- package/md_cg/test_issue152b_decrypt_cache.py +218 -0
- package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
- package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
- package/md_cg/test_issue157b_index_remainder.py +344 -0
- package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
- package/md_cg/test_issue190_tidy_idempotent.py +806 -0
- package/md_cg/test_issue191_import_trust.py +382 -0
- package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
- package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
- package/md_cg/test_issue193_write_scope.py +378 -0
- package/md_cg/test_issue197_rank_credibility_property.py +201 -0
- package/md_cg/test_issue211_export_target.py +325 -0
- package/md_cg/test_issue212_writeface_gaps.py +349 -0
- package/md_cg/test_issue214_reject_sensitivity.py +267 -0
- package/md_cg/test_issue215_condition_source_gap.py +272 -0
- package/md_cg/test_issue216_clash_routes.py +214 -0
- package/md_cg/test_issue217_slot_routes.py +248 -0
- package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
- package/md_cg/test_issue225_consistency_torn_log.py +433 -0
- package/md_cg/test_issue245_swarm_traversal.py +366 -0
- package/md_cg/test_issue258_pack_sensitivity.py +468 -0
- package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
- package/md_cg/test_issue274_read_node_id_none.py +341 -0
- package/md_cg/test_issue275_layer_param.py +250 -0
- package/md_cg/test_issue277_node_id_traversal.py +384 -0
- package/md_cg/test_issue278_neg_separated_tension.py +271 -0
- package/md_cg/test_issue278_neg_window.py +294 -0
- package/md_cg/test_issue278_negative_layering.py +83 -0
- package/md_cg/test_issue279_signers_path_guard.py +652 -0
- package/md_cg/test_issue284_skip_not_pass.py +291 -0
- package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
- package/md_cg/test_issue295_sleep_root_binding.py +589 -0
- package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
- package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
- package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
- package/md_cg/test_issue303_design_boundaries.py +262 -0
- package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
- package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
- package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
- package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
- package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
- package/md_cg/test_issue321_mcp_deep_json.py +305 -0
- package/md_cg/test_issue322_node_write_lock.py +727 -0
- package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
- package/md_cg/test_issue324_write_size_fields.py +215 -0
- package/md_cg/test_issue325_audit_poison.py +230 -0
- package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
- package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
- package/md_cg/test_issue326_key_perms.py +355 -0
- package/md_cg/test_issue326_twin_parser_parity.py +323 -0
- package/md_cg/test_issue326_vm_call_frame.py +569 -0
- package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
- package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
- package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
- package/md_cg/test_issue348_insight_verify_op.py +200 -0
- package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
- package/md_cg/test_issue350_casefold_collision.py +236 -0
- package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
- package/md_cg/test_issue352_imgaudit.py +418 -0
- package/md_cg/test_issue352_pathsjson.py +537 -0
- package/md_cg/test_issue352_refindex.py +412 -0
- package/md_cg/test_issue352_rollback.py +604 -0
- package/md_cg/test_issue352_vstateinherit.py +196 -0
- package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
- package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
- package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
- package/md_cg/test_issue354_rust_index_containment.py +571 -0
- package/md_cg/test_issue354_rust_wal_containment.py +606 -0
- package/md_cg/test_issue358_truncation_observable.py +247 -0
- package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
- package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
- package/md_cg/test_issue362_neg_condition.py +468 -0
- package/md_cg/test_issue363_lexical_idf.py +275 -0
- package/md_cg/test_issue370_readcache_assembly.py +488 -0
- package/md_cg/test_issue375_state_slot_retire.py +325 -0
- package/md_cg/test_issue376_heartbeat_failed.py +293 -0
- package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
- package/md_cg/test_issue378_protected_floor.py +310 -0
- package/md_cg/test_issue383_state_event_write_gate.py +462 -0
- package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
- package/md_cg/test_issue398_toolface_op_parity.py +511 -0
- package/md_cg/test_issue399_hive_json_shape.py +317 -0
- package/md_cg/test_issue400_hive_dirty_args.py +450 -0
- package/md_cg/test_issue401_wisdom_codegen.py +295 -0
- package/md_cg/test_issue404_heal_receipt.py +390 -0
- package/md_cg/test_issue405_git_pathspec.py +333 -0
- package/md_cg/test_issue408_eface_registry.py +291 -0
- package/md_cg/test_issue409_compact_index_completeness.py +509 -0
- package/md_cg/test_issue410_verify_demote_write.py +366 -0
- package/md_cg/test_issue411_scrub_idempotence.py +575 -0
- package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
- package/md_cg/test_issue413_preimage_failclosed.py +239 -0
- package/md_cg/test_issue413_preimage_twin.py +340 -0
- package/md_cg/test_issue414_write_args_parity.py +613 -0
- package/md_cg/test_issue415_deps_gate_probe.py +358 -0
- package/md_cg/test_issue416_entry_key_subset.py +525 -0
- package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
- package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
- package/md_cg/test_issue418_role_type_gate.py +265 -0
- package/md_cg/test_issue419_pii_redaction.py +642 -0
- package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
- package/md_cg/test_issue425_ingest_library_path.py +331 -0
- package/md_cg/test_issue426a_dedup_receipt.py +242 -0
- package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
- package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
- package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
- package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
- package/md_cg/test_issue427_serve_status_shape.py +191 -0
- package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
- package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
- package/md_cg/test_issue434_435_float_gate.py +90 -0
- package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
- package/md_cg/test_issue43_default_policy.py +13 -4
- package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
- package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
- package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
- package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
- package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
- package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
- package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
- package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
- package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
- package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
- package/md_cg/test_issue451_audit_actor.py +313 -0
- package/md_cg/test_issue452_ingest_root_hint.py +238 -0
- package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
- package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
- package/md_cg/test_issue466_basis_registry.py +469 -0
- package/md_cg/test_issue467_identity_sensitivity.py +204 -0
- package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
- package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
- package/md_cg/test_issue470_wal_event_durable.py +427 -0
- package/md_cg/test_issue471_identity_readable.py +137 -0
- package/md_cg/test_issue472_audit_chain.py +91 -0
- package/md_cg/test_issue472_prune_ledger.py +106 -0
- package/md_cg/test_issue472_rollback_degraded.py +82 -0
- package/md_cg/test_issue491_compose_sandbox.py +460 -0
- package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
- package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
- package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
- package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
- package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
- package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
- package/md_cg/test_issue525_read_null_semantics.py +52 -0
- package/md_cg/test_issue538_hook_condition_space.py +97 -0
- package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
- package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
- package/md_cg/test_issue542_tenant_root_same.py +153 -0
- package/md_cg/test_issue543_issue_authorization.py +147 -0
- package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
- package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
- package/md_cg/test_issue546_ledger_concurrency.py +81 -0
- package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
- package/md_cg/test_issue547_audit_durable.py +96 -0
- package/md_cg/test_issue549_durable_append.py +143 -0
- package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
- package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
- package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
- package/md_cg/test_issue559_refine_prefix.py +70 -0
- package/md_cg/test_issue561_pending_review.py +109 -0
- package/md_cg/test_issue66_scrub_semantics.py +107 -0
- package/md_cg/test_issue67_scrub_control_pool.py +233 -0
- package/md_cg/test_issue69_audit_boundary.py +129 -0
- package/md_cg/test_issue71_queue_backlog.py +377 -0
- package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
- package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
- package/md_cg/test_issue75_neural_failure.py +582 -0
- package/md_cg/test_issue78_export_concurrency.py +334 -0
- package/md_cg/test_issue80_residual_flush.py +169 -0
- package/md_cg/test_issue82_credential_rules.py +271 -0
- package/md_cg/test_issue82_layer_and_size.py +120 -0
- package/md_cg/test_issue84_portability.py +95 -0
- package/md_cg/test_issue85_export_overwrite.py +113 -0
- package/md_cg/test_issue86_runtime_revoke.py +110 -0
- package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
- package/md_cg/test_issue88_conclusion_face.py +280 -0
- package/md_cg/test_issue88_execution_conflicts.py +87 -0
- package/md_cg/test_issue89_zero_score.py +169 -0
- package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
- package/md_cg/test_issue91_verifier_sandbox.py +314 -0
- package/md_cg/test_issue91_verifier_timeout.py +528 -0
- package/md_cg/test_issue93_remember_redaction.py +282 -0
- package/md_cg/test_issue96_key_fallback.py +102 -0
- package/md_cg/test_issue98_tenant_root.py +104 -0
- package/md_cg/test_jsonl_commit_watermark.py +221 -0
- package/md_cg/test_live_validity_cache.py +256 -0
- package/md_cg/test_logref.py +32 -0
- package/md_cg/test_mcp_call_argument_types.py +99 -0
- package/md_cg/test_md_access_parity.py +80 -5
- package/md_cg/test_md_cg_no_hive_dep.py +140 -0
- package/md_cg/test_memory_rsi.py +215 -0
- package/md_cg/test_memory_rsi_adversarial.py +91 -0
- package/md_cg/test_mode_parity.py +1413 -1393
- package/md_cg/test_mutation_residue.py +120 -0
- package/md_cg/test_mutation_rollback.py +62 -32
- package/md_cg/test_n123_derive_expiry_chain.py +10 -5
- package/md_cg/test_n130_verify_falsified_protect.py +185 -185
- package/md_cg/test_n209_verify_write_face_gates.py +7 -2
- package/md_cg/test_n230_dirty_replay.py +52 -9
- package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
- package/md_cg/test_neg_coverage_budget.py +500 -0
- package/md_cg/test_neg_tail_honesty.py +79 -9
- package/md_cg/test_p0.py +16 -2
- package/md_cg/test_p14_root_fallback.py +373 -0
- package/md_cg/test_p1x_ref_root.py +47 -10
- package/md_cg/test_p21_tokens.py +2 -1
- package/md_cg/test_p24_evidence.py +232 -227
- package/md_cg/test_p26_refindex.py +20 -3
- package/md_cg/test_p27_docindex.py +16 -1
- package/md_cg/test_p28_refcheck.py +45 -24
- package/md_cg/test_p29_session_ingest_export.py +6 -0
- package/md_cg/test_p2_mcp.py +474 -453
- package/md_cg/test_p2_six_elements.py +14 -1
- package/md_cg/test_p3.py +370 -261
- package/md_cg/test_p33_ccg_wiring.py +9 -2
- package/md_cg/test_p3_legacy_closure.py +6 -1
- package/md_cg/test_p40_refine_worklist.py +5 -2
- package/md_cg/test_p47_session_view.py +25 -9
- package/md_cg/test_p4_freshness.py +8 -1
- package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
- package/md_cg/test_p9c_dedup_hints.py +7 -2
- package/md_cg/test_policy_required_ccg.py +12 -0
- package/md_cg/test_postings_digest_memo.py +139 -0
- package/md_cg/test_predict_beta.py +138 -135
- package/md_cg/test_qmd.py +500 -0
- package/md_cg/test_query_excerpt.py +209 -0
- package/md_cg/test_reach.py +456 -378
- package/md_cg/test_reach_snapshot_admission.py +218 -0
- package/md_cg/test_readcache_prodpath.py +4 -0
- package/md_cg/test_recall_face_guards.py +854 -812
- package/md_cg/test_recall_metadata.py +422 -0
- package/md_cg/test_retr_s5.py +104 -5
- package/md_cg/test_retr_score_once.py +14 -2
- package/md_cg/test_review_cli_attribution.py +11 -7
- package/md_cg/test_review_queue_batch.py +123 -0
- package/md_cg/test_review_queue_index.py +130 -0
- package/md_cg/test_rrf_candidates.py +292 -0
- package/md_cg/test_rrf_qualified_topk.py +214 -0
- package/md_cg/test_rrf_unique_votes.py +218 -0
- package/md_cg/test_s1_ast_judge.py +110 -0
- package/md_cg/test_scrub_ledger.py +413 -0
- package/md_cg/test_security_audit_b26.py +34 -3
- package/md_cg/test_security_audit_v21.py +1 -2
- package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
- package/md_cg/test_session5_identity.py +93 -0
- package/md_cg/test_session_attribution_consistency.py +813 -0
- package/md_cg/test_session_identity_tristate.py +486 -0
- package/md_cg/test_sleep_p1.py +35 -3
- package/md_cg/test_state_event_op.py +8 -1
- package/md_cg/test_state_projection_streaming.py +136 -0
- package/md_cg/test_stg_interval_candidates.py +280 -0
- package/md_cg/test_stg_time_blocks.py +239 -0
- package/md_cg/test_stgidx_index_parity.py +16 -12
- package/md_cg/test_subgraph_bounded_bfs.py +227 -0
- package/md_cg/test_sustain_bounded.py +30 -2
- package/md_cg/test_task_memory.py +394 -0
- package/md_cg/test_text_projection_mutations.py +101 -0
- package/md_cg/test_time_anchor.py +421 -0
- package/md_cg/test_time_core_lint.py +1024 -975
- package/md_cg/test_tool_face.py +200 -189
- package/md_cg/test_trust_bounded_frontier.py +248 -0
- package/md_cg/test_trust_edge_reachability.py +405 -0
- package/md_cg/test_w5_path_fingerprint.py +381 -0
- package/md_cg/test_w7_redlines.py +659 -0
- package/md_cg/test_write_return_shape.py +919 -0
- package/md_cg/test_writepipe.py +5 -3
- package/md_cg/timeanchor.py +534 -0
- package/md_cg/tokens.py +68 -5
- package/md_cg/tool_face.py +273 -260
- package/md_cg/trust.py +110 -26
- package/md_cg/twophase.py +74 -2
- package/md_cg/weights.py +642 -638
- package/md_cg/whitebox.py +9 -0
- package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
- package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
- package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
- package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
- package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
- package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
- package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
- package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
- package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
- package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
- package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
- package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
- package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
- package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
- package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
- package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
- package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
- package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
- package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
- package/md_cg/writelimit.py +584 -390
- package/md_cg/writepipe.py +587 -76
- package/package.json +13 -9
- package/src/bridge.ts +34 -11
- package/src/cli.ts +75 -65
- package/src/hooks.ts +908 -776
- package/src/index.ts +19 -5
- package/src/init.ts +362 -361
- package/src/lib/datapath.ts +419 -326
- package/src/lib/hook_audit.ts +256 -243
- package/src/lib/mdcg_client.ts +10 -2
- package/src/lib/mutual.ts +481 -432
- package/src/lib/prompt_safety.ts +164 -149
- package/src/lib/roleplay_web.ts +30 -2
- package/src/lib/token_store.ts +274 -52
- package/src/tools.ts +249 -223
- package/zcode/README.md +1 -1
- package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
- package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
- package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
- package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
- package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
- package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
- package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
- package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
- package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
- package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
- package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
- package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
- package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
- package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
- package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
- package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
- package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
- package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
- package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
- package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
- package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
- package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
- package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
- package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
- package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
- package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
- package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
- package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
- package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
- package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
- package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
- package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
- package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
- package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
- package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
- package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
- package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
- package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
- package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
- package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
- package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
- package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
- package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
- package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
- package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
- package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
- package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
- package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
- package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
- package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
- package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
- package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
- package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
- package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
- package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
- package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
- package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
- package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
- package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
- package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
- package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
- package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
- package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
- package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
- package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
- package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
- package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
- package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
- package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
- package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
- package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
- package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
- package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
- package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
- package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
- package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
- package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
- package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
- package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
- package/docs/mdcg/guardrail-charter.md +0 -164
- package/docs/mdcg/lingshu_tutorial.html +0 -14956
- package/docs/mdcg/memory-assessment.html +0 -923
- package/docs/mdcg/memory_score.html +0 -213
- package/docs/mdcg/memory_score.png +0 -0
- package/docs/mdcg/release_v0.3.0.md +0 -36
- package/docs/mdcg/release_v0.4.11.md +0 -49
- package/docs/mdcg/release_v0.4.5.md +0 -55
- package/docs/mdcg/tool_table_v0.3.0.md +0 -117
- package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
- package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
- package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
- package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
- package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
- package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
- package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
- package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
- package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
- package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
- package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
- package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
- package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
- package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
- package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
- package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
- package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
- package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
- package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
- package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
- package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
- package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
- package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
- package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
- package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
- package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
- package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
- package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
- package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
- package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
- package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
- package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
- package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
- package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
- package/docs/promo/bilibili-cover.jpg +0 -0
- package/docs/promo/promo-visual-1.png +0 -0
- package/docs/promo/promo-visual-2.png +0 -0
- package/docs/promo/promo-visual-3.png +0 -0
- package/docs/promo/promo-visual-4.png +0 -0
- package/docs/promo/promo-visual-5.png +0 -0
- package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
- package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
- package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
- package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
- package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
- package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
- package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
- package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
- package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
- package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
- package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
- package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
- package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
- package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
- package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
- package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
- package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
- package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
- package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
- package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
- package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
- package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
- package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
- package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
- package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
- package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
- package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
- package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
- package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
|
@@ -1,384 +0,0 @@
|
|
|
1
|
-
# 世界模型功能端 · 使用与运维指南(v1.0)
|
|
2
|
-
|
|
3
|
-
> **这一页回答一件事:语义时空图「状态层」上线后,你怎么记账、怎么查、开关在哪、怎么复跑读数、边界到哪。**
|
|
4
|
-
> 依据:`docs/plans/语义时空图补全_世界模型功能端_设计_v0.1.md`(六签收点)与 `docs/秤_记忆系统评测规范_v2.1.md` §5.1(账本完整性口径)。
|
|
5
|
-
> 使用者定位(2026-10-06):「0.7.4 把世界模型,也就是语义时空图的地基打好。」本页对应 P3 批(写侧入口 + 账本完整性探针 + 使用文档)。
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## 一、一句话
|
|
10
|
-
|
|
11
|
-
**事件是源、槽位是投影、查询走 stg**:
|
|
12
|
-
|
|
13
|
-
```
|
|
14
|
-
记账(写口) 台账(源) 投影(物化视图,查询时现算) 查询面
|
|
15
|
-
cg(op=state_event) → <root>/_state_events.jsonl → md_cg/state_slots.py → stg(op=state_chain)
|
|
16
|
-
(MCP 面) append-only、不截断 (只读台账、不落盘、不缓存) (默认关)
|
|
17
|
-
↘ CLI:python -m md_cg.state_slots
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
四个面各有单点真源,互不复制:写口只做权限/归一/落盘(`md_cg/mcp_server.py`),
|
|
21
|
-
台账只管追加(`md_cg/state_events.py`),投影只管回放(`md_cg/state_slots.py`),
|
|
22
|
-
查询面只管开关与返回体成形(`md_cg/stg.py`)。
|
|
23
|
-
|
|
24
|
-
---
|
|
25
|
-
|
|
26
|
-
## 二、台账(源)在哪、长什么样
|
|
27
|
-
|
|
28
|
-
| 项 | 内容 |
|
|
29
|
-
|---|---|
|
|
30
|
-
| 位置 | 库根下 `_state_events.jsonl`(与 `_recent.jsonl`、`_write_2pc.jsonl` 同级) |
|
|
31
|
-
| 性质 | **append-only**:只追加、不读改写、不截断(窗口滚动面 `_recent.jsonl` 不可作一等记录,故单立此账) |
|
|
32
|
-
| 一行一条 | `{t, subject, slot, old, new, kind, seq, evidence, actor}` |
|
|
33
|
-
| `kind` 五类 | `migration` 迁移 / `retraction` 撤回 / `enablement` 启用 / `acquisition` 获得 / `replacement` 替换;**未分类(None)合法** |
|
|
34
|
-
| 撤回语义 | `old` 有值、`new` 空 = 值作废、无新值;启用=old 空、new 有值;迁移/替换=皆有值 |
|
|
35
|
-
| 坏行 | 容忍 ≠ 静默:跳过时计数 + 有界样本 + stderr 告警(`state_events.BAD_ROWS` 可读) |
|
|
36
|
-
| 多进程 | 跨进程文件锁(`FileLock`),崩溃不留半截文件(flush+fsync) |
|
|
37
|
-
|
|
38
|
-
**记账不判语义**:`kind` 只是检索面标签,不进判据;「不是事实」的言语(玩笑/元层/回忆转述)
|
|
39
|
-
之消歧标记(`not_fact`)**不在本批**(见 §八 边界)。
|
|
40
|
-
|
|
41
|
-
---
|
|
42
|
-
|
|
43
|
-
## 三、写:MCP 记账口 `cg(op=state_event)`
|
|
44
|
-
|
|
45
|
-
### 用法
|
|
46
|
-
|
|
47
|
-
```
|
|
48
|
-
cg(op="state_event", subject="鲸娘", slot="住所",
|
|
49
|
-
old="别墅", new="小屋", kind="migration", seq=1108, evidence="r1108")
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
| 参数 | 必填 | 说明 |
|
|
53
|
-
|---|---|---|
|
|
54
|
-
| `subject` | 是 | 事件主体(谁的状态);去空白后为空即报错 |
|
|
55
|
-
| `slot` | 是 | 事件槽位(哪项状态);同上 |
|
|
56
|
-
| `old` / `new` | 至少一个 | 变更前/后值;**双空非法**(空事件无意义)。撤回=`new` 留空 |
|
|
57
|
-
| `kind` | 否 | 五类之一;缺省/空串/纯空白 → 归一为「未分类」(None);其它值报错 |
|
|
58
|
-
| `seq` | 否 | 轮或序号(回指语料位置用) |
|
|
59
|
-
| `evidence` | 否 | 出处(短证/轮号/文件路径皆可,回查用) |
|
|
60
|
-
|
|
61
|
-
返回体:`{"ok": true, "event": {…落盘记录…}}`(`event` 即 append 落盘的那一行)。
|
|
62
|
-
|
|
63
|
-
### 失败口径(fail-closed,不吞)
|
|
64
|
-
|
|
65
|
-
| 情形 | 结果 |
|
|
66
|
-
|---|---|
|
|
67
|
-
| 缺/空 `subject`、缺/空 `slot` | `ValueError`(点名缺哪项) |
|
|
68
|
-
| `old` 与 `new` 双空 | `ValueError` |
|
|
69
|
-
| `kind` 非法值 | `ValueError`(列出允许五类) |
|
|
70
|
-
|
|
71
|
-
以上都是**原样上抛**的 `ValueError`(不是包装过的错误),客户端按普通错误处置即可——
|
|
72
|
-
**失败即不落盘**。
|
|
73
|
-
|
|
74
|
-
---
|
|
75
|
-
|
|
76
|
-
## 四、读:投影与查询
|
|
77
|
-
|
|
78
|
-
### 1. 查询面 `stg(op=state_chain)`(默认关,见 §五)
|
|
79
|
-
|
|
80
|
-
```
|
|
81
|
-
stg(op="state_chain", subject="鲸娘", slot="住所", include_retired=true)
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
返回体沿 stg 既有口径:`count`(条件命中总数,截断前)/ `items`(前 limit 条)/
|
|
85
|
-
`kept` / `truncated`。单元字段:
|
|
86
|
-
|
|
87
|
-
| 字段 | 语义 |
|
|
88
|
-
|---|---|
|
|
89
|
-
| `value` | 现值(撤回后为 null,直到下一个带值事件复活) |
|
|
90
|
-
| `state` | `active` / `retired`(**退役不删除**;缺省查询剔除 retired,`include_retired=true` 可见) |
|
|
91
|
-
| `t_from` / `t_to`、`seq_from` / `seq_to` | 生效区间与序号:`*_from` =最后产生当前值的事件;`*_to` =覆盖它的下一条事件(未被覆盖=null=仍有效/未闭合) |
|
|
92
|
-
| `tier` | 来源档位(台账行顶层 `tier` 透传;未带=`unspecified`,**不编造**) |
|
|
93
|
-
| `history` | 该槽位全部事件原样七字段(`t/seq/old/new/kind/evidence/actor`);`history=false` 时不带该键 |
|
|
94
|
-
| `alternatives` / `blindspots` | 结构在场、**恒空列表**(判定口径后置,见 §八) |
|
|
95
|
-
| `event_count` | 该槽位事件条数 |
|
|
96
|
-
|
|
97
|
-
**投影是物化视图不是第二真源**:查询时从台账现算,不落盘、不缓存——台账追加一条,
|
|
98
|
-
下一次查询结果即变。
|
|
99
|
-
|
|
100
|
-
### 2. CLI 人工入口(`md_cg.state_slots`,**恒可用**)
|
|
101
|
-
|
|
102
|
-
```
|
|
103
|
-
python -X utf8 -m md_cg.state_slots --status
|
|
104
|
-
python -X utf8 -m md_cg.state_slots --subject 鲸娘 [--slot 住所] [--include-retired] [--no-history]
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
数据根取 `MDCG_ROOT`(缺省走 `datapath.mdcg_root()`)。本 CLI 与 `MDCG_STG_STATE`
|
|
108
|
-
开关**无关**——那把开关管的是 MCP 读面;CLI 是只读人工排查入口(不改任何状态)。
|
|
109
|
-
|
|
110
|
-
---
|
|
111
|
-
|
|
112
|
-
## 五、开关
|
|
113
|
-
|
|
114
|
-
| 开关 | 缺省 | 管什么 |
|
|
115
|
-
|---|---|---|
|
|
116
|
-
| `MDCG_STG_STATE` | **关** | MCP 查询面 `stg(op=state_chain)`;关臂返回 `{"error": "disabled", "hint": …}`(**不是异常**——「没开」与「没命中」必须可分辨);与 `MDCG_STG_INDEX`/`MDCG_STG_QUALIFY` 同纪律 |
|
|
117
|
-
| (无开关) | — | `cg(op=state_event)` 记账口**恒可用**(受权限闸约束,见 §六);`md_cg.state_slots` CLI **恒可用** |
|
|
118
|
-
|
|
119
|
-
---
|
|
120
|
-
|
|
121
|
-
## 六、授权口径(与既有令牌面零新词)
|
|
122
|
-
|
|
123
|
-
- **`state_event` 走 `write` 词映射**:`cg` 面 op 作用域闸按 `write` 判定——
|
|
124
|
-
凡 `ops_allow` 白名单含 `write` 的角色(或用 `"*"` 的设计者令牌)可记账;
|
|
125
|
-
guest/只读令牌照拒。令牌面**不引入新 op 词**(角色白名单与派生收窄面零改动)。
|
|
126
|
-
- **`actor` 恒取令牌**(请求参数不生效):落盘 `actor` 永远是令牌身份(无令牌形态为
|
|
127
|
-
`"system"`)——客户端不得改写归属(沿本仓既有防伪造口径)。
|
|
128
|
-
- **写闸双保险**:台账是直写盘面的 append-only 文件、**绕过库层节点写闸**,故记账口
|
|
129
|
-
另显式补齐 `require_write("internal")`——`can_write` × `theory_ok` × 密级三态各自生效
|
|
130
|
-
(只读令牌、版本层校验未过、clearance 不足 internal 都会被拒且不落盘)。
|
|
131
|
-
|
|
132
|
-
---
|
|
133
|
-
|
|
134
|
-
## 七、读数与复跑:探针 + 守卫
|
|
135
|
-
|
|
136
|
-
### 1. 账本完整性探针(《秤》5.1 口径)
|
|
137
|
-
|
|
138
|
-
```
|
|
139
|
-
python -X utf8 scripts/probe_c_ledger_integrity.py \
|
|
140
|
-
--events %TEMP%/state_events.jsonl --expect-slots 住所,房贷,名字 \
|
|
141
|
-
[--out %TEMP%/probe_c_out]
|
|
142
|
-
```
|
|
143
|
-
|
|
144
|
-
| 读数 | 口径 |
|
|
145
|
-
|---|---|
|
|
146
|
-
| ① 事件覆盖缺口率 | `--expect-slots` 清单中「台账无任何记录」的槽位占比(分子/分母都打印) |
|
|
147
|
-
| ② 无账可辨率 | 对「无记录槽位」+固定合成不存在槽位查询 `state_chain`:`count==0 且 items==[]`(**不编造、不反推**)的通过比例 |
|
|
148
|
-
| ③ 变迁史可查率 | 有记录槽位中 `state_chain`(`include_retired=True`、`history=True`)返回的 history 条数合计 == 台账该槽位记录数 的比例 |
|
|
149
|
-
|
|
150
|
-
特性(硬性):只读输入;隔离 temp root(把 `--events` 拷为该 root 的
|
|
151
|
-
`_state_events.jsonl`)——**零记忆库写入**;`--out` 必须落在仓外(fail-closed);
|
|
152
|
-
**确定性**(同输入两次运行 stdout 与 `--out` 产物字节一致);
|
|
153
|
-
stdout 末行 `PROBE_C_LEDGER_JSON {...}` 摘要(机器可读),`--out` 时另落
|
|
154
|
-
`rates.json` + `probe_c_slots.jsonl`。
|
|
155
|
-
|
|
156
|
-
### 2. 写口守卫
|
|
157
|
-
|
|
158
|
-
```
|
|
159
|
-
python -X utf8 -m md_cg.test_state_event_op # 全链/双闸/防伪造/归一/校验/回归
|
|
160
|
-
python -X utf8 -m md_cg.test_state_event_op --mutate # 定点变异自证(每条机制必须能被断言钉红)
|
|
161
|
-
```
|
|
162
|
-
|
|
163
|
-
---
|
|
164
|
-
|
|
165
|
-
## 八、边界(如实)
|
|
166
|
-
|
|
167
|
-
- `alternatives`(同期未决值)/ `blindspots`(声明缺口)判定口径**后置**:本批结构在场、
|
|
168
|
-
恒空列表,**不臆造填充**。
|
|
169
|
-
- 「不是事实」的言语(玩笑/元层/回忆转述)之**消歧标记**(`not_fact` 等)不在本批
|
|
170
|
-
(P1 事件行无该信号)。
|
|
171
|
-
- 探针只测**账本面**可辨性;**生成器级「无账强答」未测**——那需要接生成器侧读数,后置。
|
|
172
|
-
- 槽位按**标签面精确匹配**(slot 名相等),不做同义归并/模糊匹配。
|
|
173
|
-
- `state_chain` 无 `time_axis` 语义:台账事件行只有落账时间戳 `t`,无第二轴(**不伪造**);
|
|
174
|
-
需要轴语义请走 `stg` 的 timeline/relation/anchors。
|
|
175
|
-
- 单库=单台账:跨库/多租户合并不在此。
|
|
176
|
-
|
|
177
|
-
---
|
|
178
|
-
|
|
179
|
-
## 九、退役纪律:节点生命周期 `archived`(默认检索剔除)
|
|
180
|
-
|
|
181
|
-
> 《秤》v2.1 §5.2「退役纪律」口径的落地页。**先分清两个「退役」**(同名不同物):
|
|
182
|
-
|
|
183
|
-
| 说谁 | 字段 / 参数 | 谁管 |
|
|
184
|
-
|---|---|---|
|
|
185
|
-
| 台账**槽位单元**的生存态(§四) | 投影单元 `state` = `active`/`retired`,查询参数 `include_retired` | `md_cg/state_slots.py`(查询时现算) |
|
|
186
|
-
| **节点**(md 记忆条目)的归档态(本节) | frontmatter / 索引 `lifecycle_state` = `archived` | `md_cg/lifecycle.py` 状态机 + 读面剔除 |
|
|
187
|
-
|
|
188
|
-
### 1. 语义(写定,逐档可对拍)
|
|
189
|
-
|
|
190
|
-
| `lifecycle_state` | 默认读/注入面(检索面 · stg 面 · 会话续接包全段) | 说明 |
|
|
191
|
-
|---|---|---|
|
|
192
|
-
| `active`(**缺键或非法值同此**) | 参与 | fail-open:存量节点零迁移、不误剔 |
|
|
193
|
-
| `converged` | 参与 | **降权轴**(同构聚合定型),不是退役 |
|
|
194
|
-
| `demoted` | 参与 | **降权轴**(弱化),不是退役 |
|
|
195
|
-
| `archived` | **默认剔除** | 退役不删除:节点文件仍在、可显式恢复 |
|
|
196
|
-
|
|
197
|
-
### 2. 判据与落点(判据单点,三个消费面)
|
|
198
|
-
|
|
199
|
-
- 判据单点:`lifecycle.is_archived(e)`(`md_cg/lifecycle.py`)≡ `state_of(e) == "archived"`;
|
|
200
|
-
全部消费点共同引用,不各写一份口径。
|
|
201
|
-
- 消费点 ①(**cg 检索面**):`MdCGOS._candidates`(`md_cg/mdcos.py`)——**检索类** cg 读 op
|
|
202
|
-
(`route` / `read` 的检索分支与 `budget_tokens` 预算召回分支 / `search` / `search_rrf` 及其
|
|
203
|
-
内含的 lexical·bucket·entity·graph·chain·temporal 各路)都经这一个候选池;
|
|
204
|
-
`MdCGSecure._candidates` 经 `super()` 在其上叠加读可见性,判据同源。
|
|
205
|
-
注意:cg 的读 op 并非全走候选池——见消费点 ③(会话续接面自持取数面)。
|
|
206
|
-
- 消费点 ②(**stg 扫描面**):`stg._scan_one`(`md_cg/stg.py`,`_scan` 的逐条实现单点)
|
|
207
|
-
——`timeline` / `anchors` / `consistency` 三 op 的候选面同点覆盖,索引子集
|
|
208
|
-
(`MDCG_STG_INDEX=1`)与全量遍历两条分支逐位一致。`relation` 是显式 id 直读、
|
|
209
|
-
`state_chain` 走台账,两者都不经候选面(不受本节约束)。
|
|
210
|
-
- 消费点 ③(**会话续接注入面**):`MdCGOS.session_recall`(`md_cg/mdcos.py`)的
|
|
211
|
-
**四个取数段**——会话要点 `_session_notes`、活跃目标 `goals`、任务台账 `tasks`、
|
|
212
|
-
未解问题 `unresolved`(`goals`/`tasks` 经 `_retired_by_id` 按 id 回查索引后交同一
|
|
213
|
-
判据)。`cg(op=session, action=recall)` 自持取数面(不经 `_candidates`),它把节点
|
|
214
|
-
内容装配成「续接包」回给调用方/注入上下文(=注入面),故同接本判据。台账两段
|
|
215
|
-
取**全量窗**(`_LEDGER_WINDOW`)过滤后截断 `_PACK_ROWS=5` 条,故退役剔除不会让
|
|
216
|
-
包「不足额」;`tasks.active_total/done_total` 随之取**剔除后**的全窗计数(与列表
|
|
217
|
-
同源自洽)。`recent` 段是事件窗口(非节点)、`self_state` 是只读快照卡,不涉退役。
|
|
218
|
-
(独立复核 2026-10-06 两轮实测:接线前 archived 要点摘要、未解问题正文、活跃目标
|
|
219
|
-
与任务卡均经该 op 照旧回出;现由守卫 R1.12/R1.13/R3.5/R3.6/R4.6 钉住。)
|
|
220
|
-
|
|
221
|
-
### 3. 不受限面(「退役不删除」的另一半)
|
|
222
|
-
|
|
223
|
-
- `cg.get(node_id)` 直读、`cg(op=audit)` 证据审计视图:archived 期间**照常可达**;
|
|
224
|
-
- 工程台账面(`goal` / `task`)与统计面(`health` / `whoami` / conformance):直读索引,
|
|
225
|
-
不受本节约束;
|
|
226
|
-
- **生命周期恢复**:库层入口 `MdCG.set_state(node, "archived"→"active")`
|
|
227
|
-
(`md_cg/mdcg.py:2619` → `lifecycle.set_state`,走合法迁移表、逐级不跳级);恢复后
|
|
228
|
-
读面/续接面重新可见。**MCP 工具面没有独立生命周期入口**(`mcp_server.py` 全文无
|
|
229
|
-
`set_state` / `lifecycle` 字样)——「显式恢复」是库层调用面。
|
|
230
|
-
- 与 `op=restore` 的区别(易混,写明):`op=restore` 是 `op=forget` 的 `action=restore`
|
|
231
|
-
→ `cg.restore`(`md_cg/mdcos.py:3029`)=把**已遗忘**(软删除进 `trash/`)的节点放回,
|
|
232
|
-
是**删除轴**,与生命周期状态机无关;且放回时 `lifecycle_state` 按新节点(`active`)
|
|
233
|
-
起判,`active→archived` 跳级被拒 ⇒ **不透传(落 `active`)**(既有行为,本轮未改)。
|
|
234
|
-
|
|
235
|
-
### 4. 复跑读数
|
|
236
|
-
|
|
237
|
-
```
|
|
238
|
-
python -X utf8 scripts/probe_d_retirement_discipline.py # 《秤》v2.1 §5.2 探针
|
|
239
|
-
python -X utf8 -m md_cg.test_lifecycle_retire_leak # 守卫 R1–R4
|
|
240
|
-
```
|
|
241
|
-
|
|
242
|
-
| 读数(`PROBE_D_JSON`) | 口径 | 目标(面计数,括号内为比率) |
|
|
243
|
-
|---|---|---|
|
|
244
|
-
| ① 退役泄漏率 | 退役后 v2 仍出现在查证面(读面 search∪recall、时空面 timeline∪anchors)的面数 / 面数 | `0/2`(0.0) |
|
|
245
|
-
| ② 更新采纳率 | v2 写入后可见的面数 / 面数(防「一刀切全滤」的反向缺陷) | `2/2`(1.0) |
|
|
246
|
-
| ③ 旧事实残留率 | 退役步之后 v1 仍可见的面数 / 面数(不连带误剔) | `2/2`(1.0) |
|
|
247
|
-
| ④ 失效误判证伪率 | 退役节点被错误置 falsified/rejected 的条数 / 退役节点数(退役 ≠ 证伪) | `0/1`(0.0) |
|
|
248
|
-
|
|
249
|
-
(探针人读行打印的就是**面计数**「n/分母(目标 m)」;上表与它同单位,比率为换算值。)
|
|
250
|
-
|
|
251
|
-
探针特性:隔离 temp root(零在役库写入)、纯 stdlib、无随机/无时间戳、
|
|
252
|
-
`--out` 必须落在仓外(fail-closed)、末行 `PROBE_D_JSON {...}`,**两遍运行 stdout 字节一致**。
|
|
253
|
-
|
|
254
|
-
### 5. 边界(如实)
|
|
255
|
-
|
|
256
|
-
- 只剔 `archived`。要让 `converged`/`demoted` 不参与,请走既有其他维度
|
|
257
|
-
(`role` / `view` / `layer` / `session` / `validity`)——不得把它们并进退役判据。
|
|
258
|
-
- 台账单元退役(§四 `retired`)与节点退役(本节 `archived`)**各自独立、互不联动**。
|
|
259
|
-
- **面的判据(写死,供后续接线照此归类)**:**默认读/注入面**=调用方给查询/意图/会话视图,
|
|
260
|
-
**节点集合由库自选**且结果直接回给调用方或注入上下文 ⇒ 必须消费 `is_archived`;
|
|
261
|
-
**定向/管理/统计面**=调用方给出**显式节点选择键**(`node_id` / `subject:*` 标签 / 前缀 /
|
|
262
|
-
层 / 状态)或面本身是诊断·统计·写面 ⇒ 直读,不受本节约束。
|
|
263
|
-
- 已接线消费面(3 处,4 子面):检索面 `_candidates`、stg 面 `_scan_one`、会话续接注入面
|
|
264
|
-
`session_recall` 的**全部四个取数段**(要点 `_session_notes` + 活跃目标 + 任务台账 +
|
|
265
|
-
未解问题;后两段经 `_retired_by_id` 按 id 判据)(§2)。
|
|
266
|
-
- **已枚举但归入「定向/管理/统计面」(不受限,逐条申报)**:`cg.get` 直读、`op=audit`
|
|
267
|
-
证据审计、**工程台账的显式管理查询面**(`cg(op=goal, action=list)` / `cg(op=task,
|
|
268
|
-
action=list)`——直读台账,archived 期间照样列出,守卫 R1.13c 钉住这一侧)、
|
|
269
|
-
`health`/`whoami`/`_role_counts`/`_sensitivity_counts`/`conformance`/`census`/`insight`
|
|
270
|
-
统计、`review_records` 审核记录、`export`/`evidence` 导出与证据面、`crosscheck`/
|
|
271
|
-
`ghostref`/`consistency` 诊断面、`backfill*`/`writelimit`/`freshness`/`forgetting`
|
|
272
|
-
维护写面、`mreview/govern` 治理面、白箱 KB 工具面。
|
|
273
|
-
**注意别与消费点 ③ 混读**:同一份 goal/task 台账,**注入面(续接包)剔除 archived、
|
|
274
|
-
管理查询面直读**——这不是矛盾,是判据两侧的分工(守卫同时钉住两侧:R1.13b 剔除、
|
|
275
|
-
R1.13c 直读)。
|
|
276
|
-
其中**会回内容且集合由库自选**的一个代表面如实点名:`identity.profile`
|
|
277
|
-
(`md_cg/identity.py:310`,按 `subject:<id>` 标签自选并回锚点正文摘录)——实测 archived
|
|
278
|
-
锚点仍回出(取证:`identity.profile` 返回的 `anchors[0].content` 含归档节点正文标记);
|
|
279
|
-
按上条判据它属**定向面**(`subject_id` 是显式选择键,与 `cg.get` 同族),故**本轮未接线**
|
|
280
|
-
(其文件不在本轮允许改动面内)。
|
|
281
|
-
- **面的接线状态(2026-10-06 使用者裁定批落地——原「已知未覆盖面」四项处置)**:
|
|
282
|
-
- **基类 `MdCG.search` → 已接线**(`md_cg/mdcg.py` 候选条件加 `lifecycle.is_archived`
|
|
283
|
-
判据):plain `MdCG` 实例(白箱 KB / 离线脚本 / 测试)的默认检索面与生产路径
|
|
284
|
-
同口径(守卫 R5,含「converged 降权轴不误剔」对照)。
|
|
285
|
-
- **因果链/图面 `chain.adjacency` → 已接线**(新增 `skip_archived=True` 缺省参数):
|
|
286
|
-
退役节点出边整体不入表、指向退役目标的边截断——`cg(op=causal, action=chain)`、
|
|
287
|
-
`predict.*` 等读/预测面不再扩散进 archived(守卫 R6.0/R6.1/R6.4,含缓存已热
|
|
288
|
-
时归档的实测腿)。**维护面显式旁路**:`scrub` 去污染抽查传
|
|
289
|
-
`skip_archived=False` 取全量表(守卫 R6.2/R6.3 钉住旁路——面的判据分工:
|
|
290
|
-
默认读/注入面必消费、维护/管理面直读)。
|
|
291
|
-
- **缓存失效钩子(本批实证的兑现缺口)**:状态迁移改变 `is_archived` 读数,
|
|
292
|
-
而 `chain` 邻接缓存在 `set_state` 后此前**未失效**(探针实证:归档后
|
|
293
|
-
`causal_chain` 仍含目标)——现 `lifecycle.set_state` 写盘点同点调用
|
|
294
|
-
`chain.invalidate_cache`(懒导入,`invalidate_cache` 自吞异常不阻断推进)。
|
|
295
|
-
- **结构/拓扑面 `subgraph.children_index` / `parents_index` → 裁定不接**
|
|
296
|
-
(调用方给显式父/子 id、返回 id 映射不回正文,属定向/结构面,直读)——
|
|
297
|
-
守卫 R7.0/R7.1 把裁定**钉住**:子节点退役后映射仍在;未来若有人"顺手接线",
|
|
298
|
-
R7.1 转红即提醒先改裁定。
|
|
299
|
-
- **rust 检索内核 → 已接线**(`rust/src/store.rs`):`Entry` 增
|
|
300
|
-
`lifecycle_state` 字段(键名与 Python `lifecycle.STATE_FIELD` 同源)、
|
|
301
|
-
`candidates()` 剔除 `archived`(缺键/非法=active,fail-open;converged/
|
|
302
|
-
demoted 仍参与)——crate 单测 `archived_entries_excluded_from_candidates`
|
|
303
|
-
与 `lifecycle_state_parsed_from_index_json` 双钉;两侧口径一致由
|
|
304
|
-
`rank_parity` 门禁腿继续看守(评测语料无 archived,逐位零位移)。
|
|
305
|
-
- 跨进程一致性:判据只读**本进程索引条目**(`lifecycle_state` 由
|
|
306
|
-
`lifecycle._sync_index` 随迁移同步并落 `_index_log`),他进程刚归档、本进程索引
|
|
307
|
-
尚未重载的窗口内读数可能滞后(与 `lifecycle.set_state` 的既有落盘口径同源)。
|
|
308
|
-
|
|
309
|
-
---
|
|
310
|
-
|
|
311
|
-
## 十、多主体状态追踪(核心能力与常驻读取视图)
|
|
312
|
-
|
|
313
|
-
> 使用者 2026-10-06 定位:「这个功能可以常驻,维护其他角色的状态追踪,这应该要
|
|
314
|
-
> 作为语义时空图的核心功能。」
|
|
315
|
-
|
|
316
|
-
**能力陈述**:状态追踪(多主体 · 五元事件 · 槽位投影)是语义时空图的**核心功能**——
|
|
317
|
-
`subject` 参数化到任意主体(角色/机构/我),台账(`_state_events.jsonl`)为唯一真源,
|
|
318
|
-
其余全为投影/视图。
|
|
319
|
-
|
|
320
|
-
**常驻形态**=**查询时现算的只读视图**(与 `state_slots` 同哲学,不存第二真源):
|
|
321
|
-
任何时刻调用即得最新;不依赖后台任务。工具面(均在 `scripts/`):
|
|
322
|
-
|
|
323
|
-
| 件 | 用途 |
|
|
324
|
-
|---|---|
|
|
325
|
-
| `state_atlas.py` | **通用多主体追踪图**(常驻件):一份 md=全角色世界书(现值/退役/变迁史/大事记/分幕)+可选 `--worldbook-json`(酒馆风格 key/content) |
|
|
326
|
-
| `whale_state_tracker.py` | 语料线抽取器(把会话语料转五元事件;鲸娘规则集,机件可仿建他角色规则包) |
|
|
327
|
-
| `whale_state_atlas.py` | 语料线专用追踪图(从抽取产物 md 生成) |
|
|
328
|
-
| `state_slots.py`(CLI) | 槽位投影只读入口(恒可用,`--status` 等) |
|
|
329
|
-
| `stg(op=state_chain)` | MCP 查询面(flag `MDCG_STG_STATE` 默认关——纪律不变,与 CLI 恒可用互补) |
|
|
330
|
-
|
|
331
|
-
**库根解析(与 zcode MCP 同源,防双库分叉)**:`--root` > env `MDCG_ROOT` >
|
|
332
|
-
`~/.zcode/cli/config.json` 的 `mcp.servers.mdcg.env.MDCG_ROOT` > `mdcg_root()` 缺省。
|
|
333
|
-
**只读纪律**:工具面只读,`--out` 一律仓外(fail-closed)。
|
|
334
|
-
|
|
335
|
-
**记账纪律(通用指引,从鲸娘线三层消歧口径提炼)**:①状态变更发生时记账(谁的
|
|
336
|
-
什么槽位、old/new、五类 kind);②**用户侧声明优先**(用户明确说出的状态为准,
|
|
337
|
-
角色自述的「记错」不复盖真值);③非事实三类(玩笑/元层/回忆转述)如实标注、
|
|
338
|
-
不覆盖真值;④撤回=old 有值 new 空(显式作废,不做静默改写)。
|
|
339
|
-
|
|
340
|
-
**在役现状(2026-10-06 实测)**:权威库(AEIS 数据区库根——根解析同源口径见上)
|
|
341
|
-
台账**0 条事件**——机制全链就位、数据处女地;多主体渲染由隔离库演示验证
|
|
342
|
-
(2 主体/30 事件/15 槽位/15 条 worldbook 条目,读数见 `docs/eval/` 报告 v1.2 节)。
|
|
343
|
-
|
|
344
|
-
**待裁(常驻自动化的可选增强)**:是否在睡眠周期「整理」档挂一步
|
|
345
|
-
「按主体预生成追踪图 md → 状态面」——现状为**按需现算**(打开即最新),预生成仅为
|
|
346
|
-
「打开就有文件」的缓存物;改常驻循环属生产行为变更,须单独立项。
|
|
347
|
-
|
|
348
|
-
### 会话链路接入(轮写入链第二步;使用者 2026-10-06 裁定)
|
|
349
|
-
|
|
350
|
-
> 「把这个功能作为会话的 10 轮信息写入,并在写入 mdcg 的时候做处理……每次写入
|
|
351
|
-
> 异步加了一些过程,但是好处是得到了可维护的状态,同时具备了认知图和语义时空图,
|
|
352
|
-
> 原始信息的关系追溯。」
|
|
353
|
-
|
|
354
|
-
- **接线单点**:`scripts/sync_zcode_session.py::sync_to_window`(zcode 端每轮——
|
|
355
|
-
Stop 钩子/冷启动/压缩恢复共用同一链路)——写 `_recent` 窗口的**同一循环内**对同一轮
|
|
356
|
-
调 `scripts/state_extract.py` 保守抽取 → `state_events.append` 进台账。钩子在轮末以
|
|
357
|
-
子进程运行(会话外处理,即「异步」),**逐轮 fail-soft**(抽取失败绝不影响窗口写入
|
|
358
|
-
与轮次推进)。
|
|
359
|
-
- **保守口径(写入在役库的纪律:宁可漏不可误)**:只抽**用户轮**(真人=事实源);
|
|
360
|
-
仅两条高精度规则(`地点·所在` 迁移 / `情感·偏好`,负向显式记「不喜欢:」);值剥
|
|
361
|
-
句尾语气词;**同值去重**(防每轮重复记账);证据 `[auto] session=… turn=…`、
|
|
362
|
-
`actor=state_extract`——可整体甄别/清理;开关 `MDCG_STATE_EXTRACT` **缺省开**
|
|
363
|
-
(=0 关)。探针已证:裸词形(承诺 138 / 因果 59/225 命中)不进规则表。
|
|
364
|
-
- **三层同源+关系追溯**:认知图(`_recent`/知识面)+语义时空图(台账/`state_slots`
|
|
365
|
-
投影/`state_atlas` 视图)+原文(会话 md 镜像/全量转写)——事件 `evidence` 带
|
|
366
|
-
session/轮号/短证,任一层可回查另两层。
|
|
367
|
-
- **读数**:守卫 `scripts/test_state_extract.py` **10/10**(噪声三族零命中、去重、
|
|
368
|
-
变值成链、证据格式、开关、接线单点)+全量 **359/359**。
|
|
369
|
-
- **DSH 端**:同款接线位于插件侧(TS)——属后续件(须改插件并随包发布);本批仅
|
|
370
|
-
zcode 端在线,DSH 端行为不变。
|
|
371
|
-
- **已知边界(留裁决)**:「住在这里」类泛化词形会命中(值取「里」等)——v1 词形
|
|
372
|
-
如此,收窄与否归使用者。
|
|
373
|
-
|
|
374
|
-
---
|
|
375
|
-
|
|
376
|
-
## 修订记录
|
|
377
|
-
|
|
378
|
-
| 日期 | 要点 |
|
|
379
|
-
|---|---|
|
|
380
|
-
| 2026-10-06 | v1.0 首版(P3 批):全链(台账→投影→查询→记账口→CLI→探针)/ 开关 `MDCG_STG_STATE` 默认关与 CLI 恒可用 / 授权口径(`state_event`→`write` 词映射,actor 恒取令牌)/ 探针三读数复跑命令 / 边界如实(§一–§八) |
|
|
381
|
-
| 2026-10-06 | 补 §九「退役纪律」:节点 `lifecycle_state=archived` 的默认检索剔除(判据单点 `lifecycle.is_archived`,消费面 `MdCGOS._candidates` + `stg._scan_one` + 会话续接注入面 `session_recall` 四段〔要点/活跃目标/任务台账/未解问题〕)/ 两套「退役」词义分界 / 不受限面(直读·审计·**台账管理查询面**·统计)与「生命周期恢复 ≠ `op=restore`(删除轴)」/ 《秤》5.2 探针四读数(面计数口径)与守卫复跑 / 边界如实(未覆盖面:基类 `MdCG.search`、因果链面 `chain.adjacency`、结构面 `subgraph`、rust 内核、定向面 `identity.profile`) |
|
|
382
|
-
| 2026-10-06 | **边界四项裁定批落地(使用者裁定:1/2/4 接、3 不接)**:基类 `MdCG.search` 接线(R5)/ `chain.adjacency` 接线(`skip_archived` 参数,R6;scrub 维护面显式旁路)/ rust 内核接线(crate 单测双钉)/ `subgraph` 结构面**裁定不接**(R7 钉住裁定);并补 `lifecycle.set_state` 的 `chain.invalidate_cache` 同点失效(本批探针实证的缓存缺口);守卫 36→45 断言 |
|
|
383
|
-
| 2026-10-06 | **补 §十「多主体状态追踪」(核心能力定位,使用者 2026-10-06)**:常驻形态=查询时现算只读视图(不存第二真源);工具面四件(`state_atlas` 通用多主体 / 语料线两件 / CLI);库根解析与 MCP 同源(防双库分叉);记账纪律四条(从鲸娘线三层消歧口径提炼);在役台账 0 条实测+隔离多主体演示读数;睡眠档预生成列为待裁 |
|
|
384
|
-
| 2026-10-06 | **补 §十「会话链路接入」(轮写入链第二步,使用者 2026-10-06 裁定)**:`sync_to_window` 同循环内对同一轮保守抽取(`state_extract`:仅用户轮/两条高精度规则/去重/证据可甄别;开关缺省开)→ 台账;三层同源+关系追溯;守卫 `test_state_extract` 10/10、全量 359/359;DSH 端同款接线列后续件 |
|
|
@@ -1,82 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: 代码评审与条件化注释_契约_v0.1
|
|
3
|
-
overview: Phase 0 契约裁决:功能生效条件与索引元条件字段分家;render 三分区与人工优先;补写规范、门禁口径与已知代价面。作为四环全部改动的唯一权威。
|
|
4
|
-
状态: 生效(Phase 0 产出 · 2026-09-17)
|
|
5
|
-
关联计划: docs/mdcg/全库代码评审与条件化注释_计划_v0.1.md
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# 代码评审与条件化注释 · 契约 v0.1
|
|
9
|
-
|
|
10
|
-
> 本文件是 Phase 0 的裁决产出(计划 `contract-adr`),作为「全库代码评审 → 补条件化注释 → 进认知图索引 → 自动维护」四环全部改动的**唯一权威**。
|
|
11
|
-
> 与代码真源冲突时以真源为准,并回改本文件(防术语双写法漂移)。
|
|
12
|
-
|
|
13
|
-
## 一、判定单(designer-perspective · 强制调用)
|
|
14
|
-
|
|
15
|
-
```
|
|
16
|
-
[判定单]
|
|
17
|
-
条件空间:观测位置=全局(设计者位置,跨文件/跨检索面) | 观测工具=源码级逐行取证 + 机械断言 | 时间窗口=Phase 0(2026-09-17,重索引前) | 存在约束=公开仓(注释随仓公开,第14条双清单);不改 judge_qualification 判定序、不改 region_hash
|
|
18
|
-
白箱三问:依据=计划 §2.1/§2.2 逐行取证 + md_cg/test_p26_refindex.py L212-231 与 L249-258 既有断言(现场实读) | 条件=md_cg 认知图对代码条目做资格判定、且检索侧取首个匹配 | 错后=回滚=还原 codeindex.render 并重索引(既有已落盘正文不追溯)
|
|
19
|
-
裁决:ACCEPT(render 三分区 + 合成区去生效条件);对「同批全量重索引」→ DEFER
|
|
20
|
-
依据:行序压制为机械可判事实(合成行在源码注释之前且字段同名,mdcos._ccg_field 取首匹配);索引元条件与功能前置条件语义互斥(backfill.py 既有先例:清洗真实库 109 条弱等价行)
|
|
21
|
-
缺失维度:条件边界——真实库既有 2930 条代码节点的资格降级代价未被原计划评估(见 §四)
|
|
22
|
-
验证路径:md_cg/test_codeindex.py(行序/零重名/诚实缺证据/幂等/截断)+ test_p26_refindex 重对齐 + md_cg 全组回归与改动前基线对照 + 蜂巢确定性执行留痕
|
|
23
|
-
关注信号:本契约不触发追溯重写;Phase 2 铺量前必须获 q-0/q-1/q-2 裁决
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
## 二、字段分工(术语真源)
|
|
27
|
-
|
|
28
|
-
| 字段 | 承载语义 | 来源 | 可否合成 |
|
|
29
|
-
|---|---|---|---|
|
|
30
|
-
| `生效条件` | **功能前置条件** precondition:这段代码在何种输入/状态下正确 | 人工/源码声明(源码 CCG 注释) | **否**(合成即冒充) |
|
|
31
|
-
| `索引元条件` | 条目在何处/何时/以何工具可被观测到 | 机械推导(`codeindex.condition_space` 四槽) | 是(唯一来源) |
|
|
32
|
-
| `位置` | 索引坐标(path:lineno-end、lang、precise) | 机械推导 | 是 |
|
|
33
|
-
| frontmatter `condition_space` | 四槽结构化值(与正文 `索引元条件` 同一纯函数) | 机械推导 | 是 |
|
|
34
|
-
|
|
35
|
-
真源常量:`nodefile.INDEX_META_MARK`(= `索引元条件`)与 `nodefile.is_ccg_mark`(零重名机械判据)。
|
|
36
|
-
|
|
37
|
-
四条硬约束:
|
|
38
|
-
|
|
39
|
-
1. 合成区字段名与 `nodefile.CCG_MARKS` 的交集 = 空集;
|
|
40
|
-
2. `生效条件` 行只可能来自源码声明,`render` 永不合成该字段;
|
|
41
|
-
3. 同名字段冲突时**人工优先**(源码区置首 → `_ccg_field` 取首个匹配 → 确定性可复算);
|
|
42
|
-
4. 不动 `region_hash`、不动 `judge_qualification` 判定序、`skip_matcher` 无参行为逐字不变。
|
|
43
|
-
|
|
44
|
-
## 三、补写规范(环二输入口径)
|
|
45
|
-
|
|
46
|
-
1. 只写**功能生效条件**,不写索引元条件:写「入参 path 为已存在的本地文件」,不写「源文件存在于本地仓」。
|
|
47
|
-
2. 落点在**两个窗口**之一,按源文件**物理行序**合并(靠前者胜出 = 检索侧取首匹配的确定性序):
|
|
48
|
-
- **leading**:定义行**紧邻上方**的连续 `#` 注释(`codeindex._leading_comments` 口径,遇空行即断);
|
|
49
|
-
- **body**:定义行**紧邻下方**、函数体首个语句之前的 `#` 注释(`codeindex._body_comments` 口径,**唯一真源**)。
|
|
50
|
-
既有白箱单元库 **104+ 处**用的是 body 窗口(例:`whitebox_kb/wisdom/python_code_units.py` 模板 `def tokenize(src):` 下一行即 `# 生效条件:…`);`verifier._ccg_block` 已收敛为委托 `codeindex._body_comments`(2026-09-17 裁决 A,消除历史悬空引用)。
|
|
51
|
-
3. 六要素齐全才过门槛;`生效条件` 缺一即 BLINDSPOT(缺证据 → 补写,不许省略或用「常用条件默认省略」掩盖)。
|
|
52
|
-
4. 公开仓约束:补写内容随仓公开,须过第 14 条「内容政策 + 隐私脱敏」双清单;含敏感/隐私者只入私有库(AEIS)。
|
|
53
|
-
|
|
54
|
-
## 四、已知代价面(必须显式知情)
|
|
55
|
-
|
|
56
|
-
- **改造前实测**:本机认知图真源(仓外私有库 `<brain-root>`)有 **2930** 条 `code_` 节点,其正文含合成 `生效条件`(实为索引元条件),故资格判定为 **DEFER**。
|
|
57
|
-
原计划 §九-2 称「代码节点当前恒定被判 BLINDSPOT」,与实测不符——**该前提已修正**(本契约相对计划的重要事实更正)。
|
|
58
|
-
- **改造后**:`render` 不再合成 `生效条件` → 源码未补注释的条目 = 缺证据 = **BLINDSPOT**。
|
|
59
|
-
- **影响面**:不追溯。既有 2930 条节点的正文已落盘,只有**重索引**(`index_code`,尤其非增量)或源文件变更触发重写时才翻转。
|
|
60
|
-
- **为何仍应接受**:改造前的 DEFER 建立在一个**语义错误的生效条件**上(计划 §2.2 的病根:「补了注释」与「没补」不可区分)。未补 = BLINDSPOT 是诚实信号,由环二补注释闸门(`GATE_MIN_PASS_RATE=0.90`)逐步补回。
|
|
61
|
-
- **回滚路径**:还原 `codeindex.render` 后重索引即可回到 DEFER;已落盘的旧正文不自动回退(写路径可退,历史不可逆)。
|
|
62
|
-
|
|
63
|
-
## 五、门禁口径(Phase 0 验收)
|
|
64
|
-
|
|
65
|
-
| 项 | 判据 | 断言位置 |
|
|
66
|
-
|---|---|---|
|
|
67
|
-
| 行序压制已修 | 源码 `生效条件` 置首、逐字保留,`_ccg_field` 取到人工值 | test_codeindex ② / test_p26 §4 |
|
|
68
|
-
| 补注释 = 有效 | 源码声明后 `ccg_completeness.complete == True` | test_codeindex ② |
|
|
69
|
-
| 未补 = 诚实缺证据 | `complete == False` 且**恰缺** `生效条件` | test_codeindex ② / test_p26 §5 |
|
|
70
|
-
| 字段零重名 | 合成区用到的 CCG 字段名 = 其余五要素 | test_codeindex ③ |
|
|
71
|
-
| 载体两窗口 | body 窗口注释被抽取、两窗口按物理序合并、`verifier` 与唯一真源逐字等价 | test_codeindex ⑦ |
|
|
72
|
-
| 幂等/确定性 | `render` 两次逐字节相同;`index_dir` 两次条目序一致 | test_codeindex ⑤⑥ |
|
|
73
|
-
| 既有契约不回归 | `condition_space` 四槽/全时窗、`extract` 分派、`region_hash` 12 位 | test_codeindex ④⑤ |
|
|
74
|
-
| 回归 | md_cg 全组回归与**改动前基线**对照(既有失败不改判) | 蜂巢确定性执行留痕(spec/result) |
|
|
75
|
-
|
|
76
|
-
## 六、不适用条件
|
|
77
|
-
|
|
78
|
-
- 不适用于知识/文档节点(本契约只管代码条目的注释与资格判定)。
|
|
79
|
-
- 不改 `judge_qualification` 判定序与 `region_hash`;扩面(`.ts`/`.ps1`/`.yml`)属既有计划缺口 E,只声明不扩面。
|
|
80
|
-
- q-0(注释落点)/ q-1(首期范围)/ q-2(评审方式)未获使用者裁决前,不得进入 Phase 2 铺量。
|
|
81
|
-
- 本契约不授权追溯重写既有节点正文,也不代替第 5 条验证纪律与第 17 条蜂巢派发。
|
|
82
|
-
- JS/TS 弱提取当前**只收 leading 窗口**(body 窗口未纳入)——属诚实边界而非缺陷,扩面须另行取证。
|