[hdknr]

Fixes #376
Fixes #341
Fixes #369

cruise #474 の周（不在の周。/dev-loop:cruise 474 --absent）。

変更

• 雛形のフック spec_loop_pages.py:
  • 素の本文の URL の中の Q&A の番号を書き換えない（spec-loop: Q&A の番号のリンク化が、素の本文に書いた URL の中の番号まで書き換えて URL を壊す（#324 の残り） #341）。URL は <英字のスキーム>:// か www. で始まり、空白・<・>・引用符・描いた HTML の実体参照・全角の句読点とかぎ括弧で終える。全角の丸括弧は対で数える
  • 印 decision_table（spec-loop: 雛形のフックに決定表（decision_table.csv）を描く印が無く、CSV への直リンクが開けない #369）: 各版の shared/decision_table.csv を見出しの行どおりに版ごとの節に描く（長い行は切らずに見出しを埋める・最初の行が空なら警告）
• 雛形に docs/decision-table.md（表示用のページ）
• references/tree.md: 写すもの・decision_table の印・要求・仕様から CSV へ直接リンクしない決まり・0.28.0 の取り込み（spec-loop: Q&A 表に層（共有・内部）と推奨を足し、読む側と写し済みのフックを 1 回で移す（#330・#267・#337 のまとめ） #339 の手順 4 に乗せる）
• spec-loop 0.26.0 → 0.28.0（build-proposal.py: 前の出力を消せないときは traceback・1 でなく 2 で止まり、残ったものを名指しする（#440） #477 が 0.26.1・check-signoff.py: 照合の範囲を 2 つの承認が見た中身（shared/・requirements/・spec/・removed.csv）に広げる（#375） #479 が 0.27.0 に上げるので重ならない値）

仕様の穴（不在の線で推奨により決めた）

汎用の CSV の印（<!-- spec-loop: csv … -->）は足さない——確認の Issue: #480。

確かめたこと

• scripts/test-init-mkdocs.py: OK: 試料 52 件・変異 111 件
• 実際の MkDocs（main の作業ツリーの .venv。mkdocs 1.6.1）で雛形を描いて HTML を見た——URL の中の番号は不変・地の文の番号はリンク・決定表は全部の列
• scripts/check-all.py: 52/52

関門

直す線: 既定。採否の表は docs/plans/issue-376.md。

パス	Verifier（sonnet）	/code-review（high）
1 パス目	反証 2 件	指摘 8 件
2 パス目	反証 0 件	指摘 10 件
狭いパス	指摘 3 件（下）	—

残課題（直していない指摘）

• CR6: 決定表の読み方が read_qa・build-proposal.py の写しで、突き合わせが無い
• CR7: mailto:Q-001@ex.com のように // の無いスキームの中の番号を書き換える
• CR8: qa.csv を定数にしていない
• P3: Markdown の強調が URL を割る（https://ex.com/__init__/Q-001）と、後ろの区間の番号がリンクになる（実際の Python-Markdown で再現）
• P8: path.is_file() が try の外（3.12 は権限の誤りで例外、3.14 は黙って飛ばす。qa.csv も同じ形）
• P9: URL の正規表現に左の錨が無く、長い英字の並びで 2 乗の時間
• P10: 読めない・見出しの無い決定表は ## v<n> の見出しを出さない

人間に判断をお願いするもの（狭いパスの指摘）

1. 入れ子の全角の丸括弧（https://ex.com/a（b）c）Q-001）の試料が無く、depth -= 1 を外す変異が生き残る見込み
2. 全角の ［］｛｝＜＞ で URL を終えない（https://ex.com/a］Q-001 の番号がリンクにならない）
3. 実体参照 "・' で URL を終えない（Python-Markdown は出さない）
4. 「対の無い全角の ） で URL を終える」は、URL の中に対の無い ） がある形（https://ex.com/a）b/Q-001）で I1 と緊張する

未証明

CI では MkDocs に当てていない（CI に MkDocs と Material の組が無い）。手元では当てた。

マージ

不在の cruise はここで止まる（#476）。#477・#479 と同じく spec-loop の版を上げている——先にマージした側に合わせて、後の側は main を取り込んで版を上げ直す。

🤖 Generated with Claude Code