halfcycle 0.3.30 → 0.3.31

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "halfcycle",
-  "version": "0.3.30",
+  "version": "0.3.31",
   "description": "Halfcycle Method bundle — resolution-stub slash commands, remote method-delivery registration, and governance-hook wiring for a Halfcycle engagement repo. It ships NO worker role files: a project's roles are authored from that project's own recorded decisions at orchestration kickoff (FX-2, W3-F-27).",
   "commands": [
     {

package/bin/bin.bundle.mjs

@@ -15147,21 +15147,49 @@ function emitBlock(reason) {
   process.stdout.write(JSON.stringify({ decision: "block", reason }) + "\n");
   process.exit(0);
 }
-function emitWarning(text) {
-  process.stdout.write(text + "\n");
+function nonBlockingReply(event, text) {
+  if (event === "PostToolUse") {
+    return JSON.stringify({
+      systemMessage: text,
+      hookSpecificOutput: { hookEventName: event, additionalContext: text }
+    });
+  }
+  return JSON.stringify({ systemMessage: text });
 }
-function emitInfraWarning(message) {
-  process.stdout.write(`[Halfcycle] WARNING: Guard service unavailable \u2014 ${message}. Session continues (fail-open).
+function hookReply(event) {
+  const queued = [];
+  return {
+    notice(text) {
+      queued.push(text);
+    },
+    block(reason) {
+      const carried = queued.splice(0);
+      return emitBlock(carried.length === 0 ? reason : [reason, ...carried].join("\n"));
+    },
+    flush() {
+      if (queued.length === 0)
+        return;
+      const text = queued.splice(0).join("\n");
+      const code = process.exitCode;
+      if (code !== void 0 && code !== null && Number(code) !== 0) {
+        writeSync(2, `${text}
 `);
-}
-function emitLocalFault(message) {
-  process.stdout.write(`[Halfcycle] WARNING: Local fault \u2014 ${message}. The guard service was not contacted. Session continues (fail-open).
+        return;
+      }
+      process.stdout.write(`${nonBlockingReply(event, text)}
 `);
+    }
+  };
 }
-function emitContractFault(message) {
-  process.stdout.write(`[Halfcycle] WARNING: Guard response could not be understood \u2014 ${message}
-This is not a service outage: the guard service answered. The suspect is this repository's own installed halfcycle runner, which is out of date with what the service now sends. Update it: run "npx halfcycle" in this repository, then retry. Session continues (fail-open).
-`);
+function infraWarningText(message) {
+  return `[Halfcycle] WARNING: Guard service unavailable \u2014 ${message}. Session continues (fail-open).`;
+}
+function localFaultText(message) {
+  return `[Halfcycle] WARNING: Local fault \u2014 ${message}. The guard service was not contacted. Session continues (fail-open).`;
+}
+function contractFaultText(message) {
+  return `[Halfcycle] WARNING: Guard response could not be understood \u2014 ${message}
+This is not a service outage: the guard service answered. The suspect is this repository's own installed halfcycle runner, which is out of date with what the service now sends. Update it: run "npx halfcycle" in this repository, then retry. Session continues (fail-open).`;
 }
 var UNCONFIGURED_EXIT_TOOL_USE = 2;
 var UNCONFIGURED_EXIT_STOP_FAMILY = 1;
@@ -17212,6 +17240,11 @@ async function evaluateWithRefresh(opts) {
 // dist/hooks/post-tool-use.js
 var HANDLED_EDIT_TOOLS = /* @__PURE__ */ new Set(["Edit", "Write", "MultiEdit", "NotebookEdit"]);
 async function runPostToolUse() {
+  const reply = hookReply("PostToolUse");
+  await evaluateEdit(reply);
+  reply.flush();
+}
+async function evaluateEdit(reply) {
   let input;
   try {
     const raw = await readStdin();
@@ -17228,7 +17261,7 @@ async function runPostToolUse() {
     return;
   const repoRootResult = getRepoRoot(process.cwd());
   if (!repoRootResult.ok) {
-    emitLocalFault(`Could not find git repo root: ${repoRootResult.message}`);
+    reply.notice(localFaultText(`Could not find git repo root: ${repoRootResult.message}`));
     return;
   }
   const repoRoot = repoRootResult.value;
@@ -17280,10 +17313,10 @@ async function runPostToolUse() {
       return;
     }
     if (failure.kind === "contract") {
-      emitContractFault(failure.message);
+      reply.notice(contractFaultText(failure.message));
       return;
     }
-    emitInfraWarning(failure.reason);
+    reply.notice(infraWarningText(failure.reason));
     return;
   }
   const telemetryConfig = readTelemetryConfig();
@@ -17311,25 +17344,25 @@ async function runPostToolUse() {
   }, {
     warn: (msg) => process.stderr.write(msg + "\n")
   });
-  actOnEnvelope2(clientResult.envelope);
+  actOnEnvelope2(clientResult.envelope, reply);
 }
-function actOnEnvelope2(envelope) {
+function actOnEnvelope2(envelope, reply) {
   const notRun = notRunReport(envelope.notRun);
   const notRunBlock = notRun ? `
 ${notRun}` : "";
   if (envelope.guardsFired.length === 0) {
     if (notRun)
-      emitWarning(notRun);
+      reply.notice(notRun);
     return;
   }
   if (envelope.blocking) {
     const guardLines = envelope.guardsFired.map((g) => `  [${g.severity.toUpperCase()}] ${g.patternRef}: ${g.explanation}`).join("\n");
     const reason = `Guard blocked: ${envelope.explanation}
 ${guardLines}${notRunBlock}`;
-    emitBlock(reason);
+    reply.block(reason);
   } else {
     const guardLines = envelope.guardsFired.map((g) => `  [${g.severity.toUpperCase()}] ${g.patternRef}: ${g.explanation}`).join("\n");
-    emitWarning(`[Halfcycle] Guard warning: ${envelope.explanation}
+    reply.notice(`[Halfcycle] Guard warning: ${envelope.explanation}
 ${guardLines}${notRunBlock}`);
   }
 }
@@ -17464,6 +17497,10 @@ function orphanSweep(repoRoot, refKnown, keepSessionId, now = Date.now()) {
 }
 
 // dist/hooks/session-diff.js
+var STOP_HOOK_EVENT = {
+  stop: "Stop",
+  "subagent-stop": "SubagentStop"
+};
 function resolveDiffBase2(repoRoot, sessionId) {
   const ref = readMarker(repoRoot, sessionId);
   if (ref === null)
@@ -17495,9 +17532,14 @@ function collectDiff(repoRoot, base) {
   };
 }
 async function runSessionDiff(input, kind) {
+  const reply = hookReply(STOP_HOOK_EVENT[kind]);
+  await evaluateSession(input, kind, reply);
+  reply.flush();
+}
+async function evaluateSession(input, kind, reply) {
   const repoRootResult = getRepoRoot(process.cwd());
   if (!repoRootResult.ok) {
-    emitLocalFault(`Could not find git repo root: ${repoRootResult.message}`);
+    reply.notice(localFaultText(`Could not find git repo root: ${repoRootResult.message}`));
     return;
   }
   const repoRoot = repoRootResult.value;
@@ -17507,7 +17549,7 @@ async function runSessionDiff(input, kind) {
   const diffBase = base.kind;
   const collected = collectDiff(repoRoot, base);
   if (!collected.ok) {
-    emitLocalFault(`Could not get session diff: ${collected.message}`);
+    reply.notice(localFaultText(`Could not get session diff: ${collected.message}`));
     return;
   }
   const { getDiff } = collected;
@@ -17566,10 +17608,10 @@ async function runSessionDiff(input, kind) {
       return;
     }
     if (failure.kind === "contract") {
-      emitContractFault(failure.message);
+      reply.notice(contractFaultText(failure.message));
       return;
     }
-    emitInfraWarning(failure.reason);
+    reply.notice(infraWarningText(failure.reason));
     return;
   }
   const telemetryConfig = readTelemetryConfig();
@@ -17595,28 +17637,28 @@ async function runSessionDiff(input, kind) {
     warn: (msg) => process.stderr.write(msg + "\n")
   });
   writeDedupe(repoRoot, sessionId, { base: baseKey, digest });
-  actOnEnvelope3(clientResult.envelope, kind, input.stop_hook_active === true);
+  actOnEnvelope3(clientResult.envelope, kind, input.stop_hook_active === true, reply);
 }
-function actOnEnvelope3(envelope, kind, neverBlock) {
+function actOnEnvelope3(envelope, kind, neverBlock, reply) {
   const notRun = notRunReport(envelope.notRun);
   const notRunBlock = notRun ? `
 ${notRun}` : "";
   if (envelope.guardsFired.length === 0) {
     if (notRun)
-      emitWarning(notRun);
+      reply.notice(notRun);
     return;
   }
   const where = kind === "stop" ? "session stop" : "session stop";
   const guardLines = envelope.guardsFired.map((g) => `  [${g.severity.toUpperCase()}] ${g.patternRef}: ${g.explanation}`).join("\n");
   if (envelope.blocking && !neverBlock) {
-    emitBlock(`Guard blocked at ${where}: ${envelope.explanation}
+    reply.block(`Guard blocked at ${where}: ${envelope.explanation}
 ${guardLines}${notRunBlock}`);
   } else if (envelope.blocking && neverBlock) {
-    emitWarning(`[Halfcycle] Guard would block at ${where} but the stop was already continued (stop_hook_active) \u2014 surfacing as a warning:
+    reply.notice(`[Halfcycle] Guard would block at ${where} but the stop was already continued (stop_hook_active) \u2014 surfacing as a warning:
 ${envelope.explanation}
 ${guardLines}${notRunBlock}`);
   } else {
-    emitWarning(`[Halfcycle] Guard warning at ${where}: ${envelope.explanation}
+    reply.notice(`[Halfcycle] Guard warning at ${where}: ${envelope.explanation}
 ${guardLines}${notRunBlock}`);
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "halfcycle",
-  "version": "0.3.30",
+  "version": "0.3.31",
   "description": "Your coding agents are the engineers. Halfcycle is the rest of the team: product owner, architect, planner and independent reviewer for Claude Code.",
   "keywords": [
     "claude",