@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
|
@@ -1,1032 +1,1053 @@
|
|
|
1
|
-
# -*- coding: utf-8 -*-
|
|
2
|
-
"""ref 增量索引 + 漂移/悬空巡检(P28 · R3 改造验收)。
|
|
3
|
-
|
|
4
|
-
对照 `docs/mdcg/认知图_索引与工程规范化_计划_v0.1.md` 的 R3:
|
|
5
|
-
|
|
6
|
-
① 统一 ref 协议 + 提取器注册表:调用方只说 `kind`,`refindex` 决定用哪个
|
|
7
|
-
提取器;无提取器后缀显式报错。
|
|
8
|
-
② `_refindex.json` 增量(修 F):`incremental=True` 时未变文件**不再读盘重切**
|
|
9
|
-
(`skipped_unchanged`),节点仍在(幂等);默认全量,保证「不漏召回」。
|
|
10
|
-
③ `op=ref action=check` 漂移/悬空巡检(修 D):改源一行 → 报 `stale`;删除源
|
|
11
|
-
文件 → 报 `dangling`;**只读、不抛、不改源文件**。
|
|
12
|
-
④ `op=ref action=stat`:看水位,最近一次索引是否被截断(`truncated` 不再静默)。
|
|
13
|
-
⑤ 接入 `sustain.diagnose`:`ref_stale` / `ref_dangling` 进入体检;`heal` 的
|
|
14
|
-
`rebuild_refs` 重建派生物后漂移消除(源文件不动)。
|
|
15
|
-
⑥ 检索结果带 `ref` / `ref_kind`(读侧只加字段,不改召回逻辑)。
|
|
16
|
-
⑦ 派生物不膨胀:`_refindex.json` 体积有界、重跑不涨。
|
|
17
|
-
⑧ **判据分工**(#4):漂移 / 悬空只由**节点自身 frontmatter ref** 判,水位只判
|
|
18
|
-
「这个节点能不能跳过、不读源」(五项全等 + 源 size/mtime 未变 + 同 id 只判一次);
|
|
19
|
-
水位与节点不一致记 `ledger_mismatch` 归因行(带两侧 root),**不进 ok、不重复报红**。
|
|
20
|
-
⑨ **撞 id 现场**(D1 现状钉子):两域同 rel path + 同 name ⇒ 同 id、节点被后写域覆盖,
|
|
21
|
-
但归因行可见。本组断言**现状事实**(+ 去重 + 归因字段),不作期望语义断言——
|
|
22
|
-
`node_id` 一旦改为含 root,① 会转红以提示同步迁移。
|
|
23
|
-
⑩ **口径钉子**(#5):id 是**位置化**寻址(`sha1(路径::符号名)` / `sha1(路径#标题路径)`),
|
|
24
|
-
幂等判据是**区间哈希 + 行位全等**(不是「id 存在即已索引」)。两侧都钉——实现侧
|
|
25
|
-
手算 sha1 独立复算 + 对 root / 正文 / 行位不敏感 + 五项逐项不跳过;文档侧
|
|
26
|
-
`docs/plans/真源索引_通用机制_v0.3.md` §3.1 的口径字面、整块指纹(**陈化硬失败**)
|
|
27
|
-
与行级引用必须仍与实现同源(引用漂移即红,失败信息附现址)。
|
|
28
|
-
⑪ **常驻循环止血**:`SustainLoop._tick_heal` 按 `repeat_guard=True` 调 heal——同因重复
|
|
29
|
-
失败被拦下(`repeat_failure` + 退避)而**诊断面照旧报病灶**(判据不被削弱)、
|
|
30
|
-
`heals[*].failed` 单列(没修好不静默、不假装成功)。
|
|
31
|
-
红基线(判别力自证,见 `_MUTATIONS` / `EXPECTED_RED`):`--head-baseline` 对
|
|
32
|
-
**工作区 `md_cg/refindex.py`** 做定点变异(快路径探测数据改回水位条目=v1 旧行为),
|
|
33
|
-
断言红项集合**恰好**等于预期三项(⑩ / ⑪ 两段钉的是别的语义,变异态下**仍绿**,
|
|
34
|
-
故不入红项表——「恰好」二字正是这么被守住的)。
|
|
35
|
-
|
|
36
|
-
运行:python -m md_cg.test_p28_refcheck [--head-baseline]
|
|
37
|
-
"""
|
|
38
|
-
from __future__ import annotations
|
|
39
|
-
|
|
40
|
-
import argparse
|
|
41
|
-
import hashlib
|
|
42
|
-
import os
|
|
43
|
-
import re
|
|
44
|
-
import shutil
|
|
45
|
-
import sys
|
|
46
|
-
import tempfile
|
|
47
|
-
import time
|
|
48
|
-
|
|
49
|
-
from . import corpus, refindex, sources, sustain, tokens
|
|
50
|
-
from .mdcg import MdCG
|
|
51
|
-
from .mcp_server import call_tool
|
|
52
|
-
|
|
53
|
-
PASS = FAIL = 0
|
|
54
|
-
FAILS = []
|
|
55
|
-
RED = [] # 转红项 cid(红基线模式比对用;绿态为空)
|
|
56
|
-
|
|
57
|
-
_BASE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
|
58
|
-
ROOT = os.path.join(_BASE, "_md_cg_p28")
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
def check(name, cond, detail="", cid=None):
|
|
62
|
-
global PASS, FAIL
|
|
63
|
-
if cond:
|
|
64
|
-
PASS += 1
|
|
65
|
-
print(f" [PASS] {name}" + (f" · {detail}" if detail else ""))
|
|
66
|
-
else:
|
|
67
|
-
FAIL += 1
|
|
68
|
-
FAILS.append(name)
|
|
69
|
-
# 无 cid 的失败记哨兵:红基线模式下它会与预期红项不等 ⇒ fail-closed,
|
|
70
|
-
# 不静默放过「变异波及了没被登记的断言」(同 test_logref.py:66 的口径)。
|
|
71
|
-
RED.append(cid or ("?" + name))
|
|
72
|
-
print(f" [FAIL] {name} · {detail}")
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
ALPHA = ('"""能量计算模块。"""\n'
|
|
76
|
-
'import math\n'
|
|
77
|
-
'\n'
|
|
78
|
-
'\n'
|
|
79
|
-
'def compute_energy(mass, speed):\n'
|
|
80
|
-
' """计算动能。"""\n'
|
|
81
|
-
' return mass * speed * speed\n'
|
|
82
|
-
'\n'
|
|
83
|
-
'\n'
|
|
84
|
-
'class Reactor:\n'
|
|
85
|
-
' """反应堆模型。"""\n'
|
|
86
|
-
'\n'
|
|
87
|
-
' def ignite(self):\n'
|
|
88
|
-
' """点火。"""\n'
|
|
89
|
-
' self.state = "on"\n')
|
|
90
|
-
|
|
91
|
-
# 同函数同区间,只改一行实现 → 行数不变,只有区间哈希变(最强的漂移信号)
|
|
92
|
-
ALPHA_DRIFT = ALPHA.replace("return mass * speed * speed",
|
|
93
|
-
"return 0.5 * mass * speed * speed")
|
|
94
|
-
# 第二个漂移变体:段⑤ 已把源改成 ALPHA_DRIFT 并重建索引,段⑨ 要再制造一次真实漂移,
|
|
95
|
-
# 必须写出**与当前索引内容不同**的正文;否则只是 mtime 变了、内容没变,报 ok 才对。
|
|
96
|
-
ALPHA_DRIFT2 = ALPHA.replace("return mass * speed * speed",
|
|
97
|
-
"return mass * speed * speed / 2.0")
|
|
98
|
-
ALPHA_MARK2 = "speed * speed / 2.0"
|
|
99
|
-
|
|
100
|
-
BETA = ('"""辅助模块。"""\n'
|
|
101
|
-
'\n'
|
|
102
|
-
'\n'
|
|
103
|
-
'def helper_scale(x):\n'
|
|
104
|
-
' """缩放。"""\n'
|
|
105
|
-
' return x * 2\n')
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
def rd(path):
|
|
109
|
-
with open(path, encoding="utf-8") as f:
|
|
110
|
-
return f.read()
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
def wr(path, text, bump=0.0):
|
|
114
|
-
with open(path, "w", encoding="utf-8") as f:
|
|
115
|
-
f.write(text)
|
|
116
|
-
if bump:
|
|
117
|
-
# 显式推后 mtime:粗粒度文件系统上保证「变了」能被水位看见
|
|
118
|
-
t = os.path.getmtime(path) + bump
|
|
119
|
-
os.utime(path, (t, t))
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
def index_read(cg, code_dir, **extra):
|
|
123
|
-
a = {"op": "index_code", "path": code_dir}
|
|
124
|
-
a.update(extra)
|
|
125
|
-
return call_tool(cg, "cg", a)
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
def ref_read(cg, **args):
|
|
129
|
-
a = {"op": "ref"}
|
|
130
|
-
a.update(args)
|
|
131
|
-
return call_tool(cg, "cg", a)
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
# ---------------- 6 判据分工:节点 ref 判漂移,水位只判跳过 ----------------
|
|
135
|
-
|
|
136
|
-
#: 合成源:改一行实现 → 行数不变、只有区间哈希变(最强的漂移信号,同 ALPHA_DRIFT)。
|
|
137
|
-
PROBE_SRC = ('"""probe 模块。"""\n'
|
|
138
|
-
'\n'
|
|
139
|
-
'\n'
|
|
140
|
-
'def probe_fn(x):\n'
|
|
141
|
-
' """probe 函数。"""\n'
|
|
142
|
-
' return x + 1\n')
|
|
143
|
-
PROBE_SRC2 = PROBE_SRC.replace("return x + 1", "return x + 2")
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
def _mk(tmp, name):
|
|
147
|
-
d = os.path.join(tmp, name)
|
|
148
|
-
os.makedirs(d)
|
|
149
|
-
return d
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
def _index_into(cg, src, ledger=None):
|
|
153
|
-
"""直调 refindex 的两步(index_dir → add_items),返回本轮节点 id。
|
|
154
|
-
|
|
155
|
-
必须直调:`op=index_code` 是这两步的**连写**,表达不了「只写一侧」的分歧。
|
|
156
|
-
"""
|
|
157
|
-
items, _errors, _stats = refindex.index_dir(src, kind="code_ref",
|
|
158
|
-
ledger=ledger)
|
|
159
|
-
ids, _sens = refindex.add_items(cg, items, kind="code_ref", root=src)
|
|
160
|
-
return ids
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
def _tamper_ref_hash(node_path, fake="deadbeefcafe"):
|
|
164
|
-
"""把节点 .md 里 frontmatter 的 ref 哈希改成假值(源与水位都不动)。
|
|
165
|
-
|
|
166
|
-
`cg.get` 每次从盘上读节点,故改 .md 即改「节点自述」;水位条目不受影响——
|
|
167
|
-
这正是「漂移只由节点 ref 判」要区分的场景(v1 拿水位当探测数据 ⇒ 静默)。
|
|
168
|
-
"""
|
|
169
|
-
with open(node_path, encoding="utf-8") as f:
|
|
170
|
-
txt = f.read()
|
|
171
|
-
out = re.sub(r'"hash": "[0-9a-f]{12}"', '"hash": "%s"' % fake, txt, count=1)
|
|
172
|
-
if out == txt:
|
|
173
|
-
raise RuntimeError("夹具失效:节点 frontmatter 里没有可篡改的 ref.hash")
|
|
174
|
-
with open(node_path, "w", encoding="utf-8") as f:
|
|
175
|
-
f.write(out)
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
def _verdict(res):
|
|
179
|
-
"""巡检结果 → 去重/归因视角的摘要(红基线断言只看这里)。"""
|
|
180
|
-
ids = [r.get("node_id") for r in list(res.get("stale") or [])
|
|
181
|
-
+ list(res.get("dangling") or [])]
|
|
182
|
-
return {"ok": res["ok"], "ids": ids, "dup": len(ids) - len(set(ids)),
|
|
183
|
-
"mm": res.get("ledger_mismatch") or [],
|
|
184
|
-
"mm_count": res.get("ledger_mismatch_count", 0)}
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
def guard_verdict_owner(tmp):
|
|
188
|
-
"""三组构造:水位与节点分别推到不同代,看快路径认谁(直调 refindex)。"""
|
|
189
|
-
# ①水位新、节点旧 —— 等价 mcp_server.py 的 index_dir→add_items 之间被杀
|
|
190
|
-
lib = _mk(tmp, "fo_lib")
|
|
191
|
-
src = _mk(tmp, "fo_src")
|
|
192
|
-
p = os.path.join(src, "probe_widget.py")
|
|
193
|
-
wr(p, PROBE_SRC)
|
|
194
|
-
cg = MdCG(lib)
|
|
195
|
-
ids = _index_into(cg, src, refindex.Ledger(lib))
|
|
196
|
-
cg.flush()
|
|
197
|
-
wr(p, PROBE_SRC2, bump=5.0)
|
|
198
|
-
refindex.index_dir(src, kind="code_ref", ledger=refindex.Ledger(lib))
|
|
199
|
-
res = refindex.check_refs(cg, ledger=refindex.Ledger(lib))
|
|
200
|
-
v = _verdict(res)
|
|
201
|
-
node_hashes = {refindex.ref_of(cg.get(n))[1]["hash"] for n in ids}
|
|
202
|
-
check("6①只推水位:ok=False(漂移由节点 ref 判,水位说了不算)",
|
|
203
|
-
res["ok"] is False, f"ok={res['ok']} stale={len(res['stale'])}", cid="A1")
|
|
204
|
-
check("6①stale 覆盖该文件全部节点,hash_expected 取节点 ref(不是水位新哈希)",
|
|
205
|
-
{r["node_id"] for r in res["stale"]} == set(ids)
|
|
206
|
-
and {r["hash_expected"] for r in res["stale"]} == node_hashes,
|
|
207
|
-
f"stale={sorted(r['node_id'] for r in res['stale'])}", cid="A1")
|
|
208
|
-
check("6①水位/节点不一致记归因行 watermark_behind(写序断裂可见,不进 ok)",
|
|
209
|
-
v["mm_count"] >= 1
|
|
210
|
-
and all(r["kind_of_gap"] == "watermark_behind" for r in v["mm"]),
|
|
211
|
-
str(v["mm"][:1]), cid="A2")
|
|
212
|
-
|
|
213
|
-
# ②节点新、水位旧 —— ledger 根本不参与,才算「只推节点」
|
|
214
|
-
lib = _mk(tmp, "fn_lib")
|
|
215
|
-
src = _mk(tmp, "fn_src")
|
|
216
|
-
p = os.path.join(src, "probe_widget.py")
|
|
217
|
-
wr(p, PROBE_SRC)
|
|
218
|
-
cg = MdCG(lib)
|
|
219
|
-
_index_into(cg, src, refindex.Ledger(lib))
|
|
220
|
-
cg.flush()
|
|
221
|
-
wr(p, PROBE_SRC2, bump=5.0)
|
|
222
|
-
_index_into(cg, src, ledger=None) # 全量重切,水位不动
|
|
223
|
-
cg.flush()
|
|
224
|
-
res = refindex.check_refs(cg, ledger=refindex.Ledger(lib))
|
|
225
|
-
v = _verdict(res)
|
|
226
|
-
check("6②只推节点:ok=True 且 stale/dangling 空(旧水位不得误报漂移)",
|
|
227
|
-
res["ok"] is True and not res["stale"] and not res["dangling"],
|
|
228
|
-
f"ok={res['ok']} stale={sorted(v['ids'])}", cid="B1")
|
|
229
|
-
# 归因面与「红不红」解耦:这里只断言「不一致被记下来了」(ok 由 B1 断),
|
|
230
|
-
# 免得同一次误报把两条断言一起打红、红项表失去「一项一行为」的对应。
|
|
231
|
-
check("6②旧水位与节点不一致仍归因(watermark_behind)",
|
|
232
|
-
v["mm_count"] >= 1
|
|
233
|
-
and all(r["kind_of_gap"] == "watermark_behind" for r in v["mm"]),
|
|
234
|
-
str(v["mm"][:1]), cid="B2")
|
|
235
|
-
|
|
236
|
-
# ③篡改节点 ref.hash(源与水位都不动)—— 只有节点自述变了
|
|
237
|
-
lib = _mk(tmp, "ft_lib")
|
|
238
|
-
src = _mk(tmp, "ft_src")
|
|
239
|
-
p = os.path.join(src, "probe_widget.py")
|
|
240
|
-
wr(p, PROBE_SRC)
|
|
241
|
-
cg = MdCG(lib)
|
|
242
|
-
ids = _index_into(cg, src, refindex.Ledger(lib))
|
|
243
|
-
cg.flush()
|
|
244
|
-
nid = sorted(ids)[0]
|
|
245
|
-
_tamper_ref_hash(os.path.join(lib, cg.index["nodes"][nid]["path"]))
|
|
246
|
-
res = refindex.check_refs(cg, ledger=refindex.Ledger(lib))
|
|
247
|
-
v = _verdict(res)
|
|
248
|
-
check("6③篡改节点 ref.hash(源与水位都不动):必须报 stale",
|
|
249
|
-
res["ok"] is False and any(r["node_id"] == nid for r in res["stale"]),
|
|
250
|
-
f"ok={res['ok']} stale={v['ids']}", cid="C1")
|
|
251
|
-
check("6③同一 node_id 至多一行(去重,不重复报红)", v["dup"] == 0,
|
|
252
|
-
str(v["ids"]), cid="C2")
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
def guard_collision(tmp):
|
|
256
|
-
"""撞 id 现场(D1 状态):钉现状事实 + 去重 + 归因,不作期望语义断言。
|
|
257
|
-
|
|
258
|
-
`node_id` 不含 root ⇒ 两域同 rel path + 同 name 时撞 id、节点被**后写域**覆盖
|
|
259
|
-
(`add_items` 同 id upsert 整条替换)。本组断言这个**现状**(以及归因行可见、
|
|
260
|
-
不重复报红);键一旦改为含 root,第一条会转红以提示同步迁移——那是迁移触发器,
|
|
261
|
-
不是要实现的期望语义(见 docs/plans/真源索引_通用机制_v0.3.md「id 语义与设计债」)。
|
|
262
|
-
"""
|
|
263
|
-
lib = _mk(tmp, "fc_lib")
|
|
264
|
-
domA = _mk(tmp, "fc_domA")
|
|
265
|
-
domB = _mk(tmp, "fc_domB")
|
|
266
|
-
for d in (domA, domB):
|
|
267
|
-
wr(os.path.join(d, "probe_widget.py"), PROBE_SRC)
|
|
268
|
-
cg = MdCG(lib)
|
|
269
|
-
ids_a = _index_into(cg, domA, refindex.Ledger(lib))
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
check("7
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
check("7
|
|
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
|
-
check("12
|
|
346
|
-
|
|
347
|
-
and
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
src
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
cg
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
domA
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
cg
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
check("12
|
|
419
|
-
bool(
|
|
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
|
-
|
|
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
|
-
|
|
490
|
-
)
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
"""
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
"""
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
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
|
-
codeindex.node_id(
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
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
|
-
cid="
|
|
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
|
-
sustain.
|
|
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
|
-
check("14
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
)
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
778
|
-
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
|
|
807
|
-
|
|
808
|
-
|
|
809
|
-
|
|
810
|
-
|
|
811
|
-
|
|
812
|
-
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
|
|
817
|
-
|
|
818
|
-
|
|
819
|
-
|
|
820
|
-
|
|
821
|
-
|
|
822
|
-
|
|
823
|
-
|
|
824
|
-
|
|
825
|
-
|
|
826
|
-
|
|
827
|
-
|
|
828
|
-
|
|
829
|
-
|
|
830
|
-
|
|
831
|
-
|
|
832
|
-
|
|
833
|
-
|
|
834
|
-
|
|
835
|
-
|
|
836
|
-
|
|
837
|
-
|
|
838
|
-
|
|
839
|
-
|
|
840
|
-
|
|
841
|
-
|
|
842
|
-
# ============================================
|
|
843
|
-
print("\n【
|
|
844
|
-
|
|
845
|
-
|
|
846
|
-
check("
|
|
847
|
-
|
|
848
|
-
|
|
849
|
-
|
|
850
|
-
|
|
851
|
-
|
|
852
|
-
|
|
853
|
-
|
|
854
|
-
|
|
855
|
-
|
|
856
|
-
|
|
857
|
-
|
|
858
|
-
|
|
859
|
-
|
|
860
|
-
|
|
861
|
-
|
|
862
|
-
|
|
863
|
-
|
|
864
|
-
|
|
865
|
-
|
|
866
|
-
|
|
867
|
-
check("
|
|
868
|
-
|
|
869
|
-
|
|
870
|
-
|
|
871
|
-
|
|
872
|
-
|
|
873
|
-
check("
|
|
874
|
-
|
|
875
|
-
|
|
876
|
-
|
|
877
|
-
|
|
878
|
-
|
|
879
|
-
|
|
880
|
-
|
|
881
|
-
|
|
882
|
-
|
|
883
|
-
|
|
884
|
-
|
|
885
|
-
|
|
886
|
-
|
|
887
|
-
|
|
888
|
-
|
|
889
|
-
|
|
890
|
-
|
|
891
|
-
|
|
892
|
-
|
|
893
|
-
|
|
894
|
-
|
|
895
|
-
|
|
896
|
-
|
|
897
|
-
|
|
898
|
-
|
|
899
|
-
|
|
900
|
-
check("
|
|
901
|
-
|
|
902
|
-
str(
|
|
903
|
-
check("
|
|
904
|
-
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
|
|
911
|
-
|
|
912
|
-
|
|
913
|
-
|
|
914
|
-
|
|
915
|
-
|
|
916
|
-
|
|
917
|
-
|
|
918
|
-
|
|
919
|
-
|
|
920
|
-
|
|
921
|
-
|
|
922
|
-
|
|
923
|
-
|
|
924
|
-
|
|
925
|
-
|
|
926
|
-
|
|
927
|
-
|
|
928
|
-
|
|
929
|
-
str(
|
|
930
|
-
|
|
931
|
-
|
|
932
|
-
|
|
933
|
-
|
|
934
|
-
|
|
935
|
-
|
|
936
|
-
|
|
937
|
-
|
|
938
|
-
|
|
939
|
-
|
|
940
|
-
|
|
941
|
-
|
|
942
|
-
|
|
943
|
-
|
|
944
|
-
|
|
945
|
-
|
|
946
|
-
|
|
947
|
-
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
(
|
|
951
|
-
|
|
952
|
-
|
|
953
|
-
|
|
954
|
-
|
|
955
|
-
|
|
956
|
-
|
|
957
|
-
|
|
958
|
-
|
|
959
|
-
|
|
960
|
-
|
|
961
|
-
|
|
962
|
-
check("
|
|
963
|
-
|
|
964
|
-
|
|
965
|
-
str(
|
|
966
|
-
|
|
967
|
-
|
|
968
|
-
|
|
969
|
-
|
|
970
|
-
|
|
971
|
-
|
|
972
|
-
|
|
973
|
-
check("
|
|
974
|
-
|
|
975
|
-
|
|
976
|
-
|
|
977
|
-
|
|
978
|
-
|
|
979
|
-
|
|
980
|
-
|
|
981
|
-
for
|
|
982
|
-
|
|
983
|
-
|
|
984
|
-
|
|
985
|
-
|
|
986
|
-
|
|
987
|
-
|
|
988
|
-
|
|
989
|
-
|
|
990
|
-
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
994
|
-
|
|
995
|
-
|
|
996
|
-
|
|
997
|
-
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
|
|
1001
|
-
|
|
1002
|
-
|
|
1003
|
-
|
|
1004
|
-
|
|
1005
|
-
|
|
1006
|
-
|
|
1007
|
-
|
|
1008
|
-
|
|
1009
|
-
|
|
1010
|
-
|
|
1011
|
-
|
|
1012
|
-
|
|
1013
|
-
|
|
1014
|
-
|
|
1015
|
-
|
|
1016
|
-
#
|
|
1017
|
-
|
|
1018
|
-
|
|
1019
|
-
|
|
1020
|
-
|
|
1021
|
-
|
|
1022
|
-
|
|
1023
|
-
|
|
1024
|
-
|
|
1025
|
-
|
|
1026
|
-
|
|
1027
|
-
|
|
1028
|
-
|
|
1029
|
-
|
|
1030
|
-
|
|
1031
|
-
|
|
1032
|
-
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""ref 增量索引 + 漂移/悬空巡检(P28 · R3 改造验收)。
|
|
3
|
+
|
|
4
|
+
对照 `docs/mdcg/认知图_索引与工程规范化_计划_v0.1.md` 的 R3:
|
|
5
|
+
|
|
6
|
+
① 统一 ref 协议 + 提取器注册表:调用方只说 `kind`,`refindex` 决定用哪个
|
|
7
|
+
提取器;无提取器后缀显式报错。
|
|
8
|
+
② `_refindex.json` 增量(修 F):`incremental=True` 时未变文件**不再读盘重切**
|
|
9
|
+
(`skipped_unchanged`),节点仍在(幂等);默认全量,保证「不漏召回」。
|
|
10
|
+
③ `op=ref action=check` 漂移/悬空巡检(修 D):改源一行 → 报 `stale`;删除源
|
|
11
|
+
文件 → 报 `dangling`;**只读、不抛、不改源文件**。
|
|
12
|
+
④ `op=ref action=stat`:看水位,最近一次索引是否被截断(`truncated` 不再静默)。
|
|
13
|
+
⑤ 接入 `sustain.diagnose`:`ref_stale` / `ref_dangling` 进入体检;`heal` 的
|
|
14
|
+
`rebuild_refs` 重建派生物后漂移消除(源文件不动)。
|
|
15
|
+
⑥ 检索结果带 `ref` / `ref_kind`(读侧只加字段,不改召回逻辑)。
|
|
16
|
+
⑦ 派生物不膨胀:`_refindex.json` 体积有界、重跑不涨。
|
|
17
|
+
⑧ **判据分工**(#4):漂移 / 悬空只由**节点自身 frontmatter ref** 判,水位只判
|
|
18
|
+
「这个节点能不能跳过、不读源」(五项全等 + 源 size/mtime 未变 + 同 id 只判一次);
|
|
19
|
+
水位与节点不一致记 `ledger_mismatch` 归因行(带两侧 root),**不进 ok、不重复报红**。
|
|
20
|
+
⑨ **撞 id 现场**(D1 现状钉子):两域同 rel path + 同 name ⇒ 同 id、节点被后写域覆盖,
|
|
21
|
+
但归因行可见。本组断言**现状事实**(+ 去重 + 归因字段),不作期望语义断言——
|
|
22
|
+
`node_id` 一旦改为含 root,① 会转红以提示同步迁移。
|
|
23
|
+
⑩ **口径钉子**(#5):id 是**位置化**寻址(`sha1(路径::符号名)` / `sha1(路径#标题路径)`),
|
|
24
|
+
幂等判据是**区间哈希 + 行位全等**(不是「id 存在即已索引」)。两侧都钉——实现侧
|
|
25
|
+
手算 sha1 独立复算 + 对 root / 正文 / 行位不敏感 + 五项逐项不跳过;文档侧
|
|
26
|
+
`docs/plans/真源索引_通用机制_v0.3.md` §3.1 的口径字面、整块指纹(**陈化硬失败**)
|
|
27
|
+
与行级引用必须仍与实现同源(引用漂移即红,失败信息附现址)。
|
|
28
|
+
⑪ **常驻循环止血**:`SustainLoop._tick_heal` 按 `repeat_guard=True` 调 heal——同因重复
|
|
29
|
+
失败被拦下(`repeat_failure` + 退避)而**诊断面照旧报病灶**(判据不被削弱)、
|
|
30
|
+
`heals[*].failed` 单列(没修好不静默、不假装成功)。
|
|
31
|
+
红基线(判别力自证,见 `_MUTATIONS` / `EXPECTED_RED`):`--head-baseline` 对
|
|
32
|
+
**工作区 `md_cg/refindex.py`** 做定点变异(快路径探测数据改回水位条目=v1 旧行为),
|
|
33
|
+
断言红项集合**恰好**等于预期三项(⑩ / ⑪ 两段钉的是别的语义,变异态下**仍绿**,
|
|
34
|
+
故不入红项表——「恰好」二字正是这么被守住的)。
|
|
35
|
+
|
|
36
|
+
运行:python -m md_cg.test_p28_refcheck [--head-baseline]
|
|
37
|
+
"""
|
|
38
|
+
from __future__ import annotations
|
|
39
|
+
|
|
40
|
+
import argparse
|
|
41
|
+
import hashlib
|
|
42
|
+
import os
|
|
43
|
+
import re
|
|
44
|
+
import shutil
|
|
45
|
+
import sys
|
|
46
|
+
import tempfile
|
|
47
|
+
import time
|
|
48
|
+
|
|
49
|
+
from . import corpus, refindex, sources, sustain, tokens
|
|
50
|
+
from .mdcg import MdCG
|
|
51
|
+
from .mcp_server import call_tool
|
|
52
|
+
|
|
53
|
+
PASS = FAIL = 0
|
|
54
|
+
FAILS = []
|
|
55
|
+
RED = [] # 转红项 cid(红基线模式比对用;绿态为空)
|
|
56
|
+
|
|
57
|
+
_BASE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
|
58
|
+
ROOT = os.path.join(_BASE, "_md_cg_p28")
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def check(name, cond, detail="", cid=None):
|
|
62
|
+
global PASS, FAIL
|
|
63
|
+
if cond:
|
|
64
|
+
PASS += 1
|
|
65
|
+
print(f" [PASS] {name}" + (f" · {detail}" if detail else ""))
|
|
66
|
+
else:
|
|
67
|
+
FAIL += 1
|
|
68
|
+
FAILS.append(name)
|
|
69
|
+
# 无 cid 的失败记哨兵:红基线模式下它会与预期红项不等 ⇒ fail-closed,
|
|
70
|
+
# 不静默放过「变异波及了没被登记的断言」(同 test_logref.py:66 的口径)。
|
|
71
|
+
RED.append(cid or ("?" + name))
|
|
72
|
+
print(f" [FAIL] {name} · {detail}")
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
ALPHA = ('"""能量计算模块。"""\n'
|
|
76
|
+
'import math\n'
|
|
77
|
+
'\n'
|
|
78
|
+
'\n'
|
|
79
|
+
'def compute_energy(mass, speed):\n'
|
|
80
|
+
' """计算动能。"""\n'
|
|
81
|
+
' return mass * speed * speed\n'
|
|
82
|
+
'\n'
|
|
83
|
+
'\n'
|
|
84
|
+
'class Reactor:\n'
|
|
85
|
+
' """反应堆模型。"""\n'
|
|
86
|
+
'\n'
|
|
87
|
+
' def ignite(self):\n'
|
|
88
|
+
' """点火。"""\n'
|
|
89
|
+
' self.state = "on"\n')
|
|
90
|
+
|
|
91
|
+
# 同函数同区间,只改一行实现 → 行数不变,只有区间哈希变(最强的漂移信号)
|
|
92
|
+
ALPHA_DRIFT = ALPHA.replace("return mass * speed * speed",
|
|
93
|
+
"return 0.5 * mass * speed * speed")
|
|
94
|
+
# 第二个漂移变体:段⑤ 已把源改成 ALPHA_DRIFT 并重建索引,段⑨ 要再制造一次真实漂移,
|
|
95
|
+
# 必须写出**与当前索引内容不同**的正文;否则只是 mtime 变了、内容没变,报 ok 才对。
|
|
96
|
+
ALPHA_DRIFT2 = ALPHA.replace("return mass * speed * speed",
|
|
97
|
+
"return mass * speed * speed / 2.0")
|
|
98
|
+
ALPHA_MARK2 = "speed * speed / 2.0"
|
|
99
|
+
|
|
100
|
+
BETA = ('"""辅助模块。"""\n'
|
|
101
|
+
'\n'
|
|
102
|
+
'\n'
|
|
103
|
+
'def helper_scale(x):\n'
|
|
104
|
+
' """缩放。"""\n'
|
|
105
|
+
' return x * 2\n')
|
|
106
|
+
|
|
107
|
+
|
|
108
|
+
def rd(path):
|
|
109
|
+
with open(path, encoding="utf-8") as f:
|
|
110
|
+
return f.read()
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
def wr(path, text, bump=0.0):
|
|
114
|
+
with open(path, "w", encoding="utf-8") as f:
|
|
115
|
+
f.write(text)
|
|
116
|
+
if bump:
|
|
117
|
+
# 显式推后 mtime:粗粒度文件系统上保证「变了」能被水位看见
|
|
118
|
+
t = os.path.getmtime(path) + bump
|
|
119
|
+
os.utime(path, (t, t))
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
def index_read(cg, code_dir, **extra):
|
|
123
|
+
a = {"op": "index_code", "path": code_dir}
|
|
124
|
+
a.update(extra)
|
|
125
|
+
return call_tool(cg, "cg", a)
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
def ref_read(cg, **args):
|
|
129
|
+
a = {"op": "ref"}
|
|
130
|
+
a.update(args)
|
|
131
|
+
return call_tool(cg, "cg", a)
|
|
132
|
+
|
|
133
|
+
|
|
134
|
+
# ---------------- 6 判据分工:节点 ref 判漂移,水位只判跳过 ----------------
|
|
135
|
+
|
|
136
|
+
#: 合成源:改一行实现 → 行数不变、只有区间哈希变(最强的漂移信号,同 ALPHA_DRIFT)。
|
|
137
|
+
PROBE_SRC = ('"""probe 模块。"""\n'
|
|
138
|
+
'\n'
|
|
139
|
+
'\n'
|
|
140
|
+
'def probe_fn(x):\n'
|
|
141
|
+
' """probe 函数。"""\n'
|
|
142
|
+
' return x + 1\n')
|
|
143
|
+
PROBE_SRC2 = PROBE_SRC.replace("return x + 1", "return x + 2")
|
|
144
|
+
|
|
145
|
+
|
|
146
|
+
def _mk(tmp, name):
|
|
147
|
+
d = os.path.join(tmp, name)
|
|
148
|
+
os.makedirs(d)
|
|
149
|
+
return d
|
|
150
|
+
|
|
151
|
+
|
|
152
|
+
def _index_into(cg, src, ledger=None):
|
|
153
|
+
"""直调 refindex 的两步(index_dir → add_items),返回本轮节点 id。
|
|
154
|
+
|
|
155
|
+
必须直调:`op=index_code` 是这两步的**连写**,表达不了「只写一侧」的分歧。
|
|
156
|
+
"""
|
|
157
|
+
items, _errors, _stats = refindex.index_dir(src, kind="code_ref",
|
|
158
|
+
ledger=ledger)
|
|
159
|
+
ids, _sens = refindex.add_items(cg, items, kind="code_ref", root=src)
|
|
160
|
+
return ids
|
|
161
|
+
|
|
162
|
+
|
|
163
|
+
def _tamper_ref_hash(node_path, fake="deadbeefcafe"):
|
|
164
|
+
"""把节点 .md 里 frontmatter 的 ref 哈希改成假值(源与水位都不动)。
|
|
165
|
+
|
|
166
|
+
`cg.get` 每次从盘上读节点,故改 .md 即改「节点自述」;水位条目不受影响——
|
|
167
|
+
这正是「漂移只由节点 ref 判」要区分的场景(v1 拿水位当探测数据 ⇒ 静默)。
|
|
168
|
+
"""
|
|
169
|
+
with open(node_path, encoding="utf-8") as f:
|
|
170
|
+
txt = f.read()
|
|
171
|
+
out = re.sub(r'"hash": "[0-9a-f]{12}"', '"hash": "%s"' % fake, txt, count=1)
|
|
172
|
+
if out == txt:
|
|
173
|
+
raise RuntimeError("夹具失效:节点 frontmatter 里没有可篡改的 ref.hash")
|
|
174
|
+
with open(node_path, "w", encoding="utf-8") as f:
|
|
175
|
+
f.write(out)
|
|
176
|
+
|
|
177
|
+
|
|
178
|
+
def _verdict(res):
|
|
179
|
+
"""巡检结果 → 去重/归因视角的摘要(红基线断言只看这里)。"""
|
|
180
|
+
ids = [r.get("node_id") for r in list(res.get("stale") or [])
|
|
181
|
+
+ list(res.get("dangling") or [])]
|
|
182
|
+
return {"ok": res["ok"], "ids": ids, "dup": len(ids) - len(set(ids)),
|
|
183
|
+
"mm": res.get("ledger_mismatch") or [],
|
|
184
|
+
"mm_count": res.get("ledger_mismatch_count", 0)}
|
|
185
|
+
|
|
186
|
+
|
|
187
|
+
def guard_verdict_owner(tmp):
|
|
188
|
+
"""三组构造:水位与节点分别推到不同代,看快路径认谁(直调 refindex)。"""
|
|
189
|
+
# ①水位新、节点旧 —— 等价 mcp_server.py 的 index_dir→add_items 之间被杀
|
|
190
|
+
lib = _mk(tmp, "fo_lib")
|
|
191
|
+
src = _mk(tmp, "fo_src")
|
|
192
|
+
p = os.path.join(src, "probe_widget.py")
|
|
193
|
+
wr(p, PROBE_SRC)
|
|
194
|
+
cg = MdCG(lib)
|
|
195
|
+
ids = _index_into(cg, src, refindex.Ledger(lib))
|
|
196
|
+
cg.flush()
|
|
197
|
+
wr(p, PROBE_SRC2, bump=5.0)
|
|
198
|
+
refindex.index_dir(src, kind="code_ref", ledger=refindex.Ledger(lib))
|
|
199
|
+
res = refindex.check_refs(cg, ledger=refindex.Ledger(lib))
|
|
200
|
+
v = _verdict(res)
|
|
201
|
+
node_hashes = {refindex.ref_of(cg.get(n))[1]["hash"] for n in ids}
|
|
202
|
+
check("6①只推水位:ok=False(漂移由节点 ref 判,水位说了不算)",
|
|
203
|
+
res["ok"] is False, f"ok={res['ok']} stale={len(res['stale'])}", cid="A1")
|
|
204
|
+
check("6①stale 覆盖该文件全部节点,hash_expected 取节点 ref(不是水位新哈希)",
|
|
205
|
+
{r["node_id"] for r in res["stale"]} == set(ids)
|
|
206
|
+
and {r["hash_expected"] for r in res["stale"]} == node_hashes,
|
|
207
|
+
f"stale={sorted(r['node_id'] for r in res['stale'])}", cid="A1")
|
|
208
|
+
check("6①水位/节点不一致记归因行 watermark_behind(写序断裂可见,不进 ok)",
|
|
209
|
+
v["mm_count"] >= 1
|
|
210
|
+
and all(r["kind_of_gap"] == "watermark_behind" for r in v["mm"]),
|
|
211
|
+
str(v["mm"][:1]), cid="A2")
|
|
212
|
+
|
|
213
|
+
# ②节点新、水位旧 —— ledger 根本不参与,才算「只推节点」
|
|
214
|
+
lib = _mk(tmp, "fn_lib")
|
|
215
|
+
src = _mk(tmp, "fn_src")
|
|
216
|
+
p = os.path.join(src, "probe_widget.py")
|
|
217
|
+
wr(p, PROBE_SRC)
|
|
218
|
+
cg = MdCG(lib)
|
|
219
|
+
_index_into(cg, src, refindex.Ledger(lib))
|
|
220
|
+
cg.flush()
|
|
221
|
+
wr(p, PROBE_SRC2, bump=5.0)
|
|
222
|
+
_index_into(cg, src, ledger=None) # 全量重切,水位不动
|
|
223
|
+
cg.flush()
|
|
224
|
+
res = refindex.check_refs(cg, ledger=refindex.Ledger(lib))
|
|
225
|
+
v = _verdict(res)
|
|
226
|
+
check("6②只推节点:ok=True 且 stale/dangling 空(旧水位不得误报漂移)",
|
|
227
|
+
res["ok"] is True and not res["stale"] and not res["dangling"],
|
|
228
|
+
f"ok={res['ok']} stale={sorted(v['ids'])}", cid="B1")
|
|
229
|
+
# 归因面与「红不红」解耦:这里只断言「不一致被记下来了」(ok 由 B1 断),
|
|
230
|
+
# 免得同一次误报把两条断言一起打红、红项表失去「一项一行为」的对应。
|
|
231
|
+
check("6②旧水位与节点不一致仍归因(watermark_behind)",
|
|
232
|
+
v["mm_count"] >= 1
|
|
233
|
+
and all(r["kind_of_gap"] == "watermark_behind" for r in v["mm"]),
|
|
234
|
+
str(v["mm"][:1]), cid="B2")
|
|
235
|
+
|
|
236
|
+
# ③篡改节点 ref.hash(源与水位都不动)—— 只有节点自述变了
|
|
237
|
+
lib = _mk(tmp, "ft_lib")
|
|
238
|
+
src = _mk(tmp, "ft_src")
|
|
239
|
+
p = os.path.join(src, "probe_widget.py")
|
|
240
|
+
wr(p, PROBE_SRC)
|
|
241
|
+
cg = MdCG(lib)
|
|
242
|
+
ids = _index_into(cg, src, refindex.Ledger(lib))
|
|
243
|
+
cg.flush()
|
|
244
|
+
nid = sorted(ids)[0]
|
|
245
|
+
_tamper_ref_hash(os.path.join(lib, cg.index["nodes"][nid]["path"]))
|
|
246
|
+
res = refindex.check_refs(cg, ledger=refindex.Ledger(lib))
|
|
247
|
+
v = _verdict(res)
|
|
248
|
+
check("6③篡改节点 ref.hash(源与水位都不动):必须报 stale",
|
|
249
|
+
res["ok"] is False and any(r["node_id"] == nid for r in res["stale"]),
|
|
250
|
+
f"ok={res['ok']} stale={v['ids']}", cid="C1")
|
|
251
|
+
check("6③同一 node_id 至多一行(去重,不重复报红)", v["dup"] == 0,
|
|
252
|
+
str(v["ids"]), cid="C2")
|
|
253
|
+
|
|
254
|
+
|
|
255
|
+
def guard_collision(tmp):
|
|
256
|
+
"""撞 id 现场(D1 状态):钉现状事实 + 去重 + 归因,不作期望语义断言。
|
|
257
|
+
|
|
258
|
+
`node_id` 不含 root ⇒ 两域同 rel path + 同 name 时撞 id、节点被**后写域**覆盖
|
|
259
|
+
(`add_items` 同 id upsert 整条替换)。本组断言这个**现状**(以及归因行可见、
|
|
260
|
+
不重复报红);键一旦改为含 root,第一条会转红以提示同步迁移——那是迁移触发器,
|
|
261
|
+
不是要实现的期望语义(见 docs/plans/真源索引_通用机制_v0.3.md「id 语义与设计债」)。
|
|
262
|
+
"""
|
|
263
|
+
lib = _mk(tmp, "fc_lib")
|
|
264
|
+
domA = _mk(tmp, "fc_domA")
|
|
265
|
+
domB = _mk(tmp, "fc_domB")
|
|
266
|
+
for d in (domA, domB):
|
|
267
|
+
wr(os.path.join(d, "probe_widget.py"), PROBE_SRC)
|
|
268
|
+
cg = MdCG(lib)
|
|
269
|
+
ids_a = _index_into(cg, domA, refindex.Ledger(lib))
|
|
270
|
+
# #352-E(2026-10-15):id 键**仍未**含 root,但写入面加了冲突闸——B 的同名条目
|
|
271
|
+
# 不再覆写 A,改为「不写入 + 回执 conflicts 点名」。故本钉从「两域 id 集相等」
|
|
272
|
+
# (=后写域覆盖)改为「两域算出的 id 仍相同,但 B 一个都不写」。原钉的用途
|
|
273
|
+
# (键一旦改为含 root 即转红以提示同步迁移)保留:改 id 键后这里仍会转红。
|
|
274
|
+
_items_b, _eb, _sb = refindex.index_dir(domB, kind="code_ref",
|
|
275
|
+
ledger=refindex.Ledger(lib))
|
|
276
|
+
_cf = []
|
|
277
|
+
ids_b, _ = refindex.add_items(cg, _items_b, kind="code_ref", root=domB,
|
|
278
|
+
conflicts=_cf)
|
|
279
|
+
cg.flush()
|
|
280
|
+
nid = sorted(ids_a)[0]
|
|
281
|
+
ref = refindex.ref_of(cg.get(nid))[1] or {}
|
|
282
|
+
check("7①两域同 rel path + 同 name ⇒ 仍算出同一 id,但后写域被冲突闸拦下不写入",
|
|
283
|
+
bool(ids_a) and ids_b == []
|
|
284
|
+
and {c.get("id") for c in _cf} == set(ids_a),
|
|
285
|
+
f"A={ids_a} B={ids_b} conflicts={_cf}", cid="D1")
|
|
286
|
+
check("7①同一 id 只留一条节点,ref.root 仍属**先写域**(#352-E 后的钉子)",
|
|
287
|
+
len(cg.index["nodes"]) == len(ids_a)
|
|
288
|
+
and refindex._same_root(ref.get("root"), domA),
|
|
289
|
+
f"nodes={len(cg.index['nodes'])} root={ref.get('root')}", cid="D1")
|
|
290
|
+
_tamper_ref_hash(os.path.join(lib, cg.index["nodes"][nid]["path"]))
|
|
291
|
+
res = refindex.check_refs(cg, ledger=refindex.Ledger(lib))
|
|
292
|
+
v = _verdict(res)
|
|
293
|
+
check("7②该现场篡改节点 ref.hash:同一 node_id 至多一行(dup=0)",
|
|
294
|
+
v["dup"] == 0, str(v["ids"]), cid="D2")
|
|
295
|
+
check("7②水位/节点不一致记 ledger_mismatch 归因行(撞 id 不再静默)",
|
|
296
|
+
v["mm_count"] >= 1, str(v["mm_count"]), cid="D2")
|
|
297
|
+
# #352-E:撞 id 的归因从**巡检面**(watermark/node 两侧 root 不一致)前移到
|
|
298
|
+
# **写入面回执**(conflicts 带 existing_root/root)——写入面不再让撞 id 落盘,
|
|
299
|
+
# 巡检面自然不再有「节点归了后写域」这个事实可归因。归因字段本身(两侧 root)
|
|
300
|
+
# 一个没少,只是换了承担者。
|
|
301
|
+
check("7②撞 id 归因改由写入面回执承担(conflicts 带两侧 root,可归因到域)",
|
|
302
|
+
bool(_cf) and all(c.get("existing_root") and c.get("root")
|
|
303
|
+
and c.get("id") for c in _cf),
|
|
304
|
+
str(_cf[:1]), cid="D2")
|
|
305
|
+
# 该现场再推一步:**两域的源都改掉**(合法漂移,不是篡改)。v1 逐条水位条目各自
|
|
306
|
+
# 探测 ⇒ 同一个 node_id 被反复报(本夹具实测 HEAD 4 行 / dup=2 ⇒ v2 2 行 / dup=0,
|
|
307
|
+
# 两个数是该文件的两个节点各一行)。这一步才真正钉住「去重」,且不依赖篡改。
|
|
308
|
+
wr(os.path.join(domA, "probe_widget.py"), PROBE_SRC2, bump=5.0)
|
|
309
|
+
wr(os.path.join(domB, "probe_widget.py"), PROBE_SRC2, bump=5.0)
|
|
310
|
+
v = _verdict(refindex.check_refs(cg, ledger=refindex.Ledger(lib)))
|
|
311
|
+
check("7③两域源都改:同一 node_id 至多一行(v1 会按水位条目重复报)",
|
|
312
|
+
v["dup"] == 0 and bool(v["ids"]), str(v["ids"]), cid="D3")
|
|
313
|
+
_items_b2, _eb2, _sb2 = refindex.index_dir(domB, kind="code_ref",
|
|
314
|
+
ledger=refindex.Ledger(lib))
|
|
315
|
+
_cf2 = []
|
|
316
|
+
_ids_b2, _ = refindex.add_items(cg, _items_b2, kind="code_ref",
|
|
317
|
+
root=domB, conflicts=_cf2)
|
|
318
|
+
check("7③两域源都改后再索引 B:撞 id 仍由回执点名(带两侧 root,可归因到域)",
|
|
319
|
+
_ids_b2 == [] and bool(_cf2)
|
|
320
|
+
and all(c.get("existing_root") and c.get("root") for c in _cf2),
|
|
321
|
+
f"ids={_ids_b2} conflicts={_cf2[:1]}", cid="D3")
|
|
322
|
+
|
|
323
|
+
|
|
324
|
+
# ---------------- 12 自愈止血 + 水位保全(H1/H1b/H2/H3/H4/H5/H6 + 写序) ----------------
|
|
325
|
+
|
|
326
|
+
def guard_heal_bounded(tmp):
|
|
327
|
+
"""水位不被写空 / 重建失败不许记成成功 / 同因不重试(直调 refindex|sustain)。
|
|
328
|
+
|
|
329
|
+
全部用对称小夹具(每域 1 个源文件、2 个节点),断言的是**行为**而不是文案。
|
|
330
|
+
"""
|
|
331
|
+
# ①水位保全(H1):目录仍在、零文件 ⇒ 空扫不对账,水位不被剪空
|
|
332
|
+
lib = _mk(tmp, "hb1_lib")
|
|
333
|
+
src = _mk(tmp, "hb1_src")
|
|
334
|
+
p = os.path.join(src, "hb1_widget.py")
|
|
335
|
+
wr(p, PROBE_SRC)
|
|
336
|
+
cg = MdCG(lib)
|
|
337
|
+
ids = _index_into(cg, src, refindex.Ledger(lib))
|
|
338
|
+
cg.flush()
|
|
339
|
+
os.remove(p) # 目录仍在、零文件
|
|
340
|
+
refindex.index_dir(src, kind="code_ref", ledger=refindex.Ledger(lib))
|
|
341
|
+
s = refindex.Ledger(lib).summary()
|
|
342
|
+
check("12①空扫不对账:水位条目与节点数保住([C1] 目录仍在零文件)",
|
|
343
|
+
s["files"] == 1 and s["nodes"] == len(ids),
|
|
344
|
+
f"files={s['files']} nodes={s['nodes']} ids={len(ids)}", cid="E1")
|
|
345
|
+
check("12①两面不打架:last_index 如实记 files=0 且 empty_scan=True",
|
|
346
|
+
(s.get("last_index") or {}).get("files") == 0
|
|
347
|
+
and (s.get("last_index") or {}).get("empty_scan") is True,
|
|
348
|
+
str(s.get("last_index"))[:120], cid="E1")
|
|
349
|
+
|
|
350
|
+
# ②悬空 root 不重建(H1b):不调 index_dir ⇒ 水位不被写成空
|
|
351
|
+
lib = _mk(tmp, "hb2_lib")
|
|
352
|
+
src = _mk(tmp, "hb2_src")
|
|
353
|
+
wr(os.path.join(src, "hb2_widget.py"), PROBE_SRC)
|
|
354
|
+
cg = MdCG(lib)
|
|
355
|
+
_index_into(cg, src, refindex.Ledger(lib))
|
|
356
|
+
cg.flush()
|
|
357
|
+
n_files = refindex.Ledger(lib).summary()["files"]
|
|
358
|
+
shutil.rmtree(src) # 源大域整个没了
|
|
359
|
+
r = refindex.rebuild(cg, ledger=refindex.Ledger(lib))
|
|
360
|
+
check("12②rebuild 遇悬空 root:不重建、ok=False、roots_missing 如实记",
|
|
361
|
+
r["ok"] is False and len(r["roots_missing"]) == 1 and r["indexed"] == 0
|
|
362
|
+
and any("已不是目录" in e for e in r["errors"]),
|
|
363
|
+
f"ok={r['ok']} missing={r['roots_missing']} err={r['errors'][:1]}", cid="E2")
|
|
364
|
+
check("12②悬空 root 不再把水位写成空([C3] files 保住 vs 现状 0)",
|
|
365
|
+
refindex.Ledger(lib).summary()["files"] == n_files,
|
|
366
|
+
f"files={refindex.Ledger(lib).summary()['files']} 期望 {n_files}", cid="E2")
|
|
367
|
+
|
|
368
|
+
# ③空扫组如实置 ok=False(H2)
|
|
369
|
+
lib = _mk(tmp, "hb3_lib")
|
|
370
|
+
src = _mk(tmp, "hb3_src")
|
|
371
|
+
p = os.path.join(src, "hb3_widget.py")
|
|
372
|
+
wr(p, PROBE_SRC)
|
|
373
|
+
cg = MdCG(lib)
|
|
374
|
+
_index_into(cg, src, refindex.Ledger(lib))
|
|
375
|
+
cg.flush()
|
|
376
|
+
os.remove(p)
|
|
377
|
+
r = refindex.rebuild(cg, ledger=refindex.Ledger(lib))
|
|
378
|
+
check("12③rebuild 空扫组:ok=False + errors + 逐组 empty_scan 如实回报",
|
|
379
|
+
r["ok"] is False and r["errors"] and r["rebuilt"]
|
|
380
|
+
and r["rebuilt"][0]["empty_scan"] is True
|
|
381
|
+
and r["rebuilt"][0]["files"] == 0,
|
|
382
|
+
str(r["rebuilt"])[:140], cid="E3")
|
|
383
|
+
|
|
384
|
+
# ④只有悬空 ⇒ heal 不重建(H3):止血点在「按 code 分派」
|
|
385
|
+
lib = _mk(tmp, "hb4_lib")
|
|
386
|
+
domA = _mk(tmp, "hb4_domA")
|
|
387
|
+
domB = _mk(tmp, "hb4_domB")
|
|
388
|
+
for d, nm in ((domA, "hb4_a.py"), (domB, "hb4_b.py")):
|
|
389
|
+
wr(os.path.join(d, nm), PROBE_SRC)
|
|
390
|
+
cg = MdCG(lib)
|
|
391
|
+
_index_into(cg, domA, refindex.Ledger(lib))
|
|
392
|
+
_index_into(cg, domB, refindex.Ledger(lib))
|
|
393
|
+
cg.flush()
|
|
394
|
+
shutil.rmtree(domB)
|
|
395
|
+
codes = {i["code"] for i in sustain.diagnose(cg)["issues"]}
|
|
396
|
+
acts = [a["code"] for a in sustain.heal(cg)["actions"]]
|
|
397
|
+
check("12④ref_dangling 不再触发重建(fix 字段无调度器消费,改它无效)",
|
|
398
|
+
"ref_dangling" in codes and "rebuild_refs" not in acts,
|
|
399
|
+
f"codes={sorted(codes)} actions={acts}", cid="E4")
|
|
400
|
+
|
|
401
|
+
# ⑤重建失败如实记 ok=False(H4)+ ⑥同因不重试(H6)
|
|
402
|
+
lib = _mk(tmp, "hb5_lib")
|
|
403
|
+
domA = _mk(tmp, "hb5_domA")
|
|
404
|
+
domB = _mk(tmp, "hb5_domB")
|
|
405
|
+
for d, nm in ((domA, "hb5_a.py"), (domB, "hb5_b.py")):
|
|
406
|
+
wr(os.path.join(d, nm), PROBE_SRC)
|
|
407
|
+
cg = MdCG(lib)
|
|
408
|
+
_index_into(cg, domA, refindex.Ledger(lib))
|
|
409
|
+
_index_into(cg, domB, refindex.Ledger(lib))
|
|
410
|
+
cg.flush()
|
|
411
|
+
key = (os.path.abspath(lib), "rebuild_refs")
|
|
412
|
+
sustain._HEAL_MEMO.pop(key, None)
|
|
413
|
+
p = os.path.join(domA, "hb5_a.py")
|
|
414
|
+
wr(p, PROBE_SRC2, bump=5.0) # 一个域漂移
|
|
415
|
+
shutil.rmtree(domB) # 另一个域悬空(重建必带 roots_missing)
|
|
416
|
+
h1 = sustain.heal(cg, repeat_guard=True, heal_interval=300.0)
|
|
417
|
+
row = next((a for a in h1["actions"] if a["code"] == "rebuild_refs"), None)
|
|
418
|
+
check("12⑤重建失败不得记成成功:applied=True 且 ok=False,并带结果摘要",
|
|
419
|
+
bool(row) and row["applied"] is True and row["ok"] is False
|
|
420
|
+
and bool((row.get("result") or {}).get("roots_missing")),
|
|
421
|
+
str(row)[:170], cid="E5")
|
|
422
|
+
wr(p, PROBE_SRC, bump=5.0) # 回到与上次相同的诊断信号
|
|
423
|
+
h2 = sustain.heal(cg, repeat_guard=True, heal_interval=300.0)
|
|
424
|
+
row2 = next((a for a in h2["actions"] if a["code"] == "rebuild_refs"), None)
|
|
425
|
+
check("12⑥同一信号重复失败:拦下并如实记 repeat_failure(不是静默、不重刷)",
|
|
426
|
+
bool(row2) and row2["applied"] is False
|
|
427
|
+
and row2.get("reason") == "repeat_failure"
|
|
428
|
+
and row2.get("streak") == 1 and row2.get("wait_s") == 300.0,
|
|
429
|
+
str(row2)[:170], cid="E6")
|
|
430
|
+
sustain._HEAL_MEMO[key]["ts"] = time.time() - 400 # 模拟退避窗已过
|
|
431
|
+
h3 = sustain.heal(cg, repeat_guard=True, heal_interval=300.0)
|
|
432
|
+
row3 = next((a for a in h3["actions"] if a["code"] == "rebuild_refs"), None)
|
|
433
|
+
check("12⑥退避窗过后放行重试(退避 ≠ 永久静默)",
|
|
434
|
+
bool(row3) and row3["applied"] is True, str(row3)[:170], cid="E6")
|
|
435
|
+
sustain._HEAL_MEMO.clear()
|
|
436
|
+
|
|
437
|
+
# ⑦sources 的水位面(H5):Ledger 没有 stat(),写错被 except 吞成 {}
|
|
438
|
+
st = sources.FileDispatcher(cg)._ledger_stat()
|
|
439
|
+
check("12⑦ingest stat 的水位面不再被 AttributeError 吞成空",
|
|
440
|
+
isinstance(st, dict) and "files" in st and "path" in st,
|
|
441
|
+
str(sorted(st))[:120], cid="E7")
|
|
442
|
+
|
|
443
|
+
# ⑧写序(#2):节点写入失败 ⇒ 水位不得先落盘
|
|
444
|
+
lib = _mk(tmp, "hb6_lib")
|
|
445
|
+
src = _mk(tmp, "hb6_src")
|
|
446
|
+
wr(os.path.join(src, "hb6_widget.py"), PROBE_SRC)
|
|
447
|
+
cg = MdCG(lib)
|
|
448
|
+
orig = refindex.add_items
|
|
449
|
+
|
|
450
|
+
# 生效条件:任何入参都抛 RuntimeError(把「节点写入失败」注入 op 面),用于验证水位未先落盘;
|
|
451
|
+
def _boom(*_a, **_k):
|
|
452
|
+
raise RuntimeError("夹具:节点写入失败")
|
|
453
|
+
|
|
454
|
+
refindex.add_items = _boom
|
|
455
|
+
raised = False
|
|
456
|
+
try:
|
|
457
|
+
index_read(cg, src)
|
|
458
|
+
except RuntimeError:
|
|
459
|
+
raised = True
|
|
460
|
+
finally:
|
|
461
|
+
refindex.add_items = orig
|
|
462
|
+
led = refindex.Ledger(lib)
|
|
463
|
+
check("12⑧节点写入失败时水位不落盘(残留方向=节点新/水位旧,不是反向)",
|
|
464
|
+
raised and not os.path.isfile(led.path),
|
|
465
|
+
f"raised={raised} ledger_exists={os.path.isfile(led.path)}", cid="E8")
|
|
466
|
+
|
|
467
|
+
|
|
468
|
+
# ---------------- 13 口径钉子:id 位置化 + 幂等判据由区间哈希承担(#5) ----------------
|
|
469
|
+
|
|
470
|
+
#: 口径真源(文档侧)。措辞与实现必须同源——改一边不改另一边即转红。
|
|
471
|
+
DOC_PLAN = os.path.join(_BASE, "docs", "plans", "真源索引_通用机制_v0.3.md")
|
|
472
|
+
#: 口径块定位:起=该标题行,止=下一个**二级**标题(`### ` 不算终止)。
|
|
473
|
+
DOC_SEC_HEAD = "### 3.1 "
|
|
474
|
+
|
|
475
|
+
#: §3.1(归一化后)的 sha1 前 16 位:**判据侧陈化硬失败**——口径一被改写(无论改真源
|
|
476
|
+
#: 还是改守卫)就必须同步本行,才谈得上「措辞与实现同源」。归一化=空白折叠 ⇒ 换行 /
|
|
477
|
+
#: 缩进 / 表格对齐**不**误红,只有措辞变化才红。失败信息里打印现算值,照抄即恢复。
|
|
478
|
+
DOC_SEC_FP = "f373ca6380e3debf"
|
|
479
|
+
|
|
480
|
+
#: §3.1 里必须**逐字**出现的口径字面(缺一条 ⇒ 措辞已从实现侧漂开)。
|
|
481
|
+
DOC_REQUIRED = (
|
|
482
|
+
"路径-标题寻址", # id 是位置化寻址(不是内容寻址)
|
|
483
|
+
"sha1(路径::符号名)", # code_ 的口径公式
|
|
484
|
+
"sha1(路径#标题路径)", # doc_ 的口径公式
|
|
485
|
+
"不含 root、不含正文", # 位置化的两个「不含」
|
|
486
|
+
"id 存在即已索引", # D2:明令禁止的判据(幂等不许看 id)
|
|
487
|
+
"hash + 行位全等", # 幂等判据的实际承担者
|
|
488
|
+
)
|
|
489
|
+
|
|
490
|
+
#: 行级引用 → 实现符号:(文档里必须出现的引用字面, 文件, 行号, 该行应以什么开头)。
|
|
491
|
+
#: 「文档说谁在哪一行」是措辞里最硬的一句——引用漂移(代码增删行)即红,失败信息附
|
|
492
|
+
#: 该符号**现址**,照抄回文档与本表即恢复(陈化可自愈到「人只需抄一次」)。
|
|
493
|
+
DOC_CITATIONS = (
|
|
494
|
+
("refindex.py:577", "md_cg/refindex.py", 577, "def _code_ref("),
|
|
495
|
+
("refindex.py:591", "md_cg/refindex.py", 591, "def _doc_ref("),
|
|
496
|
+
("refindex.py:635", "md_cg/refindex.py", 635,
|
|
497
|
+
"got = codeindex.region_hash(lines, lineno, end)"),
|
|
498
|
+
("refindex.py:652", "md_cg/refindex.py", 652, "def read_ref("),
|
|
499
|
+
("refindex.py:720", "md_cg/refindex.py", 720, "def check_refs("),
|
|
500
|
+
("refindex.py:931", "md_cg/refindex.py", 931, "def prune_orphans("),
|
|
501
|
+
("srcindex.py:71", "md_cg/srcindex.py", 71, "def src_id("),
|
|
502
|
+
("srcindex.py:86", "md_cg/srcindex.py", 86, "def file_hash("),
|
|
503
|
+
("logref.py:119", "md_cg/logref.py", 119, "def node_state("),
|
|
504
|
+
("docindex.py:294", "md_cg/docindex.py", 294, "def node_id("),
|
|
505
|
+
)
|
|
506
|
+
|
|
507
|
+
|
|
508
|
+
def _doc_block(path: str, head: str) -> str:
|
|
509
|
+
"""取文档里 `head` 起、到下一个**二级**标题前的正文块,空白折叠后返回。
|
|
510
|
+
|
|
511
|
+
起行不在文档里返回 ""(由调用方判红,不留静默分支)。归一化只折空白——
|
|
512
|
+
重排 / 换行 / 表格对齐不影响指纹,只有**措辞**变化才改指纹。
|
|
513
|
+
"""
|
|
514
|
+
try:
|
|
515
|
+
with open(path, encoding="utf-8") as f:
|
|
516
|
+
lines = f.read().replace("\r\n", "\n").split("\n")
|
|
517
|
+
except OSError:
|
|
518
|
+
return "" # 文档缺失=口径真源不可读,交由调用方判红
|
|
519
|
+
start = next((i for i, ln in enumerate(lines) if ln.startswith(head)), None)
|
|
520
|
+
if start is None:
|
|
521
|
+
return ""
|
|
522
|
+
i = start + 1
|
|
523
|
+
while i < len(lines) and not (lines[i].startswith("## ")
|
|
524
|
+
and not lines[i].startswith("### ")):
|
|
525
|
+
i += 1
|
|
526
|
+
return re.sub(r"\s+", " ", "\n".join(lines[start:i])).strip()
|
|
527
|
+
|
|
528
|
+
|
|
529
|
+
def guard_id_and_idempotence(tmp):
|
|
530
|
+
"""#5 口径钉子:id 位置化(不含 root / 正文 / 行位)、幂等判据由区间哈希 + 行位承担。
|
|
531
|
+
|
|
532
|
+
两侧都钉,谁单方面漂开都转红:①**实现侧**——id 用手算 sha1 独立复算(不借实现),
|
|
533
|
+
对 root / 正文哈希 / 行位不敏感;水位与节点 ref 五项全等才是跳过的前提(「id 存在」
|
|
534
|
+
不构成已索引);「同 id 而内容变」必须判 stale。②**文档侧**——`v0.3` 计划 §3.1 的
|
|
535
|
+
口径字面齐全、整块指纹不陈化、行级引用仍指向所声称的符号。
|
|
536
|
+
"""
|
|
537
|
+
from . import codeindex, docindex
|
|
538
|
+
|
|
539
|
+
# ---- ①id 口径:位置化,公式可手算复算 ----
|
|
540
|
+
it = {"path": "pkg/probe_widget.py", "name": "probe_fn", "kind": "function",
|
|
541
|
+
"lineno": 4, "end": 6, "hash": "aaaa1111bbbb", "lang": "py",
|
|
542
|
+
"precise": True}
|
|
543
|
+
want_code = "code_" + hashlib.sha1(
|
|
544
|
+
b"pkg/probe_widget.py::probe_fn").hexdigest()[:12]
|
|
545
|
+
check("13①code_ == sha1(路径::符号名)[:12](手算交叉核验,非复用实现)",
|
|
546
|
+
codeindex.node_id(it) == want_code
|
|
547
|
+
and refindex.node_id_of(it, "code_ref") == want_code,
|
|
548
|
+
f"{codeindex.node_id(it)} vs {want_code}", cid="F1")
|
|
549
|
+
dit = {"path": "docs/probe.md", "heading_path": ["一", "二"], "heading": "二",
|
|
550
|
+
"level": 2, "lineno": 10, "end": 20, "hash": "cccc2222", "dup": 1}
|
|
551
|
+
want_doc = "doc_" + hashlib.sha1(
|
|
552
|
+
"docs/probe.md#一/二".encode("utf-8")).hexdigest()[:12]
|
|
553
|
+
check("13①doc_ == sha1(路径#标题路径)[:12](手算交叉核验)",
|
|
554
|
+
docindex.node_id(dit) == want_doc
|
|
555
|
+
and refindex.node_id_of(dit, "doc_ref") == want_doc,
|
|
556
|
+
f"{docindex.node_id(dit)} vs {want_doc}", cid="F1")
|
|
557
|
+
check("13②id 不读 root(跨域同 rel path 必然同 id —— D1 的机械根)",
|
|
558
|
+
codeindex.node_id(dict(it, root="/domA")) == want_code
|
|
559
|
+
and codeindex.node_id(dict(it, root="/domB")) == want_code
|
|
560
|
+
and docindex.node_id(dict(dit, root="/domA")) == want_doc,
|
|
561
|
+
cid="F2")
|
|
562
|
+
check("13②id 不读正文哈希与行位(改内容 / 挪行位 id 不变 ⇒ 位置化而非内容寻址)",
|
|
563
|
+
codeindex.node_id(dict(it, hash="deadbeefdead", lineno=99, end=120)) == want_code
|
|
564
|
+
and docindex.node_id(dict(dit, hash="zzzz9999", lineno=1, end=2)) == want_doc,
|
|
565
|
+
cid="F2")
|
|
566
|
+
|
|
567
|
+
# ---- ②幂等判据:水位只记「能不能跳过」,判据键 = 节点 ref 的五项 + 源 size/mtime ----
|
|
568
|
+
lib = _mk(tmp, "fx_lib")
|
|
569
|
+
src = _mk(tmp, "fx_src")
|
|
570
|
+
p = os.path.join(src, "probe_widget.py")
|
|
571
|
+
wr(p, PROBE_SRC)
|
|
572
|
+
cg = MdCG(lib)
|
|
573
|
+
ids = _index_into(cg, src, refindex.Ledger(lib))
|
|
574
|
+
cg.flush()
|
|
575
|
+
nid = sorted(ids)[0]
|
|
576
|
+
_k0, ref0 = refindex.ref_of(cg.get(nid))
|
|
577
|
+
ents = [e for e in (refindex.Ledger(lib).load().get("files") or {}).values()
|
|
578
|
+
if (e.get("path") or "").endswith("probe_widget.py")]
|
|
579
|
+
e = ents[0] if ents else {}
|
|
580
|
+
n0 = (e.get("nodes") or [{}])[0]
|
|
581
|
+
check("13③水位键 = 源文件绝对路径且只有一条(跨域不撞名)",
|
|
582
|
+
len(ents) == 1, f"{len(ents)} 条", cid="F3")
|
|
583
|
+
check("13③水位条目记的正是判据要用的五项(root/path/lineno/end/hash)+ 源 size/mtime",
|
|
584
|
+
{"root", "path", "size", "mtime", "kind", "nodes"} <= set(e)
|
|
585
|
+
and {"id", "lineno", "end", "hash"} <= set(n0), sorted(e), cid="F3")
|
|
586
|
+
check("13③稳态:水位与节点 ref 五项全等(跳过的前提真的成立)",
|
|
587
|
+
refindex._same_root(e.get("root"), (ref0 or {}).get("root"))
|
|
588
|
+
and refindex._norm_rel(e.get("path")) == refindex._norm_rel((ref0 or {}).get("path"))
|
|
589
|
+
and n0.get("hash") == (ref0 or {}).get("hash")
|
|
590
|
+
and n0.get("lineno") == (ref0 or {}).get("lineno")
|
|
591
|
+
and n0.get("end") == (ref0 or {}).get("end"),
|
|
592
|
+
f"watermark={n0} ref={ref0}", cid="F3")
|
|
593
|
+
# 逐项:五项全等 + 源未变 ⇒ 跳过;任一项不等 ⇒ 一律进探测(「id 存在」不构成已索引)
|
|
594
|
+
n_rec = {"id": nid, "lineno": n0.get("lineno"), "end": n0.get("end"),
|
|
595
|
+
"hash": n0.get("hash")}
|
|
596
|
+
e_rec = {"root": e.get("root"), "path": e.get("path")}
|
|
597
|
+
rel = refindex._norm_rel(e.get("path"))
|
|
598
|
+
base = refindex._fast_path_verdict(cg, n_rec, e_rec, rel, e.get("root"), True)
|
|
599
|
+
check("13④五项全等 + 源 size/mtime 未变 ⇒ 跳过(probe=None,不读源)",
|
|
600
|
+
base["covered"] is True and base["probe"] is None, str(base), cid="F4")
|
|
601
|
+
holes = []
|
|
602
|
+
for k, v in (("hash", "000000000000"), ("lineno", 999), ("end", 1000)):
|
|
603
|
+
n2 = dict(n_rec)
|
|
604
|
+
n2[k] = v
|
|
605
|
+
if refindex._fast_path_verdict(cg, n2, e_rec, rel, e.get("root"),
|
|
606
|
+
True)["probe"] is None:
|
|
607
|
+
holes.append(k)
|
|
608
|
+
if refindex._fast_path_verdict(cg, n_rec, e_rec, "other_widget.py",
|
|
609
|
+
e.get("root"), True)["probe"] is None:
|
|
610
|
+
holes.append("path")
|
|
611
|
+
v_root = refindex._fast_path_verdict(cg, n_rec, e_rec, rel,
|
|
612
|
+
os.path.join(src, "elsewhere"), True)
|
|
613
|
+
if v_root["probe"] is None:
|
|
614
|
+
holes.append("root")
|
|
615
|
+
check("13④五项任一项不等 ⇒ 一律不跳过(「id 存在」不构成已索引)", not holes,
|
|
616
|
+
f"漏判项={holes}", cid="F4")
|
|
617
|
+
check("13④跨域不一致归因 collision_multi_root 且带两侧 root(不静默、不改判定)",
|
|
618
|
+
(v_root.get("mismatch") or {}).get("kind_of_gap") == "collision_multi_root"
|
|
619
|
+
and bool((v_root.get("mismatch") or {}).get("watermark_root"))
|
|
620
|
+
and bool((v_root.get("mismatch") or {}).get("node_root")),
|
|
621
|
+
str(v_root.get("mismatch")), cid="F4")
|
|
622
|
+
|
|
623
|
+
# ---- ③同 id 而内容变:必须判漂移(id 只做身份,不承担幂等) ----
|
|
624
|
+
wr(p, PROBE_SRC2, bump=5.0) # 行数不变,只有区间哈希变
|
|
625
|
+
res = refindex.check_refs(cg, ledger=refindex.Ledger(lib))
|
|
626
|
+
row = next((r for r in res["stale"] if r["node_id"] == nid), None)
|
|
627
|
+
check("13⑤同 id 而区间哈希变(源改一行)⇒ 必须判 stale,且 hash_expected 取节点 ref",
|
|
628
|
+
res["ok"] is False and row is not None
|
|
629
|
+
and row.get("hash_expected") == (ref0 or {}).get("hash"),
|
|
630
|
+
f"ok={res['ok']} stale={sorted(r['node_id'] for r in res['stale'])}",
|
|
631
|
+
cid="F5")
|
|
632
|
+
|
|
633
|
+
# ---- ④文档侧:措辞 / 指纹 / 行级引用都必须与实现同源 ----
|
|
634
|
+
sec = _doc_block(DOC_PLAN, DOC_SEC_HEAD)
|
|
635
|
+
check("13⑥口径真源可读:文档 §3.1 块非空", bool(sec), DOC_PLAN, cid="F6")
|
|
636
|
+
missing = [lit for lit in DOC_REQUIRED if lit not in sec]
|
|
637
|
+
check("13⑥文档 §3.1 逐字含口径字面(id 位置化 + 幂等判据不看 id)", not missing,
|
|
638
|
+
f"缺字面={missing}", cid="F6")
|
|
639
|
+
fp = hashlib.sha1(sec.encode("utf-8")).hexdigest()[:16]
|
|
640
|
+
check("13⑥文档 §3.1 指纹未陈化(措辞一改即红,须同步 DOC_SEC_FP)",
|
|
641
|
+
fp == DOC_SEC_FP, f"现={fp} 判据侧={DOC_SEC_FP}(照抄现算值即恢复)",
|
|
642
|
+
cid="F6")
|
|
643
|
+
doc_text = ""
|
|
644
|
+
try:
|
|
645
|
+
with open(DOC_PLAN, encoding="utf-8") as f:
|
|
646
|
+
doc_text = f.read()
|
|
647
|
+
except OSError:
|
|
648
|
+
pass # 缺文档 ⇒ 每条引用都记「未出现」,逐条报红
|
|
649
|
+
bad = []
|
|
650
|
+
for literal, fpath, lineno, claim in DOC_CITATIONS:
|
|
651
|
+
if literal not in doc_text:
|
|
652
|
+
bad.append(f"{literal} 未出现在文档")
|
|
653
|
+
continue
|
|
654
|
+
lines = rd(os.path.join(_BASE, fpath)).replace("\r\n", "\n").split("\n")
|
|
655
|
+
got = lines[lineno - 1] if 0 < lineno <= len(lines) else ""
|
|
656
|
+
# 判据取 strip 后前缀:行内缩进不算「引用漂移」(只钉「这一行是不是这句」)
|
|
657
|
+
if not got.strip().startswith(claim):
|
|
658
|
+
now = next((i for i, ln in enumerate(lines, 1)
|
|
659
|
+
if ln.strip().startswith(claim)), "?")
|
|
660
|
+
bad.append(f"{fpath}:{lineno} 现为 {got.strip()[:36]!r}"
|
|
661
|
+
f"({claim.strip()} 现在 {fpath}:{now})")
|
|
662
|
+
check("13⑦文档行级引用仍指向所声称的符号(引用漂移即红,失败信息附现址)",
|
|
663
|
+
not bad, ";".join(bad[:3]), cid="F7")
|
|
664
|
+
|
|
665
|
+
|
|
666
|
+
# ---------------- 14 常驻循环止血(heal 在役面) ----------------
|
|
667
|
+
|
|
668
|
+
def guard_loop_tick_heal(tmp):
|
|
669
|
+
"""`SustainLoop._tick_heal`:空转被止住 + 判据未被削弱(不静默、不假装修好)。
|
|
670
|
+
|
|
671
|
+
直调 `_tick_heal()`(**不起线程、不打心跳戳**),`d` 显式落到临时目录——
|
|
672
|
+
绝不写 ~/.mdcg。落点取循环自己的账(`heals` / `last_diagnose`)与 heal 的
|
|
673
|
+
返回值,不断言内部实现细节。
|
|
674
|
+
"""
|
|
675
|
+
lib = _mk(tmp, "lt_lib")
|
|
676
|
+
domA = _mk(tmp, "lt_domA")
|
|
677
|
+
domB = _mk(tmp, "lt_domB")
|
|
678
|
+
for d, nm in ((domA, "lt_a.py"), (domB, "lt_b.py")):
|
|
679
|
+
wr(os.path.join(d, nm), PROBE_SRC)
|
|
680
|
+
cg = MdCG(lib)
|
|
681
|
+
_index_into(cg, domA, refindex.Ledger(lib))
|
|
682
|
+
_index_into(cg, domB, refindex.Ledger(lib))
|
|
683
|
+
cg.flush()
|
|
684
|
+
sustain._HEAL_MEMO.pop((os.path.abspath(lib), "rebuild_refs"), None)
|
|
685
|
+
pa = os.path.join(domA, "lt_a.py")
|
|
686
|
+
wr(pa, PROBE_SRC2, bump=5.0) # 一域漂移
|
|
687
|
+
shutil.rmtree(domB) # 一域悬空 ⇒ 重建必带 roots_missing
|
|
688
|
+
loop = sustain.SustainLoop(cg, "p28_guard_loop", heal_interval=300.0,
|
|
689
|
+
auto_heal=True, d=os.path.join(tmp, "lt_sustain"))
|
|
690
|
+
orig = sustain.heal
|
|
691
|
+
seen = {}
|
|
692
|
+
|
|
693
|
+
def _spy(cg_, **kw):
|
|
694
|
+
res = orig(cg_, **kw)
|
|
695
|
+
seen["kw"] = kw
|
|
696
|
+
seen["actions"] = res.get("actions")
|
|
697
|
+
return res
|
|
698
|
+
|
|
699
|
+
sustain.heal = _spy
|
|
700
|
+
try:
|
|
701
|
+
loop._tick_heal()
|
|
702
|
+
finally:
|
|
703
|
+
sustain.heal = orig
|
|
704
|
+
check("14①常驻循环按 repeat_guard=True + heal_interval 调 heal(空转止在这一面)",
|
|
705
|
+
(seen.get("kw") or {}).get("repeat_guard") is True
|
|
706
|
+
and (seen.get("kw") or {}).get("heal_interval") == 300.0,
|
|
707
|
+
str(sorted((seen.get("kw") or {}))), cid="G1")
|
|
708
|
+
h1 = loop.heals[-1]
|
|
709
|
+
check("14②首轮真跑并如实记没修好:actions 含 rebuild_refs 且 failed 单列该码",
|
|
710
|
+
"rebuild_refs" in h1["actions"] and "rebuild_refs" in h1["failed"],
|
|
711
|
+
str(h1), cid="G2")
|
|
712
|
+
check("14③判据未被削弱:诊断面照旧报出病灶(ref_stale 仍在 last_diagnose)",
|
|
713
|
+
"ref_stale" in ((loop.last_diagnose or {}).get("issues") or []),
|
|
714
|
+
str(loop.last_diagnose), cid="G2")
|
|
715
|
+
# 同信号第二轮:先让信号与上次一致(重建已把索引推到新代 ⇒ 写回旧正文再漂一次)
|
|
716
|
+
wr(pa, PROBE_SRC, bump=5.0)
|
|
717
|
+
sustain.heal = _spy
|
|
718
|
+
try:
|
|
719
|
+
loop._tick_heal()
|
|
720
|
+
finally:
|
|
721
|
+
sustain.heal = orig
|
|
722
|
+
row2 = next((a for a in (seen.get("actions") or [])
|
|
723
|
+
if a.get("code") == "rebuild_refs"), None)
|
|
724
|
+
check("14④同一信号重复失败 ⇒ 被拦下并如实记 repeat_failure(不是又重跑一次)",
|
|
725
|
+
bool(row2) and row2.get("applied") is False
|
|
726
|
+
and row2.get("reason") == "repeat_failure" and row2.get("streak") == 1,
|
|
727
|
+
str(row2), cid="G3")
|
|
728
|
+
h2 = loop.heals[-1]
|
|
729
|
+
check("14④拦下也照样进账:heals 记该动作 + failed 单列,诊断面仍报病灶(都不静默)",
|
|
730
|
+
"rebuild_refs" in h2["actions"] and "rebuild_refs" in h2["failed"]
|
|
731
|
+
and "ref_stale" in ((loop.last_diagnose or {}).get("issues") or []),
|
|
732
|
+
str(h2), cid="G3")
|
|
733
|
+
sustain._HEAL_MEMO.clear()
|
|
734
|
+
|
|
735
|
+
|
|
736
|
+
# ---------------- 红基线(判别力自证) ----------------
|
|
737
|
+
|
|
738
|
+
#: 定点变异表:(标签, 现实现锚点, 改回后的旧行为)。
|
|
739
|
+
#: **源 = 工作区 md_cg/refindex.py 的文本**(不取 git HEAD:HEAD 在改动提交那一刻就等于
|
|
740
|
+
#: 实现本身,判别力静默失效——同款教训见 md_cg/test_logref.py 的 _MUTATIONS 头注)。
|
|
741
|
+
#: 锚点必须**恰好命中 1 次**:0 次=漂移、≥2 次=歧义,皆 ANCHOR-MISS → fail-closed。
|
|
742
|
+
_MUTATIONS = (
|
|
743
|
+
("快路径探测数据:节点自身 frontmatter ref(现行)→ 水位条目(v1 旧行为)",
|
|
744
|
+
' out["probe"] = {**ref, "path": ref.get("path") or rel,\n'
|
|
745
|
+
' "root": ref.get("root") or src_root}',
|
|
746
|
+
' out["probe"] = {**n, "path": rel, "root": src_root}'),
|
|
747
|
+
)
|
|
748
|
+
|
|
749
|
+
#: 变异态下**必须**转红的项:恰好命中这个集合(多一项少一项都报红):
|
|
750
|
+
#: A1 6①只推水位 ⇒ v1 拿水位当探测数据 ⇒ 哈希「匹配」而静默 ok=True(漏报)
|
|
751
|
+
#: B1 6②只推节点 ⇒ v1 拿旧水位当探测数据 ⇒ 旧哈希对不上新源(误报 stale)
|
|
752
|
+
#: C1 6③篡改节点 ref.hash ⇒ v1 根本不看节点自述 ⇒ 静默 ok=True
|
|
753
|
+
EXPECTED_RED = ("A1", "B1", "C1")
|
|
754
|
+
|
|
755
|
+
|
|
756
|
+
# 生效条件:锚点命中次数不是恰好 1 次时由 _mutated_verdict 抛出(fail-closed)。
|
|
757
|
+
class AnchorMiss(RuntimeError):
|
|
758
|
+
pass
|
|
759
|
+
|
|
760
|
+
|
|
761
|
+
#: 导入时的实现体字节码(红基线模式会把变异体挂回该属性,故不能与属性现值比)
|
|
762
|
+
_IMPL_CODEC = refindex._fast_path_verdict.__code__.co_code
|
|
763
|
+
|
|
764
|
+
|
|
765
|
+
def _anchor_selfcheck() -> None:
|
|
766
|
+
"""锚点仍在、且 EXPECTED_RED 都是本文件里真实存在的 cid → 静默通过。"""
|
|
767
|
+
_mutated_verdict() # 锚点漂移/歧义 → AnchorMiss
|
|
768
|
+
with open(os.path.abspath(__file__), encoding="utf-8") as f:
|
|
769
|
+
src = f.read()
|
|
770
|
+
gone = [i for i in EXPECTED_RED if ('cid="%s"' % i) not in src]
|
|
771
|
+
if gone:
|
|
772
|
+
raise AnchorMiss("EXPECTED_RED 含本文件里不存在的 check id(红项表已陈化):%s"
|
|
773
|
+
% "、".join(gone))
|
|
774
|
+
|
|
775
|
+
|
|
776
|
+
def _mutated_verdict():
|
|
777
|
+
"""读工作区 `md_cg/refindex.py`(**只读,不落盘**)按 _MUTATIONS 逐处文本替换,
|
|
778
|
+
把变异后的模块体 exec 进真模块 globals 的副本,返回变异后的 _fast_path_verdict。
|
|
779
|
+
锚点漂移/歧义时抛 AnchorMiss。"""
|
|
780
|
+
p = os.path.join(_BASE, "md_cg", "refindex.py")
|
|
781
|
+
with open(p, encoding="utf-8") as f:
|
|
782
|
+
text = f.read()
|
|
783
|
+
for label, anchor, repl in _MUTATIONS:
|
|
784
|
+
n = text.count(anchor)
|
|
785
|
+
if n != 1:
|
|
786
|
+
raise AnchorMiss(
|
|
787
|
+
"ANCHOR-MISS:定点变异锚点漂移/歧义 —— %s 命中 %d 次(应恰好 1 次)"
|
|
788
|
+
"|锚点首行:%s" % (label, n, anchor.splitlines()[0].strip()))
|
|
789
|
+
text = text.replace(anchor, repl)
|
|
790
|
+
g = dict(vars(refindex)) # __name__ / __package__ 保留 ⇒ 相对 import 照旧解析
|
|
791
|
+
exec(compile(text, "<mutated md_cg/refindex.py>", "exec"), g)
|
|
792
|
+
fn = g["_fast_path_verdict"]
|
|
793
|
+
# 与**导入时**的实现体比(不能比当前属性:红基线模式会把变异体挂回该属性)
|
|
794
|
+
if fn.__code__.co_code == _IMPL_CODEC:
|
|
795
|
+
raise AnchorMiss("ANCHOR-MISS:变异后字节码与实现相同(替换未生效)")
|
|
796
|
+
return fn
|
|
797
|
+
|
|
798
|
+
|
|
799
|
+
def main(argv=None):
|
|
800
|
+
ap = argparse.ArgumentParser(
|
|
801
|
+
description="P28 守卫:ref 增量索引 + 漂移/悬空巡检(R3)")
|
|
802
|
+
ap.add_argument("--head-baseline", action="store_true",
|
|
803
|
+
help="红基线:对工作区 md_cg/refindex.py 做定点变异(快路径探测"
|
|
804
|
+
"数据改回水位条目=v1 旧行为),断言红项集合 == 预期红项")
|
|
805
|
+
args = ap.parse_args(argv)
|
|
806
|
+
# 锚点自证:**两态都查**(绿态也查)——锚点漂移后若只查红基线,绿线会继续绿着
|
|
807
|
+
# 而判别力已死(本守卫的判别力全靠这张表)。漂移即 fail-closed。
|
|
808
|
+
try:
|
|
809
|
+
_anchor_selfcheck()
|
|
810
|
+
except AnchorMiss as exc:
|
|
811
|
+
print("!! %s" % exc)
|
|
812
|
+
print("结果:锚点自证未过(fail-closed)——定点变异表须同步实现")
|
|
813
|
+
return 2
|
|
814
|
+
if args.head_baseline:
|
|
815
|
+
# 变异体注入(只在本进程内,不落盘)
|
|
816
|
+
refindex._fast_path_verdict = _mutated_verdict()
|
|
817
|
+
print("!! 红基线模式:md_cg/refindex.py 经定点变异 —— %s ⇒ 快路径改用水位条目"
|
|
818
|
+
% ";".join(lbl for lbl, _a, _r in _MUTATIONS))
|
|
819
|
+
|
|
820
|
+
print("=" * 68)
|
|
821
|
+
print("md 认知图 P28 验收 · ref 增量索引 + 漂移/悬空巡检(R3)")
|
|
822
|
+
print("=" * 68)
|
|
823
|
+
|
|
824
|
+
tmp = tempfile.mkdtemp(prefix="mdcg_refcheck_")
|
|
825
|
+
# 部署声明:本用例的读写白名单根(2026-10-10 设计者裁定 dsh #85 选 A 后,
|
|
826
|
+
# MDCG_INGEST_ROOT / MDCG_EXPORT_ROOT 未配置**不再放开**,会回落 mdcg 记忆库根
|
|
827
|
+
# 与工作区;本用例沙箱在两者之外,故必须显式声明——这正是新语义要求的
|
|
828
|
+
# 「部署用环境变量声明可读写的根」。
|
|
829
|
+
os.environ["MDCG_INGEST_ROOT"] = tmp
|
|
830
|
+
os.environ["MDCG_EXPORT_ROOT"] = tmp
|
|
831
|
+
src = os.path.join(tmp, "pkg")
|
|
832
|
+
os.makedirs(src)
|
|
833
|
+
alpha = os.path.join(src, "alpha.py")
|
|
834
|
+
beta = os.path.join(src, "beta.py")
|
|
835
|
+
wr(alpha, ALPHA)
|
|
836
|
+
wr(beta, BETA)
|
|
837
|
+
|
|
838
|
+
corpus.reset_root(ROOT)
|
|
839
|
+
cg = MdCG(ROOT)
|
|
840
|
+
|
|
841
|
+
try:
|
|
842
|
+
# ============================================ ① 统一 ref 协议 + 注册表
|
|
843
|
+
print("\n【1】统一 ref 协议与提取器注册表")
|
|
844
|
+
check("tokens.ALL_OPS 仍收录 ref / index_code",
|
|
845
|
+
"ref" in tokens.ALL_OPS and "index_code" in tokens.ALL_OPS)
|
|
846
|
+
check("REF_KEYS = (code_ref, doc_ref)",
|
|
847
|
+
refindex.REF_KEYS == ("code_ref", "doc_ref"), str(refindex.REF_KEYS))
|
|
848
|
+
reg = refindex.registry()
|
|
849
|
+
check("注册表覆盖 code_ref / doc_ref",
|
|
850
|
+
"code_ref" in reg and "doc_ref" in reg, str(sorted(reg)))
|
|
851
|
+
check("kind_of_path 按后缀判 kind",
|
|
852
|
+
refindex.kind_of_path("a.py") == "code_ref"
|
|
853
|
+
and refindex.kind_of_path("a.md") == "doc_ref"
|
|
854
|
+
and refindex.kind_of_path("a.txt") == "",
|
|
855
|
+
f"py={refindex.kind_of_path('a.py')} md={refindex.kind_of_path('a.md')}")
|
|
856
|
+
try:
|
|
857
|
+
refindex.extract("x = 1", "foo.xyz")
|
|
858
|
+
raised = False
|
|
859
|
+
except ValueError as exc:
|
|
860
|
+
raised = "无提取器" in str(exc) or "无索引提取器" in str(exc)
|
|
861
|
+
check("无提取器后缀显式报错(不静默)", raised)
|
|
862
|
+
|
|
863
|
+
# ============================================ ② 全量索引 + 水位
|
|
864
|
+
print("\n【2】index_code 全量 + _refindex.json 水位")
|
|
865
|
+
out1 = index_read(cg, src)
|
|
866
|
+
check("op=index_code ok", out1.get("ok"), str(out1)[:120])
|
|
867
|
+
check("files == 2(命中后缀)", out1.get("files") == 2, str(out1.get("files")))
|
|
868
|
+
check("indexed > 0 且 error_count == 0",
|
|
869
|
+
out1.get("indexed", 0) > 0 and out1.get("error_count") == 0)
|
|
870
|
+
cg.flush()
|
|
871
|
+
led = refindex.Ledger(ROOT)
|
|
872
|
+
summ = led.summary()
|
|
873
|
+
check("_refindex.json 落盘", summ["exists"], summ["path"])
|
|
874
|
+
check("水位 files == 2", summ["files"] == 2, str(summ["files"]))
|
|
875
|
+
check("水位 nodes == 本轮 indexed",
|
|
876
|
+
summ["nodes"] == out1.get("indexed"), f"{summ['nodes']} == {out1.get('indexed')}")
|
|
877
|
+
n_before = len((cg.index.get("nodes") or {}))
|
|
878
|
+
ids1 = set(out1.get("ids") or [])
|
|
879
|
+
|
|
880
|
+
# ============================================ ③ 增量:未变则跳过
|
|
881
|
+
print("\n【3】增量索引:未变文件不重切(修 F)")
|
|
882
|
+
out2 = index_read(cg, src, incremental=True)
|
|
883
|
+
check("incremental 跳过未变文件",
|
|
884
|
+
out2.get("skipped_unchanged") == 2, str(out2.get("skipped_unchanged")))
|
|
885
|
+
check("incremental 下 indexed == 0(没有重复条目)",
|
|
886
|
+
out2.get("indexed") == 0, str(out2.get("indexed")))
|
|
887
|
+
cg.flush()
|
|
888
|
+
check("增量后节点数不变(幂等)",
|
|
889
|
+
len((cg.index.get("nodes") or {})) == n_before,
|
|
890
|
+
f"{len((cg.index.get('nodes') or {}))} == {n_before}")
|
|
891
|
+
out3 = index_read(cg, src)
|
|
892
|
+
check("默认(不传 incremental)仍是全量:不跳过",
|
|
893
|
+
out3.get("skipped_unchanged") == 0, str(out3.get("skipped_unchanged")))
|
|
894
|
+
check("重跑 id 集合稳定", set(out3.get("ids") or []) == ids1,
|
|
895
|
+
f"{len(set(out3.get('ids') or []))} vs {len(ids1)}")
|
|
896
|
+
|
|
897
|
+
# ============================================ ④ 回读 + 检索带 ref
|
|
898
|
+
print("\n【4】op=ref 回读 + 检索结果带 ref / ref_kind")
|
|
899
|
+
rr = ref_read(cg, node_id=(out1.get("ids") or [""])[0])
|
|
900
|
+
check("op=ref read ok", rr.get("ok") is True, str(rr)[:120])
|
|
901
|
+
check("ref_kind == code_ref", rr.get("ref_kind") == "code_ref",
|
|
902
|
+
str(rr.get("ref_kind")))
|
|
903
|
+
check("回读带 hash_match(源未动 → True)",
|
|
904
|
+
rr.get("hash_match") is True, str(rr.get("hash_match")))
|
|
905
|
+
read = call_tool(cg, "cg", {"op": "read", "query": "compute_energy", "k": 10})
|
|
906
|
+
hits = [r for r in read.get("results", []) if r.get("ref_kind") == "code_ref"]
|
|
907
|
+
check("检索结果带 ref / ref_kind 字段", bool(hits), f"hits={len(hits)}")
|
|
908
|
+
check("检索的 ref 指回源文件",
|
|
909
|
+
bool(hits) and isinstance(hits[0].get("ref"), dict)
|
|
910
|
+
and hits[0]["ref"].get("path") == "alpha.py",
|
|
911
|
+
str(hits[0].get("ref") if hits else None))
|
|
912
|
+
|
|
913
|
+
# ============================================ ⑤ 漂移:stale
|
|
914
|
+
print("\n【5】漂移检测:改源一行 → stale(只读、不抛)")
|
|
915
|
+
wr(alpha, ALPHA_DRIFT, bump=5.0)
|
|
916
|
+
mt_before = {p: os.path.getmtime(p) for p in (alpha, beta)}
|
|
917
|
+
chk = ref_read(cg, action="check")
|
|
918
|
+
mt_after = {p: os.path.getmtime(p) for p in (alpha, beta)}
|
|
919
|
+
check("action=check 返回 ok", isinstance(chk, dict), str(type(chk)))
|
|
920
|
+
check("check 判定 ok=False(有漂移)", chk.get("ok") is False, str(chk.get("ok")))
|
|
921
|
+
check("报出 stale 且指向 alpha.py",
|
|
922
|
+
any((r.get("path") or "").endswith("alpha.py") for r in chk.get("stale", [])),
|
|
923
|
+
str([r.get("path") for r in chk.get("stale", [])]))
|
|
924
|
+
check("巡检只读:源文件 mtime 不变", mt_before == mt_after)
|
|
925
|
+
stale_rr = ref_read(cg, ref={"path": "alpha.py", "lineno": 5, "end": 7,
|
|
926
|
+
"hash": "deadbeef", "root": src, "precise": True})
|
|
927
|
+
check("回读陈旧 ref → hash_match=False / stale=True",
|
|
928
|
+
stale_rr.get("hash_match") is False and stale_rr.get("stale") is True,
|
|
929
|
+
str(stale_rr.get("hash_match")))
|
|
930
|
+
index_read(cg, src) # 重建:漂移消除
|
|
931
|
+
chk2 = ref_read(cg, action="check")
|
|
932
|
+
check("重跑 index_code 后 stale 消除", chk2.get("ok") is True,
|
|
933
|
+
str([r.get("path") for r in chk2.get("stale", [])]))
|
|
934
|
+
|
|
935
|
+
# ============================================ 6 判据分工(#4)
|
|
936
|
+
print("\n【6】判据分工:漂移只由节点 ref 判,水位只判「能不能跳过」")
|
|
937
|
+
guard_verdict_owner(tmp)
|
|
938
|
+
|
|
939
|
+
# ============================================ 7 撞 id 现场(D1 现状钉子)
|
|
940
|
+
print("\n【7】撞 id 现场:归因可见 + 不重复报红(现状钉子 / 迁移触发器)")
|
|
941
|
+
guard_collision(tmp)
|
|
942
|
+
|
|
943
|
+
# ============================================ 8 悬空:dangling
|
|
944
|
+
print("\n【8】悬空检测:删源文件 → dangling")
|
|
945
|
+
os.remove(beta)
|
|
946
|
+
chk3 = ref_read(cg, action="check")
|
|
947
|
+
check("报出 dangling 且指向 beta.py",
|
|
948
|
+
any((r.get("path") or "").endswith("beta.py")
|
|
949
|
+
for r in chk3.get("dangling", [])),
|
|
950
|
+
str([r.get("path") for r in chk3.get("dangling", [])]))
|
|
951
|
+
check("dangling 时 ok=False", chk3.get("ok") is False)
|
|
952
|
+
wr(beta, BETA) # 恢复源 + 重建
|
|
953
|
+
index_read(cg, src)
|
|
954
|
+
chk4 = ref_read(cg, action="check")
|
|
955
|
+
check("恢复源并重建后 dangling 消除",
|
|
956
|
+
chk4.get("ok") is True and not chk4.get("dangling"),
|
|
957
|
+
str([r.get("path") for r in chk4.get("dangling", [])]))
|
|
958
|
+
|
|
959
|
+
# ============================================ 9 截断不静默 + 水位留痕
|
|
960
|
+
print("\n【9】截断显式上报 + 写进水位")
|
|
961
|
+
tr = index_read(cg, src, max_files=1)
|
|
962
|
+
check("max_files=1 → truncated=True", tr.get("truncated") is True)
|
|
963
|
+
check("truncated_reason 指出 max_files",
|
|
964
|
+
"max_files" in (tr.get("truncated_reason") or ""),
|
|
965
|
+
str(tr.get("truncated_reason")))
|
|
966
|
+
stt = ref_read(cg, action="stat")
|
|
967
|
+
check("action=stat 返回水位与 last_index",
|
|
968
|
+
isinstance(stt.get("ledger"), dict)
|
|
969
|
+
and "last_index" in stt["ledger"], str(stt.get("ledger"))[:120])
|
|
970
|
+
check("水位记下 last_index.truncated=True",
|
|
971
|
+
(stt["ledger"].get("last_index") or {}).get("truncated") is True)
|
|
972
|
+
index_read(cg, src)
|
|
973
|
+
check("重跑全量后 last_index.truncated 回 False",
|
|
974
|
+
(ref_read(cg, action="stat")["ledger"].get("last_index") or {})
|
|
975
|
+
.get("truncated") is False)
|
|
976
|
+
|
|
977
|
+
# ============================================ 10 接入 sustain.diagnose / heal
|
|
978
|
+
print("\n【10】接入 sustain:diagnose 报 ref_stale,heal 的 rebuild_refs 修复")
|
|
979
|
+
wr(alpha, ALPHA_DRIFT2, bump=5.0)
|
|
980
|
+
diag = call_tool(cg, "cg", {"op": "sustain", "action": "diagnose"})
|
|
981
|
+
codes = {i["code"] for i in diag.get("issues", [])}
|
|
982
|
+
check("diagnose issues 含 ref_stale", "ref_stale" in codes, str(sorted(codes)))
|
|
983
|
+
check("diagnose stats 报 ref_stale / ref_checked",
|
|
984
|
+
diag.get("stats", {}).get("ref_stale", 0) >= 1
|
|
985
|
+
and "ref_checked" in diag.get("stats", {}),
|
|
986
|
+
str(diag.get("stats", {}).get("ref_stale")))
|
|
987
|
+
check("巡检不改源文件(改动仍在)", ALPHA_MARK2 in rd(alpha))
|
|
988
|
+
heal = call_tool(cg, "cg", {"op": "sustain", "action": "heal"})
|
|
989
|
+
check("heal 动作含 rebuild_refs",
|
|
990
|
+
any(a.get("code") == "rebuild_refs" for a in heal.get("actions", [])),
|
|
991
|
+
str([a.get("code") for a in heal.get("actions", [])]))
|
|
992
|
+
diag2 = call_tool(cg, "cg", {"op": "sustain", "action": "diagnose"})
|
|
993
|
+
codes2 = {i["code"] for i in diag2.get("issues", [])}
|
|
994
|
+
check("heal 后 ref_stale 消除", "ref_stale" not in codes2, str(sorted(codes2)))
|
|
995
|
+
check("heal 不修改源文件", ALPHA_MARK2 in rd(alpha))
|
|
996
|
+
|
|
997
|
+
# ============================================ 11 派生物不膨胀 + 未知 action
|
|
998
|
+
print("\n【11】_refindex.json 不膨胀 / 未知 action 不静默")
|
|
999
|
+
led2 = refindex.Ledger(ROOT)
|
|
1000
|
+
p = led2.path
|
|
1001
|
+
size1 = os.path.getsize(p)
|
|
1002
|
+
for _ in range(3):
|
|
1003
|
+
index_read(cg, src)
|
|
1004
|
+
size2 = os.path.getsize(p)
|
|
1005
|
+
check("_refindex.json 体积有界(< 20KB)", size2 < 20000, f"{size2}B")
|
|
1006
|
+
check("重跑 3 次不膨胀", size2 == size1, f"{size1} -> {size2}")
|
|
1007
|
+
check("水位 files 仍 == 2(无幽灵条目)", led2.summary()["files"] == 2,
|
|
1008
|
+
str(led2.summary()["files"]))
|
|
1009
|
+
try:
|
|
1010
|
+
r = ref_read(cg, action="nope")
|
|
1011
|
+
silent = (isinstance(r, dict) and r.get("ok") is True)
|
|
1012
|
+
except Exception: # noqa: BLE001
|
|
1013
|
+
silent = False
|
|
1014
|
+
check("未知 action 不静默成功", silent is False)
|
|
1015
|
+
|
|
1016
|
+
# ============================================ 12 自愈止血 + 水位保全
|
|
1017
|
+
print("\n【12】自愈止血与水位保全(水位不被写空 / 失败不记成成功 / 同因不重试)")
|
|
1018
|
+
guard_heal_bounded(tmp)
|
|
1019
|
+
|
|
1020
|
+
# ============================================ 13 口径钉子(#5)
|
|
1021
|
+
print("\n【13】口径钉子:id 位置化 + 幂等判据由区间哈希承担(文档↔实现同源)")
|
|
1022
|
+
guard_id_and_idempotence(tmp)
|
|
1023
|
+
|
|
1024
|
+
# ============================================ 14 常驻循环止血
|
|
1025
|
+
print("\n【14】常驻循环止血(repeat_guard / 不静默 / 不假装修好)")
|
|
1026
|
+
guard_loop_tick_heal(tmp)
|
|
1027
|
+
|
|
1028
|
+
finally:
|
|
1029
|
+
shutil.rmtree(tmp, ignore_errors=True)
|
|
1030
|
+
|
|
1031
|
+
print("\n" + "=" * 68)
|
|
1032
|
+
print(f"通过 {PASS} / 失败 {FAIL}")
|
|
1033
|
+
if FAILS:
|
|
1034
|
+
print("失败项:\n - " + "\n - ".join(FAILS))
|
|
1035
|
+
print("=" * 68)
|
|
1036
|
+
if args.head_baseline:
|
|
1037
|
+
# 短码集合比对:变异后**恰好**命中预期红项(多一项少一项都报红)。无 cid 的
|
|
1038
|
+
# 失败在 check 里记了哨兵 "?<name>",故「波及到没登记的断言」也在此报红。
|
|
1039
|
+
got, exp = sorted(set(RED)), sorted(EXPECTED_RED)
|
|
1040
|
+
if got == exp:
|
|
1041
|
+
print("红基线符合预期:变异后恰好命中 %d 项 —— %s"
|
|
1042
|
+
% (len(exp), "、".join(exp)))
|
|
1043
|
+
return 0
|
|
1044
|
+
print("红基线与预期不符(fail-closed)——预期红项:%s;实得红项:%s"
|
|
1045
|
+
% ("、".join(exp) or "(无)", "、".join(got) or "(无)"))
|
|
1046
|
+
return 1
|
|
1047
|
+
return 1 if FAIL else 0
|
|
1048
|
+
|
|
1049
|
+
|
|
1050
|
+
if __name__ == "__main__":
|
|
1051
|
+
if hasattr(sys.stdout, "reconfigure"):
|
|
1052
|
+
sys.stdout.reconfigure(encoding="utf-8", errors="replace")
|
|
1053
|
+
sys.exit(main())
|