@a5c-ai/babysitter-opencode 0.1.1-staging.0dc03363

package/README.md

@@ -0,0 +1,169 @@
+# @a5c-ai/babysitter-opencode
+
+Babysitter integration package for [OpenCode](https://opencode.ai).
+
+This package ships an OpenCode plugin bundle that provides event-sourced
+orchestration, hook-based extensibility, and human-in-the-loop approval for
+complex multi-step workflows -- powered by the Babysitter SDK.
+
+## Plugin Structure
+
+```
+plugins/babysitter-opencode/
+  bin/
+    cli.cjs              CLI entry point (babysitter-opencode command)
+    install.cjs          Installation script
+    install-shared.cjs   Shared installation utilities
+    uninstall.cjs        Uninstallation script
+  commands/              Slash command definitions (.md files)
+  hooks/
+    hooks.json           Hook registration manifest
+    session-created.js   Initialize babysitter session state
+    session-idle.js      Check for pending effects when idle
+    shell-env.js         Inject env vars into shell
+    tool-execute-before.js  Pre-tool-use hook
+    tool-execute-after.js   Post-tool-use hook
+  skills/
+    babysit/SKILL.md     Core orchestration skill
+  plugin.json            Plugin manifest
+  versions.json          SDK version tracking
+```
+
+## Installation
+
+### Prerequisites
+
+Install the Babysitter SDK CLI:
+
+```bash
+npm install -g @a5c-ai/babysitter
+```
+
+### Method 1: npm global install (recommended)
+
+```bash
+npm install -g @a5c-ai/babysitter-opencode
+```
+
+The `postinstall` script automatically copies the plugin into your current
+workspace's `.opencode/plugins/babysitter/` directory.
+
+To install into a specific workspace:
+
+```bash
+babysitter-opencode install --workspace /path/to/project
+```
+
+### Method 2: Babysitter plugin manager
+
+```bash
+babysitter plugin:install babysitter-opencode
+```
+
+### Method 3: Manual copy
+
+```bash
+mkdir -p .opencode/plugins/babysitter
+cp -r node_modules/@a5c-ai/babysitter-opencode/hooks .opencode/plugins/babysitter/
+cp -r node_modules/@a5c-ai/babysitter-opencode/skills .opencode/plugins/babysitter/
+cp -r node_modules/@a5c-ai/babysitter-opencode/commands .opencode/plugins/babysitter/
+cp node_modules/@a5c-ai/babysitter-opencode/plugin.json .opencode/plugins/babysitter/
+cp node_modules/@a5c-ai/babysitter-opencode/versions.json .opencode/plugins/babysitter/
+```
+
+## Uninstallation
+
+```bash
+babysitter-opencode uninstall
+```
+
+Or from a specific workspace:
+
+```bash
+babysitter-opencode uninstall --workspace /path/to/project
+```
+
+## CLI Reference
+
+```
+babysitter-opencode install [--global]            Install plugin globally
+babysitter-opencode install --workspace [path]    Install into workspace
+babysitter-opencode uninstall [--global]          Uninstall plugin globally
+babysitter-opencode uninstall --workspace [path]  Uninstall from workspace
+babysitter-opencode sync                          Sync command surfaces
+babysitter-opencode doctor                        Check installation health
+babysitter-opencode version                       Show version
+babysitter-opencode help                          Show help
+```
+
+## Integration Model
+
+OpenCode plugins are JS/TS modules placed in `.opencode/plugins/`. The babysitter
+plugin registers hooks for the following OpenCode events:
+
+| OpenCode Event | Babysitter Hook | Purpose |
+|----------------|-----------------|---------|
+| `session.created` | `session-start` | Initialize session state |
+| `session.idle` | `stop` | Check for pending effects |
+| `shell.env` | -- | Inject env vars (BABYSITTER_SESSION_ID) |
+| `tool.execute.before` | `pre-tool-use` | Pre-tool-use awareness |
+| `tool.execute.after` | `post-tool-use` | Post-tool-use awareness |
+
+### Loop Model
+
+OpenCode does NOT have a blocking stop hook. The `session.idle` event is
+fire-and-forget. Therefore, babysitter uses an **in-turn iteration** model:
+the agent runs the full orchestration loop within a single turn by calling
+`babysitter run:iterate` repeatedly until completion.
+
+### Environment Variables
+
+The `shell.env` hook self-injects these variables since OpenCode does not
+natively provide them:
+
+- `BABYSITTER_SESSION_ID` -- Unique session identifier
+- `OPENCODE_SESSION_ID` -- Alias for session ID
+- `BABYSITTER_STATE_DIR` -- State directory path
+- `BABYSITTER_RUNS_DIR` -- Runs directory path
+- `OPENCODE_PLUGIN_ROOT` -- Plugin root directory
+
+### Configuration Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `OPENCODE_HOME` | `.opencode/` in workspace | OpenCode config root |
+| `OPENCODE_WORKSPACE` | `cwd` | Workspace directory |
+| `BABYSITTER_OPENCODE_PLUGIN_DIR` | `.opencode/plugins/` | Plugin install target |
+| `BABYSITTER_OPENCODE_MARKETPLACE_PATH` | `~/.agents/plugins/marketplace.json` | Marketplace file |
+| `BABYSITTER_SDK_CLI` | (auto-detected) | Path to SDK CLI entry |
+| `BABYSITTER_GLOBAL_STATE_DIR` | `~/.a5c` | Global state directory |
+
+## Verification
+
+```bash
+# Check installation health
+babysitter-opencode doctor
+
+# Or verify manually:
+test -f .opencode/plugins/babysitter/index.js
+test -f .opencode/plugins/babysitter/hooks/session-created.js
+test -f .opencode/plugins/babysitter/hooks/shell-env.js
+test -f .opencode/plugins/babysitter/skills/babysit/SKILL.md
+
+# Verify SDK CLI
+babysitter --version
+
+# Verify process library binding
+babysitter process-library:active --json
+```
+
+## Running Tests
+
+```bash
+cd plugins/babysitter-opencode
+npm test
+```
+
+## License
+
+MIT

package/bin/cli.cjs

@@ -0,0 +1,194 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Babysitter OpenCode CLI shim.
+ *
+ * Provides `babysitter-opencode` command for plugin management tasks
+ * (install, uninstall, sync, doctor). Delegates heavy lifting to the
+ * SDK CLI with opencode-specific flags.
+ */
+
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+
+function printUsage() {
+  console.log([
+    'babysitter-opencode - Babysitter plugin for OpenCode',
+    '',
+    'Usage:',
+    '  babysitter-opencode install [--global]            Install plugin globally',
+    '  babysitter-opencode install --workspace [path]    Install into workspace',
+    '  babysitter-opencode uninstall [--global]          Uninstall plugin globally',
+    '  babysitter-opencode uninstall --workspace [path]  Uninstall from workspace',
+    '  babysitter-opencode sync                          Sync command surfaces',
+    '  babysitter-opencode doctor                        Check installation health',
+    '  babysitter-opencode version                       Show version',
+    '  babysitter-opencode help                          Show this help',
+  ].join('\n'));
+}
+
+function parseArgs(argv) {
+  let workspace = null;
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--workspace') {
+      const next = argv[i + 1];
+      workspace = next && !next.startsWith('-') ? path.resolve(next) : process.cwd();
+      if (next && !next.startsWith('-')) {
+        i += 1;
+      }
+      continue;
+    }
+    if (arg === '--global') {
+      workspace = null;
+      continue;
+    }
+    throw new Error(`unknown argument: ${arg}`);
+  }
+
+  return { workspace };
+}
+
+function runNodeScript(scriptPath, args) {
+  const result = spawnSync(process.execPath, [scriptPath, ...args], {
+    cwd: process.cwd(),
+    stdio: 'inherit',
+    env: process.env,
+  });
+  process.exitCode = result.status ?? 1;
+}
+
+function runDoctor(workspace) {
+  const fs = require('fs');
+  const { getOpenCodeHome, getHomePluginRoot } = require('./install-shared.cjs');
+
+  const ws = workspace || process.cwd();
+  const openCodeHome = getOpenCodeHome(ws);
+  const pluginRoot = getHomePluginRoot(ws);
+  let ok = true;
+
+  console.log('[babysitter] OpenCode plugin health check');
+  console.log(`  Workspace:   ${ws}`);
+  console.log(`  OpenCode:    ${openCodeHome}`);
+  console.log(`  Plugin root: ${pluginRoot}`);
+  console.log('');
+
+  // Check plugin directory
+  if (fs.existsSync(pluginRoot)) {
+    console.log('  [ok] Plugin directory exists');
+  } else {
+    console.log('  [FAIL] Plugin directory missing');
+    ok = false;
+  }
+
+  // Check index.js
+  const indexPath = path.join(pluginRoot, 'index.js');
+  if (fs.existsSync(indexPath)) {
+    console.log('  [ok] index.js entry point exists');
+  } else {
+    console.log('  [FAIL] index.js entry point missing');
+    ok = false;
+  }
+
+  // Check plugin.json
+  const pluginJsonPath = path.join(pluginRoot, 'plugin.json');
+  if (fs.existsSync(pluginJsonPath)) {
+    console.log('  [ok] plugin.json exists');
+  } else {
+    console.log('  [FAIL] plugin.json missing');
+    ok = false;
+  }
+
+  // Check hooks
+  const hooksDir = path.join(pluginRoot, 'hooks');
+  if (fs.existsSync(hooksDir)) {
+    const hooks = fs.readdirSync(hooksDir).filter((f) => f.endsWith('.js'));
+    console.log(`  [ok] hooks/ directory (${hooks.length} scripts)`);
+  } else {
+    console.log('  [FAIL] hooks/ directory missing');
+    ok = false;
+  }
+
+  // Check skills
+  const skillPath = path.join(pluginRoot, 'skills', 'babysit', 'SKILL.md');
+  if (fs.existsSync(skillPath)) {
+    console.log('  [ok] skills/babysit/SKILL.md exists');
+  } else {
+    console.log('  [WARN] skills/babysit/SKILL.md missing');
+  }
+
+  // Check babysitter CLI availability
+  const { spawnSync: spawn } = require('child_process');
+  const cliCheck = spawn('babysitter', ['--version'], {
+    stdio: ['ignore', 'pipe', 'pipe'],
+    encoding: 'utf8',
+  });
+  if (cliCheck.status === 0) {
+    console.log(`  [ok] babysitter CLI: ${(cliCheck.stdout || '').trim()}`);
+  } else {
+    console.log('  [WARN] babysitter CLI not found in PATH');
+  }
+
+  console.log('');
+  if (ok) {
+    console.log('  All checks passed.');
+  } else {
+    console.log('  Some checks failed. Run "babysitter-opencode install" to fix.');
+    process.exitCode = 1;
+  }
+}
+
+function main() {
+  const [command, ...rest] = process.argv.slice(2);
+  if (!command || command === '--help' || command === '-h' || command === 'help') {
+    printUsage();
+    process.exitCode = command ? 0 : 1;
+    return;
+  }
+
+  switch (command) {
+    case 'install':
+    case 'uninstall': {
+      const parsed = parseArgs(rest);
+      const args = parsed.workspace ? ['--workspace', parsed.workspace] : ['--global'];
+      runNodeScript(path.join(PACKAGE_ROOT, 'bin', `${command}.cjs`), args);
+      break;
+    }
+    case 'sync': {
+      const syncScript = path.join(PACKAGE_ROOT, 'scripts', 'sync-command-surfaces.js');
+      const fs = require('fs');
+      if (fs.existsSync(syncScript)) {
+        runNodeScript(syncScript, rest);
+      } else {
+        console.error('[babysitter] sync-command-surfaces.js not found');
+        process.exitCode = 1;
+      }
+      break;
+    }
+    case 'doctor': {
+      const parsed = parseArgs(rest);
+      runDoctor(parsed.workspace);
+      break;
+    }
+    case 'version': {
+      try {
+        const pkg = require(path.join(PACKAGE_ROOT, 'package.json'));
+        console.log(pkg.version);
+      } catch {
+        console.log('unknown');
+      }
+      break;
+    }
+    default:
+      console.error(`Unknown command: ${command}`);
+      printUsage();
+      process.exitCode = 1;
+      break;
+  }
+}
+
+main();

package/bin/cli.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+/**
+ * Babysitter OpenCode CLI shim.
+ *
+ * Provides `babysitter-opencode` command for plugin management tasks
+ * (install, uninstall, sync). Delegates heavy lifting to the SDK CLI.
+ */
+
+"use strict";
+
+const { execSync } = require("child_process");
+const path = require("path");
+
+const PLUGIN_ROOT = path.resolve(__dirname, "..");
+const args = process.argv.slice(2);
+const command = args[0] || "help";
+
+function run(cmd) {
+  try {
+    execSync(cmd, { stdio: "inherit", cwd: PLUGIN_ROOT });
+  } catch (err) {
+    process.exit(err.status || 1);
+  }
+}
+
+switch (command) {
+  case "install":
+    run(`node ${path.join(PLUGIN_ROOT, "bin", "install.js")}`);
+    break;
+  case "uninstall":
+    run(`node ${path.join(PLUGIN_ROOT, "bin", "uninstall.js")}`);
+    break;
+  case "sync":
+    run(`node ${path.join(PLUGIN_ROOT, "scripts", "sync-command-surfaces.js")}`);
+    break;
+  case "version":
+    try {
+      const pkg = require(path.join(PLUGIN_ROOT, "package.json"));
+      console.log(pkg.version);
+    } catch {
+      console.log("unknown");
+    }
+    break;
+  case "help":
+  default:
+    console.log(`babysitter-opencode - Babysitter plugin for OpenCode
+
+Usage:
+  babysitter-opencode install     Install plugin into OpenCode
+  babysitter-opencode uninstall   Remove plugin from OpenCode
+  babysitter-opencode sync        Sync command surfaces
+  babysitter-opencode version     Show version
+  babysitter-opencode help        Show this help`);
+    break;
+}