@ibgib/web-gib 0.0.23 → 0.0.26

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

@@ -0,0 +1,84 @@
+---
+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
+
+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.
+
+## Required Inputs
+When invoking this skill or when the user asks for guided refactoring, ensure you have:
+1.  **Target file path**: The file to be refactored.
+2.  **Styleguide file path**: The markdown file containing the stylistic or architectural rules.
+3.  **Refactor Focus**: A description of the focus or subset of rules to apply (e.g. "function review rules", "naming conventions").
+
+## Step-by-Step Workflow
+
+Follow these steps exactly in order:
+
+### Step 1: Generate Metadata File
+1. Read the provided styleguide file.
+2. Based on the **Refactor Focus** provided by the user, extract ONLY the relevant subset of rules/guidelines. Do NOT extract the entire styleguide unless explicitly requested.
+3. Create a markdown tracking file at `[target_file_path].metadata.md` (e.g., if the target is `path/to/file.ext`, the metadata file is `path/to/file.ext.metadata.md`).
+3. Format the metadata file exactly as follows, populating the `## guidelines` section with the extracted rules:
+
+```markdown
+# agent refactor metadata
+
+## guidelines
+
+* rule 1
+* rule 2
+  * optional clarification to rule 2
+* rule 3
+etc...
+
+## path/to/file.ext
+
+[changes will go here]
+```
+
+### Step 2: Prompt for User Review
+1. **STOP execution**.
+2. Use the `notify_user` tool to prompt the user to review the generated metadata file.
+3. Set `BlockedOnUser: true` and pass the new metadata file's path in `PathsToReview`.
+4. Instruct the user: "Please review the generated metadata file. Delete any rules under the `## guidelines` section that you do NOT want applied to the file, leave any optional clarifications or notes, and then let me know when you are ready to proceed."
+
+### Step 3: Perform Refactor
+1. Once the user replies that they are ready, re-read the `[target_file_path].metadata.md` file.
+2. Identify which rules the user left under `## guidelines`.
+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`
+   * 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.
+
+
+### Step 4: Document Changes
+1. After refactoring the target file, update the `[target_file_path].metadata.md` file with a summary of the exact changes made.
+2. Document the changes under the `## [path/to/file.ext]` section.
+3. Include a timestamp and a breakdown of the modifications per rule and line number, with the diff or changed code in triple-backtick blocks.
+4. The updated section MUST follow this exact format:
+
+```markdown
+## path/to/file.ext
+
+### YYYY/MM/DD - hh:mm A/PM
+
+#### line [line_number] - [rule_name]
+
+\`\`\`[language_extension]
+[triple-backtick code block here of changes]
+\`\`\`
+
+#### line [line_number] - [rule_name]
+
+\`\`\`[language_extension]
+[triple-backtick code block here of changes]
+\`\`\`
+```
+
+### Step 5: Final Review
+Notify the user that the refactoring is complete, and if they have further files to process, repeat the skill.

package/tools/auto-generated-agent-skills/skills/ibgib-targeted-refactoring/generate-id.js

@@ -0,0 +1,9 @@
+const crypto = require('crypto');
+
+const yearStr = new Date().getFullYear().toString().slice(-2);
+
+for (let i = 0; i < 10; i++) {
+    const hash = crypto.createHash('md5').update(crypto.randomBytes(16)).digest('hex');
+    const id = hash.slice(0, 30) + yearStr;
+    console.log(id);
+}

package/tools/copy-agent-skills.js

@@ -0,0 +1,51 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const lc = `[${import.meta.url}]`;
+console.log(`${lc} starting...`);
+
+// The source .agents folder is at the monorepo root: libs/web-gib/../../../.agents
+const sourceAgentsDir = path.resolve(__dirname, '../../../.agents');
+// The target is libs/web-gib/tools/auto-generated-agent-skills
+const targetAgentsDir = path.resolve(__dirname, './auto-generated-agent-skills');
+
+if (!fs.existsSync(sourceAgentsDir)) {
+    console.error(`${lc} Error: Source directory not found: ${sourceAgentsDir}`);
+    process.exit(1);
+}
+
+try {
+    if (fs.existsSync(targetAgentsDir)) {
+        fs.rmSync(targetAgentsDir, { recursive: true, force: true });
+    }
+    
+    // We only want to copy skills that start with "ibgib-"
+    const sourceSkillsDir = path.join(sourceAgentsDir, 'skills');
+    const targetSkillsDir = path.join(targetAgentsDir, 'skills');
+    
+    if (fs.existsSync(sourceSkillsDir)) {
+        fs.mkdirSync(targetSkillsDir, { recursive: true });
+        const skillDirs = fs.readdirSync(sourceSkillsDir, { withFileTypes: true });
+        
+        let copyCount = 0;
+        for (const dirent of skillDirs) {
+            if (dirent.isDirectory() && dirent.name.startsWith('ibgib-')) {
+                const srcPath = path.join(sourceSkillsDir, dirent.name);
+                const destPath = path.join(targetSkillsDir, dirent.name);
+                fs.cpSync(srcPath, destPath, { recursive: true });
+                copyCount++;
+            }
+        }
+        console.log(`${lc} successfully copied ${copyCount} 'ibgib-' prefixed skills to ${targetAgentsDir}`);
+    } else {
+        console.log(`${lc} No skills directory found in source.`);
+    }
+
+} catch (e) {
+    console.error(`${lc} Error copying agent skills:`, e);
+    process.exit(1);
+}

package/{generate-version-file.js → tools/generate-version-file.js}

@@ -2,7 +2,7 @@
 import * as pathUtils from 'path';
 import { writeFile } from 'node:fs/promises';
 
-import packageJson from './package.json' with {type: 'json'};
+import packageJson from '../package.json' with {type: 'json'};
 
 const lc = `[${import.meta.url}]`;
 console.log(`${lc} starting... (I: 1cb5f4175a1e2ccff8045ec622ed6825)`)

package/tools/init-agents.js

@@ -2,6 +2,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import readline from 'node:readline/promises';
 
 // ESM doesn't natively have __dirname, so we reconstruct it.
 const __filename = fileURLToPath(import.meta.url);
@@ -9,9 +10,8 @@ const __dirname = path.dirname(__filename);
 
 const logPref = '[web-gib init-agents]';
 
-// Target the .agents folder at the package root
-const packageRoot = path.resolve(__dirname, '..');
-const sourceAgentsDir = path.join(packageRoot, '.agents');
+// Target the auto-generated-agent-skills folder in the tools directory
+const sourceAgentsDir = path.join(__dirname, 'auto-generated-agent-skills');
 
 // The consumer's repository root (where they run npx web-gib-init-agents)
 const targetAgentsDir = path.join(process.cwd(), '.agents');
@@ -25,15 +25,56 @@ console.log(`${logPref} Copying ibgib agent skills...`);
 console.log(`${logPref} From: ${sourceAgentsDir}`);
 console.log(`${logPref} To:   ${targetAgentsDir}`);
 
+const sourceSkillsDir = path.join(sourceAgentsDir, 'skills');
+const targetSkillsDir = path.join(targetAgentsDir, 'skills');
+
+if (!fs.existsSync(sourceSkillsDir)) {
+    console.error(`${logPref} Error: Source skills directory not found at ${sourceSkillsDir}`);
+    process.exit(1);
+}
+
+// Ensure the target skills directory exists
+if (!fs.existsSync(targetSkillsDir)) {
+    fs.mkdirSync(targetSkillsDir, { recursive: true });
+}
+
+const skillDirs = fs.readdirSync(sourceSkillsDir, { withFileTypes: true });
+const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
 try {
-    fs.cpSync(sourceAgentsDir, targetAgentsDir, {
-        recursive: true,
-        // Setting force to false ensures we DO NOT overwrite existing templates
-        force: false,
-        errorOnExist: false
-    });
-    console.log(`${logPref} ✅ Success! Agent skills have been initialized.`);
+    for (const dirent of skillDirs) {
+        if (!dirent.isDirectory()) continue;
+        
+        const skillName = dirent.name;
+        // Proceed only with explicitly targeted ibgib prefixed skills
+        if (!skillName.startsWith('ibgib-')) continue;
+
+        const srcSkillPath = path.join(sourceSkillsDir, skillName);
+        const targetSkillPath = path.join(targetSkillsDir, skillName);
+        
+        let shouldCopy = true;
+
+        if (fs.existsSync(targetSkillPath)) {
+            const answer = await rl.question(`${logPref} Skill folder '${skillName}' already exists. Overwrite? (y/N) `);
+            if (answer.toLowerCase() !== 'y') {
+                shouldCopy = false;
+                console.log(`${logPref} Skipped overwriting ${skillName}.`);
+            }
+        }
+        
+        if (shouldCopy) {
+            fs.cpSync(srcSkillPath, targetSkillPath, {
+                recursive: true,
+                force: true,
+                errorOnExist: false
+            });
+            console.log(`${logPref} ✅ Copied skill: ${skillName}`);
+        }
+    }
+    console.log(`${logPref} Finished initializing agent skills.`);
 } catch (error) {
     console.error(`${logPref} ❌ Failed to copy agent skills:`, error);
     process.exit(1);
+} finally {
+    rl.close();
 }