@a5c-ai/babysitter-github 0.1.1-staging.04cc300a

package/hooks/session-start.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+# Babysitter Session Start Hook for GitHub Copilot CLI
+# Ensures the babysitter SDK CLI is installed (from versions.json sdkVersion),
+# then delegates to the TypeScript handler.
+#
+# Protocol:
+#   Input:  JSON via stdin (contains session_id, cwd, etc.)
+#   Output: JSON via stdout ({} on success)
+#   Stderr: debug/log output only
+#   Exit 0: success
+#   Exit 2: block (fatal error)
+
+set -euo pipefail
+
+PLUGIN_ROOT="${COPILOT_PLUGIN_DIR:-$(cd "$(dirname "$0")/.." && pwd)}"
+MARKER_FILE="${PLUGIN_ROOT}/.babysitter-install-attempted"
+
+LOG_DIR="${BABYSITTER_LOG_DIR:-$PLUGIN_ROOT/.a5c/logs}"
+LOG_FILE="$LOG_DIR/babysitter-session-start-hook.log"
+mkdir -p "$LOG_DIR" 2>/dev/null
+
+# Structured logging helper -- writes to both local and global log
+blog() {
+  local msg="$1"
+  local ts
+  ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  echo "[INFO] $ts $msg" >> "$LOG_FILE" 2>/dev/null
+  # Use CLI structured logging when available; fall back to direct append
+  if command -v babysitter &>/dev/null; then
+    babysitter log --type hook --label "hook:session-start" --message "$msg" --source shell-hook 2>/dev/null || true
+  fi
+}
+
+blog "Hook script invoked"
+blog "PLUGIN_ROOT=$PLUGIN_ROOT"
+
+# Get required SDK version from versions.json
+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")
+
+# Function to install/upgrade SDK
+install_sdk() {
+  local target_version="$1"
+  # Try global install first, fall back to user-local if permissions fail
+  if npm i -g "@a5c-ai/babysitter-sdk@${target_version}" --loglevel=error 2>/dev/null; then
+    blog "Installed SDK globally (${target_version})"
+    return 0
+  else
+    # Global install failed (permissions) -- try user-local prefix
+    if npm i -g "@a5c-ai/babysitter-sdk@${target_version}" --prefix "$HOME/.local" --loglevel=error 2>/dev/null; then
+      export PATH="$HOME/.local/bin:$PATH"
+      blog "Installed SDK to user prefix (${target_version})"
+      return 0
+    fi
+  fi
+  return 1
+}
+
+# Check if babysitter CLI exists and if version matches
+NEEDS_INSTALL=false
+if command -v babysitter &>/dev/null; then
+  CURRENT_VERSION=$(babysitter --version 2>/dev/null || echo "unknown")
+  if [ "$CURRENT_VERSION" != "$SDK_VERSION" ]; then
+    blog "SDK version mismatch: installed=${CURRENT_VERSION}, required=${SDK_VERSION}"
+    NEEDS_INSTALL=true
+  else
+    blog "SDK version OK: ${CURRENT_VERSION}"
+  fi
+else
+  blog "SDK CLI not found, will install"
+  NEEDS_INSTALL=true
+fi
+
+# Install/upgrade if needed (only attempt once per plugin version)
+if [ "$NEEDS_INSTALL" = true ] && [ ! -f "$MARKER_FILE" ]; then
+  install_sdk "$SDK_VERSION"
+  echo "$SDK_VERSION" > "$MARKER_FILE" 2>/dev/null
+fi
+
+# If still not available after install attempt, try npx as last resort
+if ! command -v babysitter &>/dev/null; then
+  blog "CLI not found after install, using npx fallback"
+  babysitter() { npx -y "@a5c-ai/babysitter-sdk@${SDK_VERSION}" "$@"; }
+  export -f babysitter
+fi
+
+# Capture stdin to a temp file so the CLI receives a clean EOF
+# (piping /dev/stdin directly can keep the Node.js event loop alive)
+INPUT_FILE=$(mktemp 2>/dev/null || echo "/tmp/hook-session-start-$$.json")
+cat > "$INPUT_FILE"
+
+blog "Hook input received ($(wc -c < "$INPUT_FILE") bytes)"
+
+RESULT=$(babysitter hook:run --hook-type session-start --harness github-copilot --plugin-root "$PLUGIN_ROOT" --json < "$INPUT_FILE" 2>"$LOG_DIR/babysitter-session-start-hook-stderr.log")
+EXIT_CODE=$?
+
+blog "CLI exit code=$EXIT_CODE"
+
+rm -f "$INPUT_FILE" 2>/dev/null
+printf '%s\n' "$RESULT"
+exit $EXIT_CODE

package/hooks/user-prompt-submitted.ps1

@@ -0,0 +1,51 @@
+# Babysitter userPromptSubmitted Hook for GitHub Copilot CLI (PowerShell)
+# Applies density-filter compression to long user prompts.
+#
+# NOTE: Output from this hook is IGNORED by Copilot CLI.
+# This hook is for logging and side-effects only.
+
+$ErrorActionPreference = "Continue"
+
+$PluginRoot = if ($env:COPILOT_PLUGIN_DIR) { $env:COPILOT_PLUGIN_DIR } else { Split-Path -Parent $PSScriptRoot }
+
+# Resolve babysitter CLI
+$hasBabysitter = [bool](Get-Command babysitter -ErrorAction SilentlyContinue)
+$useFallback = $false
+
+if (-not $hasBabysitter) {
+    $localBin = Join-Path $env:USERPROFILE ".local\bin\babysitter.cmd"
+    if (Test-Path $localBin) {
+        $env:PATH = "$(Split-Path $localBin);$env:PATH"
+        $hasBabysitter = $true
+    } else {
+        $versionsFile = Join-Path $PluginRoot "versions.json"
+        try {
+            $SdkVersion = (Get-Content $versionsFile -Raw | ConvertFrom-Json).sdkVersion
+            if (-not $SdkVersion) { $SdkVersion = "latest" }
+        } catch {
+            $SdkVersion = "latest"
+        }
+        $useFallback = $true
+    }
+}
+
+$LogDir = if ($env:BABYSITTER_LOG_DIR) { $env:BABYSITTER_LOG_DIR } else { Join-Path $PluginRoot ".a5c\logs" }
+New-Item -ItemType Directory -Path $LogDir -Force -ErrorAction SilentlyContinue | Out-Null
+
+# Capture stdin
+$InputFile = [System.IO.Path]::GetTempFileName()
+$input | Out-File -FilePath $InputFile -Encoding utf8
+
+$stderrLog = Join-Path $LogDir "babysitter-user-prompt-submitted-hook-stderr.log"
+
+try {
+    if ($useFallback) {
+        Get-Content $InputFile | & npx -y "@a5c-ai/babysitter-sdk@$SdkVersion" hook:run --hook-type user-prompt-submitted --harness github-copilot --json 2>$stderrLog | Out-Null
+    } elseif ($hasBabysitter) {
+        Get-Content $InputFile | & babysitter hook:run --hook-type user-prompt-submitted --harness github-copilot --json 2>$stderrLog | Out-Null
+    }
+} catch {}
+
+Remove-Item $InputFile -Force -ErrorAction SilentlyContinue
+
+exit 0

package/hooks/user-prompt-submitted.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Babysitter userPromptSubmitted Hook for GitHub Copilot CLI
+# 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)}"
+
+# Resolve babysitter CLI: installed binary, user-local prefix, or npx fallback
+if ! command -v babysitter &>/dev/null; then
+  if [ -x "$HOME/.local/bin/babysitter" ]; then
+    export PATH="$HOME/.local/bin:$PATH"
+  else
+    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")
+    if [ -n "$SDK_VERSION" ]; then
+      babysitter() { npx -y "@a5c-ai/babysitter-sdk@${SDK_VERSION}" "$@"; }
+      export -f babysitter
+    else
+      # No CLI available -- exit silently
+      exit 0
+    fi
+  fi
+fi
+
+LOG_DIR="${BABYSITTER_LOG_DIR:-$PLUGIN_ROOT/.a5c/logs}"
+mkdir -p "$LOG_DIR" 2>/dev/null
+
+INPUT_FILE=$(mktemp 2>/dev/null || echo "/tmp/hook-user-prompt-submitted-$$.json")
+cat > "$INPUT_FILE"
+
+babysitter log --type hook --label "hook:user-prompt-submitted" --message "Hook invoked" --source shell-hook 2>/dev/null || true
+
+babysitter hook:run --hook-type user-prompt-submitted --harness github-copilot --json < "$INPUT_FILE" 2>"$LOG_DIR/babysitter-user-prompt-submitted-hook-stderr.log" || true
+
+babysitter log --type hook --label "hook:user-prompt-submitted" --message "Hook complete" --source shell-hook 2>/dev/null || true
+
+rm -f "$INPUT_FILE" 2>/dev/null
+
+exit 0

package/hooks.json

@@ -0,0 +1,29 @@
+{
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "type": "command",
+        "bash": "./hooks/session-start.sh",
+        "powershell": "./hooks/session-start.ps1",
+        "timeoutSec": 30
+      }
+    ],
+    "sessionEnd": [
+      {
+        "type": "command",
+        "bash": "./hooks/session-end.sh",
+        "powershell": "./hooks/session-end.ps1",
+        "timeoutSec": 30
+      }
+    ],
+    "userPromptSubmitted": [
+      {
+        "type": "command",
+        "bash": "./hooks/user-prompt-submitted.sh",
+        "powershell": "./hooks/user-prompt-submitted.ps1",
+        "timeoutSec": 30
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@a5c-ai/babysitter-github",
+  "version": "0.1.1-staging.04cc300a",
+  "description": "Babysitter orchestration plugin for GitHub Copilot CLI with lifecycle hooks and SDK-managed process-library bootstrapping",
+  "scripts": {
+    "test": "node scripts/sync-command-surfaces.js --check && node test/cloud-agent-install.test.js",
+    "sync:commands": "node scripts/sync-command-surfaces.js",
+    "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"
+  },
+  "bin": {
+    "babysitter-github": "bin/cli.js"
+  },
+  "files": [
+    "plugin.json",
+    "hooks.json",
+    "hooks/",
+    "skills/",
+    "bin/",
+    "scripts/",
+    "versions.json",
+    "AGENTS.md",
+    "commands/",
+    ".github/",
+    "README.md"
+  ],
+  "keywords": [
+    "babysitter",
+    "github-copilot",
+    "orchestration",
+    "ai-agent",
+    "sdk-integration"
+  ],
+  "author": "a5c.ai",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "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": "0.0.184-staging.04cc300a"
+  }
+}

package/plugin.json

@@ -0,0 +1,25 @@
+{
+  "name": "babysitter",
+  "version": "0.1.0",
+  "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",
+  "author": { "name": "a5c.ai", "email": "support@a5c.ai" },
+  "license": "MIT",
+  "skills": "skills/",
+  "hooks": "hooks.json",
+  "commands": "commands/",
+  "agents": "AGENTS.md",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/a5c-ai/babysitter"
+  },
+  "keywords": [
+    "orchestration",
+    "workflow",
+    "automation",
+    "event-sourced",
+    "hooks",
+    "github-copilot",
+    "agent",
+    "LLM"
+  ]
+}

package/scripts/sync-command-surfaces.js

@@ -0,0 +1,62 @@
+'use strict';
+
+const path = require('path');
+const {
+  listDirectories,
+  listMarkdownBasenames,
+  reportCheckResult,
+  syncCommandMirrors,
+  syncSkillsFromCommands,
+} = require('../../../scripts/plugin-command-sync-lib.cjs');
+
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+const REPO_ROOT = path.resolve(PACKAGE_ROOT, '..', '..');
+const ROOT_COMMANDS = path.join(REPO_ROOT, 'plugins', 'babysitter', 'commands');
+const PLUGIN_COMMANDS = path.join(PACKAGE_ROOT, 'commands');
+const PLUGIN_SKILLS = path.join(PACKAGE_ROOT, 'skills');
+const LABEL = 'babysitter-github sync';
+
+function getMirroredCommandNames() {
+  const local = new Set(listMarkdownBasenames(PLUGIN_COMMANDS));
+  return listMarkdownBasenames(ROOT_COMMANDS).filter((name) => local.has(name));
+}
+
+function getDerivedSkillNames() {
+  const local = new Set(listDirectories(PLUGIN_SKILLS));
+  return listMarkdownBasenames(PLUGIN_COMMANDS).filter((name) => local.has(name));
+}
+
+function main() {
+  const check = process.argv.includes('--check');
+  const mirrorResult = syncCommandMirrors({
+    label: LABEL,
+    sourceRoot: ROOT_COMMANDS,
+    targetRoot: PLUGIN_COMMANDS,
+    names: getMirroredCommandNames(),
+    check,
+    cwd: PACKAGE_ROOT,
+  });
+  const skillsResult = syncSkillsFromCommands({
+    label: LABEL,
+    sourceRoot: PLUGIN_COMMANDS,
+    skillsRoot: PLUGIN_SKILLS,
+    names: getDerivedSkillNames(),
+    check,
+    cwd: PACKAGE_ROOT,
+  });
+
+  if (check) {
+    reportCheckResult(LABEL, [...mirrorResult.stale, ...skillsResult.stale]);
+    return;
+  }
+
+  const updated = mirrorResult.updated + skillsResult.updated;
+  if (updated === 0) {
+    console.log(`[${LABEL}] no GitHub plugin command changes were needed.`);
+    return;
+  }
+
+  console.log(`[${LABEL}] updated ${updated} GitHub plugin file(s).`);
+}
+
+main();

package/scripts/team-install.js

@@ -0,0 +1,93 @@
+#!/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');
+
+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;
+    }
+  }
+  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');
+
+  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');
+}
+
+main();

package/skills/assimilate/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: assimilate
+description: Assimilate an external methodology, harness, or specification into babysitter process definitions with skills and agents.
+---
+
+# assimilate
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
+
+Use the assimilation domain processes from the active process library to convert external sources into well-defined babysitter process definitions with accompanying skills/ and agents/ directories.
+
+If the workspace does not already have an active process-library binding, initialize it first through the shared global SDK binding:
+
+```bash
+babysitter process-library:active --json
+```
+
+Run the process after formalizing it.
+
+Available assimilation workflows:
+- **methodology-assimilation** (`specializations/domains/assimilation/workflows/methodology-assimilation`) - Learns an external methodology from its repo and converts procedural instructions, commands, and manual flows into babysitter processes with refactored skills and agents. Supports output as methodology or specialization.
+- **harness integration** (`specializations/domains/assimilation/harness/*`) - Integrates babysitter SDK with a specific AI coding harness (generic, codex, opencode, gemini-cli, openclaw, antigravity).
+
+During the interview phase, determine which assimilation workflow to use based on the user's target:
+- If the target is a **repo URL or methodology name** then use the methodology-assimilation workflow.
+- If the target is a **harness name** (e.g. codex, opencode, antigravity) then use the matching harness process.
+- If the target is a **specification or other source** then adapt the methodology-assimilation workflow for the spec format.
+- If unclear, ask the user to clarify the assimilation target and type.
+
+## After Assimilation: Contribute Back
+
+After successfully assimilating a methodology or harness integration, prompt the user to share it with the community. The assimilated process definitions, skills, and agents could benefit other babysitter users:
+
+- **Completed a methodology assimilation**: `/babysitter:contrib library contribution: assimilated [methodology-name] into babysitter process definitions`
+- **Completed a harness integration**: `/babysitter:contrib library contribution: [harness-name] harness integration`
+- **Hit issues during assimilation** (e.g. unsupported patterns, missing SDK features): `/babysitter:contrib bug report: assimilation of [target] failed because [description]` or `/babysitter:contrib feature request: [what the SDK needs to support]`
+
+Even just reporting that an assimilation didn't work well helps improve babysitter for everyone.

package/skills/babysit/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: babysit
+description: >-
+  Orchestrate via @babysitter. Use this skill when asked to babysit a run,
+  orchestrate a process or whenever it is called explicitly. (babysit,
+  babysitter, orchestrate, orchestrate a run, workflow, etc.)
+---
+
+# babysit
+
+Orchestrate `.a5c/runs/<runId>/` through iterative execution.
+
+## Dependencies
+
+### Babysitter SDK and CLI
+
+Read the SDK version from `versions.json` to ensure version compatibility:
+
+```bash
+SDK_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('${PLUGIN_ROOT}/versions.json','utf8')).sdkVersion||'latest')}catch{console.log('latest')}")
+sudo npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION
+# sudo is depending on the env and system
+```
+
+then use the CLI alias: CLI="babysitter"
+
+**Alternatively, use the CLI alias:** `CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"`
+
+### jq
+
+make sure you have jq installed and available in the path. if not, install it.
+
+## Instructions
+
+Run the following command to get full orchestration instructions:
+
+```bash
+babysitter instructions:babysit-skill --harness github-copilot --json
+```
+
+Follow the instructions returned by the command above to orchestrate the run.
+
+## GitHub Copilot CLI -- In-Turn Loop Model
+
+**IMPORTANT**: Unlike Claude Code, GitHub Copilot CLI does NOT have a Stop hook
+that can drive the orchestration loop between turns. The `sessionEnd` hook output
+is ignored and cannot block or restart the session.
+
+Therefore, you MUST use **in-turn iteration**: run the full orchestration loop
+within a single session turn. The pattern is:
+
+1. `babysitter run:iterate --json` -- get pending actions
+2. For each pending action: execute it (run tasks, post results via `task:post`)
+3. `babysitter run:iterate --json` -- check for more pending actions
+4. Repeat steps 2-3 until run completes or reaches a breakpoint requiring user input
+5. If a breakpoint requires user input, ask the user and post the response, then continue iterating
+
+All iteration happens within the same turn -- do NOT rely on hooks to re-enter
+the orchestration loop. The agent drives the loop directly by calling
+`run:iterate` repeatedly until completion.
+
+### Loop Example
+
+```bash
+# Initial iterate
+RESULT=$(babysitter run:iterate --run-id "$RUN_ID" --json)
+STATUS=$(echo "$RESULT" | jq -r '.status')
+
+while [ "$STATUS" != "completed" ] && [ "$STATUS" != "failed" ]; do
+  # Process pending actions from RESULT
+  # ... execute tasks, post results ...
+
+  # Iterate again
+  RESULT=$(babysitter run:iterate --run-id "$RUN_ID" --json)
+  STATUS=$(echo "$RESULT" | jq -r '.status')
+done
+```

package/skills/call/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: call
+description: Orchestrate a babysitter run. use this command to start babysitting a complex workflow.
+---
+
+# call
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).