[shrenixcodes]

Summary

First version of VECTORA (0.1.0): a local engine that imports and indexes repositories into a persistent knowledge graph, and a web application that explores that graph in a 2D graph, a 3D atlas and a mind map with one shared selection.

The repository was empty before this branch, so this is the whole application.

What is in it

• Monorepo (npm workspaces): apps/local-engine, apps/web, and packages graph-schema, language-adapters, repository-indexer, graph-engine, graph-layout, search, shared.
• Indexing pipeline: discovery with ignore rules, syntax analysis, relationship resolution, execution flows, subsystem and concept organisation, validation. TypeScript/JavaScript use the TypeScript type checker; Python uses ast; Java, Go, Rust, C, C++ and C# use Tree-sitter.
• Knowledge graph: 18 node types, 15 relationship types, each with evidence, extraction method and confidence. References that cannot be tied to a definition are reported as unresolved, never drawn.
• Engine: Fastify on loopback, imports from GitHub, ZIP and local folders, SQLite persistence, incremental re-indexing, exports, sessions, settings, encrypted credentials.
• Web application: landing, import, workspace with Overview, Mind Map, Graph Explorer, 3D Atlas, Dependency Explorer, Search (including questions answered with file and line citations), Documentation and Settings; inspector with original source; command palette; light and dark themes.
• Sample repository in samples/sample-repo, labelled as a sample, used by tests and onboarding.
• Documentation in docs/, plus PROJECT_STATUS.md, IMPLEMENTATION_CHECKLIST.md, DECISIONS.md and KNOWN_ISSUES.md.

Verification

Run on Windows 11, Node.js 24.14.1, Microsoft Edge.

Check	Result
npm run typecheck	no errors
npm run lint	no errors
npm test	79 passed, 0 failed
Coverage (packages, engine, web logic)	83.6% lines, 65.5% branches
npm run build then npm run test:e2e	18 passed, 0 failed (desktop, tablet, mobile widths)
npm audit --omit=dev	0 vulnerabilities

Benchmarks (synthetic repositories, this machine): 1,000 files in 5.6 s, 5,000 in 22.3 s, 10,000 in 31.3 s at 995 MB peak. Details in docs/PERFORMANCE.md.

What a reviewer should know

• Not verified: a real import from github.com (tests use a local stand-in for the API); the optional external narrative service against a real endpoint; rendering frame rates and memory over long sessions; macOS, Linux and browsers other than Edge.
• Not built: desktop packaging. docs/ROADMAP.md holds the Tauri 2 plan only.
• Known weak spot: changing one TypeScript file costs almost as much as a full index, because the compiler program is rebuilt.
• Deviations from the suggested stack, each explained in DECISIONS.md: TypeScript pinned to 5.9 and Sigma to 3.x (the newest majors changed the APIs relied on); SQLite through the engine built into Node.js instead of an ORM; components written on Radix primitives rather than generated shadcn/ui components; GitHub repositories are downloaded as archives so git is never run.
• Vendored binaries: six Tree-sitter grammar WASM files (about 11 MB, MIT) in packages/language-adapters/grammars, so installation runs no native build.
• Licence review: one transitive dependency, webgl-constants, declares no licence in its metadata (docs/LICENSES.md).
• Credential key is stored beside the database; see docs/SECURITY.md for what that does and does not protect against.
• The full list of 35 limitations is in KNOWN_ISSUES.md.

How to try it

npm install
npm run build
npm start

Open http://localhost:4317, choose "Explore a repository", then "Index the sample repository".

🤖 Generated with Claude Code