@ibgib/web-gib 0.0.22 → 0.0.23

package/README.md

@@ -35,22 +35,33 @@ npx web-gib-init-agents
 ```
 
 **Option 2 (For Monorepos & Workspaces)**
-If `@ibgib/web-gib` is a dependency on a sub-app (e.g. `apps/my-app`) instead of the workspace root, `npx` at the root will fail to locate the binary. To initialize the `.agents` folder at your monorepo root, you have two choices:
+If `@ibgib/web-gib` is a dependency on a sub-app (e.g. `apps/my-app`) instead of the workspace root, package manager "hoisting" rules may prevent the executable from appearing at your root level.
 
-*Choice A:* Add it as a passthrough script in your monorepo's root `package.json` (Recommended):
-```json
-  "scripts": {
-    "init-agents": "web-gib-init-agents"
-  }
-```
-Then execute it from the root:
+To properly initialize the `.agents` folder at your monorepo's root, pull from one of the following commands:
+
+*Choice A (Execute via npx):* Let `npx` automatically resolve and execute the binary hook from the package registry:
 ```bash
-npm run init-agents
+npx -p @ibgib/web-gib web-gib-init-agents
 ```
 
-*Choice B:* Force `npx` to resolve the package locally:
+*Choice B (Execute script directly):* Bypass the broken `.bin` symlink entirely and execute the raw script locally from within the nested workspace dependency:
 ```bash
-npx -p @ibgib/web-gib web-gib-init-agents
+node ./apps/my-app/node_modules/@ibgib/web-gib/tools/init-agents.js
+```
+
+**Recommendation for Monorepos:** 
+To streamline future updates, it is highly recommended to map whichever execution method you prefer directly into your root `package.json` scripts:
+
+```json
+  "scripts": {
+    "init-agents": "npx -p @ibgib/web-gib web-gib-init-agents"
+  }
+```
+Or for the direct script approach:
+```json
+  "scripts": {
+    "init-agents": "node ./apps/my-app/node_modules/@ibgib/web-gib/tools/init-agents.js"
+  }
 ```
 
 ## UI Architecture: Custom @ibgib component framework

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/web-gib",
-  "version": "0.0.22",
+  "version": "0.0.23",
   "description": "Framework for creating agentic ibGib web apps. Contains plumbing for ibgib components, agentic framework (currently only Gemini implemented), web-based IndexedDB storage substrate, and more.",
   "funding": {
     "type": "individual",