@a5c-ai/babysitter-openclaw 5.0.1-staging.75c8fb21 → 5.0.1-staging.792ae5657ca6

package/README.md

@@ -13,24 +13,31 @@ The SDK (`@a5c-ai/babysitter-sdk`) remains the single source of truth for orches
 
 ## Installation
 
-### Primary: Babysitter Harness Install
+Install the Babysitter CLI once:
 
 ```bash
-babysitter harness:install-plugin openclaw
+npm install -g @a5c-ai/babysitter
 ```
 
-This installs the `@a5c-ai/babysitter-openclaw` npm package and registers it with OpenClaw.
+### Primary: Babysitter Harness Install
 
-### Secondary: npm
+Use the SDK helper for scriptable global or workspace installs. This is the canonical path used by the installer tests and resolves to `npx --yes @a5c-ai/babysitter-openclaw install ...` under the hood:
 
 ```bash
-npm install -g @a5c-ai/babysitter-openclaw
+# Global install
+babysitter harness:install-plugin openclaw
+
+# Workspace install
+babysitter harness:install-plugin openclaw --workspace /path/to/repo
 ```
 
-The `postinstall` script registers the plugin globally. To install into a specific workspace:
+This installs the `@a5c-ai/babysitter-openclaw` npm package and registers it with OpenClaw.
+
+### Secondary: Published package installer
 
 ```bash
-npx @a5c-ai/babysitter-openclaw install --workspace /path/to/repo
+npx --yes @a5c-ai/babysitter-openclaw install --global
+npx --yes @a5c-ai/babysitter-openclaw install --workspace /path/to/repo
 ```
 
 ### Verify Installation
@@ -42,7 +49,7 @@ babysitter harness:discover --json
 ### Removal
 
 ```bash
-npm uninstall -g @a5c-ai/babysitter-openclaw
+npx --yes @a5c-ai/babysitter-openclaw uninstall --global
 ```
 
 ## Architecture
@@ -204,7 +211,7 @@ When the `babysitter` CLI is not available globally, hooks fall back to `npx -y
 ## Plugin Layout
 
 ```text
-plugins/babysitter-openclaw/
+artifacts/generated-plugins/openclaw/
 |-- package.json              # npm package manifest
 |-- plugin.json               # Babysitter plugin manifest
 |-- openclaw.plugin.json      # OpenClaw-native plugin manifest
@@ -262,7 +269,7 @@ npm install
 ### Running Tests
 
 ```bash
-cd plugins/babysitter-openclaw
+cd artifacts/generated-plugins/openclaw
 npm test
 npm run test:integration
 npm run test:packaged-install

package/bin/install-shared.cjs

@@ -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.0.1-staging.792ae5657ca6",
     author: { name: "a5c.ai" },
   };
   if (idx >= 0) marketplace.plugins[idx] = entry;

package/commands/call.md

@@ -4,4 +4,8 @@ argument-hint: Specific instructions for the run.
 allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
 ---
 
-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/commands/cleanup.md

@@ -10,11 +10,33 @@ Create and run a cleanup process using the process at `skills\babysit\process\cr
 
 Implementation notes (for the process):
 - Parse arguments for `--dry-run` flag (if present, set dryRun: true in inputs) and `--keep-days N` (default: 7)
-- The process scans .a5c/runs/ for completed/failed runs, aggregates insights, writes summaries, then removes old data
-- Always show the user what will be removed before removing (in interactive mode via breakpoints)
-- In non-interactive mode (yolo), proceed with cleanup using defaults
-- The insights file goes to docs/run-history-insights.md
-- Only remove terminal runs (completed/failed) older than the keep-days threshold
-- Never remove active/in-progress runs
-- Remove orphaned process files not referenced by remaining runs
-- After cleanup, show remaining run count and disk usage
+
+CRITICAL: The cleanup MUST follow this exact phase order. Do NOT delete any run before Phase 2 completes.
+
+Phase 1 — Scan:
+- Scan .a5c/runs/ for all runs
+- Classify each as terminal (completed/failed) or active (in-progress/created)
+- Identify terminal runs older than the keep-days threshold as removal candidates
+- Never mark active/in-progress runs for removal
+- Count and report: total runs, terminal, active, removal candidates, disk usage
+
+Phase 2 — Aggregate insights (BEFORE any deletion):
+- For EVERY removal candidate, read its run.json and journal/ events
+- Extract: processId, prompt, status, event count, created date, task summaries
+- Group by process type and extract patterns (retry counts, convergence behavior, failure modes)
+- Append a new dated section to docs/run-history-insights.md with:
+  - Summary statistics (runs removed, disk freed, runs retained)
+  - Run categories with counts and descriptions
+  - Key patterns observed (multi-batch convergence, retry behavior, etc.)
+  - What worked well / what didn't from the run data
+- This file MUST be written and verified before proceeding to Phase 3
+
+Phase 3 — Confirm removal:
+- In interactive mode, show the user what will be removed via a breakpoint
+- In non-interactive mode (yolo), proceed with defaults
+- In dry-run mode, stop here and show what would be removed
+
+Phase 4 — Remove:
+- Delete the terminal runs older than keep-days threshold
+- Identify and remove orphaned process files not referenced by remaining runs
+- Show remaining run count and disk usage after cleanup

package/commands/doctor.md

@@ -156,7 +156,6 @@ If it exists:
 **Goal:** Inspect babysitter session files for health and detect runaway loops.
 
 - Search for session state files using Glob:
-  - `plugins/babysitter/skills/babysit/state/*.md`
   - `.a5c/state/*.md`
   - `.a5c/state/*.json`
 - For each session state file found:
@@ -260,7 +259,7 @@ Mark as PASS if total size < 500MB and no files > 10MB. Mark as WARN if total si
 
 ### 10a. Hook Registration
 
-- Locate the plugin root. Check for `CLAUDE_PLUGIN_ROOT` env var, or search for `plugins/babysitter/hooks/hooks.json` by walking up from the current directory.
+- Locate the plugin root. Check for `CLAUDE_PLUGIN_ROOT` env var first, or search for a babysitter `hooks.json` by walking up from the current directory.
 - If found, read `hooks.json` and verify:
   - A `Stop` hook entry exists with a command referencing `babysitter-stop-hook.sh`.
   - A `SessionStart` hook entry exists with a command referencing `babysitter-session-start-hook.sh`.
@@ -315,7 +314,7 @@ If the stop hook shows NO evidence of execution (no log entries, no journal even
 
 Perform these diagnostic steps in order and report the first failure found:
 
-1. **Plugin not installed**: Check if `plugins/babysitter/` exists relative to the project root and if `CLAUDE_PLUGIN_ROOT` is set. If the plugin directory doesn't exist, report: "Plugin not installed — the babysitter plugin directory is missing."
+1. **Plugin not installed**: Check if `CLAUDE_PLUGIN_ROOT` is set or if a babysitter plugin directory exists relative to the project root. If neither exists, report: "Plugin not installed — the babysitter plugin directory is missing."
 
 2. **Plugin not enabled**: Check for Claude settings files:
    - `~/.claude/settings.json` — look for `babysitter` in `enabledPlugins`.

package/commands/yolo.md

@@ -1,7 +1,11 @@
----
-description: Orchestrate a babysitter run. use this command to start babysitting a complex workflow in a non-interactive mode, without any user interaction or breakpoints in the run.
-argument-hint: Specific instructions for the run.
-allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
----
-
-Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). but without any user interaction or breakpoints in the run.
+---
+description: Orchestrate a babysitter run. use this command to start babysitting a complex workflow in a non-interactive mode, without any user interaction or breakpoints in the run.
+argument-hint: Specific instructions for the run.
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+---
+
+Start the Babysitter run directly through the CLI, without any user interaction or breakpoints. Do not invoke the Skill tool and do not run an instructions-only command. In Claude Code, use Bash to run `babysitter harness:yolo --harness claude-code --workspace "$PWD" --prompt "<user arguments>" --json`; in Codex, run `babysitter harness:yolo --harness codex --workspace "$PWD" --prompt "<user arguments>" --json`; in other harnesses, use the same command with that harness id. Replace `<user arguments>` with the arguments shown below, wait for the command to finish, and treat the CLI completion proof as the result.
+
+User arguments for this command:
+
+$ARGUMENTS

package/extensions/hooks/gateway-request-completed.ts

@@ -0,0 +1,20 @@
+/**
+ * OpenClaw gateway.request.completed hook — delegates to shell script.
+ */
+import { execFileSync } from "node:child_process";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PLUGIN_ROOT = resolve(__dirname, "../..");
+
+export async function gatewayRequestCompletedHandler(context: Record<string, unknown>): Promise<void> {
+  try {
+    execFileSync("bash", [resolve(PLUGIN_ROOT, "hooks/babysitter-proxied-gateway-request-completed.sh")], {
+      input: JSON.stringify(context),
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: 30000,
+      env: { ...process.env, ADAPTER_NAME: "openclaw", PLUGIN_ROOT },
+    });
+  } catch { /* best-effort */ }
+}

package/extensions/hooks/gateway-request-received.ts

@@ -0,0 +1,20 @@
+/**
+ * OpenClaw gateway.request.received hook — delegates to shell script.
+ */
+import { execFileSync } from "node:child_process";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PLUGIN_ROOT = resolve(__dirname, "../..");
+
+export async function gatewayRequestReceivedHandler(context: Record<string, unknown>): Promise<void> {
+  try {
+    execFileSync("bash", [resolve(PLUGIN_ROOT, "hooks/babysitter-proxied-gateway-request-received.sh")], {
+      input: JSON.stringify(context),
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: 30000,
+      env: { ...process.env, ADAPTER_NAME: "openclaw", PLUGIN_ROOT },
+    });
+  } catch { /* best-effort */ }
+}

package/extensions/hooks/{before-prompt-build.ts → gateway-request-routed.ts}

@@ -1,5 +1,5 @@
 /**
- * OpenClaw before_prompt_build hook — delegates to shell script.
+ * OpenClaw gateway.request.routed hook — delegates to shell script.
  */
 import { execFileSync } from "node:child_process";
 import { resolve, dirname } from "node:path";
@@ -8,9 +8,9 @@ import { fileURLToPath } from "node:url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PLUGIN_ROOT = resolve(__dirname, "../..");
 
-export async function beforePromptBuildHandler(context: Record<string, unknown>): Promise<void> {
+export async function gatewayRequestRoutedHandler(context: Record<string, unknown>): Promise<void> {
   try {
-    execFileSync("bash", [resolve(PLUGIN_ROOT, "hooks/babysitter-proxied-before-prompt-build.sh")], {
+    execFileSync("bash", [resolve(PLUGIN_ROOT, "hooks/babysitter-proxied-gateway-request-routed.sh")], {
       input: JSON.stringify(context),
       stdio: ["pipe", "pipe", "pipe"],
       timeout: 30000,

package/extensions/hooks/{session-end.ts → plugin-tool-after.ts}

@@ -1,5 +1,5 @@
 /**
- * OpenClaw session_end hook — delegates to shell script.
+ * OpenClaw plugin.tool.after hook — delegates to shell script.
  */
 import { execFileSync } from "node:child_process";
 import { resolve, dirname } from "node:path";
@@ -8,9 +8,9 @@ import { fileURLToPath } from "node:url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PLUGIN_ROOT = resolve(__dirname, "../..");
 
-export async function sessionEndHandler(context: Record<string, unknown>): Promise<void> {
+export async function pluginToolAfterHandler(context: Record<string, unknown>): Promise<void> {
   try {
-    execFileSync("bash", [resolve(PLUGIN_ROOT, "hooks/babysitter-proxied-session-end.sh")], {
+    execFileSync("bash", [resolve(PLUGIN_ROOT, "hooks/babysitter-proxied-plugin-tool-after.sh")], {
       input: JSON.stringify(context),
       stdio: ["pipe", "pipe", "pipe"],
       timeout: 30000,

package/extensions/hooks/{session-start.ts → plugin-tool-before.ts}

@@ -1,5 +1,5 @@
 /**
- * OpenClaw session_start hook — delegates to shell script.
+ * OpenClaw plugin.tool.before hook — delegates to shell script.
  */
 import { execFileSync } from "node:child_process";
 import { resolve, dirname } from "node:path";
@@ -8,9 +8,9 @@ import { fileURLToPath } from "node:url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PLUGIN_ROOT = resolve(__dirname, "../..");
 
-export async function sessionStartHandler(context: Record<string, unknown>): Promise<void> {
+export async function pluginToolBeforeHandler(context: Record<string, unknown>): Promise<void> {
   try {
-    execFileSync("bash", [resolve(PLUGIN_ROOT, "hooks/babysitter-proxied-session-start.sh")], {
+    execFileSync("bash", [resolve(PLUGIN_ROOT, "hooks/babysitter-proxied-plugin-tool-before.sh")], {
       input: JSON.stringify(context),
       stdio: ["pipe", "pipe", "pipe"],
       timeout: 30000,

package/extensions/hooks/{agent-end.ts → plugin-turn-stop.ts}

@@ -1,5 +1,5 @@
 /**
- * OpenClaw agent_end hook — delegates to shell script.
+ * OpenClaw plugin.turn.stop hook — delegates to shell script.
  */
 import { execFileSync } from "node:child_process";
 import { resolve, dirname } from "node:path";
@@ -8,9 +8,9 @@ import { fileURLToPath } from "node:url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PLUGIN_ROOT = resolve(__dirname, "../..");
 
-export async function agentEndHandler(context: Record<string, unknown>): Promise<void> {
+export async function pluginTurnStopHandler(context: Record<string, unknown>): Promise<void> {
   try {
-    execFileSync("bash", [resolve(PLUGIN_ROOT, "hooks/babysitter-proxied-agent-end.sh")], {
+    execFileSync("bash", [resolve(PLUGIN_ROOT, "hooks/babysitter-proxied-plugin-turn-stop.sh")], {
       input: JSON.stringify(context),
       stdio: ["pipe", "pipe", "pipe"],
       timeout: 30000,

package/hooks/{babysitter-proxied-before-prompt-build.js → babysitter-proxied-gateway-request-routed.js}

@@ -8,7 +8,7 @@ var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.res
 var stdin = "";
 try { stdin = readFileSync(0, "utf8"); } catch {}
 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/user-prompt-submit.sh")), {
     input: stdin,
     stdio: ["pipe", "pipe", "pipe"],
     timeout: 30000,

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,24 @@
+#!/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 {}
+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
+    })
+  });
+  process.stdout.write(result);
+} catch (e) {
+  process.stdout.write("{}\n");
+}

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-plugin-tool-before.js

@@ -0,0 +1,24 @@
+#!/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 {}
+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 || "openclaw",
+      PLUGIN_ROOT: PLUGIN_ROOT
+    })
+  });
+  process.stdout.write(result);
+} catch (e) {
+  process.stdout.write("{}\n");
+}

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}

@@ -8,7 +8,7 @@ var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.res
 var stdin = "";
 try { stdin = readFileSync(0, "utf8"); } catch {}
 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,

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.75c8fb21",
+  "version": "5.0.1-staging.792ae5657ca6",
   "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.75c8fb21",
+  "version": "5.0.1-staging.792ae5657ca6",
   "type": "module",
   "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
   "openclaw": {
@@ -22,7 +22,7 @@
     "sdk-integration"
   ],
   "dependencies": {
-    "@a5c-ai/babysitter-sdk": "5.0.1-staging.75c8fb21"
+    "@a5c-ai/babysitter-sdk": "5.0.1-staging.792ae5657ca6"
   },
   "peerDependencies": {
     "openclaw": "*"
@@ -60,11 +60,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/a5c-ai/babysitter.git",
-    "directory": "plugins/babysitter-openclaw"
+    "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/issues"
+    "url": "https://github.com/a5c-ai/babysitter-openclaw/issues"
   }
 }

package/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "babysitter",
-  "version": "5.0.1-staging.75c8fb21",
+  "version": "5.0.1-staging.792ae5657ca6",
   "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/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/cleanup/SKILL.md

@@ -11,11 +11,33 @@ Create and run a cleanup process using the process at `skills\babysit\process\cr
 
 Implementation notes (for the process):
 - Parse arguments for `--dry-run` flag (if present, set dryRun: true in inputs) and `--keep-days N` (default: 7)
-- The process scans .a5c/runs/ for completed/failed runs, aggregates insights, writes summaries, then removes old data
-- Always show the user what will be removed before removing (in interactive mode via breakpoints)
-- In non-interactive mode (yolo), proceed with cleanup using defaults
-- The insights file goes to docs/run-history-insights.md
-- Only remove terminal runs (completed/failed) older than the keep-days threshold
-- Never remove active/in-progress runs
-- Remove orphaned process files not referenced by remaining runs
-- After cleanup, show remaining run count and disk usage
+
+CRITICAL: The cleanup MUST follow this exact phase order. Do NOT delete any run before Phase 2 completes.
+
+Phase 1 — Scan:
+- Scan .a5c/runs/ for all runs
+- Classify each as terminal (completed/failed) or active (in-progress/created)
+- Identify terminal runs older than the keep-days threshold as removal candidates
+- Never mark active/in-progress runs for removal
+- Count and report: total runs, terminal, active, removal candidates, disk usage
+
+Phase 2 — Aggregate insights (BEFORE any deletion):
+- For EVERY removal candidate, read its run.json and journal/ events
+- Extract: processId, prompt, status, event count, created date, task summaries
+- Group by process type and extract patterns (retry counts, convergence behavior, failure modes)
+- Append a new dated section to docs/run-history-insights.md with:
+  - Summary statistics (runs removed, disk freed, runs retained)
+  - Run categories with counts and descriptions
+  - Key patterns observed (multi-batch convergence, retry behavior, etc.)
+  - What worked well / what didn't from the run data
+- This file MUST be written and verified before proceeding to Phase 3
+
+Phase 3 — Confirm removal:
+- In interactive mode, show the user what will be removed via a breakpoint
+- In non-interactive mode (yolo), proceed with defaults
+- In dry-run mode, stop here and show what would be removed
+
+Phase 4 — Remove:
+- Delete the terminal runs older than keep-days threshold
+- Identify and remove orphaned process files not referenced by remaining runs
+- Show remaining run count and disk usage after cleanup

package/skills/doctor/SKILL.md

@@ -157,7 +157,6 @@ If it exists:
 **Goal:** Inspect babysitter session files for health and detect runaway loops.
 
 - Search for session state files using Glob:
-  - `plugins/babysitter/skills/babysit/state/*.md`
   - `.a5c/state/*.md`
   - `.a5c/state/*.json`
 - For each session state file found:
@@ -261,7 +260,7 @@ Mark as PASS if total size < 500MB and no files > 10MB. Mark as WARN if total si
 
 ### 10a. Hook Registration
 
-- Locate the plugin root. Check for `CLAUDE_PLUGIN_ROOT` env var, or search for `plugins/babysitter/hooks/hooks.json` by walking up from the current directory.
+- Locate the plugin root. Check for `CLAUDE_PLUGIN_ROOT` env var first, or search for a babysitter `hooks.json` by walking up from the current directory.
 - If found, read `hooks.json` and verify:
   - A `Stop` hook entry exists with a command referencing `babysitter-stop-hook.sh`.
   - A `SessionStart` hook entry exists with a command referencing `babysitter-session-start-hook.sh`.
@@ -316,7 +315,7 @@ If the stop hook shows NO evidence of execution (no log entries, no journal even
 
 Perform these diagnostic steps in order and report the first failure found:
 
-1. **Plugin not installed**: Check if `plugins/babysitter/` exists relative to the project root and if `CLAUDE_PLUGIN_ROOT` is set. If the plugin directory doesn't exist, report: "Plugin not installed — the babysitter plugin directory is missing."
+1. **Plugin not installed**: Check if `CLAUDE_PLUGIN_ROOT` is set or if a babysitter plugin directory exists relative to the project root. If neither exists, report: "Plugin not installed — the babysitter plugin directory is missing."
 
 2. **Plugin not enabled**: Check for Claude settings files:
    - `~/.claude/settings.json` — look for `babysitter` in `enabledPlugins`.

package/skills/yolo/SKILL.md

@@ -5,4 +5,8 @@ description: Orchestrate a babysitter run. use this command to start babysitting
 
 # yolo
 
-Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). but without any user interaction or breakpoints in the run.
+Start the Babysitter run directly through the CLI, without any user interaction or breakpoints. Do not invoke the Skill tool and do not run an instructions-only command. In Claude Code, use Bash to run `babysitter harness:yolo --harness claude-code --workspace "$PWD" --prompt "<user arguments>" --json`; in Codex, run `babysitter harness:yolo --harness codex --workspace "$PWD" --prompt "<user arguments>" --json`; in other harnesses, use the same command with that harness id. Replace `<user arguments>` with the arguments shown below, wait for the command to finish, and treat the CLI completion proof as the result.
+
+User arguments for this command:
+
+$ARGUMENTS

package/versions.json

@@ -1,4 +1,4 @@
 {
-  "sdkVersion": "5.0.1-staging.75c8fb21",
-  "extensionVersion": "5.0.0"
+  "sdkVersion": "5.0.1-staging.792ae5657ca6",
+  "extensionVersion": "5.0.1-staging.792ae5657ca6"
 }

package/hooks/babysitter-proxied-agent-end.sh

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

package/hooks/babysitter-proxied-before-prompt-build.sh

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

package/scripts/sync-command-docs.cjs

@@ -1,107 +0,0 @@
-'use strict';
-
-const path = require('path');
-const {
-  listMarkdownBasenames,
-  reportCheckResult,
-  syncCommandMirrors,
-  syncSkillsFromCommands,
-  writeFileIfChanged,
-} = require('../../../scripts/plugin-command-sync-lib.cjs');
-
-const PACKAGE_ROOT = path.resolve(__dirname, '..');
-const REPO_ROOT = path.resolve(PACKAGE_ROOT, '..', '..');
-const ROOT_COMMANDS = path.join(REPO_ROOT, 'plugins', 'babysitter', 'commands');
-const COMMANDS_ROOT = path.join(PACKAGE_ROOT, 'commands');
-const SKILLS_ROOT = path.join(PACKAGE_ROOT, 'skills');
-const LABEL = 'babysitter-openclaw sync';
-
-const BABYSIT_SKILL = `---
-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.)
----
-
-# babysit
-
-Orchestrate \`.a5c/runs/<runId>/\` through iterative execution.
-
-## Dependencies
-
-### Babysitter SDK and CLI
-
-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"
-\`\`\`
-
-## Instructions
-
-Run the following command to get full orchestration instructions:
-
-\`\`\`bash
-babysitter instructions:babysit-skill --harness openclaw --interactive
-\`\`\`
-
-For non-interactive mode:
-
-\`\`\`bash
-babysitter instructions:babysit-skill --harness openclaw --no-interactive
-\`\`\`
-
-Follow the instructions returned by the command above to orchestrate the run.
-`;
-
-function getCommandNames() {
-  return listMarkdownBasenames(ROOT_COMMANDS);
-}
-
-function main() {
-  const check = process.argv.includes('--check');
-  const commandNames = getCommandNames();
-  const mirrorResult = syncCommandMirrors({
-    label: LABEL,
-    sourceRoot: ROOT_COMMANDS,
-    targetRoot: COMMANDS_ROOT,
-    names: commandNames,
-    check,
-    cwd: PACKAGE_ROOT,
-  });
-  const skillsResult = syncSkillsFromCommands({
-    label: LABEL,
-    sourceRoot: COMMANDS_ROOT,
-    skillsRoot: SKILLS_ROOT,
-    names: commandNames,
-    check,
-    cwd: PACKAGE_ROOT,
-  });
-
-  const babysitSkillPath = path.join(SKILLS_ROOT, 'babysit', 'SKILL.md');
-  if (check) {
-    const fs = require('fs');
-    const stale = [...mirrorResult.stale, ...skillsResult.stale];
-    const current = fs.existsSync(babysitSkillPath)
-      ? fs.readFileSync(babysitSkillPath, 'utf8')
-      : null;
-    if (current !== BABYSIT_SKILL) {
-      stale.push(path.relative(PACKAGE_ROOT, babysitSkillPath));
-    }
-    reportCheckResult(LABEL, stale);
-    return;
-  }
-
-  const babysitUpdated = writeFileIfChanged(babysitSkillPath, BABYSIT_SKILL) ? 1 : 0;
-  const updated = mirrorResult.updated + skillsResult.updated + babysitUpdated;
-
-  if (updated === 0) {
-    console.log(`[${LABEL}] no openclaw command or skill changes were needed.`);
-    return;
-  }
-
-  console.log(`[${LABEL}] updated ${updated} openclaw command/skill file(s).`);
-}
-
-main();