feat(docs): Path Map wiki pipeline — flowchart + generator + drift-guard (#276 Phase 2)#280
Merged
Merged
Conversation
Phase 2 of the #276 two-phase plan (Phase 1 = PR #279, merged). The user ruling: 'path 應該要做好，做成一個流程圖放在 wiki，不然我也會搞不清楚' — a daily-reference navigation map for the maintainer, not onboarding prose. docs/workflows.md gains a '## Path Flowchart (wiki source)' section: a mermaid flowchart whose spine faithfully mirrors the existing Path Selection Decision Tree (meeting gate -> complexity -> attended -> multi-shape) and whose legend subgraphs carry every off-spine family — all 36 catalog paths appear. New scripts/generate-path-map.py renders docs/wiki/Path-Map.md deterministically (mermaid lifted verbatim + per-category tables from the '#### P-' headings; no timestamps, so the guard can byte-diff). New drift-guard path-map-sync locks three invariants: freshness (generator --check), coverage (every P- name in the mermaid AND the page — a new path that skips the map goes red), discovery (README links the wiki page). README pipeline diagram gains the pointer line whose fix Phase 1 deliberately deferred until this page existed. Wiki sync copies docs/wiki/Path-Map.md verbatim. Sweep 42 suites 0 fail. Refs #276
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refs #276 — Phase 2 of two（merge 後本 issue 可走 close ritual）
Path Map：流程圖 + generator + drift-guard
Decision 的交付形狀（「path 定案 → 流程圖 → wiki，maintainer 日常查詢用」）落地：
docs/workflows.md新## Path Flowchart（wiki source）：mermaid 主幹忠實鏡像既有 Path Selection Decision Tree（meeting 分流 → complexity → attended → multi 形狀），legend 群組收齊不在主幹上的 family — 36 條 catalog path 全數出現scripts/generate-path-map.py：確定性渲染docs/wiki/Path-Map.md（mermaid 逐字 lift +#### P-目錄轉分類表；無 timestamp，可 byte-diff）；--check模式給 guard 用path-map-sync（3 不變量）：freshness（generator --check）、coverage（每個 P- 名必在 mermaid 與頁面 — 新 path 漏畫圖直接紅）、discovery（README 連結）— [IDD][design] Enforce strict separation: idd-issue → idd-diagnose → idd-all / idd-all-chain (no auto-swallow diagnose) #122/fix: README gpt-5.5 pin + docs catalog drift (v2.97-2.99 backfill) — expand drift-guards to README/docs #267 同 class 的第三次機制化Path-Map頁隨本 PR 同步上線（內容 =docs/wiki/Path-Map.md逐字；review 若改內容會重推）Verification
path-map-sync 9/9；全 sweep 42 suites 0 fail。issue 結案不由本 PR 觸發 — merge 後走 close ritual。