@series-inc/rundot-game-sdk 5.1.3 → 5.2.0

package/scripts/postinstall.mjs

@@ -1,377 +1,377 @@
-#!/usr/bin/env node
-
-import { existsSync, rmSync, readFileSync, writeFileSync, createWriteStream, renameSync, readdirSync, statSync } from 'fs';
-import { resolve as resolvePath, dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-import https from 'https';
-import AdmZip from 'adm-zip';
-
-const DOCS_ZIP_URL = 'https://github.com/series-ai/venus-sdk-docs/archive/refs/heads/main.zip';
-const DOCS_FOLDER = '.rundot-docs';
-const VERSION_FILE = '.sdk-version';
-const TEMP_ZIP_FILE = '.docs-temp.zip';
-
-/**
- * Get the current package version
- */
-function getCurrentVersion() {
-  try {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = dirname(__filename);
-    const packageJsonPath = resolvePath(__dirname, '..', 'package.json');
-    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-    return packageJson.version;
-  } catch (error) {
-    console.warn('  Could not read package version:', error.message);
-    return null;
-  }
-}
-
-/**
- * Get the previously installed version
- */
-function getInstalledVersion(projectRoot) {
-  try {
-    const targetPath = resolvePath(projectRoot, DOCS_FOLDER);
-    const versionFilePath = resolvePath(targetPath, VERSION_FILE);
-    
-    if (!existsSync(versionFilePath)) {
-      return null;
-    }
-    
-    return readFileSync(versionFilePath, 'utf-8').trim();
-  } catch (error) {
-    return null;
-  }
-}
-
-/**
- * Save the current version to the version file
- */
-function saveInstalledVersion(version, projectRoot) {
-  try {
-    const targetPath = resolvePath(projectRoot, DOCS_FOLDER);
-    const versionFilePath = resolvePath(targetPath, VERSION_FILE);
-    writeFileSync(versionFilePath, version, 'utf-8');
-  } catch (error) {
-    console.warn('  Could not save version file:', error.message);
-  }
-}
-
-/**
- * Check if docs need to be downloaded
- */
-function shouldDownloadDocs(currentVersion, installedVersion, projectRoot) {
-  // First install - no version file exists
-  if (!installedVersion) {
-    return true;
-  }
-  
-  // Version has changed
-  if (currentVersion && installedVersion !== currentVersion) {
-    return true;
-  }
-  
-  // Docs folder doesn't exist (somehow deleted)
-  const targetPath = resolvePath(projectRoot, DOCS_FOLDER);
-  if (!existsSync(targetPath)) {
-    return true;
-  }
-  
-  return false;
-}
-
-/**
- * Download a file from a URL
- */
-async function downloadFile(url, dest) {
-  return new Promise((resolve, reject) => {
-    const file = createWriteStream(dest);
-    
-    https.get(url, (response) => {
-      // Follow redirects
-      if (response.statusCode === 302 || response.statusCode === 301) {
-        file.close();
-        rmSync(dest, { force: true });
-        return downloadFile(response.headers.location, dest).then(resolve).catch(reject);
-      }
-      
-      if (response.statusCode !== 200) {
-        file.close();
-        rmSync(dest, { force: true });
-        return reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
-      }
-      
-      response.pipe(file);
-      
-      file.on('finish', () => {
-        file.close();
-        resolve();
-      });
-      
-      file.on('error', (err) => {
-        file.close();
-        rmSync(dest, { force: true });
-        reject(err);
-      });
-    }).on('error', (err) => {
-      file.close();
-      rmSync(dest, { force: true });
-      reject(err);
-    });
-  });
-}
-
-/**
- * Extract zip file and handle GitHub's nested folder structure
- */
-function extractZip(zipPath, targetPath) {
-  const zip = new AdmZip(zipPath);
-  const tempExtractPath = resolvePath(process.cwd(), '.docs-temp-extract');
-  
-  // Clean up temp folder if it exists from a previous failed run
-  if (existsSync(tempExtractPath)) {
-    rmSync(tempExtractPath, { recursive: true, force: true });
-  }
-  
-  // Extract to temporary location
-  zip.extractAllTo(tempExtractPath, true);
-  
-  // GitHub creates a folder like "venus-sdk-docs-main" inside the zip
-  // We need to find it and move its contents to the target path
-  const extractedContents = readdirSync(tempExtractPath);
-  
-  if (extractedContents.length === 1) {
-    // Move the nested folder contents to target
-    const nestedFolder = resolvePath(tempExtractPath, extractedContents[0]);
-    renameSync(nestedFolder, targetPath);
-  } else {
-    // Unexpected structure, just move everything
-    renameSync(tempExtractPath, targetPath);
-  }
-  
-  // Clean up temp folder if it still exists
-  if (existsSync(tempExtractPath)) {
-    rmSync(tempExtractPath, { recursive: true, force: true });
-  }
-}
-
-/**
- * Find all AGENTS.md and CLAUDE.md files (case insensitive) in a directory
- */
-function findAgentFiles(dir, results = []) {
-  if (!existsSync(dir)) {
-    return results;
-  }
-  
-  const entries = readdirSync(dir, { withFileTypes: true });
-  
-  for (const entry of entries) {
-    const fullPath = join(dir, entry.name);
-    
-    // Skip .git directories
-    if (entry.name === '.git') {
-      continue;
-    }
-    
-    if (entry.isDirectory()) {
-      findAgentFiles(fullPath, results);
-    } else if (entry.isFile()) {
-      const nameLower = entry.name.toLowerCase();
-      if (nameLower === 'agents.md' || nameLower === 'claude.md') {
-        results.push(fullPath);
-      }
-    }
-  }
-  
-  return results;
-}
-
-/**
- * Inject agents-index.txt content into a file between <agents-index> tags
- */
-function injectAgentsIndex(filePath, agentsIndexContent) {
-  const content = readFileSync(filePath, 'utf-8');
-  const openTag = '<agents-index>';
-  const closeTag = '</agents-index>';
-  
-  const openIndex = content.indexOf(openTag);
-  const closeIndex = content.indexOf(closeTag);
-  
-  let newContent;
-  
-  if (openIndex !== -1 && closeIndex !== -1 && closeIndex > openIndex) {
-    // Tags exist, replace content between them
-    const before = content.substring(0, openIndex + openTag.length);
-    const after = content.substring(closeIndex);
-    newContent = `${before}\n${agentsIndexContent}${after}`;
-  } else {
-    // Tags don't exist, prepend them with the content
-    newContent = `${openTag}\n${agentsIndexContent}${closeTag}\n\n${content}`;
-  }
-  
-  writeFileSync(filePath, newContent, 'utf-8');
-}
-
-/**
- * Process all AGENTS.md and CLAUDE.md files in the project directory
- */
-function processAgentFiles(docsPath, projectRoot) {
-  const agentsIndexPath = join(docsPath, 'agents-index.txt');
-  
-  // Check if agents-index.txt exists
-  if (!existsSync(agentsIndexPath)) {
-    console.log('   No agents-index.txt found, skipping agent files injection');
-    return;
-  }
-  
-  // Read the agents-index.txt content
-  const agentsIndexContent = readFileSync(agentsIndexPath, 'utf-8').trim();
-  
-  // Find all AGENTS.md and CLAUDE.md files in the project root
-  const agentFiles = findAgentFiles(projectRoot);
-  
-  if (agentFiles.length === 0) {
-    console.log('   No AGENTS.md or CLAUDE.md files found in project, creating them...');
-    
-    const files = ['AGENTS.md', 'CLAUDE.md', 'GEMINI.md'];
-    
-    try {
-      for (const file of files) {
-        writeFileSync(join(projectRoot, file), '', 'utf-8');
-        console.log(`   Created ${file}`);
-        agentFiles.push(join(projectRoot, file));
-      }
-    } catch (error) {
-      console.warn('   Failed to create agent files:', error.message);
-      return;
-    }
-  }
-  
-  console.log(`   Found ${agentFiles.length} agent file(s), injecting agents-index...`);
-  
-  for (const filePath of agentFiles) {
-    try {
-      injectAgentsIndex(filePath, agentsIndexContent);
-      const relativePath = filePath.replace(projectRoot + '/', '');
-      console.log(`   Injected into ${relativePath}`);
-    } catch (error) {
-      console.warn(`   Failed to inject into ${filePath}:`, error.message);
-    }
-  }
-}
-
-/**
- * Add .rundot-docs to .gitignore if it exists and isn't already there
- */
-function updateGitignore(projectRoot) {
-  const gitignorePath = join(projectRoot, '.gitignore');
-  
-  if (!existsSync(gitignorePath)) {
-    return;
-  }
-  
-  try {
-    const content = readFileSync(gitignorePath, 'utf-8');
-    
-    // Check if .rundot-docs is already in .gitignore
-    if (content.includes('.rundot-docs')) {
-      return;
-    }
-    
-    // Add .rundot-docs to .gitignore
-    const newContent = content.endsWith('\n') 
-      ? `${content}.rundot-docs\n` 
-      : `${content}\n.rundot-docs\n`;
-    
-    writeFileSync(gitignorePath, newContent, 'utf-8');
-    console.log('   Added .rundot-docs to .gitignore');
-  } catch (error) {
-    console.warn('   Failed to update .gitignore:', error.message);
-  }
-}
-
-/**
- * Find the project root directory (where package.json with this package as a dependency exists)
- */
-function findProjectRoot() {
-  let currentDir = process.cwd();
-  
-  // If we're already in node_modules, go up to find the project root
-  if (currentDir.includes('node_modules')) {
-    const parts = currentDir.split('node_modules');
-    return parts[0];
-  }
-  
-  return currentDir;
-}
-
-/**
- * Post-install script to download venus-sdk-docs repository
- * into a .docs folder in the current working directory
- */
-async function postInstall() {
-  const projectRoot = findProjectRoot();
-  const zipPath = resolvePath(projectRoot, TEMP_ZIP_FILE);
-  
-  try {
-    const currentVersion = getCurrentVersion();
-    const installedVersion = getInstalledVersion(projectRoot);
-    
-    if (!shouldDownloadDocs(currentVersion, installedVersion, projectRoot)) {
-      console.log('venus-sdk-docs is already up to date (version:', installedVersion || 'unknown', ')');
-      return;
-    }
-    
-    // Use project root to store the docs
-    const targetPath = resolvePath(projectRoot, DOCS_FOLDER);
-    
-    console.log('Downloading venus-sdk-docs...');
-    
-    // Check if the .docs folder already exists
-    if (existsSync(targetPath)) {
-      console.log('   Removing old version...');
-      rmSync(targetPath, { recursive: true, force: true });
-    }
-    
-    // Download the zip file
-    await downloadFile(DOCS_ZIP_URL, zipPath);
-    console.log('   Download complete, extracting...');
-    
-    // Extract the zip file
-    extractZip(zipPath, targetPath);
-    
-    // Clean up zip file
-    if (existsSync(zipPath)) {
-      rmSync(zipPath, { force: true });
-    }
-    
-    // Save the current version
-    if (currentVersion) {
-      saveInstalledVersion(currentVersion, projectRoot);
-    }
-    
-    // Process AGENTS.md and CLAUDE.md files in the project root
-    processAgentFiles(targetPath, projectRoot);
-    
-    // Add .rundot-docs to .gitignore if it exists
-    updateGitignore(projectRoot);
-    
-    console.log('venus-sdk-docs downloaded successfully!');
-    console.log(`   Documentation available at: ${targetPath}`);
-  } catch (error) {
-    console.warn('Warning: Failed to download venus-sdk-docs');
-    console.warn('   Error:', error.message);
-    console.warn('   You can manually download the docs from:', DOCS_ZIP_URL);
-    
-    // Clean up any partial downloads
-    if (existsSync(zipPath)) {
-      rmSync(zipPath, { force: true });
-    }
-    
-    // Don't fail the installation if docs download fails
-    process.exit(0);
-  }
-}
-
-postInstall();
+#!/usr/bin/env node
+
+import { existsSync, rmSync, readFileSync, writeFileSync, createWriteStream, renameSync, readdirSync, statSync } from 'fs';
+import { resolve as resolvePath, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import https from 'https';
+import AdmZip from 'adm-zip';
+
+const DOCS_ZIP_URL = 'https://github.com/series-ai/venus-sdk-docs/archive/refs/heads/main.zip';
+const DOCS_FOLDER = '.rundot-docs';
+const VERSION_FILE = '.sdk-version';
+const TEMP_ZIP_FILE = '.docs-temp.zip';
+
+/**
+ * Get the current package version
+ */
+function getCurrentVersion() {
+  try {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    const packageJsonPath = resolvePath(__dirname, '..', 'package.json');
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+    return packageJson.version;
+  } catch (error) {
+    console.warn('  Could not read package version:', error.message);
+    return null;
+  }
+}
+
+/**
+ * Get the previously installed version
+ */
+function getInstalledVersion(projectRoot) {
+  try {
+    const targetPath = resolvePath(projectRoot, DOCS_FOLDER);
+    const versionFilePath = resolvePath(targetPath, VERSION_FILE);
+    
+    if (!existsSync(versionFilePath)) {
+      return null;
+    }
+    
+    return readFileSync(versionFilePath, 'utf-8').trim();
+  } catch (error) {
+    return null;
+  }
+}
+
+/**
+ * Save the current version to the version file
+ */
+function saveInstalledVersion(version, projectRoot) {
+  try {
+    const targetPath = resolvePath(projectRoot, DOCS_FOLDER);
+    const versionFilePath = resolvePath(targetPath, VERSION_FILE);
+    writeFileSync(versionFilePath, version, 'utf-8');
+  } catch (error) {
+    console.warn('  Could not save version file:', error.message);
+  }
+}
+
+/**
+ * Check if docs need to be downloaded
+ */
+function shouldDownloadDocs(currentVersion, installedVersion, projectRoot) {
+  // First install - no version file exists
+  if (!installedVersion) {
+    return true;
+  }
+  
+  // Version has changed
+  if (currentVersion && installedVersion !== currentVersion) {
+    return true;
+  }
+  
+  // Docs folder doesn't exist (somehow deleted)
+  const targetPath = resolvePath(projectRoot, DOCS_FOLDER);
+  if (!existsSync(targetPath)) {
+    return true;
+  }
+  
+  return false;
+}
+
+/**
+ * Download a file from a URL
+ */
+async function downloadFile(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = createWriteStream(dest);
+    
+    https.get(url, (response) => {
+      // Follow redirects
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        file.close();
+        rmSync(dest, { force: true });
+        return downloadFile(response.headers.location, dest).then(resolve).catch(reject);
+      }
+      
+      if (response.statusCode !== 200) {
+        file.close();
+        rmSync(dest, { force: true });
+        return reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+      }
+      
+      response.pipe(file);
+      
+      file.on('finish', () => {
+        file.close();
+        resolve();
+      });
+      
+      file.on('error', (err) => {
+        file.close();
+        rmSync(dest, { force: true });
+        reject(err);
+      });
+    }).on('error', (err) => {
+      file.close();
+      rmSync(dest, { force: true });
+      reject(err);
+    });
+  });
+}
+
+/**
+ * Extract zip file and handle GitHub's nested folder structure
+ */
+function extractZip(zipPath, targetPath) {
+  const zip = new AdmZip(zipPath);
+  const tempExtractPath = resolvePath(process.cwd(), '.docs-temp-extract');
+  
+  // Clean up temp folder if it exists from a previous failed run
+  if (existsSync(tempExtractPath)) {
+    rmSync(tempExtractPath, { recursive: true, force: true });
+  }
+  
+  // Extract to temporary location
+  zip.extractAllTo(tempExtractPath, true);
+  
+  // GitHub creates a folder like "venus-sdk-docs-main" inside the zip
+  // We need to find it and move its contents to the target path
+  const extractedContents = readdirSync(tempExtractPath);
+  
+  if (extractedContents.length === 1) {
+    // Move the nested folder contents to target
+    const nestedFolder = resolvePath(tempExtractPath, extractedContents[0]);
+    renameSync(nestedFolder, targetPath);
+  } else {
+    // Unexpected structure, just move everything
+    renameSync(tempExtractPath, targetPath);
+  }
+  
+  // Clean up temp folder if it still exists
+  if (existsSync(tempExtractPath)) {
+    rmSync(tempExtractPath, { recursive: true, force: true });
+  }
+}
+
+/**
+ * Find all AGENTS.md and CLAUDE.md files (case insensitive) in a directory
+ */
+function findAgentFiles(dir, results = []) {
+  if (!existsSync(dir)) {
+    return results;
+  }
+  
+  const entries = readdirSync(dir, { withFileTypes: true });
+  
+  for (const entry of entries) {
+    const fullPath = join(dir, entry.name);
+    
+    // Skip .git directories
+    if (entry.name === '.git') {
+      continue;
+    }
+    
+    if (entry.isDirectory()) {
+      findAgentFiles(fullPath, results);
+    } else if (entry.isFile()) {
+      const nameLower = entry.name.toLowerCase();
+      if (nameLower === 'agents.md' || nameLower === 'claude.md') {
+        results.push(fullPath);
+      }
+    }
+  }
+  
+  return results;
+}
+
+/**
+ * Inject agents-index.txt content into a file between <agents-index> tags
+ */
+function injectAgentsIndex(filePath, agentsIndexContent) {
+  const content = readFileSync(filePath, 'utf-8');
+  const openTag = '<agents-index>';
+  const closeTag = '</agents-index>';
+  
+  const openIndex = content.indexOf(openTag);
+  const closeIndex = content.indexOf(closeTag);
+  
+  let newContent;
+  
+  if (openIndex !== -1 && closeIndex !== -1 && closeIndex > openIndex) {
+    // Tags exist, replace content between them
+    const before = content.substring(0, openIndex + openTag.length);
+    const after = content.substring(closeIndex);
+    newContent = `${before}\n${agentsIndexContent}${after}`;
+  } else {
+    // Tags don't exist, prepend them with the content
+    newContent = `${openTag}\n${agentsIndexContent}${closeTag}\n\n${content}`;
+  }
+  
+  writeFileSync(filePath, newContent, 'utf-8');
+}
+
+/**
+ * Process all AGENTS.md and CLAUDE.md files in the project directory
+ */
+function processAgentFiles(docsPath, projectRoot) {
+  const agentsIndexPath = join(docsPath, 'agents-index.txt');
+  
+  // Check if agents-index.txt exists
+  if (!existsSync(agentsIndexPath)) {
+    console.log('   No agents-index.txt found, skipping agent files injection');
+    return;
+  }
+  
+  // Read the agents-index.txt content
+  const agentsIndexContent = readFileSync(agentsIndexPath, 'utf-8').trim();
+  
+  // Find all AGENTS.md and CLAUDE.md files in the project root
+  const agentFiles = findAgentFiles(projectRoot);
+  
+  if (agentFiles.length === 0) {
+    console.log('   No AGENTS.md or CLAUDE.md files found in project, creating them...');
+    
+    const files = ['AGENTS.md', 'CLAUDE.md', 'GEMINI.md'];
+    
+    try {
+      for (const file of files) {
+        writeFileSync(join(projectRoot, file), '', 'utf-8');
+        console.log(`   Created ${file}`);
+        agentFiles.push(join(projectRoot, file));
+      }
+    } catch (error) {
+      console.warn('   Failed to create agent files:', error.message);
+      return;
+    }
+  }
+  
+  console.log(`   Found ${agentFiles.length} agent file(s), injecting agents-index...`);
+  
+  for (const filePath of agentFiles) {
+    try {
+      injectAgentsIndex(filePath, agentsIndexContent);
+      const relativePath = filePath.replace(projectRoot + '/', '');
+      console.log(`   Injected into ${relativePath}`);
+    } catch (error) {
+      console.warn(`   Failed to inject into ${filePath}:`, error.message);
+    }
+  }
+}
+
+/**
+ * Add .rundot-docs to .gitignore if it exists and isn't already there
+ */
+function updateGitignore(projectRoot) {
+  const gitignorePath = join(projectRoot, '.gitignore');
+  
+  if (!existsSync(gitignorePath)) {
+    return;
+  }
+  
+  try {
+    const content = readFileSync(gitignorePath, 'utf-8');
+    
+    // Check if .rundot-docs is already in .gitignore
+    if (content.includes('.rundot-docs')) {
+      return;
+    }
+    
+    // Add .rundot-docs to .gitignore
+    const newContent = content.endsWith('\n') 
+      ? `${content}.rundot-docs\n` 
+      : `${content}\n.rundot-docs\n`;
+    
+    writeFileSync(gitignorePath, newContent, 'utf-8');
+    console.log('   Added .rundot-docs to .gitignore');
+  } catch (error) {
+    console.warn('   Failed to update .gitignore:', error.message);
+  }
+}
+
+/**
+ * Find the project root directory (where package.json with this package as a dependency exists)
+ */
+function findProjectRoot() {
+  let currentDir = process.cwd();
+  
+  // If we're already in node_modules, go up to find the project root
+  if (currentDir.includes('node_modules')) {
+    const parts = currentDir.split('node_modules');
+    return parts[0];
+  }
+  
+  return currentDir;
+}
+
+/**
+ * Post-install script to download venus-sdk-docs repository
+ * into a .docs folder in the current working directory
+ */
+async function postInstall() {
+  const projectRoot = findProjectRoot();
+  const zipPath = resolvePath(projectRoot, TEMP_ZIP_FILE);
+  
+  try {
+    const currentVersion = getCurrentVersion();
+    const installedVersion = getInstalledVersion(projectRoot);
+    
+    if (!shouldDownloadDocs(currentVersion, installedVersion, projectRoot)) {
+      console.log('venus-sdk-docs is already up to date (version:', installedVersion || 'unknown', ')');
+      return;
+    }
+    
+    // Use project root to store the docs
+    const targetPath = resolvePath(projectRoot, DOCS_FOLDER);
+    
+    console.log('Downloading venus-sdk-docs...');
+    
+    // Check if the .docs folder already exists
+    if (existsSync(targetPath)) {
+      console.log('   Removing old version...');
+      rmSync(targetPath, { recursive: true, force: true });
+    }
+    
+    // Download the zip file
+    await downloadFile(DOCS_ZIP_URL, zipPath);
+    console.log('   Download complete, extracting...');
+    
+    // Extract the zip file
+    extractZip(zipPath, targetPath);
+    
+    // Clean up zip file
+    if (existsSync(zipPath)) {
+      rmSync(zipPath, { force: true });
+    }
+    
+    // Save the current version
+    if (currentVersion) {
+      saveInstalledVersion(currentVersion, projectRoot);
+    }
+    
+    // Process AGENTS.md and CLAUDE.md files in the project root
+    processAgentFiles(targetPath, projectRoot);
+    
+    // Add .rundot-docs to .gitignore if it exists
+    updateGitignore(projectRoot);
+    
+    console.log('venus-sdk-docs downloaded successfully!');
+    console.log(`   Documentation available at: ${targetPath}`);
+  } catch (error) {
+    console.warn('Warning: Failed to download venus-sdk-docs');
+    console.warn('   Error:', error.message);
+    console.warn('   You can manually download the docs from:', DOCS_ZIP_URL);
+    
+    // Clean up any partial downloads
+    if (existsSync(zipPath)) {
+      rmSync(zipPath, { force: true });
+    }
+    
+    // Don't fail the installation if docs download fails
+    process.exit(0);
+  }
+}
+
+postInstall();