npm - clew-code - Versions diffs - 0.2.21 → 0.2.22 - Mend

clew-code 0.2.21 → 0.2.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (66) hide show

package/dist/main.js +1861 -1856
package/docs/architecture.html +91 -148
package/docs/assets/clew-agent-loop.png +0 -0
package/docs/assets/clew-general-architecture.png +0 -0
package/docs/assets/clew-mcp-architecture.png +0 -0
package/docs/assets/clew-p2p-swarm.png +0 -0
package/docs/changelog.html +150 -0
package/docs/cli-reference.html +90 -0
package/docs/commands.html +156 -265
package/docs/configuration.html +85 -147
package/docs/contributing.html +91 -0
package/docs/css/styles.css +425 -425
package/docs/daemon.html +62 -129
package/docs/features/bridge-mode.html +61 -66
package/docs/features/evals.html +57 -149
package/docs/features/searxng-search.html +58 -118
package/docs/features/sentry-setup.html +61 -124
package/docs/index.html +137 -125
package/docs/installation.html +77 -105
package/docs/internals/growthbook-ab-testing.html +69 -91
package/docs/internals/hidden-features.html +81 -143
package/docs/js/main.js +29 -0
package/docs/loop.html +69 -181
package/docs/mcp.html +99 -247
package/docs/models.html +69 -110
package/docs/permission-model.html +86 -102
package/docs/plugins.html +84 -102
package/docs/providers.html +87 -127
package/docs/quick-start.html +81 -93
package/docs/research-memory.html +71 -102
package/docs/security.html +71 -0
package/docs/skills.html +67 -117
package/docs/swarm.html +78 -236
package/docs/tools.html +152 -151
package/docs/troubleshooting.html +86 -106
package/docs/voice-mode.html +79 -0
package/package.json +1 -1
package/docs/architecture.th.html +0 -79
package/docs/clew-code-architecture.html +0 -1126
package/docs/commands.th.html +0 -269
package/docs/configuration.th.html +0 -108
package/docs/daemon.th.html +0 -73
package/docs/features/bridge-mode.th.html +0 -62
package/docs/features/evals.th.html +0 -62
package/docs/features/searxng-search.th.html +0 -67
package/docs/features/sentry-setup.th.html +0 -69
package/docs/features/swarm.html +0 -156
package/docs/generated/providers.html +0 -625
package/docs/generated/tools.html +0 -558
package/docs/index.th.html +0 -292
package/docs/installation.th.html +0 -105
package/docs/internals/growthbook-ab-testing.th.html +0 -60
package/docs/internals/hidden-features.th.html +0 -107
package/docs/loop.th.html +0 -227
package/docs/mcp.th.html +0 -207
package/docs/models.th.html +0 -61
package/docs/permission-model.th.html +0 -67
package/docs/plugins.th.html +0 -79
package/docs/prompts-and-features.html +0 -806
package/docs/providers.th.html +0 -81
package/docs/quick-start.th.html +0 -89
package/docs/research-memory.th.html +0 -72
package/docs/skills.th.html +0 -90
package/docs/swarm.th.html +0 -280
package/docs/tools.th.html +0 -84
package/docs/troubleshooting.th.html +0 -85

package/docs/architecture.html CHANGED Viewed

@@ -1,148 +1,91 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Architecture — Clew</title>
-  <meta name="description" content="Runtime architecture, layered design, and data flow for Clew CLI.">
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
-  <link rel="stylesheet" href="css/styles.css">
-  <link rel="icon" type="image/svg+xml" href="./assets/clew.svg">
-</head>
-<body>
-<header class="header"></header>
-<div class="app"><aside class="sidebar" id="sidebar"></aside><div class="sidebar-overlay" id="sidebarOverlay"></div>
-<div class="content-wrap"><main class="content">
-  <div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span>Architecture</span></div>
-  <h1>Architecture</h1>
-  <p class="section-subtitle">Clew is a terminal-based AI coding assistant — a React/Ink TUI, Commander.js CLI, multi-provider AI engine, and extensible tool/plugin runtime all in one process.</p>
-  <h2>Layered Design</h2>
-  <p>The application is structured as four cooperative layers:</p>
-  <h3>1. Terminal UI (React 19 + Ink 6)</h3>
-  <p>Renders the interactive REPL: prompt input, streaming markdown output, status bar with context meter, arc spinner, permission dialogs, file explorer, inline images, buddy (duck) companion, and fullscreen mode. Components live in <code>src/components/</code>, state management in <code>src/state/</code>, and React context in <code>src/context/</code>.</p>
-  <h3>2. CLI &amp; Command Layer (Commander.js 13)</h3>
-  <p>Entry point at <code>src/main.tsx</code> — parses CLI flags (<code>--model</code>, <code>--print</code>, <code>--permission-mode</code>, <code>--mcp-config</code>, etc.), loads config, initializes providers and telemetry, then launches the REPL or print-mode query. Slash commands are registered in <code>src/commands.ts</code> and implemented under <code>src/commands/</code>. Commands are categorized as <code>local</code> (runs in-terminal), <code>prompt</code> (skills that expand to text), or <code>local-jsx</code> (Ink UI panels).</p>
-  <h3>3. AI Provider &amp; Adapter Layer</h3>
-  <p><strong>ProviderManager</strong> (<code>src/services/ai/ProviderManager.ts</code>) resolves API keys, selects models, and manages provider config. Provider metadata is declared in <code>src/services/ai/providers.json</code> — currently <strong>29 providers</strong> (10 dedicated classes + 18 OpenAI-compatible) with model listings, capabilities, base URLs, and env key mappings. Non-Anthropic providers are wrapped by the <strong>AnthropicAdapter</strong> or <strong>GoogleAdapter</strong>, which normalize content blocks (<code>contentBlockUtils.ts</code>), tool calls (<code>toolCallParser.ts</code>), errors (<code>errorNormalizer.ts</code>), and usage (<code>usageNormalizer.ts</code>) to a uniform format.</p>
-  <h3>4. Tool Execution &amp; Query Loop</h3>
-  <p>Tools use Zod schemas and are executed by the <strong>StreamingToolExecutor</strong> (<code>src/services/tools/StreamingToolExecutor.ts</code>). Permission gating via hooks in <code>src/utils/permissions/permissions.ts</code>. The query loop in <code>src/query.ts</code> + <code>src/QueryEngine.ts</code> orchestrates message building, context management, streaming, and tool call cycling. MCP tools (<code>src/services/mcp/</code>) are discovered at runtime and merged into the tool pool.</p>
-  <h2>Data Flow</h2>
-  <pre><code>  Terminal input
-       |
-       v
-  + Query Engine (query.ts + QueryEngine.ts)
-  |    Message building and context assembly
-  |    Tool call loop (model tool results)
-  |    Streaming response handling
-  |
-  + Provider Manager Adapter AI Model API
-  |    29 providers via providers.json
-  |    AnthropicAdapter / GoogleAdapter normalization
-  |
-  + Tool Executor (StreamingToolExecutor)
-  |    Permission check (permissions.ts)
-  |    Pre/Post tool hooks (plugins)
-  |    Tool execution result
-  |
-  + Terminal UI (React/Ink)
-       Streaming text and tool renders
-       Status bar, spinner, context meter
-       Permission dialogs</code></pre>
-  <h2>Key Subsystems</h2>
-  <h3>MCP (Model Context Protocol)</h3>
-  <p><code>src/services/mcp/</code> — manages external MCP server connections, tool discovery, resource access, and paginated <code>tools/list</code> responses. Servers configured via <code>--mcp-config</code> or <code>/mcp</code> command. See <a href="mcp.html">MCP</a> for detailed setup and configuration.</p>
-  <h3>Plugins &amp; Hooks</h3>
-  <p><code>src/services/plugins/</code> — plugin loading, installation, marketplace reconciliation, and hook dispatch. Hook points: <code>PreToolUse</code>, <code>PostToolUse</code>, <code>PreBash</code>, <code>PostPrompt</code>, <code>PreAcceptEdit</code>. Plugins can provide commands, agents, skills, MCP servers, and LSP integrations.</p>
-  <h3>LSP (Language Server Protocol)</h3>
-  <p><code>src/services/lsp/</code> — language-aware code intelligence via LSP servers. Diagnostics, completions, and symbol navigation. Enable with <code>ENABLE_LSP_TOOL=1</code>.</p>
-  <h3>Bridge Mode</h3>
-  <p><code>src/bridge/bridgeMain.ts</code> — WebSocket remote control and collaboration. Gated behind <code>BRIDGE_MODE=1</code>. Remote clients can send commands and receive responses.</p>
-  <h3>Session System</h3>
-  <p><code>src/services/SessionLifecycle/</code> — cross-session context persistence. <code>src/services/SessionMemory/</code> — persistent knowledge with cross-lingual semantic search and auto-memory capture.</p>
-  <h3>GrowthBook Feature Flags</h3>
-  <p><code>src/services/analytics/growthbook.js</code> — A/B testing and feature flag platform. Initialized at startup, evaluates flags locally with caching.</p>
-  <h3>Agent Runtime</h3>
-  <p><code>src/agentRuntime/</code> — manages multi-agent orchestration. The <strong>orchestrator</strong> coordinates agent sessions, <strong>runStore</strong> persists agent run data, <strong>toolGateway</strong> routes tools between agents, and <strong>workflowRegistry</strong> / <strong>agentRegistry</strong> declare named workflows and agent configurations.</p>
-  <h3>Autonomous / Daemon</h3>
-  <p><code>src/services/autonomous/</code> — enables 24/7 background execution. The <strong>taskQueue</strong> is a file-backed queue with priorities, leases, and dead-letter handling. <strong>agentLoop</strong> runs the continuous dequeue spawn worker monitor retry cycle. <strong>daemonMode</strong> provides the supervisor-managed background process entry point, and <strong>supervisorIntegration</strong> handles health checks and auto-respawn. See <a href="daemon.html">Daemon Mode</a> for detailed configuration and usage.</p>
-  <h3>Coordinator (Multi-Agent)</h3>
-  <p><code>src/coordinator/</code> — supports multi-agent collaboration. <strong>coordinatorMode</strong> delegates tasks to sub-agents, and <strong>workerAgent</strong> provides standalone workers for delegated subtasks.</p>
-  <h3>Memory</h3>
-  <p><code>src/memory/</code> — local embedding-free memory with SQLite FTS5 full-text search. Token-aware chunking (3000 tokens), truth priority scoring, secret redaction, and auto-ingest from <code>.clew/memory/</code>. See <a href="research-memory.html">Memory</a> for detailed usage.</p>
-  <h3>Voice Mode</h3>
-  <p><code>src/voice/</code> — compile-time gated voice input support (<code>VOICE_MODE=1</code>). Provides speech-to-text and voice command processing for hands-free operation.</p>
-  <h3>State Management</h3>
-  <p>The app uses a lightweight observable store pattern (<code>createStore&lt;T&gt;</code> in <code>src/state/store.ts</code>). Stores are plain functions with <code>getState</code>, <code>setState</code>, and <code>subscribe</code>. React components subscribe via the <strong>AppState</strong> React context (<code>src/state/AppState.tsx</code>).</p>
-  <h2>Important Source Paths</h2>
-  <table>
-    <tr><th>Path</th><th>Role</th></tr>
-    <tr><td><code>src/main.tsx</code></td><td>CLI entry, Commander program, option parsing, REPL launch</td></tr>
-    <tr><td><code>src/query.ts</code></td><td>Core query processing, message building, tool call loop</td></tr>
-    <tr><td><code>src/QueryEngine.ts</code></td><td>Query orchestration, caching, deduplication, rate limiting</td></tr>
-    <tr><td><code>src/commands.ts</code></td><td>Slash command registry (80+ commands)</td></tr>
-    <tr><td><code>src/tools.ts</code></td><td>Tool registry (40+ built-in tools)</td></tr>
-    <tr><td><code>src/Tool.ts</code></td><td>Base tool types, schemas, buildTool() helper</td></tr>
-    <tr><td><code>src/services/ai/ProviderManager.ts</code></td><td>Provider selection, API key resolution</td></tr>
-    <tr><td><code>src/services/ai/providers.json</code></td><td>Declarative provider config (29 providers)</td></tr>
-    <tr><td><code>src/services/ai/adapter/</code></td><td>AnthropicAdapter, GoogleAdapter</td></tr>
-    <tr><td><code>src/services/tools/StreamingToolExecutor.ts</code></td><td>Streaming tool execution</td></tr>
-    <tr><td><code>src/utils/permissions/permissions.ts</code></td><td>Permission evaluation logic</td></tr>
-    <tr><td><code>src/services/mcp/</code></td><td>MCP server management</td></tr>
-    <tr><td><code>src/services/plugins/</code></td><td>Plugin loader and hook dispatch</td></tr>
-    <tr><td><code>src/state/store.ts</code></td><td>Lightweight observable store (createStore&lt;T&gt;)</td></tr>
-    <tr><td><code>src/state/AppState.tsx</code></td><td>Root app state (React context)</td></tr>
-    <tr><td><code>src/state/AppStateStore.ts</code></td><td>App state store implementation</td></tr>
-    <tr><td><code>src/state/selectors.ts</code></td><td>State selectors</td></tr>
-    <tr><td><code>src/agentRuntime/</code></td><td>Agent orchestration, run store, tool gateway</td></tr>
-    <tr><td><code>src/services/autonomous/</code></td><td>Task queue, agent loop, daemon mode, supervisor</td></tr>
-    <tr><td><code>src/coordinator/</code></td><td>Multi-agent coordinator and worker agents</td></tr>
-    <tr><td><code>src/research/</code></td><td>Deep research, dossier generation, truth checking</td></tr>
-    <tr><td><code>src/memory/</code></td><td>SQLite FTS5 memory search (14 files)</td></tr>
-    <tr><td><code>src/voice/</code></td><td>Voice mode support (compile-time gated)</td></tr>
-    <tr><td><code>src/entrypoints/init.ts</code></td><td>Startup initialization (Sentry, configs, telemetry)</td></tr>
-    <tr><td><code>src/entrypoints/cli.tsx</code></td><td>Alternative CLI entry point (Commander-based)</td></tr>
-    <tr><td><code>src/entrypoints/mcp.ts</code></td><td>MCP server entry point</td></tr>
-  </table>
-  <h2>Build System</h2>
-  <p>Built with Bun bundler — <code>bun run build</code> outputs a single binary to <code>dist/</code>. TypeScript with strict mode and ESM/NodeNext module resolution. External dependencies include Electron, chromium-bidi, AWS SDK, Google Auth, and platform-specific native modules. Lint/format via Biome 2.4.</p>
-  <footer class="footer">
-    <span>Clew Code 0.2.14 — Open Source</span>
-    <div class="footer-links">
-      <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
-      <a href="https://github.com/ClewCode/ClewCode/issues">Issues</a>
-    </div>
-  </footer>
-</main>
-<nav class="toc-sidebar"></nav>
-</div>
-</div>
-<script src="js/main.js"></script>
-</body>
-</html>
-dy>
-</html>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Architecture — Clew Code</title>
+<meta name="description" href="Codebase architecture of Clew Code.">
+<link rel="icon" type="image/svg+xml" href="assets/clew.svg">
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
+<link rel="stylesheet" href="css/styles.css">
+</head>
+<body>
+<header class="header"></header>
+<div id="sidebarOverlay" class="sidebar-overlay"></div>
+<aside id="sidebar" class="sidebar"></aside>
+<div class="content-wrap">
+<div class="content">
+<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span class="current">Architecture</span></div>
+<h1>Architecture</h1>
+<p class="sub">Clew Code is a single-entry Bun bundle built with TypeScript (ESM, strict mode).</p>
+<h2 id="layers">Layer Overview</h2>
+<p>The architecture is layered: CLI entrypoint → Orchestrator → Context/Tools/Policy/Provider → Session logger.</p>
+<pre><code>CLI (parseArgs)
+   ↓
+Orchestrator (Agent loop)
+   ↓
+Context ── Tools ── Policy ── Provider
+   ↓
+Session Logger
+</code></pre>
+<h2 id="sourcelayout">Source Layout</h2>
+<pre><code>src/
+├── main.tsx                 # Entry point
+├── query.ts / QueryEngine.ts
+├── agentRuntime/            # Background agent orchestration
+├── commands/                # Slash command implementations
+├── tools/                   # 50+ built-in tools
+├── services/
+│   ├── ai/                  # Provider manager + 27 providers
+│   ├── mcp/                 # MCP client + auth + transports
+│   ├── plugins/             # Plugin hooks + marketplace
+│   ├── autonomous/          # Agent loop + task queue + cron
+│   ├── lsp/                 # LSP integration
+│   └── Supervisor/          # Agent supervisor IPC
+├── mesh/                    # MeshServer + MeshDiscovery
+├── bridge/                  # WebSocket bridge + relay
+├── components/              # Ink terminal UI components
+├── state/                   # AppState management
+└── hooks/                   # React hooks
+</code></pre>
+<h2 id="execution-layers">Execution Layers</h2>
+<p>Clew Code has several agent execution layers:</p>
+<table>
+  <thead>
+    <tr><th>Layer</th><th>Duration</th><th>Use Case</th></tr>
+  </thead>
+  <tbody>
+    <tr><td>Agent</td><td>Session-long</td><td>Main chat, custom agents in <code>.clew/agents/*.md</code></td></tr>
+    <tr><td>Subagent</td><td>One-shot</td><td>Explore codebase, test triage, review</td></tr>
+    <tr><td>Teammate/Swarm</td><td>Multi-turn</td><td>Coordinated long-running agent teams</td></tr>
+    <tr><td>LAN Mesh</td><td>Persistent</td><td>Cross-machine coordination via <code>/mesh</code></td></tr>
+    <tr><td>Process Mesh</td><td>One-shot</td><td>External CLI workers (Codex exec/pty)</td></tr>
+    <tr><td>ACP</td><td>External</td><td>Editor/IDE/agent → Clew protocol boundary</td></tr>
+  </tbody>
+</table>
+<h2 id="key-concepts">Key Concepts</h2>
+<h3>Multi-Pass Compaction</h3>
+<p>Automatic chunk-based context compression with recursive re-compaction when context exceeds the model window. Trigger manually with <code>/compact</code>.</p>
+<h3>Plan Mode</h3>
+<p>Full-access planning mode with bypass permissions. Plans persist to <code>.clew/plans/</code> with progress snapshots.</p>
+<h3>Provider Manager</h3>
+<p>The ProviderManager routes all LLM calls through a unified interface. Each provider has an adapter that normalizes requests and responses. The provider can be switched mid-session via <code>/model</code>.</p>
+</div>
+</div>
+<script src="js/main.js"></script>
+</body>
+</html>

package/docs/assets/clew-agent-loop.png ADDED Viewed

Binary file

package/docs/assets/clew-general-architecture.png ADDED Viewed

Binary file

package/docs/assets/clew-mcp-architecture.png ADDED Viewed

Binary file

package/docs/assets/clew-p2p-swarm.png ADDED Viewed

Binary file

package/docs/changelog.html ADDED Viewed

@@ -0,0 +1,150 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Changelog — Clew Code</title>
+<meta name="description" content="Release history and changelog for Clew Code.">
+<link rel="icon" type="image/svg+xml" href="assets/clew.svg">
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
+<link rel="stylesheet" href="css/styles.css">
+</head>
+<body>
+<header class="header"></header>
+<div id="sidebarOverlay" class="sidebar-overlay"></div>
+<aside id="sidebar" class="sidebar"></aside>
+<div class="content-wrap">
+<div class="content">
+<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span class="current">Changelog</span></div>
+<h1>Changelog</h1>
+<h2 id="0.2.21">v0.2.21 — 2026-06-14</h2>
+<h3>Fixed</h3>
+<ul>
+  <li><strong>Detect package manager from install path</strong> — now correctly detects whether to use <code>bun</code> or <code>npm</code> based on the installation path, not the runtime.</li>
+  <li><strong>Polish UI rendering</strong> — fixed empty-state edge cases and visual glitches.</li>
+</ul>
+<h2 id="0.2.20">v0.2.20 — 2026-06-14</h2>
+<h3>Fixed</h3>
+<ul>
+  <li><strong>mesh-spawn</strong> — spawn <code>cmd.exe</code> directly with <code>/k</code> and set title inside command instead of using <code>start</code>.</li>
+  <li><strong>mesh-spawn cd fix</strong> — execute <code>cd</code> before running clew command to bypass cmd.exe quote stripping.</li>
+</ul>
+<h2 id="0.2.16">v0.2.16 — 2026-06-14</h2>
+<h3>Fixed</h3>
+<ul>
+  <li><strong>Auto-relaunch after update</strong> — <code>UpdateDialog.startInstall()</code> now spawns a detached child process immediately after install completes. No more manual restart required.</li>
+</ul>
+<h2 id="0.2.15">v0.2.15 — 2026-06-14</h2>
+<h3>Added</h3>
+<ul>
+  <li><strong>ACP + Mesh integration</strong> — <code>AcpMeshBoundary</code> for routing editor ACP and REST ACP through the process peer / mesh layer with <code>AbortSignal</code> and <code>onProgress</code> support.</li>
+  <li><strong>AcpRunController</strong> — lifecycle owner for ACP runs: creates run, wires <code>AbortController</code>, executes through mesh boundary, maps results to terminal state.</li>
+  <li><strong>WebSocket transport</strong> — <code>ACPWebSocketServer.ts</code> — Bun-native WebSocket server bridging remote editor connections via NDJSON stream.</li>
+  <li><strong>SSE streaming</strong> — <code>GET /runs/:id/stream</code> endpoint with 500ms polling and keepalive.</li>
+</ul>
+<h3>Changed</h3>
+<ul>
+  <li><strong>Editor ACP shapes fixed</strong> — <code>PromptResponse</code> now returns only <code>{ stopReason }</code>, <code>sessionUpdate</code> uses <code>SessionNotification</code> shape.</li>
+</ul>
+<h2 id="0.2.14">v0.2.14 — 2026-06-14</h2>
+<h3>Added</h3>
+<ul>
+  <li><strong>Peer task queue system</strong> — queuing commands when busy with priority levels, auto-dequeue, SSE queue events.</li>
+  <li><strong>Peer health monitoring</strong> — healthy/lagging/offline states, latency tracking.</li>
+  <li><strong>Long-term memory system</strong> — auto-extraction, session consolidation, cross-session history, timeline queries.</li>
+  <li><strong>Gemini Code Assist provider</strong> — OAuth-based provider integration.</li>
+  <li><strong>Dashboard Monitor</strong> — real-time agent and daemon monitoring with tabbed views.</li>
+</ul>
+<h3>Changed</h3>
+<ul>
+  <li><strong>peer → swarm rename</strong> — all <code>/peer</code> commands migrated to <code>/swarm</code>.</li>
+</ul>
+<h2 id="0.2.13">v0.2.13 — 2026-06-13</h2>
+<h3>Changed</h3>
+<ul>
+  <li>Formatting pass across codebase via Biome.</li>
+  <li>bun.lock synchronized with updated dependencies.</li>
+</ul>
+<h2 id="0.2.12">v0.2.12 — 2026-06-13</h2>
+<h3>Added</h3>
+<ul>
+  <li><strong>Provider consolidation</strong> — GoogleProvider and ClewGatewayProvider now extend OpenAICompatibleProvider, removing 679 lines of duplicated code.</li>
+  <li>Zod v4 migration (<code>.passthrough()</code> → <code>.loose()</code>).</li>
+  <li>PR command refactored to use <code>--json</code> + <code>JSON.parse</code>.</li>
+</ul>
+<h2 id="0.2.11">v0.2.11 — 2026-06-13</h2>
+<h3>Added</h3>
+<ul>
+  <li>Further swarm/peer system refinements.</li>
+  <li>Bug fixes and performance improvements.</li>
+</ul>
+<h2 id="0.2.7">v0.2.7 — 2026-06-11</h2>
+<h3>Added</h3>
+<ul>
+  <li><strong>process_peer PTY terminal box</strong> — terminal-style progress box with ANSI-preserving output tail.</li>
+  <li><strong><code>/mesh run codex &lt;task&gt;</code></strong> — one-shot Codex process peer from chat.</li>
+  <li><strong>Auto-update dialog</strong> — npm update notification before app starts.</li>
+  <li><strong>Rich model fetching</strong> — API models now carry context window, vision, tools, reasoning, free tags.</li>
+  <li><strong><code>/model list</code> capability tags</strong> — <code>[200K ctx, vision, tools, reason, free]</code> per model.</li>
+  <li><strong>Cost in status line</strong> — shows session cost when &gt;$0.</li>
+</ul>
+<h2 id="0.2.6">v0.2.6 — 2026-06-10</h2>
+<h3>Added</h3>
+<ul>
+  <li><strong>Peer HTTP heartbeat</strong> — 60s liveness checks, offline peers detected immediately.</li>
+  <li><strong><code>/agents</code> visual polish</strong> — redesigned dashboard.</li>
+  <li><strong>Auto-updater</strong> — switched from Anthropic GCS to npm registry.</li>
+</ul>
+<h3>Removed</h3>
+<ul>
+  <li>GitHub Copilot provider and all references cleaned out.</li>
+</ul>
+<h2 id="0.2.5">v0.2.5 — 2026-06-10</h2>
+<h3>Added</h3>
+<ul>
+  <li><strong>Rebranded to Clew Code</strong> — docs, UI copy, and package updated.</li>
+  <li><strong>Memory search</strong> — <code>/memory search</code> for stored entries.</li>
+  <li><strong>Peer tools</strong> — 14 AI coordination tools, peer help, connection count in footer.</li>
+</ul>
+<h2 id="0.2.4">v0.2.4 — 2026-06-08</h2>
+<h3>Added</h3>
+<ul>
+  <li><strong>Peer-to-peer</strong> — UDP multicast discovery, file registry, 14 AI coordination tools, interactive PeerMenu.</li>
+  <li><strong>Autonomous agents</strong> — agent loop, supervisor integration, task queue, Loop Lock.</li>
+  <li><strong>Workflow Rainbow</strong> — per-character gradient highlight for "workflow" keyword.</li>
+</ul>
+<h2 id="0.2.3">v0.2.3 — 2026-06-07</h2>
+<h3>Added</h3>
+<ul>
+  <li><code>/effort</code> works with any provider exposing <code>reasoningEffort</code>.</li>
+  <li><code>/model</code> fetches live model list from provider APIs.</li>
+  <li>Relay server for cross-network remote control.</li>
+  <li>Bridge v2: provider-agnostic remote control.</li>
+  <li><code>/pr create/list/view/review/merge/status</code>.</li>
+  <li>Security: PowerShell rules, malformed tool call guard, 100 MB bash output cap.</li>
+</ul>
+<p><a href="https://github.com/ClewCode/ClewCode/blob/main/CHANGELOG.md">View full changelog on GitHub →</a></p>
+</div>
+</div>
+<script src="js/main.js"></script>
+</body>
+</html>

package/docs/cli-reference.html ADDED Viewed

@@ -0,0 +1,90 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>CLI Reference — Clew Code</title>
+<meta name="description" content="Command-line interface reference for Clew Code.">
+<link rel="icon" type="image/svg+xml" href="assets/clew.svg">
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet">
+<link rel="stylesheet" href="css/styles.css">
+</head>
+<body>
+<header class="header"></header>
+<div id="sidebarOverlay" class="sidebar-overlay"></div>
+<aside id="sidebar" class="sidebar"></aside>
+<div class="content-wrap">
+<div class="content">
+<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span class="current">CLI Reference</span></div>
+<h1>CLI Reference</h1>
+<p class="sub">Complete reference for Clew Code command-line flags and arguments.</p>
+<h2 id="usage">Usage</h2>
+<pre><code class="language-bash">clew [flags]
+clew [command] [flags]
+</code></pre>
+<h2 id="global">Global Flags</h2>
+<table>
+  <thead>
+    <tr><th>Flag</th><th>Description</th></tr>
+  </thead>
+  <tbody>
+    <tr><td><code>-p, --prompt &lt;text&gt;</code></td><td>One-shot mode: run a prompt in non-interactive mode and exit</td></tr>
+    <tr><td><code>--resume &lt;id&gt;</code></td><td>Resume a previous session by ID. Use <code>last</code> for the most recent session</td></tr>
+    <tr><td><code>--version</code></td><td>Print version and exit</td></tr>
+    <tr><td><code>--help</code></td><td>Show help message</td></tr>
+  </tbody>
+</table>
+<h2 id="exec">Exec Commands</h2>
+<table>
+  <thead>
+    <tr><th>Command</th><th>Description</th></tr>
+  </thead>
+  <tbody>
+    <tr><td><code>clew . &lt;prompt&gt;</code></td><td>Run prompt in current directory</td></tr>
+    <tr><td><code>clew acp serve</code></td><td>Start ACP WebSocket server (default port: 3099)</td></tr>
+  </tbody>
+</table>
+<h2 id="env">Environment Variables</h2>
+<table>
+  <thead>
+    <tr><th>Variable</th><th>Description</th></tr>
+  </thead>
+  <tbody>
+    <tr><td><code>ANTHROPIC_API_KEY</code></td><td>Anthropic Claude API key</td></tr>
+    <tr><td><code>OPENAI_API_KEY</code></td><td>OpenAI API key</td></tr>
+    <tr><td><code>GOOGLE_API_KEY</code></td><td>Google Gemini API key</td></tr>
+    <tr><td><code>DEEPSEEK_API_KEY</code></td><td>DeepSeek API key</td></tr>
+    <tr><td><code>GROQ_API_KEY</code></td><td>Groq API key</td></tr>
+    <tr><td><code>MISTRAL_API_KEY</code></td><td>Mistral API key</td></tr>
+    <tr><td><code>OPENROUTER_API_KEY</code></td><td>OpenRouter API key</td></tr>
+    <tr><td><code>OLLAMA_HOST</code></td><td>Ollama server URL (default: http://localhost:11434)</td></tr>
+    <tr><td><code>SEARXNG_URL</code></td><td>SearXNG instance URL</td></tr>
+    <tr><td><code>SENTRY_DSN</code></td><td>Sentry DSN for error tracking</td></tr>
+    <tr><td><code>GROWTHBOOK_API_KEY</code></td><td>GrowthBook API key for feature flags</td></tr>
+  </tbody>
+</table>
+<h2 id="exit-codes">Exit Codes</h2>
+<table>
+  <thead>
+    <tr><th>Code</th><th>Meaning</th></tr>
+  </thead>
+  <tbody>
+    <tr><td><code>0</code></td><td>Success</td></tr>
+    <tr><td><code>1</code></td><td>General error</td></tr>
+  </tbody>
+</table>
+</div>
+</div>
+<script src="js/main.js"></script>
+</body>
+</html>