# aaa1234fdja/isa architecture

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

- Interactive diagram: https://gitdiagram.com/aaa1234fdja/isa
- Repository: https://github.com/aaa1234fdja/isa

## Overview

ISA combines a browser-based local chat/workspace interface with an early Rust CLI, plus a response harness and read-only skill/extension catalogs. The user-facing path is browser chat or local project/conversation management; separate CLI commands provide bounded repository inspection, edits, sessions, and Ollama chat. The graph preserves documented capabilities, but browser implementation details and several CLI dispatch paths were not sampled, so those links rely on README statements or are omitted.

Main entry points: [`src/cli/mod.rs`](https://github.com/aaa1234fdja/isa/blob/main/src/cli/mod.rs) (CLI Commands), [`Harness Isa/mod.rs`](https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/mod.rs) (Harness Orchestration), [`index.html`](https://github.com/aaa1234fdja/isa/blob/main/index.html) (Browser Interface), [`Harness Isa/retrieval.rs`](https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/retrieval.rs) (Workspace Retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser Application"]
  node_webui["Browser Interface<br/>[index.html]"]
  node_webstate[("Local Chat State<br/>[index.html]")]
end

subgraph group_server["Rust Server"]
  node_server_entry["Preview Server<br/>[main.rs]"]
  node_http["HTTP Handling<br/>[http.rs]"]
  node_extsearch["Extension Search<br/>[plugins.rs]"]
end

subgraph group_cli["CLI Workspace Tools"]
  node_cli_entry["CLI Commands<br/>[mod.rs]"]
  node_repo["Repository Access<br/>[repository.rs]"]
  node_context["Lexical Context<br/>[context.rs]"]
  node_semantic["Semantic Search<br/>[semantic.rs]"]
  node_edit["Approved Edits<br/>[edit.rs]"]
  node_sessions[("CLI Sessions<br/>[session.rs]")]
  node_agent["Agent Loop<br/>[agent_loop.rs]"]
  node_connectors["GitHub Connector<br/>[connectors.rs]"]
  node_processes["Process Tools<br/>[processes.rs]"]
  node_registry[("Goal Contracts<br/>[registry.rs]")]
  node_work["Work Records<br/>[work.rs]"]
  node_summary["Session Search<br/>[summary.rs]"]
end

subgraph group_harness["Chat Harness"]
  node_harness_entry["Harness Orchestration<br/>[mod.rs]"]
  node_retrieval["Workspace Retrieval<br/>[retrieval.rs]"]
  node_planning["Prompt Planning<br/>[plan.rs]"]
  node_planner["Task Planner<br/>[planner.rs]"]
  node_evaluation["Response Evaluation<br/>[evaluation.rs]"]
end

subgraph group_catalog["Skills and Extensions"]
  node_skills["Skill References<br/>[mod.rs]"]
  node_plugins["Plugin Catalog<br/>[plugins.rs]"]
end

node_user(("User"))
node_ollama{{"Ollama Service"}}
node_openvsx{{"Open VSX Registry"}}

node_user -->|"uses"| node_webui
node_webui -->|"persists chats"| node_webstate
node_webui -->|"requests preview"| node_server_entry
node_server_entry -->|"handles requests"| node_http
node_webui -->|"searches extensions"| node_extsearch
node_extsearch -->|"queries registry"| node_openvsx
node_user -->|"runs commands"| node_cli_entry
node_cli_entry -->|"dispatches edits"| node_edit
node_cli_entry -->|"dispatches records"| node_registry
node_context -->|"lists files"| node_repo
node_semantic -->|"searches files"| node_repo
node_agent -->|"retrieves context"| node_context
node_agent -->|"uses sessions"| node_sessions
node_summary -->|"searches sessions"| node_sessions
node_work -->|"reads repository"| node_repo
node_agent -->|"sends chat"| node_ollama
node_user -->|"requests response"| node_harness_entry
node_harness_entry -->|"plans task"| node_planner
node_harness_entry -->|"prepares context"| node_retrieval
node_retrieval -->|"packs lexical context"| node_context
node_retrieval -->|"searches semantic context"| node_semantic
node_retrieval -->|"validates messages"| node_planning
node_harness_entry -->|"evaluates suite"| node_evaluation
node_harness_entry -->|"requests completion"| node_ollama
node_cli_entry -->|"dispatches connector"| node_connectors
node_cli_entry -.->|"dispatches process tools"| node_processes
node_cli_entry -.->|"dispatches work tools"| node_work
node_cli_entry -.->|"dispatches search"| node_summary
node_harness_entry -->|"prepares skills"| node_skills
node_user -->|"views catalog"| node_plugins

click node_webui "https://github.com/aaa1234fdja/isa/blob/main/index.html"
click node_webstate "https://github.com/aaa1234fdja/isa/blob/main/index.html"
click node_server_entry "https://github.com/aaa1234fdja/isa/blob/main/src/main.rs"
click node_http "https://github.com/aaa1234fdja/isa/blob/main/src/http.rs"
click node_extsearch "https://github.com/aaa1234fdja/isa/blob/main/src/plugins.rs"
click node_cli_entry "https://github.com/aaa1234fdja/isa/blob/main/src/cli/mod.rs"
click node_repo "https://github.com/aaa1234fdja/isa/blob/main/src/cli/repository.rs"
click node_context "https://github.com/aaa1234fdja/isa/blob/main/src/cli/context.rs"
click node_semantic "https://github.com/aaa1234fdja/isa/blob/main/src/cli/semantic.rs"
click node_edit "https://github.com/aaa1234fdja/isa/blob/main/src/cli/edit.rs"
click node_sessions "https://github.com/aaa1234fdja/isa/blob/main/src/cli/session.rs"
click node_agent "https://github.com/aaa1234fdja/isa/blob/main/src/cli/agent_loop.rs"
click node_connectors "https://github.com/aaa1234fdja/isa/blob/main/src/cli/connectors.rs"
click node_processes "https://github.com/aaa1234fdja/isa/blob/main/src/cli/processes.rs"
click node_registry "https://github.com/aaa1234fdja/isa/blob/main/src/cli/registry.rs"
click node_work "https://github.com/aaa1234fdja/isa/blob/main/src/cli/work.rs"
click node_summary "https://github.com/aaa1234fdja/isa/blob/main/src/cli/summary.rs"
click node_harness_entry "https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/mod.rs"
click node_retrieval "https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/retrieval.rs"
click node_planning "https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/plan.rs"
click node_planner "https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/planner.rs"
click node_evaluation "https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/evaluation.rs"
click node_skills "https://github.com/aaa1234fdja/isa/blob/main/Skills/mod.rs"
click node_plugins "https://github.com/aaa1234fdja/isa/blob/main/src/plugins.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_webui,node_webstate,node_user toneBlue
class node_server_entry,node_http,node_extsearch toneAmber
class node_cli_entry,node_repo,node_context,node_semantic,node_edit,node_sessions,node_agent,node_connectors,node_processes,node_registry,node_work,node_summary toneMint
class node_harness_entry,node_retrieval,node_planning,node_planner,node_evaluation toneRose
class node_skills,node_plugins,node_ollama,node_openvsx toneIndigo
```

## Components

### Browser Application

- [Browser Interface](https://github.com/aaa1234fdja/isa/blob/main/index.html): `index.html`
- [Local Chat State](https://github.com/aaa1234fdja/isa/blob/main/index.html): `index.html`

### Rust Server

- [Preview Server](https://github.com/aaa1234fdja/isa/blob/main/src/main.rs): `src/main.rs`
- [HTTP Handling](https://github.com/aaa1234fdja/isa/blob/main/src/http.rs): `src/http.rs`
- [Extension Search](https://github.com/aaa1234fdja/isa/blob/main/src/plugins.rs): `src/plugins.rs`

### CLI Workspace Tools

- [CLI Commands](https://github.com/aaa1234fdja/isa/blob/main/src/cli/mod.rs): `src/cli/mod.rs`
- [Repository Access](https://github.com/aaa1234fdja/isa/blob/main/src/cli/repository.rs): `src/cli/repository.rs`
- [Lexical Context](https://github.com/aaa1234fdja/isa/blob/main/src/cli/context.rs): `src/cli/context.rs`
- [Semantic Search](https://github.com/aaa1234fdja/isa/blob/main/src/cli/semantic.rs): `src/cli/semantic.rs`
- [Approved Edits](https://github.com/aaa1234fdja/isa/blob/main/src/cli/edit.rs): `src/cli/edit.rs`
- [CLI Sessions](https://github.com/aaa1234fdja/isa/blob/main/src/cli/session.rs): `src/cli/session.rs`
- [Agent Loop](https://github.com/aaa1234fdja/isa/blob/main/src/cli/agent_loop.rs): `src/cli/agent_loop.rs`
- [GitHub Connector](https://github.com/aaa1234fdja/isa/blob/main/src/cli/connectors.rs): `src/cli/connectors.rs`
- [Process Tools](https://github.com/aaa1234fdja/isa/blob/main/src/cli/processes.rs): `src/cli/processes.rs`
- [Goal Contracts](https://github.com/aaa1234fdja/isa/blob/main/src/cli/registry.rs): `src/cli/registry.rs`
- [Work Records](https://github.com/aaa1234fdja/isa/blob/main/src/cli/work.rs): `src/cli/work.rs`
- [Session Search](https://github.com/aaa1234fdja/isa/blob/main/src/cli/summary.rs): `src/cli/summary.rs`

### Chat Harness

- [Harness Orchestration](https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/mod.rs): `Harness Isa/mod.rs`
- [Workspace Retrieval](https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/retrieval.rs): `Harness Isa/retrieval.rs`
- [Prompt Planning](https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/plan.rs): `Harness Isa/plan.rs`
- [Task Planner](https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/planner.rs): `Harness Isa/planner.rs`
- [Response Evaluation](https://github.com/aaa1234fdja/isa/blob/main/Harness%20Isa/evaluation.rs): `Harness Isa/evaluation.rs`

### Skills and Extensions

- [Skill References](https://github.com/aaa1234fdja/isa/blob/main/Skills/mod.rs): `Skills/mod.rs`
- [Plugin Catalog](https://github.com/aaa1234fdja/isa/blob/main/src/plugins.rs): `src/plugins.rs`

### Other components

- **User**
- **Ollama Service**
- **Open VSX Registry**

## Connections

- User → Browser Interface: uses (evidence: `README.md`)
- Browser Interface → Local Chat State: persists chats (evidence: `README.md`)
- Browser Interface → Preview Server: requests preview (evidence: `README.md`)
- Preview Server → HTTP Handling: handles requests (evidence: `src/main.rs`)
- Browser Interface → Extension Search: searches extensions (evidence: `README.md`)
- Extension Search → Open VSX Registry: queries registry (evidence: `README.md`)
- User → CLI Commands: runs commands (evidence: `README.md`)
- CLI Commands → Approved Edits: dispatches edits (evidence: `src/cli/mod.rs`)
- CLI Commands → Goal Contracts: dispatches records (evidence: `src/cli/mod.rs`)
- Lexical Context → Repository Access: lists files (evidence: `src/cli/context.rs`)
- Semantic Search → Repository Access: searches files (evidence: `src/cli/semantic.rs`)
- Agent Loop → Lexical Context: retrieves context (evidence: `src/cli/agent_loop.rs`)
- Agent Loop → CLI Sessions: uses sessions (evidence: `src/cli/agent_loop.rs`)
- Session Search → CLI Sessions: searches sessions (evidence: `src/cli/summary.rs`)
- Work Records → Repository Access: reads repository (evidence: `src/cli/work.rs`)
- Agent Loop → Ollama Service: sends chat (evidence: `README.md`)
- User → Harness Orchestration: requests response (evidence: `Harness Isa/mod.rs`)
- Harness Orchestration → Task Planner: plans task (evidence: `Harness Isa/mod.rs`)
- Harness Orchestration → Workspace Retrieval: prepares context (evidence: `Harness Isa/mod.rs`)
- Workspace Retrieval → Lexical Context: packs lexical context (evidence: `Harness Isa/retrieval.rs`)
- Workspace Retrieval → Semantic Search: searches semantic context (evidence: `Harness Isa/retrieval.rs`)
- Workspace Retrieval → Prompt Planning: validates messages (evidence: `Harness Isa/retrieval.rs`)
- Harness Orchestration → Response Evaluation: evaluates suite (evidence: `Harness Isa/mod.rs`)
- Harness Orchestration → Ollama Service: requests completion (evidence: `Harness Isa/mod.rs`)
- CLI Commands → GitHub Connector: dispatches connector (evidence: `src/cli/mod.rs`)
- CLI Commands → Process Tools: dispatches process tools (evidence: `src/cli/mod.rs`)
- CLI Commands → Work Records: dispatches work tools (evidence: `src/cli/mod.rs`)
- CLI Commands → Session Search: dispatches search (evidence: `src/cli/mod.rs`)
- Harness Orchestration → Skill References: prepares skills (evidence: `Harness Isa/mod.rs`)
- User → Plugin Catalog: views catalog (evidence: `README.md`)
