@a5c-ai/babysitter-opencode 5.0.1-staging.e4f17eff → 5.0.1-staging.e920fef118ef

package/skills/retrospect/SKILL.md

@@ -5,52 +5,52 @@ description: Analysis for a run and its results, process, suggestions for proces
 
 # retrospect
 
-Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
-
-create and run a retrospect process:
-
-### Run Selection
-
-- `--all` or "all runs": list all completed/failed runs and analyze collectively
-- Multiple run IDs: analyze each specified run
-- Single run ID or no ID: existing behavior (latest run)
-- In interactive mode with no run specified: ask user whether to analyze latest, select specific runs, or all runs
-
-### Cross-Run Analysis (multi-run mode)
-
-When analyzing multiple runs, the retrospect process should additionally cover:
-- Common failure patterns across runs
-- Velocity trends (tasks/time across runs)
-- Process evolution (how processes changed)
-- Repeated breakpoint patterns
-- Aggregate quality metrics
-
-implementations notes (for the process):
-- The process should analyze the run, the process that was followed, and provide suggestions for improvements, optimizations, and fixes.
-- The process should such have many breakpoints where the user can steer the process, provide feedback, and make decisions about how to proceed with the retrospect.
-- The process should be designed to be flexible and adaptable to different types of runs, projects, and goals, and should be able to provide insights and suggestions that are relevant and actionable for the user. (modification to the process, skills, etc.)
-- The process should be designed to be iterative, allowing the user to go through multiple rounds of analysis and improvement, and should be able to track the changes and improvements made over time.
-- The process should cover:
-    - Analysis of the run and its results, including what went well, what didn't go well, and what could be improved.
-    - Analysis of the process that was followed, including what steps were taken, what tools were used, and how effective they were.
-    - Suggestions for improvements, optimizations, and fixes for both the run and the process.
-    - Implementing the improvements, optimizations, and fixes, and tracking the changes made over time.
-### Cleanup Suggestion
-
-After retrospect analysis, suggest running `/babysitter:cleanup` to clean up old run data and reclaim disk space.
-
-    - Ending by explicitly prompting the user to contribute back -- even just reporting an issue is valuable, they don't need to implement the fix themselves. After analysis, display a clear call-to-action:
-
-      "You've identified [specific insight/improvement]. This could help other babysitter users too. Run `/babysitter:contrib` to share it upstream -- you can either report it as an issue or submit a PR with the fix."
-
-      Route to the specific contrib workflow based on what the user wants to do:
-
-      **Just reporting (no code changes needed):**
-      - Found a bug or weakness in a process -> `/babysitter:contrib bug report: [description of what went wrong]`
-      - Found missing or confusing documentation -> `/babysitter:contrib documentation question: [what was unclear]`
-      - Have an idea for improvement but don't want to implement it -> `/babysitter:contrib feature request: [description]`
-
-      **Contributing code changes:**
-      - Process/skill/agent improvements -> `/babysitter:contrib library contribution: [description]`
-      - Bug fixes in SDK or CLI -> `/babysitter:contrib bugfix: [description]`
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
+
+create and run a retrospect process:
+
+### Run Selection
+
+- `--all` or "all runs": list all completed/failed runs and analyze collectively
+- Multiple run IDs: analyze each specified run
+- Single run ID or no ID: existing behavior (latest run)
+- In interactive mode with no run specified: ask user whether to analyze latest, select specific runs, or all runs
+
+### Cross-Run Analysis (multi-run mode)
+
+When analyzing multiple runs, the retrospect process should additionally cover:
+- Common failure patterns across runs
+- Velocity trends (tasks/time across runs)
+- Process evolution (how processes changed)
+- Repeated breakpoint patterns
+- Aggregate quality metrics
+
+implementations notes (for the process):
+- The process should analyze the run, the process that was followed, and provide suggestions for improvements, optimizations, and fixes.
+- The process should such have many breakpoints where the user can steer the process, provide feedback, and make decisions about how to proceed with the retrospect.
+- The process should be designed to be flexible and adaptable to different types of runs, projects, and goals, and should be able to provide insights and suggestions that are relevant and actionable for the user. (modification to the process, skills, etc.)
+- The process should be designed to be iterative, allowing the user to go through multiple rounds of analysis and improvement, and should be able to track the changes and improvements made over time.
+- The process should cover:
+    - Analysis of the run and its results, including what went well, what didn't go well, and what could be improved.
+    - Analysis of the process that was followed, including what steps were taken, what tools were used, and how effective they were.
+    - Suggestions for improvements, optimizations, and fixes for both the run and the process.
+    - Implementing the improvements, optimizations, and fixes, and tracking the changes made over time.
+### Cleanup Suggestion
+
+After retrospect analysis, suggest running `/babysitter:cleanup` to clean up old run data and reclaim disk space.
+
+    - Ending by explicitly prompting the user to contribute back -- even just reporting an issue is valuable, they don't need to implement the fix themselves. After analysis, display a clear call-to-action:
+
+      "You've identified [specific insight/improvement]. This could help other babysitter users too. Run `/babysitter:contrib` to share it upstream -- you can either report it as an issue or submit a PR with the fix."
+
+      Route to the specific contrib workflow based on what the user wants to do:
+
+      **Just reporting (no code changes needed):**
+      - Found a bug or weakness in a process -> `/babysitter:contrib bug report: [description of what went wrong]`
+      - Found missing or confusing documentation -> `/babysitter:contrib documentation question: [what was unclear]`
+      - Have an idea for improvement but don't want to implement it -> `/babysitter:contrib feature request: [description]`
+
+      **Contributing code changes:**
+      - Process/skill/agent improvements -> `/babysitter:contrib library contribution: [description]`
+      - Bug fixes in SDK or CLI -> `/babysitter:contrib bugfix: [description]`
       - Plugin instruction improvements -> `/babysitter:contrib library contribution: improved [plugin-name] [install|configure|uninstall] instructions`

package/skills/user-install/SKILL.md

@@ -5,8 +5,8 @@ description: Set up babysitter for yourself. Guides you through onboarding — i
 
 # user-install
 
-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).
+
 Before using the process library, resolve the active library root through the SDK CLI. If no binding exists yet, initialize the shared global SDK binding with:
 
 ```bash
@@ -14,5 +14,5 @@ babysitter process-library:active --json
 ```
 
 Then use the `cradle/user-install` process from the active process library.
-
+
 When the run completes, end with a friendly message that includes a polite and humorous ask to star the repo on GitHub: https://github.com/a5c-ai/babysitter

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-agent yolo --harness claude-code --workspace "$PWD" --prompt "<user arguments>" --json`; in Codex, run `babysitter-agent 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.e4f17eff",
-  "pluginVersion": "0.1.0"
+  "sdkVersion": "5.0.1-staging.e920fef118ef",
+  "extensionVersion": "5.0.1-staging.e920fef118ef"
 }

package/hooks/babysitter-proxied-session-idle.js

@@ -1,173 +0,0 @@
-#!/usr/bin/env node
-/**
- * Unified Session Idle Hook for OpenCode
- * Routes through hooks-proxy for all hook execution.
- *
- * Fires when the OpenCode agent goes idle. Checks if the current babysitter
- * run has pending effects that need attention. Since OpenCode does NOT have a
- * blocking stop hook, this is fire-and-forget -- it outputs context about
- * pending effects so the agent can decide whether to continue iterating.
- *
- * Delegates to `babysitter hook:run --hook-type stop` via hooks-proxy.
- *
- * OpenCode plugin protocol:
- *   - Receives event context as JSON via stdin
- *   - Outputs JSON to stdout
- *   - 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-session-idle-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 runViaProxy(proxy, hookType, inputJson) {
-  const handler = `babysitter hook:run --harness unified --hook-type ${hookType} --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
-  const result = execSync(`"${proxy}" invoke --adapter opencode --handler "${handler}" --json`, {
-    input: inputJson,
-    stdio: ["pipe", "pipe", "pipe"],
-    timeout: 30000,
-    env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-  });
-  return result.toString("utf8").trim();
-}
-
-function runViaNpxProxy(version, hookType, inputJson) {
-  const handler = `babysitter hook:run --harness unified --hook-type ${hookType} --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
-  const result = execSync(`npx -y "@a5c-ai/hooks-proxy-cli@${version}" invoke --adapter opencode --handler "${handler}" --json`, {
-    input: inputJson,
-    stdio: ["pipe", "pipe", "pipe"],
-    timeout: 60000,
-    env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-  });
-  return result.toString("utf8").trim();
-}
-
-function main() {
-  blog("Unified session-idle hook invoked");
-
-  const sessionId = process.env.BABYSITTER_SESSION_ID
-    || process.env.OPENCODE_SESSION_ID
-    || "";
-
-  if (!sessionId) {
-    blog("No session ID -- nothing to check");
-    process.stdout.write("{}\n");
-    return;
-  }
-
-  const sdkVersion = getSdkVersion();
-
-  // Ensure hooks-proxy is installed
-  let proxy = resolveHooksProxy();
-  if (!proxy) {
-    installHooksProxy(sdkVersion);
-    proxy = resolveHooksProxy();
-  }
-
-  const hookInput = JSON.stringify({
-    session_id: sessionId,
-    cwd: process.cwd(),
-    harness: "opencode",
-    plugin_root: PLUGIN_ROOT,
-  });
-
-  blog(`Checking run status for session ${sessionId}`);
-
-  let result;
-  try {
-    if (proxy) {
-      blog(`Using hooks-proxy: ${proxy}`);
-      result = runViaProxy(proxy, "stop", hookInput);
-    } else {
-      blog("hooks-proxy not found after install, using npx fallback");
-      result = runViaNpxProxy(sdkVersion, "stop", hookInput);
-    }
-  } catch (err) {
-    blog(`Hook execution failed: ${err.message}`);
-    result = "{}";
-  }
-
-  blog(`Hook result: ${result}`);
-
-  try {
-    const parsed = JSON.parse(result);
-    process.stdout.write(JSON.stringify(parsed) + "\n");
-  } catch {
-    process.stdout.write("{}\n");
-  }
-}
-
-main();

package/hooks/hooks.json.legacy

@@ -1,46 +0,0 @@
-{
-  "version": 1,
-  "description": "Babysitter hook registration for OpenCode. Maps OpenCode plugin events to babysitter hook scripts.",
-  "hooks": {
-    "session.created": [
-      {
-        "type": "command",
-        "script": "hooks/session-created.js",
-        "description": "Initialize babysitter session state and inject context",
-        "timeoutMs": 30000
-      }
-    ],
-    "session.idle": [
-      {
-        "type": "command",
-        "script": "hooks/session-idle.js",
-        "description": "Check for pending babysitter effects when agent goes idle",
-        "timeoutMs": 30000
-      }
-    ],
-    "shell.env": [
-      {
-        "type": "command",
-        "script": "hooks/shell-env.js",
-        "description": "Inject BABYSITTER_SESSION_ID and other env vars into shell",
-        "timeoutMs": 5000
-      }
-    ],
-    "tool.execute.before": [
-      {
-        "type": "command",
-        "script": "hooks/tool-execute-before.js",
-        "description": "Pre-tool-use hook for babysitter awareness",
-        "timeoutMs": 10000
-      }
-    ],
-    "tool.execute.after": [
-      {
-        "type": "command",
-        "script": "hooks/tool-execute-after.js",
-        "description": "Post-tool-use hook for babysitter awareness",
-        "timeoutMs": 10000
-      }
-    ]
-  }
-}

package/hooks/proxied-hooks.json

@@ -1,47 +0,0 @@
-{
-  "_comment": "NOT ACTIVE — Alternative hooks.json using per-hook unified scripts with hooks-proxy support. To activate, replace hooks.json with this file.",
-  "version": 1,
-  "description": "Babysitter hook registration for OpenCode. Maps OpenCode plugin events to unified babysitter hook scripts with hooks-proxy support.",
-  "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)",
-        "timeoutMs": 30000
-      }
-    ],
-    "session.idle": [
-      {
-        "type": "command",
-        "script": "hooks/babysitter-proxied-session-idle.js",
-        "description": "Check for pending babysitter effects when agent goes idle (proxied via a5c-hooks-proxy)",
-        "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": [
-      {
-        "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
-      }
-    ],
-    "tool.execute.after": [
-      {
-        "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
-      }
-    ]
-  }
-}

package/hooks/session-created.js

@@ -1,182 +0,0 @@
-#!/usr/bin/env node
-/**
- * Babysitter Session Created Hook for OpenCode
- *
- * Fires when an OpenCode session is created. Ensures the babysitter SDK CLI
- * is installed, then delegates to `babysitter hook:run --hook-type session-start`
- * to create baseline session state.
- *
- * OpenCode plugin protocol:
- *   - Receives event context as JSON via process.argv or stdin
- *   - Outputs JSON to stdout
- *   - Exit 0 = success
- */
-
-"use strict";
-
-const { execSync, execFileSync } = require("child_process");
-const { readFileSync, mkdirSync, appendFileSync, existsSync, writeFileSync } = require("fs");
-const os = require("os");
-const path = require("path");
-const crypto = require("crypto");
-
-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-session-created-hook.log");
-
-// ---------------------------------------------------------------------------
-// Logging
-// ---------------------------------------------------------------------------
-
-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 */ }
-}
-
-// ---------------------------------------------------------------------------
-// SDK version & install
-// ---------------------------------------------------------------------------
-
-function getSdkVersion() {
-  try {
-    const versions = JSON.parse(readFileSync(path.join(PLUGIN_ROOT, "versions.json"), "utf8"));
-    return versions.sdkVersion || "latest";
-  } catch {
-    return "latest";
-  }
-}
-
-function hasBabysitterCli() {
-  try {
-    execSync("babysitter --version", { stdio: "pipe", timeout: 10000 });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function installSdk(version) {
-  const marker = path.join(PLUGIN_ROOT, ".babysitter-install-attempted");
-  if (existsSync(marker)) return;
-
-  try {
-    execSync(`npm i -g "@a5c-ai/babysitter-sdk@${version}" --loglevel=error`, {
-      stdio: "pipe",
-      timeout: 120000,
-    });
-    blog(`Installed SDK globally (${version})`);
-  } catch {
-    // Try user-local prefix
-    try {
-      const prefix = path.join(process.env.HOME || process.env.USERPROFILE || "~", ".local");
-      execSync(`npm i -g "@a5c-ai/babysitter-sdk@${version}" --prefix "${prefix}" --loglevel=error`, {
-        stdio: "pipe",
-        timeout: 120000,
-      });
-      blog(`Installed SDK to user prefix (${version})`);
-    } catch {
-      blog("SDK installation failed");
-    }
-  }
-
-  try { writeFileSync(marker, version); } catch { /* best-effort */ }
-}
-
-// ---------------------------------------------------------------------------
-// CLI execution helper
-// ---------------------------------------------------------------------------
-
-function runBabysitterHook(hookType, inputJson) {
-  const sdkVersion = getSdkVersion();
-  const args = [
-    "hook:run",
-    "--hook-type", hookType,
-    "--harness", "opencode",
-    "--plugin-root", PLUGIN_ROOT,
-    "--state-dir", STATE_DIR,
-    "--json",
-  ];
-
-  try {
-    const result = execSync(`babysitter ${args.join(" ")}`, {
-      input: inputJson,
-      stdio: ["pipe", "pipe", "pipe"],
-      timeout: 30000,
-      env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-    });
-    return result.toString("utf8").trim();
-  } catch (err) {
-    // Fall back to npx
-    try {
-      const result = execSync(`npx -y "@a5c-ai/babysitter-sdk@${sdkVersion}" ${args.join(" ")}`, {
-        input: inputJson,
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 60000,
-        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-      });
-      return result.toString("utf8").trim();
-    } catch (npxErr) {
-      blog(`Hook execution failed: ${npxErr.message}`);
-      return "{}";
-    }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-
-function main() {
-  blog("session-created hook invoked");
-  blog(`PLUGIN_ROOT=${PLUGIN_ROOT}`);
-
-  // Generate a session ID if OpenCode doesn't provide one
-  const sessionId = process.env.OPENCODE_SESSION_ID
-    || process.env.BABYSITTER_SESSION_ID
-    || crypto.randomUUID();
-
-  // Set env var so downstream hooks can pick it up
-  process.env.BABYSITTER_SESSION_ID = sessionId;
-
-  const sdkVersion = getSdkVersion();
-
-  // Ensure SDK is installed
-  if (!hasBabysitterCli()) {
-    blog("SDK CLI not found, attempting install");
-    installSdk(sdkVersion);
-  }
-
-  // Build hook input
-  const hookInput = JSON.stringify({
-    session_id: sessionId,
-    cwd: process.cwd(),
-    harness: "opencode",
-    plugin_root: PLUGIN_ROOT,
-  });
-
-  blog(`Hook input: ${hookInput}`);
-
-  // Delegate to SDK hook handler
-  const result = runBabysitterHook("session-start", hookInput);
-
-  blog(`Hook result: ${result}`);
-
-  // Output result
-  try {
-    const parsed = JSON.parse(result);
-    process.stdout.write(JSON.stringify(parsed) + "\n");
-  } catch {
-    process.stdout.write("{}\n");
-  }
-}
-
-main();