@a5c-ai/babysitter-cursor 0.1.1-staging.0825aadb

package/hooks/stop-hook.ps1

@@ -0,0 +1,72 @@
+# Babysitter Stop Hook for Cursor IDE/CLI (PowerShell)
+# Drives the orchestration loop by checking run state on session stop.
+#
+# Protocol:
+#   Input:  JSON via stdin (session context)
+#   Output: JSON via stdout (with optional continue/stop signal)
+#   Stderr: debug/log output only
+#   Exit 0: success
+
+$ErrorActionPreference = "Stop"
+
+$PluginRoot = if ($env:CURSOR_PLUGIN_ROOT) { $env:CURSOR_PLUGIN_ROOT } else { Split-Path -Parent $PSScriptRoot }
+$StateDir = if ($env:BABYSITTER_STATE_DIR) { $env:BABYSITTER_STATE_DIR } else { Join-Path $PWD ".a5c" }
+
+$env:CURSOR_PLUGIN_ROOT = $PluginRoot
+$env:BABYSITTER_STATE_DIR = $StateDir
+
+$LogDir = if ($env:BABYSITTER_LOG_DIR) { $env:BABYSITTER_LOG_DIR } else { Join-Path $PluginRoot ".a5c\logs" }
+$LogFile = Join-Path $LogDir "babysitter-stop-hook.log"
+New-Item -ItemType Directory -Path $LogDir -Force -ErrorAction SilentlyContinue | Out-Null
+
+function Write-Blog {
+    param([string]$Message)
+    $ts = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
+    Add-Content -Path $LogFile -Value "[INFO] $ts $Message" -ErrorAction SilentlyContinue
+    if (Get-Command babysitter -ErrorAction SilentlyContinue) {
+        & babysitter log --type hook --label "hook:stop" --message $Message --source shell-hook 2>$null
+    }
+}
+
+Write-Blog "Hook script invoked"
+Write-Blog "PLUGIN_ROOT=$PluginRoot"
+Write-Blog "STATE_DIR=$StateDir"
+
+# Resolve babysitter CLI
+$useFallback = $false
+if (-not (Get-Command babysitter -ErrorAction SilentlyContinue)) {
+    $localBin = Join-Path $env:USERPROFILE ".local\bin\babysitter.cmd"
+    if (Test-Path $localBin) {
+        $env:PATH = "$(Split-Path $localBin);$env:PATH"
+    } else {
+        $versionsFile = Join-Path $PluginRoot "versions.json"
+        try {
+            $script:SdkVersion = (Get-Content $versionsFile -Raw | ConvertFrom-Json).sdkVersion
+            if (-not $script:SdkVersion) { $script:SdkVersion = "latest" }
+        } catch {
+            $script:SdkVersion = "latest"
+        }
+        $useFallback = $true
+    }
+}
+
+# Capture stdin
+$InputFile = [System.IO.Path]::GetTempFileName()
+$input | Out-File -FilePath $InputFile -Encoding utf8
+
+Write-Blog "Hook input received"
+
+$stderrLog = Join-Path $LogDir "babysitter-stop-hook-stderr.log"
+
+if ($useFallback) {
+    $Result = Get-Content $InputFile | & npx -y "@a5c-ai/babysitter-sdk@$script:SdkVersion" hook:run --hook-type stop --harness cursor --plugin-root $PluginRoot --state-dir $StateDir --json 2>$stderrLog
+} else {
+    $Result = Get-Content $InputFile | & babysitter hook:run --hook-type stop --harness cursor --plugin-root $PluginRoot --state-dir $StateDir --json 2>$stderrLog
+}
+$ExitCode = $LASTEXITCODE
+
+Write-Blog "CLI exit code=$ExitCode"
+
+Remove-Item $InputFile -Force -ErrorAction SilentlyContinue
+Write-Output $Result
+exit $ExitCode

package/hooks/stop-hook.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+# Babysitter Stop Hook for Cursor IDE/CLI
+# Drives the orchestration loop by checking run state on session stop.
+#
+# Protocol:
+#   Input:  JSON via stdin (session context)
+#   Output: JSON via stdout (with optional continue/stop signal)
+#   Stderr: debug/log output only
+#   Exit 0: success
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+STATE_DIR="${BABYSITTER_STATE_DIR:-${PWD}/.a5c}"
+LOG_DIR="${BABYSITTER_LOG_DIR:-$PLUGIN_ROOT/.a5c/logs}"
+LOG_FILE="$LOG_DIR/babysitter-stop-hook.log"
+
+export CURSOR_PLUGIN_ROOT="${CURSOR_PLUGIN_ROOT:-${PLUGIN_ROOT}}"
+export BABYSITTER_STATE_DIR="${STATE_DIR}"
+
+mkdir -p "$LOG_DIR" 2>/dev/null
+
+blog() {
+  local msg="$1"
+  local ts
+  ts="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  echo "[INFO] $ts $msg" >> "$LOG_FILE" 2>/dev/null
+  babysitter log --type hook --label "hook:stop" --message "$msg" --source shell-hook 2>/dev/null || true
+}
+
+blog "Hook script invoked"
+blog "PLUGIN_ROOT=$PLUGIN_ROOT"
+blog "STATE_DIR=$STATE_DIR"
+
+# Resolve babysitter CLI if not on PATH
+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")
+    babysitter() { npx -y "@a5c-ai/babysitter-sdk@${SDK_VERSION}" "$@"; }
+    export -f babysitter
+  fi
+fi
+
+INPUT_FILE=$(mktemp 2>/dev/null || echo "/tmp/cursor-stop-hook-$$.json")
+cat > "$INPUT_FILE"
+
+blog "Hook input received ($(wc -c < "$INPUT_FILE") bytes)"
+
+RESULT=$(babysitter hook:run \
+  --hook-type stop \
+  --harness cursor \
+  --plugin-root "$PLUGIN_ROOT" \
+  --state-dir "${BABYSITTER_STATE_DIR}" \
+  --json < "$INPUT_FILE" 2>"$LOG_DIR/babysitter-stop-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.json

@@ -0,0 +1,21 @@
+{
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "type": "command",
+        "bash": "bash \"./hooks/session-start.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/session-start.ps1\"",
+        "timeoutSec": 30
+      }
+    ],
+    "stop": [
+      {
+        "type": "command",
+        "bash": "bash \"./hooks/stop-hook.sh\"",
+        "powershell": "powershell -NoProfile -ExecutionPolicy Bypass -File \"./hooks/stop-hook.ps1\"",
+        "loop_limit": null
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@a5c-ai/babysitter-cursor",
+  "version": "0.1.1-staging.0825aadb",
+  "description": "Babysitter orchestration plugin for Cursor IDE with SDK-managed process-library bootstrapping and in-turn iteration model",
+  "scripts": {
+    "test": "node scripts/sync-command-surfaces.js --check",
+    "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-cursor": "bin/cli.js"
+  },
+  "files": [
+    ".cursor-plugin/",
+    ".cursorrules",
+    "bin/",
+    "commands/",
+    "hooks/",
+    "hooks.json",
+    "plugin.json",
+    "scripts/",
+    "skills/",
+    "versions.json"
+  ],
+  "keywords": [
+    "babysitter",
+    "cursor",
+    "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-cursor#readme",
+  "dependencies": {
+    "@a5c-ai/babysitter-sdk": "0.0.184-staging.0825aadb"
+  }
+}

package/plugin.json

@@ -0,0 +1,24 @@
+{
+  "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": "a5c.ai",
+  "license": "MIT",
+  "hooks": "hooks/hooks-cursor.json",
+  "commands": "commands/",
+  "skills": "skills/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/a5c-ai/babysitter"
+  },
+  "keywords": [
+    "orchestration",
+    "workflow",
+    "automation",
+    "event-sourced",
+    "hooks",
+    "cursor",
+    "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-cursor 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 Cursor plugin command changes were needed.`);
+    return;
+  }
+
+  console.log(`[${LABEL}] updated ${updated} Cursor plugin file(s).`);
+}
+
+main();

package/scripts/team-install.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  copyPluginBundle,
+  ensureGlobalProcessLibrary,
+  ensureMarketplaceEntry,
+  installCursorSurface,
+  warnWindowsHooks,
+  writeJson,
+} = require('../bin/install-shared');
+
+function parseArgs(argv) {
+  const args = {
+    workspace: process.cwd(),
+    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] === '--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 installInfo = {
+    installedAt: new Date().toISOString(),
+    packageRoot,
+    workspaceRoot,
+    pluginRoot: workspacePluginRoot,
+    marketplacePath: workspaceMarketplacePath,
+  };
+
+  if (args.dryRun) {
+    console.log(JSON.stringify({
+      ok: true,
+      dryRun: true,
+      installInfo,
+    }, null, 2));
+    return;
+  }
+
+  copyPluginBundle(packageRoot, workspacePluginRoot);
+  ensureMarketplaceEntry(workspaceMarketplacePath, workspacePluginRoot);
+  installCursorSurface(packageRoot, path.join(workspaceRoot, '.cursor'));
+
+  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,
+      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,81 @@
+---
+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')}")
+```
+
+Then ensure the CLI is installed:
+
+```bash
+sudo npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION
+```
+
+Use the CLI alias: `CLI="babysitter"`
+
+**Alternatively:** `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 cursor --json
+```
+
+Follow the instructions returned by the command above to orchestrate the run.
+
+## Cursor -- In-Turn Loop Model
+
+**IMPORTANT**: Cursor does NOT have a Stop hook that can drive the orchestration
+loop between turns. Unlike Claude Code, there is no hook mechanism to
+automatically re-enter the orchestration loop.
+
+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).