repo-harness 0.7.2 → 0.7.3

package/AGENTS.md

@@ -1,6 +1,6 @@
 # repo-harness AGENTS.md
 
-This repository self-hosts the `repo-harness` contract; the former `repo-harness-skill` and `project-initializer` names are retired and removed by installed-copy sync. Claude and Codex should follow the same repo-local workflow surface.
+This repository self-hosts the `repo-harness` contract; the former `repo-harness-skill` and `project-initializer` names have been fully removed and are no longer recognized by any tooling. Claude and Codex should follow the same repo-local workflow surface.
 
 ## Canonical Workflow Files
 

package/CLAUDE.md

@@ -1,6 +1,6 @@
 # repo-harness AGENTS.md
 
-This repository self-hosts the `repo-harness` contract; the former `repo-harness-skill` and `project-initializer` names are retired and removed by installed-copy sync. Claude and Codex should follow the same repo-local workflow surface.
+This repository self-hosts the `repo-harness` contract; the former `repo-harness-skill` and `project-initializer` names have been fully removed and are no longer recognized by any tooling. Claude and Codex should follow the same repo-local workflow surface.
 
 ## Canonical Workflow Files
 

package/README.es.md

@@ -85,7 +85,7 @@ artifacts.
 ## Novedades
 
 Las notas de versión viven en [`docs/CHANGELOG.md`](docs/CHANGELOG.md). La línea
-actual es `0.7.2`.
+actual es `0.7.3`.
 
 ## Cómo funciona
 
@@ -419,8 +419,8 @@ Guards habituales:
 
 ## Release actual
 
-- npm package: `repo-harness@0.7.2`
-- Generated workflow stamp: `repo-harness@0.7.2+template@0.7.2`
+- npm package: `repo-harness@0.7.3`
+- Generated workflow stamp: `repo-harness@0.7.3+template@0.7.3`
 - GitHub repository: `Ancienttwo/repo-harness`
 - Release history: [`docs/CHANGELOG.md`](docs/CHANGELOG.md)
 

package/README.fr.md

@@ -85,7 +85,7 @@ l'emportent.
 ## Nouveautés
 
 Les notes de version vivent dans [`docs/CHANGELOG.md`](docs/CHANGELOG.md). La
-ligne actuelle est `0.7.2`.
+ligne actuelle est `0.7.3`.
 
 ## Comment ça marche
 
@@ -424,8 +424,8 @@ Guards courants :
 
 ## Release actuelle
 
-- npm package : `repo-harness@0.7.2`
-- Generated workflow stamp : `repo-harness@0.7.2+template@0.7.2`
+- npm package : `repo-harness@0.7.3`
+- Generated workflow stamp : `repo-harness@0.7.3+template@0.7.3`
 - GitHub repository : `Ancienttwo/repo-harness`
 - Release history : [`docs/CHANGELOG.md`](docs/CHANGELOG.md)
 

package/README.ja.md

@@ -75,7 +75,7 @@ review、checks、handoff と食い違う場合は、source artifacts を優先
 ## What's New
 
 リリースノートは [`docs/CHANGELOG.md`](docs/CHANGELOG.md) にあります。現在の
-ラインは `0.7.2` です。
+ラインは `0.7.3` です。
 
 ## 仕組み
 
@@ -398,8 +398,8 @@ hook がブロックしたときは、まず terminal の構造化された出
 
 ## 現在の Release
 
-- npm package：`repo-harness@0.7.2`
-- Generated workflow stamp：`repo-harness@0.7.2+template@0.7.2`
+- npm package：`repo-harness@0.7.3`
+- Generated workflow stamp：`repo-harness@0.7.3+template@0.7.3`
 - GitHub repository：`Ancienttwo/repo-harness`
 - Release history：[`docs/CHANGELOG.md`](docs/CHANGELOG.md)
 

package/README.md

@@ -78,7 +78,7 @@ active plan, contract, review, checks, or handoff, the source artifacts win.
 ## What's New
 
 Release notes live in [`docs/CHANGELOG.md`](docs/CHANGELOG.md). The current line
-is `0.7.2`.
+is `0.7.3`.
 
 ## How It Works
 
@@ -405,7 +405,8 @@ and not arbitrary shell.
 - Debug in this order: user-level adapter config -> `repo-harness-hook` (or fallback `repo-harness hook`) -> route registry -> `.ai/hooks/*`.
 - If `repo-harness-hook` reports `.ai/hooks` drift, refresh the repo-local copy with `repo-harness adopt --repo <root>`.
 
-The installed adapter owns eight managed hook routes. The route tuple
+The installed adapter owns eight shared managed hook routes. Codex also installs
+three Codex-only bounded-delegation routes. The route tuple
 `event + routeId + matcher` is the stable contract; script names are the current
 implementation under `assets/hooks/` or a repo-pinned `.ai/hooks/` copy.
 
@@ -420,6 +421,11 @@ implementation under `assets/hooks/` or a repo-pinned `.ai/hooks/` copy.
 | `UserPromptSubmit.default` | all prompts | `prompt-guard.sh` | Classifies prompt intent, routes planning/check/hunt hints, and renders host-safe workflow guidance. |
 | `Stop.default` | session stop | `stop-orchestrator.sh` | Finalizes handoff and guards against ending with unresolved draft-plan or completion evidence gaps. |
 
+Codex-only routes are `UserPromptSubmit.delegation`,
+`SubagentStart.context`, and `SubagentStop.quality`. Claude keeps the shared
+`PreToolUse.subagent` return-channel route and does not install those Codex
+delegation lifecycle entries.
+
 `SessionStart` resolves hooks central-first, then runs two ordered scripts before
 work begins:
 
@@ -487,8 +493,8 @@ Most common guards:
 
 ## Current Release
 
-- npm package: `repo-harness@0.7.2`
-- Generated workflow stamp: `repo-harness@0.7.2+template@0.7.2`
+- npm package: `repo-harness@0.7.3`
+- Generated workflow stamp: `repo-harness@0.7.3+template@0.7.3`
 - GitHub repository: `Ancienttwo/repo-harness`
 - Release history: [`docs/CHANGELOG.md`](docs/CHANGELOG.md)
 

package/README.zh-CN.md

@@ -69,7 +69,7 @@ review、checks 或 handoff 冲突，以 source artifacts 为准。
 
 ## What's New
 
-Release notes 见 [`docs/CHANGELOG.md`](docs/CHANGELOG.md)，当前版本线是 `0.7.2`。
+Release notes 见 [`docs/CHANGELOG.md`](docs/CHANGELOG.md)，当前版本线是 `0.7.3`。
 
 ## 工作原理
 
@@ -437,8 +437,8 @@ hook block 工作时，先看 terminal 里的结构化输出。核心字段是
 
 ## 当前 Release
 
-- npm package：`repo-harness@0.7.2`
-- Generated workflow stamp：`repo-harness@0.7.2+template@0.7.2`
+- npm package：`repo-harness@0.7.3`
+- Generated workflow stamp：`repo-harness@0.7.3+template@0.7.3`
 - GitHub repository：`Ancienttwo/repo-harness`
 - Release history：[`docs/CHANGELOG.md`](docs/CHANGELOG.md)
 

package/SKILL.md

@@ -15,14 +15,12 @@ Compatibility boundary:
 - internal engine: CLI plus hook-backed tasks-first harness
 - contract ID: tasks-first-harness-v1
 - canonical skill, CLI, and package name: `repo-harness`
-- retired legacy aliases: `repo-harness-skill`, `project-initializer`
 - new-project creation surface: `repo-harness-scaffold` (secondary generator)
 
-`repo-harness-skill` and `project-initializer` are retired: do not create,
-sync, or search their directories under `~/.codex/skills` or
-`~/.claude/skills` as active upstream roots; installed-copy sync removes any
-existing copies. Historical `project-initializer` markers in generated files
-may remain only as legacy evidence.
+The former `repo-harness-skill` and `project-initializer` aliases have been
+fully removed. They are no longer recognized, synced, or cleaned up by any
+tooling. Historical markers left behind in long-migrated repos are inert
+evidence and are not handled.
 
 The skill should not carry the whole workflow contract in prose. It should:
 

package/assets/hooks/codex-delegation-advisor.sh

@@ -0,0 +1,157 @@
+#!/bin/bash
+# Codex Delegation Advisor - UserPromptSubmit.delegation
+# Converts explicit user delegation requests into bounded Codex subagent context.
+
+set -euo pipefail
+
+[[ "${HOOK_HOST:-}" == "codex" ]] || exit 0
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+. "$SCRIPT_DIR/hook-input.sh"
+
+hook_read_stdin_once
+input="$HOOK_STDIN_JSON"
+[[ -n "$input" ]] || exit 0
+command -v bun >/dev/null 2>&1 || exit 0
+
+JSON_INPUT="$input" REPO_ROOT="${HOOK_REPO_ROOT:-$(pwd)}" bun -e '
+  const fs = require("fs");
+  const path = require("path");
+  const crypto = require("crypto");
+
+  function sanitize(value) {
+    return String(value || "")
+      .toLowerCase()
+      .replace(/[^a-z0-9]+/g, "-")
+      .replace(/^-+|-+$/g, "")
+      .replace(/-{2,}/g, "-")
+      .slice(0, 120);
+  }
+
+  function firstString(input, keys) {
+    for (const key of keys) {
+      const value = input?.[key];
+      if (typeof value === "string" && value.trim()) return value;
+    }
+    return "";
+  }
+
+  function delegationScope(input) {
+    const runId = firstString(input, ["run_id"]);
+    if (runId) return { source: "run_id", id: `run-${sanitize(runId)}` };
+
+    const sessionId = firstString(input, ["session_id"]);
+    if (sessionId) return { source: "session_id", id: `session-${sanitize(sessionId)}` };
+
+    const transcriptPath = firstString(input, ["transcript_path"]);
+    if (transcriptPath) {
+      const digest = crypto.createHash("sha1").update(transcriptPath).digest("hex").slice(0, 16);
+      return { source: "transcript_path", id: `transcript-${digest}` };
+    }
+
+    const envSession = process.env.CODEX_SESSION_ID || process.env.CLAUDE_SESSION_ID || "";
+    if (envSession) return { source: "env_session", id: `session-${sanitize(envSession)}` };
+
+    return null;
+  }
+
+  let input;
+  try {
+    input = JSON.parse(process.env.JSON_INPUT || "");
+  } catch {
+    process.exit(0);
+  }
+
+  const prompt = firstString(input, [
+    "prompt",
+    "user_prompt",
+    "user_message",
+    "message",
+    "input",
+  ]);
+  if (!prompt) process.exit(0);
+
+  function isDelegationDiscussion(text) {
+    if (!/\b(spawn|use|run)\s+(bounded\s+)?subagents?\b/i.test(text)) return false;
+    if (/^\s*(please\s+)?(spawn|use|run)\s+(bounded\s+)?subagents?\s+(to|for)\b/i.test(text)) return false;
+    return [
+      /[?？]/,
+      /\b(should|need|necessary)\b/i,
+      /(机制|有必要|必要|是否|为什么|怎么|如何|架构|设计|注册|路由|本来就有)/i,
+      /\b(mechanism|architecture|design|registration|route|routing|adapter|hook)\b/i,
+    ].some((pattern) => pattern.test(text));
+  }
+
+  const triggers = [
+    { name: "slash-delegate", pattern: /(^|\s)\/(delegate|parallel)\b/i },
+    { name: "spawn-subagents", pattern: /\b(spawn|use|run)\s+(bounded\s+)?subagents?\b/i, skipDiscussion: true },
+    { name: "multiple-agents", pattern: /\buse\s+multiple\s+agents?\b/i },
+    { name: "parallel-agents", pattern: /\bparallel\s+(agents?|workstreams?|investigation|research)\b/i },
+    { name: "chinese-subagent", pattern: /交给\s*子代理|使用多个\s*(agent|代理)|并行(调查|研究|处理|执行|agent|代理)/i },
+  ];
+  const trigger = triggers.find((entry) => entry.pattern.test(prompt) && !(entry.skipDiscussion && isDelegationDiscussion(prompt)));
+  if (!trigger) process.exit(0);
+
+  const repoRoot = process.env.REPO_ROOT || process.cwd();
+  const stateDir = path.join(repoRoot, ".ai", "harness", "delegation");
+  fs.mkdirSync(stateDir, { recursive: true });
+
+  const now = new Date();
+  const scope = delegationScope(input);
+  const relativeStateFile = scope ? path.join("turns", `${scope.id}.json`) : "latest.json";
+  const state = {
+    version: 1,
+    eligible: true,
+    explicit: true,
+    spawned: false,
+    fallback_used: false,
+    mode: "explicit",
+    max_agents: 3,
+    max_depth: 1,
+    allow_parallel_writers: false,
+    stop_fallback: true,
+    trigger: trigger.name,
+    prompt_hash: crypto.createHash("sha1").update(prompt).digest("hex"),
+    scope_source: scope?.source || "unscoped",
+    scope_id: scope?.id || "",
+    state_file: relativeStateFile,
+    created_at: now.toISOString(),
+    created_at_epoch: Math.floor(now.getTime() / 1000),
+    updated_at: now.toISOString(),
+  };
+  if (scope) {
+    const statePath = path.join(stateDir, relativeStateFile);
+    fs.mkdirSync(path.dirname(statePath), { recursive: true });
+    fs.writeFileSync(statePath, `${JSON.stringify(state, null, 2)}\n`);
+  }
+  fs.writeFileSync(path.join(stateDir, "latest.json"), `${JSON.stringify(state, null, 2)}\n`);
+
+  const context = [
+    "[repo-harness:delegation]",
+    "",
+    "The current user prompt explicitly enabled bounded delegation.",
+    "",
+    "If this task contains at least two independent, bounded workstreams, call spawn_agent before doing the corresponding work in the parent.",
+    "",
+    "Rules:",
+    "- Spawn no more than 3 agents.",
+    "- Use explorer for read-only code mapping.",
+    "- Use worker only for an isolated implementation slice.",
+    "- Use reviewer for correctness, regression, security, and missing-test review.",
+    "- Never give two agents overlapping write ownership.",
+    "- Keep max spawn depth at 1.",
+    "- Give every agent a precise scope and required return format.",
+    "- Wait for all requested agents.",
+    "- Reconcile contradictory findings in the parent.",
+    "- Close completed agent threads.",
+    "- Do not spawn for a trivial or strictly sequential task.",
+  ].join("\n");
+
+  process.stdout.write(`${JSON.stringify({
+    hookSpecificOutput: {
+      hookEventName: "UserPromptSubmit",
+      additionalContext: context,
+    },
+  })}\n`);
+'

package/assets/hooks/codex.hooks.template.json

@@ -45,7 +45,22 @@
     "UserPromptSubmit": [
       {
         "hooks": [
-          { "type": "command", "command": "repo=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0; HOOK_HOST=codex HOOK_REPO_ROOT=\"$repo\" bash \"$repo/.ai/hooks/run-hook.sh\" prompt-guard.sh", "timeout": 30 }
+          { "type": "command", "command": "repo=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0; HOOK_HOST=codex HOOK_REPO_ROOT=\"$repo\" bash \"$repo/.ai/hooks/run-hook.sh\" prompt-guard.sh", "timeout": 30 },
+          { "type": "command", "command": "repo=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0; HOOK_HOST=codex HOOK_REPO_ROOT=\"$repo\" bash \"$repo/.ai/hooks/run-hook.sh\" codex-delegation-advisor.sh", "timeout": 30 }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "hooks": [
+          { "type": "command", "command": "repo=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0; HOOK_HOST=codex HOOK_REPO_ROOT=\"$repo\" bash \"$repo/.ai/hooks/run-hook.sh\" subagent-start-context.sh", "timeout": 30 }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          { "type": "command", "command": "repo=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0; HOOK_HOST=codex HOOK_REPO_ROOT=\"$repo\" bash \"$repo/.ai/hooks/run-hook.sh\" subagent-stop-quality.sh", "timeout": 30 }
         ]
       }
     ],

package/assets/hooks/run-hook.sh

@@ -37,16 +37,73 @@ fi
 export HOOK_REPO_ROOT="$REPO_ROOT"
 cd "$REPO_ROOT"
 
+hook_stdout_is_json_kind() {
+  local stdout_file="$1"
+  local kind="$2"
+
+  [[ -s "$stdout_file" ]] || return 1
+
+  if command -v jq >/dev/null 2>&1; then
+    case "$kind" in
+      decision)
+        jq -e '(.decision == "block") or (.decision == "allow")' "$stdout_file" >/dev/null 2>&1
+        return
+        ;;
+      user_prompt_context)
+        jq -e '.hookSpecificOutput.hookEventName == "UserPromptSubmit" and (.hookSpecificOutput.additionalContext | type == "string" and length > 0)' "$stdout_file" >/dev/null 2>&1
+        return
+        ;;
+      subagent_start_context)
+        jq -e '.hookSpecificOutput.hookEventName == "SubagentStart" and (.hookSpecificOutput.additionalContext | type == "string" and length > 0)' "$stdout_file" >/dev/null 2>&1
+        return
+        ;;
+    esac
+  fi
+
+  command -v bun >/dev/null 2>&1 || return 1
+  STDOUT_FILE="$stdout_file" JSON_KIND="$kind" bun -e '
+    const fs = require("fs");
+    const file = process.env.STDOUT_FILE;
+    const kind = process.env.JSON_KIND;
+    const raw = fs.readFileSync(file, "utf8").trim();
+    if (!raw.startsWith("{")) process.exit(1);
+    const parsed = JSON.parse(raw);
+    if (kind === "decision") {
+      process.exit(parsed.decision === "block" || parsed.decision === "allow" ? 0 : 1);
+    }
+    const specific = parsed.hookSpecificOutput || {};
+    if (
+      kind === "user_prompt_context" &&
+      specific.hookEventName === "UserPromptSubmit" &&
+      typeof specific.additionalContext === "string" &&
+      specific.additionalContext.trim()
+    ) process.exit(0);
+    if (
+      kind === "subagent_start_context" &&
+      specific.hookEventName === "SubagentStart" &&
+      typeof specific.additionalContext === "string" &&
+      specific.additionalContext.trim()
+    ) process.exit(0);
+    process.exit(1);
+  ' >/dev/null 2>&1
+}
+
 # Codex swallows hook stdout differently from Claude: success stdout is
-# dropped for every hook except session-start-context.sh, and only
-# stop-orchestrator.sh may surface its Stop decision JSON on success.
+# dropped for ordinary hooks. Only context/decision JSON for approved routes is
+# surfaced on success.
 if [[ "${HOOK_HOST:-}" == "codex" && "$HOOK_NAME" != "session-start-context.sh" ]]; then
   if ! tmp_stdout="$(mktemp)" || ! tmp_stderr="$(mktemp)"; then
     # No temp space: run unfiltered rather than silently dropping the hook.
     exec bash "$HOOK_PATH" "$@"
   fi
   if bash "$HOOK_PATH" "$@" >"$tmp_stdout" 2>"$tmp_stderr"; then
-    if [[ "$HOOK_NAME" == "stop-orchestrator.sh" ]] && grep -q '"decision"[[:space:]]*:' "$tmp_stdout"; then
+    if [[ "$HOOK_NAME" == "stop-orchestrator.sh" ]] && hook_stdout_is_json_kind "$tmp_stdout" decision; then
+      cat "$tmp_stdout"
+    elif [[ "$HOOK_NAME" == "subagent-stop-quality.sh" ]] && hook_stdout_is_json_kind "$tmp_stdout" decision; then
+      cat "$tmp_stdout"
+    elif [[ "$HOOK_NAME" == "codex-delegation-advisor.sh" ]] && hook_stdout_is_json_kind "$tmp_stdout" user_prompt_context; then
+      cat "$tmp_stdout"
+    elif [[ "$HOOK_NAME" == "subagent-start-context.sh" ]] && hook_stdout_is_json_kind "$tmp_stdout" subagent_start_context; then
       cat "$tmp_stdout"
     fi
     rm -f "$tmp_stdout" "$tmp_stderr"

package/assets/hooks/stop-orchestrator.sh

@@ -131,6 +131,115 @@ emit_stop_block_json() {
   printf '{"decision":"block","reason":"%s"}\n' "$(workflow_json_escape "$reason")"
 }
 
+delegation_state_paths_json() {
+  local state_dir
+
+  state_dir="${HOOK_REPO_ROOT:-$(pwd)}/.ai/harness/delegation"
+  [[ -f "$state_dir/latest.json" ]] || return 1
+  command -v bun >/dev/null 2>&1 || return 1
+
+  JSON_INPUT="${HOOK_STDIN_JSON:-}" DELEGATION_STATE_DIR="$state_dir" bun -e '
+    const fs = require("fs");
+    const path = require("path");
+    const crypto = require("crypto");
+
+    function sanitize(value) {
+      return String(value || "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/-{2,}/g, "-")
+        .slice(0, 120);
+    }
+
+    function firstString(input, keys) {
+      for (const key of keys) {
+        const value = input?.[key];
+        if (typeof value === "string" && value.trim()) return value;
+      }
+      return "";
+    }
+
+    function parseInput() {
+      try {
+        return JSON.parse(process.env.JSON_INPUT || "{}");
+      } catch {
+        return {};
+      }
+    }
+
+    function delegationScope(input) {
+      const runId = firstString(input, ["run_id"]);
+      if (runId) return { source: "run_id", id: `run-${sanitize(runId)}` };
+
+      const sessionId = firstString(input, ["session_id"]);
+      if (sessionId) return { source: "session_id", id: `session-${sanitize(sessionId)}` };
+
+      const transcriptPath = firstString(input, ["transcript_path"]);
+      if (transcriptPath) {
+        const digest = crypto.createHash("sha1").update(transcriptPath).digest("hex").slice(0, 16);
+        return { source: "transcript_path", id: `transcript-${digest}` };
+      }
+
+      const envSession = process.env.CODEX_SESSION_ID || process.env.CLAUDE_SESSION_ID || "";
+      if (envSession) return { source: "env_session", id: `session-${sanitize(envSession)}` };
+
+      return null;
+    }
+
+    const stateDir = process.env.DELEGATION_STATE_DIR;
+    const latestPath = path.join(stateDir, "latest.json");
+    const latest = JSON.parse(fs.readFileSync(latestPath, "utf8"));
+    const scope = delegationScope(parseInput());
+    if (latest.scope_id) {
+      if (!scope || latest.scope_id !== scope.id) process.exit(1);
+      const statePath = path.resolve(stateDir, latest.state_file || path.join("turns", `${latest.scope_id}.json`));
+      const stateRoot = path.resolve(stateDir) + path.sep;
+      if (!statePath.startsWith(stateRoot)) process.exit(1);
+      process.stdout.write(JSON.stringify({ latestPath, statePath }));
+      process.exit(0);
+    }
+    process.stdout.write(JSON.stringify({ latestPath, statePath: latestPath }));
+  ' 2>/dev/null
+}
+
+delegation_should_block() {
+  local stop_active="$1"
+  local state_paths
+
+  [[ "$stop_active" != "true" ]] || return 1
+  state_paths="$(delegation_state_paths_json)" || return 1
+  command -v bun >/dev/null 2>&1 || return 1
+
+  DELEGATION_STATE_PATHS="$state_paths" bun -e '
+    const fs = require("fs");
+    const paths = JSON.parse(process.env.DELEGATION_STATE_PATHS || "{}");
+    const state = JSON.parse(fs.readFileSync(paths.statePath, "utf8"));
+    const now = Math.floor(Date.now() / 1000);
+    const age = Number.isFinite(Number(state.created_at_epoch)) ? now - Number(state.created_at_epoch) : 0;
+    const fresh = age >= 0 && age <= 24 * 60 * 60;
+    process.exit(state.eligible === true && state.explicit === true && state.spawned !== true && state.fallback_used !== true && state.stop_fallback !== false && fresh ? 0 : 1);
+  ' >/dev/null 2>&1
+}
+
+delegation_mark_fallback_used() {
+  local state_paths
+
+  state_paths="$(delegation_state_paths_json)" || return 0
+  command -v bun >/dev/null 2>&1 || return 0
+
+  DELEGATION_STATE_PATHS="$state_paths" bun -e '
+    const fs = require("fs");
+    const paths = JSON.parse(process.env.DELEGATION_STATE_PATHS || "{}");
+    const state = JSON.parse(fs.readFileSync(paths.statePath, "utf8"));
+    state.fallback_used = true;
+    state.fallback_used_at = new Date().toISOString();
+    state.updated_at = state.fallback_used_at;
+    fs.writeFileSync(paths.statePath, `${JSON.stringify(state, null, 2)}\n`);
+    fs.writeFileSync(paths.latestPath, `${JSON.stringify(state, null, 2)}\n`);
+  ' >/dev/null 2>&1 || true
+}
+
 refresh_handoff() {
   workflow_write_handoff "session-stop"
   echo "[FinalizeHandoff] Refreshed $(workflow_handoff_file)." >&2
@@ -167,5 +276,11 @@ if should_run_plan_completeness_gate "$stop_hook_active" "$last_assistant_messag
     emit_stop_block_json "[PlanCompletenessGate] A first planning answer was produced while pending orchestration is still open: ${summary}
 
 ${guidance}"
+    exit 0
   fi
 fi
+
+if delegation_should_block "$stop_hook_active"; then
+  delegation_mark_fallback_used
+  emit_stop_block_json "[DelegationFallback] This turn explicitly requested bounded delegation, but no SubagentStart event was observed. Continue the task now by spawning the independent explorer/reviewer or isolated worker workstreams first when at least two independent workstreams exist, wait for them, reconcile their findings in the parent, then complete the response. Do not spawn for a trivial or strictly sequential task."
+fi