@a5c-ai/babysitter-github 5.0.1-staging.f6432257 → 5.0.1-staging.ff2c19f9

package/hooks/babysitter-proxied-user-prompt-submitted.sh

@@ -1,87 +1,3 @@
 #!/bin/bash
-# Unified userPromptSubmitted Hook for GitHub Copilot CLI
-# Routes through hooks-proxy for all hook execution.
-#
-# Applies density-filter compression to long user prompts.
-# Delegates to SDK CLI: babysitter hook:run --hook-type user-prompt-submitted
-#
-# NOTE: Output from this hook is IGNORED by Copilot CLI.
-# This hook is for logging and side-effects only.
-
-PLUGIN_ROOT="${COPILOT_PLUGIN_DIR:-$(cd "$(dirname "$0")/.." && pwd)}"
-PROXY_MARKER_FILE="${PLUGIN_ROOT}/.hooks-proxy-install-attempted"
-
-GLOBAL_ROOT="${BABYSITTER_GLOBAL_STATE_DIR:-$HOME/.a5c}"
-LOG_DIR="${BABYSITTER_LOG_DIR:-${GLOBAL_ROOT}/logs}"
-mkdir -p "$LOG_DIR" 2>/dev/null
-
-# Get required version from versions.json (used for hooks-proxy)
-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")
-
-# ---------------------------------------------------------------------------
-# Hooks-proxy install (same pattern as SDK install in session-start)
-# ---------------------------------------------------------------------------
-
-install_hooks_proxy() {
-  local target_version="$1"
-  if npm i -g "@a5c-ai/hooks-proxy-cli@${target_version}" --loglevel=error 2>/dev/null; then
-    return 0
-  else
-    if npm i -g "@a5c-ai/hooks-proxy-cli@${target_version}" --prefix "$HOME/.local" --loglevel=error 2>/dev/null; then
-      export PATH="$HOME/.local/bin:$PATH"
-      return 0
-    fi
-  fi
-  return 1
-}
-
-# Resolve hooks-proxy binary
-PROXY=""
-if command -v a5c-hooks-proxy &>/dev/null; then
-  PROXY="a5c-hooks-proxy"
-elif [ -f "$HOME/.local/bin/a5c-hooks-proxy" ]; then
-  PROXY="$HOME/.local/bin/a5c-hooks-proxy"
-fi
-
-# Install if not found (only attempt once per plugin version)
-if [ -z "$PROXY" ] && [ ! -f "$PROXY_MARKER_FILE" ]; then
-  install_hooks_proxy "$SDK_VERSION"
-  echo "$SDK_VERSION" > "$PROXY_MARKER_FILE" 2>/dev/null
-  if command -v a5c-hooks-proxy &>/dev/null; then
-    PROXY="a5c-hooks-proxy"
-  elif [ -f "$HOME/.local/bin/a5c-hooks-proxy" ]; then
-    PROXY="$HOME/.local/bin/a5c-hooks-proxy"
-  fi
-fi
-
-# npx fallback if still not found
-if [ -z "$PROXY" ]; then
-  PROXY="npx -y @a5c-ai/hooks-proxy-cli@${SDK_VERSION} "
-fi
-
-# ---------------------------------------------------------------------------
-# Capture stdin and delegate to hooks-proxy
-# ---------------------------------------------------------------------------
-
-INPUT_FILE=$(mktemp 2>/dev/null || echo "/tmp/hook-user-prompt-submitted-$$.json")
-cat > "$INPUT_FILE"
-
-if command -v babysitter &>/dev/null; then
-  babysitter log --type hook --label "hook:user-prompt-submitted" --message "Unified hook invoked" --source shell-hook 2>/dev/null || true
-fi
-
-STDERR_LOG="$LOG_DIR/babysitter-user-prompt-submitted-hook-stderr.log"
-
-$PROXY invoke \
-  --adapter copilot \
-  --handler "babysitter hook:run --harness unified --hook-type user-prompt-submitted --json" \
-  --json \
-  < "$INPUT_FILE" 2>"$STDERR_LOG" || true
-
-if command -v babysitter &>/dev/null; then
-  babysitter log --type hook --label "hook:user-prompt-submitted" --message "Hook complete" --source shell-hook 2>/dev/null || true
-fi
-
-rm -f "$INPUT_FILE" 2>/dev/null
-
-exit 0
+set -euo pipefail
+babysitter hook:run --harness unified --hook-type user-prompt-submit --json

package/hooks.json

@@ -4,25 +4,25 @@
     "sessionStart": [
       {
         "type": "command",
-        "bash": "bash \"./hooks/babysitter-proxied-session-start.sh\"",
-        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-session-start.ps1\"",
+        "bash": "./hooks/babysitter-proxied-session-start.sh",
+        "powershell": "./hooks/babysitter-proxied-session-start.ps1",
         "timeoutSec": 30
       }
     ],
-    "sessionEnd": [
+    "userPromptSubmitted": [
       {
         "type": "command",
-        "bash": "bash \"./hooks/babysitter-proxied-session-end.sh\"",
-        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-session-end.ps1\"",
-        "timeoutSec": 30
+        "bash": "./hooks/babysitter-proxied-user-prompt-submitted.sh",
+        "powershell": "./hooks/babysitter-proxied-user-prompt-submitted.ps1",
+        "timeoutSec": 15
       }
     ],
-    "userPromptSubmitted": [
+    "sessionEnd": [
       {
         "type": "command",
-        "bash": "bash \"./hooks/babysitter-proxied-user-prompt-submitted.sh\"",
-        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/babysitter-proxied-user-prompt-submitted.ps1\"",
-        "timeoutSec": 15
+        "bash": "./hooks/babysitter-proxied-session-end.sh",
+        "powershell": "./hooks/babysitter-proxied-session-end.ps1",
+        "timeoutSec": 30
       }
     ]
   }

package/package.json

@@ -1,50 +1,48 @@
 {
   "name": "@a5c-ai/babysitter-github",
-  "version": "5.0.1-staging.f6432257",
-  "description": "Babysitter orchestration plugin for GitHub Copilot CLI with lifecycle hooks and SDK-managed process-library bootstrapping",
+  "version": "5.0.1-staging.ff2c19f9",
+  "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
   "scripts": {
-    "test": "node scripts/sync-command-surfaces.js --check && node test/cloud-agent-install.test.js",
-    "sync:commands": "node scripts/sync-command-surfaces.js",
+    "deploy": "npm publish --access public",
+    "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",
-    "deploy": "npm publish --access public",
-    "deploy:staging": "npm publish --access public --tag staging"
+    "test": "node scripts/sync-command-surfaces.js --check",
+    "sync:commands": "node scripts/sync-command-surfaces.js"
   },
   "bin": {
-    "babysitter-github": "bin/cli.js"
+    "babysitter-github-copilot": "bin/cli.js"
   },
   "files": [
-    "plugin.json",
+    "bin/",
     "hooks.json",
     "hooks/",
     "skills/",
-    "bin/",
+    "commands/",
     "scripts/",
-    "versions.json",
+    "plugin.json",
     "AGENTS.md",
-    "commands/",
-    ".github/",
-    "README.md"
+    "README.md",
+    "versions.json",
+    "package.json"
   ],
   "keywords": [
     "babysitter",
     "github-copilot",
-    "orchestration",
-    "ai-agent",
-    "sdk-integration"
+    "orchestration"
   ],
   "author": "a5c.ai",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@a5c-ai/babysitter-sdk": "5.0.1-staging.ff2c19f9"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/a5c-ai/babysitter"
   },
-  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-github#readme",
-  "dependencies": {
-    "@a5c-ai/babysitter-sdk": "5.0.1-staging.f6432257"
-  }
+  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-github#readme"
 }

package/plugin.json

@@ -1,10 +1,9 @@
 {
   "name": "babysitter",
-  "version": "5.0.1-staging.f6432257",
-  "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.ff2c19f9",
+  "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
   "author": {
-    "name": "a5c.ai",
-    "email": "support@a5c.ai"
+    "name": "a5c.ai"
   },
   "license": "MIT",
   "skills": "skills/",
@@ -21,8 +20,10 @@
     "automation",
     "event-sourced",
     "hooks",
-    "github-copilot",
+    "TDD",
+    "quality-convergence",
     "agent",
-    "LLM"
+    "LLM",
+    "github-copilot"
   ]
 }

package/scripts/team-install.js

@@ -1,93 +1,23 @@
 #!/usr/bin/env node
 'use strict';
 
-const fs = require('fs');
-const path = require('path');
-const {
-  copyPluginBundle,
-  ensureGlobalProcessLibrary,
-  ensureMarketplaceEntry,
-  installCopilotSurface,
-  registerCopilotPlugin,
-  warnWindowsHooks,
-  writeJson,
-} = require('../bin/install-shared');
+var path = require('path');
+var shared = require('../bin/install-shared');
 
-function parseArgs(argv) {
-  const args = {
-    workspace: process.cwd(),
-    cloudAgent: false,
-    dryRun: false,
-  };
-  for (let i = 2; i < argv.length; i += 1) {
-    if (argv[i] === '--workspace' && argv[i + 1]) {
-      args.workspace = path.resolve(argv[++i]);
-    } else if (argv[i] === '--cloud-agent') {
-      args.cloudAgent = true;
-    } else if (argv[i] === '--dry-run') {
-      args.dryRun = true;
-    }
+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]);
   }
-  return args;
 }
 
-function main() {
-  const args = parseArgs(process.argv);
-  const packageRoot = path.resolve(process.env.BABYSITTER_PACKAGE_ROOT || path.join(__dirname, '..'));
-  const workspaceRoot = args.workspace;
-  const workspacePluginRoot = path.join(workspaceRoot, 'plugins', 'babysitter');
-  const workspaceMarketplacePath = path.join(workspaceRoot, '.agents', 'plugins', 'marketplace.json');
-  const workspaceCopilotDir = path.join(workspaceRoot, '.copilot');
+var src = process.env.PLUGIN_PACKAGE_ROOT || path.resolve(__dirname, '..');
+var dest = shared.getHomePluginRoot('workspace');
+console.log('[babysitter] Team install to ' + dest);
 
-  const installInfo = {
-    installedAt: new Date().toISOString(),
-    packageRoot,
-    workspaceRoot,
-    pluginRoot: workspacePluginRoot,
-    marketplacePath: workspaceMarketplacePath,
-    copilotDir: workspaceCopilotDir,
-  };
-
-  if (args.dryRun) {
-    console.log(JSON.stringify({
-      ok: true,
-      dryRun: true,
-      installInfo,
-    }, null, 2));
-    return;
-  }
-
-  copyPluginBundle(packageRoot, workspacePluginRoot);
-  ensureMarketplaceEntry(workspaceMarketplacePath, workspacePluginRoot);
-  registerCopilotPlugin(workspacePluginRoot);
-  installCopilotSurface(packageRoot, workspaceCopilotDir);
-  if (args.cloudAgent) {
-    const { installCloudAgentSurface } = require('../bin/install-shared');
-    installInfo.cloudAgent = installCloudAgentSurface(packageRoot, workspaceRoot);
-  }
-
-  const active = ensureGlobalProcessLibrary(packageRoot);
-  installInfo.processLibraryStateFile = active.stateFile;
-  installInfo.processLibraryRoot = active.binding?.dir || '';
-  installInfo.processLibraryCloneDir = active.defaultSpec?.cloneDir || '';
-
-  const outDir = path.join(workspaceRoot, '.a5c', 'team');
-  fs.mkdirSync(outDir, { recursive: true });
-  writeJson(path.join(outDir, 'install.json'), installInfo);
-
-  const profilePath = path.join(outDir, 'profile.json');
-  if (!fs.existsSync(profilePath)) {
-    writeJson(profilePath, {
-      teamName: 'default',
-      pluginRoot: workspacePluginRoot,
-      marketplacePath: workspaceMarketplacePath,
-      copilotDir: workspaceCopilotDir,
-      processLibraryLookupCommand: 'babysitter process-library:active --json',
-    });
-  }
-
-  warnWindowsHooks();
-  console.log('[team-install] complete');
+shared.copyPluginBundle(src, dest);
+if (typeof shared.harnessTeamInstall === 'function') {
+  shared.harnessTeamInstall(src, dest, workspace);
 }
-
-main();
+shared.runPostInstall(dest);
+console.log('[babysitter] Team install complete.');

package/skills/cleanup/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: cleanup
+description: Clean up .a5c/runs and .a5c/processes directories. Aggregates insights from completed/failed runs into docs/run-history-insights.md, then removes old run data and orphaned process files.
+---
+
+# cleanup
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
+
+Create and run a cleanup process using the process at `skills\babysit\process\cradle\cleanup-runs.js/processes/cleanup-runs.js`.
+
+Implementation notes (for the process):
+- Parse arguments for `--dry-run` flag (if present, set dryRun: true in inputs) and `--keep-days N` (default: 7)
+- The process scans .a5c/runs/ for completed/failed runs, aggregates insights, writes summaries, then removes old data
+- Always show the user what will be removed before removing (in interactive mode via breakpoints)
+- In non-interactive mode (yolo), proceed with cleanup using defaults
+- The insights file goes to docs/run-history-insights.md
+- Only remove terminal runs (completed/failed) older than the keep-days threshold
+- Never remove active/in-progress runs
+- Remove orphaned process files not referenced by remaining runs
+- After cleanup, show remaining run count and disk usage

package/skills/contrib/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: contrib
+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
+
+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
+ * 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

package/skills/forever/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: forever
+description: Use this command to start babysitting a never-ending babysitter run.
+---
+
+# forever
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). but create a process that uses an infinte loop and a ctx.sleep to create a never-ending babysitter loop. an example of such process is a daily process that reads new support ticket every day and tries to resolve them, then sleeps for 4 hours and repeats the process.

package/skills/help/SKILL.md

@@ -231,9 +231,10 @@ SECONDARY COMMANDS
   effect status in your browser. Useful when running /yolo or /forever to watch
   progress without interrupting the run.
 
-  How it works: Runs npx @yoavmayer/babysitter-observer-dashboard@latest which watches
+  How it works: Runs npx @a5c-ai/babysitter-observer-dashboard@latest which watches
   the .a5c/runs/ directory (or a parent directory containing multiple projects) and
-  serves a live dashboard. The process is blocking -- it runs until you stop it.
+  serves a live dashboard. The process is blocking -- it runs until you stop it, and
+  it prints the local URL to share with the user.
 
   Example: /babysitter:observe
   (opens browser showing all runs with live-updating task

package/skills/observe/SKILL.md

@@ -10,4 +10,4 @@ Run the babysitter observer dashboard:
 1. Determine the watch directory — this is usually the project's container directory (the parent of the project dir), or the current working directory if not specified.
 2. Launch the dashboard: `npx -y @a5c-ai/babysitter-observer-dashboard@latest --watch-dir <dir>`
 3. This is a blocking process — it will keep running until stopped.
-4. Open the browser at the URL printed by the dashboard.
+4. Report the URL printed by the dashboard to the user, then open it in the browser.