# sebastian-abraham/syscode architecture

> Architecture diagram of the GitHub repository sebastian-abraham/syscode, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sebastian-abraham/syscode
- Repository: https://github.com/sebastian-abraham/syscode

## Overview

SysCode builds and maintains a grounded, persistent design map of a developer’s project, then presents it as an explorable canvas and uses it to answer questions or propose map changes. The primary flow is project scan → code facts → map/reconciliation → local persistence → HTTP API → interface; chat adds scoped context and optional model-backed responses. The README documents additional capabilities whose internal wiring is not shown in the excerpts. Edges are limited to those supported by excerpts, the SOURCE INDEX, or explicit README statements.

Main entry points: [`packages/core/src/map/service.ts`](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/map/service.ts) (Map service), [`packages/core/src/analyze/index.ts`](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/analyze/index.ts) (Fact assembly), [`apps/web/src/store.tsx`](https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/web/src/store.tsx) (Web state and API), [`packages/core/src/server/http.ts`](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/server/http.ts) (Local HTTP API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Code analysis"]
  node_scan["Repository scan<br/>[scan.ts]"]
  node_tsparse["TS/JS analysis<br/>[tsjs.ts]"]
  node_pyparse["Python analysis<br/>[py.ts]"]
  node_external["External services<br/>[external.ts]"]
  node_analyzer["Fact assembly<br/>[index.ts]"]
end

subgraph group_mapping["Map and memory"]
  node_mapper["Heuristic mapper<br/>[heuristic.ts]"]
  node_identity["Identity and reconcile<br/>[identity.ts]"]
  node_mapservice["Map service<br/>[service.ts]"]
  node_context["Scoped context<br/>[context.ts]"]
  node_database[("Project map store<br/>[db.ts]")]
end

subgraph group_engine["Agent and API"]
  node_agent["Agent<br/>[agent.ts]"]
  node_provider["Model provider<br/>[provider.ts]"]
  node_http["Local HTTP API<br/>[http.ts]"]
end

subgraph group_interface["Developer interface"]
  node_webstate["Web state and API<br/>[store.tsx]"]
  node_canvas["Map canvas<br/>[Canvas.tsx]"]
  node_inspector["Inspector and context<br/>[Inspector.tsx]"]
  node_chat["Chat and proposals<br/>[ChatPanel.tsx]"]
  node_icons["Interface icons<br/>[icons.tsx]"]
end

subgraph group_desktop["Desktop shell"]
  node_desktopapp["Desktop shell<br/>[main.rs]"]
end

node_developer(("Developer"))
node_project["Project source"]
node_model{{"LLM service"}}

node_developer -->|"maps project"| node_project
node_project -->|"scans files"| node_scan
node_scan -->|"returns scanned files"| node_analyzer
node_analyzer -->|"parses TS/JS"| node_tsparse
node_analyzer -->|"parses Python"| node_pyparse
node_analyzer -->|"classifies imports"| node_external
node_analyzer -->|"supplies facts"| node_mapservice
node_mapservice -->|"builds map"| node_mapper
node_mapservice -->|"reconciles identity"| node_identity
node_mapservice -->|"reads and writes"| node_database
node_mapservice -->|"builds context"| node_context
node_context -->|"reads map data"| node_database
node_context -->|"reads anchored code"| node_project
node_http -->|"routes map operations"| node_mapservice
node_http -->|"routes chat"| node_agent
node_http -->|"probes model"| node_provider
node_agent -->|"uses scoped context"| node_context
node_agent -->|"requests model response"| node_provider
node_provider -.->|"calls configured model"| node_model
node_developer -->|"uses interface"| node_webstate
node_webstate -->|"calls engine API"| node_http
node_webstate -->|"supplies map state"| node_canvas
node_webstate -->|"supplies selection"| node_inspector
node_webstate -->|"streams chat"| node_chat
node_canvas -->|"renders icons"| node_icons
node_inspector -->|"shows agent context"| node_context
node_chat -->|"sends questions"| node_agent
node_developer -->|"launches desktop"| node_desktopapp
node_desktopapp -->|"connects to engine"| node_http

click node_scan "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/analyze/scan.ts"
click node_tsparse "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/analyze/tsjs.ts"
click node_pyparse "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/analyze/py.ts"
click node_external "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/analyze/external.ts"
click node_analyzer "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/analyze/index.ts"
click node_mapper "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/map/heuristic.ts"
click node_identity "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/map/identity.ts"
click node_mapservice "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/map/service.ts"
click node_context "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/memory/context.ts"
click node_database "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/store/db.ts"
click node_agent "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/llm/agent.ts"
click node_provider "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/llm/provider.ts"
click node_http "https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/server/http.ts"
click node_webstate "https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/web/src/store.tsx"
click node_canvas "https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/web/src/components/Canvas.tsx"
click node_inspector "https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/web/src/components/Inspector.tsx"
click node_chat "https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/web/src/components/ChatPanel.tsx"
click node_icons "https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/web/src/components/icons.tsx"
click node_desktopapp "https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/desktop/src-tauri/src/main.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_scan,node_tsparse,node_pyparse,node_external,node_analyzer toneBlue
class node_mapper,node_identity,node_mapservice,node_context,node_database toneAmber
class node_agent,node_provider,node_http toneMint
class node_webstate,node_canvas,node_inspector,node_chat,node_icons toneRose
class node_desktopapp,node_developer,node_project,node_model toneIndigo
```

## Components

### Code analysis

- [Repository scan](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/analyze/scan.ts): `packages/core/src/analyze/scan.ts`
- [TS/JS analysis](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/analyze/tsjs.ts): `packages/core/src/analyze/tsjs.ts`
- [Python analysis](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/analyze/py.ts): `packages/core/src/analyze/py.ts`
- [External services](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/analyze/external.ts): `packages/core/src/analyze/external.ts`
- [Fact assembly](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/analyze/index.ts): `packages/core/src/analyze/index.ts`

### Map and memory

- [Heuristic mapper](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/map/heuristic.ts): `packages/core/src/map/heuristic.ts`
- [Identity and reconcile](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/map/identity.ts): `packages/core/src/map/identity.ts`
- [Map service](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/map/service.ts): `packages/core/src/map/service.ts`
- [Scoped context](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/memory/context.ts): `packages/core/src/memory/context.ts`
- [Project map store](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/store/db.ts): `packages/core/src/store/db.ts`

### Agent and API

- [Agent](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/llm/agent.ts): `packages/core/src/llm/agent.ts`
- [Model provider](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/llm/provider.ts): `packages/core/src/llm/provider.ts`
- [Local HTTP API](https://github.com/sebastian-abraham/syscode/blob/seb/dev/packages/core/src/server/http.ts): `packages/core/src/server/http.ts`

### Developer interface

- [Web state and API](https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/web/src/store.tsx): `apps/web/src/store.tsx`
- [Map canvas](https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/web/src/components/Canvas.tsx): `apps/web/src/components/Canvas.tsx`
- [Inspector and context](https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/web/src/components/Inspector.tsx): `apps/web/src/components/Inspector.tsx`
- [Chat and proposals](https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/web/src/components/ChatPanel.tsx): `apps/web/src/components/ChatPanel.tsx`
- [Interface icons](https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/web/src/components/icons.tsx): `apps/web/src/components/icons.tsx`

### Desktop shell

- [Desktop shell](https://github.com/sebastian-abraham/syscode/blob/seb/dev/apps/desktop/src-tauri/src/main.rs): `apps/desktop/src-tauri/src/main.rs`

### Other components

- **Developer**
- **Project source**
- **LLM service**

## Connections

- Developer → Project source: maps project (evidence: `README.md`)
- Project source → Repository scan: scans files
- Repository scan → Fact assembly: returns scanned files (evidence: `packages/core/src/analyze/index.ts`)
- Fact assembly → TS/JS analysis: parses TS/JS (evidence: `packages/core/src/analyze/index.ts`)
- Fact assembly → Python analysis: parses Python (evidence: `packages/core/src/analyze/index.ts`)
- Fact assembly → External services: classifies imports (evidence: `packages/core/src/analyze/index.ts`)
- Fact assembly → Map service: supplies facts (evidence: `packages/core/src/map/service.ts`)
- Map service → Heuristic mapper: builds map (evidence: `packages/core/src/map/service.ts`)
- Map service → Identity and reconcile: reconciles identity (evidence: `packages/core/src/map/service.ts`)
- Map service → Project map store: reads and writes (evidence: `packages/core/src/map/service.ts`)
- Map service → Scoped context: builds context (evidence: `packages/core/src/map/service.ts`)
- Scoped context → Project map store: reads map data (evidence: `packages/core/src/memory/context.ts`)
- Scoped context → Project source: reads anchored code (evidence: `packages/core/src/memory/context.ts`)
- Local HTTP API → Map service: routes map operations (evidence: `packages/core/src/server/http.ts`)
- Local HTTP API → Agent: routes chat (evidence: `packages/core/src/server/http.ts`)
- Local HTTP API → Model provider: probes model (evidence: `packages/core/src/server/http.ts`)
- Agent → Scoped context: uses scoped context (evidence: `packages/core/src/llm/agent.ts`)
- Agent → Model provider: requests model response (evidence: `packages/core/src/llm/agent.ts`)
- Model provider → LLM service: calls configured model
- Developer → Web state and API: uses interface (evidence: `README.md`)
- Web state and API → Local HTTP API: calls engine API (evidence: `README.md`)
- Web state and API → Map canvas: supplies map state (evidence: `apps/web/src/components/Canvas.tsx`)
- Web state and API → Inspector and context: supplies selection (evidence: `apps/web/src/App.tsx`)
- Web state and API → Chat and proposals: streams chat (evidence: `apps/web/src/store.tsx`)
- Map canvas → Interface icons: renders icons (evidence: `apps/web/src/components/Canvas.tsx`)
- Inspector and context → Scoped context: shows agent context (evidence: `README.md`)
- Chat and proposals → Agent: sends questions (evidence: `README.md`)
- Developer → Desktop shell: launches desktop (evidence: `README.md`)
- Desktop shell → Local HTTP API: connects to engine (evidence: `README.md`)
