@mcpher/gas-fakes 2.3.13 → 2.3.14

package/gf_agent/scripts/builder.js

@@ -1,67 +1,97 @@
 import fs from 'fs/promises';
 import path from 'path';
+import { fileURLToPath } from 'url';
 
-const PROGRESS_DIR = './progress';
-const SKILLS_DIR = './gf_agent/skills';
-const INDEX_FILE = './gf_agent/index.md';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// The script is at gf_agent/scripts/builder.js, so the root is one level up
+const GF_AGENT_DIR = path.resolve(__dirname, '..');
+
+// Standardize paths relative to the gf_agent directory
+const SKILLS_DIR = path.join(GF_AGENT_DIR, 'skills');
+const INDEX_FILE = path.join(GF_AGENT_DIR, 'index.md');
+const TEMPLATE_FILE = path.join(__dirname, 'SKILL.template.md');
+const KNOWLEDGE_DIR = path.join(GF_AGENT_DIR, 'knowledge');
+const SKILL_OUTPUT = path.join(GF_AGENT_DIR, 'SKILL.md');
+
+// Use CWD for progress dir to allow user to provide it in a sparse clone/standalone env
+const PROGRESS_DIR = path.resolve(process.cwd(), 'progress');
 
 async function build() {
-  await fs.mkdir(SKILLS_DIR, { recursive: true });
+  // Cleanup potential junk from previous runs where paths were relative to CWD 
+  // (e.g. if run from within gf_agent/scripts, it might have created gf_agent/scripts/gf_agent)
+  try {
+    const junkDir = path.join(__dirname, 'gf_agent');
+    await fs.rm(junkDir, { recursive: true, force: true });
+  } catch (err) {
+    // Ignore
+  }
 
-  const files = await fs.readdir(PROGRESS_DIR);
-  const mdFiles = files.filter(f => f.endsWith('.md') || f.endsWith('.MD'));
+  await fs.mkdir(SKILLS_DIR, { recursive: true });
 
   let masterIndex = '# gf_agent Skills Index\n\nThis index lists all Google Apps Script services and classes supported by `gf_agent` via `gas-fakes`.\n\n';
 
-  for (const file of mdFiles) {
-    const content = await fs.readFile(path.join(PROGRESS_DIR, file), 'utf-8');
-    const serviceName = file.replace(/\.md$/i, '');
-    
-    // Extract classes
-    const classMatches = content.matchAll(/## Class: \[(.*?)\]/g);
-    const classes = [];
-    
-    for (const match of classMatches) {
-      const className = match[1];
-      // Find the table for this class
-      const classSection = content.slice(match.index);
-      const tableEnd = classSection.indexOf('## Class:') > 0 ? classSection.indexOf('## Class:', 10) : classSection.length;
-      const tableContent = classSection.slice(0, tableEnd);
+  try {
+    // Check if progress directory exists before attempting to read
+    await fs.access(PROGRESS_DIR);
+    const files = await fs.readdir(PROGRESS_DIR);
+    const mdFiles = files.filter(f => f.endsWith('.md') || f.endsWith('.MD'));
+
+    for (const file of mdFiles) {
+      const content = await fs.readFile(path.join(PROGRESS_DIR, file), 'utf-8');
+      const serviceName = file.replace(/\.md$/i, '');
       
-      // Extract completed methods
-      const methodMatches = tableContent.matchAll(/\| \[(.*?)\]\(.*?\) \| .*? \| .*? \| .*? \| (completed) \|/g);
-      const methods = Array.from(methodMatches).map(m => m[1]);
+      // Extract classes
+      const classMatches = content.matchAll(/## Class: \[(.*?)\]/g);
+      const classes = [];
       
-      if (methods.length > 0) {
-        classes.push({ name: className, methods });
+      for (const match of classMatches) {
+        const className = match[1];
+        // Find the table for this class
+        const classSection = content.slice(match.index);
+        const tableEnd = classSection.indexOf('## Class:') > 0 ? classSection.indexOf('## Class:', 10) : classSection.length;
+        const tableContent = classSection.slice(0, tableEnd);
+        
+        // Extract completed methods
+        const methodMatches = tableContent.matchAll(/\| \[(.*?)\]\(.*?\) \| .*? \| .*? \| .*? \| (completed) \|/g);
+        const methods = Array.from(methodMatches).map(m => m[1]);
+        
+        if (methods.length > 0) {
+          classes.push({ name: className, methods });
+        }
       }
-    }
 
-    if (classes.length > 0) {
-      const skillFile = `${serviceName.toLowerCase()}.md`;
-      let skillContent = `# Service: ${serviceName}\n\n`;
-      
-      classes.forEach(c => {
-        skillContent += `## Class: ${c.name}\n\n`;
-        skillContent += `Supported Methods:\n`;
-        c.methods.forEach(m => {
-          skillContent += `- \`${m}\`\n`;
+      if (classes.length > 0) {
+        const skillFile = `${serviceName.toLowerCase()}.md`;
+        let skillContent = `# Service: ${serviceName}\n\n`;
+        
+        classes.forEach(c => {
+          skillContent += `## Class: ${c.name}\n\n`;
+          skillContent += `Supported Methods:\n`;
+          c.methods.forEach(m => {
+            skillContent += `- \`${m}\`\n`;
+          });
+          skillContent += '\n';
         });
-        skillContent += '\n';
-      });
 
-      await fs.writeFile(path.join(SKILLS_DIR, skillFile), skillContent);
-      masterIndex += `- [${serviceName}](skills/${skillFile})\n`;
+        await fs.writeFile(path.join(SKILLS_DIR, skillFile), skillContent);
+        masterIndex += `- [${serviceName}](skills/${skillFile})\n`;
+      }
     }
-  }
 
-  await fs.writeFile(INDEX_FILE, masterIndex);
+    await fs.writeFile(INDEX_FILE, masterIndex);
+    console.log(`Skills and Index generated from ${PROGRESS_DIR}`);
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      console.log(`Skipping skills index generation: ${PROGRESS_DIR} not found.`);
+    } else {
+      console.log(`Skipping skills index generation: ${err.message}`);
+    }
+    console.log(`(This is expected in a sparse clone environment).`);
+  }
   
   // Aggregate knowledge files into SKILL.md
-  const TEMPLATE_FILE = './gf_agent/scripts/SKILL.template.md';
-  const KNOWLEDGE_DIR = './gf_agent/knowledge';
-  const SKILL_OUTPUT = './gf_agent/SKILL.md';
-  
   let skillMarkdown = await fs.readFile(TEMPLATE_FILE, 'utf-8');
   
   try {
@@ -76,12 +106,13 @@ async function build() {
       }
     }
   } catch (err) {
-    console.log("No knowledge directory found or error reading it:", err.message);
+    console.log(`No knowledge directory found at ${KNOWLEDGE_DIR} or error reading it:`, err.message);
   }
 
   await fs.writeFile(SKILL_OUTPUT, skillMarkdown);
 
-  console.log('Build complete! Skills, Index, and monolithic SKILL.md generated.');
+  console.log(`Build complete! Skills, Index, and monolithic SKILL.md generated at ${SKILL_OUTPUT}`);
 }
 
 build().catch(console.error);
+

package/package.json

@@ -40,7 +40,7 @@
   },
   "name": "@mcpher/gas-fakes",
   "author": "bruce mcpherson",
-  "version": "2.3.13",
+  "version": "2.3.14",
   "license": "MIT",
   "main": "main.js",
   "description": "An implementation of the Google Workspace Apps Script runtime: Run native App Script Code on Node and Cloud Run",

package/src/cli/setup.js

@@ -626,20 +626,98 @@ export async function initializeConfiguration(options = {}) {
     try {
       // 1. Install or link the agent skill
       let skillCmd;
-      const localSkillPath = path.resolve(process.cwd(), "gf_agent", "SKILL.md");
-      const isLocalClone = fs.existsSync(localSkillPath);
+      const gfAgentSubdir = path.resolve(process.cwd(), "gf_agent", "SKILL.md");
+      const gfAgentCurrent = path.resolve(process.cwd(), "SKILL.md");
 
-      if (isLocalClone) {
+      if (fs.existsSync(gfAgentSubdir)) {
         console.log("Detected local gas-fakes repository. Linking local skill for development...");
-        skillCmd = "gemini skills link ./gf_agent";
+        skillCmd = "gemini skills link ./gf_agent --consent";
         manualSkillCmd = "1. gemini skills link ./gf_agent";
+        execSync(skillCmd, { stdio: ["ignore", "pipe", "ignore"] });
+        console.log("Skill linked successfully.");
+      } else if (fs.existsSync(gfAgentCurrent) && fs.existsSync(path.resolve(process.cwd(), "index.md"))) {
+        console.log("Detected local gf_agent directory. Linking local skill for development...");
+        skillCmd = "gemini skills link . --consent";
+        manualSkillCmd = "1. gemini skills link .";
+        execSync(skillCmd, { stdio: ["ignore", "pipe", "ignore"] });
+        console.log("Skill linked successfully.");
       } else {
-        skillCmd = "gemini skills install https://github.com/brucemcpherson/gas-fakes.git --path gf_agent";
-        manualSkillCmd = "1. gemini skills install https://github.com/brucemcpherson/gas-fakes.git --path gf_agent";
-      }
+        // Not a local clone, check if already installed to avoid overwriting
+        let isAlreadyInstalled = false;
+        try {
+          const existingSkills = execSync("gemini skills list", {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+          });
+          if (existingSkills.includes("gf_agent")) {
+            isAlreadyInstalled = true;
+          }
+        } catch (err) {
+          // Ignore errors checking skills list
+        }
+
+        if (isAlreadyInstalled) {
+          console.log("gf_agent skill is already installed. Skipping remote installation.");
+          manualSkillCmd = "1. gemini skills update gf_agent (if needed)";
+        } else {
+          const installChoice = await prompts({
+            type: "select",
+            name: "method",
+            message: "How would you like to install the gf_agent skill?",
+            choices: [
+              {
+                title: "Global (Standard)",
+                value: "global",
+                description: "Recommended for most users. Installs a read-only copy globally.",
+              },
+              {
+                title: "Local Standalone (Contributor)",
+                value: "local",
+                description: "Installs a local sparse-clone for skill development and linking.",
+              },
+            ],
+            initial: 0,
+          });
+
+          if (installChoice.method === "local") {
+            const standaloneDir = "gf_agent_standalone";
+            const fullStandalonePath = path.resolve(process.cwd(), standaloneDir);
+            console.log(`Setting up local standalone skill environment in "./${standaloneDir}"...`);
+
+            try {
+              if (!fs.existsSync(fullStandalonePath)) {
+                fs.mkdirSync(fullStandalonePath, { recursive: true });
+                execSync("git init", { cwd: fullStandalonePath, stdio: "ignore" });
+                execSync("git remote add origin https://github.com/brucemcpherson/gas-fakes.git", {
+                  cwd: fullStandalonePath,
+                  stdio: "ignore",
+                });
+                execSync("git config core.sparseCheckout true", { cwd: fullStandalonePath, stdio: "ignore" });
+
+                const sparsePath = path.join(fullStandalonePath, ".git", "info", "sparse-checkout");
+                fs.writeFileSync(sparsePath, "gf_agent/*\n");
+              }
+
+              execSync("git pull origin main", { cwd: fullStandalonePath, stdio: "ignore" });
 
-      console.log(`Executing: ${skillCmd}`);
-      execSync(skillCmd, { stdio: "inherit" });
+              skillCmd = "gemini skills link ./gf_agent --consent";
+              execSync(skillCmd, { cwd: fullStandalonePath, stdio: ["ignore", "pipe", "ignore"] });
+              console.log("Skill linked successfully.");
+
+              manualSkillCmd = `1. cd ${standaloneDir} && gemini skills link ./gf_agent`;
+            } catch (gitErr) {
+              console.error(`Error during local setup: ${gitErr.message}`);
+              throw gitErr;
+            }
+          } else {
+            skillCmd = "gemini skills install https://github.com/brucemcpherson/gas-fakes.git --path gf_agent --consent";
+            manualSkillCmd = "1. gemini skills install https://github.com/brucemcpherson/gas-fakes.git --path gf_agent";
+            console.log(`Installing global skill from remote...`);
+            execSync(skillCmd, { stdio: ["ignore", "pipe", "ignore"] });
+            console.log("Skill installed successfully.");
+          }
+        }
+      }
 
       // 2. Add the MCP server
       const mcpCmd = "gemini mcp add --scope project gas-fakes-mcp gas-fakes mcp";