@a5c-ai/babysitter-opencode 0.1.1-staging.0dc03363

package/plugin.json

@@ -0,0 +1,25 @@
+{
+  "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",
+  "harness": "opencode",
+  "hooks": "hooks/",
+  "commands": "commands/",
+  "skills": "skills/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/a5c-ai/babysitter"
+  },
+  "keywords": [
+    "orchestration",
+    "workflow",
+    "automation",
+    "event-sourced",
+    "hooks",
+    "opencode",
+    "agent",
+    "LLM"
+  ]
+}

package/scripts/sync-command-docs.cjs

@@ -0,0 +1,105 @@
+'use strict';
+
+const path = require('path');
+const {
+  listMarkdownBasenames,
+  reportCheckResult,
+  syncCommandMirrors,
+  syncSkillsFromCommands,
+  writeFileIfChanged,
+} = 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 COMMANDS_ROOT = path.join(PACKAGE_ROOT, 'commands');
+const SKILLS_ROOT = path.join(PACKAGE_ROOT, 'skills');
+const LABEL = 'babysitter-opencode sync';
+
+const BABYSIT_SKILL = `---
+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{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')}")
+CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"
+\`\`\`
+
+## Instructions
+
+Run the following command to get full orchestration instructions:
+
+\`\`\`bash
+babysitter instructions:babysit-skill --harness opencode --interactive
+\`\`\`
+
+For non-interactive mode:
+
+\`\`\`bash
+babysitter instructions:babysit-skill --harness opencode --no-interactive
+\`\`\`
+
+Follow the instructions returned by the command above to orchestrate the run.
+`;
+
+function getCommandNames() {
+  return listMarkdownBasenames(ROOT_COMMANDS);
+}
+
+function main() {
+  const check = process.argv.includes('--check');
+  const commandNames = getCommandNames();
+  const mirrorResult = syncCommandMirrors({
+    label: LABEL,
+    sourceRoot: ROOT_COMMANDS,
+    targetRoot: COMMANDS_ROOT,
+    names: commandNames,
+    check,
+    cwd: PACKAGE_ROOT,
+  });
+  const skillsResult = syncSkillsFromCommands({
+    label: LABEL,
+    sourceRoot: COMMANDS_ROOT,
+    skillsRoot: SKILLS_ROOT,
+    names: commandNames,
+    check,
+    cwd: PACKAGE_ROOT,
+  });
+
+  const babysitSkillPath = path.join(SKILLS_ROOT, 'babysit', 'SKILL.md');
+  if (check) {
+    const fs = require('fs');
+    const stale = [...mirrorResult.stale, ...skillsResult.stale];
+    const current = fs.existsSync(babysitSkillPath)
+      ? fs.readFileSync(babysitSkillPath, 'utf8')
+      : null;
+    if (current !== BABYSIT_SKILL) {
+      stale.push(path.relative(PACKAGE_ROOT, babysitSkillPath));
+    }
+    reportCheckResult(LABEL, stale);
+    return;
+  }
+
+  const babysitUpdated = writeFileIfChanged(babysitSkillPath, BABYSIT_SKILL) ? 1 : 0;
+  const updated = mirrorResult.updated + skillsResult.updated + babysitUpdated;
+
+  if (updated === 0) {
+    console.log(`[${LABEL}] no OpenCode command or skill changes were needed.`);
+    return;
+  }
+
+  console.log(`[${LABEL}] updated ${updated} OpenCode command/skill file(s).`);
+}
+
+main();

package/scripts/sync-command-surfaces.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * Sync command surfaces from the canonical babysitter plugin.
+ *
+ * Copies command .md files from the cursor/codex plugins or generates
+ * them from the SDK CLI command definitions. Used during build/deploy
+ * to keep command surfaces in sync across harness plugins.
+ */
+
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+const PLUGIN_ROOT = path.resolve(__dirname, "..");
+const COMMANDS_DIR = path.join(PLUGIN_ROOT, "commands");
+
+// Check mode
+const checkOnly = process.argv.includes("--check");
+
+function main() {
+  // Verify commands directory exists and has files
+  if (!fs.existsSync(COMMANDS_DIR)) {
+    console.error("ERROR: commands/ directory not found");
+    process.exit(1);
+  }
+
+  const files = fs.readdirSync(COMMANDS_DIR).filter(f => f.endsWith(".md"));
+  if (files.length === 0) {
+    console.error("ERROR: No command .md files found in commands/");
+    process.exit(1);
+  }
+
+  console.log(`Found ${files.length} command files:`);
+  for (const file of files) {
+    const content = fs.readFileSync(path.join(COMMANDS_DIR, file), "utf8");
+    const hasHeader = content.startsWith("---");
+    const status = hasHeader ? "OK" : "MISSING FRONTMATTER";
+    console.log(`  ${file} [${status}]`);
+    if (checkOnly && !hasHeader) {
+      process.exit(1);
+    }
+  }
+
+  if (checkOnly) {
+    console.log("\nAll command files are valid.");
+  } else {
+    console.log("\nCommand surfaces synced.");
+  }
+}
+
+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/meta/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/meta/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,35 @@
+---
+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{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')}")
+CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"
+```
+
+## Instructions
+
+Run the following command to get full orchestration instructions:
+
+```bash
+babysitter instructions:babysit-skill --harness opencode --interactive
+```
+
+For non-interactive mode:
+
+```bash
+babysitter instructions:babysit-skill --harness opencode --no-interactive
+```
+
+Follow the instructions returned by the command above to orchestrate the run.

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).

package/skills/cleanup/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: cleanup
+description: Clean up .a5c/runs and .a5c/processes directories. Aggregates insights from completed/failed runs into docs/run-history-insights.md, then removes old run data and orphaned process files.
+---
+
+# cleanup
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
+
+Create and run a cleanup process using the process at `skills\babysit\process\cradle\cleanup-runs.js/processes/cleanup-runs.js`.
+
+Implementation notes (for the process):
+- Parse arguments for `--dry-run` flag (if present, set dryRun: true in inputs) and `--keep-days N` (default: 7)
+- The process scans .a5c/runs/ for completed/failed runs, aggregates insights, writes summaries, then removes old data
+- Always show the user what will be removed before removing (in interactive mode via breakpoints)
+- In non-interactive mode (yolo), proceed with cleanup using defaults
+- The insights file goes to docs/run-history-insights.md
+- Only remove terminal runs (completed/failed) older than the keep-days threshold
+- Never remove active/in-progress runs
+- Remove orphaned process files not referenced by remaining runs
+- After cleanup, show remaining run count and disk usage

package/skills/contrib/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: contrib
+description: Submit feedback or contribute to babysitter project
+---
+
+# contrib
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).
+
+## Process Routing
+
+Contribution processes live under the active process library's `cradle/` directory. Resolve the active library root with `babysitter process-library:active --json` and route based on arguments:
+
+### Issue-based (opens a GitHub issue in a5c-ai/babysitter)
+ * **Bug report** → `cradle/bug-report.js#process` — Report a bug in the SDK, CLI, process library, etc.
+ * **Feature request** → `cradle/feature-request.js#process` — Request a new feature or enhancement
+ * **Documentation question** → `cradle/documentation-question.js#process` — Ask about undocumented behavior or missing docs
+
+### PR-based (forks repo, creates branch, submits PR to a5c-ai/babysitter)
+ * **Bugfix** → `cradle/bugfix.js#process` — User already has the fix for a bug
+ * **Feature implementation** → `cradle/feature-implementation-contribute.js#process` — User already has a feature implementation
+ * **Harness integration** → `cradle/feature-harness-integration-contribute.js#process` — User has a harness (CI/CD, IDE, editor) integration
+ * **Library contribution** → `cradle/library-contribution.js#process` — New or improved process/skill/subagent for the library
+ * **Documentation answer** → `cradle/documentation-contribute-answer.js#process` — User has an answer for an unanswered docs question
+
+### Router (when arguments are empty or general)
+ * **Contribute** → `cradle/contribute.js#process` — Explains contribution types and routes to the specific process
+
+## Contribution Rules
+
+ * PR-based contributions: fork the babysitter repo (a5c-ai/babysitter) for the user, ask to star if not already starred, perform changes, submit PR
+ * Issue-based contributions: gather details, search for duplicates, review, then open an issue in a5c-ai/babysitter
+ * Add breakpoints (permissions) before ALL gh actions (fork, star, submit PR/issue) to allow user review and cancellation
+ * If arguments are empty: use the `contribute.js` router process to show options and route accordingly