@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,777 +1,792 @@
|
|
|
1
|
-
# -*- coding: utf-8 -*-
|
|
2
|
-
"""条件文档图端到端测试(P27 · 认知图的文档面)。
|
|
3
|
-
|
|
4
|
-
R2 改造的验收(对照 docs/mdcg/认知图_索引与工程规范化_计划_v0.1.md §六 R2、§七):
|
|
5
|
-
|
|
6
|
-
① 切块纪律:只切 level<=3;直接正文 <200 字且无子节的小节**合并进父节**
|
|
7
|
-
(不单独建节点,其文字进父节摘要)。既不过细,也不丢内容。
|
|
8
|
-
② md 解析硬约束:
|
|
9
|
-
· **围栏代码块内的 `#` 不是标题**(docs/ 里全是 python/shell 片段,不跟踪
|
|
10
|
-
围栏就会切出假标题、把一节切碎);
|
|
11
|
-
· **开头 YAML frontmatter 不被当正文索引**;**正文里的 `---` 不污染
|
|
12
|
-
frontmatter**(nodefile 既有纪律,这里验证不回归)。
|
|
13
|
-
③ 渲染即 CCG:`docindex.render` 必须产 CCG 6 行,否则文档节点会像改造前的
|
|
14
|
-
codeindex 一样「存得进、判不了、检索不到」(恒定 BLINDSPOT)。
|
|
15
|
-
④ doc_ref + op=ref:只存标题与摘要、**不存全文**;正文按 doc_ref 回读,
|
|
16
|
-
与 code 节点共用同一 `region_hash` → hash_match 可检漂移、可重跑恢复。
|
|
17
|
-
⑤ §1.3-3 裁定落地:layer 默认 knowledge;密级默认 internal **显式写入**
|
|
18
|
-
frontmatter,路径段命中私有提示再保守降为 private;调用方可显式覆盖。
|
|
19
|
-
⑥ 真实 docs/:章节可定位(行号与源文件一致),能检索到并按 CCG 判 ACCEPT。
|
|
20
|
-
⑦ 不静默:truncated / skipped_suffixes / skipped_dirs 显式上报;排除为**追加**
|
|
21
|
-
(只增不减,内置 .git/.venv/node_modules 不可被关闭);只读契约(源 mtime 不变);
|
|
22
|
-
幂等(重跑节点数不变);`index_doc` 进 ALL_OPS 且与工具 schema 一致。
|
|
23
|
-
⑧ fence 往返列六件套的形状与边界:BINDING_FIELDS / binding_of / binding_key
|
|
24
|
-
(**不含行位**)/ binding_slug / validate_binding / binding_drift / locate。
|
|
25
|
-
为什么必须钉死:列形状漂移会让对账器把坏列当好消息(漏报);键若悄悄带上
|
|
26
|
-
行位,真源上方插一行就会让整库失配——两者都是静默退化,只有断言看得见。
|
|
27
|
-
⑨ 逐字节回放回归:对**真实索引出的卡**断言 `render(条目) + "\n" == 卡片正文`。
|
|
28
|
-
⑧ 只证「列可定位」;只有逐字节相等才证明卡片是真源条目的**派生物**而非另一份
|
|
29
|
-
副本(渲染漂移或人工改写时列全然不变,对账器看不出来)。外部历史库另段抽样
|
|
30
|
-
(设 MDCG_ROOT 则跑,未设如实 SKIP 不虚报通过)。
|
|
31
|
-
|
|
32
|
-
运行:python -m md_cg.test_p27_docindex
|
|
33
|
-
设 MDCG_TEST_LIVE_ROOT=1 且 MDCG_ROOT=<认知图库根> 时才追加跑【12b】
|
|
34
|
-
外部历史库逐字节回放抽样(该段会以新身份打开外部库并 provision DEK,
|
|
35
|
-
故默认不跑:跑测试不该动生产库)
|
|
36
|
-
"""
|
|
37
|
-
from __future__ import annotations
|
|
38
|
-
|
|
39
|
-
import os
|
|
40
|
-
import random
|
|
41
|
-
import shutil
|
|
42
|
-
import sys
|
|
43
|
-
import tempfile
|
|
44
|
-
|
|
45
|
-
from . import codeindex, corpus, docindex, nodefile, refindex, routing, tokens
|
|
46
|
-
from . import mcp_server
|
|
47
|
-
from .mdcos import MdCGOS, MdCGSecure # 生产路径:forget 属 OS 层,基础层 MdCG 无删除原语
|
|
48
|
-
from .mcp_server import call_tool
|
|
49
|
-
from .security import Principal
|
|
50
|
-
|
|
51
|
-
PASS = FAIL = 0
|
|
52
|
-
FAILS = []
|
|
53
|
-
|
|
54
|
-
_BASE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
|
55
|
-
ROOT = os.path.join(_BASE, "_md_cg_p27")
|
|
56
|
-
DOCS = os.path.join(_BASE, "docs")
|
|
57
|
-
PLAN_DOC = "mdcg/认知图_MD目录方案_v0.1.md"
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
def check(name, cond, detail=""):
|
|
61
|
-
global PASS, FAIL
|
|
62
|
-
if cond:
|
|
63
|
-
PASS += 1
|
|
64
|
-
print(f" [PASS] {name}" + (f" · {detail}" if detail else ""))
|
|
65
|
-
else:
|
|
66
|
-
FAIL += 1
|
|
67
|
-
FAILS.append(name)
|
|
68
|
-
print(f" [FAIL] {name} · {detail}")
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
def _norm(p):
|
|
72
|
-
"""路径归一(大小写 + 分隔符):root 归属比对用,避免同一目录被判成两个。"""
|
|
73
|
-
return os.path.normcase(os.path.normpath(str(p or "")))
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
# 逐字节回放:把「往返列」从「形状可校验」推进到「内容可无损重建」。
|
|
77
|
-
# 生效条件:cg 已索引完成的库;索引条目 tags 含 "doc" 且 frontmatter 有非空 doc_ref。
|
|
78
|
-
# 判据:真源同键条目 `render(条目)` 补一个换行 == 卡片正文——`nodefile.dumps` 对不以
|
|
79
|
-
# 换行结尾的正文补 '\n',故卡片正文恒比 render 多 1 字节(是常态,不是缺陷;判等
|
|
80
|
-
# 一律按 `render + "\n"`,避免把口径差当回归)。
|
|
81
|
-
# 为什么非此不可:列形状对(validate_binding)只保证「可定位」;只有逐字节相等才
|
|
82
|
-
# 证明卡片是真源条目的**派生物**而非另一份副本。渲染漂移或人工改写卡片正文时,
|
|
83
|
-
# 列全都不变(路径/行位/hash 都是真源侧的值),对账器看不出来——本函数才看得见。
|
|
84
|
-
# 悬空(真源已移出)/ 未解析如实计数:那是数据面事实,不冒充渲染失败。
|
|
85
|
-
def _replay_cards(cg, roots=None, sample=0, seed=7):
|
|
86
|
-
nodes = (getattr(cg, "index", {}) or {}).get("nodes") or {}
|
|
87
|
-
picks = []
|
|
88
|
-
for nid in sorted(nodes):
|
|
89
|
-
if "doc" not in ((nodes.get(nid) or {}).get("tags") or []):
|
|
90
|
-
continue
|
|
91
|
-
kind, ref = refindex.ref_of(cg.get(nid))
|
|
92
|
-
if kind != "doc_ref" or not ref:
|
|
93
|
-
continue
|
|
94
|
-
if roots is not None and _norm(ref.get("root")) not in roots:
|
|
95
|
-
continue
|
|
96
|
-
picks.append((nid, ref))
|
|
97
|
-
if sample and len(picks) > sample:
|
|
98
|
-
picks = sorted(random.Random(seed).sample(picks, sample))
|
|
99
|
-
out = {"sampled": len(picks), "ok": 0, "dangling": 0, "gone": 0,
|
|
100
|
-
"unreadable": 0, "mismatch": []}
|
|
101
|
-
cache = {}
|
|
102
|
-
for nid, ref in picks:
|
|
103
|
-
fp = (str(ref.get("root") or ""), str(ref.get("path") or ""))
|
|
104
|
-
ckey = (_norm(fp[0]), fp[1])
|
|
105
|
-
if ckey not in cache:
|
|
106
|
-
# 把「源文件已移出」(数据面事实,非缺陷)与其它 IO/抽取异常(可能是真
|
|
107
|
-
# 问题:权限、编码、源被改成无标题文档)分开计数——混为一谈会把真实
|
|
108
|
-
# 故障伪装成历史遗留,静默吞掉回归。三态:True 读得 / False 不存在 /
|
|
109
|
-
# None 读不了。
|
|
110
|
-
try:
|
|
111
|
-
with open(os.path.join(fp[0], fp[1]), "r", encoding="utf-8",
|
|
112
|
-
errors="replace") as f:
|
|
113
|
-
cache[ckey] = (True, docindex.extract(f.read(), fp[1]))
|
|
114
|
-
except FileNotFoundError:
|
|
115
|
-
cache[ckey] = (False, None)
|
|
116
|
-
except (OSError, ValueError):
|
|
117
|
-
cache[ckey] = (None, None)
|
|
118
|
-
hit, items = cache[ckey]
|
|
119
|
-
if hit is not True:
|
|
120
|
-
out["gone" if hit is False else "unreadable"] += 1
|
|
121
|
-
continue
|
|
122
|
-
node = cg.get(nid) or {}
|
|
123
|
-
want = docindex.binding_key(docindex.binding_of(node))
|
|
124
|
-
# 键(path#heading_path)在同名标题重复时可能命中多条:先按行位锁定同名代,
|
|
125
|
-
# 行位也漂了才回落首条(此时本来就判「不符」,不掩盖结论)。
|
|
126
|
-
cands = [i for i in items if docindex.binding_key(i) == want]
|
|
127
|
-
if not cands:
|
|
128
|
-
out["dangling"] += 1
|
|
129
|
-
continue
|
|
130
|
-
item = next((i for i in cands if i.get("lineno") == ref.get("lineno")),
|
|
131
|
-
cands[0])
|
|
132
|
-
got = docindex.render(item) + "\n"
|
|
133
|
-
content = node.get("content") or ""
|
|
134
|
-
if got == content:
|
|
135
|
-
out["ok"] += 1
|
|
136
|
-
continue
|
|
137
|
-
k = next((i for i in range(min(len(got), len(content)))
|
|
138
|
-
if got[i] != content[i]), min(len(got), len(content)))
|
|
139
|
-
out["mismatch"].append(
|
|
140
|
-
f"{nid}@{k} 回放={got[k:k + 24]!r} 卡片={content[k:k + 24]!r}")
|
|
141
|
-
return out
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
LONG = "这是总览段落," + "用以验证章节切块在长正文下的表现," * 12 + "结束。"
|
|
145
|
-
|
|
146
|
-
GUIDE_LINES = [
|
|
147
|
-
"---",
|
|
148
|
-
"title: 测试指南",
|
|
149
|
-
"tags: [a, b]",
|
|
150
|
-
"---",
|
|
151
|
-
"",
|
|
152
|
-
"# 总览",
|
|
153
|
-
"",
|
|
154
|
-
LONG,
|
|
155
|
-
"",
|
|
156
|
-
"## 9. 分阶段实施",
|
|
157
|
-
"",
|
|
158
|
-
"表格与正文说明。",
|
|
159
|
-
"",
|
|
160
|
-
"| 阶段 | 内容 |",
|
|
161
|
-
"|---|---|",
|
|
162
|
-
"| R1 | 索引 |",
|
|
163
|
-
"",
|
|
164
|
-
"### 9.1 小节点",
|
|
165
|
-
"",
|
|
166
|
-
"一行小注。",
|
|
167
|
-
"",
|
|
168
|
-
"## 代码示例",
|
|
169
|
-
"",
|
|
170
|
-
"```python",
|
|
171
|
-
"# 这不是标题",
|
|
172
|
-
"## 也不是标题",
|
|
173
|
-
"def f():",
|
|
174
|
-
" return 1",
|
|
175
|
-
"```",
|
|
176
|
-
"",
|
|
177
|
-
"---",
|
|
178
|
-
"",
|
|
179
|
-
"### 末尾小节",
|
|
180
|
-
"",
|
|
181
|
-
"收尾正文。",
|
|
182
|
-
]
|
|
183
|
-
GUIDE = "\n".join(GUIDE_LINES)
|
|
184
|
-
|
|
185
|
-
SECRET = "\n".join([
|
|
186
|
-
"# 私有配置",
|
|
187
|
-
"",
|
|
188
|
-
"这是私有目录下的文档。",
|
|
189
|
-
"",
|
|
190
|
-
"## 子节",
|
|
191
|
-
"",
|
|
192
|
-
"内容。",
|
|
193
|
-
])
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
def find(items, heading):
|
|
197
|
-
return next((i for i in items if i["heading"] == heading), None)
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
def index_doc(cg, path, **extra):
|
|
201
|
-
a = {"op": "index_doc", "path": path}
|
|
202
|
-
a.update(extra)
|
|
203
|
-
return call_tool(cg, "cg", a)
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
def main():
|
|
207
|
-
print("=" * 68)
|
|
208
|
-
print("md 认知图 P27 验收 · 文档索引(index_doc / doc_ref / op=ref)")
|
|
209
|
-
print("=" * 68)
|
|
210
|
-
|
|
211
|
-
tmp = tempfile.mkdtemp(prefix="mdcg_docidx_")
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
check("
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
check("
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
check("
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
check("
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
check("
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
#
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
check("
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
check("
|
|
312
|
-
|
|
313
|
-
str(
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
check("
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
check("
|
|
326
|
-
|
|
327
|
-
check("
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
str(
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
check("
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
check("
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
check("
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
# =====================================================
|
|
411
|
-
print("\n【
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
check("
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
#
|
|
436
|
-
|
|
437
|
-
#
|
|
438
|
-
#
|
|
439
|
-
#
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
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
|
-
for
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
check("
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
_i, _e,
|
|
513
|
-
check("
|
|
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
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
check("
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
check("
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
check("
|
|
576
|
-
|
|
577
|
-
|
|
578
|
-
|
|
579
|
-
check("
|
|
580
|
-
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
check("
|
|
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
|
-
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
check("
|
|
633
|
-
|
|
634
|
-
and
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
docindex.
|
|
639
|
-
str(
|
|
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
|
-
check("
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
docindex.
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
|
|
686
|
-
str(
|
|
687
|
-
check("
|
|
688
|
-
docindex.
|
|
689
|
-
and docindex.
|
|
690
|
-
check("
|
|
691
|
-
docindex.
|
|
692
|
-
and docindex.
|
|
693
|
-
and docindex.
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
f"{rp['
|
|
721
|
-
f"
|
|
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
|
-
f"
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""条件文档图端到端测试(P27 · 认知图的文档面)。
|
|
3
|
+
|
|
4
|
+
R2 改造的验收(对照 docs/mdcg/认知图_索引与工程规范化_计划_v0.1.md §六 R2、§七):
|
|
5
|
+
|
|
6
|
+
① 切块纪律:只切 level<=3;直接正文 <200 字且无子节的小节**合并进父节**
|
|
7
|
+
(不单独建节点,其文字进父节摘要)。既不过细,也不丢内容。
|
|
8
|
+
② md 解析硬约束:
|
|
9
|
+
· **围栏代码块内的 `#` 不是标题**(docs/ 里全是 python/shell 片段,不跟踪
|
|
10
|
+
围栏就会切出假标题、把一节切碎);
|
|
11
|
+
· **开头 YAML frontmatter 不被当正文索引**;**正文里的 `---` 不污染
|
|
12
|
+
frontmatter**(nodefile 既有纪律,这里验证不回归)。
|
|
13
|
+
③ 渲染即 CCG:`docindex.render` 必须产 CCG 6 行,否则文档节点会像改造前的
|
|
14
|
+
codeindex 一样「存得进、判不了、检索不到」(恒定 BLINDSPOT)。
|
|
15
|
+
④ doc_ref + op=ref:只存标题与摘要、**不存全文**;正文按 doc_ref 回读,
|
|
16
|
+
与 code 节点共用同一 `region_hash` → hash_match 可检漂移、可重跑恢复。
|
|
17
|
+
⑤ §1.3-3 裁定落地:layer 默认 knowledge;密级默认 internal **显式写入**
|
|
18
|
+
frontmatter,路径段命中私有提示再保守降为 private;调用方可显式覆盖。
|
|
19
|
+
⑥ 真实 docs/:章节可定位(行号与源文件一致),能检索到并按 CCG 判 ACCEPT。
|
|
20
|
+
⑦ 不静默:truncated / skipped_suffixes / skipped_dirs 显式上报;排除为**追加**
|
|
21
|
+
(只增不减,内置 .git/.venv/node_modules 不可被关闭);只读契约(源 mtime 不变);
|
|
22
|
+
幂等(重跑节点数不变);`index_doc` 进 ALL_OPS 且与工具 schema 一致。
|
|
23
|
+
⑧ fence 往返列六件套的形状与边界:BINDING_FIELDS / binding_of / binding_key
|
|
24
|
+
(**不含行位**)/ binding_slug / validate_binding / binding_drift / locate。
|
|
25
|
+
为什么必须钉死:列形状漂移会让对账器把坏列当好消息(漏报);键若悄悄带上
|
|
26
|
+
行位,真源上方插一行就会让整库失配——两者都是静默退化,只有断言看得见。
|
|
27
|
+
⑨ 逐字节回放回归:对**真实索引出的卡**断言 `render(条目) + "\n" == 卡片正文`。
|
|
28
|
+
⑧ 只证「列可定位」;只有逐字节相等才证明卡片是真源条目的**派生物**而非另一份
|
|
29
|
+
副本(渲染漂移或人工改写时列全然不变,对账器看不出来)。外部历史库另段抽样
|
|
30
|
+
(设 MDCG_ROOT 则跑,未设如实 SKIP 不虚报通过)。
|
|
31
|
+
|
|
32
|
+
运行:python -m md_cg.test_p27_docindex
|
|
33
|
+
设 MDCG_TEST_LIVE_ROOT=1 且 MDCG_ROOT=<认知图库根> 时才追加跑【12b】
|
|
34
|
+
外部历史库逐字节回放抽样(该段会以新身份打开外部库并 provision DEK,
|
|
35
|
+
故默认不跑:跑测试不该动生产库)
|
|
36
|
+
"""
|
|
37
|
+
from __future__ import annotations
|
|
38
|
+
|
|
39
|
+
import os
|
|
40
|
+
import random
|
|
41
|
+
import shutil
|
|
42
|
+
import sys
|
|
43
|
+
import tempfile
|
|
44
|
+
|
|
45
|
+
from . import codeindex, corpus, docindex, nodefile, refindex, routing, tokens
|
|
46
|
+
from . import mcp_server
|
|
47
|
+
from .mdcos import MdCGOS, MdCGSecure # 生产路径:forget 属 OS 层,基础层 MdCG 无删除原语
|
|
48
|
+
from .mcp_server import call_tool
|
|
49
|
+
from .security import Principal
|
|
50
|
+
|
|
51
|
+
PASS = FAIL = 0
|
|
52
|
+
FAILS = []
|
|
53
|
+
|
|
54
|
+
_BASE = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
|
|
55
|
+
ROOT = os.path.join(_BASE, "_md_cg_p27")
|
|
56
|
+
DOCS = os.path.join(_BASE, "docs")
|
|
57
|
+
PLAN_DOC = "mdcg/认知图_MD目录方案_v0.1.md"
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
def check(name, cond, detail=""):
|
|
61
|
+
global PASS, FAIL
|
|
62
|
+
if cond:
|
|
63
|
+
PASS += 1
|
|
64
|
+
print(f" [PASS] {name}" + (f" · {detail}" if detail else ""))
|
|
65
|
+
else:
|
|
66
|
+
FAIL += 1
|
|
67
|
+
FAILS.append(name)
|
|
68
|
+
print(f" [FAIL] {name} · {detail}")
|
|
69
|
+
|
|
70
|
+
|
|
71
|
+
def _norm(p):
|
|
72
|
+
"""路径归一(大小写 + 分隔符):root 归属比对用,避免同一目录被判成两个。"""
|
|
73
|
+
return os.path.normcase(os.path.normpath(str(p or "")))
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
# 逐字节回放:把「往返列」从「形状可校验」推进到「内容可无损重建」。
|
|
77
|
+
# 生效条件:cg 已索引完成的库;索引条目 tags 含 "doc" 且 frontmatter 有非空 doc_ref。
|
|
78
|
+
# 判据:真源同键条目 `render(条目)` 补一个换行 == 卡片正文——`nodefile.dumps` 对不以
|
|
79
|
+
# 换行结尾的正文补 '\n',故卡片正文恒比 render 多 1 字节(是常态,不是缺陷;判等
|
|
80
|
+
# 一律按 `render + "\n"`,避免把口径差当回归)。
|
|
81
|
+
# 为什么非此不可:列形状对(validate_binding)只保证「可定位」;只有逐字节相等才
|
|
82
|
+
# 证明卡片是真源条目的**派生物**而非另一份副本。渲染漂移或人工改写卡片正文时,
|
|
83
|
+
# 列全都不变(路径/行位/hash 都是真源侧的值),对账器看不出来——本函数才看得见。
|
|
84
|
+
# 悬空(真源已移出)/ 未解析如实计数:那是数据面事实,不冒充渲染失败。
|
|
85
|
+
def _replay_cards(cg, roots=None, sample=0, seed=7):
|
|
86
|
+
nodes = (getattr(cg, "index", {}) or {}).get("nodes") or {}
|
|
87
|
+
picks = []
|
|
88
|
+
for nid in sorted(nodes):
|
|
89
|
+
if "doc" not in ((nodes.get(nid) or {}).get("tags") or []):
|
|
90
|
+
continue
|
|
91
|
+
kind, ref = refindex.ref_of(cg.get(nid))
|
|
92
|
+
if kind != "doc_ref" or not ref:
|
|
93
|
+
continue
|
|
94
|
+
if roots is not None and _norm(ref.get("root")) not in roots:
|
|
95
|
+
continue
|
|
96
|
+
picks.append((nid, ref))
|
|
97
|
+
if sample and len(picks) > sample:
|
|
98
|
+
picks = sorted(random.Random(seed).sample(picks, sample))
|
|
99
|
+
out = {"sampled": len(picks), "ok": 0, "dangling": 0, "gone": 0,
|
|
100
|
+
"unreadable": 0, "mismatch": []}
|
|
101
|
+
cache = {}
|
|
102
|
+
for nid, ref in picks:
|
|
103
|
+
fp = (str(ref.get("root") or ""), str(ref.get("path") or ""))
|
|
104
|
+
ckey = (_norm(fp[0]), fp[1])
|
|
105
|
+
if ckey not in cache:
|
|
106
|
+
# 把「源文件已移出」(数据面事实,非缺陷)与其它 IO/抽取异常(可能是真
|
|
107
|
+
# 问题:权限、编码、源被改成无标题文档)分开计数——混为一谈会把真实
|
|
108
|
+
# 故障伪装成历史遗留,静默吞掉回归。三态:True 读得 / False 不存在 /
|
|
109
|
+
# None 读不了。
|
|
110
|
+
try:
|
|
111
|
+
with open(os.path.join(fp[0], fp[1]), "r", encoding="utf-8",
|
|
112
|
+
errors="replace") as f:
|
|
113
|
+
cache[ckey] = (True, docindex.extract(f.read(), fp[1]))
|
|
114
|
+
except FileNotFoundError:
|
|
115
|
+
cache[ckey] = (False, None)
|
|
116
|
+
except (OSError, ValueError):
|
|
117
|
+
cache[ckey] = (None, None)
|
|
118
|
+
hit, items = cache[ckey]
|
|
119
|
+
if hit is not True:
|
|
120
|
+
out["gone" if hit is False else "unreadable"] += 1
|
|
121
|
+
continue
|
|
122
|
+
node = cg.get(nid) or {}
|
|
123
|
+
want = docindex.binding_key(docindex.binding_of(node))
|
|
124
|
+
# 键(path#heading_path)在同名标题重复时可能命中多条:先按行位锁定同名代,
|
|
125
|
+
# 行位也漂了才回落首条(此时本来就判「不符」,不掩盖结论)。
|
|
126
|
+
cands = [i for i in items if docindex.binding_key(i) == want]
|
|
127
|
+
if not cands:
|
|
128
|
+
out["dangling"] += 1
|
|
129
|
+
continue
|
|
130
|
+
item = next((i for i in cands if i.get("lineno") == ref.get("lineno")),
|
|
131
|
+
cands[0])
|
|
132
|
+
got = docindex.render(item) + "\n"
|
|
133
|
+
content = node.get("content") or ""
|
|
134
|
+
if got == content:
|
|
135
|
+
out["ok"] += 1
|
|
136
|
+
continue
|
|
137
|
+
k = next((i for i in range(min(len(got), len(content)))
|
|
138
|
+
if got[i] != content[i]), min(len(got), len(content)))
|
|
139
|
+
out["mismatch"].append(
|
|
140
|
+
f"{nid}@{k} 回放={got[k:k + 24]!r} 卡片={content[k:k + 24]!r}")
|
|
141
|
+
return out
|
|
142
|
+
|
|
143
|
+
|
|
144
|
+
LONG = "这是总览段落," + "用以验证章节切块在长正文下的表现," * 12 + "结束。"
|
|
145
|
+
|
|
146
|
+
GUIDE_LINES = [
|
|
147
|
+
"---",
|
|
148
|
+
"title: 测试指南",
|
|
149
|
+
"tags: [a, b]",
|
|
150
|
+
"---",
|
|
151
|
+
"",
|
|
152
|
+
"# 总览",
|
|
153
|
+
"",
|
|
154
|
+
LONG,
|
|
155
|
+
"",
|
|
156
|
+
"## 9. 分阶段实施",
|
|
157
|
+
"",
|
|
158
|
+
"表格与正文说明。",
|
|
159
|
+
"",
|
|
160
|
+
"| 阶段 | 内容 |",
|
|
161
|
+
"|---|---|",
|
|
162
|
+
"| R1 | 索引 |",
|
|
163
|
+
"",
|
|
164
|
+
"### 9.1 小节点",
|
|
165
|
+
"",
|
|
166
|
+
"一行小注。",
|
|
167
|
+
"",
|
|
168
|
+
"## 代码示例",
|
|
169
|
+
"",
|
|
170
|
+
"```python",
|
|
171
|
+
"# 这不是标题",
|
|
172
|
+
"## 也不是标题",
|
|
173
|
+
"def f():",
|
|
174
|
+
" return 1",
|
|
175
|
+
"```",
|
|
176
|
+
"",
|
|
177
|
+
"---",
|
|
178
|
+
"",
|
|
179
|
+
"### 末尾小节",
|
|
180
|
+
"",
|
|
181
|
+
"收尾正文。",
|
|
182
|
+
]
|
|
183
|
+
GUIDE = "\n".join(GUIDE_LINES)
|
|
184
|
+
|
|
185
|
+
SECRET = "\n".join([
|
|
186
|
+
"# 私有配置",
|
|
187
|
+
"",
|
|
188
|
+
"这是私有目录下的文档。",
|
|
189
|
+
"",
|
|
190
|
+
"## 子节",
|
|
191
|
+
"",
|
|
192
|
+
"内容。",
|
|
193
|
+
])
|
|
194
|
+
|
|
195
|
+
|
|
196
|
+
def find(items, heading):
|
|
197
|
+
return next((i for i in items if i["heading"] == heading), None)
|
|
198
|
+
|
|
199
|
+
|
|
200
|
+
def index_doc(cg, path, **extra):
|
|
201
|
+
a = {"op": "index_doc", "path": path}
|
|
202
|
+
a.update(extra)
|
|
203
|
+
return call_tool(cg, "cg", a)
|
|
204
|
+
|
|
205
|
+
|
|
206
|
+
def main():
|
|
207
|
+
print("=" * 68)
|
|
208
|
+
print("md 认知图 P27 验收 · 文档索引(index_doc / doc_ref / op=ref)")
|
|
209
|
+
print("=" * 68)
|
|
210
|
+
|
|
211
|
+
tmp = tempfile.mkdtemp(prefix="mdcg_docidx_")
|
|
212
|
+
# 部署声明:本用例的读写白名单根(2026-10-10 设计者裁定 dsh #85 选 A 后,
|
|
213
|
+
# MDCG_INGEST_ROOT / MDCG_EXPORT_ROOT 未配置**不再放开**,会回落 mdcg 记忆库根
|
|
214
|
+
# 与工作区;本用例沙箱在两者之外,故必须显式声明——这正是新语义要求的
|
|
215
|
+
# 「部署用环境变量声明可读写的根」。
|
|
216
|
+
# 【9】段刻意索引仓内**真实 docs/**,故按 os.pathsep 声明多根(部署声明的正形态)
|
|
217
|
+
os.environ["MDCG_INGEST_ROOT"] = tmp + os.pathsep + _BASE
|
|
218
|
+
os.environ["MDCG_EXPORT_ROOT"] = tmp
|
|
219
|
+
fx = os.path.join(tmp, "fx")
|
|
220
|
+
os.makedirs(os.path.join(fx, "private"))
|
|
221
|
+
with open(os.path.join(fx, "guide.md"), "w", encoding="utf-8") as f:
|
|
222
|
+
f.write(GUIDE)
|
|
223
|
+
with open(os.path.join(fx, "private", "secret.md"), "w", encoding="utf-8") as f:
|
|
224
|
+
f.write(SECRET)
|
|
225
|
+
with open(os.path.join(fx, "notes.txt"), "w", encoding="utf-8") as f:
|
|
226
|
+
f.write("不是文档")
|
|
227
|
+
|
|
228
|
+
# 本用例的夹具路径**每轮不同**(`mkdtemp`),而节点 id 由 `path#heading_path`
|
|
229
|
+
# 派生(落库时路径被归一为相对根)⇒ 两轮 id 相同、`doc_ref` 却指向上一轮的
|
|
230
|
+
# 临时目录(已删)。不清库时第二轮起 `indexed==0`(同 id 已存在)且 `op=ref`
|
|
231
|
+
# 因回读路径落在旧临时目录外被根白名单拒绝——**本守卫不可重跑**,而 CI 首跑
|
|
232
|
+
# 是绿的(空库),红只在本地复跑时出现、被当成「已知基线红」长期忽略。
|
|
233
|
+
# 故显式 `clean=True`:本用例的等号断言(indexed==4)要求「重跑 ≡ 首跑」,
|
|
234
|
+
# 而 reset_root 默认「不删目录」的前提是「同 id 原子覆盖」,本用例不满足该
|
|
235
|
+
# 前提(夹具路径每轮变)。范围仅限本守卫的私有库 `_md_cg_p27`,不是大目录。
|
|
236
|
+
corpus.reset_root(ROOT, clean=True)
|
|
237
|
+
cg = MdCGOS(ROOT)
|
|
238
|
+
guide_path = os.path.join(fx, "guide.md")
|
|
239
|
+
|
|
240
|
+
try:
|
|
241
|
+
# ===================================================== ① 注册表 + 切块
|
|
242
|
+
print("\n【1】注册一致性 / 切块纪律(level<=3 + 小节点合并)")
|
|
243
|
+
cg_tool = next(t for t in mcp_server.KERNEL_TOOLS if t["name"] == "cg")
|
|
244
|
+
declared = set(cg_tool["inputSchema"]["properties"]["op"]["description"].split("|"))
|
|
245
|
+
check("工具 op 枚举 == tokens.ALL_OPS(§七-11 防漏改)",
|
|
246
|
+
declared == set(tokens.ALL_OPS),
|
|
247
|
+
f"only-schema={sorted(declared - set(tokens.ALL_OPS))} "
|
|
248
|
+
f"only-ops={sorted(set(tokens.ALL_OPS) - declared)}")
|
|
249
|
+
check("index_doc 已进 ALL_OPS", "index_doc" in tokens.ALL_OPS)
|
|
250
|
+
|
|
251
|
+
try:
|
|
252
|
+
docindex.extract("x", "foo.txt")
|
|
253
|
+
unknown = False
|
|
254
|
+
except ValueError as exc:
|
|
255
|
+
unknown = "无文档提取器" in str(exc)
|
|
256
|
+
check("无文档提取器后缀显式报错", unknown)
|
|
257
|
+
|
|
258
|
+
items = docindex.extract(GUIDE, "guide.md")
|
|
259
|
+
heads = {i["heading"] for i in items}
|
|
260
|
+
check("切块只产出 3 个节点(小节点已合并)", len(items) == 3,
|
|
261
|
+
f"n={len(items)} heads={sorted(heads)}")
|
|
262
|
+
check("围栏内的 # 不是标题(假标题零泄漏)",
|
|
263
|
+
not any("不是标题" in h for h in heads), str(sorted(heads)))
|
|
264
|
+
check("总览区间覆盖至文末(未被假标题截断)",
|
|
265
|
+
find(items, "总览")["end"] == len(GUIDE_LINES),
|
|
266
|
+
f"end={find(items, '总览')['end']}")
|
|
267
|
+
check("YAML frontmatter 未被当正文(总览起始行=6)",
|
|
268
|
+
find(items, "总览")["lineno"] == 6,
|
|
269
|
+
f"lineno={find(items, '总览')['lineno']}")
|
|
270
|
+
s9 = find(items, "9. 分阶段实施")
|
|
271
|
+
check("9. 章节区间正确(10-21)",
|
|
272
|
+
s9["lineno"] == 10 and s9["end"] == 21,
|
|
273
|
+
f"{s9['lineno']}-{s9['end']}")
|
|
274
|
+
check("heading_path 反映嵌套",
|
|
275
|
+
s9["heading_path"] == ["总览", "9. 分阶段实施"],
|
|
276
|
+
str(s9["heading_path"]))
|
|
277
|
+
check("anchor 生成正常", s9["anchor"] == "9-分阶段实施", s9["anchor"])
|
|
278
|
+
check("小节点正文并入父节摘要(不丢内容)",
|
|
279
|
+
"一行小注" in s9["summary_parts"], s9["summary_parts"][:60])
|
|
280
|
+
code = find(items, "代码示例")
|
|
281
|
+
check("文末小节点正文并入其父节摘要",
|
|
282
|
+
"收尾正文" in code["summary_parts"], code["summary_parts"][:60])
|
|
283
|
+
check("只切 level<=3(条目层级均 <=3)",
|
|
284
|
+
all(i["level"] <= 3 for i in items),
|
|
285
|
+
str([i["level"] for i in items]))
|
|
286
|
+
|
|
287
|
+
# ===================================================== ② 渲染即 CCG
|
|
288
|
+
print("\n【2】render 产出 CCG(否则恒定 BLINDSPOT)")
|
|
289
|
+
rendered = docindex.render(s9)
|
|
290
|
+
cpl = nodefile.ccg_completeness(rendered)
|
|
291
|
+
check("CCG 5 要素齐全", cpl["complete"] is True, str(cpl["required_present"]))
|
|
292
|
+
check("CCG 6 行全在", cpl["all_present"] is True)
|
|
293
|
+
# 「不存全文」的准确含义:不逐字复制整节,且摘要栏有长度上限
|
|
294
|
+
# (表格/代码若落在前 200 字内被摘要带上是有意设计——否则检索不到关键词)。
|
|
295
|
+
raw_section = "\n".join(GUIDE_LINES[9:21])
|
|
296
|
+
exec_line = next(ln for ln in rendered.split("\n") if ln.startswith("# 执行:"))
|
|
297
|
+
check("不存全文(不逐字复制整节 + 摘要栏封顶)",
|
|
298
|
+
raw_section not in rendered and len(exec_line) <= 200 + len("# 执行:"),
|
|
299
|
+
f"exec_len={len(exec_line)}")
|
|
300
|
+
|
|
301
|
+
# 生效条件必须与 frontmatter 同源:四槽合成,单槽不是生效条件。
|
|
302
|
+
# 改造前正文写「文档=X;检索…时」(第三种方言),frontmatter 只写单槽
|
|
303
|
+
# observation_position → condition_space_text(require_full=True) 恒为 ""。
|
|
304
|
+
cs = docindex.condition_space(s9)
|
|
305
|
+
check("condition_space 四槽齐备",
|
|
306
|
+
set(cs) == set(nodefile.CONDITION_SLOTS_REQUIRED), str(sorted(cs)))
|
|
307
|
+
synth = nodefile.condition_space_text(cs)
|
|
308
|
+
check("四槽合成出非空生效条件(单槽冒充已废止)", bool(synth), synth)
|
|
309
|
+
check("正文生效条件 = 四槽合成结果(正文与 frontmatter 同源)",
|
|
310
|
+
f"# 生效条件:{synth}" in rendered, synth)
|
|
311
|
+
check("时间槽用全时窗哨兵(不把索引时刻伪造成条件)",
|
|
312
|
+
nodefile.is_full_time_window(cs.get("time_window")),
|
|
313
|
+
str(cs.get("time_window")))
|
|
314
|
+
|
|
315
|
+
# ===================================================== ③ 索引 + 密级
|
|
316
|
+
print("\n【3】index_doc:落盘 / 密级 / 层(§1.3-3 裁定)")
|
|
317
|
+
mt_before = {}
|
|
318
|
+
for d, _s, fs in os.walk(fx):
|
|
319
|
+
for fn in fs:
|
|
320
|
+
mt_before[os.path.join(d, fn)] = os.path.getmtime(os.path.join(d, fn))
|
|
321
|
+
out = index_doc(cg, fx)
|
|
322
|
+
check("op=index_doc ok", out.get("ok"), str(out)[:120])
|
|
323
|
+
check("indexed == 4(guide 3 + secret 1)", out.get("indexed") == 4,
|
|
324
|
+
str(out.get("indexed")))
|
|
325
|
+
check("error_count == 0", out.get("error_count") == 0, str(out.get("errors")))
|
|
326
|
+
check("files 只计 .md(2)", out.get("files") == 2, str(out.get("files")))
|
|
327
|
+
check("skipped_suffixes 报出 .txt", ".txt" in out["skipped_suffixes"],
|
|
328
|
+
str(out["skipped_suffixes"]))
|
|
329
|
+
check("layer 默认 knowledge", out.get("layer") == "knowledge")
|
|
330
|
+
check("密级默认 internal、私有目录降 private",
|
|
331
|
+
out["sensitivity"].get("internal") == 3
|
|
332
|
+
and out["sensitivity"].get("private") == 1,
|
|
333
|
+
str(out["sensitivity"]))
|
|
334
|
+
|
|
335
|
+
g_id = docindex.node_id(s9)
|
|
336
|
+
g_fm = (cg.get(g_id) or {}).get("frontmatter") or {}
|
|
337
|
+
check("guide 节点密级 frontmatter 显式 internal",
|
|
338
|
+
g_fm.get("sensitivity") == "internal", str(g_fm.get("sensitivity")))
|
|
339
|
+
check("guide 节点 layer=knowledge", g_fm.get("layer") == "knowledge")
|
|
340
|
+
check("verification_basis=data(文档以原文为准)",
|
|
341
|
+
g_fm.get("verification_basis") == "data")
|
|
342
|
+
check("frontmatter.condition_space 四槽齐备(单槽冒充已废止)",
|
|
343
|
+
set(g_fm.get("condition_space") or {}) ==
|
|
344
|
+
set(nodefile.CONDITION_SLOTS_REQUIRED),
|
|
345
|
+
str(sorted(g_fm.get("condition_space") or {})))
|
|
346
|
+
check("frontmatter 条件空间与正文生效条件同源(同一纯函数)",
|
|
347
|
+
g_fm.get("condition_space") == docindex.condition_space(s9),
|
|
348
|
+
str(g_fm.get("condition_space")))
|
|
349
|
+
check("路由域由 domain: 标签显式承担(分桶结果与改造前逐字相同)",
|
|
350
|
+
routing.route_key(g_fm.get("condition_space"), g_fm.get("tags"))
|
|
351
|
+
== routing.normalize_domain("guide.md"),
|
|
352
|
+
str(routing.route_key(g_fm.get("condition_space"), g_fm.get("tags"))))
|
|
353
|
+
sec = docindex.extract(SECRET, "private/secret.md")[0]
|
|
354
|
+
s_fm = (cg.get(docindex.node_id(sec)) or {}).get("frontmatter") or {}
|
|
355
|
+
check("私有目录文档密级=private(保守降级)",
|
|
356
|
+
s_fm.get("sensitivity") == "private", str(s_fm.get("sensitivity")))
|
|
357
|
+
|
|
358
|
+
mt_after = {}
|
|
359
|
+
for d, _s, fs in os.walk(fx):
|
|
360
|
+
for fn in fs:
|
|
361
|
+
mt_after[os.path.join(d, fn)] = os.path.getmtime(os.path.join(d, fn))
|
|
362
|
+
check("只读契约:索引不触碰源文件", mt_before == mt_after)
|
|
363
|
+
|
|
364
|
+
# ===================================================== ④ doc_ref
|
|
365
|
+
print("\n【4】frontmatter.doc_ref(指回原文,不存全文)")
|
|
366
|
+
dr = g_fm.get("doc_ref") or {}
|
|
367
|
+
check("doc_ref 字段齐全",
|
|
368
|
+
all(k in dr for k in ("path", "heading", "heading_path", "level",
|
|
369
|
+
"lineno", "end", "anchor", "lang", "precise",
|
|
370
|
+
"hash", "root")), str(sorted(dr)))
|
|
371
|
+
check("doc_ref 指向相对路径与源行号",
|
|
372
|
+
dr.get("path") == "guide.md" and dr.get("lineno") == 10
|
|
373
|
+
and dr.get("end") == 21, str({k: dr.get(k) for k in ("path", "lineno", "end")}))
|
|
374
|
+
check("正文含 --- 未污染 frontmatter(doc_ref 可正常读回)",
|
|
375
|
+
dr.get("heading_path") == ["总览", "9. 分阶段实施"],
|
|
376
|
+
str(dr.get("heading_path")))
|
|
377
|
+
|
|
378
|
+
# ===================================================== ⑤ 检索资格
|
|
379
|
+
print("\n【5】检索资格(文档节点不得是 BLINDSPOT)")
|
|
380
|
+
cg.flush()
|
|
381
|
+
rd = call_tool(cg, "cg", {"op": "read", "query": "分阶段实施", "k": 10})
|
|
382
|
+
hits = [r for r in rd.get("results", []) if r["node"]["id"] == g_id]
|
|
383
|
+
check("文档节点可被检索到", bool(hits), f"hits={len(hits)}")
|
|
384
|
+
check("CCG 完整 → state=DEFER(v2:情境未确认条件不冒充接受,非 BLINDSPOT)",
|
|
385
|
+
bool(hits) and hits[0]["state"] == "DEFER",
|
|
386
|
+
str(hits[0]["state"] if hits else None))
|
|
387
|
+
|
|
388
|
+
# ===================================================== ⑥ op=ref
|
|
389
|
+
print("\n【6】op=ref 回读文档区间 + 漂移")
|
|
390
|
+
rr = call_tool(cg, "cg", {"op": "ref", "node_id": g_id})
|
|
391
|
+
check("ref 回读成功且识别为 doc_ref",
|
|
392
|
+
rr.get("ok") and rr.get("ref_kind") == "doc_ref",
|
|
393
|
+
str(rr.get("ref_kind")))
|
|
394
|
+
check("回读文本 = 源章节(含标题与表格行)",
|
|
395
|
+
"# 9. 分阶段实施" in (rr.get("text") or "")
|
|
396
|
+
and "| R1 | 索引 |" in (rr.get("text") or ""))
|
|
397
|
+
check("hash_match=True(索引侧与回读侧同算法)",
|
|
398
|
+
rr.get("hash_match") is True, str(rr.get("hash")))
|
|
399
|
+
with open(guide_path, "w", encoding="utf-8") as f:
|
|
400
|
+
f.write(GUIDE.replace("| R1 | 索引 |", "| R9 | 已改 |"))
|
|
401
|
+
rr2 = call_tool(cg, "cg", {"op": "ref", "node_id": g_id})
|
|
402
|
+
check("文档改动 → stale 可检出", rr2.get("hash_match") is False
|
|
403
|
+
and rr2.get("stale") is True, str(rr2.get("hash")))
|
|
404
|
+
index_doc(cg, fx)
|
|
405
|
+
rr3 = call_tool(cg, "cg", {"op": "ref", "node_id": g_id})
|
|
406
|
+
check("重跑 index_doc → 漂移消除", rr3.get("hash_match") is True)
|
|
407
|
+
with open(guide_path, "w", encoding="utf-8") as f:
|
|
408
|
+
f.write(GUIDE)
|
|
409
|
+
|
|
410
|
+
# ===================================================== ⑦ 覆盖/截断
|
|
411
|
+
print("\n【7】显式覆盖与截断上报")
|
|
412
|
+
ov = index_doc(cg, fx, sensitivity="public")
|
|
413
|
+
check("sensitivity 参数可覆盖默认",
|
|
414
|
+
ov["sensitivity"].get("public") == 4, str(ov["sensitivity"]))
|
|
415
|
+
g_fm2 = (cg.get(g_id) or {}).get("frontmatter") or {}
|
|
416
|
+
check("覆盖后 frontmatter 密级=public", g_fm2.get("sensitivity") == "public")
|
|
417
|
+
index_doc(cg, fx) # 复位默认密级
|
|
418
|
+
tr = index_doc(cg, fx, max_files=1)
|
|
419
|
+
check("触 max_files → truncated=True", tr.get("truncated") is True,
|
|
420
|
+
str(tr.get("truncated_reason")))
|
|
421
|
+
check("截断时 note 明确警告", "截断" in (tr.get("note") or ""),
|
|
422
|
+
(tr.get("note") or "")[:50])
|
|
423
|
+
index_doc(cg, fx)
|
|
424
|
+
|
|
425
|
+
# ===================================================== ⑧ 幂等
|
|
426
|
+
print("\n【8】幂等(重跑 ≡ 首跑)")
|
|
427
|
+
first = index_doc(cg, fx)
|
|
428
|
+
n1 = sum(1 for e in list(cg.index["nodes"].values()) if e["layer"] == "knowledge")
|
|
429
|
+
second = index_doc(cg, fx)
|
|
430
|
+
n2 = sum(1 for e in list(cg.index["nodes"].values()) if e["layer"] == "knowledge")
|
|
431
|
+
check("重跑节点数不变(按 id 原子覆盖,不清目录)", n1 == n2, f"{n1} vs {n2}")
|
|
432
|
+
check("重跑 id 集合稳定(幂等)",
|
|
433
|
+
set(first["ids"]) == set(second["ids"]), str(first["ids"]))
|
|
434
|
+
|
|
435
|
+
# ===================================================== ⑨ 真实 docs/
|
|
436
|
+
print("\n【9】真实 docs/:章节可定位、行号与源一致、可检索")
|
|
437
|
+
# docs/experiments/ 是 .gitignore 整目录忽略的实验产物(实测 2358 个 md,
|
|
438
|
+
# 属索引噪声而非文档事实源),会把 max_files=500 撑爆:显式 skip_dirs 排除。
|
|
439
|
+
# 用「排除 + 回报」而不是「调大上限」——排除结果落在 skipped_dirs 里,不静默。
|
|
440
|
+
SKIP_NOISE = ("experiments",)
|
|
441
|
+
|
|
442
|
+
def _count_md(base, skip_names):
|
|
443
|
+
n = 0
|
|
444
|
+
for d, dirs, fs in os.walk(base):
|
|
445
|
+
dirs[:] = [x for x in dirs if x not in skip_names]
|
|
446
|
+
n += sum(1 for fn in fs if fn.lower().endswith(".md"))
|
|
447
|
+
return n
|
|
448
|
+
|
|
449
|
+
# 测试不得依赖仓库外状态:docs/experiments/ 被 .gitignore 整目录忽略,
|
|
450
|
+
# 外部 clone 后物理不存在,而本段断言的正是「真实扫描中 skip_dirs 命中
|
|
451
|
+
# 要被回报」。不存在时自备最小探针目录(跑完即清);已存在时零动作
|
|
452
|
+
# (不碰本机历史产物)。探针为无标题正文——extract 返回空条目,不产生
|
|
453
|
+
# doc 节点;且探针在 experiments 内,_count_md 与被测扫描两侧口径一致,
|
|
454
|
+
# 对「全部 md 被索引」断言零影响。
|
|
455
|
+
probe_dir = os.path.join(DOCS, "experiments")
|
|
456
|
+
probe_created = not os.path.isdir(probe_dir)
|
|
457
|
+
if probe_created:
|
|
458
|
+
os.makedirs(probe_dir, exist_ok=True)
|
|
459
|
+
with open(os.path.join(probe_dir, "_probe_no_heading.md"),
|
|
460
|
+
"w", encoding="utf-8") as f:
|
|
461
|
+
f.write("探针正文:无标题不产节点,仅让 experiments 物理存在。\n")
|
|
462
|
+
try:
|
|
463
|
+
expect_files = _count_md(DOCS, SKIP_NOISE)
|
|
464
|
+
# 预算显式给足(默认预算会随真实 docs/ 增长而被跨过 → truncated=True;
|
|
465
|
+
# 「无静默跳过」判据本身不变,见 issue #43 收尾实测:HEAD 树加两份报告即复现)
|
|
466
|
+
real = index_doc(cg, DOCS, skip_dirs=list(SKIP_NOISE),
|
|
467
|
+
max_files=5000, max_items=20000)
|
|
468
|
+
finally:
|
|
469
|
+
if probe_created:
|
|
470
|
+
shutil.rmtree(probe_dir)
|
|
471
|
+
check("docs/ 全部 md 被索引(无静默跳过)",
|
|
472
|
+
real.get("error_count") == 0 and real.get("files") == expect_files
|
|
473
|
+
and real.get("truncated") is False,
|
|
474
|
+
f"files={real.get('files')}/{expect_files} errs={real.get('error_count')}")
|
|
475
|
+
check("skip_dirs 实际排掉的目录被回报(排除不静默)",
|
|
476
|
+
any("experiments" in p for p in (real.get("skipped_dirs") or [])),
|
|
477
|
+
str(real.get("skipped_dirs"))[:80])
|
|
478
|
+
r_items = docindex.extract(
|
|
479
|
+
open(os.path.join(DOCS, PLAN_DOC), encoding="utf-8").read(), PLAN_DOC)
|
|
480
|
+
s9r = next((i for i in r_items if i["heading"].startswith("9. ")), None)
|
|
481
|
+
real_lines = open(os.path.join(DOCS, PLAN_DOC), encoding="utf-8").read().split("\n")
|
|
482
|
+
hline = 1 + next(k for k, ln in enumerate(real_lines) if ln.startswith("## 9."))
|
|
483
|
+
check("§9 章节被切出(真实文档)", s9r is not None,
|
|
484
|
+
s9r["heading"] if s9r else "缺失")
|
|
485
|
+
check("行号与源文件一致(可定位)",
|
|
486
|
+
s9r is not None and s9r["lineno"] == hline,
|
|
487
|
+
f"{s9r['lineno'] if s9r else None} == {hline}")
|
|
488
|
+
r_id = docindex.node_id(s9r)
|
|
489
|
+
rd2 = call_tool(cg, "cg", {"op": "read", "query": "分阶段实施(稳健)", "k": 10})
|
|
490
|
+
h2 = [r for r in rd2.get("results", []) if r["node"]["id"] == r_id]
|
|
491
|
+
check("§9 表可被检索到且可判(state=DEFER,非 BLINDSPOT)",
|
|
492
|
+
bool(h2) and h2[0]["state"] == "DEFER",
|
|
493
|
+
str(h2[0]["state"] if h2 else None))
|
|
494
|
+
rr4 = call_tool(cg, "cg", {"op": "ref", "node_id": r_id})
|
|
495
|
+
check("回读到 §9 表原文(给出行号区间)",
|
|
496
|
+
rr4.get("ok") and "分阶段实施" in (rr4.get("text") or ""),
|
|
497
|
+
f"L{s9r['lineno']}-L{s9r['end']}" if s9r else "")
|
|
498
|
+
|
|
499
|
+
# ===================================================== ⑨b skip_dirs
|
|
500
|
+
print("\n【9b】skip_dirs:追加排除(只增不减)+ 结果可审计")
|
|
501
|
+
hit0, rules0 = codeindex.skip_matcher(None)
|
|
502
|
+
check("skip_dirs 缺省时判定器为空(默认行为与改造前逐字一致)",
|
|
503
|
+
hit0 is None and rules0 == [], f"{hit0} {rules0}")
|
|
504
|
+
sb = os.path.join(tmp, "skipdirs")
|
|
505
|
+
for rel in ("docs/keep/keep.md", "docs/experiments/probe/p.md",
|
|
506
|
+
"docs/experiments/x.md", "sub/experiments/y.md",
|
|
507
|
+
"node_modules/pkg/n.md"):
|
|
508
|
+
fp = os.path.join(sb, rel.replace("/", os.sep))
|
|
509
|
+
os.makedirs(os.path.dirname(fp), exist_ok=True)
|
|
510
|
+
with open(fp, "w", encoding="utf-8") as f:
|
|
511
|
+
f.write("# 标题\n\n" + LONG + "\n")
|
|
512
|
+
_i, _e, st_plain = docindex.index_dir(sb)
|
|
513
|
+
check("不给 skip_dirs:内置排除照旧(node_modules 不计入)",
|
|
514
|
+
st_plain["files"] == 4 and st_plain["skipped_dirs"] == [],
|
|
515
|
+
f"files={st_plain['files']} skip={st_plain['skipped_dirs']}")
|
|
516
|
+
_i, _e, st_name = docindex.index_dir(sb, skip_dirs=["experiments"])
|
|
517
|
+
check("不含 / 的规则按目录名匹配(各层级同名目录都排)"
|
|
518
|
+
" · 且内置排除不可被关闭(node_modules 仍被排)",
|
|
519
|
+
st_name["files"] == 1
|
|
520
|
+
and sorted(st_name["skipped_dirs"]) == ["docs/experiments",
|
|
521
|
+
"sub/experiments"],
|
|
522
|
+
f"files={st_name['files']} skip={sorted(st_name['skipped_dirs'])}")
|
|
523
|
+
_i, _e, st_path = docindex.index_dir(sb, skip_dirs=["docs/experiments"])
|
|
524
|
+
check("含 / 的规则按相对路径匹配(只排这一处)",
|
|
525
|
+
st_path["files"] == 2 and st_path["skipped_dirs"] == ["docs/experiments"],
|
|
526
|
+
f"files={st_path['files']} skip={st_path['skipped_dirs']}")
|
|
527
|
+
_i, _e, st_norm = docindex.index_dir(sb, skip_dirs=["docs\\experiments\\"])
|
|
528
|
+
check("规则先归一(反斜杠/首尾斜杠)再匹配,不静默失配",
|
|
529
|
+
st_norm["files"] == 2
|
|
530
|
+
and st_norm["skipped_dirs"] == ["docs/experiments"],
|
|
531
|
+
f"files={st_norm['files']} skip={st_norm['skipped_dirs']}")
|
|
532
|
+
|
|
533
|
+
# ===================================================== ⑩ 索引对账
|
|
534
|
+
# 缺口:node_id 含 heading_path,改标题 → 整篇 id 重算;add_items 只做
|
|
535
|
+
# 同 id 幂等 upsert,旧代节点无人清退 → 新旧并存、同一文档召回两份。
|
|
536
|
+
# 水位 reconcile 只剪水位条目、不剪节点,所以必须在索引后显式清。
|
|
537
|
+
print("\n【10】节点级对账:改标题 → 清退过期代(消除重复召回)")
|
|
538
|
+
rn = os.path.join(fx, "rename.md")
|
|
539
|
+
b1 = "# 标题甲\n\n" + LONG + "\n"
|
|
540
|
+
with open(rn, "w", encoding="utf-8") as f:
|
|
541
|
+
f.write(b1)
|
|
542
|
+
r1 = index_doc(cg, fx)
|
|
543
|
+
ids1 = {docindex.node_id(i) for i in docindex.extract(b1, "rename.md")}
|
|
544
|
+
check("首轮:节点在库", all(cg.get(n) for n in ids1), f"n={len(ids1)}")
|
|
545
|
+
check("首轮无孤儿(清退计数 0)",
|
|
546
|
+
(r1.get("pruned") or {}).get("count") == 0, str(r1.get("pruned")))
|
|
547
|
+
|
|
548
|
+
b2 = "# 标题乙(已改名)\n\n" + LONG + "\n"
|
|
549
|
+
with open(rn, "w", encoding="utf-8") as f:
|
|
550
|
+
f.write(b2)
|
|
551
|
+
r2 = index_doc(cg, fx)
|
|
552
|
+
ids2 = {docindex.node_id(i) for i in docindex.extract(b2, "rename.md")}
|
|
553
|
+
check("改标题后新代上台", all(cg.get(n) for n in ids2), f"n={len(ids2)}")
|
|
554
|
+
check("旧代被清退(新旧不并存)",
|
|
555
|
+
not any(cg.get(n) for n in ids1),
|
|
556
|
+
f"残留={sorted(n for n in ids1 if cg.get(n))}")
|
|
557
|
+
check("清退数量上报", (r2.get("pruned") or {}).get("count") == len(ids1 - ids2),
|
|
558
|
+
str(r2.get("pruned")))
|
|
559
|
+
|
|
560
|
+
b3 = "# 标题丙\n\n" + LONG + "\n"
|
|
561
|
+
with open(rn, "w", encoding="utf-8") as f:
|
|
562
|
+
f.write(b3)
|
|
563
|
+
r3 = index_doc(cg, fx, prune_dry_run=True)
|
|
564
|
+
check("prune_dry_run 只列不清(节点仍在库)",
|
|
565
|
+
(r3.get("pruned") or {}).get("dry_run") is True
|
|
566
|
+
and any(cg.get(n) for n in ids2), str(r3.get("pruned")))
|
|
567
|
+
index_doc(cg, fx)
|
|
568
|
+
check("随后实际清退 → 旧代消失", not any(cg.get(n) for n in ids2))
|
|
569
|
+
|
|
570
|
+
b4 = "# 标题丁\n\n" + LONG + "\n"
|
|
571
|
+
with open(rn, "w", encoding="utf-8") as f:
|
|
572
|
+
f.write(b4)
|
|
573
|
+
ids4 = {docindex.node_id(i) for i in docindex.extract(b4, "rename.md")}
|
|
574
|
+
r5 = index_doc(cg, fx, prune=False)
|
|
575
|
+
check("prune=false 可关闭(不清退)",
|
|
576
|
+
r5.get("pruned") is None and all(cg.get(n) for n in ids4),
|
|
577
|
+
str(r5.get("pruned")))
|
|
578
|
+
r6 = index_doc(cg, fx, max_files=1)
|
|
579
|
+
check("截断时不清退(没扫完 ≠ 剩下都过期)",
|
|
580
|
+
r6.get("pruned") is None, f"truncated={r6.get('truncated')}")
|
|
581
|
+
|
|
582
|
+
print("\n【10b】悬空清退:源文件删除 → op=ref action=prune 处置")
|
|
583
|
+
ck1 = call_tool(cg, "cg", {"op": "ref", "action": "check", "max_nodes": 5000})
|
|
584
|
+
pre = len(ck1.get("dangling") or [])
|
|
585
|
+
os.remove(rn)
|
|
586
|
+
ck2 = call_tool(cg, "cg", {"op": "ref", "action": "check", "max_nodes": 5000})
|
|
587
|
+
check("删源后 check 报悬空", len(ck2.get("dangling") or []) > pre,
|
|
588
|
+
f"{pre}→{len(ck2.get('dangling') or [])}")
|
|
589
|
+
dry = call_tool(cg, "cg", {"op": "ref", "action": "prune", "max_nodes": 5000, "dry_run": True})
|
|
590
|
+
check("prune_dry_run 列出待清退但不删",
|
|
591
|
+
dry.get("dry_run") is True and dry.get("count", 0) >= 1
|
|
592
|
+
and any(cg.get(n) for n in ids4), str(dry)[:130])
|
|
593
|
+
gone = call_tool(cg, "cg", {"op": "ref", "action": "prune", "max_nodes": 5000})
|
|
594
|
+
check("prune 清退悬空节点",
|
|
595
|
+
gone.get("count", 0) >= 1 and not any(cg.get(n) for n in ids4),
|
|
596
|
+
str(gone)[:130])
|
|
597
|
+
ck3 = call_tool(cg, "cg", {"op": "ref", "action": "check", "max_nodes": 5000})
|
|
598
|
+
check("清退后悬空归零", not (ck3.get("dangling") or []),
|
|
599
|
+
str(ck3.get("dangling"))[:130])
|
|
600
|
+
|
|
601
|
+
# 跨进程一致性:新实例重放 _index_log 后,已清退节点不得复活成幽灵条目
|
|
602
|
+
# (索引有条目、文件不存在)——只有把「删除」也写进增量日志才成立。
|
|
603
|
+
cg2 = MdCGOS(ROOT)
|
|
604
|
+
revived = sorted(n for n in ids4 if n in (cg2.index.get("nodes") or {}))
|
|
605
|
+
check("清退后重开不复活幽灵条目", not revived, f"复活={revived}")
|
|
606
|
+
|
|
607
|
+
# 存量幽灵(历史「删除只摘内存索引」遗留):索引有条目、节点文件不存在
|
|
608
|
+
# 也必须清得掉,否则 dangling 永远够不着零。
|
|
609
|
+
gid = "doc_ghost_probe0001"
|
|
610
|
+
cg.index["nodes"][gid] = {"path": "knowledge/ghost_probe.md",
|
|
611
|
+
"layer": "knowledge", "tags": ["doc"],
|
|
612
|
+
"bucket": None, "importance": 0.5}
|
|
613
|
+
g1 = call_tool(cg, "cg", {"op": "ref", "action": "prune", "max_nodes": 5000})
|
|
614
|
+
check("幽灵条目被清退(索引有、文件无)",
|
|
615
|
+
len(g1.get("ghost_pruned") or []) >= 1
|
|
616
|
+
and gid not in (cg.index.get("nodes") or {}), str(g1)[:130])
|
|
617
|
+
ck4 = call_tool(cg, "cg", {"op": "ref", "action": "check", "max_nodes": 5000})
|
|
618
|
+
check("清幽灵后悬空仍为零", not (ck4.get("dangling") or []),
|
|
619
|
+
str(ck4.get("dangling"))[:130])
|
|
620
|
+
|
|
621
|
+
# ============================================ ⑪ fence 往返列(binding)
|
|
622
|
+
# 缺口:往返列(取列 / 造键 / 校验 / 漂移 / 反查)是「条件卡 ↔ Markdown 真源」
|
|
623
|
+
# 的可校验面,此前零测试。列形状一旦漂移,对账器会把坏列当好消息(漏报);
|
|
624
|
+
# 键若悄悄带上行位,真源上方插一行就会让整库失配——故两者都要钉死。
|
|
625
|
+
print("\n【11】fence 往返列:形状 / 键不含行位 / 校验 / 漂移 / 反查")
|
|
626
|
+
li = docindex.extract(GUIDE, "guide.md")
|
|
627
|
+
s9b = next(i for i in li if i["heading"] == "9. 分阶段实施")
|
|
628
|
+
rendered = docindex.render(s9b)
|
|
629
|
+
gnode = cg.get(g_id) or {}
|
|
630
|
+
g_ref = (gnode.get("frontmatter") or {}).get("doc_ref") or {}
|
|
631
|
+
b0 = docindex.binding_of(gnode)
|
|
632
|
+
check("必需列齐全且无空值",
|
|
633
|
+
isinstance(b0, dict)
|
|
634
|
+
and all(b0.get(k) not in (None, "") for k in docindex.BINDING_FIELDS),
|
|
635
|
+
str(sorted(docindex.BINDING_FIELDS)))
|
|
636
|
+
check("列面 = 必需列 + 附加列(无第二份列口径)",
|
|
637
|
+
set(b0 or {}) == set(docindex.BINDING_FIELDS)
|
|
638
|
+
| set(docindex.BINDING_OPTIONAL),
|
|
639
|
+
str(sorted(set(b0 or {}) ^ (set(docindex.BINDING_FIELDS)
|
|
640
|
+
| set(docindex.BINDING_OPTIONAL)))))
|
|
641
|
+
check("必需列/附加列 ⊆ 写侧 doc_ref 列(读写同一列面)",
|
|
642
|
+
(set(docindex.BINDING_FIELDS) | set(docindex.BINDING_OPTIONAL))
|
|
643
|
+
<= set(g_ref),
|
|
644
|
+
str(sorted(set(docindex.BINDING_FIELDS) - set(g_ref))))
|
|
645
|
+
check("binding_of 与直接读 frontmatter 同源(同一投影)",
|
|
646
|
+
b0 == docindex.binding_of({"frontmatter": {"doc_ref": g_ref}}))
|
|
647
|
+
check("binding_of 对非索引节点返回 None(不猜、不补默认值)",
|
|
648
|
+
docindex.binding_of(None) is None
|
|
649
|
+
and docindex.binding_of([]) is None
|
|
650
|
+
and docindex.binding_of({}) is None
|
|
651
|
+
and docindex.binding_of({"frontmatter": {"tags": ["doc"]}}) is None)
|
|
652
|
+
check("validate_binding:本仓卡片列形状合法(ok + 零 issue)",
|
|
653
|
+
docindex.validate_binding(b0) == {"ok": True, "issues": []},
|
|
654
|
+
str(docindex.validate_binding(b0)))
|
|
655
|
+
check("validate_binding:非 dict 如实报错且不抛",
|
|
656
|
+
docindex.validate_binding(None)
|
|
657
|
+
== {"ok": False, "issues": ["绑定不是字典(该节点无 doc_ref)"]})
|
|
658
|
+
lo0 = b0["lineno"]
|
|
659
|
+
bad_detail = []
|
|
660
|
+
for _nm, _b, _want in (
|
|
661
|
+
("缺列", {k: v for k, v in b0.items() if k != "anchor"},
|
|
662
|
+
"缺列 anchor"),
|
|
663
|
+
("类型错 root", {**b0, "root": 123},
|
|
664
|
+
"root 应为字符串,实为 int"),
|
|
665
|
+
("类型错 lineno", {**b0, "lineno": "十"}, "行位不是整数"),
|
|
666
|
+
("行位越界", {**b0, "lineno": 0}, "lineno 越界(0 < 1)"),
|
|
667
|
+
("区间倒置", {**b0, "end": lo0 - 1},
|
|
668
|
+
f"end 早于 lineno({lo0}-{lo0 - 1})")):
|
|
669
|
+
_v = docindex.validate_binding(_b)
|
|
670
|
+
if _v["ok"] or _want not in _v["issues"]:
|
|
671
|
+
bad_detail.append(f"{_nm}→{_v['issues']}")
|
|
672
|
+
check("validate_binding 逐类坏列均被点出(缺列/类型错/越界/区间倒置)",
|
|
673
|
+
not bad_detail, "; ".join(bad_detail)[:170])
|
|
674
|
+
b_shift = docindex.binding_of({"frontmatter": {"doc_ref": {
|
|
675
|
+
**g_ref, "lineno": lo0 + 40, "end": g_ref["end"] + 40}}})
|
|
676
|
+
check("键不含行位:行位位移不改键(重排后仍是同一章节)",
|
|
677
|
+
docindex.binding_key(b0) == docindex.binding_key(b_shift)
|
|
678
|
+
== "guide.md#总览/9. 分阶段实施",
|
|
679
|
+
docindex.binding_key(b0))
|
|
680
|
+
check("漂移按固定列序报出变化项(lineno → end → hash)",
|
|
681
|
+
docindex.binding_drift(b0, b_shift) == ["lineno", "end"]
|
|
682
|
+
and docindex.binding_drift(b0, {**b0, "hash": "zz"}) == ["hash"]
|
|
683
|
+
and docindex.binding_drift(
|
|
684
|
+
b0, {**b0, "hash": "zz", "lineno": lo0 + 1})
|
|
685
|
+
== ["lineno", "hash"],
|
|
686
|
+
str(docindex.binding_drift(b0, b_shift)))
|
|
687
|
+
check("同列零漂移(无变化不报 / 空值不炸)",
|
|
688
|
+
docindex.binding_drift(b0, dict(b0)) == []
|
|
689
|
+
and docindex.binding_drift(None, None) == [])
|
|
690
|
+
check("binding_key 缺 heading_path 回落 path#anchor · 非 dict 返空串",
|
|
691
|
+
docindex.binding_key({"path": "a.md", "anchor": "s1"}) == "a.md#s1"
|
|
692
|
+
and docindex.binding_key({"path": "a.md"}) == "a.md#"
|
|
693
|
+
and docindex.binding_key(None) == "")
|
|
694
|
+
check("binding_slug 与 render 正文「本条目属于」逐字同源",
|
|
695
|
+
docindex.binding_slug(b0) == "guide.md#9-分阶段实施"
|
|
696
|
+
and f"本条目属于 {docindex.binding_slug(b0)}" in rendered,
|
|
697
|
+
docindex.binding_slug(b0))
|
|
698
|
+
check("反查取最内层(父节区间内的子节优先,不回落父节)",
|
|
699
|
+
docindex.locate(li, 12)["heading"] == "9. 分阶段实施"
|
|
700
|
+
and docindex.locate(li, 30)["heading"] == "代码示例",
|
|
701
|
+
str((docindex.locate(li, 12) or {}).get("heading")))
|
|
702
|
+
check("反查区间闭合(标题行与末行都算本节)",
|
|
703
|
+
docindex.locate(li, s9b["lineno"])["heading"] == "9. 分阶段实施"
|
|
704
|
+
and docindex.locate(li, s9b["end"])["heading"] == "9. 分阶段实施")
|
|
705
|
+
check("反查越界/非整数/空表 → None(fail-closed 不猜)",
|
|
706
|
+
docindex.locate(li, 10 ** 6) is None
|
|
707
|
+
and docindex.locate(li, 0) is None
|
|
708
|
+
and docindex.locate(li, "x") is None
|
|
709
|
+
and docindex.locate(li, None) is None
|
|
710
|
+
and docindex.locate([], 10) is None)
|
|
711
|
+
|
|
712
|
+
# ================================ ⑫ 逐字节回放回归(往返列无损)
|
|
713
|
+
# ⑪ 只证「列可校验」;本段把口径推到内容无损:卡片必须是真源条目的派生物
|
|
714
|
+
# (render 补一个换行 == 卡片正文)。root 限定为本次真正索引过的两个真源,
|
|
715
|
+
# 断言只落在本轮写入的卡上——历史残留不参与,避免把脏数据当回归。
|
|
716
|
+
print("\n【12】逐字节回放回归:render(条目) + 换行 == 卡片正文")
|
|
717
|
+
cg.flush()
|
|
718
|
+
rp = _replay_cards(cg, roots={_norm(fx), _norm(DOCS)})
|
|
719
|
+
print(f" 取样 {rp['sampled']} 卡:一致 {rp['ok']} · 键未命中 "
|
|
720
|
+
f"{rp['dangling']} · 源已移出 {rp['gone']} · 读不了 "
|
|
721
|
+
f"{rp['unreadable']}")
|
|
722
|
+
check("回放取样命中卡片(root 限定=本次索引的两个真源)",
|
|
723
|
+
rp["sampled"] > 0, str(rp["sampled"]))
|
|
724
|
+
check("可读卡 100% 逐字节回放一致(写侧 render 与读侧同源)",
|
|
725
|
+
not rp["mismatch"],
|
|
726
|
+
f"一致 {rp['ok']}/{rp['sampled']};" + ";".join(rp["mismatch"][:2]))
|
|
727
|
+
check("零键未命中 / 零源已移出 / 零读不了(源在库则必可重定位并读回)",
|
|
728
|
+
rp["dangling"] == 0 and rp["gone"] == 0
|
|
729
|
+
and rp["unreadable"] == 0,
|
|
730
|
+
f"键未命中={rp['dangling']} 源已移出={rp['gone']} "
|
|
731
|
+
f"读不了={rp['unreadable']}")
|
|
732
|
+
check("回放账目闭合(一致 + 键未命中 + 源已移出 + 读不了 = 取样数)",
|
|
733
|
+
(rp["ok"] + rp["dangling"] + rp["gone"] + rp["unreadable"])
|
|
734
|
+
== rp["sampled"],
|
|
735
|
+
f"{rp['ok']}+{rp['dangling']}+{rp['gone']}+{rp['unreadable']}"
|
|
736
|
+
f" vs {rp['sampled']}")
|
|
737
|
+
|
|
738
|
+
# 历史抽样:真实认知图库(仓外数据面,历史卡最多)。
|
|
739
|
+
# ⚠ 必须**显式 opt-in**(2026-09-24 修复):DSH 把 MDCG_ROOT 导出到每个
|
|
740
|
+
# shell,而本段以新身份打开外部库——MdCGSecure 首次打开该身份即
|
|
741
|
+
# provision DEK(写 _keys.json / _crypto.jsonl,见 mdcos._init_crypto),
|
|
742
|
+
# 于是「跑一次测试」= 动生产库;且受限文件沙箱下该写会阻塞(实测本机
|
|
743
|
+
# 900s 超时、日志零字节)。故:MDCG_TEST_LIVE_ROOT=1 才跑。
|
|
744
|
+
# 语义澄清:这里只保证**查询语义只读**,不是「不写盘」。
|
|
745
|
+
_live_opt = os.environ.get("MDCG_TEST_LIVE_ROOT") == "1"
|
|
746
|
+
ext_root = os.environ.get("MDCG_ROOT") or ""
|
|
747
|
+
if not (_live_opt and ext_root and os.path.isdir(ext_root)):
|
|
748
|
+
print("\n【12b】历史抽样:跳过(需 MDCG_TEST_LIVE_ROOT=1 且 MDCG_ROOT "
|
|
749
|
+
"指向真实库)—— 本仓语料回放见【12】")
|
|
750
|
+
else:
|
|
751
|
+
print(f"\n【12b】历史抽样:外部认知图库 {ext_root}"
|
|
752
|
+
"(只读查询;首开新身份会 provision 本身份 DEK)")
|
|
753
|
+
ext = MdCGSecure(ext_root, principal=Principal(
|
|
754
|
+
actor="p27-replay", clearance="secret", can_write=False,
|
|
755
|
+
can_admin=False, role="designer", auth_mode="local-cli"))
|
|
756
|
+
try:
|
|
757
|
+
hp = _replay_cards(ext, sample=120)
|
|
758
|
+
finally:
|
|
759
|
+
ext.close()
|
|
760
|
+
print(f" 抽样 {hp['sampled']} 卡:一致 {hp['ok']} · 键未命中 "
|
|
761
|
+
f"{hp['dangling']} · 源已移出 {hp['gone']} · 读不了 "
|
|
762
|
+
f"{hp['unreadable']}")
|
|
763
|
+
check("【12b】历史库抽样命中卡片(数据面可达)",
|
|
764
|
+
hp["sampled"] > 0, str(hp["sampled"]))
|
|
765
|
+
check("【12b】可读历史卡零回放不符(未被渲染漂移/人工改写腐化)",
|
|
766
|
+
not hp["mismatch"],
|
|
767
|
+
f"一致 {hp['ok']}/{hp['sampled']};"
|
|
768
|
+
+ ";".join(hp["mismatch"][:2]))
|
|
769
|
+
check("【12b】未读回的全部是「源已移出」(非 IO/抽取故障)",
|
|
770
|
+
hp["unreadable"] == 0,
|
|
771
|
+
f"源已移出={hp['gone']} 读不了={hp['unreadable']}")
|
|
772
|
+
check("【12b】抽样账目闭合(无静默丢弃)",
|
|
773
|
+
(hp["ok"] + hp["dangling"] + hp["gone"] + hp["unreadable"])
|
|
774
|
+
== hp["sampled"],
|
|
775
|
+
f"{hp['ok']}+{hp['dangling']}+{hp['gone']}+{hp['unreadable']}"
|
|
776
|
+
f" vs {hp['sampled']}")
|
|
777
|
+
|
|
778
|
+
finally:
|
|
779
|
+
shutil.rmtree(tmp, ignore_errors=True)
|
|
780
|
+
|
|
781
|
+
print("\n" + "=" * 68)
|
|
782
|
+
print(f"通过 {PASS} / 失败 {FAIL}")
|
|
783
|
+
if FAILS:
|
|
784
|
+
print("失败项:\n - " + "\n - ".join(FAILS))
|
|
785
|
+
print("=" * 68)
|
|
786
|
+
return 1 if FAIL else 0
|
|
787
|
+
|
|
788
|
+
|
|
789
|
+
if __name__ == "__main__":
|
|
790
|
+
if hasattr(sys.stdout, "reconfigure"):
|
|
791
|
+
sys.stdout.reconfigure(encoding="utf-8", errors="replace")
|
|
792
|
+
sys.exit(main())
|