@a5c-ai/babysitter-github 0.1.1-staging.04cc300a

package/bin/install.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('path');
+const { spawnSync } = require('child_process');
+const {
+  copyPluginBundle,
+  ensureGlobalProcessLibrary,
+  ensureMarketplaceEntry,
+  getCopilotHome,
+  getHomeMarketplacePath,
+  getHomePluginRoot,
+  installCloudAgentSurface,
+  installCopilotSurface,
+  warnWindowsHooks,
+} = require('./install-shared');
+
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+
+function parseArgs(argv) {
+  const args = {
+    cloudAgent: false,
+    workspace: process.cwd(),
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--cloud-agent') {
+      args.cloudAgent = true;
+      continue;
+    }
+    if (arg === '--workspace') {
+      const next = argv[i + 1];
+      if (next && !next.startsWith('-')) {
+        args.workspace = path.resolve(next);
+        i += 1;
+      } else {
+        args.workspace = process.cwd();
+      }
+    }
+  }
+
+  return args;
+}
+
+/**
+ * Attempt to register the plugin via `copilot plugin install ./path`.
+ * Falls back to manual config.json registration if the CLI is not available.
+ */
+function registerViaCopilotCli(pluginRoot) {
+  const result = spawnSync('copilot', ['plugin', 'install', pluginRoot], {
+    stdio: ['ignore', 'pipe', 'pipe'],
+    encoding: 'utf8',
+    timeout: 30000,
+  });
+
+  if (result.status === 0) {
+    console.log(`[babysitter] Registered plugin via 'copilot plugin install'`);
+    return true;
+  }
+
+  // CLI not available or failed -- fall back to manual registration
+  const stderr = (result.stderr || '').trim();
+  if (result.error || stderr.includes('not found') || stderr.includes('not recognized')) {
+    console.log(`[babysitter] Copilot CLI not found, using manual registration`);
+  } else {
+    console.warn(`[babysitter] 'copilot plugin install' failed: ${stderr || 'unknown error'}, using manual registration`);
+  }
+  return false;
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const copilotHome = getCopilotHome();
+  const pluginRoot = getHomePluginRoot();
+  const marketplacePath = getHomeMarketplacePath();
+
+  if (args.cloudAgent) {
+    const active = ensureGlobalProcessLibrary(PACKAGE_ROOT);
+    const installed = installCloudAgentSurface(PACKAGE_ROOT, args.workspace);
+    console.log(`[babysitter] Installed Copilot cloud-agent support into ${args.workspace}`);
+    console.log(`[babysitter]   plugin bundle: ${installed.bundleRoot}`);
+    console.log(`[babysitter]   skills: ${path.join(args.workspace, '.github', 'skills')}`);
+    console.log(`[babysitter]   instructions: ${installed.copilotInstructionsPath}`);
+    console.log(`[babysitter]   agents: ${installed.agentsPath}`);
+    if (installed.setupWorkflow.needsManualMerge) {
+      console.warn(`[babysitter] Existing copilot-setup-steps workflow preserved: ${installed.setupWorkflow.workflowPath}`);
+      console.warn(`[babysitter] Merge Babysitter setup steps from: ${installed.setupWorkflow.examplePath}`);
+    } else {
+      console.log(`[babysitter]   setup workflow: ${installed.setupWorkflow.workflowPath}`);
+    }
+    console.log(`[babysitter]   process library: ${active.binding?.dir}`);
+    console.log(`[babysitter]   process library state: ${active.stateFile}`);
+    console.log('[babysitter] Cloud-agent installation complete!');
+    return;
+  }
+
+  console.log(`[babysitter] Installing plugin to ${pluginRoot}`);
+
+  try {
+    copyPluginBundle(PACKAGE_ROOT, pluginRoot);
+    ensureMarketplaceEntry(marketplacePath, pluginRoot);
+
+    // Try native copilot CLI registration first; fall back to manual config.json
+    if (!registerViaCopilotCli(pluginRoot)) {
+      const { registerCopilotPlugin } = require('./install-shared');
+      registerCopilotPlugin(pluginRoot);
+    }
+
+    installCopilotSurface(PACKAGE_ROOT, copilotHome);
+
+    const active = ensureGlobalProcessLibrary(PACKAGE_ROOT);
+    console.log(`[babysitter]   marketplace: ${marketplacePath}`);
+    console.log(`[babysitter]   copilot config: ${path.join(copilotHome, 'config.json')}`);
+    console.log(`[babysitter]   process library: ${active.binding?.dir}`);
+    if (active.defaultSpec?.cloneDir) {
+      console.log(`[babysitter]   process library clone: ${active.defaultSpec.cloneDir}`);
+    }
+    console.log(`[babysitter]   process library state: ${active.stateFile}`);
+    warnWindowsHooks();
+    console.log('[babysitter] Installation complete!');
+    console.log('[babysitter] Restart GitHub Copilot CLI to pick up the installed plugin and config changes.');
+  } catch (err) {
+    console.error(`[babysitter] Failed to install plugin: ${err.message}`);
+    process.exitCode = 1;
+  }
+}
+
+main();

package/bin/uninstall.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const { spawnSync } = require('child_process');
+const {
+  deregisterCopilotPlugin,
+  getCopilotHome,
+  getHomeMarketplacePath,
+  getHomePluginRoot,
+  removeLegacyHooks,
+  removeMarketplaceEntry,
+} = require('./install-shared');
+
+const PLUGIN_NAME = 'babysitter';
+
+/**
+ * Attempt to unregister the plugin via `copilot plugin uninstall`.
+ * Falls back to manual config.json cleanup if the CLI is not available.
+ */
+function unregisterViaCopilotCli() {
+  const result = spawnSync('copilot', ['plugin', 'uninstall', PLUGIN_NAME], {
+    stdio: ['ignore', 'pipe', 'pipe'],
+    encoding: 'utf8',
+    timeout: 30000,
+  });
+
+  if (result.status === 0) {
+    console.log(`[${PLUGIN_NAME}] Unregistered plugin via 'copilot plugin uninstall'`);
+    return true;
+  }
+
+  // CLI not available or failed
+  const stderr = (result.stderr || '').trim();
+  if (result.error || stderr.includes('not found') || stderr.includes('not recognized')) {
+    console.log(`[${PLUGIN_NAME}] Copilot CLI not found, using manual cleanup`);
+  } else {
+    console.warn(`[${PLUGIN_NAME}] 'copilot plugin uninstall' failed: ${stderr || 'unknown error'}, using manual cleanup`);
+  }
+  return false;
+}
+
+function main() {
+  const copilotHome = getCopilotHome();
+  const pluginRoot = getHomePluginRoot();
+  const marketplacePath = getHomeMarketplacePath();
+  let removedPlugin = false;
+
+  if (fs.existsSync(pluginRoot)) {
+    try {
+      fs.rmSync(pluginRoot, { recursive: true, force: true });
+      console.log(`[${PLUGIN_NAME}] Removed ${pluginRoot}`);
+      removedPlugin = true;
+    } catch (err) {
+      console.warn(`[${PLUGIN_NAME}] Warning: Could not remove plugin directory ${pluginRoot}: ${err.message}`);
+    }
+  }
+
+  removeMarketplaceEntry(marketplacePath);
+
+  // Try native copilot CLI unregistration first; fall back to manual config.json
+  if (!unregisterViaCopilotCli()) {
+    deregisterCopilotPlugin(pluginRoot);
+  }
+
+  removeLegacyHooks(copilotHome);
+
+  if (!removedPlugin) {
+    console.log(`[${PLUGIN_NAME}] Plugin directory not found, config and hooks cleaned if present.`);
+    return;
+  }
+
+  console.log(`[${PLUGIN_NAME}] Restart GitHub Copilot CLI to complete uninstallation.`);
+}
+
+main();

package/commands/assimilate.md

@@ -0,0 +1,37 @@
+---
+description: Assimilate an external methodology, harness, or specification into babysitter process definitions with skills and agents.
+argument-hint: Target to assimilate (e.g. repo URL, harness name, or spec path)
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+---
+
+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/commands/call.md

@@ -0,0 +1,7 @@
+---
+description: Orchestrate a babysitter run. use this command to start babysitting a complex workflow.
+argument-hint: Specific instructions for the run.
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+---
+
+Invoke the babysitter:babysit skill (using the Skill tool) and follow its instructions (SKILL.md).

package/commands/cleanup.md

@@ -0,0 +1,20 @@
+---
+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.
+argument-hint: "[--dry-run] [--keep-days N] Optional flags. --dry-run shows what would be removed without deleting. --keep-days N keeps runs newer than N days (default 7)."
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+---
+
+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/commands/contrib.md

@@ -0,0 +1,33 @@
+---
+description: Submit feedback or contribute to babysitter project
+argument-hint: Specific instructions for the run.
+allowed-tools: Read, Grep, Write, Task, Bash, Edit, Grep, Glob, WebFetch, WebSearch, Search, AskUserQuestion, TodoWrite, TodoRead, Skill, BashOutput, KillShell, MultiEdit, LS
+---
+
+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