@a5c-ai/babysitter-codex 0.1.6-staging.dd5dc0db → 0.1.6-staging.e7446f7c

package/README.md

@@ -6,7 +6,8 @@ Babysitter in the Codex lifecycle loop.
 
 This is a Codex skill bundle plus workspace hook templates. It is not a
 Claude-style manifest plugin, but it does rely on Codex's real lifecycle hook
-engine through `.codex/hooks.json`.
+engine through `.codex/hooks.json`, and the package postinstall now wires the
+active workspace when the global install is launched from that workspace.
 
 ## What This Package Owns
 
@@ -61,6 +62,23 @@ Install from npm:
 npm install -g @a5c-ai/babysitter-codex
 ```
 
+If you run that command from inside the target repository, postinstall will:
+
+- install the skill payload into `CODEX_HOME`
+- merge `~/.codex/config.toml` so `codex_hooks` is enabled
+- materialize workspace `.codex/hooks.json` and `.codex/config.toml` for the
+  active workspace
+
+If you installed from somewhere else, run:
+
+```bash
+npm install -g @a5c-ai/babysitter-sdk
+babysitter harness:install-plugin codex --workspace /path/to/repo
+```
+
+`babysitter harness:install-plugin ...` is provided by the SDK CLI, so make
+sure `@a5c-ai/babysitter-sdk` is installed first.
+
 Or from a local checkout:
 
 ```bash

package/bin/postinstall.js

@@ -6,9 +6,10 @@
  * so Codex CLI discovers the skill globally for all projects.
  */
 
-const fs = require('fs');
-const path = require('path');
+const fs = require('fs');
+const path = require('path');
 const os = require('os');
+const { spawnSync } = require('child_process');
 
 const SKILL_NAME = 'babysitter-codex';
 const PACKAGE_ROOT = path.resolve(__dirname, '..');
@@ -32,6 +33,113 @@ function getCodexHome() {
   if (process.env.CODEX_HOME) return process.env.CODEX_HOME;
   return path.join(os.homedir(), '.codex');
 }
+
+function writeFileIfChanged(filePath, contents) {
+  if (fs.existsSync(filePath)) {
+    const current = fs.readFileSync(filePath, 'utf8');
+    if (current === contents) {
+      return false;
+    }
+  }
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, contents, 'utf8');
+  return true;
+}
+
+function mergeCodexHomeConfig(codexHome) {
+  const configPath = path.join(codexHome, 'config.toml');
+  const featureLines = [
+    '[features]',
+    'codex_hooks = true',
+    'multi_agent = true',
+  ];
+
+  if (!fs.existsSync(configPath)) {
+    writeFileIfChanged(
+      configPath,
+      [
+        'approval_policy = "on-request"',
+        'sandbox_mode = "workspace-write"',
+        '',
+        ...featureLines,
+        '',
+      ].join('\n')
+    );
+    console.log(`[babysitter-codex]   wrote ${configPath}`);
+    return;
+  }
+
+  let content = fs.readFileSync(configPath, 'utf8');
+  if (!/^\s*codex_hooks\s*=.*$/m.test(content)) {
+    if (/^\[features\]\s*$/m.test(content)) {
+      content = content.replace(
+        /^\[features\]\s*$/m,
+        ['[features]', 'codex_hooks = true', 'multi_agent = true'].join('\n')
+      );
+    } else {
+      content = [content.trimEnd(), '', ...featureLines, ''].join('\n');
+    }
+  } else if (!/^\s*multi_agent\s*=.*$/m.test(content) && /^\[features\]\s*$/m.test(content)) {
+    content = content.replace(
+      /^\[features\]\s*$/m,
+      ['[features]', 'multi_agent = true'].join('\n')
+    );
+  }
+
+  if (writeFileIfChanged(configPath, content)) {
+    console.log(`[babysitter-codex]   merged ${configPath}`);
+  }
+}
+
+function shouldAutoOnboardWorkspace(skillDir) {
+  const initCwd = process.env.INIT_CWD;
+  if (!initCwd) return null;
+
+  const resolved = path.resolve(initCwd);
+  if (!fs.existsSync(resolved)) return null;
+  if (!fs.statSync(resolved).isDirectory()) return null;
+
+  const normalizedWorkspace = resolved.toLowerCase();
+  const normalizedPackageRoot = PACKAGE_ROOT.toLowerCase();
+  const normalizedSkillDir = skillDir.toLowerCase();
+  if (normalizedWorkspace === normalizedPackageRoot || normalizedWorkspace === normalizedSkillDir) {
+    return null;
+  }
+
+  return resolved;
+}
+
+function autoOnboardWorkspace(skillDir) {
+  const workspace = shouldAutoOnboardWorkspace(skillDir);
+  if (!workspace) {
+    return;
+  }
+
+  const scriptPath = path.join(skillDir, 'scripts', 'team-install.js');
+  if (!fs.existsSync(scriptPath)) {
+    console.warn('[babysitter-codex] WARNING: team-install.js is missing; skipping workspace hook onboarding');
+    return;
+  }
+
+  const result = spawnSync(process.execPath, [scriptPath, '--workspace', workspace], {
+    cwd: workspace,
+    stdio: 'pipe',
+    encoding: 'utf8',
+    env: {
+      ...process.env,
+      BABYSITTER_PACKAGE_ROOT: skillDir,
+    },
+  });
+
+  if (result.status !== 0) {
+    console.warn(`[babysitter-codex] WARNING: workspace onboarding failed for ${workspace}`);
+    if (result.stdout) console.warn(result.stdout.trim());
+    if (result.stderr) console.warn(result.stderr.trim());
+    return;
+  }
+
+  console.log(`[babysitter-codex]   onboarded workspace hooks/config at ${workspace}`);
+}
 
 function copyRecursive(src, dest) {
   const stat = fs.statSync(src);
@@ -92,6 +200,7 @@ function main() {
     }
 
     verifyInstalledPayload(skillDir);
+    mergeCodexHomeConfig(codexHome);
 
     if (!IS_WIN) {
       const hookDir = path.join(skillDir, '.codex', 'hooks');
@@ -106,8 +215,10 @@ function main() {
       }
     }
 
+    autoOnboardWorkspace(skillDir);
+
     console.log('[babysitter-codex] Installation complete!');
-    console.log('[babysitter-codex] Restart Codex to pick up the new skill.');
+    console.log('[babysitter-codex] Restart Codex to pick up the updated skill and hook config.');
   } catch (err) {
     console.error(`[babysitter-codex] Failed to install skill files: ${err.message}`);
     process.exitCode = 1;

package/docs/INSTALL.md

@@ -3,12 +3,13 @@
 `babysitter-codex` installation has two layers:
 
 1. Install the global Codex skill payload into `~/.codex/skills/babysitter-codex`
-2. Optionally apply workspace onboarding with `team-install` and
-   `project-install`
+2. Materialize Codex hook/config wiring for the active workspace
 
-The second layer does not create a separate process-library universe. It adds
-config, profile, and pinned-content setup around the active process roots the
-runtime already uses.
+When you run `npm install -g @a5c-ai/babysitter-codex` from inside the target
+workspace, the postinstall now uses `INIT_CWD` to auto-apply the workspace
+hook/config wiring. If you install from somewhere else, use
+`babysitter harness:install-plugin codex --workspace <dir>` or the packaged
+`team-install` helper afterwards.
 
 ## 1. Global Skill Install
 
@@ -59,6 +60,9 @@ Test-Path "$HOME/.codex/skills/babysitter-codex/.codex/hooks.json"
 Test-Path "$HOME/.codex/skills/babysitter-codex/.codex/hooks/babysitter-stop-hook.sh"
 ```
 
+The installer also merges `~/.codex/config.toml` so `features.codex_hooks = true`
+is present for the local Codex install.
+
 ## 3. Active Process Roots After Install
 
 After install, Codex-facing docs and processes should prefer:
@@ -70,10 +74,20 @@ After install, Codex-facing docs and processes should prefer:
 
 Do not document the bundled upstream snapshot as the primary library root.
 
-## 4. Team And Project Onboarding
+## 4. Workspace Hook Onboarding
+
+If the global install was not launched from the target workspace, materialize
+the workspace-local `.codex/hooks.json` and `.codex/config.toml` after install:
+
+```bash
+npm install -g @a5c-ai/babysitter-sdk
+babysitter harness:install-plugin codex --workspace /path/to/repo
+```
+
+`babysitter harness:install-plugin ...` is provided by the Babysitter SDK CLI,
+so `@a5c-ai/babysitter-sdk` must already be installed.
 
-After the package is installed, use the Codex command surface from the target
-workspace:
+Equivalent packaged helper:
 
 ```text
 babysitter team-install
@@ -89,9 +103,8 @@ This setup:
   Codex hook model
 - prepares the repo for Codex-facing Babysitter usage
 
-It should be described as layering pinned configuration and install metadata.
-It should not be described as moving process discovery into a team-only or
-project-only library root.
+This onboarding layers pinned configuration and install metadata. It does not
+move process discovery into a team-only or project-only library root.
 
 ## 5. First Run Expectations
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a5c-ai/babysitter-codex",
-  "version": "0.1.6-staging.dd5dc0db",
+  "version": "0.1.6-staging.e7446f7c",
   "description": "Babysitter Codex skill bundle and integration package for OpenAI Codex CLI - multi-step AI workflows with the upstream process library, 15 orchestration modes, and BOM-safe SKILL installation",
   "scripts": {
     "test": "node test/integration.test.js && node test/harness.test.js && node test/plugin.test.js && node test/packaged-install.test.js && node test/features-1-10.test.js && node test/process-mining.test.js",
@@ -60,6 +60,6 @@
   },
   "homepage": "https://github.com/a5c-ai/babysitter/tree/main/plugins/babysitter-codex#readme",
   "dependencies": {
-    "@a5c-ai/babysitter-sdk": "0.0.183-staging.dd5dc0db"
+    "@a5c-ai/babysitter-sdk": "0.0.183-staging.e7446f7c"
   }
 }

package/test/packaged-install.test.js

@@ -69,6 +69,7 @@ try {
     env: {
       ...process.env,
       CODEX_HOME: codexHome,
+      INIT_CWD: workspaceRoot,
     },
   });
   assert.ok(installOutput.includes('Installation complete!'));
@@ -95,6 +96,11 @@ try {
   const installedSkill = fs.readFileSync(path.join(installedSkillRoot, 'SKILL.md'), 'utf8');
   assert.ok(installedSkill.includes('SessionStart'));
   assert.ok(installedSkill.includes('Stop'));
+  const homeConfig = fs.readFileSync(path.join(codexHome, 'config.toml'), 'utf8');
+  assert.ok(homeConfig.includes('codex_hooks = true'));
+  assert.ok(homeConfig.includes('multi_agent = true'));
+  assert.ok(fs.existsSync(path.join(workspaceRoot, '.codex', 'hooks.json')));
+  assert.ok(fs.existsSync(path.join(workspaceRoot, '.codex', 'config.toml')));
 
   const verifyOutput = run(process.execPath, [path.join(installedSkillRoot, 'scripts', 'verify-content-manifest.js')], {
     cwd: workspaceRoot,