@ibgib/web-gib 0.0.26 → 0.0.28

package/dist/AUTO-GENERATED-version.d.mts

@@ -10,5 +10,5 @@
 /**
  * this is the version of this package, auto-updated in the build process
  */
-export declare const AUTO_GENERATED_VERSION = "0.0.26";
+export declare const AUTO_GENERATED_VERSION = "0.0.28";
 //# sourceMappingURL=AUTO-GENERATED-version.d.mts.map

package/dist/AUTO-GENERATED-version.mjs

@@ -10,5 +10,5 @@
 /**
  * this is the version of this package, auto-updated in the build process
  */
-export const AUTO_GENERATED_VERSION = '0.0.26';
+export const AUTO_GENERATED_VERSION = '0.0.28';
 //# sourceMappingURL=AUTO-GENERATED-version.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ibgib/web-gib",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "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/src/AUTO-GENERATED-version.mts

@@ -11,4 +11,4 @@
 /**
  * this is the version of this package, auto-updated in the build process
  */
-export const AUTO_GENERATED_VERSION = '0.0.26';
+export const AUTO_GENERATED_VERSION = '0.0.28';

package/tools/auto-generated-agent-skills/deprecated-skills.json

@@ -0,0 +1,14 @@
+[
+  {
+    "name": "ibgib-scaffold-app",
+    "deprecatedVersion": "0.0.26",
+    "deprecatedDate": "2026-04-20",
+    "message": "Renamed to ibgib-create-app."
+  },
+  {
+    "name": "ibgib-add-core-engine",
+    "deprecatedVersion": "0.0.26",
+    "deprecatedDate": "2026-04-20",
+    "message": "Renamed to ibgib-create-app-core."
+  }
+]

package/tools/auto-generated-agent-skills/skills/{ibgib-scaffold-app → ibgib-create-app}/SKILL.md

@@ -1,9 +1,9 @@
 ---
-name: ibgib-scaffold-app
+name: ibgib-create-app
 description: The master coordinator skill for scaffolding a complete "Hello World" ibgib application. Orchestrates sub-skills for core engine, app witness, and UI shell.
 ---
 
-# ibgib-scaffold-app
+# ibgib-create-app
 
 This is a Meta-Skill that coordinates multiple sub-skills to create a functional, buildable ibgib application from scratch (Greenfield) or to add ibgib to an existing project (Brownfield).
 
@@ -12,10 +12,11 @@ To orchestrate the modular sub-skills so the final application is type-safe, bui
 
 ## Sub-Skills
 This coordinator uses:
-1. `ibgib-add-core-engine`: FOUNDATION (Bootstrap, Global State, Types).
+1. `ibgib-create-app-core`: FOUNDATION (Bootstrap, Global State, Types).
 2. `ibgib-create-app-witness`: LOGIC (App Witness class, commands, helpers).
 3. `ibgib-create-shell`: UI (Shell service, event handlers).
 4. `ibgib-create-component`: COMPONENT (Initial main app component - optional but recommended).
+  * _Note: You can simple create a plain-vanilla shell that is not encapsulated in an ibgib component, but you will be losing all of the plumbing associated with a backing ibgib which makes this the recommended pattern._
 
 ## Parameters (Shared State)
 The agent must generate and maintain these tokens across sub-skill executions:
@@ -29,11 +30,11 @@ The agent must generate and maintain these tokens across sub-skill executions:
 
 ## Workflow for Greenfield (Fresh App)
 1. **Prepare Tokens**: Generate/confirm all tokens. Generate UUIDs for IDs in templates.
-2. **Core Engine**: Call `ibgib-add-core-engine` to scaffold the 7 foundational files.
+2. **Core Engine**: Call `ibgib-create-app-core` to scaffold the 7 foundational files.
 3. **App Witness**: Call `ibgib-create-app-witness` to scaffold the witness logic.
 4. **UI Shell**: Call `ibgib-create-shell` to scaffold the shell service.
 5. **Main Component**: Call `ibgib-create-component` to create the initial app component.
-6. **Hook Up**: 
+6. **Hook Up**:
     - Update `bootstrap.mts` to use the shell service and register the component.
     - Create `package.json` and `tsconfig.json` (if in a new directory).
 

package/tools/auto-generated-agent-skills/skills/{ibgib-add-core-engine → ibgib-create-app-core}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: ibgib-add-core-engine
+name: ibgib-create-app-core
 description: >
   Scaffolds the foundational ibgib bootstrap flow and global state management.
   Generates the 7 foundational files (index.html, index.mts, bootstrap.mts,
@@ -7,7 +7,7 @@ description: >
   ibgib app to boot. Supports both greenfield and brownfield projects.
 ---
 
-# Skill: ibgib-add-core-engine
+# Skill: ibgib-create-app-core
 
 ## What This Skill Does
 
@@ -17,7 +17,7 @@ Generates the engineering foundation for an ibgib app. This includes:
 - **Storage**: Initializing IndexedDB spaces.
 - **Types & Helpers**: Providing the basic framework for identity and witness coordination.
 
-This skill is often the first step in creating a new app, or used to "ibgib-ify" an existing project. It does NOT generate the App Witness (the business logic) or the UI Shell; use `ibgib-create-app-witness` and `ibgib-create-shell` for those.
+This skill is often the first step in creating a new app, or used to "ibgib-ify" an existing project. It does this by bootstrapping the environment/storage so that global state, the "metaspace" and the default concrete local user space (backed by IndexedDB). It does NOT generate the App Witness (the business logic) or the UI Shell; use `ibgib-create-app-witness` and `ibgib-create-shell` for those.
 
 ---
 
@@ -27,7 +27,8 @@ This skill is often the first step in creating a new app, or used to "ibgib-ify"
 2. Verify that `@ibgib/ts-gib`, `@ibgib/helper-gib`, `@ibgib/core-gib`, and
    `@ibgib/web-gib` are available in the workspace.
 3. Confirm the project has an `AUTO-GENERATED-version.mts` file, or note that
-   one is needed.
+   one is needed. Create the `generate-version-file.js` if needed and incorporate in the prebuild script.
+   * the source for this that you can copy is at `.agents/skills/ibgib-create-app-core/generate-version-file.js`
 
 ---
 
@@ -52,7 +53,7 @@ This skill is often the first step in creating a new app, or used to "ibgib-ify"
 Derive tokens from the developer's answers. Generate a fresh `{{APP_UUID}}` using:
 
 ```bash
-node .agents/skills/ibgib-add-core-engine/generate-id.js
+node .agents/skills/ibgib-create-app-core/generate-id.js
 ```
 
 ### 2. Generate all files

package/tools/auto-generated-agent-skills/skills/ibgib-create-app-core/generate-version-file.js

@@ -0,0 +1,29 @@
+
+import * as pathUtils from 'path';
+import { writeFile } from 'node:fs/promises';
+
+import packageJson from '../package.json' with {type: 'json'};
+
+const lc = `[${import.meta.url}]`;
+console.log(`${lc} starting... (I: genuuid)`)
+
+const filePath = pathUtils.resolve('./src/AUTO-GENERATED-version.mts')
+
+const contents = `/**
+ * @module auto-generated-version
+ *
+ * CHANGES TO THIS FILE NOT BE SAVED
+ *
+ * this is automatically updated in the build process.
+ *
+ * CHANGES TO THIS FILE NOT BE SAVED
+ */
+
+/**
+ * this is the version of this package, auto-updated in the build process
+ */
+export const AUTO_GENERATED_VERSION = '${packageJson.version}';
+`;
+
+await writeFile(filePath, contents, { encoding: 'utf8' });
+console.log(`${lc} complete.`)

package/tools/auto-generated-agent-skills/skills/ibgib-create-app-witness/SKILL.md

@@ -10,7 +10,7 @@ description: >
 
 ## What This Skill Does
 
-Generates the "Brain" of an ibgib app. In ibgib architecture, the App Witness is a class that reacts to "Request Comments" (commands) sent by the user or-other agents.
+An ibgib alone is a data description. A "witness" is a class that provides behavior that wraps this ibgib data shape via a single function with the following basic shape: `witness(arg: IbGib_V1): Promise<IbGib_V1>`. So a witness provides a single binding point that takes in an ibgib and returns one. This skill generates the "Brain" of an ibgib app that implements this interface. Concretely, the generated app witness class is one that adds plumbing for parsing incoming comments (commands) sent by the user or-other agents. A web app defaults to a single configuration/comment (`--interactive`), but this can be extended to have features enabled/disabled per context.
 
 This skill scaffolds:
 - **App Class**: Inherits from `AppBase_V1` and handles the initial `--interactive` request to boot the app.
@@ -36,7 +36,7 @@ This skill scaffolds:
 ## Generation Steps
 
 ### 1. Confirm Tokens
-Ensure you have the same tokens used in `ibgib-add-core-engine`.
+Ensure you have the same tokens used in `ibgib-create-app-core`.
 
 ### 2. Generate Files
 Apply substitutions to templates and write to the target directory (usually `src/`).
@@ -51,9 +51,3 @@ Apply substitutions to templates and write to the target directory (usually `src
 
 ### 3. Replace `genuuid` placeholders
 Replace all `genuuid` strings in the templates with fresh IDs from `generate-id.js`.
-
----
-
-## Reference Implementations
-- `apps/learning/src/witness/app/pulmoniq-learning/` — Historical reference for full-featured witnesses.
-- `apps/website/src/witness/app/pulmoniq-website/` — Historical reference for shell-service witnesses.

package/tools/auto-generated-agent-skills/skills/ibgib-create-component/templates/components/component-name/component.mts.template

@@ -90,6 +90,8 @@ export class {{COMPONENT_CLASS_PREFIX}}ComponentInstance
         if (!this.elements) { throw new Error(`(UNEXPECTED) this.elements falsy? (E: genuuid)`); }
 
         // Map shadow root elements
+        // todo: complete this line. contentEl is required in ElementsBase
+        // this.elements.contentEl =
         this.elements.containerEl = this.shadowRoot!.getElementById('container') as HTMLDivElement;
         this.elements.titleEl = this.shadowRoot!.getElementById('title') as HTMLHeadingElement;
 

package/tools/auto-generated-agent-skills/skills/ibgib-create-shell/templates/ui/shell/shell-service.mts.template

@@ -21,7 +21,7 @@ export class {{APP_CLASSNAME_PREFIX}}ShellService {
     private shellContainer: HTMLElement | null = null;
 
     /**
-     * Promise that resolves when the shell service has completed its 
+     * Promise that resolves when the shell service has completed its
      * asynchronous initialization (e.g. component registration).
      */
     public initialized: Promise<void>;
@@ -46,8 +46,9 @@ export class {{APP_CLASSNAME_PREFIX}}ShellService {
         const lc = `${this.lc}[${this.registerComponents.name}]`;
         try {
             const componentsMeta: IbGibDynamicComponentMeta[] = [
-                // Add your component metas here, e.g.:
+                // Add your individual component metas or sets here, e.g.:
                 // new MyAwesomeComponentMeta(),
+                // ...MyAwesomeComponentsSet,
             ];
             const componentSvc = await getComponentSvc();
             for (let componentMeta of componentsMeta) {
@@ -123,7 +124,7 @@ export class {{APP_CLASSNAME_PREFIX}}ShellService {
 }
 
 /**
- * Returns the singleton instance of the Shell Service, initializing it on 
+ * Returns the singleton instance of the Shell Service, initializing it on
  * globalThis if necessary.
  */
 export function get{{APP_CLASSNAME_PREFIX}}ShellSvc(): {{APP_CLASSNAME_PREFIX}}ShellService {

package/tools/auto-generated-agent-skills/skills/ibgib-enum-pattern/SKILL.md

@@ -1,5 +1,6 @@
 ---
-description: TypeScript enum pattern used in this codebase
+name: ibgib-enum-pattern
+description: more robust and powerful enum pattern used in this codebase
 ---
 
 # Ibgib Enum Pattern Skill

package/tools/auto-generated-agent-skills/skills/ibgib-get-pattern/SKILL.md

@@ -1,4 +1,5 @@
 ---
+name: ibgib-get-pattern
 description: Patterns for robustly getting IbGibs from spaces
 ---
 
@@ -18,7 +19,7 @@ Always wrap retrieval logic in a `try..catch..finally` block to ensure errors ar
 const lc = `[${myFunctionName.name}]`;
 try {
     if (logalot) { console.log(`${lc} starting... (I: genuuid)`); }
-    
+
     // ... retrieval logic ...
 
 } catch (error) {
@@ -38,8 +39,8 @@ Use this when you have access to a `MetaspaceService` (It is often appropriate t
 ```typescript
 // Ensure space is provided or fallback to local user space
 space ??= await metaspace.getLocalUserSpace({ lock: false });
-if (!space) { 
-    throw new Error(`(UNEXPECTED) space falsy and we couldn't get default local user space from metaspace? (E: genuuid)`); 
+if (!space) {
+    throw new Error(`(UNEXPECTED) space falsy and we couldn't get default local user space from metaspace? (E: genuuid)`);
 }
 
 const resGet = await metaspace.get({ addrs, space });
@@ -70,8 +71,8 @@ if (resGet.success && resGet.ibGibs?.length === addrs.length) {
 } else {
     // Examine rawResultIbGib for more context
     const resIbGib = resGet.rawResultIbGib as IbGibSpaceResultIbGib<IbGib_V1, IbGibSpaceResultData, IbGibSpaceResultRel8ns>;
-    if (!resIbGib?.data) { 
-        throw new Error(`(UNEXPECTED) resGet.rawResultIbGib.data falsy? (E: genuuid)`); 
+    if (!resIbGib?.data) {
+        throw new Error(`(UNEXPECTED) resGet.rawResultIbGib.data falsy? (E: genuuid)`);
     }
     throw new Error(`(UNEXPECTED) couldn't find addrs? addrsNotFound: ${resIbGib.data.addrsNotFound}? space.ib: ${space.ib} (E: genuuid)`);
 }
@@ -86,7 +87,3 @@ if (resGet.success && resGet.ibGibs?.length === addrs.length) {
 | **Result Validation** | Always check `resGet.success` AND that the returned `ibGibs` array matches the expected length. |
 | **Debugging Context** | When a fetch fails, cast `resGet.rawResultIbGib` to `IbGibSpaceResultIbGib` and include `addrsNotFound` in the error message. |
 | **Space Fallback** | When using `metaspace`, consider falling back to `metaspace.getLocalUserSpace({ lock: false })` if no space is provided. |
-
-## Real-World Example
-
-See `apps/learning/src/common/parse/parse-helper.mts` -> `fetchLayer` for the reference implementation of this pattern.

package/tools/auto-generated-agent-skills/skills/ibgib-targeted-refactoring/SKILL.md

@@ -1,9 +1,9 @@
 ---
-name: Ibgib Targeted Refactoring
+name: ibgib-targeted-refactoring
 description: Refactor a file to conform to specified style guidelines, using a metadata file to track user-selected rules and code changes.
 ---
 
-# Ibgib Targeted Refactoring
+# ibgib-targeted-refactoring
 
 This skill guides the agent to refactor a target file using guidelines from a specified styleguide. The process relies on an intermediate review step where the user can pick exactly which guidelines to apply.
 
@@ -51,7 +51,7 @@ etc...
 3. Read the target file.
 4. **Apply only the remaining rules** to the target file. (If there is a helper script provided along with this skill, use it as instructed in the specific user prompt).
 5. **CRITICAL LOGGING RULE**: If any of the remaining rules involve tagging log messages, warnings, or errors (e.g., as specified by `STYLEGUIDE.md`: "* Tag ALL logging messages, warnings, and errors with the proper prefix, a uuid or 'genuuid', inside parens*"), you MUST run the provided custom script to generate actual IDs.
-   * Run the command: `node .agent/skills/targeted_refactoring/generate-id.js`
+   * Run the command: `node .agents/skills/ibgib-targeted-refactoring/generate-id.js`
    * This will output a list of 10 unique IDs ending in the current year.
    * Use these generated IDs to replace any placeholder `(genuuid)` strings in your newly refactored code (or anywhere you had to add a new tag). If you run out of IDs, just run the command again. Do NOT just insert the literal string `"genuuid"` in the final code.
 

package/tools/copy-agent-skills.js

@@ -22,6 +22,13 @@ try {
     if (fs.existsSync(targetAgentsDir)) {
         fs.rmSync(targetAgentsDir, { recursive: true, force: true });
     }
+    fs.mkdirSync(targetAgentsDir, { recursive: true });
+    
+    // Copy deprecated-skills.json if it exists
+    const deprecatedFileSrc = path.join(sourceAgentsDir, 'deprecated-skills.json');
+    if (fs.existsSync(deprecatedFileSrc)) {
+        fs.cpSync(deprecatedFileSrc, path.join(targetAgentsDir, 'deprecated-skills.json'));
+    }
     
     // We only want to copy skills that start with "ibgib-"
     const sourceSkillsDir = path.join(sourceAgentsDir, 'skills');

package/tools/init-agents.js

@@ -71,6 +71,52 @@ try {
             console.log(`${logPref} ✅ Copied skill: ${skillName}`);
         }
     }
+    
+    // Check for deprecated skills in the user's workspace
+    const deprecatedFilePath = path.join(sourceAgentsDir, 'deprecated-skills.json');
+    if (fs.existsSync(deprecatedFilePath)) {
+        try {
+            const deprecatedList = JSON.parse(fs.readFileSync(deprecatedFilePath, 'utf8'));
+            
+            if (deprecatedList && Array.isArray(deprecatedList) && deprecatedList.length > 0) {
+                let mostRecentDate = '';
+                for (const d of deprecatedList) {
+                    if (d.deprecatedDate && d.deprecatedDate > mostRecentDate) {
+                        mostRecentDate = d.deprecatedDate;
+                    }
+                }
+                const dateNote = mostRecentDate ? ` (most recently on ${mostRecentDate})` : '';
+                console.log(`\n${logPref} ℹ️  Notice: Some skills have been deprecated by ibGib${dateNote}. See deprecated-skills.json for details.`);
+            }
+            
+            const userSkills = fs.readdirSync(targetSkillsDir, { withFileTypes: true });
+            let foundDeprecated = false;
+            
+            for (const dirent of userSkills) {
+                if (!dirent.isDirectory()) continue;
+                const skillName = dirent.name;
+                const deprecated = deprecatedList.find(d => d.name === skillName);
+                
+                if (deprecated) {
+                    if (!foundDeprecated) {
+                        console.log(`\n${logPref} ⚠️  WARNING: DEPRECATED SKILLS DETECTED IN YOUR WORKSPACE ⚠️`);
+                        console.log(`${logPref} The following skills in your ${targetSkillsDir} folder are deprecated:`);
+                        foundDeprecated = true;
+                    }
+                    const versionString = deprecated.deprecatedVersion ? ` (v${deprecated.deprecatedVersion})` : '';
+                    const dateString = deprecated.deprecatedDate ? ` [${deprecated.deprecatedDate}]` : '';
+                    const msgString = deprecated.message ? ` - ${deprecated.message}` : '';
+                    console.log(`${logPref}   * ${skillName}${versionString}${dateString}${msgString}`);
+                }
+            }
+            if (foundDeprecated) {
+                console.log(`${logPref} Note: Deprecated skills are NOT auto-deleted. You may safely remove them manually.\n`);
+            }
+        } catch (e) {
+            console.error(`${logPref} Error reading deprecated skills list:`, e);
+        }
+    }
+    
     console.log(`${logPref} Finished initializing agent skills.`);
 } catch (error) {
     console.error(`${logPref} ❌ Failed to copy agent skills:`, error);