@a5c-ai/babysitter-opencode 5.0.1-staging.dd0c1ccc → 5.0.1-staging.e195a4980892

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/README.md +17 -19
  2. package/bin/install-shared.js +4 -4
  3. package/commands/call.md +5 -1
  4. package/commands/check-forbidden-markers.md +68 -0
  5. package/commands/cleanup.md +37 -9
  6. package/commands/doctor.md +2 -3
  7. package/commands/help.md +2 -1
  8. package/commands/observe.md +6 -1
  9. package/commands/plan.md +11 -1
  10. package/commands/yolo.md +11 -7
  11. package/hooks/babysitter-proxied-session-created.js +4 -2
  12. package/hooks/babysitter-proxied-session-created.sh +0 -0
  13. package/hooks/babysitter-proxied-shell-env.js +4 -2
  14. package/hooks/babysitter-proxied-shell-env.sh +0 -0
  15. package/hooks/babysitter-proxied-stop-hook.sh +3 -0
  16. package/hooks/babysitter-proxied-tool-execute-after.js +4 -2
  17. package/hooks/babysitter-proxied-tool-execute-after.sh +0 -0
  18. package/hooks/babysitter-proxied-tool-execute-before.js +4 -2
  19. package/hooks/babysitter-proxied-tool-execute-before.sh +0 -0
  20. package/hooks/hooks.json +0 -8
  21. package/package.json +6 -8
  22. package/plugin.json +1 -1
  23. package/scripts/create-release-tag.mjs +18 -0
  24. package/scripts/publish-from-tag.mjs +41 -0
  25. package/scripts/team-install.js +0 -0
  26. package/skills/accomplish-status/SKILL.md +8 -2
  27. package/skills/babysit/SKILL.md +13 -6
  28. package/skills/call/SKILL.md +5 -1
  29. package/skills/check-forbidden-markers/SKILL.md +69 -0
  30. package/skills/cleanup/SKILL.md +37 -9
  31. package/skills/doctor/SKILL.md +2 -3
  32. package/skills/help/SKILL.md +2 -1
  33. package/skills/observe/SKILL.md +6 -1
  34. package/skills/plan/SKILL.md +11 -1
  35. package/skills/yolo/SKILL.md +5 -1
  36. package/versions.json +2 -2
  37. package/hooks/babysitter-proxied-session-idle.js +0 -24
  38. package/hooks/babysitter-proxied-session-idle.sh +0 -3
  39. package/scripts/sync-command-docs.cjs +0 -107
  40. package/scripts/sync-command-surfaces.js +0 -52
package/README.md CHANGED
@@ -9,7 +9,7 @@ complex multi-step workflows -- powered by the Babysitter SDK.
9
9
  ## Plugin Structure
10
10
 
11
11
  ```
12
- plugins/babysitter-opencode/
12
+ artifacts/generated-plugins/opencode/
13
13
  bin/
14
14
  cli.cjs CLI entry point (babysitter-opencode command)
15
15
  install.cjs Installation script
@@ -36,31 +36,29 @@ plugins/babysitter-opencode/
36
36
 
37
37
  ### Prerequisites
38
38
 
39
- Install the Babysitter SDK CLI:
39
+ Install the Babysitter CLI once:
40
40
 
41
41
  ```bash
42
- npm install -g @a5c-ai/babysitter-sdk
42
+ npm install -g @a5c-ai/babysitter
43
43
  ```
44
44
 
45
- ### Method 1: npm global install (recommended)
45
+ ### Method 1: Babysitter harness install (recommended)
46
46
 
47
- ```bash
48
- npm install -g @a5c-ai/babysitter-opencode
49
- ```
50
-
51
- The `postinstall` script automatically copies the plugin into your current
52
- workspace's `.opencode/plugins/babysitter/` directory.
53
-
54
- To install into a specific workspace:
47
+ Use the SDK helper for scriptable global or workspace installs. This is the canonical path used by the installer tests and resolves to `npx --yes @a5c-ai/babysitter-opencode install ...` under the hood:
55
48
 
56
49
  ```bash
57
- babysitter-opencode install --workspace /path/to/project
50
+ # Global install
51
+ babysitter harness:install-plugin opencode
52
+
53
+ # Workspace install
54
+ babysitter harness:install-plugin opencode --workspace /path/to/project
58
55
  ```
59
56
 
60
- ### Method 2: Babysitter harness install
57
+ ### Method 2: Published package installer
61
58
 
62
59
  ```bash
63
- babysitter harness:install-plugin opencode
60
+ npx --yes @a5c-ai/babysitter-opencode install --global
61
+ npx --yes @a5c-ai/babysitter-opencode install --workspace /path/to/project
64
62
  ```
65
63
 
66
64
  ### Method 3: Manual copy
@@ -94,13 +92,13 @@ OpenCode config directory (`<userDataPath>/opencode/plugins/babysitter/`).
94
92
 
95
93
  ```bash
96
94
  # Auto-detects Accomplish during standard install
97
- npm install -g @a5c-ai/babysitter-opencode
95
+ npx --yes @a5c-ai/babysitter-opencode install --global
98
96
 
99
97
  # Or target Accomplish explicitly
100
- babysitter-opencode install --accomplish
98
+ npx --yes @a5c-ai/babysitter-opencode install --accomplish
101
99
 
102
100
  # Install to both standalone OpenCode and Accomplish
103
- babysitter-opencode install --global --accomplish
101
+ npx --yes @a5c-ai/babysitter-opencode install --global --accomplish
104
102
  ```
105
103
 
106
104
  Accomplish stores OpenCode config at platform-specific locations:
@@ -206,7 +204,7 @@ babysitter process-library:active --json
206
204
  ## Running Tests
207
205
 
208
206
  ```bash
209
- cd plugins/babysitter-opencode
207
+ cd artifacts/generated-plugins/opencode
210
208
  npm test
211
209
  ```
212
210
 
@@ -29,7 +29,7 @@ function writeFileIfChanged(filePath, contents) {
29
29
  try {
30
30
  const existing = fs.readFileSync(filePath, 'utf8');
31
31
  if (existing === contents) return false;
32
- } catch {}
32
+ } catch (e) { process.stderr.write('[extension-mux] file read failed for ' + filePath + ', overwriting: ' + (e instanceof Error ? e.message : String(e)) + '\n'); }
33
33
  fs.mkdirSync(path.dirname(filePath), { recursive: true });
34
34
  fs.writeFileSync(filePath, contents);
35
35
  return true;
@@ -82,7 +82,7 @@ function writeJson(filePath, value) {
82
82
  function ensureExecutable(filePath) {
83
83
  try {
84
84
  fs.chmodSync(filePath, 0o755);
85
- } catch {}
85
+ } catch (e) { process.stderr.write('[extension-mux] chmod failed for ' + filePath + ': ' + (e instanceof Error ? e.message : String(e)) + '\n'); }
86
86
  }
87
87
 
88
88
  function normalizeMarketplaceSourcePath(source, marketplacePath) {
@@ -104,7 +104,7 @@ function ensureMarketplaceEntry(marketplacePath, pluginRoot) {
104
104
  name: PLUGIN_NAME,
105
105
  source: relSource,
106
106
  description: "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
107
- version: "5.0.0",
107
+ version: "5.0.1-staging.e195a4980892",
108
108
  author: { name: "a5c.ai" },
109
109
  };
110
110
  if (idx >= 0) marketplace.plugins[idx] = entry;
@@ -147,7 +147,7 @@ function resolveCliCommand(packageRoot) {
147
147
  const versionsPath = path.join(packageRoot, 'versions.json');
148
148
  const versions = readJson(versionsPath) || {};
149
149
  const ver = versions.sdkVersion || 'latest';
150
- return `npx -y @a5c-ai/babysitter-sdk@${ver}`;
150
+ return `npm exec --yes --package @a5c-ai/babysitter-sdk@${ver} -- babysitter`;
151
151
  }
152
152
 
153
153
  function runCli(packageRoot, cliArgs, options = {}) {
package/commands/call.md CHANGED
@@ -4,4 +4,8 @@ argument-hint: Specific instructions for the run.
4
4
  allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
5
5
  ---
6
6
 
7
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
7
+ 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.
8
+
9
+ User arguments for this command:
10
+
11
+ $ARGUMENTS
@@ -0,0 +1,68 @@
1
+ ---
2
+ description: Pre-deploy gate that scans built JS chunks for forbidden substring markers (saga-era / obsolete code paths) listed in a project-local forbidden-markers.txt
3
+ argument-hint: "[--markers-file <path>] [--chunks-dir <path>] [--json] Optional overrides; defaults are project-relative."
4
+ allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
5
+ ---
6
+
7
+ Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). Compose the gate from the shared helper at `library/processes/shared/forbidden-markers-scanner.js` (issue #477).
8
+
9
+ ## What this gate does
10
+
11
+ Reads a list of literal substring markers from `scripts/forbidden-markers.txt` (blank lines and `#`-prefixed comments stripped) and greps every `.js` chunk under `.vercel/output/static/_next/static/chunks/` (Next.js / Vercel default; configurable) for any occurrence. Reports structured hits per `(marker, chunk)` pair with occurrence counts. Designed to chain between `vercel build --prod` and `vercel deploy --prod`.
12
+
13
+ Use this gate when a refactor or restart-from-baseline replaced load-bearing code paths and you need a structural guarantee the obsolete symbols never re-ship. Burned-in evidence: cookbook VI-9 / VI-12 near-miss revivals during the 2026-05 iOS-Safari saga; the prototype lives at `cookbook/scripts/check-no-forbidden.mjs` and shipped two upstream contributions before being generalized as this gate.
14
+
15
+ ## When to use
16
+
17
+ - **Pre-deploy.** Insert after build, before deploy. Block the deploy when `ok: false`.
18
+ - **Post-restart.** After a baseline rollback + step-by-step re-add, snapshot the saga-era markers in `forbidden-markers.txt` and let CI hold the line.
19
+ - **Post-refactor.** When old helper / handler / module names must not coexist with the new ones in the same bundle.
20
+
21
+ ## Expected config locations
22
+
23
+ - `scripts/forbidden-markers.txt` — one marker per line, `#` for comments. The list is the contract; the gate is mechanical. Commit this file to source control.
24
+ - `.vercel/output/static/_next/static/chunks/` — default scan target. Override for non-Vercel frameworks via the `--chunks-dir` flag or the `chunksDir` task input.
25
+
26
+ A missing markers file is a no-op (`ok: true`, `reason: 'missing-markers-file'`) — misconfiguration is never a deploy block. A missing chunks directory is likewise a no-op (`reason: 'missing-chunks-dir'`) so the gate is safe to chain into `check:all` before the build runs.
27
+
28
+ ## Exit semantics
29
+
30
+ | Reason | `ok` | Deploy decision |
31
+ |-------------------------|--------|--------------------------------|
32
+ | `missing-markers-file` | true | Pass (no gate active) |
33
+ | `missing-chunks-dir` | true | Pass (run before build) |
34
+ | `empty-markers` | true | Pass (list is empty) |
35
+ | `no-chunks` | true | Pass (nothing to scan) |
36
+ | `clean` | true | Pass — proceed to deploy |
37
+ | `hits` | false | **BLOCK** — surface hits, ask for triage |
38
+
39
+ For each hit, the gate emits `{ marker, chunk, count }` so the operator sees the exact marker string, the absolute chunk path, and the number of occurrences in that chunk. Multiple hits across chunks for the same marker are reported separately.
40
+
41
+ ## Programmatic surface
42
+
43
+ ```js
44
+ import { scanForbiddenMarkers, checkForbiddenMarkersTask } from '@a5c-ai/babysitter-library/processes/shared';
45
+
46
+ // Direct call:
47
+ const result = await scanForbiddenMarkers({
48
+ markersFile: 'scripts/forbidden-markers.txt',
49
+ chunksDir: '.vercel/output/static/_next/static/chunks',
50
+ });
51
+ if (!result.ok) {
52
+ // result.hits: Array<{ marker, chunk, count }>
53
+ // result.reason === 'hits'
54
+ process.exit(1);
55
+ }
56
+
57
+ // Or dispatched as a babysitter task:
58
+ const gate = await ctx.task(checkForbiddenMarkersTask, {
59
+ projectDir: '.',
60
+ // markersFile / chunksDir are inferred from projectDir if omitted
61
+ });
62
+ ```
63
+
64
+ ## Reference
65
+
66
+ - Issue: https://github.com/a5c-ai/babysitter/issues/477
67
+ - Helper module: `library/processes/shared/forbidden-markers-scanner.js`
68
+ - Origin (cookbook prototype): `cookbook/scripts/check-no-forbidden.mjs` (81 lines)
@@ -6,15 +6,43 @@ allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSea
6
6
 
7
7
  Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
8
8
 
9
- Create and run a cleanup process using the process at `skills\babysit\process\cradle\cleanup-runs.js/processes/cleanup-runs.js`.
9
+ Resolve the active process library with:
10
+
11
+ ```bash
12
+ babysitter process-library:active --json
13
+ ```
14
+
15
+ Read `binding.dir` from that JSON and create/run the cleanup process from `cradle/cleanup-runs.js#process` relative to that active library root. Do not use plugin-cache-relative cradle paths.
10
16
 
11
17
  Implementation notes (for the process):
12
18
  - Parse arguments for `--dry-run` flag (if present, set dryRun: true in inputs) and `--keep-days N` (default: 7)
13
- - The process scans .a5c/runs/ for completed/failed runs, aggregates insights, writes summaries, then removes old data
14
- - Always show the user what will be removed before removing (in interactive mode via breakpoints)
15
- - In non-interactive mode (yolo), proceed with cleanup using defaults
16
- - The insights file goes to docs/run-history-insights.md
17
- - Only remove terminal runs (completed/failed) older than the keep-days threshold
18
- - Never remove active/in-progress runs
19
- - Remove orphaned process files not referenced by remaining runs
20
- - After cleanup, show remaining run count and disk usage
19
+
20
+ CRITICAL: The cleanup MUST follow this exact phase order. Do NOT delete any run before Phase 2 completes.
21
+
22
+ Phase 1 Scan:
23
+ - Scan .a5c/runs/ for all runs
24
+ - Classify each as terminal (completed/failed) or active (in-progress/created)
25
+ - Identify terminal runs older than the keep-days threshold as removal candidates
26
+ - Never mark active/in-progress runs for removal
27
+ - Count and report: total runs, terminal, active, removal candidates, disk usage
28
+
29
+ Phase 2 — Aggregate insights (BEFORE any deletion):
30
+ - For EVERY removal candidate, read its run.json and journal/ events
31
+ - Extract: processId, prompt, status, event count, created date, task summaries
32
+ - Group by process type and extract patterns (retry counts, convergence behavior, failure modes)
33
+ - Append a new dated section to docs/run-history-insights.md with:
34
+ - Summary statistics (runs removed, disk freed, runs retained)
35
+ - Run categories with counts and descriptions
36
+ - Key patterns observed (multi-batch convergence, retry behavior, etc.)
37
+ - What worked well / what didn't from the run data
38
+ - This file MUST be written and verified before proceeding to Phase 3
39
+
40
+ Phase 3 — Confirm removal:
41
+ - In interactive mode, show the user what will be removed via a breakpoint
42
+ - In non-interactive mode (yolo), proceed with defaults
43
+ - In dry-run mode, stop here and show what would be removed
44
+
45
+ Phase 4 — Remove:
46
+ - Delete the terminal runs older than keep-days threshold
47
+ - Identify and remove orphaned process files not referenced by remaining runs
48
+ - Show remaining run count and disk usage after cleanup
@@ -156,7 +156,6 @@ If it exists:
156
156
  **Goal:** Inspect babysitter session files for health and detect runaway loops.
157
157
 
158
158
  - Search for session state files using Glob:
159
- - `plugins/babysitter/skills/babysit/state/*.md`
160
159
  - `.a5c/state/*.md`
161
160
  - `.a5c/state/*.json`
162
161
  - For each session state file found:
@@ -260,7 +259,7 @@ Mark as PASS if total size < 500MB and no files > 10MB. Mark as WARN if total si
260
259
 
261
260
  ### 10a. Hook Registration
262
261
 
263
- - Locate the plugin root. Check for `CLAUDE_PLUGIN_ROOT` env var, or search for `plugins/babysitter/hooks/hooks.json` by walking up from the current directory.
262
+ - Locate the plugin root. Check for `CLAUDE_PLUGIN_ROOT` env var first, or search for a babysitter `hooks.json` by walking up from the current directory.
264
263
  - If found, read `hooks.json` and verify:
265
264
  - A `Stop` hook entry exists with a command referencing `babysitter-stop-hook.sh`.
266
265
  - A `SessionStart` hook entry exists with a command referencing `babysitter-session-start-hook.sh`.
@@ -315,7 +314,7 @@ If the stop hook shows NO evidence of execution (no log entries, no journal even
315
314
 
316
315
  Perform these diagnostic steps in order and report the first failure found:
317
316
 
318
- 1. **Plugin not installed**: Check if `plugins/babysitter/` exists relative to the project root and if `CLAUDE_PLUGIN_ROOT` is set. If the plugin directory doesn't exist, report: "Plugin not installed — the babysitter plugin directory is missing."
317
+ 1. **Plugin not installed**: Check if `CLAUDE_PLUGIN_ROOT` is set or if a babysitter plugin directory exists relative to the project root. If neither exists, report: "Plugin not installed — the babysitter plugin directory is missing."
319
318
 
320
319
  2. **Plugin not enabled**: Check for Claude settings files:
321
320
  - `~/.claude/settings.json` — look for `babysitter` in `enabledPlugins`.
package/commands/help.md CHANGED
@@ -233,7 +233,8 @@ SECONDARY COMMANDS
233
233
  How it works: Runs npx @a5c-ai/babysitter-observer-dashboard@latest which watches
234
234
  the .a5c/runs/ directory (or a parent directory containing multiple projects) and
235
235
  serves a live dashboard. The process is blocking -- it runs until you stop it, and
236
- it prints the local URL to share with the user.
236
+ it prints the local URL to share with the user. Do not use `babysitter observe`
237
+ as a fallback; the core Babysitter CLI does not expose that subcommand.
237
238
 
238
239
  Example: /babysitter:observe
239
240
  (opens browser showing all runs with live-updating task
@@ -7,6 +7,11 @@ allowed-tools: Read, Grep, Write, Task, Bash
7
7
  Run the babysitter observer dashboard:
8
8
 
9
9
  1. Determine the watch directory — this is usually the project's container directory (the parent of the project dir), or the current working directory if not specified.
10
- 2. Launch the dashboard: `npx -y @a5c-ai/babysitter-observer-dashboard@latest --watch-dir <dir>`
10
+ 2. Launch the standalone dashboard package: `npx -y @a5c-ai/babysitter-observer-dashboard@latest --watch-dir <dir>`.
11
11
  3. This is a blocking process — it will keep running until stopped.
12
12
  4. Report the URL printed by the dashboard to the user, then open it in the browser.
13
+
14
+ Do not fall back to `babysitter observe`; the core Babysitter CLI does not expose
15
+ that subcommand. Some harness runtimes may provide a separate
16
+ `agent-platform observe` surface, but this skill uses the verified standalone
17
+ dashboard package.
package/commands/plan.md CHANGED
@@ -4,4 +4,14 @@ argument-hint: Specific instructions for the run.
4
4
  allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
5
5
  ---
6
6
 
7
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). focus on creating the best process possible, but without creating and running the actual run.
7
+ Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). Focus on creating the best process possible, but without creating and running the actual run.
8
+
9
+ Before drafting the process, run Phase 0 -- REUSE-AUDIT: extract keyword nouns and verbs from the request, scan for matching existing migrations, API routes, environment variables, SDK dependencies, and imports, honor `.a5c/reuse-audit.json` when present, and put a `Reuse-audit findings (REVIEW BEFORE PROCEEDING)` block before Phase 1 of the plan.
10
+
11
+ ## Process Shape Selection
12
+
13
+ Choose the process shape before authoring `process.js`:
14
+
15
+ - Use a flat phase list when the spec is well-defined, the work is wiring or composition, the bug class is already known if this is a fix, and execution should proceed sequentially through clear phases.
16
+ - Use a HYPOTHESES tree when the bug class is unknown, forensics are required, multiple causal models compete, and each hypothesis needs its own observations, falsifying observations, and follow-up phases.
17
+ - Rule of thumb: if the first phase is "investigate", use HYPOTHESES-tree mode. If the first phase is "implement X", use flat-phase-list mode.
package/commands/yolo.md CHANGED
@@ -1,7 +1,11 @@
1
- ---
2
- description: Orchestrate a babysitter run. use this command to start babysitting a complex workflow in a non-interactive mode, without any user interaction or breakpoints in the run.
3
- argument-hint: Specific instructions for the run.
4
- allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
5
- ---
6
-
7
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). but without any user interaction or breakpoints in the run.
1
+ ---
2
+ description: Orchestrate a babysitter run. use this command to start babysitting a complex workflow in a non-interactive mode, without any user interaction or breakpoints in the run.
3
+ argument-hint: Specific instructions for the run.
4
+ allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
5
+ ---
6
+
7
+ Run the Babysitter orchestration instructions directly through the CLI, without any user interaction or breakpoints. In Claude Code, use Bash to run `babysitter instructions:babysit-skill --harness claude-code --no-interactive`; in Codex, run `babysitter instructions:babysit-skill --harness codex --no-interactive`; in other harnesses, use the same command with that harness id. Then follow the returned instructions in this same turn until completion proof is produced. Do not stop after reading the instructions, do not invoke the Skill tool first, and use the non-interactive/no-breakpoints path when the instructions offer a mode choice.
8
+
9
+ User arguments for this command:
10
+
11
+ $ARGUMENTS
@@ -6,7 +6,7 @@ var readFileSync = require("fs").readFileSync;
6
6
 
7
7
  var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
8
8
  var stdin = "";
9
- try { stdin = readFileSync(0, "utf8"); } catch {}
9
+ try { stdin = readFileSync(0, "utf8"); } catch (e) { process.stderr.write("[extension-mux] stdin read failed: " + (e instanceof Error ? e.message : String(e)) + "\n"); }
10
10
  try {
11
11
  var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/session-start.sh")), {
12
12
  input: stdin,
@@ -20,5 +20,7 @@ try {
20
20
  });
21
21
  process.stdout.write(result);
22
22
  } catch (e) {
23
- process.stdout.write("{}\n");
23
+ process.stderr.write("[extension-mux] hook execution failed: " + (e instanceof Error ? e.message : String(e)) + "\n");
24
+ process.stdout.write(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }) + "\n");
25
+ process.exit(1);
24
26
  }
File without changes
@@ -6,7 +6,7 @@ var readFileSync = require("fs").readFileSync;
6
6
 
7
7
  var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
8
8
  var stdin = "";
9
- try { stdin = readFileSync(0, "utf8"); } catch {}
9
+ try { stdin = readFileSync(0, "utf8"); } catch (e) { process.stderr.write("[extension-mux] stdin read failed: " + (e instanceof Error ? e.message : String(e)) + "\n"); }
10
10
  try {
11
11
  var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/shell-env.sh")), {
12
12
  input: stdin,
@@ -20,5 +20,7 @@ try {
20
20
  });
21
21
  process.stdout.write(result);
22
22
  } catch (e) {
23
- process.stdout.write("{}\n");
23
+ process.stderr.write("[extension-mux] hook execution failed: " + (e instanceof Error ? e.message : String(e)) + "\n");
24
+ process.stdout.write(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }) + "\n");
25
+ process.exit(1);
24
26
  }
File without changes
@@ -0,0 +1,3 @@
1
+ #!/bin/bash
2
+ set -euo pipefail
3
+ babysitter hook:run --harness unified --hook-type stop --json
@@ -6,7 +6,7 @@ var readFileSync = require("fs").readFileSync;
6
6
 
7
7
  var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
8
8
  var stdin = "";
9
- try { stdin = readFileSync(0, "utf8"); } catch {}
9
+ try { stdin = readFileSync(0, "utf8"); } catch (e) { process.stderr.write("[extension-mux] stdin read failed: " + (e instanceof Error ? e.message : String(e)) + "\n"); }
10
10
  try {
11
11
  var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/post-tool-use.sh")), {
12
12
  input: stdin,
@@ -20,5 +20,7 @@ try {
20
20
  });
21
21
  process.stdout.write(result);
22
22
  } catch (e) {
23
- process.stdout.write("{}\n");
23
+ process.stderr.write("[extension-mux] hook execution failed: " + (e instanceof Error ? e.message : String(e)) + "\n");
24
+ process.stdout.write(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }) + "\n");
25
+ process.exit(1);
24
26
  }
File without changes
@@ -6,7 +6,7 @@ var readFileSync = require("fs").readFileSync;
6
6
 
7
7
  var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
8
8
  var stdin = "";
9
- try { stdin = readFileSync(0, "utf8"); } catch {}
9
+ try { stdin = readFileSync(0, "utf8"); } catch (e) { process.stderr.write("[extension-mux] stdin read failed: " + (e instanceof Error ? e.message : String(e)) + "\n"); }
10
10
  try {
11
11
  var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/pre-tool-use.sh")), {
12
12
  input: stdin,
@@ -20,5 +20,7 @@ try {
20
20
  });
21
21
  process.stdout.write(result);
22
22
  } catch (e) {
23
- process.stdout.write("{}\n");
23
+ process.stderr.write("[extension-mux] hook execution failed: " + (e instanceof Error ? e.message : String(e)) + "\n");
24
+ process.stdout.write(JSON.stringify({ error: e instanceof Error ? e.message : String(e) }) + "\n");
25
+ process.exit(1);
24
26
  }
File without changes
package/hooks/hooks.json CHANGED
@@ -26,14 +26,6 @@
26
26
  "timeoutMs": 30000
27
27
  }
28
28
  ],
29
- "session.idle": [
30
- {
31
- "type": "command",
32
- "script": "./hooks/babysitter-proxied-session-idle.js",
33
- "description": "babysitter SessionIdle hook",
34
- "timeoutMs": 30000
35
- }
36
- ],
37
29
  "shell.env": [
38
30
  {
39
31
  "type": "command",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@a5c-ai/babysitter-opencode",
3
- "version": "5.0.1-staging.dd0c1ccc",
3
+ "version": "5.0.1-staging.e195a4980892",
4
4
  "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
5
5
  "scripts": {
6
6
  "deploy": "npm publish --access public",
@@ -8,8 +8,7 @@
8
8
  "postinstall": "node bin/install.js",
9
9
  "preuninstall": "node bin/uninstall.js",
10
10
  "team:install": "node scripts/team-install.js",
11
- "test": "node test/integration.test.js",
12
- "sync:commands": "node scripts/sync-command-docs.cjs"
11
+ "test": "node test/integration.test.js"
13
12
  },
14
13
  "bin": {
15
14
  "babysitter-opencode": "bin/cli.js"
@@ -36,15 +35,14 @@
36
35
  "access": "public"
37
36
  },
38
37
  "dependencies": {
39
- "@a5c-ai/babysitter-sdk": "5.0.1-staging.dd0c1ccc"
38
+ "@a5c-ai/babysitter-sdk": "5.0.1-staging.e195a4980892"
40
39
  },
41
40
  "repository": {
42
41
  "type": "git",
43
- "url": "git+https://github.com/a5c-ai/babysitter.git",
44
- "directory": "plugins/babysitter-opencode"
42
+ "url": "git+https://github.com/a5c-ai/babysitter-opencode.git"
45
43
  },
46
- "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-opencode#readme",
44
+ "homepage": "https://github.com/a5c-ai/babysitter-opencode#readme",
47
45
  "bugs": {
48
- "url": "https://github.com/a5c-ai/babysitter/issues"
46
+ "url": "https://github.com/a5c-ai/babysitter-opencode/issues"
49
47
  }
50
48
  }
package/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "babysitter",
3
- "version": "5.0.1-staging.dd0c1ccc",
3
+ "version": "5.0.1-staging.e195a4980892",
4
4
  "description": "Orchestrate complex, multi-step workflows with event-sourced state management, hook-based extensibility, and human-in-the-loop approval",
5
5
  "author": "a5c.ai",
6
6
  "license": "MIT",
@@ -0,0 +1,18 @@
1
+ #!/usr/bin/env node
2
+ import { spawnSync } from 'node:child_process';
3
+ import { existsSync, readFileSync } from 'node:fs';
4
+
5
+ function run(command, args) {
6
+ const result = spawnSync(command, args, { encoding: 'utf8', stdio: 'inherit' });
7
+ if (result.status !== 0) process.exit(result.status || 1);
8
+ }
9
+
10
+ const branch = process.env.GITHUB_REF_NAME || 'develop';
11
+ const sha = (process.env.GITHUB_SHA || '').slice(0, 12);
12
+ const version = existsSync('package.json') ? JSON.parse(readFileSync('package.json', 'utf8')).version : JSON.parse(readFileSync('versions.json', 'utf8')).sdkVersion;
13
+ const normalized = String(version).replace(/[^0-9A-Za-z._-]/g, '-');
14
+ const tag = 'release/' + branch + '/v' + normalized + '-' + sha;
15
+ run('git', ['config', 'user.name', 'github-actions[bot]']);
16
+ run('git', ['config', 'user.email', 'github-actions[bot]@users.noreply.github.com']);
17
+ run('git', ['tag', tag]);
18
+ run('git', ['push', 'origin', tag]);
@@ -0,0 +1,41 @@
1
+ #!/usr/bin/env node
2
+ import { spawnSync } from 'node:child_process';
3
+ import { readFileSync } from 'node:fs';
4
+
5
+ function run(command, args, options = {}) {
6
+ const result = spawnSync(command, args, { stdio: options.stdio || 'inherit', encoding: options.encoding });
7
+ if (result.status !== 0 && !options.allowFailure) process.exit(result.status || 1);
8
+ return result;
9
+ }
10
+
11
+ function npmView(packageSpec) {
12
+ return run('npm', ['view', packageSpec, 'version'], { allowFailure: true, stdio: 'pipe', encoding: 'utf8' }).status === 0;
13
+ }
14
+
15
+ const pkg = JSON.parse(readFileSync('package.json', 'utf8'));
16
+ const ref = process.env.GITHUB_REF_NAME || '';
17
+ const branch = ref.split('/')[1] || 'develop';
18
+ const tag = branch === 'main' ? 'latest' : branch;
19
+
20
+ if (!process.env.NODE_AUTH_TOKEN) {
21
+ console.log('NODE_AUTH_TOKEN is not configured; skipping npm publish.');
22
+ process.exit(0);
23
+ }
24
+
25
+ if (npmView(pkg.name + '@' + pkg.version)) {
26
+ console.log(pkg.name + '@' + pkg.version + ' already exists; ensuring dist-tag ' + tag + '.');
27
+ run('npm', ['dist-tag', 'add', pkg.name + '@' + pkg.version, tag], { allowFailure: true });
28
+ process.exit(0);
29
+ }
30
+
31
+ for (const field of ['dependencies', 'peerDependencies', 'optionalDependencies']) {
32
+ for (const [name, version] of Object.entries(pkg[field] || {})) {
33
+ if (!name.startsWith('@a5c-ai/') || version.startsWith('^') || version.startsWith('~') || version === '*' || version.startsWith('workspace:')) continue;
34
+ if (!npmView(name + '@' + version)) {
35
+ console.log('Required internal dependency ' + name + '@' + version + ' is not published yet; skipping npm publish.');
36
+ process.exit(0);
37
+ }
38
+ }
39
+ }
40
+
41
+ run('npm', ['publish', '--access', 'public', '--tag', tag]);
File without changes
@@ -29,12 +29,18 @@ Where `OPENCODE_CONFIG_DIR` is resolved from the `OPENCODE_CONFIG_DIR` environme
29
29
  Read the SDK version from `versions.json` to ensure version compatibility:
30
30
 
31
31
  ```bash
32
- SDK_VERSION=$(node -e "try{const fs=require('fs');const probes=['./plugins/babysitter-opencode/versions.json','./node_modules/@a5c-ai/babysitter-opencode/versions.json'];for(const probe of probes){if(fs.existsSync(probe)){console.log(JSON.parse(fs.readFileSync(probe,'utf8')).sdkVersion||'latest');process.exit(0)}}console.log('latest')}catch{console.log('latest')}")
32
+ SDK_VERSION=$(node -e "try{const fs=require('fs');const probes=['./plugins/babysitter-unified/versions.json','./node_modules/@a5c-ai/babysitter-opencode/versions.json'];for(const probe of probes){if(fs.existsSync(probe)){console.log(JSON.parse(fs.readFileSync(probe,'utf8')).sdkVersion||'latest');process.exit(0)}}console.log('latest')}catch{console.log('latest')}")
33
33
  npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION
34
34
 
35
- CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"
35
+ if command -v babysitter >/dev/null 2>&1 && babysitter --version >/dev/null 2>&1; then
36
+ CLI="babysitter"
37
+ else
38
+ CLI="npm exec --yes --package @a5c-ai/babysitter-sdk@$SDK_VERSION -- babysitter"
39
+ fi
36
40
  ```
37
41
 
42
+ 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`.
43
+
38
44
  ## Instructions
39
45
 
40
46
  ### 1. Resolve the status directory
@@ -1,11 +1,12 @@
1
1
  ---
2
2
  name: babysit
3
- 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.)
3
+ description: >-
4
+ 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.)
4
5
  ---
5
6
 
6
7
  # babysit
7
8
 
8
- Orchestrate `.a5c/runs/<runId>/` through iterative execution.
9
+ 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.
9
10
 
10
11
  ## Dependencies
11
12
 
@@ -14,24 +15,30 @@ Orchestrate `.a5c/runs/<runId>/` through iterative execution.
14
15
  Read the SDK version from `versions.json` to ensure version compatibility:
15
16
 
16
17
  ```bash
17
- SDK_VERSION=$(node -e "try{const fs=require('fs');const probes=['./plugins/babysitter-opencode/versions.json','./node_modules/@a5c-ai/babysitter-opencode/versions.json'];for(const probe of probes){if(fs.existsSync(probe)){console.log(JSON.parse(fs.readFileSync(probe,'utf8')).sdkVersion||'latest');process.exit(0)}}console.log('latest')}catch{console.log('latest')}")
18
+ SDK_VERSION=$(node -e "try{const fs=require('fs');const probes=['./plugins/babysitter-unified/versions.json','./node_modules/@a5c-ai/babysitter-opencode/versions.json'];for(const probe of probes){if(fs.existsSync(probe)){console.log(JSON.parse(fs.readFileSync(probe,'utf8')).sdkVersion||'latest');process.exit(0)}}console.log('latest')}catch{console.log('latest')}")
18
19
 
19
20
  npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION
20
- CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"
21
+ if command -v babysitter >/dev/null 2>&1 && babysitter --version >/dev/null 2>&1; then
22
+ CLI="babysitter"
23
+ else
24
+ CLI="npm exec --yes --package @a5c-ai/babysitter-sdk@$SDK_VERSION -- babysitter"
25
+ fi
21
26
  ```
22
27
 
28
+ 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`.
29
+
23
30
  ## Instructions
24
31
 
25
32
  Run the following command to get full orchestration instructions:
26
33
 
27
34
  ```bash
28
- babysitter instructions:babysit-skill --harness opencode --interactive
35
+ $CLI instructions:babysit-skill --harness opencode --interactive
29
36
  ```
30
37
 
31
38
  For non-interactive mode:
32
39
 
33
40
  ```bash
34
- babysitter instructions:babysit-skill --harness opencode --no-interactive
41
+ $CLI instructions:babysit-skill --harness opencode --no-interactive
35
42
  ```
36
43
 
37
44
  Follow the instructions returned by the command above to orchestrate the run.
@@ -5,4 +5,8 @@ description: Orchestrate a babysitter run. use this command to start babysitting
5
5
 
6
6
  # call
7
7
 
8
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
8
+ 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.
9
+
10
+ User arguments for this command:
11
+
12
+ $ARGUMENTS
@@ -0,0 +1,69 @@
1
+ ---
2
+ name: check-forbidden-markers
3
+ description: Pre-deploy gate that scans built JS chunks for forbidden substring markers (saga-era / obsolete code paths) listed in a project-local forbidden-markers.txt
4
+ ---
5
+
6
+ # check-forbidden-markers
7
+
8
+ Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). Compose the gate from the shared helper at `library/processes/shared/forbidden-markers-scanner.js` (issue #477).
9
+
10
+ ## What this gate does
11
+
12
+ Reads a list of literal substring markers from `scripts/forbidden-markers.txt` (blank lines and `#`-prefixed comments stripped) and greps every `.js` chunk under `.vercel/output/static/_next/static/chunks/` (Next.js / Vercel default; configurable) for any occurrence. Reports structured hits per `(marker, chunk)` pair with occurrence counts. Designed to chain between `vercel build --prod` and `vercel deploy --prod`.
13
+
14
+ Use this gate when a refactor or restart-from-baseline replaced load-bearing code paths and you need a structural guarantee the obsolete symbols never re-ship. Burned-in evidence: cookbook VI-9 / VI-12 near-miss revivals during the 2026-05 iOS-Safari saga; the prototype lives at `cookbook/scripts/check-no-forbidden.mjs` and shipped two upstream contributions before being generalized as this gate.
15
+
16
+ ## When to use
17
+
18
+ - **Pre-deploy.** Insert after build, before deploy. Block the deploy when `ok: false`.
19
+ - **Post-restart.** After a baseline rollback + step-by-step re-add, snapshot the saga-era markers in `forbidden-markers.txt` and let CI hold the line.
20
+ - **Post-refactor.** When old helper / handler / module names must not coexist with the new ones in the same bundle.
21
+
22
+ ## Expected config locations
23
+
24
+ - `scripts/forbidden-markers.txt` — one marker per line, `#` for comments. The list is the contract; the gate is mechanical. Commit this file to source control.
25
+ - `.vercel/output/static/_next/static/chunks/` — default scan target. Override for non-Vercel frameworks via the `--chunks-dir` flag or the `chunksDir` task input.
26
+
27
+ A missing markers file is a no-op (`ok: true`, `reason: 'missing-markers-file'`) — misconfiguration is never a deploy block. A missing chunks directory is likewise a no-op (`reason: 'missing-chunks-dir'`) so the gate is safe to chain into `check:all` before the build runs.
28
+
29
+ ## Exit semantics
30
+
31
+ | Reason | `ok` | Deploy decision |
32
+ |-------------------------|--------|--------------------------------|
33
+ | `missing-markers-file` | true | Pass (no gate active) |
34
+ | `missing-chunks-dir` | true | Pass (run before build) |
35
+ | `empty-markers` | true | Pass (list is empty) |
36
+ | `no-chunks` | true | Pass (nothing to scan) |
37
+ | `clean` | true | Pass — proceed to deploy |
38
+ | `hits` | false | **BLOCK** — surface hits, ask for triage |
39
+
40
+ For each hit, the gate emits `{ marker, chunk, count }` so the operator sees the exact marker string, the absolute chunk path, and the number of occurrences in that chunk. Multiple hits across chunks for the same marker are reported separately.
41
+
42
+ ## Programmatic surface
43
+
44
+ ```js
45
+ import { scanForbiddenMarkers, checkForbiddenMarkersTask } from '@a5c-ai/babysitter-library/processes/shared';
46
+
47
+ // Direct call:
48
+ const result = await scanForbiddenMarkers({
49
+ markersFile: 'scripts/forbidden-markers.txt',
50
+ chunksDir: '.vercel/output/static/_next/static/chunks',
51
+ });
52
+ if (!result.ok) {
53
+ // result.hits: Array<{ marker, chunk, count }>
54
+ // result.reason === 'hits'
55
+ process.exit(1);
56
+ }
57
+
58
+ // Or dispatched as a babysitter task:
59
+ const gate = await ctx.task(checkForbiddenMarkersTask, {
60
+ projectDir: '.',
61
+ // markersFile / chunksDir are inferred from projectDir if omitted
62
+ });
63
+ ```
64
+
65
+ ## Reference
66
+
67
+ - Issue: https://github.com/a5c-ai/babysitter/issues/477
68
+ - Helper module: `library/processes/shared/forbidden-markers-scanner.js`
69
+ - Origin (cookbook prototype): `cookbook/scripts/check-no-forbidden.mjs` (81 lines)
@@ -7,15 +7,43 @@ description: Clean up .a5c/runs and .a5c/processes directories. Aggregates insig
7
7
 
8
8
  Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
9
9
 
10
- Create and run a cleanup process using the process at `skills\babysit\process\cradle\cleanup-runs.js/processes/cleanup-runs.js`.
10
+ Resolve the active process library with:
11
+
12
+ ```bash
13
+ babysitter process-library:active --json
14
+ ```
15
+
16
+ Read `binding.dir` from that JSON and create/run the cleanup process from `cradle/cleanup-runs.js#process` relative to that active library root. Do not use plugin-cache-relative cradle paths.
11
17
 
12
18
  Implementation notes (for the process):
13
19
  - Parse arguments for `--dry-run` flag (if present, set dryRun: true in inputs) and `--keep-days N` (default: 7)
14
- - The process scans .a5c/runs/ for completed/failed runs, aggregates insights, writes summaries, then removes old data
15
- - Always show the user what will be removed before removing (in interactive mode via breakpoints)
16
- - In non-interactive mode (yolo), proceed with cleanup using defaults
17
- - The insights file goes to docs/run-history-insights.md
18
- - Only remove terminal runs (completed/failed) older than the keep-days threshold
19
- - Never remove active/in-progress runs
20
- - Remove orphaned process files not referenced by remaining runs
21
- - After cleanup, show remaining run count and disk usage
20
+
21
+ CRITICAL: The cleanup MUST follow this exact phase order. Do NOT delete any run before Phase 2 completes.
22
+
23
+ Phase 1 Scan:
24
+ - Scan .a5c/runs/ for all runs
25
+ - Classify each as terminal (completed/failed) or active (in-progress/created)
26
+ - Identify terminal runs older than the keep-days threshold as removal candidates
27
+ - Never mark active/in-progress runs for removal
28
+ - Count and report: total runs, terminal, active, removal candidates, disk usage
29
+
30
+ Phase 2 — Aggregate insights (BEFORE any deletion):
31
+ - For EVERY removal candidate, read its run.json and journal/ events
32
+ - Extract: processId, prompt, status, event count, created date, task summaries
33
+ - Group by process type and extract patterns (retry counts, convergence behavior, failure modes)
34
+ - Append a new dated section to docs/run-history-insights.md with:
35
+ - Summary statistics (runs removed, disk freed, runs retained)
36
+ - Run categories with counts and descriptions
37
+ - Key patterns observed (multi-batch convergence, retry behavior, etc.)
38
+ - What worked well / what didn't from the run data
39
+ - This file MUST be written and verified before proceeding to Phase 3
40
+
41
+ Phase 3 — Confirm removal:
42
+ - In interactive mode, show the user what will be removed via a breakpoint
43
+ - In non-interactive mode (yolo), proceed with defaults
44
+ - In dry-run mode, stop here and show what would be removed
45
+
46
+ Phase 4 — Remove:
47
+ - Delete the terminal runs older than keep-days threshold
48
+ - Identify and remove orphaned process files not referenced by remaining runs
49
+ - Show remaining run count and disk usage after cleanup
@@ -157,7 +157,6 @@ If it exists:
157
157
  **Goal:** Inspect babysitter session files for health and detect runaway loops.
158
158
 
159
159
  - Search for session state files using Glob:
160
- - `plugins/babysitter/skills/babysit/state/*.md`
161
160
  - `.a5c/state/*.md`
162
161
  - `.a5c/state/*.json`
163
162
  - For each session state file found:
@@ -261,7 +260,7 @@ Mark as PASS if total size < 500MB and no files > 10MB. Mark as WARN if total si
261
260
 
262
261
  ### 10a. Hook Registration
263
262
 
264
- - Locate the plugin root. Check for `CLAUDE_PLUGIN_ROOT` env var, or search for `plugins/babysitter/hooks/hooks.json` by walking up from the current directory.
263
+ - Locate the plugin root. Check for `CLAUDE_PLUGIN_ROOT` env var first, or search for a babysitter `hooks.json` by walking up from the current directory.
265
264
  - If found, read `hooks.json` and verify:
266
265
  - A `Stop` hook entry exists with a command referencing `babysitter-stop-hook.sh`.
267
266
  - A `SessionStart` hook entry exists with a command referencing `babysitter-session-start-hook.sh`.
@@ -316,7 +315,7 @@ If the stop hook shows NO evidence of execution (no log entries, no journal even
316
315
 
317
316
  Perform these diagnostic steps in order and report the first failure found:
318
317
 
319
- 1. **Plugin not installed**: Check if `plugins/babysitter/` exists relative to the project root and if `CLAUDE_PLUGIN_ROOT` is set. If the plugin directory doesn't exist, report: "Plugin not installed — the babysitter plugin directory is missing."
318
+ 1. **Plugin not installed**: Check if `CLAUDE_PLUGIN_ROOT` is set or if a babysitter plugin directory exists relative to the project root. If neither exists, report: "Plugin not installed — the babysitter plugin directory is missing."
320
319
 
321
320
  2. **Plugin not enabled**: Check for Claude settings files:
322
321
  - `~/.claude/settings.json` — look for `babysitter` in `enabledPlugins`.
@@ -234,7 +234,8 @@ SECONDARY COMMANDS
234
234
  How it works: Runs npx @a5c-ai/babysitter-observer-dashboard@latest which watches
235
235
  the .a5c/runs/ directory (or a parent directory containing multiple projects) and
236
236
  serves a live dashboard. The process is blocking -- it runs until you stop it, and
237
- it prints the local URL to share with the user.
237
+ it prints the local URL to share with the user. Do not use `babysitter observe`
238
+ as a fallback; the core Babysitter CLI does not expose that subcommand.
238
239
 
239
240
  Example: /babysitter:observe
240
241
  (opens browser showing all runs with live-updating task
@@ -8,6 +8,11 @@ description: Launch the babysitter observer dashboard. Installs and runs the rea
8
8
  Run the babysitter observer dashboard:
9
9
 
10
10
  1. Determine the watch directory — this is usually the project's container directory (the parent of the project dir), or the current working directory if not specified.
11
- 2. Launch the dashboard: `npx -y @a5c-ai/babysitter-observer-dashboard@latest --watch-dir <dir>`
11
+ 2. Launch the standalone dashboard package: `npx -y @a5c-ai/babysitter-observer-dashboard@latest --watch-dir <dir>`.
12
12
  3. This is a blocking process — it will keep running until stopped.
13
13
  4. Report the URL printed by the dashboard to the user, then open it in the browser.
14
+
15
+ Do not fall back to `babysitter observe`; the core Babysitter CLI does not expose
16
+ that subcommand. Some harness runtimes may provide a separate
17
+ `agent-platform observe` surface, but this skill uses the verified standalone
18
+ dashboard package.
@@ -5,4 +5,14 @@ description: Plan a babysitter run. use this command to plan a complex workflow,
5
5
 
6
6
  # plan
7
7
 
8
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). focus on creating the best process possible, but without creating and running the actual run.
8
+ Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). Focus on creating the best process possible, but without creating and running the actual run.
9
+
10
+ Before drafting the process, run Phase 0 -- REUSE-AUDIT: extract keyword nouns and verbs from the request, scan for matching existing migrations, API routes, environment variables, SDK dependencies, and imports, honor `.a5c/reuse-audit.json` when present, and put a `Reuse-audit findings (REVIEW BEFORE PROCEEDING)` block before Phase 1 of the plan.
11
+
12
+ ## Process Shape Selection
13
+
14
+ Choose the process shape before authoring `process.js`:
15
+
16
+ - Use a flat phase list when the spec is well-defined, the work is wiring or composition, the bug class is already known if this is a fix, and execution should proceed sequentially through clear phases.
17
+ - Use a HYPOTHESES tree when the bug class is unknown, forensics are required, multiple causal models compete, and each hypothesis needs its own observations, falsifying observations, and follow-up phases.
18
+ - Rule of thumb: if the first phase is "investigate", use HYPOTHESES-tree mode. If the first phase is "implement X", use flat-phase-list mode.
@@ -5,4 +5,8 @@ description: Orchestrate a babysitter run. use this command to start babysitting
5
5
 
6
6
  # yolo
7
7
 
8
- Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md). but without any user interaction or breakpoints in the run.
8
+ Run the Babysitter orchestration instructions directly through the CLI, without any user interaction or breakpoints. In Claude Code, use Bash to run `babysitter instructions:babysit-skill --harness claude-code --no-interactive`; in Codex, run `babysitter instructions:babysit-skill --harness codex --no-interactive`; in other harnesses, use the same command with that harness id. Then follow the returned instructions in this same turn until completion proof is produced. Do not stop after reading the instructions, do not invoke the Skill tool first, and use the non-interactive/no-breakpoints path when the instructions offer a mode choice.
9
+
10
+ User arguments for this command:
11
+
12
+ $ARGUMENTS
package/versions.json CHANGED
@@ -1,4 +1,4 @@
1
1
  {
2
- "sdkVersion": "5.0.1-staging.dd0c1ccc",
3
- "extensionVersion": "5.0.0"
2
+ "sdkVersion": "5.0.1-staging.e195a4980892",
3
+ "extensionVersion": "5.0.1-staging.e195a4980892"
4
4
  }
@@ -1,24 +0,0 @@
1
- #!/usr/bin/env node
2
- "use strict";
3
- var execSync = require("child_process").execSync;
4
- var path = require("path");
5
- var readFileSync = require("fs").readFileSync;
6
-
7
- var PLUGIN_ROOT = process.env.PLUGIN_ROOT || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
8
- var stdin = "";
9
- try { stdin = readFileSync(0, "utf8"); } catch {}
10
- try {
11
- var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "hooks/session-idle.sh")), {
12
- input: stdin,
13
- stdio: ["pipe", "pipe", "pipe"],
14
- timeout: 30000,
15
- env: Object.assign({}, process.env, {
16
- HOOK_TYPE: process.env.HOOK_TYPE || "",
17
- ADAPTER_NAME: process.env.ADAPTER_NAME || "opencode",
18
- PLUGIN_ROOT: PLUGIN_ROOT
19
- })
20
- });
21
- process.stdout.write(result);
22
- } catch (e) {
23
- process.stdout.write("{}\n");
24
- }
@@ -1,3 +0,0 @@
1
- #!/bin/bash
2
- set -euo pipefail
3
- babysitter hook:run --harness unified --hook-type session-idle --json
@@ -1,107 +0,0 @@
1
- 'use strict';
2
-
3
- const path = require('path');
4
- const {
5
- listMarkdownBasenames,
6
- reportCheckResult,
7
- syncCommandMirrors,
8
- syncSkillsFromCommands,
9
- writeFileIfChanged,
10
- } = require('../../../scripts/plugin-command-sync-lib.cjs');
11
-
12
- const PACKAGE_ROOT = path.resolve(__dirname, '..');
13
- const REPO_ROOT = path.resolve(PACKAGE_ROOT, '..', '..');
14
- const ROOT_COMMANDS = path.join(REPO_ROOT, 'plugins', 'babysitter', 'commands');
15
- const COMMANDS_ROOT = path.join(PACKAGE_ROOT, 'commands');
16
- const SKILLS_ROOT = path.join(PACKAGE_ROOT, 'skills');
17
- const LABEL = 'babysitter-opencode sync';
18
-
19
- const BABYSIT_SKILL = `---
20
- name: babysit
21
- 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.)
22
- ---
23
-
24
- # babysit
25
-
26
- Orchestrate \`.a5c/runs/<runId>/\` through iterative execution.
27
-
28
- ## Dependencies
29
-
30
- ### Babysitter SDK and CLI
31
-
32
- Read the SDK version from \`versions.json\` to ensure version compatibility:
33
-
34
- \`\`\`bash
35
- SDK_VERSION=$(node -e "try{const fs=require('fs');const probes=['./plugins/babysitter-opencode/versions.json','./node_modules/@a5c-ai/babysitter-opencode/versions.json'];for(const probe of probes){if(fs.existsSync(probe)){console.log(JSON.parse(fs.readFileSync(probe,'utf8')).sdkVersion||'latest');process.exit(0)}}console.log('latest')}catch{console.log('latest')}")
36
-
37
- npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION
38
- CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"
39
- \`\`\`
40
-
41
- ## Instructions
42
-
43
- Run the following command to get full orchestration instructions:
44
-
45
- \`\`\`bash
46
- babysitter instructions:babysit-skill --harness opencode --interactive
47
- \`\`\`
48
-
49
- For non-interactive mode:
50
-
51
- \`\`\`bash
52
- babysitter instructions:babysit-skill --harness opencode --no-interactive
53
- \`\`\`
54
-
55
- Follow the instructions returned by the command above to orchestrate the run.
56
- `;
57
-
58
- function getCommandNames() {
59
- return listMarkdownBasenames(ROOT_COMMANDS);
60
- }
61
-
62
- function main() {
63
- const check = process.argv.includes('--check');
64
- const commandNames = getCommandNames();
65
- const mirrorResult = syncCommandMirrors({
66
- label: LABEL,
67
- sourceRoot: ROOT_COMMANDS,
68
- targetRoot: COMMANDS_ROOT,
69
- names: commandNames,
70
- check,
71
- cwd: PACKAGE_ROOT,
72
- });
73
- const skillsResult = syncSkillsFromCommands({
74
- label: LABEL,
75
- sourceRoot: COMMANDS_ROOT,
76
- skillsRoot: SKILLS_ROOT,
77
- names: commandNames,
78
- check,
79
- cwd: PACKAGE_ROOT,
80
- });
81
-
82
- const babysitSkillPath = path.join(SKILLS_ROOT, 'babysit', 'SKILL.md');
83
- if (check) {
84
- const fs = require('fs');
85
- const stale = [...mirrorResult.stale, ...skillsResult.stale];
86
- const current = fs.existsSync(babysitSkillPath)
87
- ? fs.readFileSync(babysitSkillPath, 'utf8')
88
- : null;
89
- if (current !== BABYSIT_SKILL) {
90
- stale.push(path.relative(PACKAGE_ROOT, babysitSkillPath));
91
- }
92
- reportCheckResult(LABEL, stale);
93
- return;
94
- }
95
-
96
- const babysitUpdated = writeFileIfChanged(babysitSkillPath, BABYSIT_SKILL) ? 1 : 0;
97
- const updated = mirrorResult.updated + skillsResult.updated + babysitUpdated;
98
-
99
- if (updated === 0) {
100
- console.log(`[${LABEL}] no OpenCode command or skill changes were needed.`);
101
- return;
102
- }
103
-
104
- console.log(`[${LABEL}] updated ${updated} OpenCode command/skill file(s).`);
105
- }
106
-
107
- main();
@@ -1,52 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Sync command surfaces from the canonical babysitter plugin.
4
- *
5
- * Copies command .md files from the cursor/codex plugins or generates
6
- * them from the SDK CLI command definitions. Used during build/deploy
7
- * to keep command surfaces in sync across harness plugins.
8
- */
9
-
10
- "use strict";
11
-
12
- const fs = require("fs");
13
- const path = require("path");
14
-
15
- const PLUGIN_ROOT = path.resolve(__dirname, "..");
16
- const COMMANDS_DIR = path.join(PLUGIN_ROOT, "commands");
17
-
18
- // Check mode
19
- const checkOnly = process.argv.includes("--check");
20
-
21
- function main() {
22
- // Verify commands directory exists and has files
23
- if (!fs.existsSync(COMMANDS_DIR)) {
24
- console.error("ERROR: commands/ directory not found");
25
- process.exit(1);
26
- }
27
-
28
- const files = fs.readdirSync(COMMANDS_DIR).filter(f => f.endsWith(".md"));
29
- if (files.length === 0) {
30
- console.error("ERROR: No command .md files found in commands/");
31
- process.exit(1);
32
- }
33
-
34
- console.log(`Found ${files.length} command files:`);
35
- for (const file of files) {
36
- const content = fs.readFileSync(path.join(COMMANDS_DIR, file), "utf8");
37
- const hasHeader = content.startsWith("---");
38
- const status = hasHeader ? "OK" : "MISSING FRONTMATTER";
39
- console.log(` ${file} [${status}]`);
40
- if (checkOnly && !hasHeader) {
41
- process.exit(1);
42
- }
43
- }
44
-
45
- if (checkOnly) {
46
- console.log("\nAll command files are valid.");
47
- } else {
48
- console.log("\nCommand surfaces synced.");
49
- }
50
- }
51
-
52
- main();