@humwick/runner 0.130.4 → 0.130.6

package/plugins/claude/monitors/relay-monitor.provisioned.mjs

@@ -1,20 +1,36 @@
 // @bun
 // sdk/src/env.ts
-function legacyEnvName(name) {
-  return name.startsWith("HUMWICK_") ? "AGENT_RELAY_" + name.slice(8) : name;
+function relayEnv(env, name) {
+  return env?.[name];
 }
-function canonicalEnvName(name) {
-  return name.startsWith("AGENT_RELAY_") ? "HUMWICK_" + name.slice(12) : name;
+
+// sdk/src/types/guards.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function relayEnv(env, name) {
-  const legacy = legacyEnvName(name);
-  const canonical = canonicalEnvName(legacy);
-  const value = env?.[canonical];
-  const fallback = canonical === legacy ? value : env?.[legacy];
-  if (value !== undefined && fallback !== undefined && value !== fallback) {
-    console.warn(`Conflicting environment keys ${canonical} and ${legacy}; using ${canonical}`);
-  }
-  return value !== undefined ? value : fallback;
+
+// sdk/src/stored-names.ts
+var STORED_NAMES = {
+  source: "humwick",
+  profileKey: "humwick",
+  channelSchema: "humwick.channel.v1",
+  reactionSchema: "humwick.reaction.v1",
+  connectorSchema: "humwick.connector.v1",
+  bundledSource: "humwick-bundled",
+  bundledSeed: "humwick-bundled-seed",
+  qaSeed: "humwick-qa-skill-seed",
+  callmuxSeed: "humwick-shared-callmux-seed",
+  taskCommentMarker: "humwick:task-comment"
+};
+var SHARED_PROFILE_CAPABILITIES = {
+  instructions: `${STORED_NAMES.source}.instructions`,
+  mcp: `${STORED_NAMES.source}.mcp`,
+  hooks: `${STORED_NAMES.source}.hooks`,
+  skills: `${STORED_NAMES.source}.skills`,
+  plugins: `${STORED_NAMES.source}.plugins`
+};
+function readHumwickRecord(value) {
+  return isRecord(value?.humwick) ? value.humwick : undefined;
 }
 
 // sdk/src/types/users.ts
@@ -42,17 +58,12 @@ function heldForSender(message) {
   return typeof heldFor === "string" && heldFor ? heldFor : undefined;
 }
 
-// sdk/src/types/guards.ts
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
 // runner/src/message-body-config/config.ts
 function monitorDeliveryMaxCharsFromEnv() {
-  return relayEnv(process.env, "AGENT_RELAY_MONITOR_DELIVERY_MAX_CHARS");
+  return relayEnv(process.env, "HUMWICK_MONITOR_DELIVERY_MAX_CHARS");
 }
 function monitorDeliveryLineMaxCharsFromEnv() {
-  return relayEnv(process.env, "AGENT_RELAY_MONITOR_DELIVERY_LINE_MAX_CHARS");
+  return relayEnv(process.env, "HUMWICK_MONITOR_DELIVERY_LINE_MAX_CHARS");
 }
 // runner/src/relay-instructions.ts
 import { existsSync } from "fs";
@@ -81,8 +92,8 @@ function lines(...parts) {
   return parts.join(`
 `);
 }
-var RELAY_RUN_STANDING_INSTRUCTIONS = lines("## Long-running commands", "Run commands that may print secrets (ssh to hosts, reading env/config files, secret tooling) through `relay_run`, never raw Bash/shell tools. Relay masks stdout/stderr before storing logs or returning output, even on a nonzero exit; masker failures withhold output. Inspect exitCode, signal and timedOut. Reference secret files or variables; never paste secret literals into the command.", "Run long commands, gates, builds and tests through `relay_run` with `waitMs: 0`, then END YOUR TURN and wait for Relay's completion wake (finish, failure or timeout). If it returns queued or still-running, end your turn too.", "Waiting for a condition (epoch closes, deploy finishes, land merges, service healthy, file appears) is also a long command: start ONE detached `relay_run` whose command is a poll loop with a deadline (e.g. `timeout 30m bash -c 'until <check>; do sleep 20; done'`), then END YOUR TURN with no text. Never check once per turn, sleep in the foreground, or keep the turn alive with Monitor/until loops: every turn end is forwarded to your parent as a message.", "A detached wait is exempt from periodic progress-update instructions, including updates every 60 seconds. Never poll with `relay_run{runId}`, `write_stdin`, sleep, ps or tail. Resume on the completion notification and check the reported exit status; missing output or exit status is not a pass.", "This rule overrides older profile, working-state, compaction or recovery guidance that recommends raw exec sessions or polling for long commands. Do not edit the worktree while validation is running.");
-var RELAY_REPLY_INSTRUCTIONS = 'Reply to an agent\'s Relay message with `relay_reply` (messageId, body). CLI fallback: `agent-relay /reply <messageId> "<your reply>"`. Your turn response reaches the human user automatically: never send the user a Relay message to answer them. Send one reply per batch to the latest relevant message. Send no status-only confirmations.';
+var RELAY_RUN_STANDING_INSTRUCTIONS = lines("## Long-running commands", "Run commands that may print secrets (ssh to hosts, reading env/config files, secret tooling) through `humwick_run`, never raw Bash/shell tools. Relay masks stdout/stderr before storing logs or returning output, even on a nonzero exit; masker failures withhold output. Inspect exitCode, signal and timedOut. Reference secret files or variables; never paste secret literals into the command.", "Run long commands, gates, builds and tests through `humwick_run` with `waitMs: 0`, then END YOUR TURN and wait for Relay's completion wake (finish, failure or timeout). If it returns queued or still-running, end your turn too.", "Waiting for a condition (epoch closes, deploy finishes, land merges, service healthy, file appears) is also a long command: start ONE detached `humwick_run` whose command is a poll loop with a deadline (e.g. `timeout 30m bash -c 'until <check>; do sleep 20; done'`), then END YOUR TURN with no text. Never check once per turn, sleep in the foreground, or keep the turn alive with Monitor/until loops: every turn end is forwarded to your parent as a message.", "A detached wait is exempt from periodic progress-update instructions, including updates every 60 seconds. Never poll with `humwick_run{runId}`, `write_stdin`, sleep, ps or tail. Resume on the completion notification and check the reported exit status; missing output or exit status is not a pass.", "This rule overrides older profile, working-state, compaction or recovery guidance that recommends raw exec sessions or polling for long commands. Do not edit the worktree while validation is running.");
+var RELAY_REPLY_INSTRUCTIONS = 'Reply to an agent\'s Relay message with `humwick_reply` (messageId, body). CLI fallback: `humwick /reply <messageId> "<your reply>"`. Your turn response reaches the human user automatically: never send the user a Relay message to answer them. Send one reply per batch to the latest relevant message. Send no status-only confirmations.';
 var REPOSITORY_SEARCH_FALLBACK = "Use available tools for repository search. If MCP search tools are missing or fail, use shell search (rg, grep, or find) and continue; never stall on a missing tool.";
 var AGENT_CORE_TEMPLATE_SLUG = "relay.agent-core";
 var TEMP_DIR_TEMPLATE_SLUG = "relay.temp-dir";
@@ -92,7 +103,7 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     slug: TEMP_DIR_TEMPLATE_SLUG,
     category: "runner",
     title: "Private Temp Dir",
-    description: "Shown to every session with Relay context: the agent's TMPDIR is private and reaped (#3084).",
+    description: "Shown to every session with Relay context: the agent's TMPDIR is private and reaped.",
     template: TEMP_DIR_RULE,
     defaultTemplate: TEMP_DIR_RULE,
     variables: []
@@ -119,7 +130,7 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     slug: "relay.web.fetch",
     category: "runner",
     title: "URL Reader Steer (local first)",
-    description: "The page-reader capability: {{tools}} is local; {{fallback}} is keyless Jina. Replaces the old Jina-first steer (#3242).",
+    description: "The page-reader capability: {{tools}} is local; {{fallback}} is keyless Jina. Replaces the old Jina-first steer.",
     template: "Read a known URL: use the self-hosted page reader {{tools}} first. Use max_length (default 5000 characters) and start_index to read large pages in chunks; respect robots.txt refusals. Only if it fails or returns unusable JS-heavy content, use keyless Jina {{fallback}} with url only (no question or API key). Jina shares a low per-IP limit across the fleet; if it also fails, use the built-in fetch once. Never retry in a loop or use readers to search.",
     defaultTemplate: "Read a known URL: use the self-hosted page reader {{tools}} first. Use max_length (default 5000 characters) and start_index to read large pages in chunks; respect robots.txt refusals. Only if it fails or returns unusable JS-heavy content, use keyless Jina {{fallback}} with url only (no question or API key). Jina shares a low per-IP limit across the fleet; if it also fails, use the built-in fetch once. Never retry in a loop or use readers to search.",
     variables: ["tools", "fallback"]
@@ -146,8 +157,8 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     category: "runner",
     title: "Claude Relay Manual",
     description: "Bundled CLAUDE.md relay manual written into provisioned Claude homes.",
-    template: lines("# Agent Relay", "", "- Relay messages can come from people, channels, or agents. Read the body and do the work.", "- For a truncated delivery stub, fetch its body with `relay_get_message` (messageId) or `agent-relay get-message <messageId>`.", "- Do not reply to pure info, passive acknowledgements, or reactions without an action request. Never reply or react to a notification-class message; act on it if relevant.", "- If a provider permission prompt holds your current tool call and Relay tools still work, tell your coordinator which tool is held. Do not depend on this report for rescue: a prompt on the Relay call itself can block reporting.", "- Use `agent-relay /react <messageId> <emoji>` for lightweight acknowledgement, approval, thanks, praise, a completed handoff, or an FYI\u2014not questions, tasks, bugs, or textual results. \uD83D\uDC4D to your question approves proceeding; \uD83D\uDC4D to completed status means no further action.", "- Use `agent-relay /status --json` for identity and `agent-relay /guide` for command details."),
-    defaultTemplate: lines("# Agent Relay", "", "- Relay messages can come from people, channels, or agents. Read the body and do the work.", "- For a truncated delivery stub, fetch its body with `relay_get_message` (messageId) or `agent-relay get-message <messageId>`.", "- Do not reply to pure info, passive acknowledgements, or reactions without an action request. Never reply or react to a notification-class message; act on it if relevant.", "- If a provider permission prompt holds your current tool call and Relay tools still work, tell your coordinator which tool is held. Do not depend on this report for rescue: a prompt on the Relay call itself can block reporting.", "- Use `agent-relay /react <messageId> <emoji>` for lightweight acknowledgement, approval, thanks, praise, a completed handoff, or an FYI\u2014not questions, tasks, bugs, or textual results. \uD83D\uDC4D to your question approves proceeding; \uD83D\uDC4D to completed status means no further action.", "- Use `agent-relay /status --json` for identity and `agent-relay /guide` for command details."),
+    template: lines("# Humwick", "", "- Relay messages can come from people, channels, or agents. Read the body and do the work.", "- For a truncated delivery stub, fetch its body with `humwick_get_message` (messageId) or `humwick get-message <messageId>`.", "- Do not reply to pure info, passive acknowledgements, or reactions without an action request. Never reply or react to a notification-class message; act on it if relevant.", "- If a provider permission prompt holds your current tool call and Relay tools still work, tell your coordinator which tool is held. Do not depend on this report for rescue: a prompt on the Relay call itself can block reporting.", "- Use `humwick /react <messageId> <emoji>` for lightweight acknowledgement, approval, thanks, praise, a completed handoff, or an FYI\u2014not questions, tasks, bugs, or textual results. \uD83D\uDC4D to your question approves proceeding; \uD83D\uDC4D to completed status means no further action.", "- Use `humwick /status --json` for identity and `humwick /guide` for command details."),
+    defaultTemplate: lines("# Humwick", "", "- Relay messages can come from people, channels, or agents. Read the body and do the work.", "- For a truncated delivery stub, fetch its body with `humwick_get_message` (messageId) or `humwick get-message <messageId>`.", "- Do not reply to pure info, passive acknowledgements, or reactions without an action request. Never reply or react to a notification-class message; act on it if relevant.", "- If a provider permission prompt holds your current tool call and Relay tools still work, tell your coordinator which tool is held. Do not depend on this report for rescue: a prompt on the Relay call itself can block reporting.", "- Use `humwick /react <messageId> <emoji>` for lightweight acknowledgement, approval, thanks, praise, a completed handoff, or an FYI\u2014not questions, tasks, bugs, or textual results. \uD83D\uDC4D to your question approves proceeding; \uD83D\uDC4D to completed status means no further action.", "- Use `humwick /status --json` for identity and `humwick /guide` for command details."),
     variables: []
   },
   {
@@ -155,8 +166,8 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     category: "runner",
     title: "Claude Relay Context",
     description: "One-line relay context note for Claude sessions.",
-    template: "[agent-relay] Relay is available. Follow the Agent Relay rules in CLAUDE.md when present, or run agent-relay /guide.",
-    defaultTemplate: "[agent-relay] Relay is available. Follow the Agent Relay rules in CLAUDE.md when present, or run agent-relay /guide.",
+    template: "[humwick] Relay is available. Follow the Humwick rules in CLAUDE.md when present, or run humwick /guide.",
+    defaultTemplate: "[humwick] Relay is available. Follow the Humwick rules in CLAUDE.md when present, or run humwick /guide.",
     variables: []
   },
   {
@@ -164,8 +175,8 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     category: "runner",
     title: "Claude Relay Context (Read Only)",
     description: "Read-only relay context note for Claude sessions.",
-    template: lines("[agent-relay] Relay is available. Follow the Agent Relay rules in CLAUDE.md when present, or run agent-relay /guide.", "", "This Claude session is running with restricted read-only Relay permissions. Do not invoke Agent Relay skills. Use the CLI for Relay actions."),
-    defaultTemplate: lines("[agent-relay] Relay is available. Follow the Agent Relay rules in CLAUDE.md when present, or run agent-relay /guide.", "", "This Claude session is running with restricted read-only Relay permissions. Do not invoke Agent Relay skills. Use the CLI for Relay actions."),
+    template: lines("[humwick] Relay is available. Follow the Humwick rules in CLAUDE.md when present, or run humwick /guide.", "", "This Claude session is running with restricted read-only Relay permissions. Do not invoke Humwick skills. Use the CLI for Relay actions."),
+    defaultTemplate: lines("[humwick] Relay is available. Follow the Humwick rules in CLAUDE.md when present, or run humwick /guide.", "", "This Claude session is running with restricted read-only Relay permissions. Do not invoke Humwick skills. Use the CLI for Relay actions."),
     variables: []
   },
   {
@@ -173,8 +184,8 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     category: "runner",
     title: "Codex Relay Context",
     description: "Relay context note injected into Codex sessions.",
-    template: "[agent-relay] Relay is available. Identity and capabilities are in `## Agent Relay Identity`; tool access follows those capabilities. Details: `agent-relay /guide`.",
-    defaultTemplate: "[agent-relay] Relay is available. Identity and capabilities are in `## Agent Relay Identity`; tool access follows those capabilities. Details: `agent-relay /guide`.",
+    template: "[humwick] Relay is available. Identity and capabilities are in `## Humwick Identity`; tool access follows those capabilities. Details: `humwick /guide`.",
+    defaultTemplate: "[humwick] Relay is available. Identity and capabilities are in `## Humwick Identity`; tool access follows those capabilities. Details: `humwick /guide`.",
     variables: []
   },
   {
@@ -182,8 +193,8 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     category: "runner",
     title: "OpenCode Relay Context",
     description: "Relay context note injected into OpenCode sessions.",
-    template: "[agent-relay] Relay messages can come from people, channels, or agents: read each message and do its work. Fetch a truncated delivery with `agent-relay get-message <messageId>`. Use `agent-relay /react <messageId> <emoji>` only for lightweight acknowledgement. Run `agent-relay /status --json` for identity and `agent-relay /guide` for command details.",
-    defaultTemplate: "[agent-relay] Relay messages can come from people, channels, or agents: read each message and do its work. Fetch a truncated delivery with `agent-relay get-message <messageId>`. Use `agent-relay /react <messageId> <emoji>` only for lightweight acknowledgement. Run `agent-relay /status --json` for identity and `agent-relay /guide` for command details.",
+    template: "[humwick] Relay messages can come from people, channels, or agents: read each message and do its work. Fetch a truncated delivery with `humwick get-message <messageId>`. Use `humwick /react <messageId> <emoji>` only for lightweight acknowledgement. Run `humwick /status --json` for identity and `humwick /guide` for command details.",
+    defaultTemplate: "[humwick] Relay messages can come from people, channels, or agents: read each message and do its work. Fetch a truncated delivery with `humwick get-message <messageId>`. Use `humwick /react <messageId> <emoji>` only for lightweight acknowledgement. Run `humwick /status --json` for identity and `humwick /guide` for command details.",
     variables: []
   },
   {
@@ -191,8 +202,8 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     category: "runner",
     title: "Runner Workspace Lifecycle Note",
     description: "Lifecycle note injected by the runner for isolated workspaces.",
-    template: lines("[agent-relay] You are in worktree branch {{branch}}, based on {{baseRef}}, not main. Other agents land to {{baseRef}}; it moving is normal.", "While iterating, run only affected tests via the project command when available; the full gate runs automatically at land/merge.", "Commit here; pushing your own branch and rebasing before delivery are allowed. Never push to main or {{baseRef}}; never rebase or rewrite history after a `complete` delivery has armed a land. Do not merge, resolve conflicts, or enter the main checkout. Relay/steward own those and may rebase in background. When done, self-report the configured validation result through `relay_task_deliver` with `complete`, summary, commits, and passing `typecheck` + `test` gates when the diff touches code/test/config paths. It skips code gates for empty/docs-only diffs, rebases onto {{baseRef}}, lands, and pushes.", "Accepted delivery means status becomes `ready`: NORMAL, healthy handoff, not a stall. Stop your turn; do not poll. Clean rebases auto-merge about every two minutes; a steward appears only when deterministic landing fails. Relay wakes `landed-success` or `landed-failure`; on success it keeps this worktree on its current post-land branch, and the next delivery rebases it against the latest base. `agent-relay workspace status` shows the next step."),
-    defaultTemplate: lines("[agent-relay] You are in worktree branch {{branch}}, based on {{baseRef}}, not main. Other agents land to {{baseRef}}; it moving is normal.", "While iterating, run only affected tests via the project command when available; the full gate runs automatically at land/merge.", "Commit here; pushing your own branch and rebasing before delivery are allowed. Never push to main or {{baseRef}}; never rebase or rewrite history after a `complete` delivery has armed a land. Do not merge, resolve conflicts, or enter the main checkout. Relay/steward own those and may rebase in background. When done, self-report the configured validation result through `relay_task_deliver` with `complete`, summary, commits, and passing `typecheck` + `test` gates when the diff touches code/test/config paths. It skips code gates for empty/docs-only diffs, rebases onto {{baseRef}}, lands, and pushes.", "Accepted delivery means status becomes `ready`: NORMAL, healthy handoff, not a stall. Stop your turn; do not poll. Clean rebases auto-merge about every two minutes; a steward appears only when deterministic landing fails. Relay wakes `landed-success` or `landed-failure`; on success it keeps this worktree on its current post-land branch, and the next delivery rebases it against the latest base. `agent-relay workspace status` shows the next step."),
+    template: lines("[humwick] You are in worktree branch {{branch}}, based on {{baseRef}}, not main. Other agents land to {{baseRef}}; it moving is normal.", "While iterating, run only affected tests via the project command when available; the full gate runs automatically at land/merge.", "Commit here; pushing your own branch and rebasing before delivery are allowed. Never push to main or {{baseRef}}; never rebase or rewrite history after a `complete` delivery has armed a land. Do not merge, resolve conflicts, or enter the main checkout. Relay/steward own those and may rebase in background. When done, self-report the configured validation result through `humwick_task_deliver` with `complete`, summary, commits, and passing `typecheck` + `test` gates when the diff touches code/test/config paths. It skips code gates for empty/docs-only diffs, rebases onto {{baseRef}}, lands, and pushes.", "Accepted delivery means status becomes `ready`: NORMAL, healthy handoff, not a stall. Stop your turn; do not poll. Clean rebases auto-merge about every two minutes; a steward appears only when deterministic landing fails. Relay wakes `landed-success` or `landed-failure`; on success it keeps this worktree on its current post-land branch, and the next delivery rebases it against the latest base. `humwick workspace status` shows the next step."),
+    defaultTemplate: lines("[humwick] You are in worktree branch {{branch}}, based on {{baseRef}}, not main. Other agents land to {{baseRef}}; it moving is normal.", "While iterating, run only affected tests via the project command when available; the full gate runs automatically at land/merge.", "Commit here; pushing your own branch and rebasing before delivery are allowed. Never push to main or {{baseRef}}; never rebase or rewrite history after a `complete` delivery has armed a land. Do not merge, resolve conflicts, or enter the main checkout. Relay/steward own those and may rebase in background. When done, self-report the configured validation result through `humwick_task_deliver` with `complete`, summary, commits, and passing `typecheck` + `test` gates when the diff touches code/test/config paths. It skips code gates for empty/docs-only diffs, rebases onto {{baseRef}}, lands, and pushes.", "Accepted delivery means status becomes `ready`: NORMAL, healthy handoff, not a stall. Stop your turn; do not poll. Clean rebases auto-merge about every two minutes; a steward appears only when deterministic landing fails. Relay wakes `landed-success` or `landed-failure`; on success it keeps this worktree on its current post-land branch, and the next delivery rebases it against the latest base. `humwick workspace status` shows the next step."),
     variables: ["branch", "baseRef"]
   },
   {
@@ -200,8 +211,8 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     category: "runner",
     title: "Runner Workspace Deps Symlink Note",
     description: "Symlinked node_modules caveat injected by the runner.",
-    template: "[agent-relay] Isolated workspace: this is a git worktree, and its node_modules are SYMLINKED from the main checkout \u2014 dependencies are already installed and ready to use. Do NOT run a clean dependency install (`bun install` / `npm install` / `pnpm install`): it writes through the symlink and mutates the main checkout's shared node_modules. Build caches written under node_modules are shared too. If typecheck/build fails on a missing module (a dependency added to the base AFTER this worktree was created), run `agent-relay workspace deps` \u2014 it re-provisions only the stale dirs with a real isolated install, safely, without touching the shared node_modules. If you genuinely need to change dependencies in isolation, ask the host to spawn with AGENT_RELAY_WORKSPACE_DEPS=install.",
-    defaultTemplate: "[agent-relay] Isolated workspace: this is a git worktree, and its node_modules are SYMLINKED from the main checkout \u2014 dependencies are already installed and ready to use. Do NOT run a clean dependency install (`bun install` / `npm install` / `pnpm install`): it writes through the symlink and mutates the main checkout's shared node_modules. Build caches written under node_modules are shared too. If typecheck/build fails on a missing module (a dependency added to the base AFTER this worktree was created), run `agent-relay workspace deps` \u2014 it re-provisions only the stale dirs with a real isolated install, safely, without touching the shared node_modules. If you genuinely need to change dependencies in isolation, ask the host to spawn with AGENT_RELAY_WORKSPACE_DEPS=install.",
+    template: "[humwick] Isolated workspace: this is a git worktree, and its node_modules are SYMLINKED from the main checkout \u2014 dependencies are already installed and ready to use. Do NOT run a clean dependency install (`bun install` / `npm install` / `pnpm install`): it writes through the symlink and mutates the main checkout's shared node_modules. Build caches written under node_modules are shared too. If typecheck/build fails on a missing module (a dependency added to the base AFTER this worktree was created), run `humwick workspace deps` \u2014 it re-provisions only the stale dirs with a real isolated install, safely, without touching the shared node_modules. If you genuinely need to change dependencies in isolation, ask the host to spawn with HUMWICK_WORKSPACE_DEPS=install.",
+    defaultTemplate: "[humwick] Isolated workspace: this is a git worktree, and its node_modules are SYMLINKED from the main checkout \u2014 dependencies are already installed and ready to use. Do NOT run a clean dependency install (`bun install` / `npm install` / `pnpm install`): it writes through the symlink and mutates the main checkout's shared node_modules. Build caches written under node_modules are shared too. If typecheck/build fails on a missing module (a dependency added to the base AFTER this worktree was created), run `humwick workspace deps` \u2014 it re-provisions only the stale dirs with a real isolated install, safely, without touching the shared node_modules. If you genuinely need to change dependencies in isolation, ask the host to spawn with HUMWICK_WORKSPACE_DEPS=install.",
     variables: []
   },
   {
@@ -209,8 +220,8 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     category: "runner",
     title: "Runner Workspace Deps Command Note",
     description: "Repository-command dependency provisioning note injected by the runner.",
-    template: "[agent-relay] Isolated workspace: dependencies were provisioned by the repository command `{{installCommand}}`; node_modules is real, not shared with the main checkout. If dependencies drift, run `{{installCommand}}` yourself from the worktree root (or `agent-relay workspace deps` to ask Relay to rerun it).",
-    defaultTemplate: "[agent-relay] Isolated workspace: dependencies were provisioned by the repository command `{{installCommand}}`; node_modules is real, not shared with the main checkout. If dependencies drift, run `{{installCommand}}` yourself from the worktree root (or `agent-relay workspace deps` to ask Relay to rerun it).",
+    template: "[humwick] Isolated workspace: dependencies were provisioned by the repository command `{{installCommand}}`; node_modules is real, not shared with the main checkout. If dependencies drift, run `{{installCommand}}` yourself from the worktree root (or `humwick workspace deps` to ask Relay to rerun it).",
+    defaultTemplate: "[humwick] Isolated workspace: dependencies were provisioned by the repository command `{{installCommand}}`; node_modules is real, not shared with the main checkout. If dependencies drift, run `{{installCommand}}` yourself from the worktree root (or `humwick workspace deps` to ask Relay to rerun it).",
     variables: ["installCommand"]
   },
   {
@@ -218,8 +229,8 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     category: "runner",
     title: "Runner Workspace Deps None Note",
     description: "Missing dependency provisioning caveat injected by the runner.",
-    template: "[agent-relay] Isolated workspace: dependencies were not provisioned (AGENT_RELAY_WORKSPACE_DEPS=none). You may need to install node_modules before typecheck/test/build work.",
-    defaultTemplate: "[agent-relay] Isolated workspace: dependencies were not provisioned (AGENT_RELAY_WORKSPACE_DEPS=none). You may need to install node_modules before typecheck/test/build work.",
+    template: "[humwick] Isolated workspace: dependencies were not provisioned (HUMWICK_WORKSPACE_DEPS=none). You may need to install node_modules before typecheck/test/build work.",
+    defaultTemplate: "[humwick] Isolated workspace: dependencies were not provisioned (HUMWICK_WORKSPACE_DEPS=none). You may need to install node_modules before typecheck/test/build work.",
     variables: []
   },
   {
@@ -227,8 +238,8 @@ var RUNNER_PROMPT_TEMPLATE_DEFAULTS = [
     category: "runner",
     title: "Runner Workspace Symlink Note",
     description: "Write-through symlink caveat injected by the runner.",
-    template: "[agent-relay] Isolated workspace: these untracked paths are SYMLINKED from the main checkout: {{linked}}. They resolve to the real files in main, so editing or deleting them writes THROUGH to main \u2014 treat them as read-only unless you intend to change main.",
-    defaultTemplate: "[agent-relay] Isolated workspace: these untracked paths are SYMLINKED from the main checkout: {{linked}}. They resolve to the real files in main, so editing or deleting them writes THROUGH to main \u2014 treat them as read-only unless you intend to change main.",
+    template: "[humwick] Isolated workspace: these untracked paths are SYMLINKED from the main checkout: {{linked}}. They resolve to the real files in main, so editing or deleting them writes THROUGH to main \u2014 treat them as read-only unless you intend to change main.",
+    defaultTemplate: "[humwick] Isolated workspace: these untracked paths are SYMLINKED from the main checkout: {{linked}}. They resolve to the real files in main, so editing or deleting them writes THROUGH to main \u2014 treat them as read-only unless you intend to change main.",
     variables: []
   }
 ];
@@ -266,7 +277,7 @@ function resolveRelayContext(input) {
   return { available: text.length > 0, text };
 }
 function webToolsSteer(names, claude) {
-  return names.map((name) => name === "brave" ? `Web search: use ${claude ? "web_search on the agent-relay MCP server (load with ToolSearch)" : "web_search on the agent-relay MCP server"}. Relay tries Tavily, then budget-capped Brave. If the monthly cap is reached, report it; do not retry in a loop.` : renderRunnerTemplate("relay.web.fetch", {
+  return names.map((name) => name === "brave" ? `Web search: use ${claude ? "web_search on the humwick MCP server (load with ToolSearch)" : "web_search on the humwick MCP server"}. Relay tries Tavily, then budget-capped Brave. If the monthly cap is reached, report it; do not retry in a loop.` : renderRunnerTemplate("relay.web.fetch", {
     tools: webToolSteerRefs(name, claude),
     fallback: webToolSteerRefs(name, claude, true)
   })).join(`
@@ -305,7 +316,7 @@ function workspaceSymlinksNote(linked) {
   return renderRunnerTemplate("workspace.symlinks", { linked: linked.join(", ") });
 }
 function workspaceDepsNoteFromEnv(env = process.env) {
-  const json = relayEnv(env, "AGENT_RELAY_WORKSPACE_JSON");
+  const json = relayEnv(env, "HUMWICK_WORKSPACE_JSON");
   if (!json)
     return "";
   try {
@@ -366,8 +377,8 @@ function attachmentLabel(ref) {
 }
 function attachmentCacheMetadata(ref) {
   const metadata = isRecord(ref.metadata) ? ref.metadata : undefined;
-  const agentRelay = metadata && isRecord(metadata.agentRelay) ? metadata.agentRelay : undefined;
-  return agentRelay;
+  const humwick = readHumwickRecord(metadata);
+  return humwick;
 }
 function isMemoryInjection(message) {
   return isRecord(message.payload) && message.payload.memoryInjection === true;
@@ -430,10 +441,10 @@ function providerAttachmentText(message) {
   const canFetchMessage = isPersistedRelayMessage(message);
   const guidance = !canFetchMessage ? [] : hasLocalPaths ? [
     "Use the local path above when inspecting the attachment.",
-    `Read attachment details: agent-relay get-message ${message.id} --json`
+    `Read attachment details: humwick get-message ${message.id} --json`
   ] : [
-    `Read attachment details: agent-relay get-message ${message.id} --json`,
-    `Fetch content: curl -fsS -H "X-Agent-Relay-Token: $AGENT_RELAY_TOKEN" "$AGENT_RELAY_URL/api/artifacts/<artifactId>/content" -o <filename>`
+    `Read attachment details: humwick get-message ${message.id} --json`,
+    `Fetch content: curl -fsS -H "X-Humwick-Token: $HUMWICK_TOKEN" "$HUMWICK_URL/api/artifacts/<artifactId>/content" -o <filename>`
   ];
   return [
     "Attachments:",
@@ -539,7 +550,7 @@ function spillMustKeepSection(section, spillDir, reserved) {
   const bracket = `[${boundLabel(label, MAX_DISPLAY_LABEL_CHARS)} \u2014 spilled to disk, read it now]`;
   const references = [
     `Full content (byte-exact): ${filePath}`,
-    `File: ${fileName} \u2014 in your session scratch tmp dir ($AGENT_RELAY_SCRATCH_DIR)`,
+    `File: ${fileName} \u2014 in your session scratch tmp dir ($HUMWICK_SCRATCH_DIR)`,
     `File: ${fileName} (scratch dir)`,
     `File: ${fileName}`
   ];
@@ -556,6 +567,26 @@ ${reference}`;
     spilled: false
   };
 }
+function readableEvent(items, reserved) {
+  const texts = items.map((item) => item.text);
+  let totalChars = texts.reduce((sum, text) => sum + text.length, Math.max(0, texts.length - 1) * 2);
+  for (let i = 0;i < items.length; i++) {
+    const item = items[i];
+    if (!item.stub)
+      continue;
+    for (const candidate of [item.full, item.preview]) {
+      if (candidate === undefined)
+        continue;
+      const otherChars = totalChars - texts[i].length;
+      if (!fitsMonitorDelivery(candidate, { reserved: reserved + otherChars }))
+        continue;
+      texts[i] = candidate;
+      totalChars = otherChars + candidate.length;
+      break;
+    }
+  }
+  return { events: items.length ? [{ text: join(texts), messageIds: idsOf(items) }] : [] };
+}
 function packWithDeferredNotice(items, reserved) {
   let kept = [];
   const DEFERRED_NOTICE_BUDGET = 100;
@@ -587,7 +618,7 @@ function planClaudeMonitorDelivery(sections, options = {}) {
   const rendered = sections.map((section) => ({ ...section, text: section.stub ?? section.full }));
   const allStubbed = join(rendered.map((section) => section.text));
   if (fitsMonitorDelivery(allStubbed, { reserved })) {
-    return { events: [{ text: allStubbed, messageIds: idsOf(rendered) }] };
+    return readableEvent(rendered, reserved);
   }
   const mustKeep = rendered.filter((section) => !section.stub && section.kind !== "disposable");
   const optional = rendered.filter((section) => section.stub || section.kind === "disposable");
@@ -619,7 +650,7 @@ function planClaudeMonitorDelivery(sections, options = {}) {
       chunk = withSubstitute;
     }
   }
-  return { events: chunk.length ? [{ text: join(chunk.map((item) => item.text)), messageIds: idsOf(chunk) }] : [] };
+  return readableEvent(chunk, reserved);
 }
 
 // runner/src/adapters/claude-delivery.ts
@@ -646,7 +677,7 @@ function formatMessage(message, relaySurface) {
   const rawBody = relaySurface ? message.body : stripRelayScaffolding(message.body);
   if (isMemoryContext) {
     return [
-      `[agent-relay ${isSelfResumeInjection(message) ? "self-resume continuation" : "context"} from ${message.from}]`,
+      `[humwick ${isSelfResumeInjection(message) ? "self-resume continuation" : "context"} from ${message.from}]`,
       providerAttachmentText(message),
       `${subject}${rawBody}`
     ].filter(Boolean).join(`
@@ -706,17 +737,20 @@ function taskDeliverableSummary(message) {
     lines.push(clampToLine(`Next: ${nextAction}`));
   return lines.length > 0 ? lines : undefined;
 }
-function stubMessage(message) {
+function stubMessage(message, includePreview = false) {
   const gist = message.subject ? `Subject: ${clampToLine(message.subject)}` : firstSentence(message.body);
+  const preview = includePreview ? truncateToCaps(message.body, 400, monitorDeliveryLineMaxChars()) : "";
   const summary = taskDeliverableSummary(message);
   const fetchTarget = message.messageType === "final-turn" && message.sourceMessageId ? message.sourceMessageId : message.id;
   const finalTurn = message.messageType === "final-turn" ? " | final turn" : "";
   return [
     receivesTurnResponseAutomatically(message.from) ? undefined : `[relay message #${message.id} from ${providerSenderLabel(message)}${finalTurn}]`,
-    gist || undefined,
+    message.subject || !preview ? gist || undefined : undefined,
     ...summary ?? [],
     message.threadId !== undefined ? `Thread: #${message.threadId}` : undefined,
-    `Over monitor size limit \u2014 full ${message.messageType === "final-turn" ? "turn" : "message"}: relay_get_message #${fetchTarget} (CLI: agent-relay get-message ${fetchTarget})`
+    preview ? `Body preview (${preview.length} of ${message.body.length} chars):
+${preview}` : undefined,
+    `Over monitor size limit \u2014 full ${message.messageType === "final-turn" ? "turn" : "message"}: humwick_get_message #${fetchTarget} (CLI: humwick get-message ${fetchTarget})`
   ].filter(Boolean).join(`
 `);
 }
@@ -726,7 +760,7 @@ function claudeMonitorDeliveryPlan(messages, options = {}) {
   const sections = uniqueMessages.map((message) => ({
     id: isPersistedRelayMessage(message) ? message.id : undefined,
     full: formatMessage(message, relaySurface),
-    ...isStubbable(message) ? { stub: stubMessage(message) } : { kind: nonStubbableSectionKind(message), label: nonStubbableSectionLabel(message) }
+    ...isStubbable(message) ? { stub: stubMessage(message), preview: stubMessage(message, true) } : { kind: nonStubbableSectionKind(message), label: nonStubbableSectionLabel(message) }
   }));
   if (relaySurface && uniqueMessages.length > 0 && uniqueMessages.every((message) => isNotificationMessage(message) && !receivesTurnResponseAutomatically(message.from))) {
     sections.push({ id: undefined, full: NOTIFICATION_NUDGE, kind: "disposable", label: "notification" });
@@ -740,7 +774,7 @@ function claudeMonitorDeliveryPlan(messages, options = {}) {
 }
 
 // runner/plugins/claude/monitors/relay-monitor.ts
-var port = relayEnv(process.env, "AGENT_RELAY_RUNNER_PORT");
+var port = relayEnv(process.env, "HUMWICK_RUNNER_PORT");
 if (!port)
   process.exit(0);
 var firstDelivery = true;
@@ -752,7 +786,7 @@ ws.onmessage = (event) => {
   const messages = payload.messages;
   let reservedChars = 0;
   if (firstDelivery) {
-    const contextBlock = relayEnv(process.env, "AGENT_RELAY_APPROVAL") === "read-only" ? claudeReadOnlyRelayContext() : claudeRelayContext();
+    const contextBlock = relayEnv(process.env, "HUMWICK_APPROVAL") === "read-only" ? claudeReadOnlyRelayContext() : claudeRelayContext();
     const wsNote = workspaceDepsNoteFromEnv();
     const prefix = [contextBlock, wsNote].filter(Boolean).join(`
 
@@ -765,7 +799,7 @@ ws.onmessage = (event) => {
   const plan = claudeMonitorDeliveryPlan(messages, {
     reservedChars,
     monitorLimited: true,
-    spillDir: relayEnv(process.env, "AGENT_RELAY_SCRATCH_DIR")
+    spillDir: relayEnv(process.env, "HUMWICK_SCRATCH_DIR")
   });
   if (plan.events[0])
     console.log(plan.events[0].text);

package/plugins/claude/monitors/relay-monitor.ts

@@ -3,7 +3,7 @@ import type { Message } from "@humwick/sdk";
 import { claudeMonitorDeliveryPlan } from "../../../src/adapters/claude-delivery";
 import { claudeReadOnlyRelayContext, claudeRelayContext, workspaceDepsNoteFromEnv } from "../../../src/relay-instructions";
 
-const port = relayEnv(process.env, "AGENT_RELAY_RUNNER_PORT");
+const port = relayEnv(process.env, "HUMWICK_RUNNER_PORT");
 if (!port) process.exit(0);
 
 let firstDelivery = true;
@@ -13,13 +13,13 @@ ws.onmessage = (event) => {
   const payload = parsePayload(String(event.data));
   if (!payload || payload.type !== "message.deliver" || !Array.isArray(payload.messages)) return;
   const messages = payload.messages as Message[];
-  // #1935 — the once-per-session context/workspace block is logged in the same synchronous tick as
+  // the once-per-session context/workspace block is logged in the same synchronous tick as
   // the message, so the harness batches both into ONE monitor event under a single size cap. Track
   // the prefix length and hand it to the composer as reservedChars, so the over-limit stub gate
   // accounts for the prefix and the first message can't be silently truncated behind it.
   let reservedChars = 0;
   if (firstDelivery) {
-    const contextBlock = relayEnv(process.env, "AGENT_RELAY_APPROVAL") === "read-only" ? claudeReadOnlyRelayContext() : claudeRelayContext();
+    const contextBlock = relayEnv(process.env, "HUMWICK_APPROVAL") === "read-only" ? claudeReadOnlyRelayContext() : claudeRelayContext();
     const wsNote = workspaceDepsNoteFromEnv();
     const prefix = [contextBlock, wsNote].filter(Boolean).join("\n\n");
     console.log(prefix);
@@ -30,12 +30,12 @@ ws.onmessage = (event) => {
   const plan = claudeMonitorDeliveryPlan(messages, {
     reservedChars,
     monitorLimited: true,
-    // #2310 — an over-cap must-keep section (memory context, self-resume continuation) is spilled
+    // an over-cap must-keep section (memory context, self-resume continuation) is spilled
     // byte-exact to the session scratch dir and represented by a small pointer instead of ever
     // being raw-emitted for the harness to truncate. There is no supported way to emit more than
     // one Monitor event per delivery cycle (the harness coalesces same-tick stdout into one
     // event), so the pointer — not chunking — is what keeps the content loss-free.
-    spillDir: relayEnv(process.env, "AGENT_RELAY_SCRATCH_DIR"),
+    spillDir: relayEnv(process.env, "HUMWICK_SCRATCH_DIR"),
   });
   if (plan.events[0]) console.log(plan.events[0].text);
   ws.send(JSON.stringify({

package/plugins/claude/skills/label/SKILL.md

@@ -10,14 +10,14 @@ allowed-tools: [Bash]
 Run:
 
 ```bash
-agent-relay /label $ARGUMENTS
+humwick /label $ARGUMENTS
 ```
 
 Examples:
 
 ```bash
-agent-relay /label backend-fixer
-agent-relay /label --clear
+humwick /label backend-fixer
+humwick /label --clear
 ```
 
 Report the new label or current label briefly.

package/plugins/claude/skills/message/SKILL.md

@@ -9,12 +9,12 @@ allowed-tools: [Bash]
 
 ⚠️ **SECURITY — never inline the message body in the shell command.** A body with
 markdown backticks `` `like this` `` or `$(...)` would be shell-executed (command
-substitution) before `agent-relay` sees it — a command-injection vector (#1262),
+substitution) before `humwick` sees it — a command-injection vector,
 since the body may quote another agent's or a user's text. **Feed the body through
 stdin via a quoted heredoc** (the `'RELAY_EOF'` quotes disable all expansion):
 
 ```bash
-agent-relay /message <target> --stdin <<'RELAY_EOF'
+humwick /message <target> --stdin <<'RELAY_EOF'
 Your message text. Backticks `bun run release` and $(anything) are delivered
 verbatim and are NOT executed.
 RELAY_EOF
@@ -24,17 +24,17 @@ Targets (the `<target>` positional) can be an agent id, `tag:`, `policy:`, `cap:
 `broadcast`:
 
 ```bash
-agent-relay /message codex --stdin <<'RELAY_EOF'
+humwick /message codex --stdin <<'RELAY_EOF'
 Can you look at that failing action?
 RELAY_EOF
 
-agent-relay /message tag:backend --stdin <<'RELAY_EOF'
+humwick /message tag:backend --stdin <<'RELAY_EOF'
 Does anyone see the regression?
 RELAY_EOF
 ```
 
 For a message you have already staged in a file, use `--body-file PATH` instead.
 
-**Do NOT** build `agent-relay /message <target> "…body…"` with the body inside quotes.
+**Do NOT** build `humwick /message <target> "…body…"` with the body inside quotes.
 
 Report the sent message id briefly.

package/plugins/claude/skills/react/SKILL.md

@@ -10,7 +10,7 @@ allowed-tools: [Bash]
 Run:
 
 ```bash
-agent-relay /react $ARGUMENTS
+humwick /react $ARGUMENTS
 ```
 
 Use reactions instead of text when the message only needs lightweight acknowledgement, approval, thanks, or "good job".

package/plugins/claude/skills/read-message/SKILL.md

@@ -10,15 +10,15 @@ allowed-tools: [Bash]
 Run:
 
 ```bash
-agent-relay get-message $ARGUMENTS
+humwick get-message $ARGUMENTS
 ```
 
 Useful forms:
 
 ```bash
-agent-relay get-message 206
-agent-relay get-message 206 --json
-agent-relay get-message 206 --body
+humwick get-message 206
+humwick get-message 206 --json
+humwick get-message 206 --body
 ```
 
 Use `--body` when you only need the complete message text. Use `--json` when attachments, metadata, or thread context matter.

package/plugins/claude/skills/reply/SKILL.md

@@ -9,15 +9,15 @@ allowed-tools: [Bash]
 
 ⚠️ **SECURITY — never inline the reply body in the shell command.** Your shell runs
 the command you type, so a body containing markdown backticks `` `like this` `` or
-`$(...)` would be executed as a shell command *before* `agent-relay` ever sees it
-(command substitution). This is a real command-injection vector (#1262): the body may
+`$(...)` would be executed as a shell command *before* `humwick` ever sees it
+(command substitution). This is a real command-injection vector: the body may
 quote another agent's or a user's text. **Always feed the body through stdin via a
 quoted heredoc**, which disables all shell expansion and delivers the body verbatim.
 
 Run (safe — quoted `'RELAY_EOF'` delimiter means no expansion, no substitution):
 
 ```bash
-agent-relay /reply <messageId> --stdin <<'RELAY_EOF'
+humwick /reply <messageId> --stdin <<'RELAY_EOF'
 Your reply text here. Backticks `bun run release` and $(anything) are delivered
 verbatim and are NOT executed.
 RELAY_EOF
@@ -29,7 +29,7 @@ The server auto-routes the reply to the original sender and inherits the channel
 For a reply you have already staged in a file, use `--body-file` instead:
 
 ```bash
-agent-relay /reply <messageId> --body-file .agent-relay/sessions/$AGENT_RELAY_ID/tmp/reply.md
+humwick /reply <messageId> --body-file $TMPDIR/reply.md
 ```
 
 The relay creates that per-session scratch dir for you (git-ignored locally), so
@@ -37,7 +37,7 @@ staging there never pollutes the working tree and never collides with other agen
 No cleanup needed — the dir is reaped when your session ends. Oversized replies are
 automatically uploaded as an Humwick artifact and sent as an attached concise reply.
 
-**Do NOT** build `agent-relay /reply <id> "…body…"` with the body inside quotes — the
+**Do NOT** build `humwick /reply <id> "…body…"` with the body inside quotes — the
 heredoc `--stdin` form above is the only safe way to pass free text.
 
 Do not send a separate Relay follow-up that only confirms the reply was sent. The CLI

package/plugins/claude/skills/send-claimable/SKILL.md

@@ -9,12 +9,12 @@ allowed-tools: [Bash]
 
 ⚠️ **SECURITY — never inline the work-item body in the shell command.** A body with
 markdown backticks `` `like this` `` or `$(...)` would be shell-executed (command
-substitution) before `agent-relay` sees it — a command-injection vector (#1262).
+substitution) before `humwick` sees it — a command-injection vector.
 **Feed the body through stdin via a quoted heredoc** (the `'RELAY_EOF'` quotes disable
 all expansion, delivering the body verbatim):
 
 ```bash
-agent-relay /send-claimable <target> --stdin <<'RELAY_EOF'
+humwick /send-claimable <target> --stdin <<'RELAY_EOF'
 Describe the work item here. Backticks `bun run release` and $(anything) are
 delivered verbatim and are NOT executed.
 RELAY_EOF
@@ -23,17 +23,17 @@ RELAY_EOF
 Targets can be an agent id, `tag:`, `cap:`, or `policy:`:
 
 ```bash
-agent-relay /send-claimable tag:backend --stdin <<'RELAY_EOF'
+humwick /send-claimable tag:backend --stdin <<'RELAY_EOF'
 Fix the failing API test
 RELAY_EOF
 
-agent-relay /send-claimable cap:review --stdin <<'RELAY_EOF'
+humwick /send-claimable cap:review --stdin <<'RELAY_EOF'
 Review the migration patch
 RELAY_EOF
 ```
 
 For a work item you have already staged in a file, use `--body-file PATH` instead.
 
-**Do NOT** build `agent-relay /send-claimable <target> "…body…"` with the body inside quotes.
+**Do NOT** build `humwick /send-claimable <target> "…body…"` with the body inside quotes.
 
 Report the sent claimable message id briefly.

package/plugins/claude/skills/slice-first/SKILL.md

@@ -6,7 +6,7 @@ description: Frame and prove a thin end-to-end feature slice before planning har
 # Slice first
 
 Use the current project's instructions and configured validation/deployment gates,
-including its “How to validate in THIS project” brief or `.agent-relay/land-gates.json`.
+including its “How to validate in THIS project” brief or the project’s `land-gates.json`.
 Choose the proof's location and runtime in that project; no particular repo is required.
 
 | Stage | Required result |
@@ -19,8 +19,10 @@ Choose the proof's location and runtime in that project; no particular repo is r
 
 Coordinator owns stages, scope ledger and budget; record stage decisions on the spec
 Task. Changing the bar or exceeding the budget needs operator approval. A blocked
-slice returns to frame. Never create or spawn harden Tasks before the proof Task is
-done with `slice-proof: pass`; dependencies alone do not prevent dispatch.
+slice returns to frame. Never spawn harden builders before the slice Task is `done`
+with a passing `slice-proof` verdict. Relay holds the slice Task's dependents (plan
+nodes, Task dependencies) while its proof is open or failed; a builder you spawn by
+hand is not held.
 
 Design writes proof then spec, no full design. Builder declares each slice shortcut
 in delivery risks. QA reproduces independently. Review blocks only on the stage's