@tech-leads-club/harness-toolkit 0.16.2 → 0.16.4

package/README.md

@@ -448,11 +448,15 @@ Healthy install checklist:
 
 ```mermaid
 graph LR
-    EV["provider event<br/><i>Cursor or Claude Code hook</i>"]
-    HK["user-level hook file"]
-    LX["bin/tlc-exec.mjs &lt;handler&gt;<br/><i>Bun first, Node + dist fallback</i>"]
-    EP["src/entrypoints/&lt;handler&gt;.ts<br/><i>core + resolved adapter</i>"]
-    OUT["follow-up · handoff · observability<br/><i>under project policy</i>"]
+    EV["`provider event
+    *Cursor or Claude Code hook*`"]
+    HK["`user-level hook file`"]
+    LX["`bin/tlc-exec.mjs #60;handler#62;
+    *Bun first, Node + dist fallback*`"]
+    EP["`src/entrypoints/#60;handler#62;.ts
+    *core + resolved adapter*`"]
+    OUT["`follow-up · handoff · observability
+    *under project policy*`"]
     EV --> HK --> LX --> EP --> OUT
 ```
 
@@ -482,7 +486,7 @@ See `tlc harness help architecture` or [`docs/architecture.md`](docs/architectur
 | `tlc harness build` | Compile `dist/` for the Node fallback path |
 | `tlc harness test` | Run the full local gate |
 | `tlc harness grind [on\|off]` | Lint/test follow-ups on stop |
-| `tlc harness pause` / `resume` | Disable / enable stop checks |
+| `tlc harness pause` / `resume` | Circuit breaker: every hook steps aside except the floor / back on |
 | `tlc harness mode solo\|paired\|focus` | Operator posture |
 | `tlc harness attest` | Tamper-evident record of what each session ran under |
 | `tlc harness handoff` | Handoff state between turns and sessions — the sanctioned reader |

package/bin/tlc-cli.ts

@@ -116,7 +116,7 @@ export function statusScreen(root: string): Screen {
           },
           {
             label: "gates",
-            value: report.gatesPaused ? "PAUSED — stop checks disabled" : "active",
+            value: report.gatesPaused ? "PAUSED — every hook steps aside; only the floor runs" : "active",
             level: report.gatesPaused ? "warn" : "ok",
           },
         ],
@@ -185,13 +185,13 @@ export function setPaused(root: string, on: boolean): string {
   if (on) {
     writeFileSync(path, "");
     coreFacade.policy.refreshPolicyBaselines(root);
-    return "gates PAUSED — stop checks disabled until `tlc harness resume`";
+    return "harness PAUSED — every hook steps aside (only the floor still runs) until `tlc harness resume`";
   }
   if (existsSync(path)) {
     rmSync(path);
   }
   coreFacade.policy.refreshPolicyBaselines(root);
-  return "gates ACTIVE again";
+  return "harness ACTIVE again";
 }
 
 /**

package/bin/tlc-exec.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
-import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync, writeSync } from "node:fs";
 import { homedir } from "node:os";
 import { delimiter, dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -235,8 +235,10 @@ export function decideRuntime({ harnessHome, entry, bunPath, nodeMajor, distExis
 }
 
 function run(harnessHome, command, commandArgs, origin = harnessHome, entry = "") {
+  const isHook = HOOK_ENTRIES.has(entry);
   const result = spawnSync(command, commandArgs, {
-    stdio: "inherit",
+    stdio: isHook ? ["inherit", "pipe", "inherit"] : "inherit",
+    maxBuffer: 64 * 1024 * 1024,
     // why: `TLC_ORIGIN` is where this copy physically lives, which is not `TLC_HOME` once an npm-installed shim
     // is driving the runtime installed under the conventional path. `tlc harness install` needs the former as
     // its source and the latter as its destination, and nothing else in the runtime reads it.
@@ -259,6 +261,16 @@ function run(harnessHome, command, commandArgs, origin = harnessHome, entry = ""
     }
     process.exit(127);
   }
+  if (isHook) {
+    const stdout = result.stdout ?? Buffer.alloc(0);
+    if (stdout.toString("utf8").trim() === "") {
+      console.error(
+        `tlc: ${entry} produced no verdict (exit ${result.status ?? result.signal}); carrying on without one.`,
+      );
+      carryOn();
+    }
+    writeSync(1, stdout);
+  }
   process.exit(result.status ?? 1);
 }