@ibgib/web-gib 0.0.20 → 0.0.22

package/README.md

@@ -21,6 +21,38 @@ All ibgib code is TypeScript + ES Modules.
 * .web.mts - web (not node)
 * .app.mts - blank-gib app (not the web extension)
 
+## AI Agent Skills (Scaffolding)
+
+In lieu of a heavy framework CLI, the `@ibgib/web-gib` package comes bundled with built-in agent instructions and templates structure to help your IDE's AI agents natively scaffold new ibgib applications, components, and shells.
+
+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.
+
+**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, `npx` at the root will fail to locate the binary. To initialize the `.agents` folder at your monorepo root, you have two choices:
+
+*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:
+```bash
+npm run init-agents
+```
+
+*Choice B:* Force `npx` to resolve the package locally:
+```bash
+npx -p @ibgib/web-gib web-gib-init-agents
+```
+
 ## 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.20",
+  "version": "0.0.22",
   "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
     });