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

clew-code 0.2.21 → 0.2.23

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 (67) hide show

package/README.md +45 -45
package/dist/main.js +2906 -2722
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 +133 -241
package/docs/configuration.html +85 -147
package/docs/contributing.html +91 -0
package/docs/css/styles.css +272 -152
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 +185 -148
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 +63 -92
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 +183 -171
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/models.html CHANGED Viewed

@@ -1,110 +1,81 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Models — Clew</title>
-  <meta name="description" content="Model selection guide for Clew — how to pick, switch, and manage models across 29 providers.">
-  <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">
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Models — Clew Code</title>
+<meta name="description" href="Model configuration and selection in 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 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>Models</span></div>
-  <h1>Models</h1>
-  <p class="section-subtitle">Clew supports 100+ models across 29 providers. Pick the right model for each task — from frontier reasoning to fast local inference.</p>
+<div id="sidebarOverlay" class="sidebar-overlay"></div>
+<aside id="sidebar" class="sidebar"></aside>
-  <h2>Model Selection Guide</h2>
-  <table>
-    <tr><th>Workload</th><th>Recommended Models</th><th>Context</th><th>Notes</th></tr>
-    <tr><td>Complex architecture &amp; large edits</td><td>claude-opus-4-7, claude-sonnet-4-6, gpt-5.5, deepseek-v4-pro</td><td>1M tokens</td><td>Best tool calling, strong reasoning, largest context</td></tr>
-    <tr><td>Code review &amp; debugging</td><td>claude-sonnet-4-6, gpt-5.5, gemini-3.1-pro-preview</td><td>1M-2M tokens</td><td>Good instruction following, reliable output</td></tr>
-    <tr><td>Quick search &amp; summarization</td><td>claude-haiku-4-5, deepseek-v4-flash, mistral-small-4, groq/llama-3.3-70b</td><td>128K-200K</td><td>Fast, cost-effective, lower latency</td></tr>
-    <tr><td>Offline / air-gapped</td><td>ollama/llama4:70b, ollama/llama3.3</td><td>131K tokens</td><td>Fully local, no network needed</td></tr>
-    <tr><td>Cost-sensitive bulk</td><td>kilocode/kilo-auto/free, opencode-go/minimax-m2.7, groq/llama-3.1-8b</td><td>Varies</td><td>Free or minimal cost tiers available</td></tr>
-    <tr><td>Research &amp; reasoning</td><td>claude-opus-4-7, deepseek-v4-pro, gemini-3.1-pro-preview</td><td>1M-2M tokens</td><td>Deep reasoning, chain-of-thought</td></tr>
-    <tr><td>Vision / multimodal</td><td>claude-sonnet-4-6, gpt-5.5, gemini-3.1-pro-preview, deepseek-v4-flash</td><td>1M tokens</td><td>Image understanding, document analysis</td></tr>
-  </table>
+<div class="content-wrap">
+<div class="content">
-  <h2>Notable Models by Provider</h2>
-  <table>
-    <tr><th>Provider</th><th>Models Available</th></tr>
-    <tr><td>Anthropic</td><td>claude-opus-4-7 (1M ctx), claude-sonnet-4-6 (1M ctx, recommended), claude-haiku-4-5 (200K ctx, fast)</td></tr>
-    <tr><td>OpenAI</td><td>gpt-5.5 (1M ctx), gpt-5.4 (1M ctx), gpt-5.4-mini (fast)</td></tr>
-    <tr><td>Google</td><td>gemini-3.1-pro-preview (2M ctx), gemini-3.1-flash-lite (1M ctx, fast)</td></tr>
-    <tr><td>DeepSeek</td><td>deepseek-v4-pro (1M ctx, MoE), deepseek-v4-flash (1M ctx, fast MoE)</td></tr>
-    <tr><td>xAI</td><td>grok-4.3 (128K ctx)</td></tr>
-    <tr><td>Mistral</td><td>mistral-medium-3.5, mistral-small-4, mistral-large-3</td></tr>
-    <tr><td>Groq</td><td>llama-3.3-70b, llama-3.1-8b-instant (fast)</td></tr>
-    <tr><td>Ollama</td><td>llama4:70b (local), llama3.3 (local), qwen3.6-plus (local)</td></tr>
-    <tr><td>OpenCode</td><td>claude-opus-4-7, claude-sonnet-4-6, gpt-5.5, gemini-3.1-pro, kimi-k2.6</td></tr>
-    <tr><td>KiloCode</td><td>kilo-auto/free, kilo-auto/balanced, kilo-auto/frontier</td></tr>
-    <tr><td>Cohere</td><td>command-a-plus (128K ctx)</td></tr>
-    <tr><td>Perplexity</td><td>sonar-pro, sonar, sonar-reasoning-pro</td></tr>
-    <tr><td>Together AI</td><td>deepseek-v4, Qwen3.6, Llama-4</td></tr>
-    <tr><td>NVIDIA NIM</td><td>deepseek-v4-pro, glm-5.1, nemotron-3</td></tr>
-    <tr><td>Cerebras</td><td>qwen-3-235b (extremely fast)</td></tr>
-    <tr><td>Moonshot (Kimi)</td><td>kimi-k2.6 (128K ctx)</td></tr>
-    <tr><td>Zhipu (GLM)</td><td>glm-4.7 (128K ctx)</td></tr>
-    <tr><td>Hugging Face</td><td>llama-3.3-70b-instruct</td></tr>
-    <tr><td>Poe</td><td>claude-3-7-sonnet</td></tr>
-  </table>
+<div class="breadcrumbs"><a href="index.html">Home</a><span class="sep">/</span><span class="current">Models</span></div>
-  <h2>Model Switching</h2>
-  <pre><code>/model                          # Interactive picker (fetches live models from provider API when supported)
-/model list                     # List all available models from the active provider API
-/model claude-sonnet-4-7        # Switch by full ID
-/model sonnet                   # Alias-based switching
---model opus                    # CLI flag at startup</code></pre>
-  <p>For providers with a /v1/models endpoint (OpenAI, DeepSeek, NVIDIA, etc.), the picker fetches live models from the API instead of the static providers.json list.
-    The picker shows <strong>all models from every provider</strong> in named sections — not just the active provider's models. Recent models appear at top with the active provider's default. Select any model from any provider directly.</p>
-  <p>Model switching is instant — the next conversation turn uses the new model. Previous context is preserved.</p>
+<h1>Models</h1>
+<p class="sub">Select and configure AI models from any supported provider. Switch mid-session without restarting.</p>
-  <h2>Model Aliases</h2>
-  <p>Short aliases are resolved to full model IDs: <code>sonnet</code>, <code>opus</code>, <code>haiku</code>, <code>gpt5</code>, <code>flash</code>, etc.</p>
+<h2 id="switching">Switching Models</h2>
+<p>Use the <code>/model</code> command in the REPL:</p>
+<pre><code class="language-bash">❯ /model                 # interactive provider/model picker
+❯ /model openai          # switch to OpenAI provider
+❯ /model gpt-5.5         # set specific model
+❯ /model list            # list available models from all providers
+</code></pre>
-  <h2>CLI Flags for Models</h2>
-  <table>
-    <tr><th>Flag</th><th>Description</th></tr>
-    <tr><td><code>--model &lt;name&gt;</code></td><td>Set model at startup (e.g., <code>--model sonnet</code> or <code>--model claude-opus-4-7</code>)</td></tr>
-    <tr><td><code>--effort &lt;level&gt;</code></td><td>Set reasoning effort: <code>low</code>, <code>medium</code>, <code>high</code>, <code>max</code></td></tr>
-    <tr><td><code>--max-turns &lt;N&gt;</code></td><td>Limit agentic turns in non-interactive mode</td></tr>
-    <tr><td><code>--thinking &lt;mode&gt;</code></td><td>Thinking mode: <code>enabled</code>, <code>adaptive</code>, <code>disabled</code></td></tr>
-    <tr><td><code>--fallback-model &lt;model&gt;</code></td><td>Fallback when primary model is overloaded (print mode only)</td></tr>
-    <tr><td><code>--task-budget &lt;tokens&gt;</code></td><td>API-side task budget in tokens</td></tr>
-    <tr><td><code>--max-budget-usd &lt;amount&gt;</code></td><td>Maximum spend on API calls (print mode only)</td></tr>
-  </table>
+<h2 id="capabilities">Capability Tags</h2>
+<p>The <code>/model list</code> command fetches live model lists from provider APIs and displays capability tags:</p>
+<pre><code>deepseek-v4-flash      [200K ctx, tools, reason, free]
+gpt-5.5                [128K ctx, vision, tools]
+claude-sonnet-5        [200K ctx, vision, tools, reason]
+gemini-2.0-flash       [1M ctx, vision, tools, free]
+</code></pre>
+<p>Tags include context window size, vision support, tool calling, reasoning, and free tier availability.</p>
-  <h2>Model Capabilities</h2>
-  <p>Each model declaration in <code>providers.json</code> includes:</p>
-  <ul>
-    <li>Model ID and display label</li>
-    <li>Context window (<code>maxContext</code>) and max output tokens (<code>maxOutput</code>)</li>
-    <li>Tool calling type (<code>native</code>, <code>none</code>)</li>
-    <li>Vision support</li>
-    <li>Streaming mode (<code>full</code>, <code>partial</code>)</li>
-    <li>Reasoning support</li>
-    <li>System prompt support</li>
-    <li>Tags (for filtering): <code>fast</code>, <code>verified</code>, <code>recommended</code>, <code>latest</code>, <code>free</code>, <code>vision</code>, <code>tools</code>, <code>native</code>, <code>moe</code>, <code>local</code></li>
-  </ul>
+<h2 id="reasoning">Reasoning Effort</h2>
+<p>For models that support configurable reasoning (DeepSeek, NVIDIA, OpenRouter, etc.):</p>
+<pre><code class="language-bash">❯ /effort low
+❯ /effort medium
+❯ /effort high
+</code></pre>
-  <footer class="footer">
-    <span>Clew 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>
+<h2 id="local">Local Models (Ollama)</h2>
+<p>Run models locally with Ollama:</p>
+<pre><code class="language-bash">❯ /model ollama/llama3.3
+❯ /model ollama/mistral
+❯ /model ollama/codellama
+</code></pre>
+<p>Set the Ollama host:</p>
+<pre><code class="language-bash">export OLLAMA_HOST=http://localhost:11434
+</code></pre>
+<h2 id="image-gen">Image Generation Models</h2>
+<p><code>GenerateImage</code> auto-discovers image-capable models from provider APIs on first use:</p>
+<table>
+  <thead><tr><th>Provider</th><th>Models Discovered</th><th>API Key</th></tr></thead>
+  <tbody>
+    <tr><td>OpenAI</td><td><code>dall-e-3</code>, future DALL-E versions</td><td><code>OPENAI_API_KEY</code></td></tr>
+    <tr><td>OpenRouter</td><td><code>gemini-3.1-flash-image-preview</code>, <code>flux.2-pro</code>, <code>recraft-v3</code>, etc.</td><td><code>OPENROUTER_API_KEY</code></td></tr>
+    <tr><td>Google</td><td><code>imagen-3.0-generate-002</code>, future Imagen versions</td><td><code>GOOGLE_API_KEY</code></td></tr>
+  </tbody>
+</table>
+<p>To override auto-discovery, add <code>"capabilities": { "imageGen": { "defaultModel": "...", "apiType": "..." } }</code> to the provider in <code>providers.json</code>.</p>
+<h2 id="provider-defaults">Provider Defaults</h2>
+<p>Each provider has a default model. The first time you switch to a provider, its default model is selected automatically. Override with:</p>
+<pre><code class="language-bash">❯ /model deepseek-v4-flash
+</code></pre>
 </div>
 </div>
 <script src="js/main.js"></script>
 </body>
 </html>

package/docs/permission-model.html CHANGED Viewed

@@ -1,102 +1,86 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Permission Model — Clew</title>
-  <meta name="description" content="Tool execution permissions in Clew — modes, rules, and security.">
-  <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>Permission Model</span></div>
-  <h1>Permission Model</h1>
-  <p class="section-subtitle">Clew gates tool execution through a tiered permission system with multiple modes, allow/deny rules, and tool-specific checks.</p>
-  <h2>Permission Modes</h2>
-  <p>Defined in <code>src/types/permissions.ts</code>. Seven user-addressable modes:</p>
-  <table>
-    <tr><th>Mode</th><th>Behavior</th></tr>
-    <tr><td><code>default</code></td><td>Ask before sensitive tool actions (read/write/bash/network). Safe default.</td></tr>
-    <tr><td><code>ask</code></td><td>Always ask before any tool execution.</td></tr>
-    <tr><td><code>plan</code></td><td>Prefer planning mode — AI must present a plan before executing tools.</td></tr>
-    <tr><td><code>auto</code></td><td>Auto-approve low-risk actions using transcript classifier (requires <code>TRANSCRIPT_CLASSIFIER</code> feature). Prompt for risky operations.</td></tr>
-    <tr><td><code>acceptEdits</code></td><td>Auto-approve file edit operations. Useful for rapid iteration.</td></tr>
-    <tr><td><code>bypassPermissions</code></td><td>Skip all permission prompts. Use only in trusted sandboxes.</td></tr>
-    <tr><td><code>dontAsk</code></td><td>Never ask — auto-deny anything that would require permission.</td></tr>
-  </table>
-  <h2>Permission Rules</h2>
-  <p>Granular allow/deny rules control specific tools and their arguments:</p>
-  <pre><code>/permissions     # Open interactive permission rule manager</code></pre>
-  <p>Rules can target specific tools with pattern matching:</p>
-  <ul>
-    <li><code>Bash(git *)</code> — Allow/deny git commands specifically</li>
-    <li><code>Edit</code> — Allow/deny all file edits</li>
-    <li><code>Bash(rm *)</code> — Warn/block destructive shell commands</li>
-  </ul>
-  <h2>Rule Sources</h2>
-  <p>Permission rules come from multiple sources (evaluated in order, with later sources overriding earlier ones):</p>
-  <ul>
-    <li><code>userSettings</code> — From user config file</li>
-    <li><code>projectSettings</code> — From project-level settings</li>
-    <li><code>localSettings</code> — Local overrides</li>
-    <li><code>flagSettings</code> — From CLI flags (<code>--allowedTools</code>, <code>--disallowedTools</code>)</li>
-    <li><code>policySettings</code> — Managed/organization policy</li>
-  </ul>
-  <h2>Tool Permission Flow</h2>
-  <pre><code>1. Tool input validation (validateInput)
-2. Tool-specific checkPermissions()
-3. Deny rule check (permissions.ts getDenyRuleForTool)
-4. Permission mode evaluation (mode-based auto decision)
-5. Plugin hooks (PreToolUse PostToolUse)
-6. Classifier-based auto-approval (auto mode)
-7. User permission dialog (if needed)</code></pre>
-  <h2>CLI Flags for Permissions</h2>
-  <table>
-    <tr><th>Flag</th><th>Description</th></tr>
-    <tr><td><code>--permission-mode &lt;mode&gt;</code></td><td>Set session permission mode</td></tr>
-    <tr><td><code>--dangerously-skip-permissions</code></td><td>Bypass all checks (sandbox only)</td></tr>
-    <tr><td><code>--allow-dangerously-skip-permissions</code></td><td>Enable bypass as optional mode</td></tr>
-    <tr><td><code>--allowedTools, --allowed-tools &lt;tools...&gt;</code></td><td>Allowlist specific tools with patterns</td></tr>
-    <tr><td><code>--disallowedTools, --disallowed-tools &lt;tools...&gt;</td><td>Denylist specific tools with patterns</td></tr>
-  </table>
-  <h2>Security Best Practices</h2>
-  <ul>
-    <li><strong>Default mode</strong> for day-to-day development</li>
-    <li><strong>Plan mode</strong> for production infrastructure or unfamiliar code</li>
-    <li><strong>Bypass modes</strong> only in disposable worktrees or Docker sandboxes</li>
-    <li>Use allow/deny rules to permit safe patterns (e.g., <code>Bash(git *)</code>) while blocking dangerous ones</li>
-    <li>Run <code>/doctor</code> to audit current permission settings</li>
-  </ul>
-  <div class="callout callout-warn">
-    <strong>Use Caution</strong>
-    <code>bypassPermissions</code> mode executes all tool actions without prompting. Restrict to trusted, sandboxed environments.
-  </div>
-  <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>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Permission Model — Clew Code</title>
+<meta name="description" href="Permission modes and security model in 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">Permission Model</span></div>
+<h1>Permission Model</h1>
+<p class="sub">Clew Code provides 7 permission modes with granular allow/deny rules for safe AI-assisted development.</p>
+<h2 id="modes">Permission Modes</h2>
+<table>
+  <thead>
+    <tr><th>Mode</th><th>Description</th></tr>
+  </thead>
+  <tbody>
+    <tr><td><code>default</code></td><td>Ask for every tool execution. Maximum safety.</td></tr>
+    <tr><td><code>ask</code></td><td>Prompt for confirmation on each action.</td></tr>
+    <tr><td><code>plan</code></td><td>Full-access planning with bypass permissions. Read, write, edit freely during planning.</td></tr>
+    <tr><td><code>auto</code></td><td>Auto-approve safe tools (read, grep, glob). Ask for destructive operations.</td></tr>
+    <tr><td><code>acceptEdits</code></td><td>Auto-approve file edits within allowed patterns.</td></tr>
+    <tr><td><code>bypassPermissions</code></td><td>Full access — all tools approved automatically.</td></tr>
+    <tr><td><code>dontAsk</code></td><td>Execute everything without prompting. Use with caution.</td></tr>
+  </tbody>
+</table>
+<h2 id="switching">Switching Modes</h2>
+<p>Use the <code>/permissions</code> command in the REPL:</p>
+<pre><code class="language-bash">❯ /permissions plan     # enter full-access plan mode
+❯ /permissions auto     # auto-approve safe operations
+❯ /permissions default  # back to asking for each action
+</code></pre>
+<h2 id="rules">Allow/Deny Rules</h2>
+<p>Configure granular rules in <code>.clew/settings.json</code>:</p>
+<pre><code class="language-json">{
+  "allow": [
+    "bash: npm run dev",
+    "bash: git status",
+    "write: src/**"
+  ],
+  "deny": [
+    "bash: rm -rf",
+    "bash: git push --force"
+  ]
+}
+</code></pre>
+<p>Rules support glob pattern matching against tool names and arguments.</p>
+<h2 id="safety">Safety Gates</h2>
+<p>The <code>safetyGate</code> system validates:</p>
+<ul>
+  <li>Command paths — prevents execution of dangerous commands</li>
+  <li>File paths — blocks writes outside project boundaries</li>
+  <li>Destructive operations — requires explicit approval</li>
+  <li>Bash output cap — 100 MB limit to prevent runaway processes</li>
+</ul>
+<h2 id="plan-mode">Plan Mode</h2>
+<p>Plan mode is a special full-access mode for architectural work:</p>
+<ul>
+  <li>Read, write, and edit files without permission prompts</li>
+  <li>Plan files persist to <code>.clew/plans/</code> with progress snapshots</li>
+  <li>Exit with <code>ExitPlanMode</code> to present the plan for approval</li>
+</ul>
+</div>
+</div>
+<script src="js/main.js"></script>
+</body>
+</html>

package/docs/plugins.html CHANGED Viewed

@@ -1,102 +1,84 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Plugins — Clew</title>
-  <meta name="description" content="Extend Clew with plugins — commands, agents, skills, hooks, MCP servers, and marketplace support.">
-  <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>Plugins</span></div>
-  <h1>Plugins</h1>
-  <p class="section-subtitle">Plugins extend Clew with custom commands, agents, skills, execution hooks, MCP servers, and LSP integrations. Plugin management is handled by <code>src/services/plugins/</code> and <code>src/utils/plugins/</code>.</p>
-  <h2>What Plugins Can Provide</h2>
-  <table>
-    <tr><th>Extension</th><th>Description</th></tr>
-    <tr><td>Slash Commands</td><td>Custom <code>/command</code> implementations registered via plugin manifest</td></tr>
-    <tr><td>Agents</td><td>Specialized agent configurations with custom prompts and tool access</td></tr>
-    <tr><td>Skills</td><td>Reusable task instructions from plugin skill directories</td></tr>
-    <tr><td>Execution Hooks</td><td>Pre/post hooks at tool, bash, prompt, and edit stages</td></tr>
-    <tr><td>MCP Servers</td><td>Model Context Protocol server definitions bundled with the plugin</td></tr>
-    <tr><td>LSP Servers</td><td>Language Server Protocol integration</td></tr>
-  </table>
-  <h2>Hook System</h2>
-  <table>
-    <tr><th>Hook Point</th><th>When It Fires</th></tr>
-    <tr><td><code>PreToolUse</code></td><td>Before a tool executes — validation, input modification, logging</td></tr>
-    <tr><td><code>PostToolUse</code></td><td>After a tool completes — result transformation, audit</td></tr>
-    <tr><td><code>PreBash</code></td><td>Before shell command execution — sanitization, env injection</td></tr>
-    <tr><td><code>PostPrompt</code></td><td>After prompt construction — context augmentation</td></tr>
-    <tr><td><code>PreAcceptEdit</code></td><td>Before accepting an edit — validation, policy enforcement</td></tr>
-  </table>
-  <h2>Plugin Management</h2>
-  <pre><code>/plugin                          # List installed plugins
-/plugin-details                  # Show detailed plugin information
-/reload-plugins                  # Activate pending plugin changes
-clew plugin validate /path       # Validate a plugin manifest (CLI)</code></pre>
-  <p>Plugins are loaded from these locations:</p>
-  <ul>
-    <li><strong>Bundled</strong> — Shipped with Clew</li>
-    <li><strong>User</strong> — Installed by the user (via marketplace or manual)</li>
-    <li><strong>Plugin dir</strong> — Custom directories via <code>--plugin-dir &lt;path&gt;</code> (repeatable)</li>
-  </ul>
-  <p>The <code>PluginInstallationManager</code> (<code>src/services/plugins/PluginInstallationManager.ts</code>) handles automatic installation, marketplace reconciliation, and plugin refresh. Use <code>/reload-plugins</code> after installing or updating plugins.</p>
-  <h2>Built-in Plugins</h2>
-  <table>
-    <tr><th>Plugin</th><th>Description</th></tr>
-    <tr><td><code>commit-commands</code></td><td>Git workflow — commit, push, PR creation, branch cleanup (<code>clean_gone</code>)</td></tr>
-    <tr><td><code>commit-push-pr</code></td><td>Commit, push, and open a PR in one step</td></tr>
-    <tr><td><code>code-review</code></td><td>Automated PR code review</td></tr>
-    <tr><td><code>feature-dev</code></td><td>Guided feature development with codebase understanding</td></tr>
-    <tr><td><code>frontend-design</code></td><td>Production-grade UI/UX generation</td></tr>
-    <tr><td><code>verify</code></td><td>Typecheck, lint, build, and test pipeline</td></tr>
-    <tr><td><code>precommit</code></td><td>Pre-commit review with full verification</td></tr>
-    <tr><td><code>commit</code></td><td>Conventional git commit message generation</td></tr>
-    <tr><td><code>simplify</code></td><td>Code quality and reuse review</td></tr>
-    <tr><td><code>debug</code></td><td>Debugging assistance and diagnosis</td></tr>
-    <tr><td><code>web-search</code></td><td>Multi-provider web search</td></tr>
-    <tr><td><code>scrapling</code></td><td>Web scraping with Scrapling framework</td></tr>
-    <tr><td><code>skillify</code></td><td>Create reusable skills from workflows</td></tr>
-    <tr><td><code>remember</code></td><td>Save user preferences</td></tr>
-  </table>
-  <h2>Plugin Structure</h2>
-  <pre><code>my-plugin/
-  manifest.json         # Plugin metadata and capability declarations
-  commands/             # Custom slash commands
-  skills/               # Reusable task instructions
-  agents/               # Agent configurations
-  hooks/                # Hook implementations</code></pre>
-  <h2>Marketplace</h2>
-  <p>Plugins can be distributed through marketplaces. The <code>marketplaceManager</code> (<code>src/utils/plugins/marketplaceManager.ts</code>) handles marketplace source discovery, cache management, and plugin installation from remote sources.</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>
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Plugins — Clew Code</title>
+<meta name="description" href="Plugin system, marketplace, and hooks in 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">Plugins</span></div>
+<h1>Plugins</h1>
+<p class="sub">Extend Clew Code without touching source code. Plugins can add tools, hook into lifecycle events, and integrate with external systems.</p>
+<h2 id="overview">Overview</h2>
+<p>Plugins are self-contained packages with a manifest file that declare hooks, tools, and configurations. They are hot-reloadable — no restart needed.</p>
+<h2 id="lifecycle">Lifecycle Hooks</h2>
+<p>Plugins can hook into every stage of the agent lifecycle:</p>
+<table>
+  <thead>
+    <tr><th>Hook</th><th>Trigger</th></tr>
+  </thead>
+  <tbody>
+    <tr><td><code>PreToolUse</code></td><td>Before a tool is executed</td></tr>
+    <tr><td><code>PostToolUse</code></td><td>After a tool completes</td></tr>
+    <tr><td><code>PreBash</code></td><td>Before a bash command runs</td></tr>
+    <tr><td><code>PostPrompt</code></td><td>After a prompt is processed</td></tr>
+    <tr><td><code>PreAcceptEdit</code></td><td>Before a file edit is applied</td></tr>
+  </tbody>
+</table>
+<h2 id="commands">Plugin Commands</h2>
+<table>
+  <thead>
+    <tr><th>Command</th><th>Description</th></tr>
+  </thead>
+  <tbody>
+    <tr><td><code>/plugin install &lt;name&gt;</code></td><td>Install a plugin from the marketplace</td></tr>
+    <tr><td><code>/plugin list</code></td><td>List installed plugins</td></tr>
+    <tr><td><code>/plugin remove &lt;name&gt;</code></td><td>Remove a plugin</td></tr>
+    <tr><td><code>/plugin marketplace</code></td><td>Browse the plugin marketplace</td></tr>
+    <tr><td><code>/hooks</code></td><td>View active hooks</td></tr>
+  </tbody>
+</table>
+<h2 id="plugin-manifest">Plugin Manifest</h2>
+<p>Plugins declare themselves via a manifest:</p>
+<pre><code class="language-json">{
+  "name": "my-plugin",
+  "version": "1.0.0",
+  "hooks": {
+    "PreToolUse": "./pre-tool.js",
+    "PostToolUse": "./post-tool.js"
+  },
+  "tools": [
+    {
+      "name": "my_custom_tool",
+      "description": "A custom tool",
+      "schema": { ... }
+    }
+  ]
+}
+</code></pre>
+<h2 id="marketplace">Plugin Marketplace</h2>
+<p>Discover and install community plugins via the built-in marketplace browser. Use <code>/plugin marketplace</code> to explore available plugins.</p>
+</div>
+</div>
+<script src="js/main.js"></script>
+</body>
+</html>