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

package/hooks/babysitter-proxied-tool-execute-after.js

@@ -1,164 +1,24 @@
 #!/usr/bin/env node
-/**
- * Unified Tool Execute After Hook for OpenCode
- * Routes through hooks-proxy for all hook execution.
- *
- * Fires after a tool execution in OpenCode. Delegates to
- * `babysitter hook:run --hook-type post-tool-use` via hooks-proxy.
- *
- * This hook can be used to:
- * - Log tool execution results for babysitter run observability
- * - Trigger babysitter effects based on tool outputs
- * - Update session state after tool executions
- *
- * OpenCode plugin protocol:
- *   - Receives tool result 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-tool-after-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 main() {
-  const sessionId = process.env.BABYSITTER_SESSION_ID
-    || process.env.OPENCODE_SESSION_ID
-    || "";
-
-  if (!sessionId) {
-    process.stdout.write("{}\n");
-    return;
-  }
-
-  // Read stdin for tool result context
-  let inputData = "";
-  try {
-    inputData = require("fs").readFileSync(0, "utf8");
-  } catch {
-    // No stdin available
-  }
-
-  blog(`Unified tool-execute-after: session=${sessionId}`);
-
-  const hookInput = JSON.stringify({
-    session_id: sessionId,
-    cwd: process.cwd(),
-    harness: "opencode",
-    plugin_root: PLUGIN_ROOT,
-    tool_result: inputData ? JSON.parse(inputData) : {},
+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 || "opencode",
+      PLUGIN_ROOT: PLUGIN_ROOT
+    })
   });
-
-  const sdkVersion = getSdkVersion();
-
-  // Ensure hooks-proxy is installed
-  let proxy = resolveHooksProxy();
-  if (!proxy) {
-    installHooksProxy(sdkVersion);
-    proxy = resolveHooksProxy();
-  }
-
-  const handler = `babysitter hook:run --harness unified --hook-type post-tool-use --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
-
-  try {
-    let result;
-    if (proxy) {
-      blog(`Using hooks-proxy: ${proxy}`);
-      result = execSync(`"${proxy}" invoke --adapter opencode --handler "${handler}" --json`, {
-        input: hookInput,
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 10000,
-        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-      });
-    } else {
-      blog("hooks-proxy not found after install, using npx fallback");
-      result = execSync(`npx -y "@a5c-ai/hooks-proxy-cli@${sdkVersion}" invoke --adapter opencode --handler "${handler}" --json`, {
-        input: hookInput,
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 30000,
-        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-      });
-    }
-    const output = result.toString("utf8").trim();
-    blog(`Hook result: ${output}`);
-    process.stdout.write((output || "{}") + "\n");
-  } catch (err) {
-    blog(`Post-tool-use hook failed: ${err.message} -- non-blocking`);
-    process.stdout.write("{}\n");
-  }
+  process.stdout.write(result);
+} catch (e) {
+  process.stdout.write("{}\n");
 }
-
-main();

package/hooks/babysitter-proxied-tool-execute-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-tool-execute-before.js

@@ -1,166 +1,24 @@
 #!/usr/bin/env node
-/**
- * Unified Tool Execute Before Hook for OpenCode
- * Routes through hooks-proxy for all hook execution.
- *
- * Fires before a tool execution in OpenCode. Delegates to
- * `babysitter hook:run --hook-type pre-tool-use` via hooks-proxy.
- *
- * This hook can be used to:
- * - Log tool invocations for babysitter run observability
- * - Block certain tool calls during specific orchestration phases
- * - Inject babysitter context into tool arguments
- *
- * OpenCode plugin protocol:
- *   - Receives tool context as JSON via stdin
- *   - Outputs JSON to stdout (empty = allow, { block: true } = block)
- *   - 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-tool-before-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 main() {
-  const sessionId = process.env.BABYSITTER_SESSION_ID
-    || process.env.OPENCODE_SESSION_ID
-    || "";
-
-  if (!sessionId) {
-    // No session -- pass through without intervention
-    process.stdout.write("{}\n");
-    return;
-  }
-
-  // Read stdin for tool context
-  let inputData = "";
-  try {
-    inputData = require("fs").readFileSync(0, "utf8");
-  } catch {
-    // No stdin available
-  }
-
-  blog(`Unified tool-execute-before: session=${sessionId}`);
-
-  const hookInput = JSON.stringify({
-    session_id: sessionId,
-    cwd: process.cwd(),
-    harness: "opencode",
-    plugin_root: PLUGIN_ROOT,
-    tool_context: inputData ? JSON.parse(inputData) : {},
+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 || "opencode",
+      PLUGIN_ROOT: PLUGIN_ROOT
+    })
   });
-
-  const sdkVersion = getSdkVersion();
-
-  // Ensure hooks-proxy is installed
-  let proxy = resolveHooksProxy();
-  if (!proxy) {
-    installHooksProxy(sdkVersion);
-    proxy = resolveHooksProxy();
-  }
-
-  const handler = `babysitter hook:run --harness unified --hook-type pre-tool-use --plugin-root ${PLUGIN_ROOT} --state-dir ${STATE_DIR} --json`;
-
-  try {
-    let result;
-    if (proxy) {
-      blog(`Using hooks-proxy: ${proxy}`);
-      result = execSync(`"${proxy}" invoke --adapter opencode --handler "${handler}" --json`, {
-        input: hookInput,
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 10000,
-        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-      });
-    } else {
-      blog("hooks-proxy not found after install, using npx fallback");
-      result = execSync(`npx -y "@a5c-ai/hooks-proxy-cli@${sdkVersion}" invoke --adapter opencode --handler "${handler}" --json`, {
-        input: hookInput,
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 30000,
-        env: { ...process.env, BABYSITTER_STATE_DIR: STATE_DIR },
-      });
-    }
-    const output = result.toString("utf8").trim();
-    blog(`Hook result: ${output}`);
-    process.stdout.write((output || "{}") + "\n");
-  } catch (err) {
-    // On failure, allow the tool execution to proceed
-    blog(`Pre-tool-use hook failed: ${err.message} -- allowing execution`);
-    process.stdout.write("{}\n");
-  }
+  process.stdout.write(result);
+} catch (e) {
+  process.stdout.write("{}\n");
 }
-
-main();

package/hooks/babysitter-proxied-tool-execute-before.sh

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

package/hooks/hooks.json

@@ -1,45 +1,45 @@
 {
   "version": 1,
-  "description": "Babysitter hook registration for OpenCode. Maps OpenCode plugin events to unified babysitter hook scripts with hooks-proxy support.",
+  "description": "babysitter hook registration for OpenCode.",
   "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)",
+        "script": "./hooks/babysitter-proxied-session-created.js",
+        "description": "babysitter SessionStart hook",
         "timeoutMs": 30000
       }
     ],
-    "session.idle": [
+    "tool.execute.before": [
       {
         "type": "command",
-        "script": "hooks/babysitter-proxied-session-idle.js",
-        "description": "Check for pending babysitter effects when agent goes idle (proxied via a5c-hooks-proxy)",
+        "script": "./hooks/babysitter-proxied-tool-execute-before.js",
+        "description": "babysitter PreToolUse hook",
         "timeoutMs": 30000
       }
     ],
-    "shell.env": [
+    "tool.execute.after": [
       {
         "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
+        "script": "./hooks/babysitter-proxied-tool-execute-after.js",
+        "description": "babysitter PostToolUse hook",
+        "timeoutMs": 30000
       }
     ],
-    "tool.execute.before": [
+    "session.idle": [
       {
         "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
+        "script": "./hooks/babysitter-proxied-session-idle.js",
+        "description": "babysitter SessionIdle hook",
+        "timeoutMs": 30000
       }
     ],
-    "tool.execute.after": [
+    "shell.env": [
       {
         "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
+        "script": "./hooks/babysitter-proxied-shell-env.js",
+        "description": "babysitter ShellEnv hook",
+        "timeoutMs": 5000
       }
     ]
   }

package/package.json

@@ -1,46 +1,50 @@
 {
   "name": "@a5c-ai/babysitter-opencode",
-  "version": "5.0.1-staging.e4f17eff",
-  "description": "Babysitter orchestration plugin for OpenCode with SDK-managed process-library bootstrapping and in-turn iteration model",
+  "version": "5.0.1-staging.ef4e872c",
+  "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
   "scripts": {
-    "test": "node test/integration.test.js",
-    "test:integration": "node test/integration.test.js",
-    "sync:commands": "node scripts/sync-command-docs.cjs",
-    "postinstall": "node bin/install.cjs",
-    "preuninstall": "node bin/uninstall.cjs",
     "deploy": "npm publish --access public",
-    "deploy:staging": "npm publish --access public --tag staging"
+    "deploy:staging": "npm publish --access public --tag staging",
+    "postinstall": "node bin/install.js",
+    "preuninstall": "node bin/uninstall.js",
+    "team:install": "node scripts/team-install.js",
+    "test": "node test/integration.test.js",
+    "sync:commands": "node scripts/sync-command-docs.cjs"
   },
   "bin": {
-    "babysitter-opencode": "bin/cli.cjs"
+    "babysitter-opencode": "bin/cli.js"
   },
   "files": [
     "bin/",
-    "commands/",
     "hooks/",
-    "scripts/",
     "skills/",
+    "commands/",
+    "scripts/",
     "plugin.json",
-    "versions.json"
+    "README.md",
+    "versions.json",
+    "package.json"
   ],
   "keywords": [
     "babysitter",
     "opencode",
-    "orchestration",
-    "ai-agent",
-    "sdk-integration"
+    "orchestration"
   ],
   "author": "a5c.ai",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@a5c-ai/babysitter-sdk": "5.0.1-staging.ef4e872c"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/a5c-ai/babysitter"
+    "url": "git+https://github.com/a5c-ai/babysitter.git",
+    "directory": "plugins/babysitter-opencode"
   },
   "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-opencode#readme",
-  "dependencies": {
-    "@a5c-ai/babysitter-sdk": "5.0.1-staging.e4f17eff"
+  "bugs": {
+    "url": "https://github.com/a5c-ai/babysitter/issues"
   }
 }

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "babysitter",
-  "version": "5.0.1-staging.e4f17eff",
-  "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval -- powered by the Babysitter SDK",
+  "version": "5.0.1-staging.ef4e872c",
+  "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",
   "harness": "opencode",
@@ -18,8 +18,10 @@
     "automation",
     "event-sourced",
     "hooks",
-    "opencode",
+    "TDD",
+    "quality-convergence",
     "agent",
-    "LLM"
+    "LLM",
+    "opencode"
   ]
 }

package/scripts/team-install.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+'use strict';
+
+var path = require('path');
+var shared = require('../bin/install-shared');
+
+var workspace = process.cwd();
+for (var i = 0; i < process.argv.length; i++) {
+  if (process.argv[i] === '--workspace' && process.argv[i + 1]) {
+    workspace = path.resolve(process.argv[i + 1]);
+  }
+}
+
+var src = process.env.PLUGIN_PACKAGE_ROOT || path.resolve(__dirname, '..');
+var dest = shared.getHomePluginRoot('workspace');
+console.log('[babysitter] Team install to ' + dest);
+
+shared.copyPluginBundle(src, dest);
+if (typeof shared.harnessTeamInstall === 'function') {
+  shared.harnessTeamInstall(src, dest, workspace);
+}
+shared.runPostInstall(dest);
+console.log('[babysitter] Team install complete.');

package/skills/contrib/SKILL.md

@@ -5,30 +5,30 @@ description: Submit feedback or contribute to babysitter project
 
 # contrib
 
-Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
-
-## Process Routing
-
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
+
+## Process Routing
+
 Contribution processes live under the active process library's `cradle/` directory. Resolve the active library root with `babysitter process-library:active --json` and route based on arguments:
-
-### Issue-based (opens a GitHub issue in a5c-ai/babysitter)
- * **Bug report** → `cradle/bug-report.js#process` — Report a bug in the SDK, CLI, process library, etc.
- * **Feature request** → `cradle/feature-request.js#process` — Request a new feature or enhancement
- * **Documentation question** → `cradle/documentation-question.js#process` — Ask about undocumented behavior or missing docs
-
-### PR-based (forks repo, creates branch, submits PR to a5c-ai/babysitter)
- * **Bugfix** → `cradle/bugfix.js#process` — User already has the fix for a bug
- * **Feature implementation** → `cradle/feature-implementation-contribute.js#process` — User already has a feature implementation
- * **Harness integration** → `cradle/feature-harness-integration-contribute.js#process` — User has a harness (CI/CD, IDE, editor) integration
- * **Library contribution** → `cradle/library-contribution.js#process` — New or improved process/skill/subagent for the library
- * **Documentation answer** → `cradle/documentation-contribute-answer.js#process` — User has an answer for an unanswered docs question
-
-### Router (when arguments are empty or general)
- * **Contribute** → `cradle/contribute.js#process` — Explains contribution types and routes to the specific process
-
-## Contribution Rules
-
- * PR-based contributions: fork the babysitter repo (a5c-ai/babysitter) for the user, ask to star if not already starred, perform changes, submit PR
- * Issue-based contributions: gather details, search for duplicates, review, then open an issue in a5c-ai/babysitter
- * Add breakpoints (permissions) before ALL gh actions (fork, star, submit PR/issue) to allow user review and cancellation
+
+### Issue-based (opens a GitHub issue in a5c-ai/babysitter)
+ * **Bug report** → `cradle/bug-report.js#process` — Report a bug in the SDK, CLI, process library, etc.
+ * **Feature request** → `cradle/feature-request.js#process` — Request a new feature or enhancement
+ * **Documentation question** → `cradle/documentation-question.js#process` — Ask about undocumented behavior or missing docs
+
+### PR-based (forks repo, creates branch, submits PR to a5c-ai/babysitter)
+ * **Bugfix** → `cradle/bugfix.js#process` — User already has the fix for a bug
+ * **Feature implementation** → `cradle/feature-implementation-contribute.js#process` — User already has a feature implementation
+ * **Harness integration** → `cradle/feature-harness-integration-contribute.js#process` — User has a harness (CI/CD, IDE, editor) integration
+ * **Library contribution** → `cradle/library-contribution.js#process` — New or improved process/skill/subagent for the library
+ * **Documentation answer** → `cradle/documentation-contribute-answer.js#process` — User has an answer for an unanswered docs question
+
+### Router (when arguments are empty or general)
+ * **Contribute** → `cradle/contribute.js#process` — Explains contribution types and routes to the specific process
+
+## Contribution Rules
+
+ * PR-based contributions: fork the babysitter repo (a5c-ai/babysitter) for the user, ask to star if not already starred, perform changes, submit PR
+ * Issue-based contributions: gather details, search for duplicates, review, then open an issue in a5c-ai/babysitter
+ * Add breakpoints (permissions) before ALL gh actions (fork, star, submit PR/issue) to allow user review and cancellation
  * If arguments are empty: use the `contribute.js` router process to show options and route accordingly

package/skills/doctor/SKILL.md

@@ -363,13 +363,13 @@ Mark as FAIL if:
 - Parse the output and inspect the `resolvedFrom` field. Classify as follows:
   - `resolvedFrom: "pid-marker"` → mark as PASS ("Session ID derives from the live Claude Code ancestor process -- authoritative").
   - `resolvedFrom: "env-file"` → mark as PASS with a note ("CLAUDE_ENV_FILE was used; typically healthy").
-  - `resolvedFrom: "env-var"` → mark as WARN ("`BABYSITTER_SESSION_ID` is set without a corroborating PID marker. Likely stale from a prior Claude Code session -- see GitHub issue #130").
-    - Remediation: run `babysitter session:cleanup` and start a fresh Claude Code session, or `unset BABYSITTER_SESSION_ID` before invoking babysitter.
+  - `resolvedFrom: "env-var"` → mark as WARN ("`AGENT_SESSION_ID` is set without a corroborating PID marker. Likely stale from a prior Claude Code session -- see GitHub issue #130").
+    - Remediation: run `babysitter session:cleanup` and start a fresh Claude Code session, or `unset AGENT_SESSION_ID` before invoking babysitter.
   - `resolvedFrom: "none"` → mark as ERROR ("No session ID resolvable. Either no session-start hook fired, or the ancestor walk failed").
 
 **Env-var shadow check:**
 - Independently inspect `envVarPresent` and `envVarMatches` in the output.
-- If `envVarPresent && !envVarMatches`, mark as WARN ("`BABYSITTER_SESSION_ID` in env does not match the resolved session ID; a stale value is shadowing the authoritative one. Unset the env var").
+- If `envVarPresent && !envVarMatches`, mark as WARN ("`AGENT_SESSION_ID` in env does not match the resolved session ID; a stale value is shadowing the authoritative one. Unset the env var").
 
 ---
 
@@ -391,7 +391,7 @@ Mark as FAIL if:
 
 - Enumerate files in `~/.a5c/` matching the pattern `current-session-*-pid-*`.
 - Count markers per harness (derived from the filename).
-- If more than one live marker exists for the same harness, mark as INFO ("Multiple live Claude Code / harness sessions detected; ensure each shell scopes `BABYSITTER_SESSION_ID` appropriately -- the PID marker handles this automatically").
+- If more than one live marker exists for the same harness, mark as INFO ("Multiple live Claude Code / harness sessions detected; ensure each shell scopes `AGENT_SESSION_ID` appropriately -- the PID marker handles this automatically").
 - Otherwise mark as PASS.
 
 ---
@@ -502,7 +502,7 @@ babysitter session:cleanup --dry-run   # preview
 babysitter session:cleanup             # apply
 
 # 2. Unset a stale env var
-unset BABYSITTER_SESSION_ID
+unset AGENT_SESSION_ID
 
 # 3. Re-bind a run explicitly if needed
 babysitter session:resume --session-id <fresh-id> --state-dir ~/.a5c --run-id <runId> --runs-dir .a5c/runs