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

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.
@@ -16,18 +16,16 @@ Start a babysitter run with the Codex hook model. The workspace must have
16
16
 
17
17
  ### Babysitter SDK and CLI
18
18
 
19
- Read the SDK version from the plugin manifest to ensure version compatibility:
19
+ Use the installed Babysitter SDK CLI:
20
20
 
21
21
  ```bash
22
- PLUGIN_ROOT="${CODEX_PLUGIN_ROOT:-$(pwd)/.codex}"
23
- SDK_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('${PLUGIN_ROOT}/plugin.json','utf8')).sdkVersion||'latest')}catch{console.log('latest')}")
24
- sudo npm i -g @a5c-ai/babysitter-sdk@$SDK_VERSION
22
+ sudo npm i -g @a5c-ai/babysitter-sdk
25
23
  # sudo is depending on the env and system
26
24
  ```
27
25
 
28
- then use the CLI alias: CLI="babysitter"
26
+ then use the CLI alias: `CLI="babysitter"`
29
27
 
30
- **Alternatively, use the CLI alias:** `CLI="npx -y @a5c-ai/babysitter-sdk@$SDK_VERSION"`
28
+ **Alternatively, use:** `CLI="npx -y @a5c-ai/babysitter-sdk@latest"`
31
29
 
32
30
  ### jq
33
31
 
@@ -52,7 +50,7 @@ The babysitter workflow has 4 steps:
52
50
 
53
51
  Interview the user for the intent, requirements, goal, scope, etc. through conversational interaction (before setting the in-session loop).
54
52
 
55
- A multi-step phase to understand the intent and perspective to approach the process building after researching the repo, short research online if needed, short research in the target repo, additional instructions, intent and library (processes, specializations, skills, subagents, methodologies, references, etc.) / guide for methodology building. (clarifications regarding the intent, requirements, goal, scope, etc.) - the library is at [skill-root]/process/specializations/**/**/** and [skill-root]/process/methodologies/ and under [skill-root]/process/contrib/[contributer-username]/]
53
+ A multi-step phase to understand the intent and perspective to approach the process building after researching the repo, short research online if needed, short research in the target repo, additional instructions, intent and library (processes, specializations, skills, subagents, methodologies, references, etc.) / guide for methodology building. Use project-local `.a5c/processes` plus the active process-library binding returned by `babysitter process-library:active --state-dir .a5c --json`.
56
54
 
57
55
  The first step should be the look at the state of the repo, then find the most relevant processes, specializations, skills, subagents, methodologies, references, etc. to use as a reference. use the babysitter cli discover command to find the relevant processes, skills, subagents, etc at various stages.
58
56
 
@@ -557,9 +555,9 @@ prefer processes that have the following characteristics unless otherwise specif
557
555
  - if the user is very explicit about the flow and process, create a process that follows it closely and strictly. (ad hoc requests like: "try this functionality and make sure it works as expected, repeat until it works as expected")
558
556
  - search for processes (js files), skills and agents (SKILL.md and AGENT.md files) during the interactive process building phase to compose a comprehensive process that may combine various parts from different sources:
559
557
  - .a5c/processes/ (project level processes)
560
- - plugins/babysitter/skills/babysit/process/specializations/[rnd-specialization-name-slugified]/ (rnd specializations)
561
- - plugins/babysitter/skills/babysit/process/specializations/domains/[domain-name-slugified]/[specialization-name-slugified]/ (non rnd specializations)
562
- - plugins/babysitter/skills/babysit/process/methodologies/ (methodologies)
558
+ - library/specializations/[specialization-name-slugified]/ (specializations)
559
+ - library/specializations/domains/[domain-name-slugified]/[specialization-name-slugified]/ (domain specializations)
560
+ - library/methodologies/ (methodologies)
563
561
  - When creating the process file, add `@skill` and `@agent` JSDoc markers for the relevant skills and agents found during this search (see "Process File Discovery Markers" above). This ensures only the needed dependencies are surfaced during orchestration instead of scanning all available specializations.
564
562
 
565
563
  ## Critical Rules
@@ -585,6 +583,6 @@ CRITICAL RULE: NEVER use `kind: 'node'` in generated process files. All tasks MU
585
583
  CRITICAL RULE: NEVER bypass, avoid or skip the babysitter orchestration model when the user explicitly requested this skill. Do not execute the tasks yourself, do not loop programmatically, do not create helper scripts to orchestrate the runs. Use the CLI to drive the orchestration loop and do not bypass it. not for simple tasks, and even if things get complicated or don't go smoothly. persist in executing the orchestration itself rather than simplifying the execution by bypassing the process above.
586
584
 
587
585
  ## See Also
588
- - `process/tdd-quality-convergence.js` - TDD quality convergence example - read and look for relevant processes and methodologies before creating the code process for a new run (create the run using the CLI, then use these process as a reference)
589
- - `process/reference/ADVANCED_PATTERNS.md` - Agent/skill patterns, iterative convergence
590
- - `process/reference/sdk.md` - SDK API reference
586
+ - `library/tdd-quality-convergence.js` - TDD quality convergence example - read and look for relevant processes and methodologies before creating the code process for a new run
587
+ - `library/reference/ADVANCED_PATTERNS.md` - Agent/skill patterns, iterative convergence
588
+ - `library/reference/sdk.md` - SDK API reference
@@ -6,8 +6,8 @@ argument-hint: "[command|process|skill|agent|methodology] topic to get help on"
6
6
 
7
7
  # babysitter:help
8
8
 
9
- Babysitter for Codex uses skills, AGENTS guidance, project config, and
10
- workspace lifecycle hooks so Codex stays in the orchestration loop.
9
+ Babysitter for Codex uses the installed skill bundle, workspace Codex config,
10
+ workspace hooks, and the SDK runtime so Codex stays in the orchestration loop.
11
11
 
12
12
  ## No Arguments
13
13
 
@@ -24,8 +24,7 @@ Primary examples:
24
24
  babysitter doctor current run
25
25
 
26
26
  Codex-native surfaces:
27
- - skills
28
- - AGENTS.md guidance
27
+ - installed skills under ~/.codex/skills/babysitter-codex
29
28
  - project .codex/config.toml
30
29
  - project .codex/hooks.json (SessionStart, UserPromptSubmit, Stop)
31
30
  - optional notify monitoring
@@ -6,60 +6,57 @@ argument-hint: Specific instructions for project onboarding
6
6
 
7
7
  # babysitter:project-install
8
8
 
9
- Guide through onboarding a new or existing project for babysitter orchestration.
9
+ Guide through onboarding a new or existing project for Babysitter orchestration.
10
10
 
11
11
  ## Workflow
12
12
 
13
13
  ### 1. Research the Codebase
14
14
  - Analyze project structure, language, framework, build tools
15
- - Check for existing `.a5c/` directory
16
- - Detect CI/CD configuration (GitHub Actions, Jenkins, etc.)
15
+ - Check for existing `.a5c/` and `.codex/`
16
+ - Detect CI/CD configuration
17
17
  - Identify key entry points and test suites
18
18
 
19
19
  ### 2. Interview
20
- - What are the project's goals?
21
20
  - What workflows should be orchestrated?
22
21
  - What quality gates matter most?
23
- - Any specific tools or frameworks to prefer?
22
+ - Any harness, model, or tool preferences to preserve?
24
23
 
25
24
  ### 3. Install the Real Codex Payload
26
- - Verify the user has installed `@yaniv-tg/babysitter-codex`
27
- - Run the packaged team installer from the installed skill payload
25
+ - Verify the user has installed `@a5c-ai/babysitter-sdk`
26
+ - Verify the user has installed `@a5c-ai/babysitter-codex`
27
+ - Run `babysitter harness:install-plugin codex --workspace <repo>`
28
28
  - Confirm:
29
+ - `.codex/hooks.json`
30
+ - `.codex/config.toml`
29
31
  - `.a5c/team/install.json`
30
- - `.a5c/team/profile.json`
31
- - Treat the installed skill root as the source of truth for bundled rules,
32
- docs, processes, and hook scripts
32
+ - `.a5c/active/process-library.json`
33
33
 
34
- ### 4. Build Project Profile
35
- - If `babysitter profile:*` commands are supported, write the project profile
36
- through the CLI
37
- - If the SDK is running in `compat-core`, do not block onboarding on profile
38
- writes; instead record the discovered build/test/gate choices in workspace
39
- onboarding notes under `.a5c/`
34
+ Treat the installed skill root as the source of truth for Codex-facing assets
35
+ only: hooks, skills, commands, and installer scripts. Treat the active
36
+ process-library binding as the source of truth for process content.
40
37
 
41
- The profile or onboarding notes should cover:
42
- - Project name, description, language, framework
43
- - Build and test commands
44
- - Quality gates configuration
45
- - Preferred skills and agents
38
+ ### 4. Build Project Profile
39
+ - Prefer `babysitter profile:*` CLI commands for project profile work
40
+ - Capture build/test/gate choices in the project profile or `.a5c` notes
41
+
42
+ The profile should cover:
43
+ - project name, description, language, framework
44
+ - build and test commands
45
+ - quality gates configuration
46
+ - preferred skills and agents
46
47
  - CI/CD integration settings
47
48
 
48
49
  ### 5. Install Project-Level Codex Settings
49
- - Ensure `@a5c-ai/babysitter-sdk` is available
50
- - Create `.a5c/` directory structure
51
- - Set up `.codex/config.toml` using real Codex settings (sandbox, approval, optional notify)
52
- - Set up `.codex/hooks.json` with `SessionStart`, `UserPromptSubmit`, and `Stop`
53
- - Create AGENTS.md if not present
54
- - Do not add fake manifest/plugin sections or external supervisor loops
50
+ - Ensure `.codex/hooks.json` points at the installed hook scripts
51
+ - Ensure `.codex/config.toml` contains the required Codex features and writable roots
52
+ - Ensure `.a5c` contains active process-library binding state
53
+ - Do not add a fake plugin manifest, command catalog, or external supervisor loop
55
54
 
56
55
  ### 6. Optional: Configure CI/CD
57
- - Add babysitter orchestration to CI pipeline
58
- - Set up automated quality gates
59
- - Configure deployment hooks
60
-
61
- ### Done!
56
+ - Add Babysitter orchestration to CI pipelines where relevant
57
+ - Add verification or artifact capture around the native/internal harness
62
58
 
63
- Project is ready for babysitting. Try `babysitter call ...` to start your first orchestrated workflow.
59
+ ### Done
64
60
 
65
- Star the repo: https://github.com/a5c-ai/babysitter
61
+ Project is ready for babysitting. Try `babysitter call ...` to start the first
62
+ orchestrated workflow.
@@ -6,26 +6,30 @@ argument-hint: "[--dry-run]"
6
6
 
7
7
  # babysitter:team-install
8
8
 
9
- Install the team-standard babysitter-codex setup from the installed skill payload into the current workspace.
9
+ Install or refresh the packaged Babysitter Codex workspace setup from the
10
+ installed skill payload into the current workspace.
10
11
 
11
12
  ## Steps
12
13
 
13
- 1. Resolve the installed skill root from this `SKILL.md` location, not from the repo `cwd`.
14
- 2. Run the packaged installer against the current workspace.
15
- 3. Confirm generated files:
16
- - `.a5c/team/install.json`
17
- - `.a5c/team/profile.json`
18
- - `.a5c/active/process-library.json`
19
-
20
- The installer must read:
21
- - `<skillRoot>/babysitter.lock.json`
22
-
23
- The installer must bootstrap the active process library through the Babysitter SDK CLI:
24
- - clone or update the original Babysitter repo under `<workspace>/.a5c/process-library/...`
25
- - bind the active process root with `babysitter process-library:use ...`
26
- - resolve the active path later with `babysitter process-library:active --state-dir <workspace>/.a5c --json`
27
-
28
- The installer must write workspace state only under:
29
- - `<workspace>/.a5c/`
30
-
31
- Use this before onboarding new repos or contributors so command/process/rules mappings are deterministic and do not depend on the plugin repo being checked out beside the target project.
14
+ 1. Resolve the installed skill root from this package, not from a repo checkout.
15
+ 2. Read `<skillRoot>/babysitter.lock.json`.
16
+ 3. Clone or update the upstream Babysitter repo under
17
+ `<workspace>/.a5c/process-library/babysitter-repo`.
18
+ 4. Bind `<workspace>/.a5c/process-library/babysitter-repo/library` through the
19
+ Babysitter SDK CLI.
20
+ 5. Write or refresh:
21
+ - `<workspace>/.codex/hooks.json`
22
+ - `<workspace>/.codex/config.toml`
23
+ - `<workspace>/.a5c/team/install.json`
24
+ 6. Create `<workspace>/.a5c/team/profile.json` if it does not already exist.
25
+
26
+ The installer must also produce:
27
+ - `<workspace>/.a5c/active/process-library.json`
28
+
29
+ The installer must not:
30
+ - bundle the process library into the package
31
+ - create a fake Codex plugin manifest
32
+ - depend on an external orchestrator or app-server loop
33
+
34
+ Use this before onboarding new repos or contributors so the Codex-facing assets
35
+ and the active process-library binding are deterministic.
package/README.md CHANGED
@@ -1,142 +1,134 @@
1
1
  # @a5c-ai/babysitter-codex
2
2
 
3
- Babysitter integration package for OpenAI Codex CLI. It packages Codex-facing
4
- skills, install helpers, mapping docs, and the hook assets used to keep
5
- Babysitter in the Codex lifecycle loop.
3
+ Babysitter integration package for OpenAI Codex CLI.
6
4
 
7
- This is a Codex skill bundle plus workspace hook templates. It is not a
8
- Claude-style manifest plugin, but it does rely on Codex's real lifecycle hook
9
- engine through `.codex/hooks.json`, and the package postinstall now wires the
10
- active workspace when the global install is launched from that workspace.
5
+ This package is a Codex skill bundle plus installer assets. It is not a native
6
+ Codex plugin manifest and it does not run an external orchestrator. The Codex
7
+ plugin path is:
11
8
 
12
- ## What This Package Owns
9
+ - installed skill bundle under `~/.codex/skills/babysitter-codex`
10
+ - workspace `.codex/hooks.json`
11
+ - workspace `.codex/config.toml`
12
+ - workspace `.a5c/` state
13
+ - Babysitter SDK CLI for run creation, iteration, result posting, and
14
+ process-library binding
13
15
 
14
- - Codex skill payload under `~/.codex/skills/babysitter-codex`
15
- - Codex-facing command docs
16
- - Codex runtime hook helpers under `.codex/`
17
- - Codex mapping and compatibility policy for SDK-driven orchestration
16
+ ## What This Package Installs
18
17
 
19
- ## Active Process-Library Model
18
+ Global install copies the Codex-facing bundle into `CODEX_HOME`:
20
19
 
21
- `babysitter-codex` does not ship the process library. Workspace onboarding
22
- fetches the original Babysitter repo through the SDK CLI and binds the active
23
- process root in `.a5c/active/process-library.json`.
20
+ - `SKILL.md`
21
+ - `.codex/`
22
+ - `agents/`
23
+ - `commands/`
24
+ - `bin/`
25
+ - `scripts/`
26
+ - `babysitter.lock.json`
24
27
 
25
- Active-use process discovery should prefer:
28
+ It does not bundle the process library.
26
29
 
27
- 1. Project-local `.a5c/processes`
28
- 2. The SDK-managed active process-library binding returned by
29
- `babysitter process-library:active --state-dir .a5c --json`
30
+ ## Integration Model
30
31
 
31
- `project-install` and `team-install` layer config, rules, profiles, and pinned
32
- content metadata. They should not be documented as creating an exclusive
33
- project/team process-library scope.
32
+ Babysitter for Codex uses only the hooks model:
34
33
 
35
- ## Codex User Experience
34
+ - `SessionStart` seeds Babysitter session state
35
+ - `UserPromptSubmit` handles prompt-time transformations
36
+ - `Stop` yields continuation back into the Babysitter orchestration loop
36
37
 
37
- Codex should be integrated through its real hook engine:
38
-
39
- - `SessionStart` initializes Babysitter session state
40
- - `UserPromptSubmit` handles prompt-time transformations safely
41
- - `Stop` keeps Babysitter in the orchestration loop after each yielded turn
42
-
43
- Current contract:
44
-
45
- - start, resume, and inspect work through Codex command phrases such as
46
- `babysitter call`, `babysitter resume`, and `babysitter doctor`
47
- - let the installed Codex hook assets handle runtime state, result posting,
48
- and continuation
49
- - stop after each completed phase so the `Stop` hook can decide whether Codex
50
- exits or receives the next Babysitter iteration message
51
- - finish only when `completionProof` is emitted and echoed as
52
- `<promise>...</promise>`
53
-
54
- Do not document external supervisors, hidden wrapper loops, or `notify` as the
55
- continuation mechanism for the plugin path.
38
+ The process library is fetched at workspace-install time through the SDK CLI and
39
+ bound for active use in `.a5c/active/process-library.json`.
56
40
 
57
41
  ## Installation
58
42
 
59
- Install from npm:
43
+ Install the SDK CLI first:
60
44
 
61
45
  ```bash
62
- npm install -g @a5c-ai/babysitter-codex
46
+ npm install -g @a5c-ai/babysitter-sdk
63
47
  ```
64
48
 
65
- If you run that command from inside the target repository, postinstall will:
49
+ Install the Codex package:
66
50
 
67
- - install the skill payload into `CODEX_HOME`
68
- - merge `~/.codex/config.toml` so `codex_hooks` is enabled
69
- - materialize workspace `.codex/hooks.json` and `.codex/config.toml` for the
70
- active workspace
71
- - clone or update the original Babysitter repo into `.a5c/process-library/...`
72
- - bind `.a5c/process-library/.../library` for active use through the SDK CLI
51
+ ```bash
52
+ npm install -g @a5c-ai/babysitter-codex
53
+ ```
73
54
 
74
- If you installed from somewhere else, run:
55
+ Then install the Codex plugin payload into the target workspace:
75
56
 
76
57
  ```bash
77
- npm install -g @a5c-ai/babysitter-sdk
78
58
  babysitter harness:install-plugin codex --workspace /path/to/repo
79
59
  ```
80
60
 
81
- `babysitter harness:install-plugin ...` is provided by the SDK CLI, so make
82
- sure `@a5c-ai/babysitter-sdk` is installed first.
61
+ If `npm install -g @a5c-ai/babysitter-codex` is run from inside the target
62
+ workspace, `postinstall` will also auto-run the packaged `team-install.js`
63
+ against that workspace.
83
64
 
84
- Or from a local checkout:
65
+ ## What `team-install.js` Does
85
66
 
86
- ```bash
87
- cd /path/to/babysitter-codex
88
- npm install -g .
89
- ```
67
+ `scripts/team-install.js` is the workspace installer used by the package and by
68
+ `babysitter harness:install-plugin codex`.
90
69
 
91
- Verify the installed skill payload:
70
+ It:
92
71
 
93
- ```bash
94
- npm ls -g @a5c-ai/babysitter-codex --depth=0
95
- ls -1 ~/.codex/skills/babysitter-codex
96
- test -f ~/.codex/skills/babysitter-codex/scripts/team-install.js
97
- test -f ~/.codex/skills/babysitter-codex/.codex/hooks.json
98
- test -f ~/.codex/skills/babysitter-codex/.codex/hooks/babysitter-stop-hook.sh
99
- ```
72
+ 1. Resolves the installed package root.
73
+ 2. Reads `babysitter.lock.json`.
74
+ 3. Clones or updates the upstream Babysitter repo into
75
+ `<workspace>/.a5c/process-library/babysitter-repo`.
76
+ 4. Binds `<workspace>/.a5c/process-library/babysitter-repo/library` with
77
+ `babysitter process-library:use`.
78
+ 5. Writes `<workspace>/.a5c/active/process-library.json`.
79
+ 6. Writes or refreshes `<workspace>/.codex/hooks.json`.
80
+ 7. Creates or merges `<workspace>/.codex/config.toml` so the workspace has the
81
+ required Codex settings.
82
+ 8. Writes `<workspace>/.a5c/team/install.json`.
83
+ 9. Creates `<workspace>/.a5c/team/profile.json` if it does not already exist.
100
84
 
101
- Verify the active process-library binding:
85
+ It does not create an external orchestrator, bundle the process library, or
86
+ turn the workspace into a fake Codex plugin manifest.
102
87
 
103
- ```bash
104
- babysitter process-library:active --state-dir /path/to/repo/.a5c --json
105
- ```
88
+ ## Resulting Workspace Files
106
89
 
107
- Manual bootstrap uses the same SDK CLI flow:
90
+ After a successful workspace install, the important files are:
108
91
 
109
- ```bash
110
- babysitter process-library:clone --repo https://github.com/a5c-ai/babysitter.git --dir .a5c/process-library/babysitter-repo
111
- babysitter process-library:use --dir .a5c/process-library/babysitter-repo/library --state-dir .a5c
112
- babysitter process-library:active --state-dir .a5c --json
113
- ```
92
+ - `.codex/hooks.json`
93
+ - `.codex/config.toml`
94
+ - `.a5c/team/install.json`
95
+ - `.a5c/team/profile.json`
96
+ - `.a5c/active/process-library.json`
97
+ - `.a5c/process-library/babysitter-repo/library`
114
98
 
115
- ## Quick Start
99
+ ## Using It In Codex
116
100
 
117
- Use command phrases in Codex chat:
101
+ Use normal Codex chat phrases:
118
102
 
119
103
  ```text
120
- babysitter help
121
104
  babysitter call implement authentication with tests
122
- babysitter yolo fix lint and failing tests
123
- babysitter resume latest incomplete run
124
- babysitter doctor current run
105
+ babysitter resume
106
+ babysitter doctor
107
+ babysitter team-install
108
+ babysitter project-install
125
109
  ```
126
110
 
127
- For Codex users, the expected interface is the Codex command phrases plus the
128
- workspace hook install created by onboarding. Raw Babysitter CLI primitives are
129
- internal harness details and live in the Codex skill, not in this user-facing
130
- README.
111
+ The Codex skill and hooks own the plugin flow. Low-level SDK commands are still
112
+ the runtime mechanism, but they are not the user-facing interface.
131
113
 
132
- ## Project And Team Install
114
+ ## Verification
133
115
 
134
- Use `babysitter team-install` and `babysitter project-install` from Codex chat
135
- when you want workspace onboarding. They layer pinned config and setup around
136
- the active process roots already used at runtime; they are not the source of
137
- truth for process discovery.
116
+ Verify the installed skill bundle:
117
+
118
+ ```bash
119
+ npm ls -g @a5c-ai/babysitter-codex --depth=0
120
+ ls -1 ~/.codex/skills/babysitter-codex
121
+ test -f ~/.codex/skills/babysitter-codex/scripts/team-install.js
122
+ test -f ~/.codex/skills/babysitter-codex/.codex/hooks/babysitter-stop-hook.sh
123
+ ```
124
+
125
+ Verify the active process-library binding for a workspace:
126
+
127
+ ```bash
128
+ babysitter process-library:active --state-dir /path/to/repo/.a5c --json
129
+ ```
138
130
 
139
- ## Documentation
131
+ ## Docs
140
132
 
141
133
  - [commands/README.md](./commands/README.md)
142
134
  - Internal orchestration details: [.codex/skills/babysitter/call/SKILL.md](./.codex/skills/babysitter/call/SKILL.md)
package/SKILL.md CHANGED
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  name: babysitter-codex
3
3
  description: >-
4
- Run babysitter workflows from Codex using real Codex surfaces: skills,
5
- AGENTS.md guidance, project config, lifecycle hooks, and the Babysitter SDK
6
- runtime loop.
4
+ Run babysitter workflows from Codex using the installed skill bundle,
5
+ workspace Codex hooks, workspace Codex config, and the Babysitter SDK runtime
6
+ loop.
7
7
  Use when the user wants to babysit a task, resume a run, diagnose run health,
8
8
  install the Codex skill, or assimilate a methodology for Codex.
9
9
  ---
@@ -12,20 +12,16 @@ description: >-
12
12
 
13
13
  Babysitter on Codex is implemented as:
14
14
 
15
- - Codex-facing instructions and skills
16
- - A workspace `.codex/hooks.json` with `SessionStart`, `UserPromptSubmit`, and
17
- `Stop` registrations
18
- - A `.a5c` state directory in the target workspace
19
- - The Babysitter SDK run/task loop that owns `run:create`, `run:iterate`,
20
- `task:post`, breakpoint handling, and resume behavior
21
- - Optional `notify` monitoring only as secondary telemetry
22
-
23
- Codex does expose real lifecycle hooks for this package on supported
24
- installations. Do not replace them with an external orchestrator or claim that
25
- `notify` owns continuation.
26
- Codex also does not expose a native installable plugin manifest for this
27
- package. Treat `.codex/command-catalog.json` as Babysitter compatibility
28
- metadata for the skill bundle, not as a Codex platform feature.
15
+ - the installed skill bundle under `~/.codex/skills/babysitter-codex`
16
+ - workspace `.codex/hooks.json`
17
+ - workspace `.codex/config.toml`
18
+ - workspace `.a5c/`
19
+ - the Babysitter SDK CLI for `run:create`, `run:iterate`, `run:status`,
20
+ `task:list`, `task:post`, and process-library binding
21
+
22
+ This package supports only the hooks model for the Codex plugin path. Do not
23
+ introduce an app-server loop, an external orchestrator, or fake plugin-manifest
24
+ machinery for the Codex integration.
29
25
 
30
26
  ## Choosing a Mode
31
27
 
@@ -45,9 +41,9 @@ If the user intent is unclear, default to `call/SKILL.md`.
45
41
  | Install team-pinned setup | `team-install` |
46
42
  | Assimilate external methodology | `assimilate` |
47
43
 
48
- ## Internal Runtime Contract
44
+ ## Runtime Contract
49
45
 
50
- Use the babysitter SDK CLI for orchestration:
46
+ Use the Babysitter SDK CLI for orchestration:
51
47
 
52
48
  ```bash
53
49
  babysitter run:create --process-id <id> --entry <path>#<export> ...
@@ -69,16 +65,34 @@ babysitter run:create ... --harness codex --session-id <id> --state-dir .a5c --j
69
65
  2. Post it with `babysitter task:post`
70
66
  3. Never write `result.json` directly
71
67
 
72
- ## Codex Hook Loop
68
+ ## Hook Loop
73
69
 
74
- The workspace onboarding flow should install `.codex/config.toml` and
75
- `.codex/hooks.json` so:
70
+ Workspace onboarding must install `.codex/hooks.json` and `.codex/config.toml`
71
+ so:
76
72
 
77
73
  1. `SessionStart` seeds `.a5c` session state
78
74
  2. `UserPromptSubmit` performs prompt-time transformations when needed
79
75
  3. `Stop` decides whether the run is complete or Codex should receive the next
80
76
  Babysitter iteration context
81
77
 
78
+ ## Process Library Model
79
+
80
+ The Codex package does not bundle the process library.
81
+
82
+ Workspace onboarding must:
83
+
84
+ 1. clone or update the upstream Babysitter repo into
85
+ `.a5c/process-library/babysitter-repo`
86
+ 2. bind `.a5c/process-library/babysitter-repo/library` with
87
+ `babysitter process-library:use`
88
+ 3. resolve the active binding later with
89
+ `babysitter process-library:active --state-dir .a5c --json`
90
+
91
+ Preferred discovery order:
92
+
93
+ 1. project-local `.a5c/processes`
94
+ 2. the active SDK-managed process-library binding
95
+
82
96
  ## Codex-Specific Rules
83
97
 
84
98
  - Prefer natural-language activation such as `babysitter call ...`
@@ -16,7 +16,6 @@ const PACKAGE_ROOT = path.resolve(__dirname, '..');
16
16
  const IS_WIN = process.platform === 'win32';
17
17
  const INSTALL_ENTRIES = [
18
18
  { source: 'SKILL.md', required: true },
19
- { source: 'AGENTS.md', required: true },
20
19
  { source: 'README.md', required: true },
21
20
  { source: 'agents', required: true },
22
21
  { source: 'bin', required: true },
@@ -24,4 +24,3 @@ babysitter assimilate https://github.com/org/methodology
24
24
  ## Notes
25
25
 
26
26
  - Use command phrases in Codex chat (`babysitter ...`), not custom slash commands.
27
- - If SDK capabilities are missing in your installed version, babysitter-codex falls back to compatibility behavior where possible.
package/commands/call.md CHANGED
@@ -27,4 +27,3 @@ babysitter call implement auth with tests
27
27
  - The primary Codex plugin path is hook-first through `.codex/hooks.json` (`SessionStart`, `UserPromptSubmit`, `Stop`).
28
28
  - Low-level runtime mechanics live here and in `.codex/skills/babysitter/call/SKILL.md`, not in the top-level README or install guide.
29
29
  - The implementation should create or bind honestly, let the `Stop` hook own continuation, write value payloads to `output.json`, and post outcomes through SDK commands rather than direct `result.json` writes.
30
- - If SDK capabilities are missing in your installed version, babysitter-codex falls back to compatibility behavior where possible.
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: Diagnose run/runtime health and compatibility.
2
+ description: Diagnose run/runtime health and installation.
3
3
  argument-hint: [run-id|mcp]
4
4
  ---
5
5
 
@@ -7,7 +7,7 @@ argument-hint: [run-id|mcp]
7
7
 
8
8
  ## Purpose
9
9
 
10
- Diagnose run/runtime health and compatibility.
10
+ Diagnose run/runtime health and installation.
11
11
 
12
12
  ## Usage
13
13
 
@@ -24,4 +24,4 @@ babysitter doctor mcp
24
24
  ## Notes
25
25
 
26
26
  - Use command phrases in Codex chat (`babysitter ...`), not custom slash commands.
27
- - If SDK capabilities are missing in your installed version, babysitter-codex falls back to compatibility behavior where possible.
27
+ - Check the workspace hook/config install, active process-library binding, and run state.
@@ -24,4 +24,3 @@ babysitter forever monitor production error trends daily
24
24
  ## Notes
25
25
 
26
26
  - Use command phrases in Codex chat (`babysitter ...`), not custom slash commands.
27
- - If SDK capabilities are missing in your installed version, babysitter-codex falls back to compatibility behavior where possible.
package/commands/help.md CHANGED
@@ -25,4 +25,3 @@ babysitter help command doctor
25
25
 
26
26
  - Use command phrases in Codex chat (`babysitter ...`), not custom slash commands.
27
27
  - Codex chat owns the loop through the hook model in `.codex/hooks.json`; `Stop` is the continuation owner.
28
- - If SDK capabilities are missing in your installed version, babysitter-codex falls back to compatibility behavior where possible.
package/commands/issue.md CHANGED
@@ -24,4 +24,3 @@ babysitter issue 123 --repo owner/repo --apply
24
24
  ## Notes
25
25
 
26
26
  - Use command phrases in Codex chat (`babysitter ...`), not custom slash commands.
27
- - If SDK capabilities are missing in your installed version, babysitter-codex falls back to compatibility behavior where possible.
package/commands/model.md CHANGED
@@ -24,4 +24,3 @@ babysitter model set plan=gpt-5 execute=gpt-5-codex
24
24
  ## Notes
25
25
 
26
26
  - Use command phrases in Codex chat (`babysitter ...`), not custom slash commands.
27
- - If SDK capabilities are missing in your installed version, babysitter-codex falls back to compatibility behavior where possible.
@@ -24,4 +24,3 @@ babysitter observe current workspace
24
24
  ## Notes
25
25
 
26
26
  - Use command phrases in Codex chat (`babysitter ...`), not custom slash commands.
27
- - If SDK capabilities are missing in your installed version, babysitter-codex falls back to compatibility behavior where possible.
package/commands/plan.md CHANGED
@@ -24,4 +24,3 @@ babysitter plan migration from monolith to services
24
24
  ## Notes
25
25
 
26
26
  - Use command phrases in Codex chat (`babysitter ...`), not custom slash commands.
27
- - If SDK capabilities are missing in your installed version, babysitter-codex falls back to compatibility behavior where possible.