Development guide

Install dependencies and run the local build loop:

npm install
npm run dev

npm run dev starts the esbuild watcher for plugin development.

Dogfood vault

Use ~/MyTestVault unless you need another vault.

npm run install:local -- ~/MyTestVault
npm run dev:vault -- ~/MyTestVault

dev:vault installs the real plugin files under:

~/MyTestVault/.obsidian/plugins/agentic-chat/

It also creates .hotreload and writes esbuild output directly to that plugin directory.

For the full dogfood loop:

npm run dogfood -- ~/MyTestVault

Use --once --no-open --no-tail for a non-interactive build and install check.

Docs loop

npm run docs:dev
npm run docs:build
npm run docs:preview

Architecture

Use Architecture for the single owner of each mutable state, its invariants, and the current ownership gaps. The file is the design input for the structural ownership PRs.

Verification

Use Verification for the lane reference, evidence rules, the fake-green list, and probe workflows. The merge gate is:

npm run verify -- fast

For the witness tool, the CI witness gate, the independent verifier, and the merge protocol, use Trust the change. For the on-demand mutation matrix, use Mutation testing.

Live dogfood

Exploratory WebDriver and manual bug sweeps against a real vault use docs/development/live-dogfood.md. The file stays in the repo but out of the public site because it is a maintainer runbook, not user documentation.