@a5c-ai/babysitter-codex 5.0.1-staging.ff2c19f9 → 5.1.1-staging.583e3d9a6ed7

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "babysitter",
-  "version": "5.0.0",
+  "version": "5.1.1-staging.583e3d9a6ed7",
   "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
   "author": {
     "name": "a5c.ai",
@@ -20,7 +20,7 @@
     "LLM"
   ],
   "skills": "./skills/",
-  "hooks": "./hooks/hooks.json",
+  "hooks": "./hooks.json",
   "apps": "./.app.json",
   "interface": {
     "displayName": "Babysitter",
@@ -45,5 +45,5 @@
     "composerIcon": "./assets/icon.svg",
     "logo": "./assets/logo.png"
   },
-  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-codex#readme"
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-unified/per-harness/codex#readme"
 }

package/README.md

@@ -11,29 +11,76 @@ This package ships a real Codex plugin bundle:
 
 It still uses the Babysitter SDK CLI and the shared `~/.a5c` process-library
 state. Global install writes the plugin bundle to `~/.agents/plugins/babysitter`
-and updates `~/.agents/plugins/marketplace.json` so Codex can load the plugin
-through its marketplace surface. Workspace install continues to materialize a
-workspace-local Codex surface for team setup.
+and updates `.agents/plugins/marketplace.json` (primary) so Codex can load the
+plugin through its marketplace surface. Codex also recognizes
+`.claude-plugin/marketplace.json` as a legacy marketplace path. Workspace
+install continues to materialize a workspace-local Codex surface for team setup.
+
+Codex now ships an official marketplace CLI (`codex plugin marketplace`) that
+supports `add`, `list`, `upgrade`, and `remove` subcommands. Plugin bundles
+installed through the marketplace are cached under
+`~/.codex/plugins/cache/$MARKETPLACE/$PLUGIN/$VERSION/`.
 
 ## Installation
 
-Install the SDK CLI first:
+Install the Babysitter CLI once:
+
+```bash
+npm install -g @a5c-ai/babysitter
+```
+
+Install the Codex plugin through the SDK helper. This is the canonical path used by the installer tests and resolves to `npx --yes @a5c-ai/babysitter-codex install ...` under the hood:
+
+```bash
+# Global install
+babysitter harness:install-plugin codex
+
+# Workspace install
+babysitter harness:install-plugin codex --workspace /path/to/repo
+```
+
+You can also run the published package installer directly:
+
+```bash
+npx --yes @a5c-ai/babysitter-codex install --global
+npx --yes @a5c-ai/babysitter-codex install --workspace /path/to/repo
+```
+
+Alternatively, use the official Codex marketplace CLI to add the babysitter
+marketplace directly from GitHub:
 
 ```bash
-npm install -g @a5c-ai/babysitter-sdk
+codex plugin marketplace add a5c-ai/babysitter --ref staging --sparse .agents/plugins
 ```
 
-clone the repo and install the plugin globally:
+Or from a local clone:
 
 ```bash
-npx -y @a5c-ai/babysitter-codex install --global
+codex plugin marketplace add ./path/to/babysitter
+```
+
+Then browse and install:
+
+```bash
+codex plugin list --source babysitter
+codex plugin install babysitter --source babysitter
+```
+
+Other marketplace commands:
+
+```bash
+codex plugin marketplace list
+codex plugin marketplace upgrade babysitter
+codex plugin marketplace remove babysitter
+```
 
-codex
+Then open Codex and finish enabling the plugin from the plugin UI:
 
-> /plugins
+```text
+/plugins
 ```
 
-then navigate to the 'babysitter' entry and select 'Install'.
+Navigate to the `babysitter` entry and select `Install`.
 
 If Codex was already open when you ran `install --global`, start a new thread
 after installing from `/plugins` before expecting `babysitter:*` skills such as
@@ -51,6 +98,25 @@ The plugin provides:
 The process library is fetched and bound through the SDK CLI in
 `~/.a5c/active/process-library.json`.
 
+## Hook Environment Variables
+
+Codex exposes the following environment variables to hook scripts:
+
+| Variable | Description |
+|---|---|
+| `PLUGIN_ROOT` | Absolute path to the plugin root directory (native) |
+| `PLUGIN_DATA` | Persistent data directory for the plugin (native) |
+| `CLAUDE_PLUGIN_ROOT` | Compatibility alias for `PLUGIN_ROOT` |
+| `CLAUDE_PLUGIN_DATA` | Compatibility alias for `PLUGIN_DATA` |
+
+Hook scripts should prefer `PLUGIN_ROOT` / `PLUGIN_DATA` but can read the
+`CLAUDE_PLUGIN_ROOT` / `CLAUDE_PLUGIN_DATA` aliases for cross-harness
+compatibility with Claude Code plugins.
+
+Codex auto-detects hooks via `./hooks/hooks.json`. The `hooks` field in
+`.codex-plugin/plugin.json` accepts a path, an array of paths, an inline
+object, or an array of objects.
+
 ## Workspace Output
 
 After `install --workspace`, the important files are:

package/bin/install-shared.js

@@ -13,23 +13,23 @@ function getUserHome() {
 }
 
 function getHarnessHome() {
-  return path.join(os.homedir(), '.codex');
+  return path.join(os.homedir(), ".codex");
 }
 
 function getHomePluginRoot(scope) {
   if (scope === 'workspace') return path.join(process.cwd(), '.a5c', 'plugins', PLUGIN_NAME);
-  return path.join(path.join(os.homedir(), '.agents', 'plugins'), PLUGIN_NAME);
+  return path.join(path.join(os.homedir(), ".agents/plugins"), PLUGIN_NAME);
 }
 
 function getHomeMarketplacePath() {
-  return path.join(os.homedir(), '.agents', 'plugins', 'marketplace.json');
+  return path.join(os.homedir(), ".agents/plugins/marketplace.json");
 }
 
 function writeFileIfChanged(filePath, contents) {
   try {
     const existing = fs.readFileSync(filePath, 'utf8');
     if (existing === contents) return false;
-  } catch {}
+  } catch (e) { process.stderr.write('[extensions-adapter] file read failed for ' + filePath + ', overwriting: ' + (e instanceof Error ? e.message : String(e)) + '\n'); }
   fs.mkdirSync(path.dirname(filePath), { recursive: true });
   fs.writeFileSync(filePath, contents);
   return true;
@@ -82,7 +82,7 @@ function writeJson(filePath, value) {
 function ensureExecutable(filePath) {
   try {
     fs.chmodSync(filePath, 0o755);
-  } catch {}
+  } catch (e) { process.stderr.write('[extensions-adapter] chmod failed for ' + filePath + ': ' + (e instanceof Error ? e.message : String(e)) + '\n'); }
 }
 
 function normalizeMarketplaceSourcePath(source, marketplacePath) {
@@ -104,7 +104,7 @@ function ensureMarketplaceEntry(marketplacePath, pluginRoot) {
     name: PLUGIN_NAME,
     source: relSource,
     description: "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
-    version: "5.0.0",
+    version: "5.1.1-staging.583e3d9a6ed7",
     author: { name: "a5c.ai" },
   };
   if (idx >= 0) marketplace.plugins[idx] = entry;
@@ -130,7 +130,7 @@ function runPostInstall(pluginRoot) {
   if (fs.existsSync(postInstall)) {
     spawnSync(process.execPath, [postInstall], {
       cwd: pluginRoot, stdio: 'inherit',
-      env: { ...process.env, PLUGIN_ROOT: pluginRoot },
+      env: { ...process.env, PLUGIN_ROOT: pluginRoot, CLAUDE_PLUGIN_ROOT: pluginRoot },
     });
   }
 }
@@ -147,7 +147,7 @@ function resolveCliCommand(packageRoot) {
   const versionsPath = path.join(packageRoot, 'versions.json');
   const versions = readJson(versionsPath) || {};
   const ver = versions.sdkVersion || 'latest';
-  return `npx -y @a5c-ai/babysitter-sdk@${ver}`;
+  return `npm exec --yes --package @a5c-ai/babysitter-sdk@${ver} -- babysitter`;
 }
 
 function runCli(packageRoot, cliArgs, options = {}) {
@@ -297,7 +297,7 @@ function renderCodexConfigToml() {
     'writable_roots = [".a5c", ".codex"]',
     '',
     '[features]',
-    'codex_hooks = true',
+    'hooks = true',
     'multi_agent = true',
     '',
     '[agents]',
@@ -406,7 +406,7 @@ function mergeCodexConfig(existing) {
   content = insertRootKey(content, 'sandbox_mode', 'sandbox_mode = "workspace-write"');
   content = insertRootKey(content, 'project_doc_max_bytes', 'project_doc_max_bytes = 65536');
   content = ensureWritableRoots(content);
-  content = ensureSectionLine(content, 'features', 'codex_hooks', 'codex_hooks = true');
+  content = ensureSectionLine(content, 'features', 'hooks', 'hooks = true');
   content = ensureSectionLine(content, 'features', 'multi_agent', 'multi_agent = true');
   content = ensureSectionLine(content, 'agents', 'max_depth', 'max_depth = 3');
   content = ensureSectionLine(content, 'agents', 'max_threads', 'max_threads = 4');
@@ -771,21 +771,28 @@ module.exports = {
   resolveCliCommand,
   runCli,
   ensureGlobalProcessLibrary,
+  PLUGIN_BUNDLE_ENTRIES,
+  copyRecursive,
+  copyPluginBundle,
+  DEFAULT_MARKETPLACE,
+  normalizeMarketplaceSourcePath,
+  ensureMarketplaceEntry,
+  removeMarketplaceEntry,
+  installManagedSkills,
+  mergeManagedHooksConfig,
+  installManagedHooks,
+  warnWindowsHooks,
   LEGACY_MARKETPLACE_PLUGIN_NAMES,
   LEGACY_SKILL_NAMES,
   LEGACY_PROMPT_NAMES,
   LEGACY_HOOK_SCRIPT_NAMES,
   MANAGED_HOOK_SCRIPT_NAMES,
-  DEFAULT_MARKETPLACE,
-  PLUGIN_BUNDLE_ENTRIES,
   getCodexHome,
   getHomePluginRoot,
   getHomeMarketplacePath,
   getWorkspacePluginRoot,
   getWorkspaceMarketplacePath,
   renderCodexConfigToml,
-  copyRecursive,
-  copyPluginBundle,
   insertRootKey,
   ensureSectionLine,
   ensureWritableRoots,
@@ -795,15 +802,8 @@ module.exports = {
   runBabysitterCli,
   ensureGlobalProcessLibrary,
   getMarketplaceRootDir,
-  normalizeMarketplaceSourcePath,
-  ensureMarketplaceEntry,
-  removeMarketplaceEntry,
   removeLegacyCodexSurface,
-  installManagedSkills,
-  mergeManagedHooksConfig,
-  installManagedHooks,
   installCodexSurface,
   harnessInstall,
   harnessTeamInstall,
-  warnWindowsHooks,
 };

package/bin/uninstall.js

@@ -1,7 +1,6 @@
 #!/usr/bin/env node
 'use strict';
 
-const path = require('path');
 const fs = require('fs');
 const shared = require('./install-shared');
 

package/hooks/babysitter-proxied-post-tool-use.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-pre-tool-use.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-session-end.sh

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

package/hooks/babysitter-proxied-session-start.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.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx -y @a5c-ai/hooks-mux-cli invoke --adapter codex --handler \"bash ./hooks/babysitter-proxied-session-start.sh\" --json"
+            "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-session-start.sh\" --json"
           }
         ]
       }
@@ -17,7 +17,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx -y @a5c-ai/hooks-mux-cli invoke --adapter codex --handler \"bash ./hooks/babysitter-proxied-stop.sh\" --json"
+            "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-stop.sh\" --json"
           }
         ]
       }
@@ -28,7 +28,40 @@
         "hooks": [
           {
             "type": "command",
-            "command": "npx -y @a5c-ai/hooks-mux-cli invoke --adapter codex --handler \"bash ./hooks/babysitter-proxied-user-prompt-submit.sh\" --json"
+            "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-user-prompt-submit.sh\" --json"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-pre-tool-use.sh\" --json"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-post-tool-use.sh\" --json"
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": ".*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "adapters-hooks invoke --adapter codex --handler \"bash .codex/hooks/babysitter-proxied-session-end.sh\" --json"
           }
         ]
       }

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@a5c-ai/babysitter-codex",
-  "version": "5.0.1-staging.ff2c19f9",
+  "version": "5.1.1-staging.583e3d9a6ed7",
   "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
   "scripts": {
-    "test": "node test/integration.test.js && node test/packaged-install.test.js",
-    "sync:commands": "node scripts/sync-command-skills.js",
+    "test": "npm run validate:ci",
+    "test:integration": "node test/integration.test.js",
+    "test:packaged-install": "node test/packaged-install.test.js",
+    "validate:ci": "npm run test:integration && npm run test:packaged-install",
+    "team:install": "node scripts/team-install.js",
     "deploy": "npm publish --access public",
-    "deploy:staging": "npm publish --access public --tag staging",
-    "sync:skills": "node scripts/sync-command-skills.js"
+    "deploy:staging": "npm publish --access public --tag staging"
   },
   "bin": {
     "babysitter-codex": "bin/cli.js"
@@ -36,9 +38,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/a5c-ai/babysitter"
+    "url": "git+https://github.com/a5c-ai/babysitter-codex.git"
   },
-  "dependencies": {
-    "@a5c-ai/babysitter-sdk": "5.0.1-staging.ff2c19f9"
+  "homepage": "https://github.com/a5c-ai/babysitter-codex#readme",
+  "bugs": {
+    "url": "https://github.com/a5c-ai/babysitter-codex/issues"
   }
 }

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/skills/babysit/SKILL.md

@@ -1,14 +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
 
@@ -17,13 +27,19 @@ Orchestrate `.a5c/runs/<runId>/` through iterative execution.
 Read the SDK version from `versions.json` to ensure version compatibility:
 
 ```bash
-SDK_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('${CODEX_PLUGIN_ROOT}/versions.json','utf8')).sdkVersion||'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 `babysitter` is already installed globally at the correct version, you may use `CLI="babysitter"` instead.
+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
 
@@ -31,13 +47,13 @@ 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
 $CLI instructions:babysit-skill --harness codex --interactive
 ```
 
-For non-interactive runs (e.g., with `-p` flag or no question tool):
+For non-interactive mode (running with `-p` flag or no AskUserQuestion tool):
 
 ```bash
 $CLI instructions:babysit-skill --harness codex --no-interactive

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-plugins --marketplace-name <name> --global|--project [--json]
+```
+
+## Blueprint Lifecycle
+
+For `blueprint:install`, `blueprint:update`, `blueprint:configure`, and `blueprint:list-plugins`, 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