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

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/versions.json

@@ -1,4 +1,4 @@
 {
-  "sdkVersion": "5.0.1-staging.e4f17eff",
+  "sdkVersion": "5.0.1-staging.fcac7259",
   "pluginVersion": "0.1.0"
 }

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();

package/hooks/session-idle.js

@@ -1,124 +0,0 @@
-#!/usr/bin/env node
-/**
- * Babysitter Session Idle Hook for OpenCode
- *
- * 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` (which handles the
- * run-state inspection and iteration tracking).
- *
- * 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 } = 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");
-
-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 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 {
-    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 (err) {
-      blog(`Hook execution failed: ${err.message}`);
-      return "{}";
-    }
-  }
-}
-
-function main() {
-  blog("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 hookInput = JSON.stringify({
-    session_id: sessionId,
-    cwd: process.cwd(),
-    harness: "opencode",
-    plugin_root: PLUGIN_ROOT,
-  });
-
-  blog(`Checking run status for session ${sessionId}`);
-
-  // Delegate to the stop hook handler, which inspects run state
-  // and returns block/allow decisions
-  const result = runBabysitterHook("stop", hookInput);
-
-  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/shell-env.js

@@ -1,88 +0,0 @@
-#!/usr/bin/env node
-/**
- * Babysitter Shell Environment Hook for OpenCode
- *
- * Fires when OpenCode initializes a shell environment. Injects babysitter
- * environment variables (BABYSITTER_SESSION_ID, BABYSITTER_STATE_DIR, etc.)
- * so that subprocesses and other hooks can discover the active session.
- *
- * This is critical for OpenCode because it does NOT natively inject
- * distinctive env vars into plugins -- the babysitter plugin must self-inject
- * them via this hook.
- *
- * OpenCode plugin protocol:
- *   - Outputs env var assignments as JSON: { "env": { "KEY": "VALUE" } }
- *   - Exit 0 = success
- */
-
-"use strict";
-
-const { readFileSync, mkdirSync, appendFileSync, existsSync } = 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 RUNS_DIR = process.env.BABYSITTER_RUNS_DIR || path.join(GLOBAL_ROOT, "runs");
-const LOG_DIR = process.env.BABYSITTER_LOG_DIR || path.join(GLOBAL_ROOT, "logs");
-const LOG_FILE = path.join(LOG_DIR, "babysitter-shell-env-hook.log");
-
-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 main() {
-  blog("shell-env hook invoked");
-
-  // Resolve or generate session ID
-  const sessionId = process.env.BABYSITTER_SESSION_ID
-    || process.env.OPENCODE_SESSION_ID
-    || crypto.randomUUID();
-
-  const sdkVersion = getSdkVersion();
-
-  // Build env vars to inject
-  const env = {
-    BABYSITTER_SESSION_ID: sessionId,
-    OPENCODE_SESSION_ID: sessionId,
-    BABYSITTER_STATE_DIR: STATE_DIR,
-    BABYSITTER_RUNS_DIR: RUNS_DIR,
-    OPENCODE_PLUGIN_ROOT: PLUGIN_ROOT,
-  };
-
-  // Add SDK version for downstream hooks
-  if (sdkVersion && sdkVersion !== "latest") {
-    env.BABYSITTER_SDK_VERSION = sdkVersion;
-  }
-
-  // Add global state dir if defined
-  const globalStateDir = process.env.BABYSITTER_GLOBAL_STATE_DIR;
-  if (globalStateDir) {
-    env.BABYSITTER_GLOBAL_STATE_DIR = globalStateDir;
-  }
-
-  blog(`Injecting env: ${JSON.stringify(env)}`);
-
-  process.stdout.write(JSON.stringify({ env }) + "\n");
-}
-
-main();