Skip to content

feat: add repository knowledge atlas#1446

Open
lsjfy-open-com wants to merge 1 commit into
colbymchenry:mainfrom
lsjfy-open-com:feature/repository-knowledge-atlas
Open

feat: add repository knowledge atlas#1446
lsjfy-open-com wants to merge 1 commit into
colbymchenry:mainfrom
lsjfy-open-com:feature/repository-knowledge-atlas

Conversation

@lsjfy-open-com

Copy link
Copy Markdown

Summary

This adds a repository-local knowledge layer and a bundled, read-only topology atlas on top of CodeGraph's existing graph:

  • index Markdown headings as section nodes without changing or replacing any existing code extraction
  • resolve local Markdown links and conservative inline-code symbol mentions into exact persisted references edges
  • expose bounded, exact induced graph snapshots and exact node neighborhoods
  • add codegraph ui [path] with bundled offline assets, loopback-only defaults, semantic/directory/language grouping, progressive labels, node/edge filters, visual-only group aggregation, and a precise inspector

Why

Repository knowledge is split between source and local documents. Agents and humans need to move from architecture/runbooks to concrete symbols while retaining the original CodeGraph identity and relationship truth. Existing node IDs, qualified names, edge endpoints, edge kinds, and code extraction paths remain unchanged; document nodes are appended and UI aggregation is presentation-only.

Related work

User impact

cd your-project
codegraph init
codegraph ui --limit 1200
# open http://127.0.0.1:7474

No CDN, external document fetch, or runtime network dependency is introduced. External URLs stay as source text and are not crawled.

Validation

  • npm run build
  • 606/606 existing extraction tests
  • 618/618 extraction + Markdown + wire-contract + topology tests
  • 98/100 security, watcher, and CLI tests (2 existing platform skips)
  • WSL Rust kernel: 15/15 tests
  • real-browser validation on Graphify: 10,717 nodes / 25,441 edges; grouping, filtering, zoom labels, search, direct selection, and exact inspector relationships; 0 console errors/warnings and localhost-only requests

Design notes are included under docs/design/repository-documents-v1.md and docs/design/repository-topology-ui-v1.md.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant