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

package/docs/architecture.md

@@ -20,13 +20,18 @@ Global does the work. Project only configures *this* repo. Do not copy `~/.tlc/h
 ```mermaid
 graph LR
     subgraph one["One machine"]
-        R["~/.tlc/harness<br/><i>runtime, CLI, hooks</i>"]
-        CU["cursor config<br/><i>hooks.json</i>"]
-        CL["claude config<br/><i>settings.json</i>"]
+        R["`~/.tlc/harness
+        *runtime, CLI, hooks*`"]
+        CU["`cursor config
+        *hooks.json*`"]
+        CL["`claude config
+        *settings.json*`"]
     end
     subgraph repo["One repository, shared by both"]
-        PC["config.json<br/><i>policy, tracked</i>"]
-        ST["state/<br/><i>handoff, lessons, obs</i>"]
+        PC["`config.json
+        *policy, tracked*`"]
+        ST["`state/
+        *handoff, lessons, obs*`"]
     end
     CU --> R
     CL --> R
@@ -55,11 +60,16 @@ Arrows are imports, and every one of them is checked mechanically:
 
 ```mermaid
 graph TD
-    E["entrypoints/<br/><i>one file per hook handler</i>"]
-    C["core/<br/><i>steering logic, provider-agnostic</i>"]
-    P["providers/<br/><i>one ACL adapter per provider</i>"]
-    K["contracts/<br/><i>shared vocabulary</i>"]
-    L["platform/<br/><i>OS primitives</i>"]
+    E["`entrypoints/
+    *one file per hook handler*`"]
+    C["`core/
+    *steering logic, provider-agnostic*`"]
+    P["`providers/
+    *one ACL adapter per provider*`"]
+    K["`contracts/
+    *shared vocabulary*`"]
+    L["`platform/
+    *OS primitives*`"]
 
     E --> C
     E --> P

package/docs/providers/cursor.md

@@ -13,7 +13,8 @@ Source: `src/providers/cursor/`.
 ## Detection
 
 `cursor.detect.ts`: a raw hook payload is Cursor's when `hook_event_name` is camelCase (e.g.
-`beforeShellExecution`) and `workspace_roots` is an array.
+`beforeShellExecution`). `workspace_roots` is read when present but not required: a payload without it used to
+match no provider and be answered with nothing, which Cursor's fail-closed hooks treat as a deny.
 
 ## Capability descriptor
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tech-leads-club/harness-toolkit",
-  "version": "0.16.2",
+  "version": "0.16.3",
   "type": "module",
   "description": "Multi-provider agent steering: gates, follow-up, handoff, policy",
   "keywords": [

package/src/entrypoints/run.ts

@@ -154,7 +154,7 @@ function asRecord(value: unknown): Record<string, unknown> {
 export async function runHandler(handler: Handler, io: RunIo = {}): Promise<RunOutcome> {
   const readStdin = io.readStdin ?? readStdinText;
   const now = io.now ? io.now() : new Date();
-  const abstainRendered: Rendered = { stdout: null, exitCode: 0 };
+  const abstainRendered: Rendered = { stdout: "{}", exitCode: 0 };
 
   const text = await readStdin();
   const trimmed = text.trim();

package/src/providers/cursor/cursor.detect.ts

@@ -7,8 +7,5 @@ export function detectCursor(raw: unknown): boolean {
   }
   const value = raw as Record<string, unknown>;
   const eventName = value.hook_event_name;
-  if (typeof eventName !== "string" || !CAMEL_CASE_EVENT_NAME.test(eventName)) {
-    return false;
-  }
-  return Array.isArray(value.workspace_roots);
+  return typeof eventName === "string" && CAMEL_CASE_EVENT_NAME.test(eventName);
 }