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+; inspect the source before using it on your own files.
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.
Where this check stops
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.
Before adapting the command to your own workflow, review the accepted inputs, exit codes and safety boundaries in the README.
Compiled with AI assistance from checked-in public documentation and example scripts. Run the example and review the repository's current documentation before relying on its result.