@brainervirus/workit-cursor 8.17.0 → 8.17.1

package/.cursor-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "workit",
   "displayName": "Workit",
   "description": "Adaptive Workit workflow with shared MCP tools and native Cursor hooks",
-  "version": "8.17.0",
+  "version": "8.17.1",
   "author": {
     "name": "Cristhofer Pincetti"
   },

package/dist/cursor-session-start.js

@@ -22274,6 +22274,102 @@ var init_handle = __esm(() => {
   CLAUDE_WORKTREE = /[\\/]\.claude[\\/]worktrees[\\/]/;
 });
 
+// packages/workit-core/src/hooks/deadline.ts
+import { appendFileSync, mkdirSync as mkdirSync3 } from "node:fs";
+import path28 from "node:path";
+var HOOK_SKIP_TEXT = "workit context skipped: host under load", HOOK_DEADLINE_MS = 8000, HOST_DEADLINES, HOOK_SKIPS_FILE = "hook-skips.jsonl", override = (env) => {
+  const value = Number(env.WORKIT_HOOK_DEADLINE_MS);
+  return Number.isFinite(value) && value > 0 ? value : null;
+}, hookDeadlineMs = (env, host = "", native) => {
+  const row = HOST_DEADLINES[host];
+  return override(env) ?? (row ? native === undefined ? Math.min(...Object.values(row)) : row[native] ?? row[""] : HOOK_DEADLINE_MS);
+}, skipsFile = (stateDir) => path28.join(stateDir, HOOK_SKIPS_FILE), recordHookSkip = (skip, stateDir = resolveStateDir()) => {
+  try {
+    mkdirSync3(stateDir, { recursive: true });
+    appendFileSync(skipsFile(stateDir), `${JSON.stringify(skip)}
+`);
+  } catch {}
+}, QUIET, skipDecision = (event) => QUIET.has(event) ? { kind: "none" } : { kind: "context", text: HOOK_SKIP_TEXT }, TIMED_OUT, within = async (work, ms) => {
+  let timer;
+  const expired = new Promise((resolve) => {
+    timer = setTimeout(() => resolve(TIMED_OUT), Math.max(0, ms));
+    timer.unref?.();
+  });
+  try {
+    return await Promise.race([work, expired]);
+  } finally {
+    clearTimeout(timer);
+  }
+}, isTimedOut = (value) => value === TIMED_OUT, PROCESS_START, hookBudget = (env, options = {}, host = "") => {
+  const now = options.now ?? Date.now;
+  return {
+    now,
+    record: options.record ?? ((skip) => recordHookSkip(skip)),
+    startedAt: options.startedAt ?? now(),
+    deadlineMs: options.deadlineMs ?? hookDeadlineMs(env, host),
+    host: options.deadlineMs === undefined ? host : null
+  };
+}, readWithin = async (stdin, budget) => {
+  const read = (async () => {
+    let text = "";
+    for await (const chunk of stdin)
+      text += String(chunk);
+    return text;
+  })();
+  const text = await within(read, budget.startedAt + budget.deadlineMs - budget.now());
+  return isTimedOut(text) ? null : text;
+}, note = (adapter, raw, env, budget, outcome, stage) => {
+  const parsed = raw === undefined ? null : adapter.parse(raw, env);
+  const event = parsed ? parsed.ok ? parsed.input.event.kind : parsed.event : null;
+  budget.record({
+    at: new Date(budget.now()).toISOString(),
+    host: adapter.descriptor.host,
+    event,
+    outcome,
+    stage,
+    elapsedMs: Math.round(budget.now() - budget.startedAt)
+  });
+  return { native: parsed?.native ?? null, event };
+}, skippedHook = (adapter, raw, env, budget, stage) => {
+  const { native, event } = note(adapter, raw, env, budget, "skip", stage);
+  return {
+    ...adapter.render(skipDecision(event), native),
+    error: `${HOOK_SKIP_TEXT} (past the ${budget.deadlineMs} ms hook deadline)`,
+    skipped: true
+  };
+}, dispatchWithin = async (adapter, raw, env, budget, dispatch = dispatchHook) => {
+  const native = raw?.hook_event_name;
+  if (budget.host !== null && typeof native === "string")
+    budget.deadlineMs = hookDeadlineMs(env, budget.host, native);
+  const remaining = () => budget.startedAt + budget.deadlineMs - budget.now();
+  const result = remaining() > 0 ? await within(Promise.resolve().then(() => dispatch(adapter, raw, env)), remaining()) : TIMED_OUT;
+  if (isTimedOut(result))
+    return skippedHook(adapter, raw, env, budget, "dispatch");
+  if (remaining() < 0)
+    note(adapter, raw, env, budget, "late", "done");
+  return { ...result, skipped: false };
+};
+var init_deadline = __esm(() => {
+  init_logger();
+  init_handle();
+  HOST_DEADLINES = {
+    claude_code: { "": 8000, SessionStart: 16000, Stop: 16000 },
+    codex_cli: { "": 45000, Stop: 16000 },
+    codex_desktop: { "": 45000, Stop: 16000 },
+    cursor: { "": 45000 }
+  };
+  QUIET = new Set([
+    "stop",
+    "subagent.stop",
+    "shell.post",
+    "compact.pre",
+    "prompt.submit",
+    null
+  ]);
+  TIMED_OUT = Symbol("timed out");
+  PROCESS_START = performance.timeOrigin;
+});
+
 // packages/workit-core/src/hooks/hosts/claude-code.ts
 var CLAUDE_CODE_DESCRIPTOR, EVENTS, SOURCES, SHELL_TOOLS, dialectOf2 = (value) => value.tool_name === "PowerShell" ? "powershell" : "posix", toolCommand = (value) => isRecord6(value.tool_input) ? commandText(value.tool_input.command) : null, eventOf = (name, value) => {
   const toolUseId = optionalText(value.tool_use_id);
@@ -22832,7 +22928,7 @@ var init_codex = __esm(() => {
 
 // packages/workit-core/src/hooks/hosts/cursor.ts
 import fs21 from "node:fs";
-import path28 from "node:path";
+import path29 from "node:path";
 var undocumented, none, CURSOR_DESCRIPTOR, EVENTS3, parseCursorHookInput = (value) => {
   if (!isRecord6(value) || !Object.hasOwn(EVENTS3, String(value.hook_event_name)))
     return { ok: false, error: "hook_event_name is required" };
@@ -22913,7 +23009,7 @@ var undocumented, none, CURSOR_DESCRIPTOR, EVENTS3, parseCursorHookInput = (valu
       };
   }
 }, TRANSCRIPT_TAIL_BYTES, lastAssistantText = (file) => {
-  if (!file || !path28.isAbsolute(file))
+  if (!file || !path29.isAbsolute(file))
     return null;
   try {
     const size = fs21.statSync(file).size;
@@ -22949,14 +23045,14 @@ var undocumented, none, CURSOR_DESCRIPTOR, EVENTS3, parseCursorHookInput = (valu
   } catch {
     return null;
   }
-}, within = (root, dir) => dir === root || dir.startsWith(root.endsWith(path28.sep) ? root : `${root}${path28.sep}`), hookCwd = (input) => {
+}, within2 = (root, dir) => dir === root || dir.startsWith(root.endsWith(path29.sep) ? root : `${root}${path29.sep}`), hookCwd = (input) => {
   const cwd = existingDirectory(input.cwd);
   if (cwd && input.hook_event_name === "beforeShellExecution")
     return cwd;
   return cursorWorkspaceRoot(input);
 }, cursorWorkspaceRoot = (input) => {
   const cwd = existingDirectory(input.cwd);
-  return cwd && input.workspace_roots.find((root) => within(root, cwd)) || input.workspace_roots[0];
+  return cwd && input.workspace_roots.find((root) => within2(root, cwd)) || input.workspace_roots[0];
 }, cursorDeny = (reason) => ({
   permission: "deny",
   user_message: "Workit blocked this action",
@@ -23130,19 +23226,21 @@ var init_cursor = __esm(() => {
 });
 
 // packages/workit-core/src/hooks/run.ts
-async function runHookProcess(host, stdin, stdout, stderr = process.stderr, env = process.env) {
+async function runHookProcess(host, stdin, stdout, stderr = process.stderr, env = process.env, deadline = {}) {
   const adapter = typeof host === "string" ? HOOK_ADAPTERS[host] : host;
-  let text = "";
-  for await (const chunk of stdin)
-    text += String(chunk);
+  const budget = hookBudget(env, deadline, adapter.descriptor.host);
+  const text = await readWithin(stdin, budget);
   let raw;
   try {
-    raw = JSON.parse(text || "{}");
+    raw = text === null ? undefined : JSON.parse(text || "{}");
   } catch {
     raw = undefined;
   }
-  const result = dispatchHook(adapter, raw, env);
-  if (raw === undefined || result.error)
+  const result = text === null ? skippedHook(adapter, undefined, env, budget, "input") : await dispatchWithin(adapter, raw, env, budget, deadline.dispatch);
+  if (result.skipped)
+    stderr.write(`[workit] ${result.error}
+`);
+  else if (raw === undefined || result.error)
     stderr.write(`[workit] hook input rejected: ${raw === undefined ? "invalid JSON hook input" : result.error}
 `);
   stdout.write(`${JSON.stringify(result.json)}
@@ -23151,7 +23249,7 @@ async function runHookProcess(host, stdin, stdout, stderr = process.stderr, env
 }
 var HOOK_ADAPTERS;
 var init_run = __esm(async () => {
-  init_handle();
+  init_deadline();
   init_claude_code();
   init_codex();
   init_cursor();
@@ -23309,6 +23407,14 @@ var hostRef = (handle) => ({ kind: "host", host: "cursor", handle }), cursorCapa
     return { json: {} };
   const note = `[workit: ${gap}; Workit checks are skipped for this action]`;
   return { json: { permission: "allow", user_message: note, agent_message: note } };
+}, subagentStartStep = (_adapter, raw) => {
+  let json;
+  try {
+    json = handleSubagentStartHook(raw);
+  } catch (error) {
+    json = cursorDeny(`hook failure: ${String(error)}`);
+  }
+  return { json, exitCode: json.permission === "deny" ? 2 : 0, error: null };
 }, runCursorHook = async () => {
   let text = "";
   for await (const chunk of process.stdin)
@@ -23326,24 +23432,16 @@ var hostRef = (handle) => ({ kind: "host", host: "cursor", handle }), cursorCapa
     process.exitCode = 0;
     return;
   }
-  if (isSubagentStart(raw)) {
-    let output;
-    try {
-      output = handleSubagentStartHook(raw);
-    } catch (error) {
-      output = cursorDeny(`hook failure: ${String(error)}`);
-    }
-    process.stdout.write(`${JSON.stringify(output)}
-`);
-    process.exitCode = output.permission === "deny" ? 2 : 0;
-    return;
-  }
-  process.exitCode = await runHookProcess(cursorAdapter, [text], process.stdout);
+  process.exitCode = await runHookProcess(cursorAdapter, [text], process.stdout, process.stderr, process.env, {
+    startedAt: PROCESS_START,
+    ...isSubagentStart(raw) ? { dispatch: subagentStartStep } : {}
+  });
 };
 var init_workit_hook = __esm(async () => {
   init_task_contract();
   init_task_engine();
   init_task_store();
+  init_deadline();
   await __promiseAll([
     init_hooks(),
     init_hooks()

package/dist/mcp-server.js

@@ -28828,6 +28828,18 @@ var WRITE_TOOLS = new Set([
 ]);
 // packages/workit-core/src/hooks/handle.ts
 var offered = new Set;
+// packages/workit-core/src/hooks/deadline.ts
+var QUIET = new Set([
+  "stop",
+  "subagent.stop",
+  "shell.post",
+  "compact.pre",
+  "prompt.submit",
+  null
+]);
+var TIMED_OUT = Symbol("timed out");
+var PROCESS_START = performance.timeOrigin;
+
 // packages/workit-core/src/hooks/hosts/claude-code.ts
 var SOURCES = new Set(["startup", "resume", "clear", "compact", "fork"]);
 var SHELL_TOOLS = new Set(["Bash", "PowerShell"]);

package/dist/workit-hook.js

@@ -22498,6 +22498,112 @@ var dispatchHook = (adapter, raw, env = process.env) => {
     };
   }
 };
+// packages/workit-core/src/hooks/deadline.ts
+import { appendFileSync, mkdirSync as mkdirSync3 } from "node:fs";
+import path28 from "node:path";
+var HOOK_SKIP_TEXT = "workit context skipped: host under load";
+var HOOK_DEADLINE_MS = 8000;
+var HOST_DEADLINES = {
+  claude_code: { "": 8000, SessionStart: 16000, Stop: 16000 },
+  codex_cli: { "": 45000, Stop: 16000 },
+  codex_desktop: { "": 45000, Stop: 16000 },
+  cursor: { "": 45000 }
+};
+var HOOK_SKIPS_FILE = "hook-skips.jsonl";
+var override = (env) => {
+  const value = Number(env.WORKIT_HOOK_DEADLINE_MS);
+  return Number.isFinite(value) && value > 0 ? value : null;
+};
+var hookDeadlineMs = (env, host = "", native) => {
+  const row = HOST_DEADLINES[host];
+  return override(env) ?? (row ? native === undefined ? Math.min(...Object.values(row)) : row[native] ?? row[""] : HOOK_DEADLINE_MS);
+};
+var skipsFile = (stateDir) => path28.join(stateDir, HOOK_SKIPS_FILE);
+var recordHookSkip = (skip, stateDir = resolveStateDir()) => {
+  try {
+    mkdirSync3(stateDir, { recursive: true });
+    appendFileSync(skipsFile(stateDir), `${JSON.stringify(skip)}
+`);
+  } catch {}
+};
+var QUIET = new Set([
+  "stop",
+  "subagent.stop",
+  "shell.post",
+  "compact.pre",
+  "prompt.submit",
+  null
+]);
+var skipDecision = (event) => QUIET.has(event) ? { kind: "none" } : { kind: "context", text: HOOK_SKIP_TEXT };
+var TIMED_OUT = Symbol("timed out");
+var within = async (work, ms) => {
+  let timer;
+  const expired = new Promise((resolve) => {
+    timer = setTimeout(() => resolve(TIMED_OUT), Math.max(0, ms));
+    timer.unref?.();
+  });
+  try {
+    return await Promise.race([work, expired]);
+  } finally {
+    clearTimeout(timer);
+  }
+};
+var isTimedOut = (value) => value === TIMED_OUT;
+var PROCESS_START = performance.timeOrigin;
+var hookBudget = (env, options = {}, host = "") => {
+  const now = options.now ?? Date.now;
+  return {
+    now,
+    record: options.record ?? ((skip) => recordHookSkip(skip)),
+    startedAt: options.startedAt ?? now(),
+    deadlineMs: options.deadlineMs ?? hookDeadlineMs(env, host),
+    host: options.deadlineMs === undefined ? host : null
+  };
+};
+var readWithin = async (stdin, budget) => {
+  const read = (async () => {
+    let text = "";
+    for await (const chunk of stdin)
+      text += String(chunk);
+    return text;
+  })();
+  const text = await within(read, budget.startedAt + budget.deadlineMs - budget.now());
+  return isTimedOut(text) ? null : text;
+};
+var note = (adapter, raw, env, budget, outcome, stage) => {
+  const parsed = raw === undefined ? null : adapter.parse(raw, env);
+  const event = parsed ? parsed.ok ? parsed.input.event.kind : parsed.event : null;
+  budget.record({
+    at: new Date(budget.now()).toISOString(),
+    host: adapter.descriptor.host,
+    event,
+    outcome,
+    stage,
+    elapsedMs: Math.round(budget.now() - budget.startedAt)
+  });
+  return { native: parsed?.native ?? null, event };
+};
+var skippedHook = (adapter, raw, env, budget, stage) => {
+  const { native, event } = note(adapter, raw, env, budget, "skip", stage);
+  return {
+    ...adapter.render(skipDecision(event), native),
+    error: `${HOOK_SKIP_TEXT} (past the ${budget.deadlineMs} ms hook deadline)`,
+    skipped: true
+  };
+};
+var dispatchWithin = async (adapter, raw, env, budget, dispatch = dispatchHook) => {
+  const native = raw?.hook_event_name;
+  if (budget.host !== null && typeof native === "string")
+    budget.deadlineMs = hookDeadlineMs(env, budget.host, native);
+  const remaining = () => budget.startedAt + budget.deadlineMs - budget.now();
+  const result = remaining() > 0 ? await within(Promise.resolve().then(() => dispatch(adapter, raw, env)), remaining()) : TIMED_OUT;
+  if (isTimedOut(result))
+    return skippedHook(adapter, raw, env, budget, "dispatch");
+  if (remaining() < 0)
+    note(adapter, raw, env, budget, "late", "done");
+  return { ...result, skipped: false };
+};
+
 // packages/workit-core/src/hooks/hosts/claude-code.ts
 var CLAUDE_CODE_DESCRIPTOR = {
   host: "claude_code",
@@ -23057,7 +23163,7 @@ var codexAdapter = {
 
 // packages/workit-core/src/hooks/hosts/cursor.ts
 import fs21 from "node:fs";
-import path28 from "node:path";
+import path29 from "node:path";
 var undocumented = { support: "undocumented", native: null };
 var none = { support: "none", native: null };
 var CURSOR_DESCRIPTOR = {
@@ -23254,7 +23360,7 @@ var protocolEvent2 = (input) => {
 };
 var TRANSCRIPT_TAIL_BYTES = 256 * 1024;
 var lastAssistantText = (file) => {
-  if (!file || !path28.isAbsolute(file))
+  if (!file || !path29.isAbsolute(file))
     return null;
   try {
     const size = fs21.statSync(file).size;
@@ -23291,7 +23397,7 @@ var lastAssistantText = (file) => {
     return null;
   }
 };
-var within = (root, dir) => dir === root || dir.startsWith(root.endsWith(path28.sep) ? root : `${root}${path28.sep}`);
+var within2 = (root, dir) => dir === root || dir.startsWith(root.endsWith(path29.sep) ? root : `${root}${path29.sep}`);
 var hookCwd = (input) => {
   const cwd = existingDirectory(input.cwd);
   if (cwd && input.hook_event_name === "beforeShellExecution")
@@ -23300,7 +23406,7 @@ var hookCwd = (input) => {
 };
 var cursorWorkspaceRoot = (input) => {
   const cwd = existingDirectory(input.cwd);
-  return cwd && input.workspace_roots.find((root) => within(root, cwd)) || input.workspace_roots[0];
+  return cwd && input.workspace_roots.find((root) => within2(root, cwd)) || input.workspace_roots[0];
 };
 var cursorDeny = (reason) => ({
   permission: "deny",
@@ -23365,19 +23471,21 @@ var HOOK_ADAPTERS = {
   codex_desktop: codexAdapter,
   cursor: cursorAdapter
 };
-async function runHookProcess(host, stdin, stdout, stderr = process.stderr, env = process.env) {
+async function runHookProcess(host, stdin, stdout, stderr = process.stderr, env = process.env, deadline = {}) {
   const adapter = typeof host === "string" ? HOOK_ADAPTERS[host] : host;
-  let text = "";
-  for await (const chunk of stdin)
-    text += String(chunk);
+  const budget = hookBudget(env, deadline, adapter.descriptor.host);
+  const text = await readWithin(stdin, budget);
   let raw;
   try {
-    raw = JSON.parse(text || "{}");
+    raw = text === null ? undefined : JSON.parse(text || "{}");
   } catch {
     raw = undefined;
   }
-  const result = dispatchHook(adapter, raw, env);
-  if (raw === undefined || result.error)
+  const result = text === null ? skippedHook(adapter, undefined, env, budget, "input") : await dispatchWithin(adapter, raw, env, budget, deadline.dispatch);
+  if (result.skipped)
+    stderr.write(`[workit] ${result.error}
+`);
+  else if (raw === undefined || result.error)
     stderr.write(`[workit] hook input rejected: ${raw === undefined ? "invalid JSON hook input" : result.error}
 `);
   stdout.write(`${JSON.stringify(result.json)}
@@ -23530,6 +23638,15 @@ var degradedCursorHook = (raw) => {
   return { json: { permission: "allow", user_message: note, agent_message: note } };
 };
 var handleCursorHook = (raw) => degradedCursorHook(raw)?.json ?? (isSubagentStart(raw) ? handleSubagentStartHook(raw) : dispatchHook(cursorAdapter, raw).json);
+var subagentStartStep = (_adapter, raw) => {
+  let json;
+  try {
+    json = handleSubagentStartHook(raw);
+  } catch (error) {
+    json = cursorDeny(`hook failure: ${String(error)}`);
+  }
+  return { json, exitCode: json.permission === "deny" ? 2 : 0, error: null };
+};
 var runCursorHook = async () => {
   let text = "";
   for await (const chunk of process.stdin)
@@ -23547,19 +23664,10 @@ var runCursorHook = async () => {
     process.exitCode = 0;
     return;
   }
-  if (isSubagentStart(raw)) {
-    let output;
-    try {
-      output = handleSubagentStartHook(raw);
-    } catch (error) {
-      output = cursorDeny(`hook failure: ${String(error)}`);
-    }
-    process.stdout.write(`${JSON.stringify(output)}
-`);
-    process.exitCode = output.permission === "deny" ? 2 : 0;
-    return;
-  }
-  process.exitCode = await runHookProcess(cursorAdapter, [text], process.stdout);
+  process.exitCode = await runHookProcess(cursorAdapter, [text], process.stdout, process.stderr, process.env, {
+    startedAt: PROCESS_START,
+    ...isSubagentStart(raw) ? { dispatch: subagentStartStep } : {}
+  });
 };
 if (__require.main == __require.module)
   await runCursorHook();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainervirus/workit-cursor",
-  "version": "8.17.0",
+  "version": "8.17.1",
   "private": false,
   "description": "Workit Cursor plugin — shared MCP transport, native hooks, and sixteen method skills",
   "keywords": [
@@ -46,8 +46,8 @@
     "build": "bun scripts/build.ts"
   },
   "devDependencies": {
-    "@brainervirus/workit-core": "^8.17.0",
-    "@brainervirus/workit-mcp": "^8.17.0"
+    "@brainervirus/workit-core": "^8.17.1",
+    "@brainervirus/workit-mcp": "^8.17.1"
   },
   "engines": {
     "node": ">=24"