npm - clew-code - Versions diffs - 0.2.13 → 0.2.14 - Mend

clew-code 0.2.13 → 0.2.14

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

package/dist/main.js +2596 -2527
package/docs/architecture.html +148 -148
package/docs/architecture.th.html +79 -79
package/docs/clew-code-architecture.html +6 -6
package/docs/commands.html +225 -224
package/docs/commands.th.html +132 -131
package/docs/configuration.html +147 -147
package/docs/configuration.th.html +108 -108
package/docs/daemon.html +129 -129
package/docs/daemon.th.html +73 -73
package/docs/features/bridge-mode.html +99 -99
package/docs/features/bridge-mode.th.html +90 -90
package/docs/features/evals.html +182 -182
package/docs/features/evals.th.html +90 -90
package/docs/features/peer.html +178 -178
package/docs/features/searxng-search.html +151 -151
package/docs/features/searxng-search.th.html +95 -95
package/docs/features/sentry-setup.html +157 -157
package/docs/features/sentry-setup.th.html +97 -97
package/docs/index.html +298 -299
package/docs/index.th.html +292 -292
package/docs/installation.html +105 -105
package/docs/installation.th.html +105 -105
package/docs/internals/growthbook-ab-testing.html +113 -113
package/docs/internals/growthbook-ab-testing.th.html +81 -81
package/docs/internals/hidden-features.html +175 -149
package/docs/internals/hidden-features.th.html +135 -109
package/docs/loop.html +181 -181
package/docs/loop.th.html +227 -227
package/docs/mcp.html +247 -247
package/docs/mcp.th.html +207 -207
package/docs/models.html +110 -111
package/docs/models.th.html +61 -61
package/docs/peer.html +236 -236
package/docs/peer.th.html +280 -280
package/docs/permission-model.html +102 -102
package/docs/permission-model.th.html +67 -67
package/docs/plugins.html +102 -102
package/docs/plugins.th.html +79 -79
package/docs/providers.html +126 -126
package/docs/providers.th.html +80 -80
package/docs/quick-start.html +93 -93
package/docs/quick-start.th.html +1 -1
package/docs/research-memory.html +82 -82
package/docs/research-memory.th.html +72 -72
package/docs/skills.html +117 -117
package/docs/skills.th.html +90 -90
package/docs/tools.html +170 -170
package/docs/tools.th.html +84 -84
package/docs/troubleshooting.html +106 -106
package/docs/troubleshooting.th.html +85 -85
package/package.json +162 -164

package/docs/internals/hidden-features.html CHANGED Viewed

@@ -1,149 +1,175 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Hidden Features & Internals â€” Clew</title>
-  <meta name="description" content="Feature-gated commands, internal-only tools, and beta flags in Clew.">
-  <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">
-  <div class="header-inner">
-    <a href="../index.html" class="logo">
-      <span>Clew Code</span>
-    </a>
-    <nav class="header-nav">
-      <a href="../index.html">Home</a>
-      <a href="../index.html#features">Features</a>
-      <a href="../index.html#commands">Commands</a>
-      <a href="../quick-start.html" class="active">Docs</a>
-      <a href="https://github.com/ClewCode/ClewCode" target="_blank">GitHub</a>
-    <div class="lang-wrap">
-    <button class="lang-btn">ðŸŒ</button>
-    <div class="lang-menu">
-      <a href="../../readme/README.zh.md">ä¸æ–‡</a>
-      <a href="../../readme/README.th.md">à¹„à¸—à¸¢</a>
-      <a href="../../readme/README.ja.md">æ—¥æœ¬èªž</a>
-      <a href="../../readme/README.ko.md">í•œêµì–´</a>
-      <a href="../../readme/README.es.md">EspaÃ±ol</a>
-      <a href="../../readme/README.fr.md">FranÃ§ais</a>
-      <a href="../../readme/README.de.md">Deutsch</a>
-      <a href="../../readme/README.pt.md">PortuguÃªs</a>
-      <a href="../../readme/README.vi.md">Tiáº¿ng Viá»‡t</a>
-      <a href="../../readme/README.id.md">Bahasa Indonesia</a>
-      <a href="../../readme/README.ru.md">Ð ÑƒÑÑÐºÐ¸Ð¹</a>
-      <a href="../../readme/README.hi.md">à¤¹à¤¿à¤¨à¥à¤¦à¥€</a>
-      <a href="../../README.md">English</a>
-    </div>
-  </div>
-    </nav>
-    <button class="menu-btn" id="menuToggle" aria-label="Toggle navigation"><span></span><span></span><span></span></button>
-  </div>
-</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><a href="../index.html#features">Internals</a><span class="sep">/</span><span>Hidden Features</span></div>
-      <h1>Hidden Features &amp; Internals</h1>
-      <p class="section-subtitle">Feature-gated commands, internal-only tools, and beta flags â€” not visible in the standard help menu.</p>
-      <div class="callout callout-warn">
-        <strong>Internal / Beta</strong>
-        These features may change without notice. Most require specific environment variables or build-time feature flags.
-      </div>
-      <h2>Feature-Gated Commands</h2>
-      <p>From <code>src/commands.ts</code> â€” enabled via environment variables:</p>
-      <table>
-        <tr><th>Command</th><th>Env Variable</th><th>Description</th></tr>
-        <tr><td><code>/bridge</code></td><td><code>BRIDGE_MODE=1</code></td><td>WebSocket remote control and collaboration</td></tr>
-        <tr><td><code>/voice</code></td><td><code>VOICE_MODE=1</code></td><td>Toggle voice mode</td></tr>
-        <tr><td><code>/brief</code></td><td><code>KAIROS=1</code></td><td>Brief command for quick context</td></tr>
-        <tr><td><code>/assistant</code></td><td><code>KAIROS=1</code></td><td>Assistant mode with proactive behavior</td></tr>
-      </table>
-      <h2>Internal-Only Commands</h2>
-      <p>Defined in <code>INTERNAL_ONLY_COMMANDS</code> in <code>src/commands.ts</code>:</p>
-      <table>
-        <tr><th>Command</th><th>Description</th></tr>
-        <tr><td><code>/backfill-sessions</code></td><td>Backfill session data</td></tr>
-        <tr><td><code>/break-cache</code></td><td>Break internal caches</td></tr>
-        <tr><td><code>/bughunter</code></td><td>Automated bug hunting workflow</td></tr>
-        <tr><td><code>/commit-push-pr</code></td><td>Commit, push, and PR creation</td></tr>
-        <tr><td><code>/ctx-viz</code></td><td>Context visualization</td></tr>
-        <tr><td><code>/init-verifiers</code></td><td>Initialize verifiers</td></tr>
-        <tr><td><code>/issue</code></td><td>Issue management</td></tr>
-        <tr><td><code>/mock-limits</code></td><td>Mock usage limits for testing</td></tr>
-        <tr><td><code>/reset-limits</code></td><td>Reset usage limits</td></tr>
-        <tr><td><code>/ultraplan</code></td><td>Extended plan mode</td></tr>
-        <tr><td><code>/version</code></td><td>Show version</td></tr>
-        <tr><td><code>/bridge-kick</code></td><td>Bridge session management</td></tr>
-        <tr><td><code>/onboarding</code></td><td>Interactive onboarding wizard</td></tr>
-        <tr><td><code>/team-onboarding</code></td><td>Generate teammate ramp-up guide</td></tr>
-        <tr><td><code>/share</code></td><td>Share session</td></tr>
-        <tr><td><code>/summary</code></td><td>Summarize conversation</td></tr>
-        <tr><td><code>/teleport</code></td><td>Teleport session</td></tr>
-        <tr><td><code>/ant-trace</code></td><td>Anthropic-internal tracing</td></tr>
-        <tr><td><code>/perf-issue</code></td><td>Performance issue reporting</td></tr>
-        <tr><td><code>/env</code></td><td>Environment inspection</td></tr>
-        <tr><td><code>/oauth-refresh</code></td><td>OAuth token refresh</td></tr>
-        <tr><td><code>/debug-tool-call</code></td><td>Tool call debugging</td></tr>
-        <tr><td><code>/autofix-pr</code></td><td>Autofix PR workflow</td></tr>
-      </table>
-      <h2>Feature-Gated Tools</h2>
-      <table>
-        <tr><th>Tool</th><th>Flag / Feature</th></tr>
-        <tr><td><code>LSPTool</code></td><td><code>ENABLE_LSP_TOOL=1</code></td></tr>
-        <tr><td><code>ComputerUseTool</code></td><td><code>ENABLE_COMPUTER_USE=1</code> (Windows)</td></tr>
-        <tr><td><code>ToolSearchTool</code></td><td><code>CODE_INDEX</code> feature flag</td></tr>
-        <tr><td><code>EnterWorktreeTool / ExitWorktreeTool</code></td><td>Worktree mode enabled</td></tr>
-        <tr><td><code>PowerShellTool</code></td><td>PowerShell tool enabled in settings</td></tr>
-        <tr><td><code>CronCreateTool / CronDeleteTool / CronListTool</code></td><td><code>AGENT_TRIGGERS</code> feature</td></tr>
-        <tr><td><code>PushNotificationTool</code></td><td><code>KAIROS</code> feature</td></tr>
-        <tr><td><code>REPLTool</code></td><td><code>USER_TYPE=ant</code></td></tr>
-        <tr><td><code>ConfigTool / TungstenTool</code></td><td><code>USER_TYPE=ant</code></td></tr>
-      </table>
-      <h2>Build-Time Feature Flags</h2>
-      <ul>
-        <li><code>TRANSCRIPT_CLASSIFIER</code> â€” Enables auto permission mode with transcript-based classification</li>
-        <li><code>CHICAGO_MCP</code> â€” Enables Chicago MCP protocol features</li>
-      </ul>
-      <h2>Runtime Feature Detection</h2>
-      <p>Features are checked via <code>feature('FEATURE_NAME')</code> (compile-time) and <code>isEnvTruthy()</code> (runtime):</p>
-      <ul>
-        <li><code>PROACTIVE</code> / <code>KAIROS</code> â€” Proactive agent behavior</li>
-        <li><code>AGENT_TRIGGERS</code> â€” Scheduled and remote agent triggers</li>
-        <li><code>KAIROS_GITHUB_WEBHOOKS</code> â€” GitHub webhook subscriptions</li>
-        <li><code>KAIROS_PUSH_NOTIFICATION</code> â€” Push notification support</li>
-        <li><code>CONTEXT_COLLAPSE</code> â€” Context collapse inspection</li>
-        <li><code>MCP_SKILLS</code> â€” MCP-provided skills</li>
-        <li><code>CODE_INDEX</code> â€” Code indexing and search</li>
-        <li><code>COORDINATOR_MODE</code> â€” Multi-agent coordinator mode</li>
-      </ul>
-      <footer class="footer">
-        <span>Clew Code v0.2.7 â€” 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>Hidden Features & Internals â€” Clew</title>
+  <meta name="description" content="Feature-gated commands, internal-only tools, and beta flags in Clew.">
+  <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">
+  <div class="header-inner">
+    <a href="../index.html" class="logo">
+      <span>Clew Code</span>
+    </a>
+    <nav class="header-nav">
+      <a href="../index.html">Home</a>
+      <a href="../index.html#features">Features</a>
+      <a href="../index.html#commands">Commands</a>
+      <a href="../quick-start.html" class="active">Docs</a>
+      <a href="https://github.com/ClewCode/ClewCode" target="_blank">GitHub</a>
+    <div class="lang-wrap">
+    <button class="lang-btn">ðŸŒ</button>
+    <div class="lang-menu">
+      <a href="../../readme/README.zh.md">ä¸æ–‡</a>
+      <a href="../../readme/README.th.md">à¹„à¸—à¸¢</a>
+      <a href="../../readme/README.ja.md">æ—¥æœ¬èªž</a>
+      <a href="../../readme/README.ko.md">í•œêµì–´</a>
+      <a href="../../readme/README.es.md">EspaÃ±ol</a>
+      <a href="../../readme/README.fr.md">FranÃ§ais</a>
+      <a href="../../readme/README.de.md">Deutsch</a>
+      <a href="../../readme/README.pt.md">PortuguÃªs</a>
+      <a href="../../readme/README.vi.md">Tiáº¿ng Viá»‡t</a>
+      <a href="../../readme/README.id.md">Bahasa Indonesia</a>
+      <a href="../../readme/README.ru.md">Ð ÑƒÑÑÐºÐ¸Ð¹</a>
+      <a href="../../readme/README.hi.md">à¤¹à¤¿à¤¨à¥à¤¦à¥€</a>
+      <a href="../../README.md">English</a>
+    </div>
+  </div>
+    </nav>
+    <button class="menu-btn" id="menuToggle" aria-label="Toggle navigation"><span></span><span></span><span></span></button>
+  </div>
+</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><a href="../index.html#features">Internals</a><span class="sep">/</span><span>Hidden Features</span></div>
+      <h1>Hidden Features &amp; Internals</h1>
+      <p class="section-subtitle">Feature-gated commands, internal-only tools, and beta flags â€” not visible in the standard help menu.</p>
+      <div class="callout callout-warn">
+        <strong>Internal / Beta</strong>
+        These features may change without notice. Most require specific environment variables or build-time feature flags.
+      </div>
+      <h2>Feature-Gated Commands</h2>
+      <p>From <code>src/commands.ts</code> â€” enabled via environment variables:</p>
+      <table>
+        <tr><th>Command</th><th>Env Variable</th><th>Description</th></tr>
+        <tr><td><code>/bridge</code></td><td><code>BRIDGE_MODE=1</code></td><td>WebSocket remote control and collaboration</td></tr>
+        <tr><td><code>/voice</code></td><td><code>VOICE_MODE=1</code></td><td>Toggle voice mode</td></tr>
+        <tr><td><code>/brief</code></td><td><code>KAIROS=1</code></td><td>Brief command for quick context</td></tr>
+        <tr><td><code>/assistant</code></td><td><code>KAIROS=1</code></td><td>Assistant mode with proactive behavior</td></tr>
+      </table>
+      <h2>Internal-Only Commands</h2>
+      <p>Defined in <code>INTERNAL_ONLY_COMMANDS</code> in <code>src/commands.ts</code>:</p>
+      <table>
+        <tr><th>Command</th><th>Description</th></tr>
+        <tr><td><code>/backfill-sessions</code></td><td>Backfill session data</td></tr>
+        <tr><td><code>/break-cache</code></td><td>Break internal caches</td></tr>
+        <tr><td><code>/bughunter</code></td><td>Automated bug hunting workflow</td></tr>
+        <tr><td><code>/commit-push-pr</code></td><td>Commit, push, and PR creation</td></tr>
+        <tr><td><code>/ctx-viz</code></td><td>Context visualization</td></tr>
+        <tr><td><code>/init-verifiers</code></td><td>Initialize verifiers</td></tr>
+        <tr><td><code>/issue</code></td><td>Issue management</td></tr>
+        <tr><td><code>/mock-limits</code></td><td>Mock usage limits for testing</td></tr>
+        <tr><td><code>/reset-limits</code></td><td>Reset usage limits</td></tr>
+        <tr><td><code>/ultraplan</code></td><td>Extended plan mode</td></tr>
+        <tr><td><code>/version</code></td><td>Show version</td></tr>
+        <tr><td><code>/bridge-kick</code></td><td>Bridge session management</td></tr>
+        <tr><td><code>/onboarding</code></td><td>Interactive onboarding wizard</td></tr>
+        <tr><td><code>/team-onboarding</code></td><td>Generate teammate ramp-up guide</td></tr>
+        <tr><td><code>/share</code></td><td>Share session</td></tr>
+        <tr><td><code>/summary</code></td><td>Summarize conversation</td></tr>
+        <tr><td><code>/teleport</code></td><td>Teleport session</td></tr>
+        <tr><td><code>/ant-trace</code></td><td>Anthropic-internal tracing</td></tr>
+        <tr><td><code>/perf-issue</code></td><td>Performance issue reporting</td></tr>
+        <tr><td><code>/env</code></td><td>Environment inspection</td></tr>
+        <tr><td><code>/oauth-refresh</code></td><td>OAuth token refresh</td></tr>
+        <tr><td><code>/debug-tool-call</code></td><td>Tool call debugging</td></tr>
+        <tr><td><code>/autofix-pr</code></td><td>Autofix PR workflow</td></tr>
+      </table>
+      <h2>Feature-Gated Tools</h2>
+      <table>
+        <tr><th>Tool</th><th>Flag / Feature</th></tr>
+        <tr><td><code>LSPTool</code></td><td><code>ENABLE_LSP_TOOL=1</code></td></tr>
+        <tr><td><code>ComputerUseTool</code></td><td><code>ENABLE_COMPUTER_USE=1</code> (Windows)</td></tr>
+        <tr><td><code>ToolSearchTool</code></td><td><code>CODE_INDEX</code> feature flag</td></tr>
+        <tr><td><code>EnterWorktreeTool / ExitWorktreeTool</code></td><td>Worktree mode enabled</td></tr>
+        <tr><td><code>PowerShellTool</code></td><td>PowerShell tool enabled in settings</td></tr>
+        <tr><td><code>CronCreateTool / CronDeleteTool / CronListTool</code></td><td><code>AGENT_TRIGGERS</code> feature</td></tr>
+        <tr><td><code>PushNotificationTool</code></td><td><code>KAIROS</code> feature</td></tr>
+        <tr><td><code>REPLTool</code></td><td><code>USER_TYPE=ant</code></td></tr>
+        <tr><td><code>ConfigTool / TungstenTool</code></td><td><code>USER_TYPE=ant</code></td></tr>
+      </table>
+      <h2>Build-Time Feature Flags</h2>
+      <p>Set via <code>--define.FLAG_NAME=true</code> in <code>package.json</code> scripts. Tree-shaken out of builds that don't pass the flag.</p>
+      <table>
+        <tr><th>Flag</th><th>Description</th></tr>
+        <tr><td><code>TRANSCRIPT_CLASSIFIER</code></td><td>Enables &quot;auto&quot; permission mode where Claude uses a transcript-based classifier to decide which tools to auto-approve. Used in dev and release builds.</td></tr>
+        <tr><td><code>CHICAGO_MCP</code></td><td>Enables <strong>Computer Use</strong> — Claude controlling mouse, keyboard, and screen via the <code>@ant/computer-use-mcp</code> protocol. Codename comes from Anthropic's Chicago office. Can also be unlocked at runtime with <code>ENABLE_COMPUTER_USE=1</code>.</td></tr>
+        <tr><td><code>VOICE_MODE</code></td><td>Enables voice input/output support. Present in all build profiles (dev, start, release).</td></tr>
+      </table>
+      <h2>Runtime Features (No Compile-Time Gate)</h2>
+      <p>These features are always compiled in. They are enabled and configured entirely at runtime through environment variables or slash commands — no build-time flag needed.</p>
+      <h3>Clew Gateway (AI Provider Proxy)</h3>
+      <p>A self-hosted AI provider proxy. Run your own gateway instance (e.g. on Cloudflare Workers) and route all LLM calls through it for provider fallback, model routing, and usage tracking across multiple upstream providers.</p>
+      <table>
+        <tr><th>Env Variable</th><th>Description</th></tr>
+        <tr><td><code>CLEW_GATEWAY_URL</code></td><td>Gateway base URL (default: <code>http://localhost:8787/v1</code>)</td></tr>
+        <tr><td><code>CLEW_GATEWAY_KEY</code></td><td>Virtual API key (e.g. <code>clew_live_xxxxx</code>)</td></tr>
+        <tr><td><code>CLEW_MODEL</code></td><td>Optional default model alias (default: <code>clew-code</code>)</td></tr>
+      </table>
+      <p>Supports model listing, streaming, and returns metadata headers (<code>x-clew-provider</code>, <code>x-clew-fallback-used</code>, <code>x-clew-attempts</code>, <code>x-clew-fallback-chain</code>) for debugging. Select it like any other provider via <code>/model</code>.</p>
+      <h3>Ultracode (Dynamic Workflows)</h3>
+      <p>A session-level mode that sets effort to <code>xhigh</code> and lets Claude autonomously decide to spawn dynamic workflows (parallel subtasks + adversarial verifiers) for complex prompts. Based on Anthropic's dynamic-workflows announcement (May 2026). The first workflow in a session shows a token-cost confirmation; subsequent ones run silently.</p>
+      <pre><code>/effort ultracode     # Enable via effort slider (interactive or direct)
+/ultracode on         # Enable ultracode mode for this session
+/ultracode off        # Disable ultracode mode
+/ultracode status     # Show current enabled/confirmed/count state
+/ultracode confirm    # Accept the first-run cost warning
+/ultracode reset      # Clear confirmation + workflow counter
+/ultracode run &lt;p&gt;    # Plan a dynamic workflow for prompt &lt;p&gt;</code></pre>
+      <h2>Runtime Feature Detection</h2>
+      <p>Features are checked via <code>feature('FEATURE_NAME')</code> (compile-time) and <code>isEnvTruthy()</code> (runtime):</p>
+      <ul>
+        <li><code>PROACTIVE</code> / <code>KAIROS</code> â€” Proactive agent behavior</li>
+        <li><code>AGENT_TRIGGERS</code> â€” Scheduled and remote agent triggers</li>
+        <li><code>KAIROS_GITHUB_WEBHOOKS</code> â€” GitHub webhook subscriptions</li>
+        <li><code>KAIROS_PUSH_NOTIFICATION</code> â€” Push notification support</li>
+        <li><code>CONTEXT_COLLAPSE</code> â€” Context collapse inspection</li>
+        <li><code>MCP_SKILLS</code> â€” MCP-provided skills</li>
+        <li><code>CODE_INDEX</code> â€” Code indexing and search</li>
+        <li><code>COORDINATOR_MODE</code> â€” Multi-agent coordinator mode</li>
+      </ul>
+      <footer class="footer">
+        <span>Clew Code 0.2.13 â€” 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>