@a5c-ai/babysitter-openclaw 0.1.1-staging.45beae68

package/extensions/hooks/session-end.ts

@@ -0,0 +1,80 @@
+/**
+ * OpenClaw session_end hook handler.
+ * Delegates to: babysitter hook:run --hook-type stop --harness openclaw
+ *
+ * Runs on session teardown to finalize any active babysitter runs.
+ */
+
+import { execFileSync } from "node:child_process";
+import { readFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PLUGIN_ROOT = resolve(__dirname, "../..");
+
+function getLogDir(): string {
+  const dir = process.env.BABYSITTER_LOG_DIR ?? resolve(homedir(), ".a5c/logs");
+  mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+function getSdkVersion(): string {
+  try {
+    const versionsPath = resolve(PLUGIN_ROOT, "versions.json");
+    const data = JSON.parse(readFileSync(versionsPath, "utf8"));
+    return data.sdkVersion ?? "latest";
+  } catch {
+    return "latest";
+  }
+}
+
+function resolveBabysitterCli(): string {
+  try {
+    execFileSync("babysitter", ["--version"], { stdio: "ignore" });
+    return "babysitter";
+  } catch {
+    return `npx -y @a5c-ai/babysitter-sdk@${getSdkVersion()}`;
+  }
+}
+
+export async function sessionEndHandler(context: Record<string, unknown>): Promise<void> {
+  const logDir = getLogDir();
+  const stateDir = process.env.BABYSITTER_STATE_DIR ?? resolve(process.cwd(), ".a5c");
+  const cli = resolveBabysitterCli();
+
+  try {
+    const input = JSON.stringify(context);
+    const args = [
+      "hook:run",
+      "--hook-type", "stop",
+      "--harness", "openclaw",
+      "--plugin-root", PLUGIN_ROOT,
+      "--state-dir", stateDir,
+    ];
+
+    if (cli === "babysitter") {
+      execFileSync("babysitter", args, {
+        input,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 30_000,
+      });
+    } else {
+      execFileSync("npx", ["-y", `@a5c-ai/babysitter-sdk@${getSdkVersion()}`, ...args], {
+        input,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 60_000,
+      });
+    }
+  } catch (err) {
+    try {
+      const ts = new Date().toISOString();
+      const msg = `[ERROR] ${ts} session-end hook failed: ${err instanceof Error ? err.message : String(err)}\n`;
+      const { appendFileSync } = await import("node:fs");
+      appendFileSync(resolve(logDir, "babysitter-session-end-hook.log"), msg);
+    } catch {
+      // Swallow logging failures
+    }
+  }
+}

package/extensions/hooks/session-start.ts

@@ -0,0 +1,81 @@
+/**
+ * OpenClaw session_start hook handler.
+ * Delegates to: babysitter hook:run --hook-type session-start --harness openclaw
+ *
+ * Ensures the babysitter CLI is available and triggers session initialization.
+ */
+
+import { execFileSync } from "node:child_process";
+import { readFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PLUGIN_ROOT = resolve(__dirname, "../..");
+
+function getLogDir(): string {
+  const dir = process.env.BABYSITTER_LOG_DIR ?? resolve(homedir(), ".a5c/logs");
+  mkdirSync(dir, { recursive: true });
+  return dir;
+}
+
+function getSdkVersion(): string {
+  try {
+    const versionsPath = resolve(PLUGIN_ROOT, "versions.json");
+    const data = JSON.parse(readFileSync(versionsPath, "utf8"));
+    return data.sdkVersion ?? "latest";
+  } catch {
+    return "latest";
+  }
+}
+
+function resolveBabysitterCli(): string {
+  try {
+    execFileSync("babysitter", ["--version"], { stdio: "ignore" });
+    return "babysitter";
+  } catch {
+    return `npx -y @a5c-ai/babysitter-sdk@${getSdkVersion()}`;
+  }
+}
+
+export async function sessionStartHandler(context: Record<string, unknown>): Promise<void> {
+  const logDir = getLogDir();
+  const stateDir = process.env.BABYSITTER_STATE_DIR ?? resolve(process.cwd(), ".a5c");
+  const cli = resolveBabysitterCli();
+
+  try {
+    const input = JSON.stringify(context);
+    const args = [
+      "hook:run",
+      "--hook-type", "session-start",
+      "--harness", "openclaw",
+      "--plugin-root", PLUGIN_ROOT,
+      "--state-dir", stateDir,
+    ];
+
+    if (cli === "babysitter") {
+      execFileSync("babysitter", args, {
+        input,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 30_000,
+      });
+    } else {
+      execFileSync("npx", ["-y", `@a5c-ai/babysitter-sdk@${getSdkVersion()}`, ...args], {
+        input,
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 60_000,
+      });
+    }
+  } catch (err) {
+    // Log but do not fail the session — hooks are best-effort
+    try {
+      const ts = new Date().toISOString();
+      const msg = `[ERROR] ${ts} session-start hook failed: ${err instanceof Error ? err.message : String(err)}\n`;
+      const { appendFileSync } = await import("node:fs");
+      appendFileSync(resolve(logDir, "babysitter-session-start-hook.log"), msg);
+    } catch {
+      // Swallow logging failures
+    }
+  }
+}

package/extensions/index.ts

@@ -0,0 +1,67 @@
+import type { OpenClawPluginAPI } from "openclaw";
+import { sessionStartHandler } from "./hooks/session-start.js";
+import { sessionEndHandler } from "./hooks/session-end.js";
+import { beforePromptBuildHandler } from "./hooks/before-prompt-build.js";
+import { agentEndHandler } from "./hooks/agent-end.js";
+
+const COMMANDS = [
+  "assimilate",
+  "call",
+  "cleanup",
+  "contrib",
+  "doctor",
+  "forever",
+  "help",
+  "observe",
+  "plan",
+  "plugins",
+  "project-install",
+  "resume",
+  "retrospect",
+  "user-install",
+  "yolo",
+] as const;
+
+function toSkillPrompt(name: string, args: string): string {
+  return `/skill:${name}${args ? ` ${args}` : ""}`;
+}
+
+export default function activate(api: OpenClawPluginAPI): void {
+  // Register programmatic hooks via the OpenClaw Plugin SDK api.on() method.
+  // These delegate to babysitter hook:run — no logic lives here.
+  api.on("session_start", sessionStartHandler);
+  api.on("session_end", sessionEndHandler);
+  api.on("before_prompt_build", beforePromptBuildHandler);
+  api.on("agent_end", agentEndHandler);
+
+  // Register slash commands that forward to babysitter skills
+  const forwardBabysit = async (args: unknown) => {
+    api.sendUserMessage(toSkillPrompt("babysit", String(args ?? "").trim()));
+  };
+
+  api.registerCommand("babysit", {
+    description: "Load the Babysitter orchestration skill",
+    handler: forwardBabysit,
+  });
+
+  api.registerCommand("babysitter", {
+    description: "Alias for /babysit",
+    handler: forwardBabysit,
+  });
+
+  for (const name of COMMANDS) {
+    const forward = async (args: unknown) => {
+      api.sendUserMessage(toSkillPrompt(name, String(args ?? "").trim()));
+    };
+
+    api.registerCommand(name, {
+      description: `Open the Babysitter ${name} skill`,
+      handler: forward,
+    });
+
+    api.registerCommand(`babysitter:${name}`, {
+      description: `Alias for /${name}`,
+      handler: forward,
+    });
+  }
+}

package/hooks/babysitter-session-start.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+STATE_DIR="${BABYSITTER_STATE_DIR:-${PWD}/.a5c}"
+LOG_DIR="${BABYSITTER_LOG_DIR:-$HOME/.a5c/logs}"
+LOG_FILE="$LOG_DIR/babysitter-session-start-hook.log"
+
+export OPENCLAW_PLUGIN_ROOT="${OPENCLAW_PLUGIN_ROOT:-${PLUGIN_ROOT}}"
+export BABYSITTER_STATE_DIR="${STATE_DIR}"
+
+mkdir -p "$LOG_DIR" 2>/dev/null
+
+blog() {
+  local msg="$1"
+  local ts
+  ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  echo "[INFO] $ts $msg" >> "$LOG_FILE" 2>/dev/null
+  babysitter log --type hook --label "hook:session-start" --message "$msg" --source shell-hook 2>/dev/null || true
+}
+
+blog "Hook script invoked"
+blog "PLUGIN_ROOT=$PLUGIN_ROOT"
+blog "STATE_DIR=$STATE_DIR"
+
+# Get required SDK version from versions.json
+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")
+
+# Ensure babysitter CLI is available
+if ! command -v babysitter &>/dev/null; then
+  if [ -x "$HOME/.local/bin/babysitter" ]; then
+    export PATH="$HOME/.local/bin:$PATH"
+  else
+    if npm i -g "@a5c-ai/babysitter-sdk@${SDK_VERSION}" --loglevel=error 2>/dev/null; then
+      blog "Installed SDK globally (${SDK_VERSION})"
+    elif npm i -g "@a5c-ai/babysitter-sdk@${SDK_VERSION}" --prefix "$HOME/.local" --loglevel=error 2>/dev/null; then
+      export PATH="$HOME/.local/bin:$PATH"
+      blog "Installed SDK to user prefix (${SDK_VERSION})"
+    fi
+  fi
+fi
+
+INPUT_FILE=$(mktemp 2>/dev/null || echo "/tmp/openclaw-session-start-hook-$$.json")
+cat > "$INPUT_FILE"
+
+blog "Hook input received ($(wc -c < "$INPUT_FILE") bytes)"
+
+RESULT=$(babysitter hook:run \
+  --hook-type session-start \
+  --harness openclaw \
+  --plugin-root "${OPENCLAW_PLUGIN_ROOT}" \
+  --state-dir "${BABYSITTER_STATE_DIR}" \
+  < "$INPUT_FILE" 2>"$LOG_DIR/babysitter-session-start-hook-stderr.log")
+EXIT_CODE=$?
+
+blog "CLI exit code=$EXIT_CODE"
+
+rm -f "$INPUT_FILE" 2>/dev/null
+printf '%s\n' "$RESULT"
+exit $EXIT_CODE

package/hooks/babysitter-stop-hook.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+STATE_DIR="${BABYSITTER_STATE_DIR:-${PWD}/.a5c}"
+LOG_DIR="${BABYSITTER_LOG_DIR:-$HOME/.a5c/logs}"
+LOG_FILE="$LOG_DIR/babysitter-stop-hook.log"
+
+export OPENCLAW_PLUGIN_ROOT="${OPENCLAW_PLUGIN_ROOT:-${PLUGIN_ROOT}}"
+export BABYSITTER_STATE_DIR="${STATE_DIR}"
+
+mkdir -p "$LOG_DIR" 2>/dev/null
+
+blog() {
+  local msg="$1"
+  local ts
+  ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  echo "[INFO] $ts $msg" >> "$LOG_FILE" 2>/dev/null
+  babysitter log --type hook --label "hook:stop" --message "$msg" --source shell-hook 2>/dev/null || true
+}
+
+blog "Hook script invoked"
+blog "PLUGIN_ROOT=$PLUGIN_ROOT"
+blog "STATE_DIR=$STATE_DIR"
+
+INPUT_FILE=$(mktemp 2>/dev/null || echo "/tmp/openclaw-stop-hook-$$.json")
+cat > "$INPUT_FILE"
+
+blog "Hook input received ($(wc -c < "$INPUT_FILE") bytes)"
+
+RESULT=$(babysitter hook:run \
+  --hook-type stop \
+  --harness openclaw \
+  --plugin-root "${OPENCLAW_PLUGIN_ROOT}" \
+  --state-dir "${BABYSITTER_STATE_DIR}" \
+  < "$INPUT_FILE" 2>"$LOG_DIR/babysitter-stop-hook-stderr.log")
+EXIT_CODE=$?
+
+blog "CLI exit code=$EXIT_CODE"
+
+rm -f "$INPUT_FILE" 2>/dev/null
+printf '%s\n' "$RESULT"
+exit $EXIT_CODE

package/hooks.json

@@ -0,0 +1,26 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./hooks/babysitter-session-start.sh"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "./hooks/babysitter-stop-hook.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/openclaw.plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "babysitter",
+  "version": "0.1.0",
+  "description": "Babysitter orchestration plugin for OpenClaw — event-sourced workflows, multi-step process management, and human-in-the-loop approval",
+  "entrypoint": "extensions/index.ts",
+  "hooks": {
+    "session_start": "extensions/hooks/session-start.ts",
+    "session_end": "extensions/hooks/session-end.ts",
+    "before_prompt_build": "extensions/hooks/before-prompt-build.ts",
+    "agent_end": "extensions/hooks/agent-end.ts"
+  },
+  "capabilities": [
+    "orchestration",
+    "process-management",
+    "human-in-the-loop"
+  ]
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@a5c-ai/babysitter-openclaw",
+  "version": "0.1.1-staging.45beae68",
+  "type": "module",
+  "description": "Babysitter plugin for OpenClaw AI agent with programmatic hook integration, orchestration skills, and SDK-managed process-library bootstrapping",
+  "openclaw": {
+    "extensions": [
+      "./extensions"
+    ],
+    "compat": {
+      "minVersion": "0.1.0"
+    },
+    "build": {
+      "hooks": "extensions/index.ts"
+    }
+  },
+  "keywords": [
+    "babysitter",
+    "openclaw",
+    "orchestration",
+    "ai-agent",
+    "sdk-integration"
+  ],
+  "dependencies": {
+    "@a5c-ai/babysitter-sdk": "0.0.187-staging.45beae68"
+  },
+  "peerDependencies": {
+    "openclaw": "*"
+  },
+  "scripts": {
+    "postinstall": "node bin/install.cjs --global",
+    "preuninstall": "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"
+  },
+  "bin": {
+    "babysitter-openclaw": "bin/cli.cjs"
+  },
+  "files": [
+    "bin/",
+    "package.json",
+    "versions.json",
+    "plugin.json",
+    "openclaw.plugin.json",
+    "hooks/",
+    "hooks.json",
+    "extensions/",
+    "skills/",
+    "commands/",
+    "scripts/",
+    "README.md"
+  ],
+  "author": "a5c.ai",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/a5c-ai/babysitter"
+  },
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-openclaw#readme"
+}

package/plugin.json

@@ -0,0 +1,25 @@
+{
+  "name": "babysitter",
+  "version": "4.0.156",
+  "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",
+  "hooks": "hooks.json",
+  "commands": "commands/",
+  "skills": "skills/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/a5c-ai/babysitter"
+  },
+  "keywords": [
+    "orchestration",
+    "workflow",
+    "automation",
+    "event-sourced",
+    "hooks",
+    "TDD",
+    "quality-convergence",
+    "agent",
+    "LLM"
+  ]
+}

package/scripts/setup.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# setup.sh — Full setup script for babysitter-openclaw plugin
+#
+# Installs npm dependencies, verifies the babysitter SDK,
+# creates necessary directories, and prints usage instructions.
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+log()   { echo -e "${GREEN}[babysitter]${NC} $1"; }
+warn()  { echo -e "${YELLOW}[babysitter] WARNING:${NC} $1"; }
+error() { echo -e "${RED}[babysitter] ERROR:${NC} $1"; }
+
+# ── Check Node.js ──────────────────────────────────────────────────────
+log "Checking Node.js version..."
+if ! command -v node &>/dev/null; then
+  error "Node.js is not installed. Please install Node.js >= 18."
+  exit 1
+fi
+
+NODE_MAJOR=$(node -e "console.log(process.versions.node.split('.')[0])")
+if [ "$NODE_MAJOR" -lt 18 ]; then
+  error "Node.js v$(node -v) detected. babysitter-openclaw requires Node.js >= 18."
+  exit 1
+fi
+log "Node.js v$(node -v | tr -d 'v') — OK"
+
+# ── Check OpenClaw ────────────────────────────────────────────────────
+log "Checking for OpenClaw..."
+if command -v openclaw &>/dev/null; then
+  OPENCLAW_VERSION=$(openclaw --version 2>/dev/null || echo "unknown")
+  log "OpenClaw ${OPENCLAW_VERSION} — OK"
+else
+  warn "OpenClaw CLI not found in PATH. Install it or ensure it is on your PATH."
+fi
+
+# ── Install npm dependencies ──────────────────────────────────────────
+log "Installing npm dependencies..."
+cd "$PLUGIN_DIR"
+if [ -f "package.json" ]; then
+  npm install --no-audit --no-fund 2>&1 || {
+    warn "npm install encountered issues, but continuing setup."
+  }
+  log "Dependencies installed."
+else
+  warn "No package.json found in $PLUGIN_DIR — skipping npm install."
+fi
+
+# ── Verify babysitter SDK ─────────────────────────────────────────────
+log "Checking for @a5c-ai/babysitter-sdk..."
+SDK_CHECK=$(node -e "try { require('@a5c-ai/babysitter-sdk'); console.log('ok'); } catch(e) { console.log('missing'); }" 2>/dev/null)
+if [ "$SDK_CHECK" = "ok" ]; then
+  log "@a5c-ai/babysitter-sdk — OK"
+else
+  warn "@a5c-ai/babysitter-sdk not found. Install it with: npm install @a5c-ai/babysitter-sdk"
+fi
+
+# ── Ensure hook scripts are executable ───────────────────────────────
+log "Setting hook script permissions..."
+if [ -d "$PLUGIN_DIR/hooks" ]; then
+  chmod +x "$PLUGIN_DIR/hooks/"*.sh 2>/dev/null || true
+  log "Hook scripts are executable."
+fi
+
+# ── Create state directory ───────────────────────────────────────────
+log "Creating state directory..."
+STATE_DIR="${BABYSITTER_GLOBAL_STATE_DIR:-$HOME/.a5c}"
+mkdir -p "$STATE_DIR"
+log "State directory ready: $STATE_DIR"
+
+# ── Print usage instructions ─────────────────────────────────────────
+echo ""
+echo "============================================"
+echo "  babysitter-openclaw plugin setup complete"
+echo "============================================"
+echo ""
+echo "Install methods:"
+echo ""
+echo "  PRIMARY (marketplace):"
+echo "    babysitter plugin:install babysitter"
+echo ""
+echo "  SECONDARY (npm, for development):"
+echo "    npm install -g @a5c-ai/babysitter-openclaw"
+echo "    babysitter-openclaw install --global"
+echo ""
+echo "  PROJECT-LOCAL:"
+echo "    babysitter-openclaw install --workspace ."
+echo ""
+echo "For more information, see: $PLUGIN_DIR/README.md"
+echo ""
+
+log "Done."

package/scripts/sync-command-docs.cjs

@@ -0,0 +1,106 @@
+'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')}")
+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();