madr/supersedes-bidirectional

frontmatter の supersedes フィールドと superseded-by フィールドが、ADR コレクション全体で互いに一貫して指し合っていることを検証する、ファイル横断のプロジェクトルールです。

ADR-A が ADR-B を supersede する場合、A の frontmatter は supersedes: ADR-B を宣言し、B の frontmatter は superseded-by: ADR-A を宣言すべきです。このルールは各ファイルの frontmatter を直接読み取り（マージされたメタデータブリッジは使いません）、ベース名（^(\d{4})-）で ADR-NNNN → file のインデックスを構築し、両方向をチェックします。NNNN- プレフィックスのないファイルはアドレス指定できないためスキップされます。

両フィールドは単一の文字列または文字列の配列（多対一の supersession）を受け付けます。文字列でも配列でもない値（number, null, boolean）は暗黙的に無視されます — 型チェックはこのルールの関心事ではありません。

チェック内容

unknownReference — supersedes または superseded-by の値が、対応するファイルが存在しない ADR-NNNN を参照しています。メッセージ: Frontmatter `<direction>: <ref>` references an ADR that does not exist。data.ref と data.direction を含みます。宙に浮いた参照を含むファイルに対して発行されます。
missingBackReference — ファイル A がファイル B への前方参照を宣言しているが、B が相互の参照を宣言していません。メッセージ: <source> declares `<direction>: <ref>`, but <ref> (this file) does not back-reference it via <expected>。逆参照が欠落しているファイルに対して発行され、そのファイルを指し示した source ファイルと、追加すべき expected の参照を示します。

例

有効

# 0001-old.md
---
status: superseded by ADR-0042
superseded-by: ADR-0042
---

# 0042-new.md
---
status: accepted
supersedes: ADR-0001
---

無効 — 逆参照の欠落

# 0001-old.md
---
# (no superseded-by here)
---

# 0042-new.md
---
supersedes: ADR-0001
---

0001-old.md に対して data.expected: 'ADR-0042' を伴う missingBackReference を発行します。

無効 — 未知の参照

# 0042-x.md
---
supersedes: ADR-9999   # no 9999-*.md exists
---

0042-x.md に対して data.ref: 'ADR-9999' を伴う unknownReference を発行します。

オプション

このルールにはオプションがありません。

import { defineConfig } from 'madr-lint';

export default defineConfig({
  rules: {
    'madr/supersedes-bidirectional': 'error',
  },
});

MADR バージョン互換性

バージョン	適用	備考
v2	いいえ	`- Supersedes: ADR-NNNN` は本文コンテンツであり、frontmatter ではない
v3	はい	frontmatter の `supersedes` / `superseded-by`
v4	はい	同上

このルールは frontmatter のみを読み取るため、MADR v2 の本文リストメタデータには適用されません。

無効化する場合

supersession を ADR frontmatter の外部で追跡しているリポジトリでは無効化してください — 例: Git タグ、外部レジストリ、または明示的な supersedes / superseded-by フィールドなしで status: superseded by ... の行のみを使う場合です。

他のルールと同様、インラインコメントで抑制できます — ルールの抑制を参照してください。