@a5c-ai/babysitter-cursor 0.1.1-staging.400de59e

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,48 @@
+{
+  "name": "@a5c-ai/babysitter-cursor",
+  "version": "0.1.1-staging.400de59e",
+  "description": "Babysitter orchestration plugin for Cursor IDE with SDK-managed process-library bootstrapping and in-turn iteration model",
+  "scripts": {
+    "test": "echo \"No tests yet\"",
+    "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.400de59e"
+  }
+}

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/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,17 @@
+---
+name: assimilate
+description: Assimilate an external methodology, repo, spec, or process into a Babysitter workflow.
+---
+
+# assimilate
+
+Load and use the installed `babysit` skill.
+
+Resolve the request in `assimilate` mode:
+
+- treat everything after `$assimilate` as the target repo, methodology, spec,
+  or reference to ingest
+- follow the `babysit` skill contract for research, process-library discovery,
+  and orchestration
+- do not create a separate command surface here; this skill only forwards into
+  `babysit`

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,17 @@
+---
+name: call
+description: Start a new Babysitter orchestration run from Cursor IDE/CLI.
+---
+
+# call
+
+Load and use the installed `babysit` skill.
+
+Resolve the request in `call` mode:
+
+- treat everything after `$call` as the initial Babysitter request for a new
+  orchestration run
+- create the process, create the run, and enter the Babysitter loop
+- using this always means the user meant an interactive run
+- do not create a separate command surface here; this skill only forwards into
+  `babysit`

package/skills/doctor/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: doctor
+description: Diagnose Babysitter run health, integration issues, or orchestration failures.
+---
+
+# doctor
+
+Load and use the installed `babysit` skill.
+
+Resolve the request in `doctor` mode:
+
+- treat everything after `$doctor` as the run selector, subsystem, or problem
+  statement to diagnose
+- focus on run health, orchestration correctness, and recovery guidance
+- do not create a separate command surface here; this skill only forwards into
+  `babysit`

package/skills/help/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: help
+description: Explain Babysitter Cursor IDE/CLI usage, modes, setup, or operational behavior.
+---
+
+# help
+
+Load and use the installed `babysit` skill.
+
+Resolve the request in `help` mode:
+
+- treat everything after `$help` as the help target or question
+- focus on explaining the right Babysitter flow or integration surface
+- do not create a separate command surface here; this skill only forwards into
+  `babysit`

package/skills/observe/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: observe
+description: Observe, inspect, or monitor a Babysitter run.
+---
+
+# observe
+
+Load and use the installed `babysit` skill.
+
+Resolve the request in `observe` mode:
+
+- treat everything after `$observe` as the run selector or observation target
+- focus on inspection, monitoring, and state visibility
+- do not create a separate command surface here; this skill only forwards into
+  `babysit`

package/skills/plan/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: plan
+description: Plan a Babysitter workflow without executing the run.
+---
+
+# plan
+
+Load and use the installed `babysit` skill.
+
+Resolve the request in `plan` mode:
+
+- treat everything after `$plan` as the planning request
+- focus on building the best process possible without creating and running the
+  actual run unless the user explicitly changes mode
+- do not create a separate command surface here; this skill only forwards into
+  `babysit`

package/skills/resume/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: resume
+description: Resume an existing Babysitter run from Cursor IDE/CLI.
+---
+
+# resume
+
+Load and use the installed `babysit` skill.
+
+Resolve the request in `resume` mode:
+
+- treat everything after `$resume` as the run selector or run id
+- focus on restoring the orchestration context and continuing the run honestly
+- do not create a separate command surface here; this skill only forwards into
+  `babysit`

package/skills/retrospect/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: retrospect
+description: Summarize or retrospect on one or more completed Babysitter runs.
+argument-hint: "[run-id...] [--all] Optional run IDs or --all for all runs"
+---
+
+# retrospect
+
+Load and use the installed `babysit` skill.
+
+Resolve the request in `retrospect` mode:
+
+- treat everything after `$retrospect` as the run selector(s) to summarize
+- focus on the run history, outcomes, lessons, and gaps
+- do not create a separate command surface here; this skill only forwards into
+  `babysit`
+
+## Phase 1: Resolve Target Run(s)
+
+- If `--all` or "all" is present in args: list all runs via `ls -lt .a5c/runs/` and collect all completed/failed run IDs
+- If multiple run IDs are provided: use all of them
+- Otherwise: existing behavior (resolve the latest single run)
+- Use interactive prompts to confirm run selection when possible
+
+## Phase 2: Load Run Data
+
+For each selected run, load:
+- `run.json` metadata
+- Journal events
+- Task definitions and results
+- State snapshots
+
+## Phase 3: Analysis
+
+Perform standard per-run analysis (outcomes, process effectiveness, suggestions).
+
+### Cross-Run Pattern Analysis (multi-run mode)
+
+When analyzing multiple runs, additionally cover:
+- **Common failure modes** across runs
+- **Velocity trends** (tasks/time across runs)
+- **Process evolution** (how processes changed over time)
+- **Repeated breakpoint patterns**
+
+## Phase 4: Suggestions
+
+Provide actionable suggestions for process improvements, optimizations, and fixes.
+
+## Phase 5: Implementation
+
+If the user agrees, implement improvements to processes, skills, or configuration.
+
+## Phase 6: Cleanup Suggestion
+
+After analysis, suggest: "Consider running `babysitter cleanup` (or `/babysitter:cleanup`) to clean up old run data and reclaim disk space."

package/skills/user-install/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: user-install
+description: Install the user-level Babysitter Cursor IDE/CLI setup.
+---
+
+# user-install
+
+Load and use the installed `babysit` skill.
+
+Resolve the request in `user-install` mode:
+
+- treat everything after `$user-install` as the user-setup request
+- focus on user profile, user-level install, and personal defaults
+- do not create a separate command surface here; this skill only forwards into
+  `babysit`

package/versions.json

@@ -0,0 +1,3 @@
+{
+  "sdkVersion": "0.0.184-staging.400de59e"
+}