@a5c-ai/babysitter-codex 0.1.6-staging.2dca8387

package/.codex/AGENTS.md

@@ -0,0 +1,53 @@
+# Project-Scoped Agent Instructions
+
+These instructions supplement the root `AGENTS.md` with Codex-specific rules for
+the bundled `babysitter-codex` runtime.
+
+## Real Codex Surfaces
+
+- Installed skills under `~/.codex/skills/babysitter-codex`
+- `AGENTS.md`
+- project `.codex/config.toml`
+- optional `notify`
+
+Codex does not provide native blocking `SessionStart` or `Stop` hooks for this
+package. The shell files in `.codex/hooks/*.sh` are compatibility stubs only.
+
+## Session Binding
+
+- Use a session ID only when it is explicitly available from:
+  - `BABYSITTER_SESSION_ID`
+  - `CODEX_THREAD_ID`
+  - `CODEX_SESSION_ID`
+- Never fabricate a session ID just to call `session:init`.
+- If no real session ID exists, continue in compat-core mode without session
+  binding.
+
+## Installed Skill Layout
+
+The installed skill must be self-contained. Required payload at
+`~/.codex/skills/babysitter-codex/`:
+
+- `SKILL.md`
+- `AGENTS.md`
+- `.codex/`
+- `agents/`
+- `bin/`
+- `commands/`
+- `scripts/`
+- `babysitter.lock.json`
+
+## Team Install Contract
+
+- `scripts/team-install.js` resolves the package root from its own installed
+  location, not from repo `cwd`.
+- They write workspace state only under `<workspace>/.a5c/team/`.
+- Generated profile paths may point back to the installed skill root for hook
+  assets and skill metadata.
+
+## Result Posting
+
+- Write successful task payloads to `tasks/<effectId>/output.json`.
+- Post results with `babysitter task:post <runDir> <effectId> --status ok --value tasks/<effectId>/output.json --json`.
+- Post errors with `--status error --error tasks/<effectId>/error.json --json`.
+- Never write `result.json` directly.

package/.codex/command-catalog.json

@@ -0,0 +1,130 @@
+{
+  "name": "babysitter",
+  "version": "0.1.5",
+  "description": "Packaged metadata for the Babysitter Codex skill bundle and hook-enabled project install templates.",
+  "author": "a5c.ai",
+  "license": "MIT",
+  "runtimeCapabilities": {
+    "codexNativeSurfaces": [
+      "AGENTS.md",
+      "skills",
+      "config.toml",
+      "hooks.json"
+    ],
+    "babysitterRuntimeOwnsRunLoop": false,
+    "supportsBlockingHooks": true,
+    "supportsCustomSlashCommands": false,
+    "sessionBinding": "hook-first",
+    "hookModel": "codex-hooks",
+    "primaryTurnControl": "stop-hook"
+  },
+  "commands": [
+    {
+      "name": "babysitter:call",
+      "file": "skills/babysitter/call/SKILL.md",
+      "aliases": [
+        "babysitter:babysit",
+        "babysitter"
+      ],
+      "description": "Start a babysitter orchestration run",
+      "argumentHint": "Specific instructions for the run"
+    },
+    {
+      "name": "babysitter:yolo",
+      "file": "skills/babysitter/yolo/SKILL.md",
+      "description": "Non-interactive autonomous orchestration (no breakpoints)",
+      "argumentHint": "Specific instructions for the run"
+    },
+    {
+      "name": "babysitter:resume",
+      "file": "skills/babysitter/resume/SKILL.md",
+      "description": "Resume an existing orchestration run",
+      "argumentHint": "[run-id] Optional run ID to resume"
+    },
+    {
+      "name": "babysitter:plan",
+      "file": "skills/babysitter/plan/SKILL.md",
+      "description": "Plan a workflow without executing it",
+      "argumentHint": "Specific instructions for the plan"
+    },
+    {
+      "name": "babysitter:forever",
+      "file": "skills/babysitter/forever/SKILL.md",
+      "description": "Start a never-ending periodic orchestration run",
+      "argumentHint": "Specific instructions for the run"
+    },
+    {
+      "name": "babysitter:doctor",
+      "file": "skills/babysitter/doctor/SKILL.md",
+      "description": "Diagnose babysitter run health",
+      "argumentHint": "[run-id] Optional run ID to diagnose"
+    },
+    {
+      "name": "babysitter:observe",
+      "file": "skills/babysitter/observe/SKILL.md",
+      "description": "Launch the observer dashboard",
+      "argumentHint": "[--watch-dir <dir>] or 'stop'"
+    },
+    {
+      "name": "babysitter:retrospect",
+      "file": "skills/babysitter/retrospect/SKILL.md",
+      "description": "Analyze completed runs and propose process improvements",
+      "argumentHint": "[run-id] Optional run ID to analyze"
+    },
+    {
+      "name": "babysitter:model",
+      "file": "skills/babysitter/model/SKILL.md",
+      "description": "Set or view model routing policy",
+      "argumentHint": "[show|set <phase>=<model> ...]"
+    },
+    {
+      "name": "babysitter:issue",
+      "file": "skills/babysitter/issue/SKILL.md",
+      "description": "Work directly from a GitHub issue",
+      "argumentHint": "<issue-number|url> [--repo owner/name]"
+    },
+    {
+      "name": "babysitter:help",
+      "file": "skills/babysitter/help/SKILL.md",
+      "description": "Help and documentation",
+      "argumentHint": "[command|process|skill|agent] topic to get help on"
+    },
+    {
+      "name": "babysitter:project-install",
+      "file": "skills/babysitter/project-install/SKILL.md",
+      "description": "Set up a project for babysitting",
+      "argumentHint": "Specific instructions"
+    },
+    {
+      "name": "babysitter:user-install",
+      "file": "skills/babysitter/user-install/SKILL.md",
+      "description": "Set up babysitter for a user",
+      "argumentHint": "Specific instructions"
+    },
+    {
+      "name": "babysitter:assimilate",
+      "file": "skills/babysitter/assimilate/SKILL.md",
+      "description": "Assimilate external methodology into babysitter processes",
+      "argumentHint": "Target (repo URL, harness name, or spec path)"
+    },
+    {
+      "name": "babysitter:team-install",
+      "file": "skills/babysitter/team-install/SKILL.md",
+      "description": "Install team-pinned babysitter runtime/content from lockfile",
+      "argumentHint": "[--dry-run]"
+    }
+  ],
+  "skills": [],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-codex"
+  },
+  "keywords": [
+    "orchestration",
+    "workflow",
+    "codex",
+    "babysitter",
+    "command-phrases",
+    "command-catalog"
+  ]
+}

package/.codex/config.toml

@@ -0,0 +1,24 @@
+# Project-scoped Codex configuration template for babysitter-codex.
+#
+# This package now assumes the real Codex lifecycle hook engine:
+# - `.codex/hooks.json` registers SessionStart, UserPromptSubmit, and Stop
+# - `features.codex_hooks = true` enables that engine on supported platforms
+# - `.a5c` stores babysitter session and run state
+#
+# `team-install` / `project-install` should materialize a workspace-local
+# `.codex/hooks.json` that points at the installed hook scripts.
+
+approval_policy = "on-request"
+sandbox_mode = "workspace-write"
+project_doc_max_bytes = 65536
+
+[sandbox_workspace_write]
+writable_roots = [".a5c", ".codex"]
+
+[features]
+codex_hooks = true
+multi_agent = true
+
+[agents]
+max_depth = 3
+max_threads = 4

package/.codex/hooks/babysitter-session-start.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+STATE_DIR="${BABYSITTER_STATE_DIR:-${PWD}/.a5c}"
+
+export CODEX_PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-${PLUGIN_ROOT}}"
+export BABYSITTER_STATE_DIR="${STATE_DIR}"
+
+exec babysitter hook:run \
+  --hook-type session-start \
+  --harness codex \
+  --plugin-root "${CODEX_PLUGIN_ROOT}" \
+  --state-dir "${BABYSITTER_STATE_DIR}"

package/.codex/hooks/babysitter-stop-hook.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+STATE_DIR="${BABYSITTER_STATE_DIR:-${PWD}/.a5c}"
+
+export CODEX_PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-${PLUGIN_ROOT}}"
+export BABYSITTER_STATE_DIR="${STATE_DIR}"
+
+exec babysitter hook:run \
+  --hook-type stop \
+  --harness codex \
+  --plugin-root "${CODEX_PLUGIN_ROOT}" \
+  --state-dir "${BABYSITTER_STATE_DIR}"

package/.codex/hooks/user-prompt-submit.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+STATE_DIR="${BABYSITTER_STATE_DIR:-${PWD}/.a5c}"
+
+export CODEX_PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-${PLUGIN_ROOT}}"
+export BABYSITTER_STATE_DIR="${STATE_DIR}"
+
+exec babysitter hook:run \
+  --hook-type user-prompt-submit \
+  --harness codex \
+  --plugin-root "${CODEX_PLUGIN_ROOT}" \
+  --state-dir "${BABYSITTER_STATE_DIR}"

package/.codex/hooks.json

@@ -0,0 +1,37 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".codex/hooks/babysitter-session-start.sh"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".codex/hooks/user-prompt-submit.sh"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".codex/hooks/babysitter-stop-hook.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/.codex/plugin.json

@@ -0,0 +1,132 @@
+{
+    "name":  "babysitter",
+    "version":  "0.1.5",
+    "description":  "Packaged metadata for the Babysitter Codex skill bundle and hook-enabled project install templates.",
+    "author":  "a5c.ai",
+    "license":  "MIT",
+    "runtimeCapabilities":  {
+                                "codexNativeSurfaces":  [
+                                                             "AGENTS.md",
+                                                             "skills",
+                                                             "config.toml",
+                                                             "hooks.json"
+                                                         ],
+                                "babysitterRuntimeOwnsRunLoop":  false,
+                                "supportsBlockingHooks":  true,
+                                "supportsCustomSlashCommands":  false,
+                                "sessionBinding":  "hook-first",
+                                "hookModel":  "codex-hooks",
+                                "primaryTurnControl":  "stop-hook"
+                            },
+    "commands":  [
+                     {
+                         "name":  "babysitter:call",
+                         "file":  "skills/babysitter/call/SKILL.md",
+                         "aliases":  [
+                                         "babysitter:babysit",
+                                         "babysitter"
+                                     ],
+                         "description":  "Start a babysitter orchestration run",
+                         "argumentHint":  "Specific instructions for the run"
+                     },
+                     {
+                         "name":  "babysitter:yolo",
+                         "file":  "skills/babysitter/yolo/SKILL.md",
+                         "description":  "Non-interactive autonomous orchestration (no breakpoints)",
+                         "argumentHint":  "Specific instructions for the run"
+                     },
+                     {
+                         "name":  "babysitter:resume",
+                         "file":  "skills/babysitter/resume/SKILL.md",
+                         "description":  "Resume an existing orchestration run",
+                         "argumentHint":  "[run-id] Optional run ID to resume"
+                     },
+                     {
+                         "name":  "babysitter:plan",
+                         "file":  "skills/babysitter/plan/SKILL.md",
+                         "description":  "Plan a workflow without executing it",
+                         "argumentHint":  "Specific instructions for the plan"
+                     },
+                     {
+                         "name":  "babysitter:forever",
+                         "file":  "skills/babysitter/forever/SKILL.md",
+                         "description":  "Start a never-ending periodic orchestration run",
+                         "argumentHint":  "Specific instructions for the run"
+                     },
+                     {
+                         "name":  "babysitter:doctor",
+                         "file":  "skills/babysitter/doctor/SKILL.md",
+                         "description":  "Diagnose babysitter run health",
+                         "argumentHint":  "[run-id] Optional run ID to diagnose"
+                     },
+                     {
+                         "name":  "babysitter:observe",
+                         "file":  "skills/babysitter/observe/SKILL.md",
+                         "description":  "Launch the observer dashboard",
+                         "argumentHint":  "[--watch-dir \u003cdir\u003e] or \u0027stop\u0027"
+                     },
+                     {
+                         "name":  "babysitter:retrospect",
+                         "file":  "skills/babysitter/retrospect/SKILL.md",
+                         "description":  "Analyze completed runs and propose process improvements",
+                         "argumentHint":  "[run-id] Optional run ID to analyze"
+                     },
+                     {
+                         "name":  "babysitter:model",
+                         "file":  "skills/babysitter/model/SKILL.md",
+                         "description":  "Set or view model routing policy",
+                         "argumentHint":  "[show|set \u003cphase\u003e=\u003cmodel\u003e ...]"
+                     },
+                     {
+                         "name":  "babysitter:issue",
+                         "file":  "skills/babysitter/issue/SKILL.md",
+                         "description":  "Work directly from a GitHub issue",
+                         "argumentHint":  "\u003cissue-number|url\u003e [--repo owner/name]"
+                     },
+                     {
+                         "name":  "babysitter:help",
+                         "file":  "skills/babysitter/help/SKILL.md",
+                         "description":  "Help and documentation",
+                         "argumentHint":  "[command|process|skill|agent] topic to get help on"
+                     },
+                     {
+                         "name":  "babysitter:project-install",
+                         "file":  "skills/babysitter/project-install/SKILL.md",
+                         "description":  "Set up a project for babysitting",
+                         "argumentHint":  "Specific instructions"
+                     },
+                     {
+                         "name":  "babysitter:user-install",
+                         "file":  "skills/babysitter/user-install/SKILL.md",
+                         "description":  "Set up babysitter for a user",
+                         "argumentHint":  "Specific instructions"
+                     },
+                     {
+                         "name":  "babysitter:assimilate",
+                         "file":  "skills/babysitter/assimilate/SKILL.md",
+                         "description":  "Assimilate external methodology into babysitter processes",
+                         "argumentHint":  "Target (repo URL, harness name, or spec path)"
+                     },
+                     {
+                         "name":  "babysitter:team-install",
+                         "file":  "skills/babysitter/team-install/SKILL.md",
+                         "description":  "Install team-pinned babysitter runtime/content from lockfile",
+                         "argumentHint":  "[--dry-run]"
+                     }
+                 ],
+    "skills":  [
+
+               ],
+    "repository":  {
+                       "type":  "git",
+                       "url":  "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-codex"
+                   },
+    "keywords":  [
+                     "orchestration",
+                     "workflow",
+                     "codex",
+                     "babysitter",
+                     "command-phrases",
+                     "command-catalog"
+                 ]
+}

package/.codex/skills/babysitter/assimilate/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: babysitter:assimilate
+description: Assimilate an external methodology, harness, or specification into babysitter process definitions.
+argument-hint: "Target to assimilate (repo URL, harness name, or spec path)"
+---
+
+# babysitter:assimilate
+
+Convert external sources into well-defined babysitter process definitions with accompanying `skills/` and `agents/` directories.
+
+## Assimilation Workflows
+
+Determine which workflow to use based on the target:
+
+### Methodology Assimilation (repo URL or methodology name)
+
+Learns an external methodology from its repo and converts procedural instructions, commands, and manual flows into babysitter processes with refactored skills and agents.
+
+1. Clone or fetch the target repo
+2. Analyze the methodology's structure, commands, and workflows
+3. Map manual steps to babysitter task definitions
+4. Generate process .js files, SKILL.md files, and AGENT.md files
+5. Store output in `.a5c/processes/`
+
+### Harness Integration (harness name)
+
+Integrates babysitter SDK with a specific AI coding harness. Available targets:
+- `codex` — OpenAI Codex CLI
+- `opencode` — OpenCode (Bun-based)
+- `gemini-cli` — Google Gemini CLI
+- `openclaw` — OpenClaw daemon
+- `antigravity` — Google Antigravity
+- `generic` — Generic AI harness
+
+### Specification Assimilation (spec path)
+
+Adapts the methodology-assimilation workflow for specification documents (RFC, API spec, design doc).
+
+## Output
+
+For each assimilation, generate:
+```
+.a5c/processes/
+├── <name>.js           # Process definition
+├── <name>-inputs.json  # Default inputs
+├── skills/             # Extracted skills
+│   └── <skill>/SKILL.md
+└── agents/             # Extracted agents
+    └── <agent>/AGENT.md
+```
+
+## Usage
+
+```
+babysitter assimilate https://github.com/org/methodology-repo
+babysitter assimilate harness codex
+babysitter assimilate ./specs/api-design.md
+```