@a5c-ai/babysitter-openclaw 5.0.1-staging.ff2c19f9 → 5.1.1-staging.00ceebd28cf2

package/hooks/{babysitter-proxied-session-end.js → babysitter-proxied-gateway-request-completed.js}

@@ -6,7 +6,7 @@ var readFileSync = require("fs").readFileSync;
 
 var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
 var stdin = "";
-try { stdin = readFileSync(0, "utf8"); } catch {}
+try { stdin = readFileSync(0, "utf8"); } catch (e) { process.stderr.write("[extensions-adapter] stdin read failed: " + (e instanceof Error ? e.message : String(e)) + "\n"); }
 try {
   var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/session-end.sh")), {
     input: stdin,
@@ -15,10 +15,13 @@ try {
     env: Object.assign({}, process.env, {
       HOOK_TYPE: process.env.HOOK_TYPE || "",
       ADAPTER_NAME: process.env.ADAPTER_NAME || "openclaw",
-      PLUGIN_ROOT: PLUGIN_ROOT
+      PLUGIN_ROOT: PLUGIN_ROOT,
+      CLAUDE_PLUGIN_ROOT: PLUGIN_ROOT
     })
   });
   process.stdout.write(result);
 } catch (e) {
-  process.stdout.write("{}\n");
+  process.stderr.write("[extensions-adapter] hook execution failed: " + (e instanceof Error ? e.message : String(e)) + "\n");
+  process.stdout.write(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }) + "\n");
+  process.exit(1);
 }

package/hooks/{babysitter-proxied-session-start.js → babysitter-proxied-gateway-request-received.js}

@@ -6,7 +6,7 @@ var readFileSync = require("fs").readFileSync;
 
 var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
 var stdin = "";
-try { stdin = readFileSync(0, "utf8"); } catch {}
+try { stdin = readFileSync(0, "utf8"); } catch (e) { process.stderr.write("[extensions-adapter] stdin read failed: " + (e instanceof Error ? e.message : String(e)) + "\n"); }
 try {
   var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/session-start.sh")), {
     input: stdin,
@@ -15,10 +15,13 @@ try {
     env: Object.assign({}, process.env, {
       HOOK_TYPE: process.env.HOOK_TYPE || "",
       ADAPTER_NAME: process.env.ADAPTER_NAME || "openclaw",
-      PLUGIN_ROOT: PLUGIN_ROOT
+      PLUGIN_ROOT: PLUGIN_ROOT,
+      CLAUDE_PLUGIN_ROOT: PLUGIN_ROOT
     })
   });
   process.stdout.write(result);
 } catch (e) {
-  process.stdout.write("{}\n");
+  process.stderr.write("[extensions-adapter] hook execution failed: " + (e instanceof Error ? e.message : String(e)) + "\n");
+  process.stdout.write(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }) + "\n");
+  process.exit(1);
 }

package/hooks/{babysitter-proxied-session-start.sh → babysitter-proxied-gateway-request-received.sh}

@@ -1,7 +1,7 @@
 #!/bin/bash
 # Session Start — installs SDK if needed, then runs hook handler.
 set -euo pipefail
-PLUGIN_ROOT="${PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}"
+PLUGIN_ROOT="${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}}"
 SDK_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('${PLUGIN_ROOT}/versions.json','utf8')).sdkVersion||'latest')}catch{console.log('latest')}" 2>/dev/null || echo "latest")
 if ! command -v babysitter &>/dev/null; then
   npm i -g "@a5c-ai/babysitter-sdk@${SDK_VERSION}" --loglevel=error 2>/dev/null || \

package/hooks/babysitter-proxied-gateway-request-routed.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+"use strict";
+var execSync = require("child_process").execSync;
+var path = require("path");
+var readFileSync = require("fs").readFileSync;
+
+var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
+var stdin = "";
+try { stdin = readFileSync(0, "utf8"); } catch (e) { process.stderr.write("[extensions-adapter] stdin read failed: " + (e instanceof Error ? e.message : String(e)) + "\n"); }
+try {
+  var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/user-prompt-submit.sh")), {
+    input: stdin,
+    stdio: ["pipe", "pipe", "pipe"],
+    timeout: 30000,
+    env: Object.assign({}, process.env, {
+      HOOK_TYPE: process.env.HOOK_TYPE || "",
+      ADAPTER_NAME: process.env.ADAPTER_NAME || "openclaw",
+      PLUGIN_ROOT: PLUGIN_ROOT,
+      CLAUDE_PLUGIN_ROOT: PLUGIN_ROOT
+    })
+  });
+  process.stdout.write(result);
+} catch (e) {
+  process.stderr.write("[extensions-adapter] hook execution failed: " + (e instanceof Error ? e.message : String(e)) + "\n");
+  process.stdout.write(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }) + "\n");
+  process.exit(1);
+}

package/hooks/babysitter-proxied-gateway-request-routed.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+set -euo pipefail
+babysitter hook:run --harness unified --hook-type user-prompt-submit --json

package/hooks/babysitter-proxied-plugin-tool-after.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+"use strict";
+var execSync = require("child_process").execSync;
+var path = require("path");
+var readFileSync = require("fs").readFileSync;
+
+var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
+var stdin = "";
+try { stdin = readFileSync(0, "utf8"); } catch (e) { process.stderr.write("[extensions-adapter] stdin read failed: " + (e instanceof Error ? e.message : String(e)) + "\n"); }
+try {
+  var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/post-tool-use.sh")), {
+    input: stdin,
+    stdio: ["pipe", "pipe", "pipe"],
+    timeout: 30000,
+    env: Object.assign({}, process.env, {
+      HOOK_TYPE: process.env.HOOK_TYPE || "",
+      ADAPTER_NAME: process.env.ADAPTER_NAME || "openclaw",
+      PLUGIN_ROOT: PLUGIN_ROOT,
+      CLAUDE_PLUGIN_ROOT: PLUGIN_ROOT
+    })
+  });
+  process.stdout.write(result);
+} catch (e) {
+  process.stderr.write("[extensions-adapter] hook execution failed: " + (e instanceof Error ? e.message : String(e)) + "\n");
+  process.stdout.write(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }) + "\n");
+  process.exit(1);
+}

package/hooks/babysitter-proxied-plugin-tool-after.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+set -euo pipefail
+babysitter hook:run --harness unified --hook-type post-tool-use --json

package/hooks/{babysitter-proxied-before-prompt-build.js → babysitter-proxied-plugin-tool-before.js}

@@ -6,19 +6,22 @@ var readFileSync = require("fs").readFileSync;
 
 var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
 var stdin = "";
-try { stdin = readFileSync(0, "utf8"); } catch {}
+try { stdin = readFileSync(0, "utf8"); } catch (e) { process.stderr.write("[extensions-adapter] stdin read failed: " + (e instanceof Error ? e.message : String(e)) + "\n"); }
 try {
-  var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/before-prompt-build.sh")), {
+  var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/pre-tool-use.sh")), {
     input: stdin,
     stdio: ["pipe", "pipe", "pipe"],
     timeout: 30000,
     env: Object.assign({}, process.env, {
       HOOK_TYPE: process.env.HOOK_TYPE || "",
       ADAPTER_NAME: process.env.ADAPTER_NAME || "openclaw",
-      PLUGIN_ROOT: PLUGIN_ROOT
+      PLUGIN_ROOT: PLUGIN_ROOT,
+      CLAUDE_PLUGIN_ROOT: PLUGIN_ROOT
     })
   });
   process.stdout.write(result);
 } catch (e) {
-  process.stdout.write("{}\n");
+  process.stderr.write("[extensions-adapter] hook execution failed: " + (e instanceof Error ? e.message : String(e)) + "\n");
+  process.stdout.write(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }) + "\n");
+  process.exit(1);
 }

package/hooks/babysitter-proxied-plugin-tool-before.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+set -euo pipefail
+babysitter hook:run --harness unified --hook-type pre-tool-use --json

package/hooks/{babysitter-proxied-agent-end.js → babysitter-proxied-plugin-turn-stop.js}

@@ -6,19 +6,22 @@ var readFileSync = require("fs").readFileSync;
 
 var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
 var stdin = "";
-try { stdin = readFileSync(0, "utf8"); } catch {}
+try { stdin = readFileSync(0, "utf8"); } catch (e) { process.stderr.write("[extensions-adapter] stdin read failed: " + (e instanceof Error ? e.message : String(e)) + "\n"); }
 try {
-  var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/after-agent.sh")), {
+  var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/stop.sh")), {
     input: stdin,
     stdio: ["pipe", "pipe", "pipe"],
     timeout: 30000,
     env: Object.assign({}, process.env, {
       HOOK_TYPE: process.env.HOOK_TYPE || "",
       ADAPTER_NAME: process.env.ADAPTER_NAME || "openclaw",
-      PLUGIN_ROOT: PLUGIN_ROOT
+      PLUGIN_ROOT: PLUGIN_ROOT,
+      CLAUDE_PLUGIN_ROOT: PLUGIN_ROOT
     })
   });
   process.stdout.write(result);
 } catch (e) {
-  process.stdout.write("{}\n");
+  process.stderr.write("[extensions-adapter] hook execution failed: " + (e instanceof Error ? e.message : String(e)) + "\n");
+  process.stdout.write(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }) + "\n");
+  process.exit(1);
 }

package/hooks.json

@@ -1,27 +1,4 @@
 {
   "description": "babysitter plugin hooks for OpenClaw",
-  "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "./hooks/babysitter-proxied-session-start.sh"
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "./hooks/babysitter-proxied-stop-hook.sh"
-          }
-        ]
-      }
-    ]
-  }
+  "hooks": {}
 }

package/openclaw.plugin.json

@@ -1,13 +1,15 @@
 {
   "name": "babysitter",
-  "version": "5.0.1-staging.ff2c19f9",
+  "version": "5.1.1-staging.00ceebd28cf2",
   "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
   "entrypoint": "extensions/index.ts",
   "hooks": {
-    "session_start": "extensions/hooks/session-start.ts",
-    "agent_end": "extensions/hooks/agent-end.ts",
-    "session_end": "extensions/hooks/session-end.ts",
-    "before_prompt_build": "extensions/hooks/before-prompt-build.ts"
+    "gateway.request.received": "extensions/hooks/gateway-request-received.ts",
+    "plugin.turn.stop": "extensions/hooks/plugin-turn-stop.ts",
+    "gateway.request.routed": "extensions/hooks/gateway-request-routed.ts",
+    "plugin.tool.before": "extensions/hooks/plugin-tool-before.ts",
+    "plugin.tool.after": "extensions/hooks/plugin-tool-after.ts",
+    "gateway.request.completed": "extensions/hooks/gateway-request-completed.ts"
   },
   "capabilities": [
     "orchestration",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a5c-ai/babysitter-openclaw",
-  "version": "5.0.1-staging.ff2c19f9",
+  "version": "5.1.1-staging.00ceebd28cf2",
   "type": "module",
   "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
   "openclaw": {
@@ -22,21 +22,19 @@
     "sdk-integration"
   ],
   "dependencies": {
-    "@a5c-ai/babysitter-sdk": "5.0.1-staging.ff2c19f9"
+    "@a5c-ai/babysitter-sdk": "5.1.1-staging.00ceebd28cf2"
   },
   "peerDependencies": {
     "openclaw": "*"
   },
   "scripts": {
-    "postinstall": "node bin/install.cjs --global",
-    "preuninstall": "node bin/uninstall.cjs --global",
+    "plugin:install": "node bin/install.cjs --global",
+    "plugin:uninstall": "node bin/uninstall.cjs --global",
     "test": "node --test test/integration.test.js",
     "test:integration": "node --test test/integration.test.js",
     "test:packaged-install": "node test/packaged-install.test.cjs",
-    "sync:commands": "node scripts/sync-command-docs.cjs",
     "deploy": "npm publish --access public",
-    "deploy:staging": "npm publish --access public --tag staging",
-    "team:install": "node scripts/team-install.cjs"
+    "deploy:staging": "npm publish --access public --tag staging"
   },
   "bin": {
     "babysitter-openclaw": "bin/cli.cjs"
@@ -62,7 +60,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/a5c-ai/babysitter"
+    "url": "git+https://github.com/a5c-ai/babysitter-openclaw.git"
   },
-  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-openclaw#readme"
+  "homepage": "https://github.com/a5c-ai/babysitter-openclaw#readme",
+  "bugs": {
+    "url": "https://github.com/a5c-ai/babysitter-openclaw/issues"
+  }
 }

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "babysitter",
-  "version": "5.0.1-staging.ff2c19f9",
+  "version": "5.1.1-staging.00ceebd28cf2",
   "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
   "author": "a5c.ai",
   "license": "MIT",

package/scripts/create-release-tag.mjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+
+function run(command, args) {
+  const result = spawnSync(command, args, { encoding: 'utf8', stdio: 'inherit' });
+  if (result.status !== 0) process.exit(result.status || 1);
+}
+
+const branch = process.env.GITHUB_REF_NAME || 'develop';
+const sha = (process.env.GITHUB_SHA || '').slice(0, 12);
+const version = existsSync('package.json') ? JSON.parse(readFileSync('package.json', 'utf8')).version : JSON.parse(readFileSync('versions.json', 'utf8')).sdkVersion;
+const normalized = String(version).replace(/[^0-9A-Za-z._-]/g, '-');
+const tag = 'release/' + branch + '/v' + normalized + '-' + sha;
+run('git', ['config', 'user.name', 'github-actions[bot]']);
+run('git', ['config', 'user.email', 'github-actions[bot]@users.noreply.github.com']);
+run('git', ['tag', tag]);
+run('git', ['push', 'origin', tag]);

package/scripts/publish-from-tag.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, { stdio: options.stdio || 'inherit', encoding: options.encoding });
+  if (result.status !== 0 && !options.allowFailure) process.exit(result.status || 1);
+  return result;
+}
+
+function npmView(packageSpec) {
+  return run('npm', ['view', packageSpec, 'version'], { allowFailure: true, stdio: 'pipe', encoding: 'utf8' }).status === 0;
+}
+
+const pkg = JSON.parse(readFileSync('package.json', 'utf8'));
+const ref = process.env.GITHUB_REF_NAME || '';
+const branch = ref.split('/')[1] || 'develop';
+const tag = branch === 'main' ? 'latest' : branch;
+
+if (!process.env.NODE_AUTH_TOKEN) {
+  console.log('NODE_AUTH_TOKEN is not configured; skipping npm publish.');
+  process.exit(0);
+}
+
+if (npmView(pkg.name + '@' + pkg.version)) {
+  console.log(pkg.name + '@' + pkg.version + ' already exists; ensuring dist-tag ' + tag + '.');
+  run('npm', ['dist-tag', 'add', pkg.name + '@' + pkg.version, tag], { allowFailure: true });
+  process.exit(0);
+}
+
+for (const field of ['dependencies', 'peerDependencies', 'optionalDependencies']) {
+  for (const [name, version] of Object.entries(pkg[field] || {})) {
+    if (!name.startsWith('@a5c-ai/') || version.startsWith('^') || version.startsWith('~') || version === '*' || version.startsWith('workspace:')) continue;
+    if (!npmView(name + '@' + version)) {
+      console.log('Required internal dependency ' + name + '@' + version + ' is not published yet; skipping npm publish.');
+      process.exit(0);
+    }
+  }
+}
+
+run('npm', ['publish', '--access', 'public', '--tag', tag]);

package/scripts/team-install.cjs

@@ -2,7 +2,7 @@
 'use strict';
 
 var path = require('path');
-var shared = require('../bin/install-shared');
+var shared = require('../bin/install-shared.cjs');
 
 var workspace = process.cwd();
 for (var i = 0; i < process.argv.length; i++) {

package/skills/babysit/SKILL.md

@@ -1,11 +1,24 @@
 ---
 name: babysit
-description: Orchestrate via @babysitter. Use this skill when asked to babysit a run, orchestrate a process or whenever it is called explicitly. (babysit, babysitter, orchestrate, orchestrate a run, workflow, etc.)
+description: Execute via @babysitter. Use this skill when asked to babysit a task, do anything that is structured process-driven (even a loop) or whenever it is called explicitly. (babysit, babysitter, with a process, orchestrate, orchestrate a run, workflow, loop until, etc.)
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+version: 0.1.3
 ---
 
 # babysit
 
-Orchestrate `.a5c/runs/<runId>/` through iterative execution.
+Follow the commands below exactly. but apply judgement and creativity to get the job done. no matter how small or simple the task may seem, you must use the babysitter SDK and run lifecycle to execute it. This is non-negotiable. If you are asked to do something that seems like it could be done with a simple tool call, you must still use the babysitter SDK to create a run, define tasks, execute them, and complete the run. This is how you will learn and demonstrate mastery of the babysitter system. Always follow the full process, even for trivial tasks.
+
+Subagents that need a scratch checkout or working directory must create it under
+`/tmp/<descriptive-name>/`, not under `.a5c/runs/<runId>/work`. Before returning
+deliverables, validate that no run-dir worktree was left behind, for example:
+
+```bash
+find .a5c/runs -maxdepth 3 -name work -type d -print
+```
+
+That command should print nothing. If it prints a non-empty work directory, move
+or remove only the scratch data you created before returning.
 
 ## Dependencies
 
@@ -14,24 +27,36 @@ Orchestrate `.a5c/runs/<runId>/` through iterative execution.
 Read the SDK version from `versions.json` to ensure version compatibility:
 
 ```bash
-PLUGIN_ROOT="${OPENCLAW_PLUGIN_ROOT:-$(pwd)}"
-SDK_VERSION=$(node -e "try{const fs=require('fs');const path=require('path');const pluginRoot=process.env.OPENCLAW_PLUGIN_ROOT||process.env.PLUGIN_ROOT||process.cwd();const probes=[path.join(pluginRoot,'versions.json'),path.join(pluginRoot,'plugins','babysitter-openclaw','versions.json'),path.join(pluginRoot,'node_modules','@a5c-ai','babysitter-openclaw','versions.json'),path.join(process.cwd(),'node_modules','@a5c-ai','babysitter-openclaw','versions.json')];for(const probe of probes){if(fs.existsSync(probe)){console.log(JSON.parse(fs.readFileSync(probe,'utf8')).sdkVersion||'latest');process.exit(0)}}console.log('latest')}catch{console.log('latest')}")
-npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION
-CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"
+SDK_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('${PLUGIN_ROOT}/versions.json','utf8')).sdkVersion||'latest')}catch{console.log('latest')}")
+npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION || npm i -g @a5c-ai/babysitter-sdk@latest
+
+if command -v babysitter >/dev/null 2>&1 && babysitter --version >/dev/null 2>&1; then
+  CLI="babysitter"
+else
+  CLI="npm exec --yes --package @a5c-ai/babysitter-sdk@$SDK_VERSION -- babysitter"
+fi
 ```
 
+If the pinned version fails to install (e.g. not yet published), the fallback installs `latest`.
+
+If a stale or broken global shim fails with `MODULE_NOT_FOUND`, repair it with `npm rm -g @a5c-ai/babysitter @a5c-ai/babysitter-sdk && npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION`, then re-run `babysitter --version`.
+
+### jq
+
+Make sure `jq` is installed and available in the path. If not, install it.
+
 ## Instructions
 
-Run the following command to get full orchestration instructions:
+Run the following command to get full instructions:
 
 ```bash
-babysitter instructions:babysit-skill --harness openclaw --interactive
+$CLI instructions:babysit-skill --harness openclaw --interactive
 ```
 
-For non-interactive mode:
+For non-interactive mode (running with `-p` flag or no AskUserQuestion tool):
 
 ```bash
-babysitter instructions:babysit-skill --harness openclaw --no-interactive
+$CLI instructions:babysit-skill --harness openclaw --no-interactive
 ```
 
 Follow the instructions returned by the command above to orchestrate the run.

package/skills/blueprints/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: blueprints
+description: manage Babysitter blueprints. Use this command to list installed blueprints, browse marketplaces, install, update, uninstall, configure, or create a new blueprint.
+---
+
+# blueprints
+
+This command installs and manages Babysitter blueprints. A blueprint is a version-managed package of contextual instructions or deterministic Babysitter processes, not a conventional software plugin.
+
+If the command is run without arguments, list installed blueprints with their name, version, marketplace, installation date, and last update date. Also list configured marketplaces and show how to add the default marketplace when none exist.
+
+Blueprints can be installed at two scopes:
+
+- **global** (`--global`): stored under `~/.a5c/`, available for all projects
+- **project** (`--project`): stored under `<projectDir>/.a5c/`, project-specific
+
+## Marketplace Management
+
+Marketplaces are git repositories containing a `marketplace.json` manifest and blueprint package directories. The SDK clones new marketplaces to `.a5c/blueprints/marketplaces/` for the selected scope and reads legacy `.a5c/marketplaces/` clones for compatibility.
+
+### Add a marketplace
+
+```bash
+babysitter blueprints:add-marketplace --marketplace-url <url> [--marketplace-path <relative-path>] [--marketplace-branch <ref>] [--force] --global|--project [--json]
+```
+
+### Update a marketplace
+
+```bash
+babysitter blueprints:update-marketplace --marketplace-name <name> [--marketplace-branch <ref>] --global|--project [--json]
+```
+
+### List blueprints in a marketplace
+
+```bash
+babysitter blueprints:list-blueprints --marketplace-name <name> --global|--project [--json]
+```
+
+## Blueprint Lifecycle
+
+For `blueprint:install`, `blueprint:update`, `blueprint:configure`, and `blueprint:list-blueprints`, the `--marketplace-name` flag is auto-detected when only one marketplace is cloned for the selected scope.
+
+```bash
+babysitter blueprints:install --plugin-name <name> [--marketplace-name <mp>] --global|--project [--json]
+babysitter blueprints:update --plugin-name <name> --marketplace-name <mp> --global|--project [--json]
+babysitter blueprints:configure --plugin-name <name> --marketplace-name <mp> --global|--project [--json]
+babysitter blueprints:uninstall --plugin-name <name> --marketplace-name <mp> --global|--project [--json]
+```
+
+The `--plugin-name` flag is preserved for CLI compatibility with existing marketplace manifests. User-facing docs should call the installable a blueprint.
+
+## Registry Management
+
+```bash
+babysitter blueprints:list-installed --global|--project [--json]
+babysitter blueprints:update-registry --plugin-name <name> --plugin-version <ver> --marketplace-name <mp> --global|--project [--json]
+babysitter blueprints:remove-from-registry --plugin-name <name> --global|--project [--json]
+```
+
+## Deprecated Aliases
+
+The old `plugin:*` commands remain available as deprecated aliases for one release. Prefer `blueprint:*` in new docs, skills, and process instructions.
+
+## Agent Plugins Are Separate
+
+Do not rename or reinterpret agent harness plugins while handling blueprints. `CLAUDE_PLUGIN_ROOT`, `PI_PLUGIN_ROOT`, `.claude/plugins/`, hooks-adapter, extensions-adapter, and agent plugin manifests stay plugin-specific.

package/skills/call/SKILL.md

@@ -5,4 +5,8 @@ description: Orchestrate a babysitter run. use this command to start babysitting
 
 # call
 
-Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). Then continue executing the returned instructions in this same turn. Do not stop after the Skill tool returns; carry the requested run through to completion proof.
+
+User arguments for this command:
+
+$ARGUMENTS

package/skills/check-forbidden-markers/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: check-forbidden-markers
+description: Pre-deploy gate that scans built JS chunks for forbidden substring markers (saga-era / obsolete code paths) listed in a project-local forbidden-markers.txt
+---
+
+# check-forbidden-markers
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). Compose the gate from the shared helper at `library/processes/shared/forbidden-markers-scanner.js` (issue #477).
+
+## What this gate does
+
+Reads a list of literal substring markers from `scripts/forbidden-markers.txt` (blank lines and `#`-prefixed comments stripped) and greps every `.js` chunk under `.vercel/output/static/_next/static/chunks/` (Next.js / Vercel default; configurable) for any occurrence. Reports structured hits per `(marker, chunk)` pair with occurrence counts. Designed to chain between `vercel build --prod` and `vercel deploy --prod`.
+
+Use this gate when a refactor or restart-from-baseline replaced load-bearing code paths and you need a structural guarantee the obsolete symbols never re-ship. Burned-in evidence: cookbook VI-9 / VI-12 near-miss revivals during the 2026-05 iOS-Safari saga; the prototype lives at `cookbook/scripts/check-no-forbidden.mjs` and shipped two upstream contributions before being generalized as this gate.
+
+## When to use
+
+- **Pre-deploy.** Insert after build, before deploy. Block the deploy when `ok: false`.
+- **Post-restart.** After a baseline rollback + step-by-step re-add, snapshot the saga-era markers in `forbidden-markers.txt` and let CI hold the line.
+- **Post-refactor.** When old helper / handler / module names must not coexist with the new ones in the same bundle.
+
+## Expected config locations
+
+- `scripts/forbidden-markers.txt` — one marker per line, `#` for comments. The list is the contract; the gate is mechanical. Commit this file to source control.
+- `.vercel/output/static/_next/static/chunks/` — default scan target. Override for non-Vercel frameworks via the `--chunks-dir` flag or the `chunksDir` task input.
+
+A missing markers file is a no-op (`ok: true`, `reason: 'missing-markers-file'`) — misconfiguration is never a deploy block. A missing chunks directory is likewise a no-op (`reason: 'missing-chunks-dir'`) so the gate is safe to chain into `check:all` before the build runs.
+
+## Exit semantics
+
+| Reason                  | `ok`   | Deploy decision                |
+|-------------------------|--------|--------------------------------|
+| `missing-markers-file`  | true   | Pass (no gate active)          |
+| `missing-chunks-dir`    | true   | Pass (run before build)        |
+| `empty-markers`         | true   | Pass (list is empty)           |
+| `no-chunks`             | true   | Pass (nothing to scan)         |
+| `clean`                 | true   | Pass — proceed to deploy       |
+| `hits`                  | false  | **BLOCK** — surface hits, ask for triage |
+
+For each hit, the gate emits `{ marker, chunk, count }` so the operator sees the exact marker string, the absolute chunk path, and the number of occurrences in that chunk. Multiple hits across chunks for the same marker are reported separately.
+
+## Programmatic surface
+
+```js
+import { scanForbiddenMarkers, checkForbiddenMarkersTask } from '@a5c-ai/babysitter-library/processes/shared';
+
+// Direct call:
+const result = await scanForbiddenMarkers({
+  markersFile: 'scripts/forbidden-markers.txt',
+  chunksDir:   '.vercel/output/static/_next/static/chunks',
+});
+if (!result.ok) {
+  // result.hits: Array<{ marker, chunk, count }>
+  // result.reason === 'hits'
+  process.exit(1);
+}
+
+// Or dispatched as a babysitter task:
+const gate = await ctx.task(checkForbiddenMarkersTask, {
+  projectDir: '.',
+  // markersFile / chunksDir are inferred from projectDir if omitted
+});
+```
+
+## Reference
+
+- Issue: https://github.com/a5c-ai/babysitter/issues/477
+- Helper module: `library/processes/shared/forbidden-markers-scanner.js`
+- Origin (cookbook prototype): `cookbook/scripts/check-no-forbidden.mjs` (81 lines)