@a5c-ai/babysitter-github 5.0.1-staging.d73033a7 → 5.0.1-staging.daf8e165bc4a

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

@@ -1,92 +1,12 @@
-# Unified userPromptSubmitted Hook for GitHub Copilot CLI (PowerShell)
-# Routes through hooks-proxy for all hook execution.
-#
-# 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 }
-$ProxyMarkerFile = Join-Path $PluginRoot ".hooks-proxy-install-attempted"
-
-$GlobalRoot = if ($env:BABYSITTER_GLOBAL_STATE_DIR) { $env:BABYSITTER_GLOBAL_STATE_DIR } else { Join-Path $HOME ".a5c" }
-$LogDir = if ($env:BABYSITTER_LOG_DIR) { $env:BABYSITTER_LOG_DIR } else { Join-Path $GlobalRoot "logs" }
-New-Item -ItemType Directory -Path $LogDir -Force -ErrorAction SilentlyContinue | Out-Null
-
-# Get required version from versions.json (used for hooks-proxy)
-$versionsFile = Join-Path $PluginRoot "versions.json"
-try {
-    $SdkVersion = (Get-Content $versionsFile -Raw | ConvertFrom-Json).sdkVersion
-    if (-not $SdkVersion) { $SdkVersion = "latest" }
-} catch {
-    $SdkVersion = "latest"
-}
-
-# ---------------------------------------------------------------------------
-# Hooks-proxy install (same pattern as SDK install in session-start)
-# ---------------------------------------------------------------------------
-
-function Install-HooksProxy {
-    param([string]$TargetVersion)
-    try {
-        & npm i -g "@a5c-ai/hooks-proxy-cli@$TargetVersion" --loglevel=error 2>$null
-        if ($LASTEXITCODE -eq 0) { return $true }
-    } catch {}
-    try {
-        $prefix = Join-Path $env:USERPROFILE ".local"
-        & npm i -g "@a5c-ai/hooks-proxy-cli@$TargetVersion" --prefix $prefix --loglevel=error 2>$null
-        if ($LASTEXITCODE -eq 0) {
-            $env:PATH = "$prefix\bin;$env:PATH"
-            return $true
-        }
-    } catch {}
-    return $false
-}
-
-# Resolve hooks-proxy binary
-$Proxy = $null
-if (Get-Command a5c-hooks-proxy -ErrorAction SilentlyContinue) {
-    $Proxy = "a5c-hooks-proxy"
+# PowerShell hook wrapper — sets env vars and delegates to bash
+$env:HOOK_TYPE = 'user-prompt-submit'
+$env:ADAPTER_NAME = 'copilot'
+$env:PLUGIN_ROOT = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+
+$input_data = [Console]::In.ReadToEnd()
+$result = $input_data | & bash "$PSScriptRoot/../$($MyInvocation.MyCommand.Name -replace '\.ps1$','.sh')" 2>$null
+if ($LASTEXITCODE -eq 0 -and $result) {
+  Write-Output $result
 } else {
-    $localProxy = Join-Path $env:USERPROFILE ".local\bin\a5c-hooks-proxy.exe"
-    if (Test-Path $localProxy) {
-        $Proxy = $localProxy
-    }
+  Write-Output '{}'
 }
-
-# Install if not found (only attempt once per plugin version)
-if (-not $Proxy -and -not (Test-Path $ProxyMarkerFile)) {
-    Install-HooksProxy $SdkVersion | Out-Null
-    Set-Content -Path $ProxyMarkerFile -Value $SdkVersion -ErrorAction SilentlyContinue
-    if (Get-Command a5c-hooks-proxy -ErrorAction SilentlyContinue) {
-        $Proxy = "a5c-hooks-proxy"
-    } else {
-        $localProxy = Join-Path $env:USERPROFILE ".local\bin\a5c-hooks-proxy.exe"
-        if (Test-Path $localProxy) {
-            $Proxy = $localProxy
-        }
-    }
-}
-
-# ---------------------------------------------------------------------------
-# Capture stdin and delegate to hooks-proxy
-# ---------------------------------------------------------------------------
-
-$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 ($Proxy) {
-        Get-Content $InputFile | & $Proxy invoke --adapter copilot --handler "babysitter hook:run --harness unified --hook-type user-prompt-submitted --json" --json 2>$stderrLog | Out-Null
-    } else {
-        Get-Content $InputFile | & npx -y "@a5c-ai/hooks-proxy-cli@$SdkVersion" invoke --adapter copilot --handler "babysitter hook:run --harness unified --hook-type user-prompt-submitted --json" --json 2>$stderrLog | Out-Null
-    }
-} catch {}
-
-Remove-Item $InputFile -Force -ErrorAction SilentlyContinue
-
-exit 0

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,49 @@
     "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\"",
+        "bash": "./hooks/babysitter-proxied-user-prompt-submitted.sh",
+        "powershell": "./hooks/babysitter-proxied-user-prompt-submitted.ps1",
+        "timeoutSec": 15
+      }
+    ],
+    "preToolUse": [
+      {
+        "type": "command",
+        "bash": "./hooks/babysitter-proxied-pre-tool-use.sh",
+        "powershell": "./hooks/babysitter-proxied-pre-tool-use.ps1",
         "timeoutSec": 30
       }
     ],
-    "userPromptSubmitted": [
+    "postToolUse": [
       {
         "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-post-tool-use.sh",
+        "powershell": "./hooks/babysitter-proxied-post-tool-use.ps1",
+        "timeoutSec": 30
+      }
+    ],
+    "PreCompact": [
+      {
+        "type": "command",
+        "bash": "./hooks/babysitter-proxied-pre-compact.sh",
+        "powershell": "./hooks/babysitter-proxied-pre-compact.ps1",
+        "timeoutSec": 30
+      }
+    ],
+    "sessionEnd": [
+      {
+        "type": "command",
+        "bash": "./hooks/babysitter-proxied-session-end.sh",
+        "powershell": "./hooks/babysitter-proxied-session-end.ps1",
+        "timeoutSec": 30
       }
     ]
   }

package/package.json

@@ -1,50 +1,49 @@
 {
   "name": "@a5c-ai/babysitter-github",
-  "version": "5.0.1-staging.d73033a7",
-  "description": "Babysitter orchestration plugin for GitHub Copilot CLI with lifecycle hooks and SDK-managed process-library bootstrapping",
+  "version": "5.0.1-staging.daf8e165bc4a",
+  "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",
-    "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"
+    "deploy:staging": "npm publish --access public --tag staging",
+    "plugin:install": "node bin/install.js --global",
+    "plugin:uninstall": "node bin/uninstall.js --global",
+    "team:install": "node scripts/team-install.js"
   },
   "bin": {
     "babysitter-github": "bin/cli.js"
   },
   "files": [
-    "plugin.json",
+    "bin/",
     "hooks.json",
+    "AGENTS.md",
     "hooks/",
     "skills/",
-    "bin/",
+    "commands/",
     "scripts/",
+    "plugin.json",
+    "README.md",
     "versions.json",
-    "AGENTS.md",
-    "commands/",
-    ".github/",
-    "README.md"
+    "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.daf8e165bc4a"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/a5c-ai/babysitter"
+    "url": "git+https://github.com/a5c-ai/babysitter-github-copilot.git"
   },
-  "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-github#readme",
-  "dependencies": {
-    "@a5c-ai/babysitter-sdk": "5.0.1-staging.d73033a7"
+  "homepage": "https://github.com/a5c-ai/babysitter-github-copilot#readme",
+  "bugs": {
+    "url": "https://github.com/a5c-ai/babysitter-github-copilot/issues"
   }
 }

package/plugin.json

@@ -1,10 +1,9 @@
 {
   "name": "babysitter",
-  "version": "5.0.1-staging.d73033a7",
-  "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.daf8e165bc4a",
+  "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/create-release-tag.mjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+
+function run(command, args) {
+  const result = spawnSync(command, args, { encoding: 'utf8', stdio: 'inherit' });
+  if (result.status !== 0) process.exit(result.status || 1);
+}
+
+const branch = process.env.GITHUB_REF_NAME || 'develop';
+const sha = (process.env.GITHUB_SHA || '').slice(0, 12);
+const version = existsSync('package.json') ? JSON.parse(readFileSync('package.json', 'utf8')).version : JSON.parse(readFileSync('versions.json', 'utf8')).sdkVersion;
+const normalized = String(version).replace(/[^0-9A-Za-z._-]/g, '-');
+const tag = 'release/' + branch + '/v' + normalized + '-' + sha;
+run('git', ['config', 'user.name', 'github-actions[bot]']);
+run('git', ['config', 'user.email', 'github-actions[bot]@users.noreply.github.com']);
+run('git', ['tag', tag]);
+run('git', ['push', 'origin', tag]);

package/scripts/publish-from-tag.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, { stdio: options.stdio || 'inherit', encoding: options.encoding });
+  if (result.status !== 0 && !options.allowFailure) process.exit(result.status || 1);
+  return result;
+}
+
+function npmView(packageSpec) {
+  return run('npm', ['view', packageSpec, 'version'], { allowFailure: true, stdio: 'pipe', encoding: 'utf8' }).status === 0;
+}
+
+const pkg = JSON.parse(readFileSync('package.json', 'utf8'));
+const ref = process.env.GITHUB_REF_NAME || '';
+const branch = ref.split('/')[1] || 'develop';
+const tag = branch === 'main' ? 'latest' : branch;
+
+if (!process.env.NODE_AUTH_TOKEN) {
+  console.log('NODE_AUTH_TOKEN is not configured; skipping npm publish.');
+  process.exit(0);
+}
+
+if (npmView(pkg.name + '@' + pkg.version)) {
+  console.log(pkg.name + '@' + pkg.version + ' already exists; ensuring dist-tag ' + tag + '.');
+  run('npm', ['dist-tag', 'add', pkg.name + '@' + pkg.version, tag], { allowFailure: true });
+  process.exit(0);
+}
+
+for (const field of ['dependencies', 'peerDependencies', 'optionalDependencies']) {
+  for (const [name, version] of Object.entries(pkg[field] || {})) {
+    if (!name.startsWith('@a5c-ai/') || version.startsWith('^') || version.startsWith('~') || version === '*' || version.startsWith('workspace:')) continue;
+    if (!npmView(name + '@' + version)) {
+      console.log('Required internal dependency ' + name + '@' + version + ' is not published yet; skipping npm publish.');
+      process.exit(0);
+    }
+  }
+}
+
+run('npm', ['publish', '--access', 'public', '--tag', tag]);

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/babysit/SKILL.md

@@ -1,14 +1,24 @@
 ---
 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.)
+description: Execute via @babysitter. Use this skill when asked to babysit a task, do anything that is structured process-driven (even a loop) or whenever it is called explicitly. (babysit, babysitter, with a process, orchestrate, orchestrate a run, workflow, loop until, etc.)
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+version: 0.1.3
 ---
 
 # babysit
 
-Orchestrate `.a5c/runs/<runId>/` through iterative execution.
+Follow the commands below exactly. but apply judgement and creativity to get the job done. no matter how small or simple the task may seem, you must use the babysitter SDK and run lifecycle to execute it. This is non-negotiable. If you are asked to do something that seems like it could be done with a simple tool call, you must still use the babysitter SDK to create a run, define tasks, execute them, and complete the run. This is how you will learn and demonstrate mastery of the babysitter system. Always follow the full process, even for trivial tasks.
+
+Subagents that need a scratch checkout or working directory must create it under
+`/tmp/<descriptive-name>/`, not under `.a5c/runs/<runId>/work`. Before returning
+deliverables, validate that no run-dir worktree was left behind, for example:
+
+```bash
+find .a5c/runs -maxdepth 3 -name work -type d -print
+```
+
+That command should print nothing. If it prints a non-empty work directory, move
+or remove only the scratch data you created before returning.
 
 ## Dependencies
 
@@ -17,13 +27,19 @@ Orchestrate `.a5c/runs/<runId>/` through iterative execution.
 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')}")
-npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION
-
-CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"
+SDK_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('${COPILOT_PLUGIN_DIR}/versions.json','utf8')).sdkVersion||'latest')}catch{console.log('latest')}")
+npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION || npm i -g @a5c-ai/babysitter-sdk@latest
+
+if command -v babysitter >/dev/null 2>&1 && babysitter --version >/dev/null 2>&1; then
+  CLI="babysitter"
+else
+  CLI="npm exec --yes --package @a5c-ai/babysitter-sdk@$SDK_VERSION -- babysitter"
+fi
 ```
 
-If `babysitter` is already installed globally at the correct version, you may use `CLI="babysitter"` instead.
+If the pinned version fails to install (e.g. not yet published), the fallback installs `latest`.
+
+If a stale or broken global shim fails with `MODULE_NOT_FOUND`, repair it with `npm rm -g @a5c-ai/babysitter @a5c-ai/babysitter-sdk && npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION`, then re-run `babysitter --version`.
 
 ### jq
 
@@ -31,46 +47,16 @@ Make sure `jq` is installed and available in the path. If not, install it.
 
 ## Instructions
 
-Run the following command to get full orchestration instructions:
+Run the following command to get full instructions:
 
 ```bash
-$CLI instructions:babysit-skill --harness github-copilot --json
+$CLI instructions:babysit-skill --harness github-copilot --interactive
 ```
 
-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. `$CLI run:iterate --json` -- get pending actions
-2. For each pending action: execute it (run tasks, post results via `task:post`)
-3. `$CLI 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
+For non-interactive mode (running with `-p` flag or no AskUserQuestion tool):
 
 ```bash
-# Initial iterate
-RESULT=$($CLI 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=$($CLI run:iterate --run-id "$RUN_ID" --json)
-  STATUS=$(echo "$RESULT" | jq -r '.status')
-done
+$CLI instructions:babysit-skill --harness github-copilot --no-interactive
 ```
+
+Follow the instructions returned by the command above to orchestrate the run.