truecourse 0.6.0-next.10 → 0.6.0-next.11
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 +1 -25
- package/cli.mjs +6852 -6483
- package/package.json +1 -1
- package/server.mjs +1236 -1085
package/README.md
CHANGED
|
@@ -323,31 +323,7 @@ The first `truecourse analyze` (or `truecourse add`) in a fresh repo asks whethe
|
|
|
323
323
|
## Prerequisites
|
|
324
324
|
|
|
325
325
|
- Node.js >= 20
|
|
326
|
-
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI on your PATH
|
|
327
|
-
|
|
328
|
-
## LLM transport (`--llm-transport`)
|
|
329
|
-
|
|
330
|
-
Every LLM-powered step — `analyze`'s LLM rules, and the whole Spec → Verify pipeline (`spec scan`, `spec resolve`, `contracts generate`) — reaches the model through a pluggable **transport**, chosen with `--llm-transport`:
|
|
331
|
-
|
|
332
|
-
| Mode | How it reaches the model | Needs |
|
|
333
|
-
|---|---|---|
|
|
334
|
-
| **`cli`** *(default)* | spawns `claude -p …` per call | the `claude` binary on PATH, signed in. No API key. |
|
|
335
|
-
| **`agent`** | a **filesystem mailbox** under `--io <dir>` | nothing — no `claude` binary, no API key |
|
|
336
|
-
|
|
337
|
-
In **`agent`** mode the tool doesn't call the model itself: for each prompt it writes `requests/<id>.json` (`{ stage, system, user, schema, … }`) into the `--io` directory and waits for a matching `responses/<id>.json` (`{ text }`). An **orchestrating agent that is itself an LLM** — e.g. a [Claude Code routine](https://code.claude.com/docs/en/routines) — watches that directory and answers each prompt. This lets contract generation and `analyze`'s LLM rules run **inside a headless cloud session with no `claude` binary and no API key**.
|
|
338
|
-
|
|
339
|
-
```bash
|
|
340
|
-
# default: spawn the claude CLI
|
|
341
|
-
truecourse analyze --llm
|
|
342
|
-
truecourse contracts generate
|
|
343
|
-
|
|
344
|
-
# agent transport: the tool parks prompts in ./io and an external agent answers them
|
|
345
|
-
truecourse analyze --llm --llm-transport agent --io ./io
|
|
346
|
-
truecourse spec scan --llm-transport agent --io ./io
|
|
347
|
-
truecourse contracts generate --llm-transport agent --io ./io
|
|
348
|
-
```
|
|
349
|
-
|
|
350
|
-
Accepted by: `analyze`, `spec scan`, `spec resolve`, `contracts generate`. (On `analyze`, `--llm` / `--no-llm` is a *separate* flag — it decides **whether** LLM rules run; `--llm-transport` decides **how** to reach the model.) Both modes send identical prompts and parse identical schema-validated JSON — only the delivery differs.
|
|
326
|
+
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI on your PATH. Deterministic rules run without it; LLM-powered rules and the Spec → Verify pipeline need it.
|
|
351
327
|
|
|
352
328
|
## Configuration
|
|
353
329
|
|