@sublang/playbook 0.1.1 → 0.1.2

package/README.md

@@ -40,13 +40,13 @@ runtime ported to cligent's `tmux-play` host out of the box.
 
 ### Install (users)
 
-Install the package globally alongside its `@sublang/cligent` peer.
-The bundled production config wires Anthropic (Captain + Coder) and
-OpenAI Codex (Reviewer); both SDKs come along as direct dependencies
-of `@sublang/playbook`, so no extra install is needed:
+Install the package globally. The bundled production config wires
+Anthropic (Captain + Coder) and OpenAI Codex (Reviewer); `@sublang/
+cligent`, the two adapter SDKs, and `xstate` are all direct
+dependencies, so a single install pulls in everything:
 
 ```sh
-npm install -g @sublang/playbook @sublang/cligent
+npm install -g @sublang/playbook
 ```
 
 Each adapter reads its own auth: the Claude SDK uses your local
@@ -60,8 +60,10 @@ playbook-code
 ```
 
 The `playbook-code` bin resolves the bundled
-`tmux-play.production.config.yaml` and execs `tmux-play` against it; any
-extra flags pass through (`playbook-code --help` lists `tmux-play`'s).
+`tmux-play.production.config.yaml` and execs the bundled `tmux-play`
+CLI (from playbook's own `node_modules/@sublang/cligent`) against it;
+any extra flags pass through (`playbook-code --help` lists
+`tmux-play`'s).
 
 ### Install (contributors / from source)
 
@@ -170,7 +172,8 @@ package.
 
 ## Requirements
 
-- Node.js ≥ 20
+- Node.js ≥ 20.6.0 (the `playbook-code` shim uses
+  `import.meta.resolve`, unflagged since this release)
 - pnpm 9 (for the reference package)
 - A configured `tmux-play` host (for live Boss turns)
 

package/bin/playbook-code.js

@@ -3,33 +3,36 @@
 // SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
 
 // Thin shim that resolves the bundled tmux-play.production.config.yaml
-// relative to this script's own location and execs `tmux-play` against
-// it. Extra argv is forwarded verbatim, so callers can pass flags like
-// --window or override the config with a later --config of their own
-// (tmux-play uses the last --config wins).
-//
-// `tmux-play` is provided by the @sublang/cligent peer; this shim
-// expects it to be discoverable on PATH (npm install -g or a project's
-// node_modules/.bin).
+// relative to this script's own location and execs cligent's tmux-play
+// CLI from inside @sublang/playbook's own node_modules tree. We resolve
+// the CLI through cligent's `./tmux-play` subpath export instead of
+// relying on `tmux-play` being on PATH — npm global installs only link
+// bins from top-level packages, so a transitive cligent's bin won't
+// reach the user's PATH but its files are still resolvable here.
 
 import { spawn } from 'node:child_process';
-import { dirname, resolve } from 'node:path';
+import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const here = dirname(fileURLToPath(import.meta.url));
 const configPath = resolve(here, '..', 'tmux-play.production.config.yaml');
 
+// cligent's `./tmux-play` subpath export only declares "import"
+// (no "require"/"default"), so createRequire(...).resolve trips
+// ERR_PACKAGE_PATH_NOT_EXPORTED. import.meta.resolve uses ESM rules
+// and follows the "import" condition — works from Node 20.6+.
+const tmuxPlayIndexUrl = import.meta.resolve('@sublang/cligent/tmux-play');
+const tmuxPlayBin = join(dirname(fileURLToPath(tmuxPlayIndexUrl)), 'cli.js');
+
 const child = spawn(
-  'tmux-play',
-  ['--config', configPath, ...process.argv.slice(2)],
+  process.execPath,
+  [tmuxPlayBin, '--config', configPath, ...process.argv.slice(2)],
   { stdio: 'inherit' },
 );
 
 child.on('error', (err) => {
-  const reason = err && err.code === 'ENOENT' ? 'not found on PATH' : err.message;
   process.stderr.write(
-    `playbook-code: failed to launch tmux-play: ${reason}\n` +
-      "Install @sublang/cligent (which provides 'tmux-play') alongside @sublang/playbook.\n",
+    `playbook-code: failed to launch tmux-play (${tmuxPlayBin}): ${err.message}\n`,
   );
   process.exit(127);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sublang/playbook",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "description": "Reference CODE playbook — XState v5 FSM, host-agnostic runtime, and tmux-play adapter for a coder/reviewer/committer loop driven by GEARS spec items.",
   "license": "Apache-2.0",
@@ -22,7 +22,7 @@
     "tmux-play"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=20.6.0"
   },
   "files": [
     "code.fsm.ts",
@@ -63,19 +63,15 @@
     "access": "public",
     "provenance": true
   },
-  "peerDependencies": {
-    "@sublang/cligent": "^0.3.0",
-    "xstate": "^5.0.0"
-  },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.143",
-    "@openai/codex-sdk": "^0.130.0"
+    "@openai/codex-sdk": "^0.130.0",
+    "@sublang/cligent": "^0.3.0",
+    "xstate": "^5.19.4"
   },
   "devDependencies": {
-    "@sublang/cligent": "^0.3.0",
     "@types/node": "^22.0.0",
     "typescript": "^5.8.0",
-    "vitest": "^3.0.0",
-    "xstate": "^5.19.4"
+    "vitest": "^3.0.0"
   }
 }