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/features/evals.th.html DELETED Viewed

@@ -1,62 +0,0 @@
-<!DOCTYPE html>
-<html lang="th">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>การประเมินผล — Clew</title>
-  <meta name="description" content="กรอบงานประเมินและตรวจสอบเอเจนต์เขียนโค้ด AI แบบออฟไลน์">
-  <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&family=Noto+Sans+Thai: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.th.html">หน้าแรก</a><span class="sep">/</span><a href="../index.th.html#features">ฟีเจอร์</a><span class="sep">/</span><span>การประเมินผล</span></div>
-      <h1>กรอบงานประเมินผล</h1>
-      <p class="section-subtitle">กรอบงานประเมินและตรวจสอบเอเจนต์เขียนโค้ด AI แบบออฟไลน์</p>
-      <div class="callout callout-tip">
-        <strong>สรุป</strong>
-        รัน <code>clew eval init</code> เพื่อสร้างโฟลเดอร์ประเมินผลในโปรเจกต์ของคุณ จากนั้นรัน <code>clew eval run</code> เพื่อรันเกณฑ์มาตรฐานการเขียนโค้ดหรือวิจัยในเครื่อง
-      </div>
-      <h2>ภาพรวม</h2>
-      <p>Clew มีกรอบงานประเมินผลแบบออฟไลน์ในตัวภายใต้เนมสเปซคำสั่ง <code>/eval</code> ช่วยให้นักพัฒนาสามารถให้คะแนนคุณภาพผลลัพธ์ของเอเจนต์, ตรวจจับ regression ในร่องรอย, และเปรียบเทียบเวอร์ชันโมเดล</p>
-      <h2>การใช้งาน CLI</h2>
-      <h3>1. เริ่มต้น Workspace</h3>
-      <pre><code>claude eval init</code></pre>
-      <h3>2. รันการประเมิน</h3>
-      <pre><code># รันงานทั้งหมด
-claude eval run
-# รันเฉพาะหมวด "coding"
-claude eval run --set coding
-# รันงานเฉพาะ
-claude eval run --task coding.sample-task</code></pre>
-      <h3>3. เปรียบเทียบ Drift และ Regression</h3>
-      <pre><code>claude eval compare --baseline main</code></pre>
-      <footer class="footer">
-        <span>Clew Code 0.2.14</span>
-        <div class="footer-links">
-          <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
-          <a href="https://github.com/ClewCode/ClewCode/issues">ปัญหา</a>
-        </div>
-      </footer>
-    </main>
-    <nav class="toc-sidebar"></nav>
-  </div>
-</div>
-<script src="../js/main.js"></script>
-</body>
-</html>

package/docs/features/searxng-search.th.html DELETED Viewed

@@ -1,67 +0,0 @@
-<!DOCTYPE html>
-<html lang="th">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>ค้นหา SearXNG — Clew</title>
-  <meta name="description" content="ค้นหาเว็บแบบโฮสต์เองที่เคารพความเป็นส่วนตัวผ่าน Docker SearXNG">
-  <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&family=Noto+Sans+Thai: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.th.html">หน้าแรก</a><span class="sep">/</span><a href="../index.th.html#features">ฟีเจอร์</a><span class="sep">/</span><span>ค้นหา SearXNG</span></div>
-      <h1>ค้นหา SearXNG</h1>
-      <p class="section-subtitle">ค้นหาเว็บแบบโฮสต์เองที่เคารพความเป็นส่วนตัวผ่าน Docker</p>
-      <div class="callout callout-tip">
-        <strong>สรุป</strong>
-        รัน <code>cd searxng && start.bat</code> เพื่อเริ่มเครื่องมือค้นหา จากนั้นใช้ <code>/searxng on</code> จาก CLI
-      </div>
-      <h2>ภาพรวม</h2>
-      <p>SearXNG คือเครื่องมือค้นหาเมตาฟรีที่เคารพความเป็นส่วนตัว โปรเจกต์นี้มีการตั้งค่าแบบ Docker เพื่อให้คุณรันอินสแตนซ์ของคุณเองในเครื่อง</p>
-      <h2>เริ่มต้นใช้งาน</h2>
-      <pre><code>cd searxng
-start.bat</code></pre>
-      <p>เริ่ม SearXNG ที่ <a href="http://localhost:18889">http://localhost:18889</a></p>
-      <h3>คำสั่ง Slash</h3>
-      <table>
-        <tr><th>คำสั่ง</th><th>การทำงาน</th></tr>
-        <tr><td><code>/searxng on</code></td><td>เริ่ม Docker container</td></tr>
-        <tr><td><code>/searxng off</code></td><td>หยุด Docker container</td></tr>
-        <tr><td><code>/searxng status</code></td><td>ตรวจสอบว่ากำลังรันอยู่</td></tr>
-      </table>
-      <h2>วิธีการทำงาน</h2>
-      <ol>
-        <li>SearXNG รันใน Docker ที่ <code>localhost:18889</code></li>
-        <li><code>.env</code> ของโปรเจกต์ตั้งค่า <code>SEARXNG_INSTANCE_URL=http://localhost:18889</code></li>
-        <li><code>selectBestDirectProvider()</code> ใน <code>WebSearchTool.ts</code> ตรวจจับอัตโนมัติและให้ความสำคัญ SearXNG</li>
-      </ol>
-      <footer class="footer">
-        <span>Clew Code 0.2.14</span>
-        <div class="footer-links">
-          <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
-          <a href="https://github.com/ClewCode/ClewCode/issues">ปัญหา</a>
-        </div>
-      </footer>
-    </main>
-    <nav class="toc-sidebar"></nav>
-  </div>
-</div>
-<script src="../js/main.js"></script>
-</body>
-</html>

package/docs/features/sentry-setup.th.html DELETED Viewed

@@ -1,69 +0,0 @@
-<!DOCTYPE html>
-<html lang="th">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Sentry การรายงานข้อผิดพลาด — Clew</title>
-  <meta name="description" content="Sentry crash/error telemetry แบบ opt-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&family=Noto+Sans+Thai: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.th.html">หน้าแรก</a><span class="sep">/</span><a href="../index.th.html#features">ฟีเจอร์</a><span class="sep">/</span><span>Sentry Setup</span></div>
-      <h1>Sentry การรายงานข้อผิดพลาด</h1>
-      <p class="section-subtitle">ระบบรายงาน crash และ error แบบ opt-in — <strong>ปิดโดยสมบูรณ์เป็นค่าเริ่มต้น</strong> ไม่มีข้อมูลออกจากเครื่องของคุณเว้นแต่คุณจะตั้งค่า <code>SENTRY_DSN</code></p>
-      <div class="callout callout-tip">
-        <strong>สรุป</strong>
-        <code>SENTRY_DSN=https://key@sentry.io/123 claude</code> — เท่านั้น หากไม่มี, ไม่มีการร้องขอเครือข่าย, ไม่มี telemetry
-      </div>
-      <h2>เริ่มต้นใช้งาน</h2>
-      <h3>Sentry แบบโฮสต์เอง</h3>
-      <pre><code>SENTRY_DSN=https://public_key@your-sentry.example.com/123 claude</code></pre>
-      <h3>Sentry Cloud</h3>
-      <pre><code>SENTRY_DSN=https://public_key@o123456.ingest.sentry.io/789 claude</code></pre>
-      <h2>สิ่งที่ถูกส่ง</h2>
-      <p>เฉพาะข้อมูลเมตาของข้อผิดพลาด — <strong>ไม่เคยส่ง prompts, คำตอบ, เนื้อหาไฟล์, หรือผลลัพธ์คำสั่ง</strong>:</p>
-      <ul>
-        <li>ชื่อ, ข้อความ, และ stack trace ของข้อผิดพลาด</li>
-        <li>ข้อมูลรันไทม์: แพลตฟอร์ม OS, เวอร์ชัน Node/Bun</li>
-        <li>โหมด: REPL, ไม่โต้ตอบ, เซิร์ฟเวอร์ MCP</li>
-        <li>ชื่อผู้ให้บริการและโมเดล</li>
-      </ul>
-      <h2>เครื่องมือขจัดข้อมูลส่วนตัว</h2>
-      <p>ทุกเหตุการณ์ผ่านฮุค <code>beforeSend</code> ที่:</p>
-      <ol>
-        <li><strong>ล้างสตริง</strong> — ลบรูปแบบคีย์ API, ส่วนหัว auth, ค่า cookie</li>
-        <li><strong>ลบตัวแปร stack frame</strong></li>
-        <li><strong>ล้างข้อมูลคำขอ</strong> — ลบส่วนหัว, cookies, query strings</li>
-        <li><strong>ตัดสตริงที่ใหญ่เกิน</strong> — เกิน 2000 ตัวอักษรถูกตัด</li>
-      </ol>
-      <footer class="footer">
-        <span>Clew Code 0.2.14</span>
-        <div class="footer-links">
-          <a href="https://github.com/ClewCode/ClewCode">GitHub</a>
-          <a href="https://github.com/ClewCode/ClewCode/issues">ปัญหา</a>
-        </div>
-      </footer>
-    </main>
-    <nav class="toc-sidebar"></nav>
-  </div>
-</div>
-<script src="../js/main.js"></script>
-</body>
-</html>

package/docs/features/swarm.html DELETED Viewed

@@ -1,156 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Swarm — LAN Swarm Coordination — Clew</title>
-  <meta name="description" content="LAN swarm discovery, task delegation, and autonomous AI swarm coordination 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"></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>›</span>
-        <span>Swarm Coordination</span>
-      </div>
-      <h1>Swarm Coordination</h1>
-      <p>
-        Clew supports LAN swarm discovery and task delegation, enabling a lead-worker model
-        where one instance can coordinate multiple worker instances (swarm nodes) on the same network.
-      </p>
-      <h2>Architecture</h2>
-      <p>
-        Each swarm node runs a lightweight HTTP server (PeerServer) on a random port.
-        Discovery uses UDP multicast broadcast (239.255.37.37:42069) plus a file-based
-        registry (<code>~/.clew/peers/</code>) for same-machine instances.
-      </p>
-      <pre><code>Node A (Lead)                    Node B (Worker)
-  |                                |
-  |--- UDP multicast query ------->|
-  |<--- response (host, port, cwd)-|
-  |                                |
-  |--- HTTP POST /peer-todo ------>|  Assign task
-  |--- HTTP POST /peer-exec ------>|  Run command
-  |<--- response ------------------|  Return result</code></pre>
-      <h2>Getting Started</h2>
-      <h3>Worker Setup</h3>
-      <pre><code># Start sharing (advertise on LAN)
-/swarm share
-# Set display name and role
-/swarm name Build Server
-/swarm role builder</code></pre>
-      <h3>Lead Setup</h3>
-      <pre><code># Discover available swarm nodes
-/swarm discover
-# Join a specific node by port
-/swarm join 127.0.0.1:59421
-# View connected swarm nodes
-/swarm list</code></pre>
-      <h3>Assign Tasks</h3>
-      <pre><code># Direct task assignment
-/swarm todo Build-Server "run the test suite"
-# Let the AI handle it
-> Assign a task to the build server to run all tests</code></pre>
-      <h2>Commands</h2>
-      <table>
-        <thead>
-          <tr><th>Command</th><th>Description</th></tr>
-        </thead>
-        <tbody>
-          <tr><td><code>/swarm</code></td><td>Open interactive swarm menu</td></tr>
-          <tr><td><code>/swarm share</code></td><td>Start advertising as a worker</td></tr>
-          <tr><td><code>/swarm share stop</code></td><td>Stop advertising</td></tr>
-          <tr><td><code>/swarm discover</code></td><td>Scan LAN for swarm nodes (5s timeout)</td></tr>
-          <tr><td><code>/swarm join &lt;port&gt;</code></td><td>Connect to a swarm node by port or host:port</td></tr>
-          <tr><td><code>/swarm list</code></td><td>Open interactive swarm node list</td></tr>
-          <tr><td><code>/swarm todo &lt;node&gt; &lt;task&gt;</code></td><td>Assign a task to a worker node</td></tr>
-          <tr><td><code>/swarm todos</code></td><td>View received tasks</td></tr>
-          <tr><td><code>/swarm todo done &lt;id&gt;</code></td><td>Mark task as complete</td></tr>
-          <tr><td><code>/swarm name &lt;name&gt;</code></td><td>Set your display name</td></tr>
-          <tr><td><code>/swarm role &lt;role&gt;</code></td><td>Set your role (e.g., builder, tester)</td></tr>
-          <tr><td><code>/swarm inbox</code></td><td>View pending messages</td></tr>
-          <tr><td><code>/swarm spawn [options]</code></td><td>Spawn a new swarm node shell terminal</td></tr>
-          <tr><td><code>/swarm help</code></td><td>Show help</td></tr>
-        </tbody>
-      </table>
-      <h2>AI Swarm Tools</h2>
-      <p>
-        Clew AI can autonomously coordinate swarm nodes using these tools:
-      </p>
-      <table>
-        <thead>
-          <tr><th>Tool</th><th>Description</th></tr>
-        </thead>
-        <tbody>
-          <tr><td><code>peer_discover</code></td><td>Scan for swarm workers on LAN and same machine</td></tr>
-          <tr><td><code>peer_join</code></td><td>Connect to a remote swarm node by host:port</td></tr>
-          <tr><td><code>peer_send_task</code></td><td>Assign a task to a worker via HTTP POST</td></tr>
-          <tr><td><code>peer_list_tasks</code></td><td>Check pending and completed tasks</td></tr>
-          <tr><td><code>peer_list_roles</code></td><td>List all swarm nodes with names, roles, and IPs</td></tr>
-          <tr><td><code>peer_run</code></td><td>Execute a shell command on a remote worker</td></tr>
-          <tr><td><code>peer_share</code></td><td>Start or stop advertising as a worker</td></tr>
-          <tr><td><code>peer_info</code></td><td>Get detailed info about a specific swarm node</td></tr>
-          <tr><td><code>peer_set_name</code></td><td>Set display name for a swarm node</td></tr>
-          <tr><td><code>peer_set_role</code></td><td>Set role for a swarm node</td></tr>
-        </tbody>
-      </table>
-      <h2>Protocol</h2>
-      <p>Discovery uses UDP multicast on <code>239.255.37.37:42069</code>. Node info is broadcast every 30 seconds. Nodes are evicted after 90 seconds of inactivity.</p>
-      <p>Communication uses HTTP POST to registered node endpoints:</p>
-      <table>
-        <thead>
-          <tr><th>Endpoint</th><th>Method</th><th>Description</th></tr>
-        </thead>
-        <tbody>
-          <tr><td><code>/peer-info</code></td><td>GET</td><td>Get node metadata (host, port, cwd, name, role)</td></tr>
-          <tr><td><code>/peer-todo</code></td><td>POST</td><td>Accept inbound task assignment</td></tr>
-          <tr><td><code>/peer-msg</code></td><td>POST</td><td>Accept inbound message</td></tr>
-          <tr><td><code>/peer-exec</code></td><td>POST</td><td>Accept shell command execution</td></tr>
-        </tbody>
-      </table>
-      <!-- ─── Footer ─── -->
-      <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>
-  </div>
-</div>
-<script src="../js/main.js"></script>
-</body>
-</html>