2 Commits
Author SHA1 Message Date
james 2a3226976d chore(gitignore): ignore regenerated archify browser-evidence artifacts
`archify visual-check` rewrites its screenshots and contact sheet on every run,
so keep those bytes out of the tree and commit the *.visual-check.json receipt
that holds the measurements.
2026-09-12 23:07:04 +08:00
james 37ccb33ba0 docs(archify): add CodeGraph architecture and query-handling diagrams
Two self-contained interactive diagrams under docs/archify/, each with its
source spec and browser-evidence receipt.

- codegraph-architecture: the extraction -> resolution -> query -> context
  pipeline, the local-first engine boundary, and the MCP / CLI / viewer
  consumption surfaces. 16 cited source references verified at the indexed
  revision.
- codegraph-explore-nl-query: how codegraph_explore turns a natural-language
  query into symbols (parseQuery, flowTokens), resolves them to nodes with
  exact-only matching and overload disambiguation, finds the call path among
  them, and assembles a budgeted answer.

Validation: both pass showcase validation with 9/9 artifact checks and no
composition errors or warnings, and visual-check reports no viewport overflow
at 1440x900, 1600x1000, 1920x1080, and 2048x1320.
2026-09-12 23:05:42 +08:00