truecourse 0.6.0-next.11 → 0.6.0-next.12

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 (4) hide show
  1. package/README.md +4 -1
  2. package/cli.mjs +5964 -5948
  3. package/package.json +1 -1
  4. package/server.mjs +1858 -1718
package/README.md CHANGED
@@ -332,13 +332,16 @@ TrueCourse talks to Claude Code via the `claude` CLI. You can tune how that inte
332
332
  For packaged installs (`npx truecourse` or `npm install -g truecourse`), the simplest place to set them is `~/.truecourse/.env`. The file is loaded automatically on every invocation:
333
333
 
334
334
  ```
335
- CLAUDE_CODE_BINARY=claude # override the `claude` binary on PATH
335
+ CLAUDE_CODE_BINARY=claude # override the `claude` binary on PATH (CLAUDE_CODE_BIN also accepted)
336
336
  CLAUDE_CODE_MODEL= # Claude Code --model flag (empty = default)
337
337
  CLAUDE_CODE_TIMEOUT_MS=120000 # per-call timeout (ms)
338
338
  CLAUDE_CODE_MAX_RETRIES=2 # retry attempts on parse/validation failure
339
339
  CLAUDE_CODE_MAX_CONCURRENCY=10 # max concurrent `claude` processes per run
340
+ TRUECOURSE_SKIP_CLAUDE_CHECK= # set to 1 to skip the up-front `claude` login preflight
340
341
  ```
341
342
 
343
+ Every command that uses Claude (`analyze` with LLM rules, `spec scan`, `spec resolve`, `contracts generate`) runs a quick up-front preflight: it makes one tiny `claude` call to confirm the CLI is installed and logged in, and aborts with the CLI's own error message if not — so an expired login is caught immediately instead of failing every extraction subprocess at the end of a long run. Set `TRUECOURSE_SKIP_CLAUDE_CHECK=1` to skip it (e.g. on CI where auth is known good). `CLAUDE_CODE_BINARY` is the canonical way to point at a non-default binary; `CLAUDE_CODE_BIN` is honored as a legacy alias.
344
+
342
345
  **`CLAUDE_CODE_MAX_CONCURRENCY`** caps how many Claude CLI processes TrueCourse spawns in parallel during a single run. Default `10`. Raise it on CI runners with spare headroom; lower it on resource-constrained machines (e.g. 8 GB laptops, shared VMs) to avoid OOM on large repos. Must be a positive integer.
343
346
 
344
347
  For a one-off override, prefix the command: