forge:store-custodian

The Store Custodian is the sole authorized gateway for the probabilistic layer (LLM-driven workflows and commands) to read and modify the JSON store at .forge/store/. All store mutations must go through store-cli.cjs.

Hard rule: never fall back to writing store files directly. If the CLI fails, read the error, fix the data, and retry. If it persists after retries, report the error to the user and stop.

FORGE_ROOT Resolution

Before invoking any store-cli command, resolve the plugin root path:

FORGE_ROOT=$(node -e "console.log(require('./.forge/config.json').paths.forgeRoot)")