@ibgib/web-gib 0.0.21 → 0.0.23

package/README.md

@@ -27,12 +27,43 @@ In lieu of a heavy framework CLI, the `@ibgib/web-gib` package comes bundled wit
 
 Because AI coding assistants typically do not read files inside `node_modules`, you must initialize these skills by copying them directly into your project's root folder. You can do this manually, or we have provided a simple script to do the copying for you.
 
-To initialize or update your agent skills, run the bundled executable in your terminal:
+**Option 1 (For standard projects)**
+If `@ibgib/web-gib` is installed at your project root, you can run the executable directly via `npx`:
 
 ```bash
 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, package manager "hoisting" rules may prevent the executable from appearing at your root level.
+
+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
+npx -p @ibgib/web-gib web-gib-init-agents
+```
+
+*Choice B (Execute script directly):* Bypass the broken `.bin` symlink entirely and execute the raw script locally from within the nested workspace dependency:
+```bash
+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
 
 **tl;dr**: _Web Component-based components react to ibgib's unique Merkle DAG DLT time-centric data model._

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/web-gib",
-  "version": "0.0.21",
+  "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",

package/tools/init-agents.js

@@ -1,11 +1,15 @@
 #!/usr/bin/env node
-const fs = require('fs');
-const path = require('path');
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// ESM doesn't natively have __dirname, so we reconstruct it.
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 
 const logPref = '[web-gib init-agents]';
 
-// Assuming this file is placed at <package_root>/tools/init-agents.js
-// so the package root is exactly one directory up.
+// Target the .agents folder at the package root
 const packageRoot = path.resolve(__dirname, '..');
 const sourceAgentsDir = path.join(packageRoot, '.agents');
 
@@ -22,11 +26,9 @@ console.log(`${logPref} From: ${sourceAgentsDir}`);
 console.log(`${logPref} To:   ${targetAgentsDir}`);
 
 try {
-    // cpSync is available in Node 16.7+
     fs.cpSync(sourceAgentsDir, targetAgentsDir, {
         recursive: true,
         // Setting force to false ensures we DO NOT overwrite existing templates
-        // if the consumer has customized them for their own project!
         force: false,
         errorOnExist: false
     });