clew-code 0.6.1 → 0.6.2
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.
- package/README.md +36 -36
- package/dist/main.js +2354 -2329
- package/docs/architecture/provider-system.md +0 -9
- package/package.json +33 -41
package/README.md
CHANGED
|
@@ -346,37 +346,43 @@ Also available on the [GitHub Wiki](https://github.com/ClewCode/ClewCode/wiki).
|
|
|
346
346
|
## Architecture
|
|
347
347
|
|
|
348
348
|
```
|
|
349
|
-
┌─ REPL
|
|
350
|
-
│ Ink + React 19
|
|
351
|
-
│ Slash commands / skills
|
|
352
|
-
│ Streaming / history
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
│
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
│
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
349
|
+
┌─ REPL ──────────────────────────────────┐
|
|
350
|
+
│ Ink + React 19 ┌──────┐ │
|
|
351
|
+
│ Slash commands / skills │Tools │ │
|
|
352
|
+
│ Streaming / history │ x76 │ │
|
|
353
|
+
│ state/AppState.tsx └──┬───┘ │
|
|
354
|
+
└────────┬─────────────────────────┘ │
|
|
355
|
+
│ ▲ │
|
|
356
|
+
▼ │ │
|
|
357
|
+
┌─ QueryEngine ───────────┴──────────────┘
|
|
358
|
+
│ Streaming · tool loop · compaction
|
|
359
|
+
│ Checkpoints · Max Mode · /rewind
|
|
360
|
+
│
|
|
361
|
+
│ query.ts (non-streaming: subagents)
|
|
362
|
+
└──┬────┬────┬────┬────┬────┬────┐
|
|
363
|
+
▼ ▼ ▼ ▼ ▼ ▼ ▼
|
|
364
|
+
┌────┐┌────┐┌────┐┌────┐┌────┐┌──────────┐
|
|
365
|
+
│ MCP││LSP ││Git ││Web ││Task││ Provider │
|
|
366
|
+
│ ││ ││ ││ ││ ││ Manager │
|
|
367
|
+
└────┘└────┘└────┘└────┘└────┘└──────────┘
|
|
368
|
+
│ LAN │ │
|
|
369
|
+
▼ ▼ ▼ ▼
|
|
370
|
+
┌──────┐┌─────────┐┌──────────┐┌──────────┐
|
|
371
|
+
│ vec ││ Peer ││ Agent ││ Agent │
|
|
372
|
+
│Memory││ Server ││Runtime ││ Subagent │
|
|
373
|
+
└──────┘└─────────┘└──────────┘└──────────┘
|
|
374
|
+
│ Autonomous task queue + cron + DA │
|
|
375
|
+
└──────────────────────────────────────────┘
|
|
370
376
|
```
|
|
371
377
|
|
|
372
378
|
- **Entry**: `src/main.tsx` → `src/replLauncher.tsx` boots the Ink/React 19 REPL
|
|
373
379
|
- **REPL screen**: `src/screens/REPL.tsx` routes input to commands or the query engine
|
|
374
|
-
- **Query
|
|
380
|
+
- **Query paths**: `src/QueryEngine.ts` (streaming with tool loop) + `src/query.ts` (non-streaming for subagents, background tasks)
|
|
375
381
|
- **Providers**: `src/services/ai/` — 32 providers behind one interface, normalized errors/usage
|
|
376
|
-
- **Tools**: `src/tools/<ToolName>/`,
|
|
377
|
-
- **Services**: `src/services/` — MCP client, autonomous
|
|
382
|
+
- **Tools**: `src/tools/<ToolName>/`, 76 tool packages extending `Tool`, registered in `src/tools.ts`
|
|
383
|
+
- **Services**: `src/services/` — MCP client, autonomous queue, vec memory, session search, plugins, LSP, voice, audit log, and more
|
|
378
384
|
|
|
379
|
-
Full detail, including
|
|
385
|
+
Full detail, including tool inventory and service list: [AGENT.md](AGENT.md).
|
|
380
386
|
|
|
381
387
|
---
|
|
382
388
|
|
|
@@ -390,10 +396,10 @@ bun run dev # Live-reload REPL (with feature flags)
|
|
|
390
396
|
bun run dev:channels # Dev with development channels loaded
|
|
391
397
|
bun run build # Production build to dist/
|
|
392
398
|
bun run start # Run the compiled build
|
|
393
|
-
bun test #
|
|
399
|
+
bun test # Full suite (vitest-compatible runner)
|
|
394
400
|
bun test --bail # Stop on first failure
|
|
395
|
-
|
|
396
|
-
|
|
401
|
+
bun test path/to/file.test.ts # Single file
|
|
402
|
+
bun test -t "test name" # By test name
|
|
397
403
|
bun run check:ci # Biome lint + format check (no autofix)
|
|
398
404
|
bun run lint # Biome lint with autofix
|
|
399
405
|
bun run check # Lint + format with autofix
|
|
@@ -408,15 +414,9 @@ bun run check:ci && bun x tsc --noEmit && bun test --bail
|
|
|
408
414
|
|
|
409
415
|
Or run the `/clew-verify` skill, which runs the full gate and a real CLI smoke test — green tests alone don't prove an Ink TUI feature actually works.
|
|
410
416
|
|
|
411
|
-
### ✅ Shadow `.js` Files — Resolved
|
|
412
|
-
|
|
413
|
-
The JS→TS migration is complete. All 401 `.js` shadow files that sat alongside `.ts`/`.tsx` twins have been removed. **Zero shadow pairs remain** — the `/js-shadow-sync` skill has been removed.
|
|
414
|
-
|
|
415
|
-
Any `.js` file still in `src/` is a genuine JS source module (no `.ts` twin exists).
|
|
416
|
-
|
|
417
417
|
### Release
|
|
418
418
|
|
|
419
|
-
Pushing a `v*` tag triggers the GitHub Actions release and npm publish. Before tagging: bump `package.json`, update `CHANGELOG.md`, run the full gate above. See [
|
|
419
|
+
Pushing a `v*` tag triggers the GitHub Actions release and npm publish. Before tagging: bump `package.json`, update `CHANGELOG.md`, run the full gate above. See [AGENT.md § Release](AGENT.md#release) or run the `/clew-release` skill.
|
|
420
420
|
|
|
421
421
|
---
|
|
422
422
|
|
|
@@ -426,7 +426,7 @@ Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines
|
|
|
426
426
|
|
|
427
427
|
- Report bugs via [GitHub Issues](https://github.com/ClewCode/ClewCode/issues)
|
|
428
428
|
- Discuss ideas in [GitHub Discussions](https://github.com/ClewCode/ClewCode/discussions)
|
|
429
|
-
- Read [
|
|
429
|
+
- Read [AGENT.md](AGENT.md) for full architecture and code conventions
|
|
430
430
|
|
|
431
431
|
---
|
|
432
432
|
|