@tagma/sdk 0.3.8 → 0.3.9

package/README.md

@@ -1,11 +1,25 @@
 # @tagma/sdk
 
-A local AI task orchestration SDK for [Bun](https://bun.sh). Define multi-track pipelines in YAML, run AI coding agents (Claude Code, Codex, OpenCode) and shell commands in parallel with dependency resolution, approval gates, and lifecycle hooks.
+> ## ⚠️ Bun-only package — do **not** `npm install`
+>
+> ```bash
+> bun add @tagma/sdk
+> ```
+>
+> This package ships TypeScript source (`main: ./src/sdk.ts`) and relies on
+> Bun's native `.ts` loader. `npm` / `yarn` / `pnpm` installs are blocked by a
+> `preinstall` guard and will fail by design. Get Bun at <https://bun.sh>.
+>
+> *(The `npm i @tagma/sdk` line in the npmjs.com sidebar is auto-generated by
+> the npm registry website and cannot be removed — please ignore it and use
+> the command above.)*
 
-> **Bun ≥ 1.3 required.** `node` + `npm` are not supported — this package ships TypeScript source (`main: ./src/sdk.ts`) and relies on Bun's native `.ts` loader. Install with `bun add`, not `npm install`.
+A local AI task orchestration SDK for [Bun](https://bun.sh). Define multi-track pipelines in YAML, run AI coding agents (Claude Code, Codex, OpenCode) and shell commands in parallel with dependency resolution, approval gates, and lifecycle hooks.
 
 ## Install
 
+**Requires Bun ≥ 1.3.** Node/npm are not supported.
+
 ```bash
 bun add @tagma/sdk
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tagma/sdk",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -15,13 +15,15 @@
     ".": "./src/sdk.ts"
   },
   "files": [
-    "src"
+    "src",
+    "scripts/preinstall.js"
   ],
   "engines": {
     "bun": ">=1.3"
   },
   "packageManager": "bun@1.3.7",
   "scripts": {
+    "preinstall": "node scripts/preinstall.js",
     "test": "bun test",
     "release": "bun scripts/release.ts",
     "release:publish": "bun scripts/release.ts --publish"

package/scripts/preinstall.js

@@ -0,0 +1,38 @@
+// Preinstall guard — refuses installation under npm / yarn / pnpm.
+// @tagma/sdk ships TypeScript source (main: ./src/sdk.ts) and relies on
+// Bun's native .ts loader, so installing under Node-based managers leaves
+// users with a broken package.
+//
+// Bun detection: we can't rely on process.versions.bun alone, because bun
+// invokes lifecycle scripts via the interpreter named in the script command
+// ("node scripts/preinstall.js" runs under node even when called from bun
+// install). Bun does, however, set npm_config_user_agent to a string that
+// starts with "bun/<version> ...", which is the canonical cross-manager
+// signal. Check both for safety.
+
+const ua = process.env.npm_config_user_agent || '';
+if (process.versions.bun || ua.startsWith('bun/') || ua.startsWith('bun ')) {
+  process.exit(0);
+}
+
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+
+process.stderr.write(
+  [
+    '',
+    red(bold('  @tagma/sdk requires Bun (>= 1.3).')),
+    '',
+    '  This package ships TypeScript source and uses Bun\'s native .ts loader.',
+    '  npm / yarn / pnpm cannot consume it.',
+    '',
+    '  Install with:',
+    cyan('    bun add @tagma/sdk'),
+    '',
+    '  Get Bun: https://bun.sh',
+    '',
+  ].join('\n') + '\n',
+);
+
+process.exit(1);