@intrect/openswarm 0.2.2 → 0.4.0

package/README.md

@@ -1,134 +1,100 @@
 # OpenSwarm
 
-> Autonomous AI agent orchestrator powered by Claude Code CLI
+[![npm version](https://img.shields.io/npm/v/@intrect/openswarm.svg)](https://www.npmjs.com/package/@intrect/openswarm)
+[![npm downloads](https://img.shields.io/npm/dm/@intrect/openswarm.svg)](https://www.npmjs.com/package/@intrect/openswarm)
+[![license](https://img.shields.io/npm/l/@intrect/openswarm.svg)](LICENSE)
 
-OpenSwarm orchestrates multiple Claude Code instances as autonomous agents. It picks up Linear issues, runs Worker/Reviewer pair pipelines to produce code changes, reports progress to Discord, and retains long-term memory via LanceDB vector embeddings.
+> Autonomous AI agent orchestrator — Claude, GPT, Codex, and local models (Ollama/LMStudio/llama.cpp)
 
-## 📸 Demo
+OpenSwarm orchestrates multiple AI agents as autonomous code workers. It picks up Linear issues, runs Worker/Reviewer pair pipelines, reports to Discord, and retains long-term memory via LanceDB. Supports Claude Code, OpenAI GPT, Codex, and **local open-source models** via Ollama, LMStudio, or llama.cpp.
 
-### Web Dashboard (Port 3847)
-
-![OpenSwarm Dashboard](screenshots/dashboard-main.png)
-
-Real-time supervisor dashboard with repository status, pipeline events, live logs, PR processor, and agent chat.
-
-### CLI Chat Interface
-
-**Rich TUI Mode** (Claude Code inspired):
+## Quick Start
 
 ```bash
-$ openswarm chat --tui
+npm install -g @intrect/openswarm
+openswarm
 ```
 
-![TUI Chat Interface](screenshots/tui.png)
+That's it. `openswarm` with no arguments launches the TUI chat interface immediately.
 
-- Dark theme with Claude Code inspired color palette
-- 5 interactive tabs: Chat, Projects, Tasks, Stuck, Logs
-- Real-time streaming responses with themed loading messages
-- Keyboard shortcuts: Tab (switch tabs), Enter (send), Shift+Enter (newline), Esc (exit input)
-- Session management: auto-save, resume, model switching
-- Status bar: model, message count, cumulative cost
+![TUI Chat Interface](screenshots/tui.png)
 
-**Simple Mode** (readline based):
+### TUI keyboard shortcuts
 
-```bash
-$ openswarm chat [session-name]
+| Key | Action |
+|-----|--------|
+| `Tab` | Switch tabs (Chat / Projects / Tasks / Stuck / Logs) |
+| `Enter` | Send message |
+| `Shift+Enter` | Newline |
+| `i` | Focus input |
+| `Esc` | Exit input focus |
+| `Ctrl+C` | Quit |
 
-╔════════════════════════════════════╗
-║  Swarm Chat  sonnet-4-5           ║
-╚════════════════════════════════════╝
-demo | /help | Ctrl+D exit
+Status bar shows: provider · model · message count · cumulative cost
 
-you What are the main components of OpenSwarm?
-assistant OpenSwarm has 9 main architectural layers... ($0.0023)
+---
 
-you /model haiku
-Model: claude-haiku-4-5-20251001
+## CLI Commands
 
-you /save openswarm-overview
-Saved: openswarm-overview
+```bash
+openswarm                        # TUI chat (default)
+openswarm chat [session]         # Simple readline chat
+openswarm start                  # Start full daemon (requires config.yaml)
+openswarm run "Fix the bug" -p ~/my-project   # Run a single task
+openswarm exec "Run tests" --local --pipeline # Execute via daemon
+openswarm init                   # Generate config.yaml scaffold
+openswarm validate               # Validate config.yaml
+
+# Code Registry & BS Detector
+openswarm check --scan           # Scan repo → register all entities
+openswarm check src/foo.ts       # File brief (entities, tests, risk)
+openswarm check --bs             # BS pattern scan (bad code smells)
+openswarm check --stats          # Registry statistics
+openswarm check --high-risk      # High-risk entities
+openswarm check --search "name"  # Full-text search
+openswarm annotate "funcName" --deprecate "reason"
+openswarm annotate "funcName" --tag "needs-refactor"
+openswarm annotate "funcName" --warn "error/security: SQL injection"
 ```
 
-**Commands**: `/clear`, `/model <name>`, `/save [name]`, `/help`
+### `openswarm exec` options
 
-## Architecture
+| Option | Description |
+|--------|-------------|
+| `--path <path>` | Project path (default: cwd) |
+| `--timeout <seconds>` | Timeout in seconds (default: 600) |
+| `--local` | Execute locally without daemon |
+| `--pipeline` | Full pipeline: worker + reviewer + tester + documenter |
+| `--worker-only` | Worker only, no review |
+| `-m, --model <model>` | Model override for worker |
 
-```
-                         ┌──────────────────────────┐
-                         │       Linear API          │
-                         │   (issues, state, memory) │
-                         └─────────────┬────────────┘
-                                       │
-                 ┌─────────────────────┼─────────────────────┐
-                 │                     │                     │
-                 v                     v                     v
-  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐
-  │ AutonomousRunner │  │  DecisionEngine  │  │  TaskScheduler   │
-  │ (heartbeat loop) │─>│  (scope guard)   │─>│  (queue + slots) │
-  └────────┬─────────┘  └──────────────────┘  └────────┬─────────┘
-           │                                            │
-           v                                            v
-  ┌──────────────────────────────────────────────────────────────┐
-  │                      PairPipeline                            │
-  │  ┌────────┐   ┌──────────┐   ┌────────┐   ┌─────────────┐  │
-  │  │ Worker │──>│ Reviewer │──>│ Tester │──>│ Documenter  │  │
-  │  │(Adapter│<──│(Adapter) │   │(Adapter│   │  (Adapter)  │  │
-  │  └───┬────┘   └──────────┘   └────────┘   └─────────────┘  │
-  │      │  ↕ StuckDetector                                      │
-  │  ┌───┴────────────────────────────────────────────────────┐  │
-  │  │ CLI Adapters: Claude (`claude -p`) | Codex (`codex`)   │  │
-  │  └────────────────────────────────────────────────────────┘  │
-  └──────────────────────────────────────────────────────────────┘
-           │                     │                     │
-           v                     v                     v
-  ┌──────────────┐  ┌──────────────────┐  ┌──────────────────┐
-  │  Discord Bot │  │  Memory (LanceDB │  │  Knowledge Graph │
-  │  (commands)  │  │  + Xenova E5)    │  │  (code analysis) │
-  └──────────────┘  └──────────────────┘  └──────────────────┘
-```
+Exit codes: `0` success · `1` failure · `2` timeout
 
-## Features
+---
+
+## Full Daemon Setup
 
-- **Multi-Provider Adapters** - Pluggable CLI adapter system supporting **Claude Code** (`claude -p`) and **OpenAI Codex** (`codex exec`), with runtime provider switching via Discord command
-- **Autonomous Pipeline** - Cron-driven heartbeat fetches Linear issues, runs Worker/Reviewer pair loops, and updates issue state automatically
-- **Worker/Reviewer Pairs** - Multi-iteration code generation with automated review, testing, and documentation stages
-- **Decision Engine** - Scope validation, rate limiting, priority-based task selection, and workflow mapping
-- **Cognitive Memory** - LanceDB vector store with Xenova/multilingual-e5-base embeddings for long-term recall across sessions
-- **Knowledge Graph** - Static code analysis, dependency mapping, impact analysis, and file-level conflict detection across concurrent tasks
-- **Discord Control** - Full command interface for monitoring, task dispatch, scheduling, provider switching, and pair session management
-- **Rich TUI Chat** - Claude Code inspired terminal interface with tabs, streaming responses, and geek-themed loading messages
-- **Dynamic Scheduling** - Cron-based job scheduler with Discord management commands
-- **PR Auto-Improvement** - Monitors open PRs, auto-fixes CI failures, auto-resolves merge conflicts, and retries until all checks pass
-- **Long-Running Monitors** - Track external processes (training jobs, batch tasks) and report completion
-- **Web Dashboard** - Real-time pipeline stages, cost tracking, worktree status, and live logs on port 3847
-- **Pace Control** - 5-hour rolling window task caps, per-project limits, turbo mode, exponential backoff on failures
-- **i18n** - English and Korean locale support
-
-## Prerequisites
+For autonomous operation (Linear issue processing, Discord control, PR auto-improvement), you need a full config:
+
+### Prerequisites
 
 - **Node.js** >= 22
-- **CLI Provider** (at least one):
-  - **Claude Code CLI** installed and authenticated (`claude -p`) — default provider
-  - **OpenAI Codex CLI** installed (`codex exec`) — alternative provider
+- **Claude Code CLI** authenticated (`claude -p`) — default provider
+- **OpenAI Codex CLI** (`codex exec`) — optional alternative provider
 - **Discord Bot** token with message content intent
 - **Linear** API key and team ID
 - **GitHub CLI** (`gh`) for CI monitoring (optional)
 
-## Installation
+### Configuration
 
 ```bash
 git clone https://github.com/unohee/OpenSwarm.git
 cd OpenSwarm
 npm install
-```
-
-## Configuration
-
-```bash
 cp config.example.yaml config.yaml
 ```
 
-Create a `.env` file with required secrets:
+Create a `.env` file:
 
 ```bash
 DISCORD_TOKEN=your-discord-bot-token
@@ -137,9 +103,9 @@ LINEAR_API_KEY=your-linear-api-key
 LINEAR_TEAM_ID=your-linear-team-id
 ```
 
-`config.yaml` supports environment variable substitution (`${VAR}` or `${VAR:-default}`) and is validated with Zod schemas.
+`config.yaml` supports `${VAR}` / `${VAR:-default}` substitution and is validated with Zod schemas.
 
-### Key Configuration Sections
+### Key configuration sections
 
 | Section | Description |
 |---------|-------------|
@@ -152,20 +118,22 @@ LINEAR_TEAM_ID=your-linear-team-id
 
 ### CLI Adapter (Provider)
 
-OpenSwarm supports multiple CLI backends. Set the default in `config.yaml`:
-
 ```yaml
-adapter: claude   # "claude" (default) or "codex"
+adapter: claude   # "claude" | "codex" | "gpt" | "local"
 ```
 
 Switch at runtime via Discord: `!provider codex` / `!provider claude`
 
-| Adapter | CLI Command | Models | Git Management |
-|---------|-------------|--------|----------------|
-| `claude` | `claude -p` | claude-sonnet-4, claude-haiku-4.5, claude-opus-4 | Manual (worker commits) |
-| `codex` | `codex exec` | o3, o4-mini | Auto (`--full-auto`) |
+| Adapter | Backend | Models | Auth |
+|---------|---------|--------|------|
+| `claude` | Claude Code CLI | sonnet-4, haiku-4.5, opus-4 | CLI auth |
+| `codex` | OpenAI Codex CLI | o3, o4-mini | CLI auth |
+| `gpt` | OpenAI API | gpt-4o, o3, gpt-4.1 | OAuth PKCE |
+| `local` | Ollama / LMStudio / llama.cpp | gemma4, llama3, mistral, qwen, etc. | None |
+
+Local models are auto-detected on standard ports (Ollama `:11434`, LMStudio `:1234`, llama.cpp `:8080`).
 
-Per-role adapter overrides are supported — e.g., use Codex for workers and Claude for reviewers:
+Per-role adapter overrides:
 
 ```yaml
 autonomous:
@@ -180,8 +148,6 @@ autonomous:
 
 ### Agent Roles
 
-Each pipeline stage can be configured independently:
-
 ```yaml
 autonomous:
   defaultRoles:
@@ -201,158 +167,120 @@ autonomous:
       enabled: false
 ```
 
-## Usage
+### Running the daemon
 
-### CLI Commands
+#### macOS launchd service (recommended)
 
 ```bash
-# Interactive chat with Claude (TUI mode)
-openswarm chat --tui
-
-# Interactive chat (simple readline mode)
-openswarm chat [session-name]
-
-# Run a single task (no config needed)
-openswarm run "Fix the login bug" --path ~/my-project
-
-# Execute via daemon (auto-starts service if needed)
-openswarm exec "Run tests and fix failures" --worker-only
-openswarm exec "Review all pending PRs" --timeout 300
-openswarm exec "Fix CI" --local --pipeline
-
-# Initialize configuration
-openswarm init
-
-# Validate configuration
-openswarm validate
-
-# Start the full daemon
-openswarm start
+npm run service:install    # Build and install as system service
+npm run service:start      # Start
+npm run service:stop       # Stop
+npm run service:restart    # Restart
+npm run service:status     # Status and recent logs
+npm run service:logs       # stdout (follow mode)
+npm run service:errors     # stderr (follow mode)
+npm run service:uninstall  # Uninstall
 ```
 
-#### `openswarm exec` Options
+#### Manual
 
-| Option | Description |
-|--------|-------------|
-| `--path <path>` | Project path (default: cwd) |
-| `--timeout <seconds>` | Timeout in seconds (default: 600) |
-| `--no-auto-start` | Do not auto-start the service |
-| `--local` | Execute locally without daemon |
-| `--pipeline` | Full pipeline: worker + reviewer + tester + documenter |
-| `--worker-only` | Worker only, no review |
-| `-m, --model <model>` | Model override for worker |
-
-Exit codes: `0` (success), `1` (failure), `2` (timeout).
-
-### Running the Service
-
-#### macOS launchd Service (Recommended)
-
-**Installation:**
 ```bash
-# Build and install as a system service
-npm run service:install
+npm run build && npm start   # Production
+npm run dev                  # Development (tsx watch)
+docker compose up -d         # Docker
 ```
 
-**Service Management:**
-```bash
-npm run service:start      # Start service
-npm run service:stop       # Stop service
-npm run service:restart    # Restart service
-npm run service:status     # View status and recent logs
-npm run service:logs       # View stdout logs (follow mode)
-npm run service:errors     # View stderr logs (follow mode)
-npm run service:uninstall  # Uninstall service
-```
+---
 
-**Browser Auto-Launch (Optional):**
-```bash
-npm run browser:install    # Auto-open dashboard on boot
-npm run browser:uninstall  # Disable auto-open
+## Architecture
+
+```
+                         ┌──────────────────────────┐
+                         │       Linear API          │
+                         │   (issues, state, memory) │
+                         └─────────────┬────────────┘
+                                       │
+                 ┌─────────────────────┼─────────────────────┐
+                 │                     │                     │
+                 v                     v                     v
+  ┌──────────────────┐  ┌──────────────────┐  ┌──────────────────┐
+  │ AutonomousRunner │  │  DecisionEngine  │  │  TaskScheduler   │
+  │ (heartbeat loop) │─>│  (scope guard)   │─>│  (queue + slots) │
+  └────────┬─────────┘  └──────────────────┘  └────────┬─────────┘
+           │                                            │
+           v                                            v
+  ┌──────────────────────────────────────────────────────────────┐
+  │                      PairPipeline                            │
+  │  ┌────────┐   ┌──────────┐   ┌────────┐   ┌─────────────┐  │
+  │  │ Worker │──>│ Reviewer │──>│ Tester │──>│ Documenter  │  │
+  │  │(Adapter│<──│(Adapter) │   │(Adapter│   │  (Adapter)  │  │
+  │  └───┬────┘   └──────────┘   └────────┘   └─────────────┘  │
+  │      │  ↕ StuckDetector                                      │
+  │  ┌───┴────────────────────────────────────────────────────┐  │
+  │  │ Adapters: Claude | Codex | GPT | Local (Ollama/LMS)   │  │
+  │  └────────────────────────────────────────────────────────┘  │
+  └──────────────────────────────────────────────────────────────┘
+           │                     │                     │
+           v                     v                     v
+  ┌──────────────┐  ┌──────────────────┐  ┌──────────────────┐
+  │  Discord Bot │  │  Memory (LanceDB │  │  Knowledge Graph │
+  │  (commands)  │  │  + Xenova E5)    │  │  (code analysis) │
+  └──────────────┘  └──────────────────┘  └────────┬─────────┘
+                                                    │
+                                           ┌────────┴─────────┐
+                                           │  Code Registry   │
+                                           │  (SQLite + FTS5) │
+                                           │  + BS Detector   │
+                                           └──────────────────┘
 ```
 
-The service will:
-- Auto-start on system boot
-- Auto-restart on crash
-- Log to `~/.openswarm/logs/`
-- Run with your user permissions (access to Claude CLI, gh, local files)
-- (Optional) Open web dashboard at http://localhost:3847 on boot
+## Features
 
-#### Manual Execution
+- **Multi-Provider Adapters** — Pluggable adapter system: **Claude Code**, **OpenAI GPT/Codex**, and **local models** (Ollama, LMStudio, llama.cpp) with runtime provider switching
+- **Code Registry** — SQLite-backed entity registry tracking every function/class/type across 8 languages, with complexity scoring, test mapping, and risk assessment
+- **BS Detector** — Built-in static analysis engine that detects bad code patterns (empty catch, hardcoded secrets, `as any`, etc.) with pipeline guard integration
+- **Autonomous Pipeline** — Cron-driven heartbeat fetches Linear issues, runs Worker/Reviewer pair loops, and updates issue state automatically
+- **Worker/Reviewer Pairs** — Multi-iteration code generation with automated review, testing, and documentation stages
+- **Decision Engine** — Scope validation, rate limiting, priority-based task selection, and workflow mapping
+- **Cognitive Memory** — LanceDB vector store with Xenova/multilingual-e5-base embeddings for long-term recall across sessions
+- **Knowledge Graph** — Static code analysis, dependency mapping, impact analysis, and file-level conflict detection across concurrent tasks
+- **Discord Control** — Full command interface for monitoring, task dispatch, scheduling, provider switching, and pair session management
+- **Rich TUI Chat** — Claude Code inspired terminal interface with tabs, streaming responses, and geek-themed loading messages
+- **Dynamic Scheduling** — Cron-based job scheduler with Discord management commands
+- **PR Auto-Improvement** — Monitors open PRs, auto-fixes CI failures, auto-resolves merge conflicts, and retries until all checks pass
+- **Long-Running Monitors** — Track external processes (training jobs, batch tasks) and report completion
+- **Web Dashboard** — Real-time pipeline stages, cost tracking, worktree status, and live logs on port 3847
+- **Pace Control** — 5-hour rolling window task caps, per-project limits, turbo mode, exponential backoff on failures
+- **i18n** — English and Korean locale support
 
-```bash
-# Development
-npm run dev
+---
 
-# Production
-npm run build
-npm start
+## How It Works
 
-# Background (legacy)
-nohup npm start > openswarm.log 2>&1 &
 ```
-
-#### Docker
-
-```bash
-docker compose up -d
+Linear (Todo/In Progress)
+  → Fetch assigned issues
+  → DecisionEngine filters & prioritizes
+  → Resolve project path via projectMapper
+  → PairPipeline.run()
+    → Worker generates code (Claude CLI)
+    → Reviewer evaluates (APPROVE/REVISE/REJECT)
+    → Loop up to N iterations
+    → Optional: Tester → Documenter stages
+  → Update Linear issue state (Done/Blocked)
+  → Report to Discord
+  → Save to cognitive memory
 ```
 
-### Shell Helper (optional)
+### Memory System
 
-Add to `~/.zshrc` or `~/.bashrc`:
+Hybrid retrieval: `0.55 × similarity + 0.20 × importance + 0.15 × recency + 0.10 × frequency`
 
-```bash
-openswarm() {
-  case "$1" in
-    start)
-      cd /path/to/OpenSwarm && nohup npm start > ~/.openswarm/log 2>&1 &
-      echo "✅ Started (PID: $!)"
-      ;;
-    stop)
-      pkill -f "openswarm" && echo "✅ Stopped"
-      ;;
-    status)
-      pgrep -f "openswarm" && echo "✅ Running" || echo "❌ Stopped"
-      ;;
-    chat)
-      cd /path/to/OpenSwarm && node --import=tsx src/cli.ts chat "${@:2}"
-      ;;
-  esac
-}
-```
+Memory types: `belief` · `strategy` · `user_model` · `system_pattern` · `constraint`
 
-## Project Structure
+Background: decay, consolidation, contradiction detection, distillation.
 
-```
-src/
-├── index.ts                 # Entry point
-├── cli.ts                   # CLI entry point (run, exec, chat, init, validate, start)
-├── cli/                     # CLI subcommand handlers
-│   └── promptHandler.ts     # `exec` command: daemon submit, auto-start, polling
-├── core/                    # Config, service lifecycle, types, event hub
-├── adapters/                # CLI provider adapters (claude, codex), process registry
-├── agents/                  # Worker, reviewer, tester, documenter, auditor
-│   ├── pairPipeline.ts      # Worker → Reviewer → Tester → Documenter pipeline
-│   ├── agentBus.ts          # Inter-agent message bus
-│   └── cliStreamParser.ts   # Claude CLI output parser
-├── orchestration/           # Decision engine, task parser, scheduler, workflow
-├── automation/              # Autonomous runner, cron scheduler, PR processor
-│   ├── autonomousRunner.ts  # Cron-driven heartbeat and task dispatch
-│   ├── prProcessor.ts       # PR auto-improvement (CI fixes, conflict resolution)
-│   ├── conflictResolver.ts  # AI-powered merge conflict resolution
-│   ├── prOwnership.ts       # Bot PR tracking for conflict resolution
-│   ├── longRunningMonitor.ts# External process monitoring
-│   └── runnerState.ts       # Persistent pipeline state
-├── memory/                  # LanceDB + Xenova embeddings cognitive memory
-├── knowledge/               # Code knowledge graph (scanner, analyzer, graph)
-├── discord/                 # Bot core, command handlers, pair session UI
-├── linear/                  # Linear SDK wrapper, project updater
-├── github/                  # GitHub CLI wrapper for CI monitoring
-├── support/                 # Web dashboard, planner, rollback, git tools
-├── locale/                  # i18n (en/ko) with prompt templates
-└── __tests__/               # Vitest test suite
-```
+---
 
 ## Discord Commands
 
@@ -416,95 +344,50 @@ src/
 | `!memory search "<query>"` | Search cognitive memory |
 | `!help` | Full command reference |
 
-## How It Works
-
-### Issue Processing Flow
-
-```
-Linear (Todo/In Progress)
-  → Fetch assigned issues
-  → DecisionEngine filters & prioritizes
-  → Resolve project path via projectMapper
-  → PairPipeline.run()
-    → Worker generates code (Claude CLI)
-    → Reviewer evaluates (APPROVE/REVISE/REJECT)
-    → Loop up to N iterations
-    → Optional: Tester → Documenter stages
-  → Update Linear issue state (Done/Blocked)
-  → Report to Discord
-  → Save to cognitive memory
-```
-
-### Memory System
-
-Hybrid retrieval scoring: `0.55 * similarity + 0.20 * importance + 0.15 * recency + 0.10 * frequency`
-
-Memory types: `belief`, `strategy`, `user_model`, `system_pattern`, `constraint`
-
-Background cognition: decay, consolidation, contradiction detection, and distillation (noise filtering).
-
-## `@intrect/claude-driver` (npm 패키지)
-
-OpenSwarm의 Claude CLI 스폰 + 스트리밍 파싱 로직을 독립 패키지로 추출했습니다. 다른 프로젝트에서 OpenSwarm 없이 바로 사용할 수 있습니다.
-
-```bash
-npm install @intrect/claude-driver
-```
-
-### 기본 사용법
-
-```ts
-import { run } from '@intrect/claude-driver';
-
-const result = await run({
-  prompt: 'Fix the bug in src/app.ts',
-  cwd: '/my/project',
-});
-console.log(result.response);  // 어시스턴트 응답
-console.log(result.cost);      // "$0.03 | 1.2k in / 800 out | 12.3s"
-```
-
-### 어댑터 직접 사용 (mid-level)
+---
 
-```ts
-import { spawnCli, ClaudeCliAdapter } from '@intrect/claude-driver';
+## Project Structure
 
-const adapter = new ClaudeCliAdapter();
-const raw = await spawnCli(adapter, {
-  prompt: 'Explain this code',
-  cwd: '/my/project',
-  onLog: (line) => process.stdout.write(line),
-});
 ```
-
-### 파서만 사용 (low-level)
-
-```ts
-import {
-  parseCliStreamChunk,
-  extractResultFromStreamJson,
-  extractCostFromStreamJson,
-} from '@intrect/claude-driver';
+src/
+├── index.ts                 # Entry point
+├── cli.ts                   # CLI entry point (run, exec, chat, init, validate, start)
+├── cli/                     # CLI subcommand handlers
+│   └── promptHandler.ts     # exec command: daemon submit, auto-start, polling
+├── core/                    # Config, service lifecycle, types, event hub
+├── adapters/                # CLI provider adapters (claude, codex, gpt, local), process registry
+├── agents/                  # Worker, reviewer, tester, documenter, auditor
+│   ├── pairPipeline.ts      # Worker → Reviewer → Tester → Documenter pipeline
+│   ├── agentBus.ts          # Inter-agent message bus
+│   └── cliStreamParser.ts   # Claude CLI output parser
+├── orchestration/           # Decision engine, task parser, scheduler, workflow
+├── automation/              # Autonomous runner, cron scheduler, PR processor
+├── memory/                  # LanceDB + Xenova embeddings cognitive memory
+├── knowledge/               # Code knowledge graph (scanner, analyzer, graph)
+├── registry/                # Code entity registry, BS detector, entity scanner
+├── issues/                  # Local issue tracker (SQLite + GraphQL + Kanban UI)
+├── discord/                 # Bot core, command handlers, pair session UI
+├── linear/                  # Linear SDK wrapper, project updater
+├── github/                  # GitHub CLI wrapper for CI monitoring
+├── support/                 # Web dashboard, planner, rollback, git tools
+├── locale/                  # i18n (en/ko) with prompt templates
+└── __tests__/               # Vitest test suite
 ```
 
-### 공개 API
-
-| 모듈 | 내보내는 것 |
-|------|------------|
-| 고수준 | `run()`, `inferProviderFromModel()` |
-| 중간 수준 | `spawnCli()` |
-| 어댑터 | `ClaudeCliAdapter`, `CodexCliAdapter`, `getAdapter()`, `setDefaultAdapter()` |
-| 스트림 파서 | `parseCliStreamChunk()`, `extractResultFromStreamJson()` |
-| 비용 파서 | `extractCostFromStreamJson()`, `aggregateCosts()`, `formatCost()` |
-| 버퍼 | `SmartStreamBuffer` |
+## State & Data
 
-- **런타임 의존성 0개** — ESM 전용, Node.js 20+
-- **타입 완전 지원** — TypeScript 타입 포함
-- **멀티 프로바이더** — Claude CLI와 Codex CLI 모두 지원
-- 소스: [`packages/claude-driver/`](packages/claude-driver/)
+| Path | Description |
+|------|-------------|
+| `~/.openswarm/` | State directory (memory, codex, metrics, workflows) |
+| `~/.openswarm/registry.db` | Code entity registry (SQLite) |
+| `~/.openswarm/issues.db` | Local issue tracker (SQLite) |
+| `~/.claude/openswarm-*.json` | Pipeline history and task state |
+| `config.yaml` | Main configuration |
+| `dist/` | Compiled output |
 
 ---
 
+
 ## Tech Stack
 
 | Category | Technology |
@@ -512,7 +395,8 @@ import {
 | Runtime | Node.js 22+ (ESM) |
 | Language | TypeScript (strict mode) |
 | Build | tsc |
-| Agent Execution | Claude Code CLI (`claude -p`) or OpenAI Codex CLI (`codex exec`) via pluggable adapters |
+| Agent Execution | Claude Code, OpenAI GPT/Codex, Ollama/LMStudio/llama.cpp |
+| Local DB | better-sqlite3 (WAL mode, FTS5) |
 | Task Management | Linear SDK (`@linear/sdk`) |
 | Communication | Discord.js 14 |
 | Vector DB | LanceDB + Apache Arrow |
@@ -522,22 +406,43 @@ import {
 | Linting | oxlint |
 | Testing | Vitest |
 
-## State & Data
-
-| Path | Description |
-|------|-------------|
-| `~/.openswarm/` | State directory (memory, codex, metrics, workflows, etc.) |
-| `~/.claude/openswarm-*.json` | Pipeline history and task state |
-| `config.yaml` | Main configuration |
-| `dist/` | Compiled output |
-
-## Docker
+---
 
-```bash
-docker compose up -d
-```
+## Changelog
+
+### v0.3.0
+- **Code Registry**: `openswarm check --scan` scans repo, registers 1000+ entities across 8 languages (TS, Python, Go, Rust, Java, C, C++, C#) with test mapping, complexity scoring, and risk assessment
+- **BS Detector**: `openswarm check --bs` — built-in static analysis for bad code patterns, pipeline guard integration
+- **Local Model Support**: Ollama, LMStudio, llama.cpp via single `local` adapter with auto-detection
+- **GPT Adapter**: OpenAI models via OAuth PKCE flow
+- **Local Issue Tracker**: SQLite + GraphQL + Kanban web UI at `:3847/issues`
+- **CLI**: `openswarm check`, `openswarm annotate` commands
+
+### v0.2.2
+- `openswarm` without arguments now launches TUI chat directly
+
+### v0.2.1
+- Security: patched lodash, picomatch, rollup, undici, yaml vulnerabilities
+
+### v0.2.0
+- Published as `@intrect/openswarm` on npm
+- Extracted `@intrect/claude-driver` as standalone zero-dependency package
+- Autonomous runner hardening and multi-project orchestration
+- Task-state rehydration from Linear comments
+- `--verbose` flag for detailed execution logging
+- Codex adapter: dropped o-series model override
+
+### v0.1.0
+- Initial release
+- Worker/Reviewer pair pipeline
+- Claude Code CLI + Codex CLI adapters
+- Discord bot control
+- Linear integration
+- LanceDB cognitive memory
+- Web dashboard (port 3847)
+- Rich TUI chat interface
 
-The Docker setup includes volume mounts for `~/.openswarm/` state persistence and `.env` for secrets.
+---
 
 ## License