@mcpher/gas-fakes 2.3.13 → 2.3.15

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/gf_agent/skills/base.md

@@ -0,0 +1,156 @@
+# Service: base
+
+## Class: Blob
+
+Supported Methods:
+- `copyBlob()`
+- `getBytes()`
+- `getContentType()`
+- `getDataAsString()`
+- `getDataAsString(String)`
+- `getName()`
+- `isGoogleType()`
+- `setBytes(Byte)`
+- `setContentType(String)`
+- `setContentTypeFromExtension()`
+- `setDataFromString(String,String)`
+- `setDataFromString(String)`
+- `setName(String)`
+- `clear()`
+- `getLog()`
+- `log(Object)`
+- `log(String,Object...)`
+- `asHexString()`
+- `getBlue()`
+- `getColorType()`
+- `getGreen()`
+- `getRed()`
+- `getActiveUser()`
+- `getActiveUserLocale()`
+- `getEffectiveUser()`
+- `getScriptTimeZone()`
+- `getTemporaryActiveUserKey()`
+- `getEmail()`
+
+## Class: Browser
+
+Supported Methods:
+- `clear()`
+- `getLog()`
+- `log(Object)`
+- `log(String,Object...)`
+- `asHexString()`
+- `getBlue()`
+- `getColorType()`
+- `getGreen()`
+- `getRed()`
+- `getActiveUser()`
+- `getActiveUserLocale()`
+- `getEffectiveUser()`
+- `getScriptTimeZone()`
+- `getTemporaryActiveUserKey()`
+- `getEmail()`
+
+## Class: console
+
+Supported Methods:
+- `clear()`
+- `getLog()`
+- `log(Object)`
+- `log(String,Object...)`
+- `asHexString()`
+- `getBlue()`
+- `getColorType()`
+- `getGreen()`
+- `getRed()`
+- `getActiveUser()`
+- `getActiveUserLocale()`
+- `getEffectiveUser()`
+- `getScriptTimeZone()`
+- `getTemporaryActiveUserKey()`
+- `getEmail()`
+
+## Class: Logger
+
+Supported Methods:
+- `clear()`
+- `getLog()`
+- `log(Object)`
+- `log(String,Object...)`
+- `asHexString()`
+- `getBlue()`
+- `getColorType()`
+- `getGreen()`
+- `getRed()`
+- `getActiveUser()`
+- `getActiveUserLocale()`
+- `getEffectiveUser()`
+- `getScriptTimeZone()`
+- `getTemporaryActiveUserKey()`
+- `getEmail()`
+
+## Class: Menu
+
+Supported Methods:
+- `asHexString()`
+- `getBlue()`
+- `getColorType()`
+- `getGreen()`
+- `getRed()`
+- `getActiveUser()`
+- `getActiveUserLocale()`
+- `getEffectiveUser()`
+- `getScriptTimeZone()`
+- `getTemporaryActiveUserKey()`
+- `getEmail()`
+
+## Class: PromptResponse
+
+Supported Methods:
+- `asHexString()`
+- `getBlue()`
+- `getColorType()`
+- `getGreen()`
+- `getRed()`
+- `getActiveUser()`
+- `getActiveUserLocale()`
+- `getEffectiveUser()`
+- `getScriptTimeZone()`
+- `getTemporaryActiveUserKey()`
+- `getEmail()`
+
+## Class: RgbColor
+
+Supported Methods:
+- `asHexString()`
+- `getBlue()`
+- `getColorType()`
+- `getGreen()`
+- `getRed()`
+- `getActiveUser()`
+- `getActiveUserLocale()`
+- `getEffectiveUser()`
+- `getScriptTimeZone()`
+- `getTemporaryActiveUserKey()`
+- `getEmail()`
+
+## Class: Session
+
+Supported Methods:
+- `getActiveUser()`
+- `getActiveUserLocale()`
+- `getEffectiveUser()`
+- `getScriptTimeZone()`
+- `getTemporaryActiveUserKey()`
+- `getEmail()`
+
+## Class: Ui
+
+Supported Methods:
+- `getEmail()`
+
+## Class: User
+
+Supported Methods:
+- `getEmail()`
+

package/gf_agent/skills/cache.md

@@ -0,0 +1,20 @@
+# Service: cache
+
+## Class: Cache
+
+Supported Methods:
+- `get(String)`
+- `put(String,String,Integer)`
+- `put(String,String)`
+- `remove(String)`
+- `getDocumentCache()`
+- `getScriptCache()`
+- `getUserCache()`
+
+## Class: CacheService
+
+Supported Methods:
+- `getDocumentCache()`
+- `getScriptCache()`
+- `getUserCache()`
+