@jaguilar87/gaia-ops 1.3.3 → 1.3.5

package/CHANGELOG.md

@@ -7,6 +7,56 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [1.3.5] - 2025-11-10
+
+### Added
+- **Smart Installer Flow:** Project context repo now asked FIRST, with auto-population of all config
+- **Input Sanitization:** Handles "git clone <url>" pastes automatically (extracts just URL)
+- **Auto-Configuration:** Parses project-context.json and pre-fills all wizard questions
+- **Better Error Messages:** Clear troubleshooting tips for git clone failures (SSH keys, access, URL)
+
+### Changed
+- **Wizard Question Order:** Project context moved from last to first question
+- **User Experience:** Reduced manual input when project context exists
+- **Clone Strategy:** Validates project context early, then sets up in final location
+- **Error Handling:** Installation continues even if project context clone fails
+
+### Improved
+- Eliminates typos and configuration errors by pre-filling from existing context
+- Saves time for users with existing project-context repos
+- Better guidance when git operations fail
+
+---
+
+## [1.3.4] - 2025-11-10
+
+### Fixed
+- **Installer:** Removed incorrect AGENTS.md symlink creation in project root during installation
+- **Documentation:** AGENTS.md now only accessible via `.claude/config/AGENTS.md` as intended
+- **Package Quality:** Excluded Python cache files (`__pycache__/`) from published package
+
+### Changed
+- **README.md:** Updated project structure documentation to reflect correct AGENTS.md location
+- **README.en.md:** Updated project structure and corrected package references
+- **Package Size:** Reduced from 911.7 kB (93 files) to 660.7 kB (77 files) - 27% reduction
+
+### Added
+- **Package Metadata:** Added `homepage` and `bugs` fields to package.json for better npm discovery
+- **Badges:** Added npm version, license, and Node.js version badges to README files
+- **CI/CD:** Created GitHub Actions workflow for automated npm publishing
+- **.npmignore:** Added file to exclude development artifacts from package
+- **Cleanup Script:** Added `npm run clean` to remove Python cache files automatically
+- **Pre-publish Hook:** Added `prepublishOnly` script for automatic cleanup before publishing
+
+### Package Quality Improvements
+- Better npm package metadata for discoverability
+- Professional badges in documentation
+- Automated publishing workflow
+- Cleaner package distribution (no cache files)
+- Improved documentation consistency
+
+---
+
 ## [2.1.0] - 2025-11-07
 
 ### Changed

package/README.en.md

@@ -1,5 +1,9 @@
 # @jaguilar87/gaia-ops
 
+[![npm version](https://badge.fury.io/js/@jaguilar87%2Fgaia-ops.svg)](https://www.npmjs.com/package/@jaguilar87/gaia-ops)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/@jaguilar87/gaia-ops.svg)](https://nodejs.org)
+
 **[🇪🇸 Versión en español](README.md)**
 
 Multi-agent orchestration system for Claude Code - DevOps automation toolkit.
@@ -127,26 +131,24 @@ After installation:
 
 ```
 your-project/
-├── .claude/                 # Symlinked to node_modules/@aaxis/claude-agents/
-│   ├── agents/              → node_modules/@aaxis/claude-agents/agents/
-│   ├── tools/               → node_modules/@aaxis/claude-agents/tools/
-│   ├── hooks/               → node_modules/@aaxis/claude-agents/hooks/
-│   ├── commands/            → node_modules/@aaxis/claude-agents/commands/
-│   ├── docs/                → node_modules/@aaxis/claude-agents/docs/
-│   ├── templates/           → node_modules/@aaxis/claude-agents/templates/
-│   ├── config/              → node_modules/@aaxis/claude-agents/config/
-│   ├── CHANGELOG.md         → node_modules/@aaxis/claude-agents/CHANGELOG.md
+├── .claude/                 # Symlinked to node_modules/@jaguilar87/gaia-ops/
+│   ├── agents/              → node_modules/@jaguilar87/gaia-ops/agents/
+│   ├── tools/               → node_modules/@jaguilar87/gaia-ops/tools/
+│   ├── hooks/               → node_modules/@jaguilar87/gaia-ops/hooks/
+│   ├── commands/            → node_modules/@jaguilar87/gaia-ops/commands/
+│   ├── config/              → node_modules/@jaguilar87/gaia-ops/config/
+│   ├── templates/           → node_modules/@jaguilar87/gaia-ops/templates/
+│   ├── CHANGELOG.md         → node_modules/@jaguilar87/gaia-ops/CHANGELOG.md
 │   ├── logs/                # Project-specific (NOT symlinked)
 │   ├── tests/               # Project-specific (NOT symlinked)
 │   └── project-context.json # Project-specific (NOT symlinked)
 ├── CLAUDE.md                # Generated from template
-├── AGENTS.md                → node_modules/@aaxis/claude-agents/AGENTS.md
 ├── gitops/                  # Your GitOps manifests
 ├── terraform/               # Your Terraform code
 ├── app-services/            # Your application code
 ├── node_modules/
-│   └── @aaxis/
-│       └── claude-agents/   # This package
+│   └── @jaguilar87/
+│       └── gaia-ops/        # This package
 └── package.json
 ```
 

package/README.md

@@ -1,5 +1,9 @@
 # @jaguilar87/gaia-ops
 
+[![npm version](https://badge.fury.io/js/@jaguilar87%2Fgaia-ops.svg)](https://www.npmjs.com/package/@jaguilar87/gaia-ops)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/@jaguilar87/gaia-ops.svg)](https://nodejs.org)
+
 **[🇺🇸 English version](README.en.md)**
 
 Sistema de orquestación multi-agente para Claude Code - Toolkit de automatización DevOps.
@@ -139,7 +143,6 @@ tu-proyecto/
 │   ├── tests/               # Específico del proyecto (NO symlink)
 │   └── project-context.json # Específico del proyecto (NO symlink)
 ├── CLAUDE.md                # Generado desde template
-├── AGENTS.md                → node_modules/@jaguilar87/gaia-ops/AGENTS.md
 ├── gitops/                  # Tus manifiestos GitOps
 ├── terraform/               # Tu código Terraform
 ├── app-services/            # Tu código de aplicación

package/bin/gaia-init.js

@@ -254,6 +254,81 @@ function validateConfiguration(config, nonInteractive) {
 // Interactive prompts
 // ============================================================================
 
+/**
+ * Sanitize git repo URL input
+ * Handles cases where user pastes "git clone <url>" instead of just "<url>"
+ */
+function sanitizeGitUrl(input) {
+  if (!input || typeof input !== 'string') return '';
+
+  // Trim whitespace
+  let sanitized = input.trim();
+
+  // Remove "git clone" prefix if present
+  if (sanitized.toLowerCase().startsWith('git clone ')) {
+    sanitized = sanitized.substring('git clone '.length).trim();
+  }
+
+  // Remove quotes if present
+  sanitized = sanitized.replace(/^["']|["']$/g, '');
+
+  return sanitized;
+}
+
+/**
+ * Try to clone project context repo early and parse config
+ * Returns parsed config or null if clone fails
+ */
+async function tryCloneProjectContext(repoUrl) {
+  if (!repoUrl || repoUrl.trim() === '') {
+    return null;
+  }
+
+  const sanitizedUrl = sanitizeGitUrl(repoUrl);
+
+  const spinner = ora('Cloning project context repository...').start();
+
+  try {
+    const tempDir = join(CWD, '.claude-temp-context');
+
+    // Remove temp dir if exists
+    if (existsSync(tempDir)) {
+      await fs.rm(tempDir, { recursive: true, force: true });
+    }
+
+    // Clone to temp directory
+    await execAsync(`git clone ${sanitizedUrl} ${tempDir}`, { timeout: 30000 });
+
+    // Try to read project-context.json
+    const contextPath = join(tempDir, 'project-context.json');
+
+    if (existsSync(contextPath)) {
+      const contextData = JSON.parse(await fs.readFile(contextPath, 'utf-8'));
+
+      // Clean up temp dir
+      await fs.rm(tempDir, { recursive: true, force: true });
+
+      spinner.succeed('Project context loaded successfully');
+      console.log(chalk.green('  ✓ Auto-populated configuration from project context\n'));
+
+      return {
+        contextData,
+        repoUrl: sanitizedUrl
+      };
+    } else {
+      // No project-context.json found
+      await fs.rm(tempDir, { recursive: true, force: true });
+      spinner.warn('Repository cloned but no project-context.json found');
+      return null;
+    }
+  } catch (error) {
+    spinner.fail('Failed to clone project context repository');
+    console.log(chalk.yellow(`\n⚠️  Error: ${error.message}`));
+    console.log(chalk.gray('  Continuing with manual configuration...\n'));
+    return null;
+  }
+}
+
 /**
  * Present interactive wizard to user
  */
@@ -276,32 +351,79 @@ async function runInteractiveWizard(detected) {
 
   console.log(chalk.gray('This wizard will set up the Gaia-Ops agent system for your project.\n'));
 
-  console.log(chalk.yellow('📍 Directory Configuration'));
-  console.log(chalk.gray('Gaia-Ops agents need to know where your code lives:\n'));
-  console.log(chalk.gray('  • GitOps: Kubernetes manifests that agents will monitor and deploy'));
-  console.log(chalk.gray('  • Terraform: Infrastructure code that agents will plan and apply'));
-  console.log(chalk.gray('  • App Services: Application code that agents will build and test\n'));
+  // =========================================================================
+  // STEP 1: Ask for project context repo first (if available)
+  // =========================================================================
+  console.log(chalk.yellow('🔗 Project Context (Optional but Recommended)'));
+  console.log(chalk.gray('If you have a project context repo, we can auto-populate your configuration.\n'));
+
+  const contextQuestion = await prompts({
+    type: 'text',
+    name: 'projectContextRepo',
+    message: '📦 Project context Git repo (e.g., git@bitbucket.org:org/context.git):',
+    initial: ''
+  }, {
+    onCancel: () => {
+      console.log(chalk.yellow('\n⚠️  Installation cancelled by user\n'));
+      process.exit(0);
+    }
+  });
+
+  // Try to clone and parse project context
+  let projectContext = null;
+  if (contextQuestion.projectContextRepo) {
+    projectContext = await tryCloneProjectContext(contextQuestion.projectContextRepo);
+  }
+
+  // Extract defaults from project context if available
+  const defaults = projectContext ? {
+    gitops: projectContext.contextData.paths?.gitops || detected.gitops || './gitops',
+    terraform: projectContext.contextData.paths?.terraform || detected.terraform || './terraform',
+    appServices: projectContext.contextData.paths?.app_services || detected.appServices || './app-services',
+    cloudProvider: projectContext.contextData.sections?.project_details?.cloud_provider || 'gcp',
+    gcpProjectId: projectContext.contextData.sections?.project_details?.project_id || projectContext.contextData.metadata?.project_id || '',
+    awsAccountId: projectContext.contextData.sections?.project_details?.aws_account || projectContext.contextData.metadata?.aws_account || '',
+    region: projectContext.contextData.sections?.project_details?.region || projectContext.contextData.metadata?.primary_region || 'us-central1',
+    clusterName: projectContext.contextData.sections?.project_details?.cluster_name || '',
+    repoUrl: projectContext?.repoUrl || contextQuestion.projectContextRepo
+  } : {
+    gitops: detected.gitops || './gitops',
+    terraform: detected.terraform || './terraform',
+    appServices: detected.appServices || './app-services',
+    cloudProvider: 'gcp',
+    gcpProjectId: '',
+    awsAccountId: '',
+    region: 'us-central1',
+    clusterName: '',
+    repoUrl: contextQuestion.projectContextRepo
+  };
+
+  // =========================================================================
+  // STEP 2: Ask remaining questions (with smart defaults from context)
+  // =========================================================================
+  console.log(chalk.yellow('\n📍 Directory Configuration'));
+  console.log(chalk.gray('Verify or adjust the following paths:\n'));
 
   const questions = [
     {
       type: 'text',
       name: 'gitops',
       message: '📦 GitOps directory:',
-      initial: detected.gitops || './gitops',
+      initial: defaults.gitops,
       validate: value => value.trim().length > 0
     },
     {
       type: 'text',
       name: 'terraform',
       message: '🔧 Terraform directory:',
-      initial: detected.terraform || './terraform',
+      initial: defaults.terraform,
       validate: value => value.trim().length > 0
     },
     {
       type: 'text',
       name: 'appServices',
       message: '🚀 App Services directory:',
-      initial: detected.appServices || './app-services',
+      initial: defaults.appServices,
       validate: value => value.trim().length > 0
     },
     {
@@ -313,31 +435,34 @@ async function runInteractiveWizard(detected) {
         { title: 'AWS (Amazon Web Services)', value: 'aws' },
         { title: 'Multi-cloud (AWS + GCP)', value: 'multi-cloud' }
       ],
-      initial: 0
+      initial: defaults.cloudProvider === 'gcp' ? 0 : defaults.cloudProvider === 'aws' ? 1 : 2
     },
     {
       type: (prev, values) => ['gcp', 'multi-cloud'].includes(values.cloudProvider) ? 'text' : null,
       name: 'gcpProjectId',
       message: '🌐 GCP Project ID (e.g., aaxis-rnd-non-prod):',
+      initial: defaults.gcpProjectId,
       validate: value => value.trim().length > 0
     },
     {
       type: (prev, values) => ['aws', 'multi-cloud'].includes(values.cloudProvider) ? 'text' : null,
       name: 'awsAccountId',
       message: '🌐 AWS Account ID (e.g., 929914624686):',
+      initial: defaults.awsAccountId,
       validate: value => value.trim().length > 0
     },
     {
       type: 'text',
       name: 'region',
       message: '🌍 Primary Region (e.g., us-central1 for GCP, us-east-1 for AWS):',
-      initial: 'us-central1',
+      initial: defaults.region,
       validate: value => value.trim().length > 0
     },
     {
       type: 'text',
       name: 'clusterName',
       message: '☸️  Cluster Name (e.g., rnd-gke-nonprod or digital-eks-prod):',
+      initial: defaults.clusterName,
       validate: value => value.trim().length > 0
     },
     {
@@ -345,12 +470,6 @@ async function runInteractiveWizard(detected) {
       name: 'installClaudeCode',
       message: '📥 Install Claude Code if not present?',
       initial: true
-    },
-    {
-      type: 'text',
-      name: 'projectContextRepo',
-      message: '🔗 Project context Git repo (optional, e.g., git@bitbucket.org:org/context.git):',
-      initial: ''
     }
   ];
 
@@ -367,6 +486,10 @@ async function runInteractiveWizard(detected) {
     process.exit(0);
   }
 
+  // Add project context info to responses
+  responses.projectContextRepo = defaults.repoUrl;
+  responses.projectContextAlreadyCloned = !!projectContext;
+
   return responses;
 }
 
@@ -496,27 +619,13 @@ async function generateClaudeMd(config) {
 
 /**
  * Generate AGENTS.md symlink
+ * NOTE: AGENTS.md is already available at .claude/config/AGENTS.md via the config/ symlink
+ * No need to create a separate symlink in the project root
  */
 async function generateAgentsMd() {
-  const spinner = ora('Creating AGENTS.md symlink...').start();
-
-  try {
-    const agentsMdLink = join(CWD, 'AGENTS.md');
-    const packagePath = join(CWD, 'node_modules', '@jaguilar87', 'gaia-ops', 'config', 'AGENTS.md');
-    const relativePath = relative(CWD, packagePath);
-
-    // Remove existing if present
-    if (existsSync(agentsMdLink)) {
-      await fs.unlink(agentsMdLink);
-    }
-
-    await fs.symlink(relativePath, agentsMdLink);
-
-    spinner.succeed('AGENTS.md symlink created');
-  } catch (error) {
-    spinner.fail('Failed to create AGENTS.md symlink');
-    throw error;
-  }
+  // AGENTS.md is accessible via .claude/config/AGENTS.md (symlinked directory)
+  // No action needed - keeping function for backward compatibility
+  return Promise.resolve();
 }
 
 /**
@@ -712,13 +821,58 @@ async function installClaudeAgentsPackage() {
 
 /**
  * Clone project context repository (optional)
+ * If already cloned during wizard, skip clone and just set it up in final location
  */
-async function cloneProjectContextRepo(repoUrl) {
+async function cloneProjectContextRepo(repoUrl, alreadyCloned = false) {
   if (!repoUrl || repoUrl.trim() === '') {
     console.log(chalk.gray('\n✓ Skipping project context repo clone (not provided)\n'));
     return;
   }
 
+  const sanitizedUrl = sanitizeGitUrl(repoUrl);
+
+  if (alreadyCloned) {
+    // Context was already cloned during wizard, just re-clone to final location
+    const spinner = ora('Setting up project context...').start();
+
+    try {
+      const projectContextDir = join(CWD, '.claude', 'project-context');
+
+      // Remove the generated project-context.json as it will be replaced by the cloned repo
+      const generatedFile = join(projectContextDir, 'project-context.json');
+      if (existsSync(generatedFile)) {
+        await fs.unlink(generatedFile);
+      }
+
+      // Clone fresh to final location (we already validated it works)
+      const tempDir = `${projectContextDir}-temp`;
+      await execAsync(`git clone ${sanitizedUrl} ${tempDir}`, { timeout: 30000 });
+
+      // Move contents from temp to project-context
+      const files = await fs.readdir(tempDir);
+      for (const file of files) {
+        const src = join(tempDir, file);
+        const dest = join(projectContextDir, file);
+        await fs.rename(src, dest);
+      }
+
+      // Remove temp directory
+      await fs.rm(tempDir, { recursive: true, force: true });
+
+      spinner.succeed('Project context repository configured');
+      console.log(chalk.green(`  → Location: .claude/project-context/\n`));
+    } catch (error) {
+      spinner.fail('Failed to setup project context repository');
+      console.log(chalk.yellow(`\n⚠️  You can clone it manually with:`));
+      console.log(chalk.gray(`  cd .claude`));
+      console.log(chalk.gray(`  rm -rf project-context`));
+      console.log(chalk.gray(`  git clone ${sanitizedUrl} project-context\n`));
+      // Don't throw - allow installation to continue
+    }
+    return;
+  }
+
+  // Not cloned yet during wizard, try to clone now
   const spinner = ora('Cloning project context repository...').start();
 
   try {
@@ -730,11 +884,11 @@ async function cloneProjectContextRepo(repoUrl) {
       await fs.unlink(generatedFile);
     }
 
-    // Clone repo directly into project-context directory
-    await execAsync(`git clone ${repoUrl} ${projectContextDir}-temp`);
+    // Clone repo
+    const tempDir = `${projectContextDir}-temp`;
+    await execAsync(`git clone ${sanitizedUrl} ${tempDir}`, { timeout: 30000 });
 
     // Move contents from temp to project-context
-    const tempDir = `${projectContextDir}-temp`;
     const files = await fs.readdir(tempDir);
     for (const file of files) {
       const src = join(tempDir, file);
@@ -743,17 +897,22 @@ async function cloneProjectContextRepo(repoUrl) {
     }
 
     // Remove temp directory
-    await fs.rmdir(tempDir);
+    await fs.rm(tempDir, { recursive: true, force: true });
 
     spinner.succeed('Project context repository cloned');
-    console.log(chalk.green(`  → Cloned from: ${repoUrl}`));
+    console.log(chalk.green(`  → Cloned from: ${sanitizedUrl}`));
     console.log(chalk.gray(`  → Location: .claude/project-context/\n`));
   } catch (error) {
     spinner.fail('Failed to clone project context repository');
-    console.log(chalk.yellow(`\n⚠️  You can clone it manually later with:`));
-    console.log(chalk.gray(`  cd .claude`));
-    console.log(chalk.gray(`  rm -rf project-context`));
-    console.log(chalk.gray(`  git clone ${repoUrl} project-context\n`));
+    console.log(chalk.yellow(`\n⚠️  Error: ${error.message}`));
+    console.log(chalk.gray('\n  Common issues:'));
+    console.log(chalk.gray('  • Check SSH keys are configured: ssh -T git@bitbucket.org'));
+    console.log(chalk.gray('  • Verify repository URL is correct'));
+    console.log(chalk.gray('  • Ensure you have access to the repository\n'));
+    console.log(chalk.yellow(`  You can clone it manually later with:`));
+    console.log(chalk.gray(`    cd .claude`));
+    console.log(chalk.gray(`    rm -rf project-context`));
+    console.log(chalk.gray(`    git clone ${sanitizedUrl} project-context\n`));
     // Don't throw - allow installation to continue
   }
 }
@@ -828,7 +987,7 @@ async function main() {
 
     // Step 10: Clone project context repository (optional)
     if (config.projectContextRepo) {
-      await cloneProjectContextRepo(config.projectContextRepo);
+      await cloneProjectContextRepo(config.projectContextRepo, config.projectContextAlreadyCloned);
     }
 
     // Success message

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaguilar87/gaia-ops",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "Multi-agent orchestration system for Claude Code - DevOps automation toolkit",
   "main": "index.js",
   "type": "module",
@@ -25,6 +25,11 @@
     "type": "git",
     "url": "git+https://github.com/metraton/gaia-ops.git"
   },
+  "homepage": "https://github.com/metraton/gaia-ops#readme",
+  "bugs": {
+    "url": "https://github.com/metraton/gaia-ops/issues",
+    "email": "jaguilar1897@gmail.com"
+  },
   "files": [
     "bin/",
     "agents/",
@@ -42,7 +47,9 @@
   "scripts": {
     "test": "pytest tests/ -v",
     "validate": "python3 tools/commit_validator.py",
-    "lint": "eslint ."
+    "lint": "eslint .",
+    "clean": "find . -type d -name '__pycache__' -exec rm -rf {} + 2>/dev/null || true",
+    "prepublishOnly": "npm run clean"
   },
   "dependencies": {
     "prompts": "^2.4.2",