kc-beta 0.7.3 → 0.8.1

package/README.md

@@ -21,12 +21,59 @@ npm install -g kc-beta
 kc-beta onboard      # configure provider + API key
 cd my-project        # a folder containing rules/ and samples/
 kc-beta              # launch the agent
+
+# v0.8.1+ unattended runs: type the slash command inside the kc-beta TUI
+> /marathon Verify the new regulation against samples/. Iterate twice. If
+  most workflows work with regex, build another version using tier1+tier2
+  worker LLMs more aggressively.
+# Marathon mode chains turns automatically. /marathon off disengages.
+# /marathon status shows the driver state.
 ```
 
 Requires **Node.js 20+**. See [QUICKSTART.md](./QUICKSTART.md) for the full setup walkthrough.
 
 ---
 
+## v0.8 Highlights
+
+- **`/marathon <goal>` slash command** (v0.8.1; replaces the v0.8.0
+  separate-process `kc-marathon` CLI). Activates an inline driver inside
+  the running kc-beta TUI. Goal embedded in the command. `/marathon off`
+  to disengage manually; `/marathon status` to inspect. F5
+  one-phase-per-prompt stays enabled for interactive sessions and
+  bypasses cleanly when marathon is active. Status-bar shows
+  `🏃 MARATHON` only when active — no clutter in normal mode. v0.8.0's
+  separate-process driver was scrapped after E2E #11 found drivers
+  died silently when their parent terminal closed (SIGHUP unhandled).
+- **Skill usage counter** — passive Layer-B measurement of which skills
+  the engine actually ships to the LLM. `skill_byte_send` events go to
+  events.jsonl; the audit script aggregates per-phase × per-skill.
+  Agent-blind by design.
+- **`worker_llm_call` batch mode** — `prompts: [...]` array input with
+  concurrency control (default 5, max 10). Pairs with a canonical
+  `workflows/common/llm_client.py` shim (taught in `skill-to-workflow`)
+  so distilled workflows route through the engine where possible and
+  log to `output/llm_ledger.jsonl` when they don't.
+- **`sandbox_exec` timeout model** — default 120s (was 30s); per-call
+  `timeout_ms` up to 600s for known-slow commands. Configurable via
+  `KC_EXEC_DEFAULT_TIMEOUT_MS` + `KC_EXEC_MAX_TIMEOUT_MS`.
+- **Prescriptive phase-advance hints** — refusal messages now name
+  concrete next-action artifacts (`workflows/<rule_id>/workflow_v1.py`,
+  `output/results/production_qc_results.json`, etc.) instead of
+  descriptive `engineCounts` only.
+- **`check.py` substantiveness audit** — engine detects stub-shaped
+  rule_skills/<id>/check.py files (NOT_APPLICABLE-only returns with no
+  workflow delegation). Surfaced in milestones; opt-in enforcement via
+  `KC_ENFORCE_CHECK_PY_SUBSTANTIVE=1`.
+
+Plus engine-fix carryover from the v0.7.5 audit cycle: H3 calibration
+aggregator schema, milestone-derivation gaps (review_001.json + multi-
+path coverage_report.md), VLM runtime hardcode (workspace .env overlay),
+heap_mb periodic-write fix, stale release detection, taskboard skill
+availability in every phase. Full list: see DEV_LOG v0.8 entry.
+
+---
+
 ## What It Does
 
 KC drives a single coding agent through seven phases:
@@ -216,8 +263,8 @@ Quality Thresholds, Language.
 
 ## Status
 
-**v0.7.3 — codex review patch release.** Latest line in the v0.7.x
-hardening track. Architectural payload from v0.6.0+ is still in place:
+**v0.7.4 — phase-control fix + codex review re-attempt.** Architectural
+payload from v0.6.0+ is still in place:
 
 - Parallel ralph-loop (up to 8 concurrent workers) with a heap-safety
   conformance gate
@@ -226,8 +273,14 @@ hardening track. Architectural payload from v0.6.0+ is still in place:
 - Agent-owned task board: the agent reads the rule list from
   `describeState`, decides decomposition (per-rule / grouped / range),
   and calls `TaskCreate` / `TaskUpdate` / `TaskComplete` to drive the
-  Ralph loop. Source-context auto-attach pulls rule NL + evidence chunks
-  + sibling rules into the prompt of each task as it runs.
+  Ralph loop **within the current phase only** (v0.7.4). Source-context
+  auto-attach pulls rule NL + evidence chunks + sibling rules into each
+  task's prompt.
+- Phase boundaries = user checkpoints: the Ralph loop exits at every
+  phase transition, returning control to the user. The engine doesn't
+  auto-advance; phase advance is explicit (agent's `phase_advance` tool
+  call or user re-prompt). Marathon-style end-to-end autonomy lives
+  outside the engine.
 - Workspace file locking for shared coordination files (`rules/catalog.json`,
   `rules/manifest.json`, `refs/manifest.json`, `tasks.json`,
   `session-state.json`) — every writer goes through `withFileLock`.

package/bin/kc-beta.js

@@ -34,17 +34,31 @@ if (parallelismOverride !== null) {
 // their own output.
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-function printBanner() {
+function readPkgVersion() {
   try {
     const pkg = JSON.parse(readFileSync(resolve(__dirname, "..", "package.json"), "utf-8"));
-    const scriptPath = __filename;
-    process.stderr.write(`⏵⏵  KC Agent CLI  v${pkg.version}  ·  ${scriptPath}\n`);
-  } catch { /* package.json missing or unreadable — silent */ }
+    return pkg.version || "unknown";
+  } catch { return "unknown"; }
+}
+function printBanner() {
+  try {
+    const v = readPkgVersion();
+    process.stderr.write(`⏵⏵  KC Agent CLI  v${v}  ·  ${__filename}\n`);
+  } catch { /* silent */ }
 }
-const suppressBanner = args.includes("--version") || args.includes("-v") ||
-                       args.includes("--help") || args.includes("-h");
+const isVersion = args.includes("--version") || args.includes("-v");
+const isHelp = args.includes("--help") || args.includes("-h");
+const suppressBanner = isVersion || isHelp;
 if (!suppressBanner) printBanner();
 
+// v0.7.5 G-F1: `--version` prints version and exits. Previously the flag
+// suppressed the banner but fell through to TUI launch (audit confirmed
+// during v0.7.4 testing). Print + exit before the subcommand dispatch.
+if (isVersion) {
+  process.stdout.write(`${readPkgVersion()}\n`);
+  process.exit(0);
+}
+
 (async () => {
   if (subcommand === "onboard" || subcommand === "setup") {
     const { onboard } = await import("../src/cli/onboard.js");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kc-beta",
-  "version": "0.7.3",
+  "version": "0.8.1",
   "description": "KC Agent — LLM document verification agent (pure Node.js CLI). Dual-licensed: PolyForm Noncommercial 1.0.0 for personal/noncommercial use; commercial license required for enterprise production. See LICENSE and LICENSE-COMMERCIAL.md.",
   "type": "module",
   "bin": {
@@ -18,7 +18,8 @@
   ],
   "scripts": {
     "build:meme": "node scripts/build-meme.js",
-    "prepublishOnly": "node scripts/build-meme.js"
+    "prepublishOnly": "node scripts/build-meme.js",
+    "test": "node scripts/run-tests.js"
   },
   "homepage": "https://github.com/kitchen-engineer42/kc-cli",
   "repository": {