@furongjun1999/dsh-memory 0.8.1 → 0.9.7
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 +38 -27
- 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 +139 -139
- 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 +37 -3
- package/lib/hooks.js +176 -24
- package/lib/index.d.ts +2 -2
- package/lib/index.js +29 -6
- 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 +51 -3
- 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 +28 -2
- 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 +15 -2
- package/lib/tools.js +44 -4
- 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 +37 -7
- 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 +573 -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 +747 -726
- package/md_cg/conformance_core.py +753 -0
- package/md_cg/consistency.py +1278 -955
- package/md_cg/consolidate.py +1793 -1633
- package/md_cg/crypto.py +346 -24
- 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 +262 -251
- 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 +426 -345
- 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 +7108 -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 +1103 -1100
- package/md_cg/probe_memory_rsi.py +95 -0
- package/md_cg/probe_memory_rsi_mcp.py +66 -0
- package/md_cg/protect.py +654 -494
- package/md_cg/protocol.py +492 -411
- package/md_cg/provenance.py +606 -600
- 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 +613 -604
- 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 +657 -420
- package/md_cg/rollback_cli.py +124 -104
- package/md_cg/rotate.py +347 -0
- package/md_cg/routing.py +490 -429
- 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 +144 -144
- package/md_cg/semantic/export_en_zh_map.py +2 -2
- package/md_cg/semantic/zh_en_atoms.py +141 -139
- 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 +1091 -833
- package/md_cg/state_events.py +75 -10
- package/md_cg/state_slots.py +312 -221
- package/md_cg/stg.py +85 -18
- 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 +2013 -1973
- 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_code_kind_forbidden.py +101 -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 +658 -656
- 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 +874 -865
- 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_issue562_retired_faces.py +150 -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 +1141 -1109
- package/md_cg/test_mcp_call_argument_types.py +99 -0
- package/md_cg/test_md_access_parity.py +330 -255
- 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 +835 -805
- package/md_cg/test_n123_derive_expiry_chain.py +210 -205
- package/md_cg/test_n130_verify_falsified_protect.py +185 -185
- package/md_cg/test_n209_verify_write_face_gates.py +466 -461
- package/md_cg/test_n230_dirty_replay.py +52 -9
- package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
- package/md_cg/test_neg_coverage_budget.py +500 -0
- package/md_cg/test_neg_tail_honesty.py +733 -663
- 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 +294 -293
- 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 +792 -777
- package/md_cg/test_p28_refcheck.py +1053 -1032
- 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 +476 -463
- package/md_cg/test_p3.py +370 -261
- package/md_cg/test_p33_ccg_wiring.py +300 -293
- package/md_cg/test_p3_legacy_closure.py +438 -433
- package/md_cg/test_p40_refine_worklist.py +244 -241
- package/md_cg/test_p47_session_view.py +25 -9
- package/md_cg/test_p4_freshness.py +781 -774
- package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
- package/md_cg/test_p9c_dedup_hints.py +288 -283
- package/md_cg/test_policy_required_ccg.py +444 -432
- 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 +312 -213
- 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 +521 -514
- 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 +1024 -1020
- package/md_cg/test_subgraph_bounded_bfs.py +227 -0
- package/md_cg/test_sustain_bounded.py +652 -624
- 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 +228 -226
- 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 +1114 -1030
- package/md_cg/twophase.py +303 -231
- package/md_cg/weights.py +642 -638
- package/md_cg/whitebox.py +536 -527
- 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 +1634 -1633
- package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
- package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
- 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 +490 -470
- package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
- package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
- package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
- package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
- package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
- package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
- 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 +1337 -826
- package/package.json +14 -9
- package/scripts/workspace_index.py +328 -0
- package/src/bridge.ts +34 -11
- package/src/cli.ts +75 -65
- package/src/hooks.ts +932 -776
- package/src/index.ts +30 -7
- package/src/init.ts +362 -361
- package/src/lib/datapath.ts +419 -326
- package/src/lib/hook_audit.ts +42 -3
- package/src/lib/mdcg_client.ts +469 -461
- package/src/lib/mutual.ts +481 -432
- package/src/lib/prompt_safety.ts +178 -149
- package/src/lib/roleplay_web.ts +30 -2
- package/src/lib/token_store.ts +274 -52
- package/src/tools.ts +271 -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
package/md_cg/conformance.py
CHANGED
|
@@ -1,727 +1,748 @@
|
|
|
1
|
-
# -*- coding: utf-8 -*-
|
|
2
|
-
"""md_cg · 数据健康不变量断言集(Pi⑤)+ G1 类型空间正交性审计 + G3 unanalyzed 显式占位
|
|
3
|
-
|
|
4
|
-
把 2026-09-15 的一次性审计改写为**周期可复跑**的断言集(混层比例阈值 / 重复度阈值 /
|
|
5
|
-
字段覆盖率下限 / 闸门四态分布),挂 sustain 周期巡检;超阈值**只告警,不自动改数据**。
|
|
6
|
-
|
|
7
|
-
三条纪律:
|
|
8
|
-
1. **不变量 fail-closed**:类型空间封闭性 / 边键规范 / 边目标可解析 / 索引↔盘一致 /
|
|
9
|
-
重复度不劣化——任一 FAIL = 库结构失真,须人工处置。
|
|
10
|
-
2. **健康指标只告警**:混层比 / role 覆盖率 / evidence 覆盖率 / 分析覆盖率 /
|
|
11
|
-
闸门四态 / 触达率——低于靶值 WARN,不阻断、不改数据。
|
|
12
|
-
3. **缺数据源 → BLINDSPOT**(如实上报),绝不冒充 PASS。
|
|
13
|
-
|
|
14
|
-
G1(Ghidra 交接 §5.4):输出各类型空间的「声明值 / 实测值 / 未声明已用 / 声明未用 /
|
|
15
|
-
跨空间重叠 / 方向口径分歧」——类型空间不封闭是写入侧漂移的前兆。
|
|
16
|
-
|
|
17
|
-
G3(同 §5.4):unanalyzed 采用**派生断言**(不新增字段、零写入),判据
|
|
18
|
-
`evidence_count==0 ∧ verification_basis 空 ∧ lifecycle_state 空`。
|
|
19
|
-
不做字段级占位的理由:生命周期是单向降级轴,与分析覆盖正交,塞同一字段破坏正交性。
|
|
20
|
-
|
|
21
|
-
用法:
|
|
22
|
-
python -m md_cg.conformance [--root R] [--json out.json] [--baseline b.json]
|
|
23
|
-
[--no-path-check] [--strict]
|
|
24
|
-
"""
|
|
25
|
-
from __future__ import annotations
|
|
26
|
-
|
|
27
|
-
import argparse
|
|
28
|
-
import json
|
|
29
|
-
import os
|
|
30
|
-
import sys
|
|
31
|
-
import time
|
|
32
|
-
from collections import Counter, deque
|
|
33
|
-
|
|
34
|
-
REPORT_VERSION = 1
|
|
35
|
-
INDEX_FILE = "_index.json"
|
|
36
|
-
ACCESS_LOG = "_access.log"
|
|
37
|
-
DECISION_LOG = os.path.join("hippocampus", "decisions.jsonl")
|
|
38
|
-
INBOX_LOG = os.path.join("hippocampus", "inbox.jsonl")
|
|
39
|
-
DEFAULT_ROOT = os.path.join(
|
|
40
|
-
os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "data", "mdcg")
|
|
41
|
-
#: _audit.jsonl 只读尾部窗口行数(append-only 全史可数十 MB,周期巡检不扫全史)
|
|
42
|
-
AUDIT_TAIL = 20000
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
# 生效条件:无入参,datapath.mdcg_root() 返回真值时返回该值,导入或调用抛异常、或返回假值(如空串)时返回模块常量 DEFAULT_ROOT;
|
|
46
|
-
def _default_root() -> str:
|
|
47
|
-
"""根解析沿用本仓约定:env `MDCG_ROOT` > `paths.json`(用户级,旧包内兼容读)
|
|
48
|
-
> 用户级状态根 `data/mdcg`。
|
|
49
|
-
|
|
50
|
-
走 `datapath.mdcg_root()`(兜底纪律:与其它工具同源解析,不另立一套)。
|
|
51
|
-
"""
|
|
52
|
-
try:
|
|
53
|
-
from .datapath import mdcg_root
|
|
54
|
-
got = mdcg_root()
|
|
55
|
-
if got:
|
|
56
|
-
return got
|
|
57
|
-
except Exception: # noqa: BLE001
|
|
58
|
-
pass
|
|
59
|
-
return DEFAULT_ROOT
|
|
60
|
-
|
|
61
|
-
# 阈值口径 = 9-15 审计基线(2026-09-16 复跑实测:混层 6468/11076=58.4% / role 2.13% /
|
|
62
|
-
# verification_basis 60.3% / evidence 0.10% / dir_mismatch 0 / 闸门 142 条) + M4 治理靶值。
|
|
63
|
-
# 比率型阈值只表达「离靶多远」,不阻断任何写入。
|
|
64
|
-
# 注:触达率随 _access.log 滚动追加而单调增长,9-15 快照 7.0% → 09-16 实测 8.7%,
|
|
65
|
-
# 差异来自时间而非口径;故**不纳入基线不劣化比对**(日志轮转会误报)。
|
|
66
|
-
THRESHOLDS = {
|
|
67
|
-
"stratum_ratio_max": 0.60,
|
|
68
|
-
"stratum_target": 0.30,
|
|
69
|
-
"role_coverage_min": 0.90,
|
|
70
|
-
"evidence_coverage_min": 0.50,
|
|
71
|
-
"analysis_coverage_min": 0.90,
|
|
72
|
-
"reach_ratio_min": 0.30,
|
|
73
|
-
"gate_sample_min": 20,
|
|
74
|
-
# 样本下限:低于此值比率型指标不可判(如仓内自建语料),一律 BLINDSPOT 不冒充 PASS
|
|
75
|
-
"min_nodes": 200,
|
|
76
|
-
}
|
|
77
|
-
|
|
78
|
-
#: 单一内容指纹的最大同组节点数(超过即「同模板批量写入」体征,须人工治理)
|
|
79
|
-
DUP_GROUP_MAX = 200
|
|
80
|
-
|
|
81
|
-
# 写侧规范边键。取证更正(2026-09-16):subgraph.children_index:122 / parents_index:162
|
|
82
|
-
# 已含 `or e.get("type")` 容错,**读侧不忽略** legacy `type`(`subgraph` 内 normalize_edge
|
|
83
|
-
# 的 docstring 仍写「会被静默忽略」,属文档滞后于代码,已登记 DOC_CODE_DRIFT)。
|
|
84
|
-
# 仍记为规范项:chain.edge_rel 与 subgraph 双兼容是本库私约,非 md_cg 读侧(Rust 引擎 /
|
|
85
|
-
# 外部消费者)可能只读 relation_type。
|
|
86
|
-
CANONICAL_EDGE_KEYS = ("relation_type", "relation")
|
|
87
|
-
LAYER_DIRS = ("knowledge", "contextual", "self", "structural", "anchor",
|
|
88
|
-
"rejected", "unresolved", "goals", "data", "trash")
|
|
89
|
-
|
|
90
|
-
# G1 静态登记:已取证的方向口径分歧(事实,非推断)
|
|
91
|
-
KNOWN_DIRECTION_CONFLICTS = [
|
|
92
|
-
{"literal": "hierarchical",
|
|
93
|
-
"conflict": "md_cg subgraph 视其为「本节点是子、target 是父」"
|
|
94
|
-
"(children_index:128);白箱源库语义为 source 是父 —— 同名反义,"
|
|
95
|
-
"直接迁移整树倒置",
|
|
96
|
-
"workaround": "migrate_wisdom_graph.SRC_REL_MAP 迁移时改写为 contains(语义等价)"},
|
|
97
|
-
]
|
|
98
|
-
# G1 静态登记:已核对**无**方向分歧的项(防止「看起来像冲突」被反复误报)
|
|
99
|
-
VERIFIED_CONSISTENT = [
|
|
100
|
-
{"literal": "part_of / parent_of / contains",
|
|
101
|
-
"verified": "children_index:128-135 与 parents_index:171-178 逐字对称、方向取反,自洽"},
|
|
102
|
-
]
|
|
103
|
-
# G1 已取证的**文档滞后于代码**实例(陈述与实现不符,非缺陷但会误导写侧)
|
|
104
|
-
DOC_CODE_DRIFT = [
|
|
105
|
-
{"where": "subgraph.normalize_edge docstring:96",
|
|
106
|
-
"claims": "「早期迁移器写的 type 会被静默忽略(subgraph 不兼容)」",
|
|
107
|
-
"fact": "children_index:122 / parents_index:162 已含 `or e.get(\"type\")` 容错 —— "
|
|
108
|
-
"读侧兼容,陈述已过期"},
|
|
109
|
-
]
|
|
110
|
-
|
|
111
|
-
# G1 静态登记:新增类型的散落点(回答「新增类型要不要改引擎」)
|
|
112
|
-
NEW_TYPE_TOUCHPOINTS = {
|
|
113
|
-
"layer": ["mdcg.LAYERS", "mdcg.BUCKETED_LAYERS", "mdcg.NEG_MEMORY_MARKS",
|
|
114
|
-
"nodefile(fm 契约)", "routing(bucket)", "MCP 工具面描述"],
|
|
115
|
-
"edge_type": ["chain.EDGE_WEIGHTS", "subgraph(父子方向分支)",
|
|
116
|
-
"migrate_wisdom_graph.SRC_REL_MAP"],
|
|
117
|
-
}
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
# 生效条件:root 下 INDEX_FILE 可读且 JSON 顶层为 dict 并含 nodes 字典时返回该 nodes;不可读抛 OSError、JSON 非法抛 JSONDecodeError、nodes 非 dict 抛 ValueError;
|
|
121
|
-
def load_index(root: str) -> dict:
|
|
122
|
-
"""读索引快照(唯一必需数据源);损坏即抛——断言集不建立在猜测上。"""
|
|
123
|
-
with open(os.path.join(root, INDEX_FILE), encoding="utf-8") as f:
|
|
124
|
-
raw = json.load(f)
|
|
125
|
-
nodes = raw.get("nodes") if isinstance(raw, dict) else None
|
|
126
|
-
if not isinstance(nodes, dict):
|
|
127
|
-
raise ValueError(f"索引格式异常(缺 nodes 字典): {root}/{INDEX_FILE}")
|
|
128
|
-
return nodes
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
# 生效条件:path 不存在(os.path.exists 为假)时返回 [];存在时逐行解析,空行与 JSONDecodeError 行被跳过,返回可解析记录的列表(可能为 []);
|
|
132
|
-
def _read_jsonl(path: str) -> list:
|
|
133
|
-
if not os.path.exists(path):
|
|
134
|
-
return []
|
|
135
|
-
out = []
|
|
136
|
-
with open(path, encoding="utf-8", errors="replace") as f:
|
|
137
|
-
for line in f:
|
|
138
|
-
line = line.strip()
|
|
139
|
-
if not line:
|
|
140
|
-
continue
|
|
141
|
-
try:
|
|
142
|
-
out.append(json.loads(line))
|
|
143
|
-
except json.JSONDecodeError:
|
|
144
|
-
continue
|
|
145
|
-
return out
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
# 生效条件:rec 的 tags 缺失或为假值时按空列表处理,仅对含 ":" 的 tag 取首个冒号前的前缀构成集合并返回;无此类 tag 时返回空集合;
|
|
149
|
-
def _tag_prefixes(rec: dict) -> set:
|
|
150
|
-
return {str(t).split(":", 1)[0] for t in (rec.get("tags") or []) if ":" in str(t)}
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
# 生效条件:r 的 verification_basis 为 list/tuple 时返回其真值元素的 str 列表;否则该值真值时返回 [str(b)],缺失或为假值(None/空串/空容器)时返回 [];
|
|
154
|
-
def _basis_of(r: dict):
|
|
155
|
-
b = r.get("verification_basis")
|
|
156
|
-
if isinstance(b, (list, tuple)):
|
|
157
|
-
return [str(x) for x in b if x]
|
|
158
|
-
return [str(b)] if b else []
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
# 生效条件:无入参,返回 layer(取自导入的模块常量 LAYERS 的排序值)+ edge_type/derived_relation/verification_basis/lifecycle_state 五键声明值映射,后四键对应模块导入或属性取值失败、属性值为假值(空容器/None)时该键 declared=None;
|
|
162
|
-
def enum_spaces() -> dict:
|
|
163
|
-
"""各类型空间的声明值(模块真源取不到 → declared=None,报告标 BLINDSPOT)。"""
|
|
164
|
-
from .mdcg import LAYERS
|
|
165
|
-
spaces = {"layer": {"declared": sorted(LAYERS), "source": "mdcg.LAYERS"}}
|
|
166
|
-
|
|
167
|
-
#
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
#
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
if
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
#
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
for
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
#
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
checks
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
f"
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
f"
|
|
510
|
-
f"
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
f"
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
for
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
|
|
576
|
-
|
|
577
|
-
|
|
578
|
-
|
|
579
|
-
|
|
580
|
-
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
a(f"
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
"
|
|
670
|
-
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""md_cg · 数据健康不变量断言集(Pi⑤)+ G1 类型空间正交性审计 + G3 unanalyzed 显式占位
|
|
3
|
+
|
|
4
|
+
把 2026-09-15 的一次性审计改写为**周期可复跑**的断言集(混层比例阈值 / 重复度阈值 /
|
|
5
|
+
字段覆盖率下限 / 闸门四态分布),挂 sustain 周期巡检;超阈值**只告警,不自动改数据**。
|
|
6
|
+
|
|
7
|
+
三条纪律:
|
|
8
|
+
1. **不变量 fail-closed**:类型空间封闭性 / 边键规范 / 边目标可解析 / 索引↔盘一致 /
|
|
9
|
+
重复度不劣化——任一 FAIL = 库结构失真,须人工处置。
|
|
10
|
+
2. **健康指标只告警**:混层比 / role 覆盖率 / evidence 覆盖率 / 分析覆盖率 /
|
|
11
|
+
闸门四态 / 触达率——低于靶值 WARN,不阻断、不改数据。
|
|
12
|
+
3. **缺数据源 → BLINDSPOT**(如实上报),绝不冒充 PASS。
|
|
13
|
+
|
|
14
|
+
G1(Ghidra 交接 §5.4):输出各类型空间的「声明值 / 实测值 / 未声明已用 / 声明未用 /
|
|
15
|
+
跨空间重叠 / 方向口径分歧」——类型空间不封闭是写入侧漂移的前兆。
|
|
16
|
+
|
|
17
|
+
G3(同 §5.4):unanalyzed 采用**派生断言**(不新增字段、零写入),判据
|
|
18
|
+
`evidence_count==0 ∧ verification_basis 空 ∧ lifecycle_state 空`。
|
|
19
|
+
不做字段级占位的理由:生命周期是单向降级轴,与分析覆盖正交,塞同一字段破坏正交性。
|
|
20
|
+
|
|
21
|
+
用法:
|
|
22
|
+
python -m md_cg.conformance [--root R] [--json out.json] [--baseline b.json]
|
|
23
|
+
[--no-path-check] [--strict]
|
|
24
|
+
"""
|
|
25
|
+
from __future__ import annotations
|
|
26
|
+
|
|
27
|
+
import argparse
|
|
28
|
+
import json
|
|
29
|
+
import os
|
|
30
|
+
import sys
|
|
31
|
+
import time
|
|
32
|
+
from collections import Counter, deque
|
|
33
|
+
|
|
34
|
+
REPORT_VERSION = 1
|
|
35
|
+
INDEX_FILE = "_index.json"
|
|
36
|
+
ACCESS_LOG = "_access.log"
|
|
37
|
+
DECISION_LOG = os.path.join("hippocampus", "decisions.jsonl")
|
|
38
|
+
INBOX_LOG = os.path.join("hippocampus", "inbox.jsonl")
|
|
39
|
+
DEFAULT_ROOT = os.path.join(
|
|
40
|
+
os.path.dirname(os.path.dirname(os.path.abspath(__file__))), "data", "mdcg")
|
|
41
|
+
#: _audit.jsonl 只读尾部窗口行数(append-only 全史可数十 MB,周期巡检不扫全史)
|
|
42
|
+
AUDIT_TAIL = 20000
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
# 生效条件:无入参,datapath.mdcg_root() 返回真值时返回该值,导入或调用抛异常、或返回假值(如空串)时返回模块常量 DEFAULT_ROOT;
|
|
46
|
+
def _default_root() -> str:
|
|
47
|
+
"""根解析沿用本仓约定:env `MDCG_ROOT` > `paths.json`(用户级,旧包内兼容读)
|
|
48
|
+
> 用户级状态根 `data/mdcg`。
|
|
49
|
+
|
|
50
|
+
走 `datapath.mdcg_root()`(兜底纪律:与其它工具同源解析,不另立一套)。
|
|
51
|
+
"""
|
|
52
|
+
try:
|
|
53
|
+
from .datapath import mdcg_root
|
|
54
|
+
got = mdcg_root()
|
|
55
|
+
if got:
|
|
56
|
+
return got
|
|
57
|
+
except Exception: # noqa: BLE001
|
|
58
|
+
pass
|
|
59
|
+
return DEFAULT_ROOT
|
|
60
|
+
|
|
61
|
+
# 阈值口径 = 9-15 审计基线(2026-09-16 复跑实测:混层 6468/11076=58.4% / role 2.13% /
|
|
62
|
+
# verification_basis 60.3% / evidence 0.10% / dir_mismatch 0 / 闸门 142 条) + M4 治理靶值。
|
|
63
|
+
# 比率型阈值只表达「离靶多远」,不阻断任何写入。
|
|
64
|
+
# 注:触达率随 _access.log 滚动追加而单调增长,9-15 快照 7.0% → 09-16 实测 8.7%,
|
|
65
|
+
# 差异来自时间而非口径;故**不纳入基线不劣化比对**(日志轮转会误报)。
|
|
66
|
+
THRESHOLDS = {
|
|
67
|
+
"stratum_ratio_max": 0.60,
|
|
68
|
+
"stratum_target": 0.30,
|
|
69
|
+
"role_coverage_min": 0.90,
|
|
70
|
+
"evidence_coverage_min": 0.50,
|
|
71
|
+
"analysis_coverage_min": 0.90,
|
|
72
|
+
"reach_ratio_min": 0.30,
|
|
73
|
+
"gate_sample_min": 20,
|
|
74
|
+
# 样本下限:低于此值比率型指标不可判(如仓内自建语料),一律 BLINDSPOT 不冒充 PASS
|
|
75
|
+
"min_nodes": 200,
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
#: 单一内容指纹的最大同组节点数(超过即「同模板批量写入」体征,须人工治理)
|
|
79
|
+
DUP_GROUP_MAX = 200
|
|
80
|
+
|
|
81
|
+
# 写侧规范边键。取证更正(2026-09-16):subgraph.children_index:122 / parents_index:162
|
|
82
|
+
# 已含 `or e.get("type")` 容错,**读侧不忽略** legacy `type`(`subgraph` 内 normalize_edge
|
|
83
|
+
# 的 docstring 仍写「会被静默忽略」,属文档滞后于代码,已登记 DOC_CODE_DRIFT)。
|
|
84
|
+
# 仍记为规范项:chain.edge_rel 与 subgraph 双兼容是本库私约,非 md_cg 读侧(Rust 引擎 /
|
|
85
|
+
# 外部消费者)可能只读 relation_type。
|
|
86
|
+
CANONICAL_EDGE_KEYS = ("relation_type", "relation")
|
|
87
|
+
LAYER_DIRS = ("knowledge", "contextual", "self", "structural", "anchor",
|
|
88
|
+
"rejected", "unresolved", "goals", "data", "trash")
|
|
89
|
+
|
|
90
|
+
# G1 静态登记:已取证的方向口径分歧(事实,非推断)
|
|
91
|
+
KNOWN_DIRECTION_CONFLICTS = [
|
|
92
|
+
{"literal": "hierarchical",
|
|
93
|
+
"conflict": "md_cg subgraph 视其为「本节点是子、target 是父」"
|
|
94
|
+
"(children_index:128);白箱源库语义为 source 是父 —— 同名反义,"
|
|
95
|
+
"直接迁移整树倒置",
|
|
96
|
+
"workaround": "migrate_wisdom_graph.SRC_REL_MAP 迁移时改写为 contains(语义等价)"},
|
|
97
|
+
]
|
|
98
|
+
# G1 静态登记:已核对**无**方向分歧的项(防止「看起来像冲突」被反复误报)
|
|
99
|
+
VERIFIED_CONSISTENT = [
|
|
100
|
+
{"literal": "part_of / parent_of / contains",
|
|
101
|
+
"verified": "children_index:128-135 与 parents_index:171-178 逐字对称、方向取反,自洽"},
|
|
102
|
+
]
|
|
103
|
+
# G1 已取证的**文档滞后于代码**实例(陈述与实现不符,非缺陷但会误导写侧)
|
|
104
|
+
DOC_CODE_DRIFT = [
|
|
105
|
+
{"where": "subgraph.normalize_edge docstring:96",
|
|
106
|
+
"claims": "「早期迁移器写的 type 会被静默忽略(subgraph 不兼容)」",
|
|
107
|
+
"fact": "children_index:122 / parents_index:162 已含 `or e.get(\"type\")` 容错 —— "
|
|
108
|
+
"读侧兼容,陈述已过期"},
|
|
109
|
+
]
|
|
110
|
+
|
|
111
|
+
# G1 静态登记:新增类型的散落点(回答「新增类型要不要改引擎」)
|
|
112
|
+
NEW_TYPE_TOUCHPOINTS = {
|
|
113
|
+
"layer": ["mdcg.LAYERS", "mdcg.BUCKETED_LAYERS", "mdcg.NEG_MEMORY_MARKS",
|
|
114
|
+
"nodefile(fm 契约)", "routing(bucket)", "MCP 工具面描述"],
|
|
115
|
+
"edge_type": ["chain.EDGE_WEIGHTS", "subgraph(父子方向分支)",
|
|
116
|
+
"migrate_wisdom_graph.SRC_REL_MAP"],
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
# 生效条件:root 下 INDEX_FILE 可读且 JSON 顶层为 dict 并含 nodes 字典时返回该 nodes;不可读抛 OSError、JSON 非法抛 JSONDecodeError、nodes 非 dict 抛 ValueError;
|
|
121
|
+
def load_index(root: str) -> dict:
|
|
122
|
+
"""读索引快照(唯一必需数据源);损坏即抛——断言集不建立在猜测上。"""
|
|
123
|
+
with open(os.path.join(root, INDEX_FILE), encoding="utf-8") as f:
|
|
124
|
+
raw = json.load(f)
|
|
125
|
+
nodes = raw.get("nodes") if isinstance(raw, dict) else None
|
|
126
|
+
if not isinstance(nodes, dict):
|
|
127
|
+
raise ValueError(f"索引格式异常(缺 nodes 字典): {root}/{INDEX_FILE}")
|
|
128
|
+
return nodes
|
|
129
|
+
|
|
130
|
+
|
|
131
|
+
# 生效条件:path 不存在(os.path.exists 为假)时返回 [];存在时逐行解析,空行与 JSONDecodeError 行被跳过,返回可解析记录的列表(可能为 []);
|
|
132
|
+
def _read_jsonl(path: str) -> list:
|
|
133
|
+
if not os.path.exists(path):
|
|
134
|
+
return []
|
|
135
|
+
out = []
|
|
136
|
+
with open(path, encoding="utf-8", errors="replace") as f:
|
|
137
|
+
for line in f:
|
|
138
|
+
line = line.strip()
|
|
139
|
+
if not line:
|
|
140
|
+
continue
|
|
141
|
+
try:
|
|
142
|
+
out.append(json.loads(line))
|
|
143
|
+
except json.JSONDecodeError:
|
|
144
|
+
continue
|
|
145
|
+
return out
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
# 生效条件:rec 的 tags 缺失或为假值时按空列表处理,仅对含 ":" 的 tag 取首个冒号前的前缀构成集合并返回;无此类 tag 时返回空集合;
|
|
149
|
+
def _tag_prefixes(rec: dict) -> set:
|
|
150
|
+
return {str(t).split(":", 1)[0] for t in (rec.get("tags") or []) if ":" in str(t)}
|
|
151
|
+
|
|
152
|
+
|
|
153
|
+
# 生效条件:r 的 verification_basis 为 list/tuple 时返回其真值元素的 str 列表;否则该值真值时返回 [str(b)],缺失或为假值(None/空串/空容器)时返回 [];
|
|
154
|
+
def _basis_of(r: dict):
|
|
155
|
+
b = r.get("verification_basis")
|
|
156
|
+
if isinstance(b, (list, tuple)):
|
|
157
|
+
return [str(x) for x in b if x]
|
|
158
|
+
return [str(b)] if b else []
|
|
159
|
+
|
|
160
|
+
|
|
161
|
+
# 生效条件:无入参,返回 layer(取自导入的模块常量 LAYERS 的排序值)+ edge_type/derived_relation/verification_basis/lifecycle_state 五键声明值映射,后四键对应模块导入或属性取值失败、属性值为假值(空容器/None)时该键 declared=None;
|
|
162
|
+
def enum_spaces() -> dict:
|
|
163
|
+
"""各类型空间的声明值(模块真源取不到 → declared=None,报告标 BLINDSPOT)。"""
|
|
164
|
+
from .mdcg import LAYERS
|
|
165
|
+
spaces = {"layer": {"declared": sorted(LAYERS), "source": "mdcg.LAYERS"}}
|
|
166
|
+
# #122(2026-10-12 DSH 端):**审计必须知道第二份权威的下场**。修前白箱侧
|
|
167
|
+
# (md_access.py)另有一份独立 LAYERS,而本函数只声明 mdcg 一份 ⇒ 审计对
|
|
168
|
+
# 「是否另立一份、是否已转发、是否已漂移」完全不知情。此处只**增**一个嵌套键
|
|
169
|
+
# (不动既有 declared/source ⇒ 既有消费者零变化):former 二份权威的现状读数。
|
|
170
|
+
try:
|
|
171
|
+
_WB = os.path.join(os.path.dirname(os.path.abspath(__file__)), "whitebox_kb")
|
|
172
|
+
for _p in (_WB, os.path.join(_WB, "wisdom")):
|
|
173
|
+
if _p not in sys.path:
|
|
174
|
+
sys.path.insert(0, _p)
|
|
175
|
+
import md_access as _ma
|
|
176
|
+
spaces["layer"]["second_authority"] = {
|
|
177
|
+
"symbol": "md_access.LAYERS",
|
|
178
|
+
"source": getattr(_ma, "LAYERS_SOURCE", "unknown"),
|
|
179
|
+
"same_tuple": tuple(_ma.LAYERS) == tuple(LAYERS),
|
|
180
|
+
# 身份判据:True = 真转发(同一对象);False = 仍是副本(哪怕值相同)
|
|
181
|
+
"forwarded": _ma.LAYERS is LAYERS,
|
|
182
|
+
}
|
|
183
|
+
except Exception as _exc: # noqa: BLE001
|
|
184
|
+
spaces["layer"]["second_authority"] = {
|
|
185
|
+
"symbol": "md_access.LAYERS", "source": "unavailable",
|
|
186
|
+
"error": "%s: %s" % (type(_exc).__name__, _exc)}
|
|
187
|
+
|
|
188
|
+
# 生效条件:以 md_cg.<mod> 导入并 getattr(attr)(导入或取值抛异常则 val=None),把 {"declared": sorted(val) if val else None, "source": "<mod>.<attr>"} 写入片段外闭包变量 spaces 的 key 键(val 为假值时 declared=None),无返回值;
|
|
189
|
+
def _grab(mod: str, attr: str, key: str):
|
|
190
|
+
try:
|
|
191
|
+
m = __import__(f"md_cg.{mod}", fromlist=[attr])
|
|
192
|
+
val = getattr(m, attr, None)
|
|
193
|
+
except Exception: # noqa: BLE001
|
|
194
|
+
val = None
|
|
195
|
+
spaces[key] = {"declared": sorted(val) if val else None,
|
|
196
|
+
"source": f"{mod}.{attr}"}
|
|
197
|
+
|
|
198
|
+
_grab("chain", "EDGE_WEIGHTS", "edge_type")
|
|
199
|
+
_grab("provenance", "RELATIONS", "derived_relation")
|
|
200
|
+
_grab("nodefile", "VERIFICATION_BASIS", "verification_basis")
|
|
201
|
+
_grab("lifecycle", "STATES", "lifecycle_state")
|
|
202
|
+
return spaces
|
|
203
|
+
|
|
204
|
+
|
|
205
|
+
# ---------------------------- 指标 ----------------------------
|
|
206
|
+
|
|
207
|
+
# 生效条件:对 nodes 各记录按 str(content_hash) 计数,content_hash 缺失被折成 "None",返回出现次数 >1 且哈希不为 "None"/"" 的组数、涉及节点数与前 5 大组大小;
|
|
208
|
+
def _dup_metrics(nodes: dict) -> dict:
|
|
209
|
+
ch = Counter(str(r.get("content_hash")) for r in nodes.values())
|
|
210
|
+
groups = {h: c for h, c in ch.items() if c > 1 and h not in ("None", "")}
|
|
211
|
+
return {"groups": len(groups), "nodes": sum(groups.values()),
|
|
212
|
+
"largest": sorted(groups.values(), reverse=True)[:5]}
|
|
213
|
+
|
|
214
|
+
|
|
215
|
+
# 生效条件:对 nodes 中每个节点的 "edges" 真值且为 list/tuple 的边列表,仅遍历其中 dict 边;依据 CANONICAL_EDGE_KEYS 与 "type" 统计键组合、关系类型、总边数、非规范键样本(最多 5)和悬空边,返回汇总字典。
|
|
216
|
+
def _edge_metrics(nodes: dict) -> dict:
|
|
217
|
+
types, key_mix = Counter(), Counter()
|
|
218
|
+
total = dangling = with_edges = non_canonical = 0
|
|
219
|
+
samples = []
|
|
220
|
+
for nid, r in nodes.items():
|
|
221
|
+
es = r.get("edges") or []
|
|
222
|
+
if not isinstance(es, (list, tuple)) or not es:
|
|
223
|
+
continue
|
|
224
|
+
with_edges += 1
|
|
225
|
+
for e in es:
|
|
226
|
+
if not isinstance(e, dict):
|
|
227
|
+
continue
|
|
228
|
+
total += 1
|
|
229
|
+
keys = [k for k in CANONICAL_EDGE_KEYS + ("type",) if e.get(k)]
|
|
230
|
+
types[str(e.get("relation_type") or e.get("relation") or e.get("type"))] += 1
|
|
231
|
+
key_mix["+".join(keys) if keys else "<无关系键>"] += 1
|
|
232
|
+
if not any(k in CANONICAL_EDGE_KEYS for k in keys):
|
|
233
|
+
non_canonical += 1
|
|
234
|
+
if len(samples) < 5:
|
|
235
|
+
samples.append({"node": nid, "edge": dict(e)})
|
|
236
|
+
tgt = e.get("target") or e.get("target_id")
|
|
237
|
+
if tgt is None or str(tgt) not in nodes:
|
|
238
|
+
dangling += 1
|
|
239
|
+
return {"nodes_with_edges": with_edges, "total": total,
|
|
240
|
+
"types": dict(types.most_common(20)), "key_mix": dict(key_mix.most_common(10)),
|
|
241
|
+
"non_canonical": non_canonical, "dangling": dangling, "samples": samples}
|
|
242
|
+
|
|
243
|
+
|
|
244
|
+
# 生效条件:遍历 nodes 的值作为记录,path 经 str(r.get("path") or "") 为空即 missing++ 并 continue,不以记录含 layer/path 为前置;仅对非空 path 执行 layer 与 head 检查(layer 非空且 head != layer 且 head in LAYER_DIRS 时 layer_mismatch++),且 check_exists 为 True 时才对非空 path 以 os.path.join(root, rel) 判断不存在并计入 missing,最终返回 missing/layer_mismatch/samples 统计;。
|
|
245
|
+
def _path_metrics(root: str, nodes: dict, check_exists: bool) -> dict:
|
|
246
|
+
missing = mismatch = 0
|
|
247
|
+
samples = []
|
|
248
|
+
for r in nodes.values():
|
|
249
|
+
layer, p = str(r.get("layer") or ""), str(r.get("path") or "")
|
|
250
|
+
if not p:
|
|
251
|
+
missing += 1
|
|
252
|
+
if len(samples) < 5:
|
|
253
|
+
samples.append({"id": r.get("id"), "why": "path 缺失"})
|
|
254
|
+
continue
|
|
255
|
+
rel = p.replace("\\", "/")
|
|
256
|
+
head = rel.split("/", 1)[0]
|
|
257
|
+
if layer and head != layer and head in LAYER_DIRS:
|
|
258
|
+
mismatch += 1
|
|
259
|
+
if len(samples) < 5:
|
|
260
|
+
samples.append({"id": r.get("id"), "path": p, "layer": layer})
|
|
261
|
+
if check_exists and not os.path.exists(os.path.join(root, rel)):
|
|
262
|
+
missing += 1
|
|
263
|
+
if len(samples) < 5:
|
|
264
|
+
samples.append({"id": r.get("id"), "path": p, "why": "文件不存在"})
|
|
265
|
+
return {"missing": missing, "layer_mismatch": mismatch, "samples": samples}
|
|
266
|
+
|
|
267
|
+
|
|
268
|
+
# 生效条件:root 下 DECISION_LOG/INBOX_LOG 不存在时按空列表计,返回 decisions(decision 或 status 回落 "?" 的前 10 项)、decisions_total、inbox_pending=max(0, 收件数−决策数)、以及 _audit.jsonl 末尾 AUDIT_TAIL 行内 op 计数的前 6 项与尾窗元信息;
|
|
269
|
+
def _gate_metrics(root: str) -> dict:
|
|
270
|
+
dec = _read_jsonl(os.path.join(root, DECISION_LOG))
|
|
271
|
+
inbox = _read_jsonl(os.path.join(root, INBOX_LOG))
|
|
272
|
+
ops = Counter()
|
|
273
|
+
# _audit.jsonl 是 append-only 且可达数十 MB(真源 15.9MB / 7.4 万行)——
|
|
274
|
+
# 只读尾部窗口(近 AUDIT_TAIL 行)取 op 分布,避免周期巡检在此处 O(全史)。
|
|
275
|
+
audit = os.path.join(root, "_audit.jsonl")
|
|
276
|
+
tail = []
|
|
277
|
+
if os.path.exists(audit):
|
|
278
|
+
with open(audit, encoding="utf-8", errors="replace") as f:
|
|
279
|
+
tail = list(deque(f, maxlen=AUDIT_TAIL))
|
|
280
|
+
for line in tail:
|
|
281
|
+
if not line.strip():
|
|
282
|
+
continue
|
|
283
|
+
try:
|
|
284
|
+
ops[str(json.loads(line).get("op"))] += 1
|
|
285
|
+
except json.JSONDecodeError:
|
|
286
|
+
continue
|
|
287
|
+
return {"decisions": dict(Counter(str(r.get("decision") or r.get("status") or "?")
|
|
288
|
+
for r in dec).most_common(10)),
|
|
289
|
+
"decisions_total": len(dec),
|
|
290
|
+
"inbox_pending": max(0, len(inbox) - len(dec)),
|
|
291
|
+
"audit_ops": dict(ops.most_common(6)), "audit_tail_lines": len(tail),
|
|
292
|
+
"audit_tail_window": AUDIT_TAIL}
|
|
293
|
+
|
|
294
|
+
|
|
295
|
+
# 生效条件:对 root 与 nodes,若 root/ACCESS_LOG 路径不存在则返回 {"distinct": None, "ratio": None, "lines": None};否则逐行解析 JSON,当 "ids" 为 list 或 tuple 时把其中真值元素 str 后加入 seen,且当 "id"/"node_id"/"nid" 任一真值时把其 str 加入 seen,返回 distinct 为 seen 与 nodes 键交集数量、ratio 为 distinct/max(len(nodes),1)、lines 为非空行数。
|
|
296
|
+
def _reach_metrics(root: str, nodes: dict) -> dict:
|
|
297
|
+
p = os.path.join(root, ACCESS_LOG)
|
|
298
|
+
if not os.path.exists(p):
|
|
299
|
+
return {"distinct": None, "ratio": None, "lines": None}
|
|
300
|
+
seen, lines = set(), 0
|
|
301
|
+
with open(p, encoding="utf-8", errors="replace") as f:
|
|
302
|
+
for line in f:
|
|
303
|
+
line = line.strip()
|
|
304
|
+
if not line:
|
|
305
|
+
continue
|
|
306
|
+
lines += 1
|
|
307
|
+
try:
|
|
308
|
+
rec = json.loads(line)
|
|
309
|
+
except json.JSONDecodeError:
|
|
310
|
+
continue
|
|
311
|
+
# 实际落盘形态:{"t":..., "ids":[<nid>,...], "tier":...}(_access.log 逐次追加)
|
|
312
|
+
got = rec.get("ids")
|
|
313
|
+
if isinstance(got, (list, tuple)):
|
|
314
|
+
seen.update(str(x) for x in got if x)
|
|
315
|
+
nid = rec.get("id") or rec.get("node_id") or rec.get("nid")
|
|
316
|
+
if nid:
|
|
317
|
+
seen.add(str(nid))
|
|
318
|
+
hit = len(seen & set(nodes))
|
|
319
|
+
return {"distinct": hit, "ratio": hit / max(len(nodes), 1), "lines": lines}
|
|
320
|
+
|
|
321
|
+
|
|
322
|
+
# 生效条件:对 nodes,筛出 layer 字符串为 "knowledge" 的 kn;mixed 为 kn 中标签前缀含 doc 或 code 的数量;返回全库 nodes 数与 knowledge 层数、mixed、mixed_ratio=mixed/max(len(kn),1),以及全库口径 role_ratio/basis_ratio/evidence_ratio/state_ratio 和 knowledge 层口径 role_ratio_kn/basis_ratio_kn/evidence_ratio_kn。
|
|
323
|
+
def _coverage_metrics(nodes: dict) -> dict:
|
|
324
|
+
"""混层口径 + 字段覆盖率(9-15 审计基线口径,逐项可复现)。
|
|
325
|
+
|
|
326
|
+
**分母口径取证(2026-09-16,关键)**:审计的「role 99.99% 为空」「evidence_count
|
|
327
|
+
仅 6 条」是 **knowledge 层**分母;全库分母会摊薄成「role 2.13% / evidence 12 条」,
|
|
328
|
+
把一个 99.99% 的空缺伪装成「还行」。故两类分母并存上报,**健康判据一律取
|
|
329
|
+
knowledge 层口径**(`*_ratio_kn`),全库口径只作对照片段。
|
|
330
|
+
"""
|
|
331
|
+
kn = [r for r in nodes.values() if str(r.get("layer")) == "knowledge"]
|
|
332
|
+
mixed = sum(1 for r in kn if {"doc", "code"} & _tag_prefixes(r))
|
|
333
|
+
n, nk = len(nodes), max(len(kn), 1)
|
|
334
|
+
return {"nodes": n, "knowledge": len(kn), "mixed_layer": mixed,
|
|
335
|
+
"mixed_ratio": mixed / nk,
|
|
336
|
+
"role_ratio": sum(1 for r in nodes.values() if r.get("role")) / max(n, 1),
|
|
337
|
+
"basis_ratio": sum(1 for r in nodes.values() if _basis_of(r)) / max(n, 1),
|
|
338
|
+
"evidence_ratio": sum(1 for r in nodes.values()
|
|
339
|
+
if _as_int(r.get("evidence_count")) > 0) / max(n, 1),
|
|
340
|
+
"state_ratio": sum(1 for r in nodes.values()
|
|
341
|
+
if r.get("lifecycle_state")) / max(n, 1),
|
|
342
|
+
# —— knowledge 层口径(= 审计原口径,判据用这组)——
|
|
343
|
+
"role_ratio_kn": sum(1 for r in kn if r.get("role")) / nk,
|
|
344
|
+
"basis_ratio_kn": sum(1 for r in kn if _basis_of(r)) / nk,
|
|
345
|
+
"evidence_ratio_kn": sum(1 for r in kn
|
|
346
|
+
if _as_int(r.get("evidence_count")) > 0) / nk}
|
|
347
|
+
|
|
348
|
+
|
|
349
|
+
# 生效条件:int(v) 转换成功时返回该整数;抛 TypeError/ValueError(如 None、非数字串)时返回 0;
|
|
350
|
+
def _as_int(v) -> int:
|
|
351
|
+
try:
|
|
352
|
+
return int(v)
|
|
353
|
+
except (TypeError, ValueError):
|
|
354
|
+
return 0
|
|
355
|
+
|
|
356
|
+
|
|
357
|
+
# ---------------------------- G3 · unanalyzed 派生集合 ----------------------------
|
|
358
|
+
|
|
359
|
+
# 生效条件:仅当记录 _as_int(evidence_count)==0 且 verification_basis 为空且 lifecycle_state 为假值时计入 ids,返回 count、ratio=count/max(len(nodes),1) 与前 5 个 id 样本;
|
|
360
|
+
def unanalyzed(nodes: dict) -> dict:
|
|
361
|
+
"""G3:unanalyzed **派生**判据(不新增字段、零写入)。
|
|
362
|
+
|
|
363
|
+
判据 = `evidence_count==0 ∧ verification_basis 空 ∧ lifecycle_state 空`
|
|
364
|
+
—— 三者皆空 = 「无一维分析痕迹」,与「分析结论为负」不同(后者会留 basis)。
|
|
365
|
+
|
|
366
|
+
不做字段级占位的理由(Ghidra 交接 §5.4):
|
|
367
|
+
* 生命周期是**单向降级轴**(active→converged→demoted→archived),与分析覆盖正交,
|
|
368
|
+
塞进同一字段即破坏正交性;
|
|
369
|
+
* **逃逸口已存在**——`verification_basis` 声明集里有 `other`(真源 273 条在用),
|
|
370
|
+
「分析过但无法归类」有明确归宿,故「basis 为空」不再与「分析结论为空」混淆。
|
|
371
|
+
"""
|
|
372
|
+
ids = [nid for nid, r in nodes.items()
|
|
373
|
+
if _as_int(r.get("evidence_count")) == 0
|
|
374
|
+
and not _basis_of(r)
|
|
375
|
+
and not r.get("lifecycle_state")]
|
|
376
|
+
return {"count": len(ids), "ratio": len(ids) / max(len(nodes), 1),
|
|
377
|
+
"sample": ids[:5]}
|
|
378
|
+
|
|
379
|
+
|
|
380
|
+
# ---------------------------- G1 · 类型空间正交性审计 ----------------------------
|
|
381
|
+
|
|
382
|
+
# 生效条件:调用 _usage(nodes, edges) 时 edges 形参未被源码引用,对 nodes.values() 中每个节点 r,仅当 r.get("layer")、r.get("role")、r.get("derived_relation")、r.get("lifecycle_state") 为真值时分别以 str 值计入对应 Counter,_basis_of(r) 与 _tag_prefixes(r) 展开的元素分别计入 verification_basis 与 tag_prefix,再遍历各 r 的 r.get("edges") or [] 中 isinstance(e, dict) 的项按 edge_rel(e) 计数,最终 edge_type 仅保留键为真值的计数,返回 used 字典;
|
|
383
|
+
def _usage(nodes: dict, edges: dict) -> dict:
|
|
384
|
+
"""各类型空间的**实测**取值(与 enum_spaces 的声明值对照)。"""
|
|
385
|
+
from .chain import edge_rel
|
|
386
|
+
used = {
|
|
387
|
+
"layer": Counter(str(r.get("layer")) for r in nodes.values() if r.get("layer")),
|
|
388
|
+
"role": Counter(str(r.get("role")) for r in nodes.values() if r.get("role")),
|
|
389
|
+
"verification_basis": Counter(b for r in nodes.values() for b in _basis_of(r)),
|
|
390
|
+
"derived_relation": Counter(str(r.get("derived_relation"))
|
|
391
|
+
for r in nodes.values() if r.get("derived_relation")),
|
|
392
|
+
"lifecycle_state": Counter(str(r.get("lifecycle_state"))
|
|
393
|
+
for r in nodes.values() if r.get("lifecycle_state")),
|
|
394
|
+
"tag_prefix": Counter(p for r in nodes.values() for p in _tag_prefixes(r)),
|
|
395
|
+
}
|
|
396
|
+
rels = Counter()
|
|
397
|
+
for r in nodes.values():
|
|
398
|
+
for e in (r.get("edges") or []):
|
|
399
|
+
if isinstance(e, dict):
|
|
400
|
+
rels[edge_rel(e)] += 1
|
|
401
|
+
used["edge_type"] = Counter({k: v for k, v in rels.items() if k})
|
|
402
|
+
return used
|
|
403
|
+
|
|
404
|
+
|
|
405
|
+
# 生效条件:以 enum_spaces 的声明集与 _usage 的实测集逐空间对照(closed 仅在 declared 非 None 且无未声明已用时为 True),role 与 tag_prefix 两空间的 declared/closed 恒为 None,另附 _cross_space_overlap(字面量出现在 ≥2 空间或 layer∩tag_prefix)及 KNOWN_DIRECTION_CONFLICTS/VERIFIED_CONSISTENT/DOC_CODE_DRIFT/NEW_TYPE_TOUCHPOINTS 四个常量;
|
|
406
|
+
def _g1_audit(nodes: dict, edges: dict) -> dict:
|
|
407
|
+
"""G1:声明值 / 实测值 / 未声明已用 / 声明未用 / 跨空间重叠 / 方向口径分歧。"""
|
|
408
|
+
spaces = enum_spaces()
|
|
409
|
+
used = _usage(nodes, edges)
|
|
410
|
+
out = {}
|
|
411
|
+
for name, spec in spaces.items():
|
|
412
|
+
dec = set(spec.get("declared") or [])
|
|
413
|
+
u = set(used.get(name, {}).keys())
|
|
414
|
+
out[name] = {
|
|
415
|
+
"source": spec.get("source"),
|
|
416
|
+
"declared": sorted(dec),
|
|
417
|
+
"used": dict(used.get(name, {}).most_common(30)),
|
|
418
|
+
"undeclared_used": sorted(u - dec),
|
|
419
|
+
"declared_unused": sorted(dec - u),
|
|
420
|
+
"closed": (spec.get("declared") is not None and not (u - dec)),
|
|
421
|
+
}
|
|
422
|
+
for name in ("role", "tag_prefix"):
|
|
423
|
+
out[name] = {"source": None, "declared": None,
|
|
424
|
+
"used": dict(used.get(name, {}).most_common(30)),
|
|
425
|
+
"undeclared_used": sorted(used.get(name, {})),
|
|
426
|
+
"declared_unused": [], "closed": None}
|
|
427
|
+
# 跨空间重叠:同一字面量出现在 ≥2 个空间 → 解析歧义风险
|
|
428
|
+
owners = Counter()
|
|
429
|
+
for name, spec in out.items():
|
|
430
|
+
for lit in (spec.get("declared") or []):
|
|
431
|
+
owners[str(lit)] += 1
|
|
432
|
+
out["_cross_space_overlap"] = sorted(l for l, c in owners.items() if c > 1) + \
|
|
433
|
+
sorted(set(used.get("layer", {})) & set(used.get("tag_prefix", {})))
|
|
434
|
+
out["_direction_conflicts"] = KNOWN_DIRECTION_CONFLICTS
|
|
435
|
+
out["_verified_consistent"] = VERIFIED_CONSISTENT
|
|
436
|
+
out["_doc_code_drift"] = DOC_CODE_DRIFT
|
|
437
|
+
out["_new_type_touchpoints"] = NEW_TYPE_TOUCHPOINTS
|
|
438
|
+
return out
|
|
439
|
+
|
|
440
|
+
|
|
441
|
+
# ---------------------------- 断言集 ----------------------------
|
|
442
|
+
|
|
443
|
+
# 生效条件:四参齐备时返回 {"id": cid, "level": level, "ok": bool(ok), "detail": detail},ok 经 bool() 归一为布尔;
|
|
444
|
+
def _ck(cid: str, level: str, ok: bool, detail: str) -> dict:
|
|
445
|
+
return {"id": cid, "level": level, "ok": bool(ok), "detail": detail}
|
|
446
|
+
|
|
447
|
+
|
|
448
|
+
# 生效条件:调用 check(root, check_paths, baseline, strict) 时,root 原样传入 load_index 得 nodes,check_paths 原样传入 _path_metrics 并在 index.path.present 检查消息中当其为假时追加“(--no-path-check 未查盘)”,baseline 为真时追加 _regression 基线不劣化检查、为假(None 或空 dict)时跳过,n=len(nodes) 小于 THRESHOLDS["min_nodes"] 时 small 为真且使 _ratio 各项及 reach.ratio、stratum.mixed_ratio 在 val 为 None 或 small 为真时记 BLINDSPOT、否则记 WARN,最终 verdict 为 FAIL(存在 level="FAIL" 且 ok 为假)、否则 WARN(存在 level="WARN" 且 ok 为假,或 strict 为真且存在 level="BLINDSPOT")、否则 PASS,返回含 REPORT_VERSION、t、elapsed_s、root 绝对路径、verdict、nodes、checks、counts、coverage、dup、edges、paths、gate、reach、unanalyzed、g1、protocol(=protocol.audit() 静态对账,恒追加四条 FAIL 级断言:op.declared 无未登记分支 / verb.implemented live 动词均有实现分支 / verb.reserved_clean 预留动词未被静默实现 / shape.declared 形状声明完备)、thresholds 的 dict;
|
|
449
|
+
def check(root: str, *, check_paths: bool = True,
|
|
450
|
+
baseline: dict = None, strict: bool = False) -> dict:
|
|
451
|
+
"""跑一遍全部断言,返回报告 dict(零写入:不修任何数据、不落任何文件)。"""
|
|
452
|
+
t0 = time.time()
|
|
453
|
+
nodes = load_index(root)
|
|
454
|
+
n = len(nodes)
|
|
455
|
+
small = n < THRESHOLDS["min_nodes"]
|
|
456
|
+
cov = _coverage_metrics(nodes)
|
|
457
|
+
edges = _edge_metrics(nodes)
|
|
458
|
+
paths = _path_metrics(root, nodes, check_paths)
|
|
459
|
+
gate = _gate_metrics(root)
|
|
460
|
+
reach = _reach_metrics(root, nodes)
|
|
461
|
+
un = unanalyzed(nodes)
|
|
462
|
+
g1 = _g1_audit(nodes, edges)
|
|
463
|
+
dup = _dup_metrics(nodes)
|
|
464
|
+
checks = []
|
|
465
|
+
T = THRESHOLDS
|
|
466
|
+
|
|
467
|
+
# ---- 不变量(fail-closed)----
|
|
468
|
+
for space, use_key in (("layer", "layer"), ("verification_basis", "verification_basis"),
|
|
469
|
+
("derived_relation", "derived_relation"),
|
|
470
|
+
("lifecycle_state", "lifecycle_state")):
|
|
471
|
+
spec = g1[space]
|
|
472
|
+
undecl = spec["undeclared_used"]
|
|
473
|
+
checks.append(_ck(f"enum.{space}.closed", "FAIL", not undecl,
|
|
474
|
+
f"声明源={spec['source']};未声明已用={undecl or '无'}"))
|
|
475
|
+
checks.append(_ck("edge.rel.declared", "WARN",
|
|
476
|
+
not g1["edge_type"]["undeclared_used"],
|
|
477
|
+
f"未声明边类型={g1['edge_type']['undeclared_used'] or '无'}"
|
|
478
|
+
"(读侧退化为 chain.DEFAULT_EDGE_WEIGHT=0.50,不炸但权重失真)"))
|
|
479
|
+
checks.append(_ck("edge.key.canonical", "WARN", edges["non_canonical"] == 0,
|
|
480
|
+
f"非规范键边 {edges['non_canonical']}/{edges['total']}"
|
|
481
|
+
f"(写侧规范={CANONICAL_EDGE_KEYS};md_cg 读侧兼容 type,"
|
|
482
|
+
"非 md_cg 读侧不兼容——存量债,判据=不劣化)"))
|
|
483
|
+
checks.append(_ck("edge.target.resolvable", "FAIL", edges["dangling"] == 0,
|
|
484
|
+
f"悬空边 {edges['dangling']}/{edges['total']}(图断裂)"))
|
|
485
|
+
checks.append(_ck("index.path.present", "FAIL", paths["missing"] == 0,
|
|
486
|
+
f"path 缺失/文件不存在 {paths['missing']}"
|
|
487
|
+
+ ("" if check_paths else "(--no-path-check 未查盘)")))
|
|
488
|
+
checks.append(_ck("index.layer.dir.match", "FAIL", paths["layer_mismatch"] == 0,
|
|
489
|
+
f"层-目录不一致 {paths['layer_mismatch']}(9-15 基线=0)"))
|
|
490
|
+
top_dup = dup["largest"][0] if dup["largest"] else 0
|
|
491
|
+
checks.append(_ck("dup.content.no_blowup", "FAIL", top_dup <= DUP_GROUP_MAX,
|
|
492
|
+
f"内容指纹重复组 {dup['groups']} / 涉及节点 {dup['nodes']}"
|
|
493
|
+
f" / 最大组 {dup['largest'][:3]}(最大组上限 {DUP_GROUP_MAX})"))
|
|
494
|
+
|
|
495
|
+
# ---- 健康指标(只告警)----
|
|
496
|
+
# 生效条件:val 为 None 或片段外闭包布尔 small 为真(small、n、T 均未在本片段定义)时追加 level="BLINDSPOT" 项;否则追加 level="WARN"、ok=(val>=low) 的项;两分支均无返回值;
|
|
497
|
+
def _ratio(cid, val, low, name):
|
|
498
|
+
if small or val is None:
|
|
499
|
+
checks.append(_ck(cid, "BLINDSPOT", True,
|
|
500
|
+
f"{name} 不可判(样本 {n} < {T['min_nodes']} / 数据源缺失)"))
|
|
501
|
+
return
|
|
502
|
+
checks.append(_ck(cid, "WARN", val >= low, f"{name}={val * 100:.1f}%(下限 {low:.0%})"))
|
|
503
|
+
|
|
504
|
+
mr = None if small else cov["mixed_ratio"]
|
|
505
|
+
checks.append(_ck("stratum.mixed_ratio",
|
|
506
|
+
"BLINDSPOT" if mr is None else "WARN",
|
|
507
|
+
mr is None or mr <= T["stratum_ratio_max"],
|
|
508
|
+
"混层比(knowledge 中 doc∪code 标签)=N/A(样本不足)" if mr is None else
|
|
509
|
+
f"混层比(knowledge 中 doc∪code 标签)={mr * 100:.1f}%"
|
|
510
|
+
f"(上限 {T['stratum_ratio_max']:.0%},治理靶 {T['stratum_target']:.0%})"))
|
|
511
|
+
_ratio("stratum.role_coverage", cov["role_ratio_kn"], T["role_coverage_min"],
|
|
512
|
+
"role 覆盖率[knowledge]")
|
|
513
|
+
_ratio("stratum.evidence_coverage", cov["evidence_ratio_kn"],
|
|
514
|
+
T["evidence_coverage_min"], "evidence 覆盖率[knowledge]")
|
|
515
|
+
_ratio("analysis.coverage", 1 - un["ratio"], T["analysis_coverage_min"],
|
|
516
|
+
f"分析覆盖率(非 unanalyzed;unanalyzed={un['count']})")
|
|
517
|
+
_ratio("reach.ratio", None if small else reach["ratio"], T["reach_ratio_min"], "触达率")
|
|
518
|
+
checks.append(_ck("gate.sample", "WARN",
|
|
519
|
+
gate["decisions_total"] >= T["gate_sample_min"],
|
|
520
|
+
f"闸门裁决样本 {gate['decisions_total']} 条 {gate['decisions']}"
|
|
521
|
+
f"(下限 {T['gate_sample_min']})"))
|
|
522
|
+
|
|
523
|
+
# ---- 记忆动词协议 v1 静态对账(声明 ↔ MCP 面实现,纯源码事实、不连库)----
|
|
524
|
+
# 与 G1 的分工:G1 对账**数据值域**,这里对账**动词面**——两者都是
|
|
525
|
+
# 「声明了没做 / 做了没说」的前置红灯,属结构性不变量(FAIL 级,fail-closed)。
|
|
526
|
+
from . import protocol as _proto
|
|
527
|
+
pa = _proto.audit()
|
|
528
|
+
checks.append(_ck("protocol.op.extension_surface", "WARN", True,
|
|
529
|
+
f"协议 v{pa['protocol_version']} 冻结面={pa['declared']}"
|
|
530
|
+
f"(live {len(pa['live'])} / reserved {len(pa['reserved'])});"
|
|
531
|
+
f"MCP 面另有 {len(pa['extension_ops'])} 个扩展 op 不属协议面"
|
|
532
|
+
f"(文档一致性由 cogmap 门禁承担)"))
|
|
533
|
+
checks.append(_ck("protocol.verb.implemented", "FAIL",
|
|
534
|
+
not pa["missing_impl"],
|
|
535
|
+
f"声明为 live 的动词 {pa['live']} 均有实现分支"
|
|
536
|
+
if not pa["missing_impl"] else
|
|
537
|
+
f"声明为 live 却无实现分支:{pa['missing_impl']}"))
|
|
538
|
+
checks.append(_ck("protocol.verb.reserved_clean", "FAIL",
|
|
539
|
+
not pa["reserved_leaked"],
|
|
540
|
+
f"reserved 动词 {pa['reserved']} 未出现实现分支"
|
|
541
|
+
if not pa["reserved_leaked"] else
|
|
542
|
+
f"reserved 动词被静默实现(须先改 status=live):"
|
|
543
|
+
f"{pa['reserved_leaked']}"))
|
|
544
|
+
checks.append(_ck("protocol.shape.declared", "FAIL",
|
|
545
|
+
not pa["shape_errors"],
|
|
546
|
+
f"{len(pa['declared'])} 个动词形状声明完备"
|
|
547
|
+
if not pa["shape_errors"] else
|
|
548
|
+
f"形状声明不完整:{pa['shape_errors']}"))
|
|
549
|
+
|
|
550
|
+
# ---- 基线不劣化(有 baseline 时才可判)----
|
|
551
|
+
if baseline:
|
|
552
|
+
checks += _regression({"mixed_ratio": cov["mixed_ratio"],
|
|
553
|
+
"non_canonical": edges["non_canonical"],
|
|
554
|
+
"dangling": edges["dangling"],
|
|
555
|
+
"dup_groups": dup["groups"],
|
|
556
|
+
"unanalyzed": un["count"]}, baseline)
|
|
557
|
+
|
|
558
|
+
fails = [c for c in checks if c["level"] == "FAIL" and not c["ok"]]
|
|
559
|
+
warns = [c for c in checks if c["level"] == "WARN" and not c["ok"]]
|
|
560
|
+
blind = [c for c in checks if c["level"] == "BLINDSPOT"]
|
|
561
|
+
v = "FAIL" if fails else ("WARN" if (warns or (strict and blind)) else "PASS")
|
|
562
|
+
return {"report_version": REPORT_VERSION, "t": t0, "elapsed_s": round(time.time() - t0, 2),
|
|
563
|
+
"root": os.path.abspath(root), "verdict": v,
|
|
564
|
+
"nodes": n, "checks": checks,
|
|
565
|
+
"counts": {"fail": len(fails), "warn": len(warns), "blindspot": len(blind),
|
|
566
|
+
"total": len(checks)},
|
|
567
|
+
"coverage": cov, "dup": dup, "edges": edges, "paths": paths,
|
|
568
|
+
"gate": gate, "reach": reach, "unanalyzed": un, "g1": g1,
|
|
569
|
+
"protocol": pa, "thresholds": T}
|
|
570
|
+
|
|
571
|
+
|
|
572
|
+
# 生效条件:对 cur 各键,baseline(或其 metrics)缺失、该键在基线为 None 或 cur 值为 None 时跳过;否则以 val > b+1e-9 判劣化,产出 level 恒为 "FAIL"、ok=not worse 的检查项;
|
|
573
|
+
def _regression(cur: dict, baseline: dict) -> list:
|
|
574
|
+
"""与基线比对:单调量只准不变或改善(重复度/悬空/非规范键/混层/unanalyzed)。
|
|
575
|
+
|
|
576
|
+
只收**单调有害量**(越大越坏);触达率等随运行时间自然增长的量不进比对,
|
|
577
|
+
否则日志轮转即误报。
|
|
578
|
+
"""
|
|
579
|
+
base = (baseline or {}).get("metrics") or {}
|
|
580
|
+
out = []
|
|
581
|
+
for key, val in cur.items():
|
|
582
|
+
b = base.get(key)
|
|
583
|
+
if b is None or val is None:
|
|
584
|
+
continue
|
|
585
|
+
worse = val > b + 1e-9
|
|
586
|
+
out.append(_ck(f"baseline.{key}", "FAIL", not worse,
|
|
587
|
+
f"现值 {val:.4f} vs 基线 {b:.4f}"
|
|
588
|
+
+ ("(劣化)" if worse else "(未劣化)")))
|
|
589
|
+
return out
|
|
590
|
+
|
|
591
|
+
|
|
592
|
+
# 生效条件:rep 含 coverage/edges/dup/unanalyzed/gate/reach 子字典与 nodes 键时(全部按下标取值,缺键即抛 KeyError)返回扁平指标映射;
|
|
593
|
+
def metrics_of(rep: dict) -> dict:
|
|
594
|
+
"""抽成可比对的扁平指标(--baseline 的写入面)。"""
|
|
595
|
+
return {"mixed_ratio": rep["coverage"]["mixed_ratio"],
|
|
596
|
+
"non_canonical": rep["edges"]["non_canonical"],
|
|
597
|
+
"dangling": rep["edges"]["dangling"],
|
|
598
|
+
"dup_groups": rep["dup"]["groups"],
|
|
599
|
+
"unanalyzed": rep["unanalyzed"]["count"],
|
|
600
|
+
"nodes": rep["nodes"],
|
|
601
|
+
"role_ratio": rep["coverage"]["role_ratio"],
|
|
602
|
+
"basis_ratio": rep["coverage"]["basis_ratio"],
|
|
603
|
+
"evidence_ratio": rep["coverage"]["evidence_ratio"],
|
|
604
|
+
"role_ratio_kn": rep["coverage"]["role_ratio_kn"],
|
|
605
|
+
"evidence_ratio_kn": rep["coverage"]["evidence_ratio_kn"],
|
|
606
|
+
"reach_ratio": rep["reach"]["ratio"],
|
|
607
|
+
"gate_decisions": rep["gate"]["decisions_total"]}
|
|
608
|
+
|
|
609
|
+
|
|
610
|
+
# ---------------------------- 报告 ----------------------------
|
|
611
|
+
|
|
612
|
+
# 生效条件:rep 各键齐备(按下标取值,任一键缺失抛 KeyError)时拼接为多行文本,reach.ratio 为 None 时渲染 "N/A",g1 中以 "_" 开头的键在遍历中被跳过;
|
|
613
|
+
def render(rep: dict) -> str:
|
|
614
|
+
L = []
|
|
615
|
+
a = L.append
|
|
616
|
+
a(f"== conformance v{rep['report_version']} · {rep['root']}")
|
|
617
|
+
a(f" verdict: {rep['verdict']} nodes={rep['nodes']} "
|
|
618
|
+
f"checks={rep['counts']['total']} (fail {rep['counts']['fail']} / "
|
|
619
|
+
f"warn {rep['counts']['warn']} / blindspot {rep['counts']['blindspot']})")
|
|
620
|
+
a("\n-- 断言集(FAIL=fail-closed 不变量 / WARN=健康指标只告警)--")
|
|
621
|
+
for c in rep["checks"]:
|
|
622
|
+
mark = {"FAIL": "!!", "WARN": " ?", "BLINDSPOT": " ~"}.get(c["level"], " .")
|
|
623
|
+
ok = "ok " if c["ok"] else "NO "
|
|
624
|
+
a(f" [{mark}] {ok}{c['id']}: {c['detail']}")
|
|
625
|
+
c = rep["coverage"]
|
|
626
|
+
a(f"\n-- 口径复核(9-15 基线)--")
|
|
627
|
+
a(f" nodes={c['nodes']} knowledge={c['knowledge']} 混层={c['mixed_layer']}"
|
|
628
|
+
f" ({c['mixed_ratio'] * 100:.1f}%)")
|
|
629
|
+
a(f" dir_mismatch={rep['paths']['layer_mismatch']} path_missing={rep['paths']['missing']}")
|
|
630
|
+
a(f" 覆盖率[knowledge 层·判据口径] role={c['role_ratio_kn'] * 100:.3f}%"
|
|
631
|
+
f" basis={c['basis_ratio_kn'] * 100:.1f}% evidence={c['evidence_ratio_kn'] * 100:.3f}%")
|
|
632
|
+
a(f" 覆盖率为对照[全库口径] role={c['role_ratio'] * 100:.2f}%"
|
|
633
|
+
f" basis={c['basis_ratio'] * 100:.1f}% evidence={c['evidence_ratio'] * 100:.2f}%"
|
|
634
|
+
f" state={c['state_ratio'] * 100:.1f}%")
|
|
635
|
+
a(f" 重复 content_hash 组={rep['dup']['groups']} 节点={rep['dup']['nodes']}"
|
|
636
|
+
f" 最大组={rep['dup']['largest'][:3]}")
|
|
637
|
+
a(f" 边 total={rep['edges']['total']} 非规范键={rep['edges']['non_canonical']}"
|
|
638
|
+
f" 悬空={rep['edges']['dangling']} 类型={rep['edges']['types']}")
|
|
639
|
+
r = rep["reach"]
|
|
640
|
+
a(f" 触达 distinct={r['distinct']} ratio="
|
|
641
|
+
+ ("N/A" if r['ratio'] is None else f"{r['ratio'] * 100:.1f}%") + f" log_lines={r['lines']}")
|
|
642
|
+
a(f" 闸门 decisions={rep['gate']['decisions_total']} {rep['gate']['decisions']}"
|
|
643
|
+
f" inbox_pending={rep['gate']['inbox_pending']}")
|
|
644
|
+
a(f" 审计 op(尾窗 {rep['gate']['audit_tail_lines']}"
|
|
645
|
+
f"/{rep['gate']['audit_tail_window']} 行)={rep['gate']['audit_ops']}")
|
|
646
|
+
a(f" G3 unanalyzed 派生={rep['unanalyzed']['count']}"
|
|
647
|
+
f" ({rep['unanalyzed']['ratio'] * 100:.1f}%)")
|
|
648
|
+
pr = rep.get("protocol") or {}
|
|
649
|
+
if pr:
|
|
650
|
+
a("\n-- 记忆动词协议 v1 静态对账 --")
|
|
651
|
+
a(f" {pr['doc']} frozen={pr['frozen']} ok={pr['ok']}")
|
|
652
|
+
a(f" 声明={pr['declared']}")
|
|
653
|
+
a(f" live={pr['live']} reserved={pr['reserved']}(未实现即如实登记,不冒充)")
|
|
654
|
+
a(f" MCP 面 op 分支={len(pr['actual'])} 个,其中扩展能力面"
|
|
655
|
+
f"(不属协议 v1){len(pr['extension_ops'])} 个")
|
|
656
|
+
if pr["errors"]:
|
|
657
|
+
for e in pr["errors"]:
|
|
658
|
+
a(f" !! {e}")
|
|
659
|
+
a("\n-- G1 类型空间正交性 --")
|
|
660
|
+
for name, spec in rep["g1"].items():
|
|
661
|
+
if name.startswith("_"):
|
|
662
|
+
continue
|
|
663
|
+
a(f" [{name}] 源={spec['source']} 封闭={spec['closed']}")
|
|
664
|
+
a(f" 实测={spec['used']}")
|
|
665
|
+
if spec["undeclared_used"]:
|
|
666
|
+
a(f" ★未声明已用={spec['undeclared_used']}")
|
|
667
|
+
if spec["declared_unused"]:
|
|
668
|
+
a(f" 声明未用={spec['declared_unused']}")
|
|
669
|
+
a(f" 跨空间重叠={rep['g1']['_cross_space_overlap'] or '无'}")
|
|
670
|
+
a(f" 方向口径分歧={[d['literal'] for d in rep['g1']['_direction_conflicts']]}")
|
|
671
|
+
a(f" 已核对无分歧={[d['literal'] for d in rep['g1']['_verified_consistent']]}")
|
|
672
|
+
a(f" 文档滞后于代码={[d['where'] for d in rep['g1']['_doc_code_drift']]}")
|
|
673
|
+
a(f" 新增类型触点={rep['g1']['_new_type_touchpoints']}")
|
|
674
|
+
return "\n".join(L)
|
|
675
|
+
|
|
676
|
+
|
|
677
|
+
# 生效条件:传入对象可写属性时执行赋值 sustain_module.conformance_summary = report_summary,无返回值(None);
|
|
678
|
+
def register_sustain(sustain_module) -> None: # pragma: no cover
|
|
679
|
+
"""挂点说明(供 sustain 侧最小侵入调用)。
|
|
680
|
+
|
|
681
|
+
周期巡检**不加新 tick**:`_tick_tidy()` 已是「contextual 存量治理」的
|
|
682
|
+
读侧巡检,本断言集复用同一节奏(tidy_interval),由 `report_summary(cg)`
|
|
683
|
+
只取结论不落盘——避免为只读检查新增后台周期与 env 开关。
|
|
684
|
+
"""
|
|
685
|
+
sustain_module.conformance_summary = report_summary
|
|
686
|
+
|
|
687
|
+
|
|
688
|
+
# 生效条件:root 依次取 cg_or_root.root 属性、cg_or_root 本身、_default_root()(前者为假值即回落,故 0/空串会继续回落);check 抛异常时返回 ok=False、verdict="BLINDSPOT"、error,否则返回 ok=(verdict!="FAIL") 与 fail/warn/blindspot/failed_ids/t;
|
|
689
|
+
def report_summary(cg_or_root) -> dict:
|
|
690
|
+
"""给常驻循环用的**轻量**结论(不渲染全文、不写盘):verdict + 计数。"""
|
|
691
|
+
root = getattr(cg_or_root, "root", None) or cg_or_root or _default_root()
|
|
692
|
+
try:
|
|
693
|
+
rep = check(root, check_paths=False)
|
|
694
|
+
except Exception as e: # noqa: BLE001
|
|
695
|
+
return {"ok": False, "verdict": "BLINDSPOT", "error": f"{type(e).__name__}: {e}"}
|
|
696
|
+
return {"ok": rep["verdict"] != "FAIL", "verdict": rep["verdict"],
|
|
697
|
+
"fail": rep["counts"]["fail"], "warn": rep["counts"]["warn"],
|
|
698
|
+
"blindspot": rep["counts"]["blindspot"],
|
|
699
|
+
"failed_ids": [c["id"] for c in rep["checks"]
|
|
700
|
+
if c["level"] == "FAIL" and not c["ok"]],
|
|
701
|
+
"t": rep["t"]}
|
|
702
|
+
|
|
703
|
+
|
|
704
|
+
# 生效条件:argv 为 None 时 argparse 从 sys.argv 取值,--root 缺失或为假值回落 _default_root();check 抛 OSError/ValueError(如索引不可读)时打印 BLINDSPOT 并返回 2,否则按 --write-baseline/--json 写盘后返回 0(verdict≠"FAIL")或 1("FAIL");
|
|
705
|
+
def main(argv=None) -> int:
|
|
706
|
+
p = argparse.ArgumentParser(prog="python -m md_cg.conformance",
|
|
707
|
+
description="数据健康不变量断言集(只读,零写入)")
|
|
708
|
+
p.add_argument("--root", default=None,
|
|
709
|
+
help="认知图根(默认 MDCG_ROOT > paths.json > 用户级状态根 data/mdcg)")
|
|
710
|
+
p.add_argument("--json", dest="json_out", default=None)
|
|
711
|
+
p.add_argument("--baseline", default=None, help="基线报告 json(比对不劣化)")
|
|
712
|
+
p.add_argument("--write-baseline", default=None, help="把本次指标写成新基线")
|
|
713
|
+
p.add_argument("--no-path-check", action="store_true", help="不查盘上文件是否存在")
|
|
714
|
+
p.add_argument("--strict", action="store_true", help="BLINDSPOT 也视为非 PASS")
|
|
715
|
+
a = p.parse_args(argv)
|
|
716
|
+
|
|
717
|
+
root = a.root or _default_root()
|
|
718
|
+
baseline = None
|
|
719
|
+
if a.baseline:
|
|
720
|
+
with open(a.baseline, encoding="utf-8") as f:
|
|
721
|
+
baseline = json.load(f)
|
|
722
|
+
try:
|
|
723
|
+
rep = check(root, check_paths=not a.no_path_check,
|
|
724
|
+
baseline=baseline, strict=a.strict)
|
|
725
|
+
except (OSError, ValueError) as e:
|
|
726
|
+
# 数据源不可读 = BLINDSPOT(如实上报),绝不打印「通过」
|
|
727
|
+
print(f"== conformance v{REPORT_VERSION} · {os.path.abspath(root)}")
|
|
728
|
+
print(f" verdict: BLINDSPOT —— 索引不可读: {type(e).__name__}: {e}")
|
|
729
|
+
print(f" 缺失维度: 数据源({INDEX_FILE});修复后重跑,勿以本结果为「通过」。")
|
|
730
|
+
return 2
|
|
731
|
+
print(render(rep))
|
|
732
|
+
if a.write_baseline:
|
|
733
|
+
with open(a.write_baseline, "w", encoding="utf-8") as f:
|
|
734
|
+
json.dump({"report_version": REPORT_VERSION, "t": rep["t"],
|
|
735
|
+
"root": rep["root"], "metrics": metrics_of(rep)},
|
|
736
|
+
f, ensure_ascii=False, indent=2)
|
|
737
|
+
print(f"\n 基线已写入: {a.write_baseline}")
|
|
738
|
+
if a.json_out:
|
|
739
|
+
with open(a.json_out, "w", encoding="utf-8") as f:
|
|
740
|
+
json.dump(rep, f, ensure_ascii=False, indent=2, default=str)
|
|
741
|
+
print(f" 报告已写入: {a.json_out}")
|
|
742
|
+
return 0 if rep["verdict"] != "FAIL" else 1
|
|
743
|
+
|
|
744
|
+
|
|
745
|
+
if __name__ == "__main__":
|
|
746
|
+
if hasattr(sys.stdout, "reconfigure"):
|
|
747
|
+
sys.stdout.reconfigure(encoding="utf-8", errors="replace")
|
|
727
748
|
sys.exit(main())
|