Documentation
Context Map — scoped edits
Use a local dependency map to locate code, scope an edit, and review its impact. A stale or failed map is not a verification receipt.
Commands
hephaestus context refresh --project .
hephaestus context locate "entity kind routing" --project .
hephaestus context slice --project . --task "fix entity kind routing" --target src/package-kind.ts
hephaestus context impact --project . --changed src/package-kind.ts
hephaestus context verify --project . --changed src/package-kind.ts --reviewed src/register/route.tsRead the result of each stage
- refresh builds the local map; locate and refs find definitions and references.
- slice selects the dependencies relevant to a task; impact shows what needs review before changing a file.
- verify accounts for changed, reviewed, verified, or explicitly waived files. Code review and a passing runtime test are different evidence.
The map stays project-local; private source and paths must not be sent in public agent discovery. If map refresh fails, inspect the reported cause and perform explicit file/dependency review. Record that limitation instead of calling the map gate passed.