@a5c-ai/babysitter-opencode 5.0.1-staging.d73033a7 → 5.0.1-staging.daf8e165bc4a

package/hooks/babysitter-proxied-tool-execute-before.js

@@ -1,166 +1,26 @@
 #!/usr/bin/env node
-/**
- * Unified Tool Execute Before Hook for OpenCode
- * Routes through hooks-proxy for all hook execution.
- *
- * Fires before a tool execution in OpenCode. Delegates to
- * `babysitter hook:run --hook-type pre-tool-use` via hooks-proxy.
- *
- * This hook can be used to:
- * - Log tool invocations for babysitter run observability
- * - Block certain tool calls during specific orchestration phases
- * - Inject babysitter context into tool arguments
- *
- * OpenCode plugin protocol:
- *   - Receives tool context as JSON via stdin
- *   - Outputs JSON to stdout (empty = allow, { block: true } = block)
- *   - Exit 0 = success
- */
-
 "use strict";
-
-const { execSync } = require("child_process");
-const { readFileSync, mkdirSync, appendFileSync, existsSync, writeFileSync } = require("fs");
-const os = require("os");
-const path = require("path");
-
-const PLUGIN_ROOT = process.env.OPENCODE_PLUGIN_ROOT || path.resolve(__dirname, "..");
-const GLOBAL_ROOT = process.env.BABYSITTER_GLOBAL_STATE_DIR || path.join(os.homedir(), ".a5c");
-const STATE_DIR = process.env.BABYSITTER_STATE_DIR || path.join(GLOBAL_ROOT, "state");
-const LOG_DIR = process.env.BABYSITTER_LOG_DIR || path.join(GLOBAL_ROOT, "logs");
-const LOG_FILE = path.join(LOG_DIR, "babysitter-tool-before-hook.log");
-const PROXY_MARKER = path.join(PLUGIN_ROOT, ".hooks-proxy-install-attempted");
-
-function ensureDir(dir) {
-  try { mkdirSync(dir, { recursive: true }); } catch { /* best-effort */ }
-}
-
-function blog(msg) {
-  ensureDir(LOG_DIR);
-  const ts = new Date().toISOString();
-  try {
-    appendFileSync(LOG_FILE, `[INFO] ${ts} ${msg}\n`);
-  } catch { /* best-effort */ }
-}
-
-function getSdkVersion() {
-  try {
-    const versions = JSON.parse(readFileSync(path.join(PLUGIN_ROOT, "versions.json"), "utf8"));
-    return versions.sdkVersion || "latest";
-  } catch {
-    return "latest";
-  }
-}
-
-function resolveHooksProxy() {
-  try {
-    execSync("a5c-hooks-proxy --version", { stdio: "pipe", timeout: 5000 });
-    return "a5c-hooks-proxy";
-  } catch { /* not in PATH */ }
-
-  const localProxy = path.join(
-    process.env.HOME || process.env.USERPROFILE || "~",
-    ".local", "bin", process.platform === "win32" ? "a5c-hooks-proxy.exe" : "a5c-hooks-proxy"
-  );
-  if (existsSync(localProxy)) {
-    return localProxy;
-  }
-
-  return null;
-}
-
-function installHooksProxy(version) {
-  if (existsSync(PROXY_MARKER)) return;
-
-  try {
-    execSync(`npm i -g "@a5c-ai/hooks-proxy-cli@${version}" --loglevel=error`, {
-      stdio: "pipe",
-      timeout: 120000,
-    });
-    blog(`Installed hooks-proxy globally (${version})`);
-  } catch {
-    try {
-      const prefix = path.join(process.env.HOME || process.env.USERPROFILE || "~", ".local");
-      execSync(`npm i -g "@a5c-ai/hooks-proxy-cli@${version}" --prefix "${prefix}" --loglevel=error`, {
-        stdio: "pipe",
-        timeout: 120000,
-      });
-      blog(`Installed hooks-proxy to user prefix (${version})`);
-    } catch {
-      blog("hooks-proxy installation failed");
-    }
-  }
-
-  try { writeFileSync(PROXY_MARKER, version); } catch { /* best-effort */ }
-}
-
-function main() {
-  const sessionId = process.env.BABYSITTER_SESSION_ID
-    || process.env.OPENCODE_SESSION_ID
-    || "";
-
-  if (!sessionId) {
-    // No session -- pass through without intervention
-    process.stdout.write("{}\n");
-    return;
-  }
-
-  // Read stdin for tool context
-  let inputData = "";
-  try {
-    inputData = require("fs").readFileSync(0, "utf8");
-  } catch {
-    // No stdin available
-  }
-
-  blog(`Unified tool-execute-before: session=${sessionId}`);
-
-  const hookInput = JSON.stringify({
-    session_id: sessionId,
-    cwd: process.cwd(),
-    harness: "opencode",
-    plugin_root: PLUGIN_ROOT,
-    tool_context: inputData ? JSON.parse(inputData) : {},
+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("[extension-mux] stdin read failed: " + (e instanceof Error ? e.message : String(e)) + "\n"); }
+try {
+  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 || "opencode",
+      PLUGIN_ROOT: PLUGIN_ROOT
+    })
   });
-
-  const sdkVersion = getSdkVersion();
-
-  // Ensure hooks-proxy is installed
-  let proxy = resolveHooksProxy();
-  if (!proxy) {
-    installHooksProxy(sdkVersion);
-    proxy = resolveHooksProxy();
-  }
-
-  const handler = `babysitter hook:run --harness unified --hook-type pre-tool-use --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
-
-  try {
-    let result;
-    if (proxy) {
-      blog(`Using hooks-proxy: ${proxy}`);
-      result = execSync(`"${proxy}" invoke --adapter opencode --handler "${handler}" --json`, {
-        input: hookInput,
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 10000,
-        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-      });
-    } else {
-      blog("hooks-proxy not found after install, using npx fallback");
-      result = execSync(`npx -y "@a5c-ai/hooks-proxy-cli@${sdkVersion}" invoke --adapter opencode --handler "${handler}" --json`, {
-        input: hookInput,
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 30000,
-        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-      });
-    }
-    const output = result.toString("utf8").trim();
-    blog(`Hook result: ${output}`);
-    process.stdout.write((output || "{}") + "\n");
-  } catch (err) {
-    // On failure, allow the tool execution to proceed
-    blog(`Pre-tool-use hook failed: ${err.message} -- allowing execution`);
-    process.stdout.write("{}\n");
-  }
+  process.stdout.write(result);
+} catch (e) {
+  process.stderr.write("[extension-mux] 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);
 }
-
-main();

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

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

package/hooks/hooks.json

@@ -1,45 +1,37 @@
 {
   "version": 1,
-  "description": "Babysitter hook registration for OpenCode. Maps OpenCode plugin events to unified babysitter hook scripts with hooks-proxy support.",
+  "description": "babysitter hook registration for OpenCode.",
   "hooks": {
     "session.created": [
       {
         "type": "command",
-        "script": "hooks/babysitter-proxied-session-created.js",
-        "description": "Initialize babysitter session state and inject context (proxied via a5c-hooks-proxy)",
+        "script": "./hooks/babysitter-proxied-session-created.js",
+        "description": "babysitter SessionStart hook",
         "timeoutMs": 30000
       }
     ],
-    "session.idle": [
+    "tool.execute.before": [
       {
         "type": "command",
-        "script": "hooks/babysitter-proxied-session-idle.js",
-        "description": "Check for pending babysitter effects when agent goes idle (proxied via a5c-hooks-proxy)",
+        "script": "./hooks/babysitter-proxied-tool-execute-before.js",
+        "description": "babysitter PreToolUse hook",
         "timeoutMs": 30000
       }
     ],
-    "shell.env": [
-      {
-        "type": "command",
-        "script": "hooks/babysitter-proxied-shell-env.js",
-        "description": "Inject BABYSITTER_SESSION_ID and other env vars into shell (proxied via a5c-hooks-proxy)",
-        "timeoutMs": 5000
-      }
-    ],
-    "tool.execute.before": [
+    "tool.execute.after": [
       {
         "type": "command",
-        "script": "hooks/babysitter-proxied-tool-execute-before.js",
-        "description": "Pre-tool-use hook for babysitter awareness (proxied via a5c-hooks-proxy)",
-        "timeoutMs": 10000
+        "script": "./hooks/babysitter-proxied-tool-execute-after.js",
+        "description": "babysitter PostToolUse hook",
+        "timeoutMs": 30000
       }
     ],
-    "tool.execute.after": [
+    "shell.env": [
       {
         "type": "command",
-        "script": "hooks/babysitter-proxied-tool-execute-after.js",
-        "description": "Post-tool-use hook for babysitter awareness (proxied via a5c-hooks-proxy)",
-        "timeoutMs": 10000
+        "script": "./hooks/babysitter-proxied-shell-env.js",
+        "description": "babysitter ShellEnv hook",
+        "timeoutMs": 5000
       }
     ]
   }

package/package.json

@@ -1,46 +1,48 @@
 {
   "name": "@a5c-ai/babysitter-opencode",
-  "version": "5.0.1-staging.d73033a7",
-  "description": "Babysitter orchestration plugin for OpenCode with SDK-managed process-library bootstrapping and in-turn iteration model",
+  "version": "5.0.1-staging.daf8e165bc4a",
+  "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",
-    "test:integration": "node test/integration.test.js",
-    "sync:commands": "node scripts/sync-command-docs.cjs",
-    "postinstall": "node bin/install.cjs",
-    "preuninstall": "node bin/uninstall.cjs",
     "deploy": "npm publish --access public",
-    "deploy:staging": "npm publish --access public --tag staging"
+    "deploy:staging": "npm publish --access public --tag staging",
+    "postinstall": "node bin/install.js",
+    "preuninstall": "node bin/uninstall.js",
+    "team:install": "node scripts/team-install.js",
+    "test": "node test/integration.test.js"
   },
   "bin": {
-    "babysitter-opencode": "bin/cli.cjs"
+    "babysitter-opencode": "bin/cli.js"
   },
   "files": [
     "bin/",
-    "commands/",
     "hooks/",
-    "scripts/",
     "skills/",
+    "commands/",
+    "scripts/",
     "plugin.json",
-    "versions.json"
+    "README.md",
+    "versions.json",
+    "package.json"
   ],
   "keywords": [
     "babysitter",
     "opencode",
-    "orchestration",
-    "ai-agent",
-    "sdk-integration"
+    "orchestration"
   ],
   "author": "a5c.ai",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@a5c-ai/babysitter-sdk": "5.0.1-staging.daf8e165bc4a"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/a5c-ai/babysitter"
+    "url": "git+https://github.com/a5c-ai/babysitter-opencode.git"
   },
-  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-opencode#readme",
-  "dependencies": {
-    "@a5c-ai/babysitter-sdk": "5.0.1-staging.d73033a7"
+  "homepage": "https://github.com/a5c-ai/babysitter-opencode#readme",
+  "bugs": {
+    "url": "https://github.com/a5c-ai/babysitter-opencode/issues"
   }
 }

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "babysitter",
-  "version": "5.0.1-staging.d73033a7",
-  "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval -- powered by the Babysitter SDK",
+  "version": "5.0.1-staging.daf8e165bc4a",
+  "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",
   "harness": "opencode",
@@ -18,8 +18,10 @@
     "automation",
     "event-sourced",
     "hooks",
-    "opencode",
+    "TDD",
+    "quality-convergence",
     "agent",
-    "LLM"
+    "LLM",
+    "opencode"
   ]
 }

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.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+'use strict';
+
+var path = require('path');
+var shared = require('../bin/install-shared');
+
+var workspace = process.cwd();
+for (var i = 0; i < process.argv.length; i++) {
+  if (process.argv[i] === '--workspace' && process.argv[i + 1]) {
+    workspace = path.resolve(process.argv[i + 1]);
+  }
+}
+
+var src = process.env.PLUGIN_PACKAGE_ROOT || path.resolve(__dirname, '..');
+var dest = shared.getHomePluginRoot('workspace');
+console.log('[babysitter] Team install to ' + dest);
+
+shared.copyPluginBundle(src, dest);
+if (typeof shared.harnessTeamInstall === 'function') {
+  shared.harnessTeamInstall(src, dest, workspace);
+}
+shared.runPostInstall(dest);
+console.log('[babysitter] Team install complete.');

package/skills/accomplish-status/SKILL.md

@@ -29,12 +29,18 @@ Where `OPENCODE_CONFIG_DIR` is resolved from the `OPENCODE_CONFIG_DIR` environme
 Read the SDK version from `versions.json` to ensure version compatibility:
 
 ```bash
-SDK_VERSION=$(node -e "try{const fs=require('fs');const probes=['./plugins/babysitter-opencode/versions.json','./node_modules/@a5c-ai/babysitter-opencode/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')}")
+SDK_VERSION=$(node -e "try{const fs=require('fs');const probes=['./plugins/babysitter-unified/versions.json','./node_modules/@a5c-ai/babysitter-opencode/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"
+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 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`.
+
 ## Instructions
 
 ### 1. Resolve the status directory

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
-SDK_VERSION=$(node -e "try{const fs=require('fs');const probes=['./plugins/babysitter-opencode/versions.json','./node_modules/@a5c-ai/babysitter-opencode/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('${OPENCODE_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 opencode --interactive
+$CLI instructions:babysit-skill --harness opencode --interactive
 ```
 
-For non-interactive mode:
+For non-interactive mode (running with `-p` flag or no AskUserQuestion tool):
 
 ```bash
-babysitter instructions:babysit-skill --harness opencode --no-interactive
+$CLI instructions:babysit-skill --harness opencode --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 blueprint:add-marketplace --marketplace-url <url> [--marketplace-path <relative-path>] [--marketplace-branch <ref>] [--force] --global|--project [--json]
+```
+
+### Update a marketplace
+
+```bash
+babysitter blueprint:update-marketplace --marketplace-name <name> [--marketplace-branch <ref>] --global|--project [--json]
+```
+
+### List blueprints in a marketplace
+
+```bash
+babysitter blueprint: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 blueprint:install --plugin-name <name> [--marketplace-name <mp>] --global|--project [--json]
+babysitter blueprint:update --plugin-name <name> --marketplace-name <mp> --global|--project [--json]
+babysitter blueprint:configure --plugin-name <name> --marketplace-name <mp> --global|--project [--json]
+babysitter blueprint: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 blueprint:list-installed --global|--project [--json]
+babysitter blueprint:update-registry --plugin-name <name> --plugin-version <ver> --marketplace-name <mp> --global|--project [--json]
+babysitter blueprint: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-mux, extension-mux, 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