Read a directory of architecture decision records, check their metadata and their supersession graph, and derive a searchable local index.
This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+.
Run the checked-in example
npm run example # clean set, exits 0, writes an index
node bin/decision-record-indexer.mjs --root examples/decisions-broken # exits 1Read the result
examples/decisions-broken contains a supersession cycle, a reference to a record that does not exist, a status outside the vocabulary, an unknown front matter key, an impossible date, a record with no owners and a file with no front matter at all.
Scope
A run that indexed no record is reported incomplete and exits 2. pass with nothing checked is green on no evidence, and this tool does not do that.