@a5c-ai/babysitter-codex 0.1.6-staging.060a3463

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/skills/babysit/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: babysit
+description: >-
+  Run babysitter workflows from Codex using the installed babysit skill bundle,
+  workspace Codex hooks, workspace Codex config, and the Babysitter SDK runtime
+  loop.
+  Use when the user wants to babysit a task, resume a run, diagnose run health,
+  install the Codex skill, or assimilate a methodology for Codex.
+---
+
+# Babysitter for Codex CLI
+
+Babysitter on Codex is implemented as:
+
+- the installed skill bundle under `~/.codex/skills/babysit` or `.codex/skills/babysit`
+- optional prompt aliases under `~/.codex/prompts/*.md` or `.codex/prompts/*.md`
+- workspace `.codex/hooks.json`
+- workspace `.codex/config.toml`
+- workspace `.a5c/`
+- the Babysitter SDK CLI for `run:create`, `run:iterate`, `run:status`,
+  `task:list`, `task:post`, and process-library binding
+
+This package supports only the hooks model for the Codex plugin path. Do not
+introduce an app-server loop, an external orchestrator, or fake plugin-manifest
+machinery for the Codex integration.
+
+## Choosing a Mode
+
+Use this single skill for all Babysitter Codex flows.
+
+Choose the mode from either:
+
+1. the direct user intent when the skill is invoked as `$babysit`
+2. the installed prompt alias name when the user invoked `/call`, `/plan`,
+   `/resume`, `/yolo`, and the rest
+
+| User intent | Mode |
+|-------------|------|
+| Start an orchestration run | `call` |
+| Run autonomously | `yolo` |
+| Resume an existing run | `resume` |
+| Plan without executing | `plan` |
+| Diagnose run health | `doctor` |
+| Help and documentation | `help` |
+| Install into a project | `project-install` |
+| Install user profile/setup | `user-install` |
+| Install team-pinned setup | `team-install` |
+| Assimilate external methodology | `assimilate` |
+
+## Runtime Contract
+
+Use the Babysitter SDK CLI for orchestration:
+
+```bash
+babysitter run:create   --process-id <id> --entry <path>#<export> ...
+babysitter run:iterate  <runDir> --json --iteration <n>
+babysitter run:status   <runDir> --json
+babysitter task:list    <runDir> --pending --json
+babysitter task:post    <runDir> <effectId> --status ok --value <file> --json
+```
+
+When a Codex session ID is available, bind it honestly:
+
+```bash
+babysitter run:create ... --harness codex --session-id <id> --state-dir .a5c --json
+```
+
+## Result Posting Protocol
+
+1. Write the result value to `tasks/<effectId>/output.json`
+2. Post it with `babysitter task:post`
+3. Never write `result.json` directly
+
+## Hook Loop
+
+Workspace onboarding must install `.codex/hooks.json` and `.codex/config.toml`
+so:
+
+1. `SessionStart` seeds `.a5c` session state
+2. `UserPromptSubmit` performs prompt-time transformations when needed
+3. `Stop` decides whether the run is complete or Codex should receive the next
+   Babysitter iteration context
+
+## Process Library Model
+
+The Codex package does not bundle the process library.
+
+Workspace onboarding must:
+
+1. clone or update the upstream Babysitter repo into
+   `.a5c/process-library/babysitter-repo`
+2. bind `.a5c/process-library/babysitter-repo/library` with
+   `babysitter process-library:use`
+3. resolve the active binding later with
+   `babysitter process-library:active --state-dir .a5c --json`
+
+Preferred discovery order:
+
+1. project-local `.a5c/processes`
+2. the active SDK-managed process-library binding
+
+## Codex-Specific Rules
+
+- Prefer invoking the skill directly with `$babysit`
+- Optional prompt aliases such as `/call`, `/plan`, `/resume`, and `/yolo` may
+  exist, but they should only forward into the `babysit` skill for the matching
+  mode; they are not the primary integration surface
+- Never fabricate a session ID when none is available from Codex or the caller
+- Use `notify` only for monitoring and telemetry, never as the orchestration
+  control loop

package/README.md

@@ -0,0 +1,156 @@
+# @a5c-ai/babysitter-codex
+
+Babysitter integration package for OpenAI Codex CLI.
+
+This package is a Codex skill bundle plus installer assets. It is not a native
+Codex plugin manifest and it does not run an external orchestrator. The Codex
+plugin path is:
+
+- installed skill bundle under `~/.codex/skills/babysit`
+- optional user-local prompt aliases under `~/.codex/prompts/call.md`,
+  `plan.md`, `resume.md`, `yolo.md`, and the rest of the Babysitter modes
+- repo-local skill bundle under `.codex/skills/babysit`
+- repo-local prompt aliases under `.codex/prompts/*.md`
+- workspace `.codex/hooks.json`
+- workspace `.codex/config.toml`
+- workspace `.a5c/` state
+- Babysitter SDK CLI for run creation, iteration, result posting, and
+  process-library binding
+
+## What This Package Installs
+
+Global install copies the Codex-facing bundle into `CODEX_HOME`:
+
+- `SKILL.md`
+- `.codex/`
+- `agents/`
+- `prompts/` as the source for user-local prompt aliases
+- `scripts/`
+- `babysitter.lock.json`
+
+It does not bundle the process library.
+
+## Integration Model
+
+Babysitter for Codex uses only the hooks model:
+
+- `SessionStart` seeds Babysitter session state
+- `UserPromptSubmit` handles prompt-time transformations
+- `Stop` yields continuation back into the Babysitter orchestration loop
+
+The process library is fetched at workspace-install time through the SDK CLI and
+bound for active use in `.a5c/active/process-library.json`.
+
+## Installation
+
+Install the SDK CLI first:
+
+```bash
+npm install -g @a5c-ai/babysitter-sdk
+```
+
+Install the Codex package:
+
+```bash
+npm install -g @a5c-ai/babysitter-codex
+```
+
+This global install now also clones or updates the process library into
+`~/.a5c/process-library/babysitter-repo` and binds it as the default active
+process library in `~/.a5c/active/process-library.json` through the SDK CLI.
+
+Then install the Codex plugin payload into the target workspace:
+
+```bash
+babysitter harness:install-plugin codex --workspace /path/to/repo
+```
+
+If `npm install -g @a5c-ai/babysitter-codex` is run from inside the target
+workspace, `postinstall` will also auto-run the packaged `team-install.js`
+against that workspace.
+
+## What `team-install.js` Does
+
+`scripts/team-install.js` is the workspace installer used by the package and by
+`babysitter harness:install-plugin codex`.
+
+It:
+
+1. Resolves the installed package root.
+2. Reads `babysitter.lock.json`.
+3. Installs the single repo-local Codex skill into `.codex/skills/babysit`.
+4. Installs the prompt aliases into `.codex/prompts`.
+5. Copies hook scripts into `.codex/hooks`.
+6. Clones or updates the upstream Babysitter repo into
+   `<workspace>/.a5c/process-library/babysitter-repo`.
+7. Binds `<workspace>/.a5c/process-library/babysitter-repo/library` with
+   `babysitter process-library:use`.
+8. Writes `<workspace>/.a5c/active/process-library.json`.
+9. Writes or refreshes `<workspace>/.codex/hooks.json`.
+10. Creates or merges `<workspace>/.codex/config.toml` so the workspace has the
+   required Codex settings.
+11. Writes `<workspace>/.a5c/team/install.json`.
+12. Creates `<workspace>/.a5c/team/profile.json` if it does not already exist.
+
+It does not create an external orchestrator, bundle the process library, or
+turn the workspace into a fake Codex plugin manifest.
+
+## Resulting Workspace Files
+
+After a successful workspace install, the important files are:
+
+- `.codex/skills/babysit/SKILL.md`
+- `.codex/prompts/call.md`
+- `.codex/prompts/plan.md`
+- `.codex/prompts/resume.md`
+- `.codex/hooks/`
+- `.codex/hooks.json`
+- `.codex/config.toml`
+- `.a5c/team/install.json`
+- `.a5c/team/profile.json`
+- `.a5c/active/process-library.json`
+- `.a5c/process-library/babysitter-repo/library`
+
+## Using It In Codex
+
+Use the skill directly:
+
+```text
+$babysit implement authentication with tests
+```
+
+The optional prompt aliases are the mode shortcuts:
+
+```text
+/call implement authentication with tests
+/plan migration from monolith to services
+/resume latest
+```
+
+Each prompt alias should only forward into the `babysit` skill for the
+matching mode. Low-level SDK commands remain runtime mechanics, not the
+user-facing interface.
+
+## Verification
+
+Verify the installed skill bundle:
+
+```bash
+npm ls -g @a5c-ai/babysitter-codex --depth=0
+ls -1 ~/.codex/skills/babysit
+test -f ~/.codex/skills/babysit/scripts/team-install.js
+test -f ~/.codex/skills/babysit/.codex/hooks/babysitter-stop-hook.sh
+test -f ~/.codex/prompts/call.md
+test -f ~/.codex/prompts/plan.md
+test -f ~/.codex/prompts/resume.md
+```
+
+Verify the active process-library binding for a workspace:
+
+```bash
+babysitter process-library:active --state-dir /path/to/repo/.a5c --json
+```
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: babysit
+description: >-
+  Run babysitter workflows from Codex using the installed babysit skill bundle,
+  workspace Codex hooks, workspace Codex config, and the Babysitter SDK runtime
+  loop.
+  Use when the user wants to babysit a task, resume a run, diagnose run health,
+  install the Codex skill, or assimilate a methodology for Codex.
+---
+
+# Babysitter for Codex CLI
+
+Babysitter on Codex is implemented as:
+
+- the installed skill bundle under `~/.codex/skills/babysit` or `.codex/skills/babysit`
+- workspace `.codex/hooks.json`
+- workspace `.codex/config.toml`
+- workspace `.a5c/`
+- the Babysitter SDK CLI for `run:create`, `run:iterate`, `run:status`,
+  `task:list`, `task:post`, and process-library binding
+
+This package supports only the hooks model for the Codex plugin path. Do not
+introduce an app-server loop, an external orchestrator, or fake plugin-manifest
+machinery for the Codex integration.
+
+## Choosing a Mode
+
+Use this single skill for all Babysitter Codex flows.
+
+Choose the mode from either:
+
+1. the direct user intent when the skill is invoked as `$babysit`
+2. the installed prompt alias name when the user invoked `/call`, `/plan`,
+   `/resume`, `/yolo`, and the rest
+
+| User intent | Mode |
+|-------------|------|
+| Start an orchestration run | `call` |
+| Run autonomously | `yolo` |
+| Resume an existing run | `resume` |
+| Plan without executing | `plan` |
+| Diagnose run health | `doctor` |
+| Help and documentation | `help` |
+| Install into a project | `project-install` |
+| Install user profile/setup | `user-install` |
+| Install team-pinned setup | `team-install` |
+| Assimilate external methodology | `assimilate` |
+
+## Runtime Contract
+
+Use the Babysitter SDK CLI for orchestration:
+
+```bash
+babysitter run:create   --process-id <id> --entry <path>#<export> ...
+babysitter run:iterate  <runDir> --json --iteration <n>
+babysitter run:status   <runDir> --json
+babysitter task:list    <runDir> --pending --json
+babysitter task:post    <runDir> <effectId> --status ok --value <file> --json
+```
+
+When a Codex session ID is available, bind it honestly:
+
+```bash
+babysitter run:create ... --harness codex --session-id <id> --state-dir .a5c --json
+```
+
+## Result Posting Protocol
+
+1. Write the result value to `tasks/<effectId>/output.json`
+2. Post it with `babysitter task:post`
+3. Never write `result.json` directly
+
+## Hook Loop
+
+Workspace onboarding must install `.codex/hooks.json` and `.codex/config.toml`
+so:
+
+1. `SessionStart` seeds `.a5c` session state
+2. `UserPromptSubmit` performs prompt-time transformations when needed
+3. `Stop` decides whether the run is complete or Codex should receive the next
+   Babysitter iteration context
+
+## Process Library Model
+
+The Codex package does not bundle the process library.
+
+Workspace onboarding must:
+
+1. clone or update the upstream Babysitter repo into
+   `.a5c/process-library/babysitter-repo`
+2. bind `.a5c/process-library/babysitter-repo/library` with
+   `babysitter process-library:use`
+3. resolve the active binding later with
+   `babysitter process-library:active --state-dir .a5c --json`
+
+Preferred discovery order:
+
+1. project-local `.a5c/processes`
+2. the active SDK-managed process-library binding
+
+## Codex-Specific Rules
+
+- Prefer invoking the skill directly with `$babysit`
+- Optional user-local prompt aliases such as `/call`, `/plan`, `/resume`, and
+  `/yolo` may exist, but they should only forward into the `babysit` skill for
+  the matching mode; they are not the primary integration surface
+- Do not depend on nested mode skills under `.codex/skills/babysit/*`; the
+  installed Codex skill is the single `babysit` skill
+- Never fabricate a session ID when none is available from Codex or the caller
+- Use `notify` only for monitoring and telemetry, never as the orchestration
+  control loop

package/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Babysitter"
+  short_description: "Orchestrate multi-step AI workflows with quality convergence"
+  default_prompt: "Use $babysit to orchestrate this task"

package/babysitter.lock.json

@@ -0,0 +1,18 @@
+{
+  "version": 1,
+  "generatedAt": "2026-03-11T00:00:00.000Z",
+  "runtime": {
+    "name": "@a5c/babysitter-codex-runtime",
+    "version": "0.1.4"
+  },
+  "content": {
+    "name": "@a5c/babysitter-codex-content",
+    "version": "0.1.4",
+    "processLibrary": {
+      "repo": "https://github.com/a5c-ai/babysitter.git",
+      "processSubpath": "library",
+      "referenceSubpath": "library/reference",
+      "snapshotCommit": "unknown"
+    }
+  }
+}