PJR-ZWMH 登録簿の索引生成で山括弧プレースホルダをインラインコード化し、frontmatter でも検知する
1. 概要
個票 frontmatter の conclusion などに dct-<domain>.yaml のような山括弧プレースホルダをインラインコードにせず書くと、register build がそのまま表セルへ展開し、generated/pjr-index.md で HTML タグとして解釈されて VitePress ビルドが失敗する。remark の山括弧検査は本文の html ノードだけを対象とし、markdownlint も frontmatter を見ず、生成物は gitignore で lint:md の対象外のため、ビルドまで誰も検知できない。生成側でインラインコード化して塞ぎ、あわせて frontmatter 側でも検知できるようにする。
2. 完了条件
register buildが索引の表セルへ展開する全項目（title、description、conclusionなど）で、素の山括弧プレースホルダがインラインコードへ変換される。- 変換範囲は Markdown 記述ルールに合わせ、山括弧の前後で英字・数字・ハイフン・アンダースコアが連結している場合はその範囲全体を 1 つのインラインコードで囲む。
- 既にインラインコードで囲まれている箇所は二重に囲まない。コードスパン内の山括弧は変換しない。
<br>のような実在する HTML タグ名も、索引の表セルでは同様に無害化される（セル内改行は記述ルールで禁止のため、HTML として通す必要がない）。- 生成された
generated/pjr-index.mdと派生ビューに、コードスパン外の素の山括弧が現れない。 - 個票 frontmatter に素の山括弧プレースホルダを書いた場合、
register-item-frontmatter.schema.yamlの検証または同等の検査で検知され、ビルドを待たずに気付ける。 parsePjrIndexによる表の読み戻しが、インラインコード化した値に対しても破綻しない。読み戻し値の扱い（コードスパンを剥がすか、そのまま扱うか）が実装として定まっている。- 上記を検証する unit test が追加され、
npm run test:unit、npm run lint:md、npm run validate:schemaが成功する。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | 表セルへ展開する値の一覧と、変換対象の判定規則を決める | ARC | done | 全 12 セルを対象とし、コードスパン外の連結範囲全体を囲む |
| 2 | register build の行生成へインラインコード化を実装する | ARC | done | formatTableRow で全セルへ共通変換を適用 |
| 3 | parsePjrIndex の読み戻しへの影響を確認し、扱いを決める | ARC | done | コードスパンを表示値の一部として保持し、再生成時の二重化を防ぐ |
| 4 | frontmatter 側の検知を追加する | ARC | done | 既存 remark 検査を YAML frontmatter の文字列値へ拡張 |
| 5 | unit test を追加する | ARC | done | 変換、二重化防止、コードスパン内不変、読み戻し、frontmatter 検知を追加 |
| 6 | 記述ルールとの整合を確認し、必要ならガイドへ追記する | ARC | done | 既存の山括弧規約と一致するためガイド変更は不要 |
4. 対応結果
- 登録簿の行生成で、
title、description、conclusionを含む全セルのコードスパン外にある山括弧をインラインコード化した。 - 生成処理と lint に同一の変換規則を適用し、frontmatter の文字列値に素の山括弧がある場合は既存 remark 検査で報告するようにした。表セルでは HTML を許容しないため、
<br>などの実在タグも frontmatter では検知する。 parsePjrIndexはコードスパンを剥がさず表示値として保持する。このため、旧一覧の読み取り後に再生成してもコードスパンは二重化されない。- unit test で全表セルへの適用、連結範囲、既存コードスパン、実在 HTML タグ、frontmatter 検知、読み戻しを確認した。残課題はない。
5. 関連ドキュメント
- 事象が確認された個票: PJR-WVNS 計画成果物をカタログへ載せ、専用の planning ドメインとトラックで所有する
- 表記規約:
.github/instructions/markdown.instructions.mdの山括弧プレースホルダの節 - 本文側の既存検査:
tools/docs/src/remark-no-unescaped-angle-placeholder.ts - 変更対象の実装:
src/register.tsの索引行生成とparsePjrIndex - 検証スキーマ:
docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml