CLI reference

failure-memory [--json-errors] <command> ...

Successful commands print JSON. Classified failures print a stable error code; --json-errors emits the error as JSON.

Project lifecycle

--config is optional on every command. When omitted it defaults to <repo>/.failure-memory/config.toml, the file init writes, so after init most commands need only --repo. An explicit --config is read as given.

init

failure-memory init [--repo .] [--config .failure-memory/config.toml] \
  [--repository-id <id>] [--node-namespace <namespace>] [--force]

doctor

failure-memory doctor [--config <path>] [--repo .]

migrate-check

failure-memory migrate-check [--config <path>] [--repo .]

Reports legacy-layout conditions without moving canonical data.

generate-wrapper

failure-memory generate-wrapper [--config <path>] --output <path> \
  [--repo .] [--force]

Registry and compiler

add

Choose exactly one source:

failure-memory add --interactive [--config <path>] --global-vault <path> [--repo .]
failure-memory add --from-json lesson.json [--config <path>] \
  --global-vault <path> [--repo .]

validate

failure-memory validate [--config <path>] [--repo .]

compile

failure-memory compile [--config <path>] --global-vault <path> \
  [--repo .] [--output-root <path>]

check

failure-memory check [--config <path>] --global-vault <path> \
  [--repo .] [--output-root <path>]

ci-check

failure-memory ci-check [--config <path>] [--repo .]

Refresh

failure-memory refresh <action> \
  [--config <path>] \
  --global-vault <path> \
  [--repo .] \
  [--phase 1] \
  [--generated-at <timezone-aware-ISO8601>] \
  [--force-lock]

Actions: preflight, status, lessons, mirror, graph, all, clean.

clean removes only paths marked disposable by project configuration.

Provider

resolve

failure-memory resolve [--config <path>] --request request.json [--repo .]

validate-fingerprint

failure-memory validate-fingerprint [--config <path>] \
  --request request.json --result result.json [--repo .]