@a5c-ai/babysitter-github 5.0.1-staging.e4f17eff → 5.0.1-staging.e920fef118ef

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.e4f17eff",
-  "description": "Babysitter orchestration plugin for GitHub Copilot CLI with lifecycle hooks and SDK-managed process-library bootstrapping",
+  "version": "5.0.1-staging.e920fef118ef",
+  "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.e920fef118ef"
+  },
   "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.e4f17eff"
+  "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.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.e920fef118ef",
+  "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,12 @@
 ---
 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.)
+  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.)
 ---
 
 # 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.
 
 ## Dependencies
 

package/skills/call/SKILL.md

@@ -5,4 +5,8 @@ description: Orchestrate a babysitter run. use this command to start babysitting
 
 # call
 
-Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). Then continue executing the returned instructions in this same turn. Do not stop after the Skill tool returns; carry the requested run through to completion proof.
+
+User arguments for this command:
+
+$ARGUMENTS

package/skills/cleanup/SKILL.md

@@ -0,0 +1,43 @@
+---
+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)
+
+CRITICAL: The cleanup MUST follow this exact phase order. Do NOT delete any run before Phase 2 completes.
+
+Phase 1 — Scan:
+- Scan .a5c/runs/ for all runs
+- Classify each as terminal (completed/failed) or active (in-progress/created)
+- Identify terminal runs older than the keep-days threshold as removal candidates
+- Never mark active/in-progress runs for removal
+- Count and report: total runs, terminal, active, removal candidates, disk usage
+
+Phase 2 — Aggregate insights (BEFORE any deletion):
+- For EVERY removal candidate, read its run.json and journal/ events
+- Extract: processId, prompt, status, event count, created date, task summaries
+- Group by process type and extract patterns (retry counts, convergence behavior, failure modes)
+- Append a new dated section to docs/run-history-insights.md with:
+  - Summary statistics (runs removed, disk freed, runs retained)
+  - Run categories with counts and descriptions
+  - Key patterns observed (multi-batch convergence, retry behavior, etc.)
+  - What worked well / what didn't from the run data
+- This file MUST be written and verified before proceeding to Phase 3
+
+Phase 3 — Confirm removal:
+- In interactive mode, show the user what will be removed via a breakpoint
+- In non-interactive mode (yolo), proceed with defaults
+- In dry-run mode, stop here and show what would be removed
+
+Phase 4 — Remove:
+- Delete the terminal runs older than keep-days threshold
+- Identify and remove orphaned process files not referenced by remaining runs
+- Show remaining run count and disk usage after cleanup

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