@jaguilar87/gaia-ops 1.1.0 → 1.3.0

package/bin/gaia-init.js

@@ -258,48 +258,87 @@ function validateConfiguration(config, nonInteractive) {
  * Present interactive wizard to user
  */
 async function runInteractiveWizard(detected) {
-  console.log(chalk.cyan.bold('\n🤖 Claude Code Agent System Installer\n'));
-  console.log(chalk.gray('This wizard will set up the Claude Code agent system for your project.\n'));
+  // ASCII Art banner
+  console.log(chalk.cyan(`
+    ╔═══════════════════════════════════════════════════════════════╗
+    ║                                                               ║
+    ║       ██████╗  █████╗ ██╗ █████╗       ██████╗ ██████╗ ███████╗       ║
+    ║      ██╔════╝ ██╔══██╗██║██╔══██╗     ██╔═══██╗██╔══██╗██╔════╝       ║
+    ║      ██║  ███╗███████║██║███████║     ██║   ██║██████╔╝███████╗       ║
+    ║      ██║   ██║██╔══██║██║██╔══██║     ██║   ██║██╔═══╝ ╚════██║       ║
+    ║      ╚██████╔╝██║  ██║██║██║  ██║     ╚██████╔╝██║     ███████║       ║
+    ║       ╚═════╝ ╚═╝  ╚═╝╚═╝╚═╝  ╚═╝      ╚═════╝ ╚═╝     ╚══════╝       ║
+    ║                                                               ║
+    ║            Multi-Agent DevOps Orchestration System            ║
+    ║                    Powered by Claude Code                     ║
+    ║                                                               ║
+    ╚═══════════════════════════════════════════════════════════════╝
+  `));
+
+  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'));
 
   const questions = [
     {
       type: 'text',
       name: 'gitops',
-      message: '📦 GitOps directory (Flux/Kubernetes manifests):',
+      message: '📦 GitOps directory:',
       initial: detected.gitops || './gitops',
       validate: value => value.trim().length > 0
     },
     {
       type: 'text',
       name: 'terraform',
-      message: '🔧 Terraform directory (infrastructure as code):',
+      message: '🔧 Terraform directory:',
       initial: detected.terraform || './terraform',
       validate: value => value.trim().length > 0
     },
     {
       type: 'text',
       name: 'appServices',
-      message: '🚀 App Services directory (application code):',
+      message: '🚀 App Services directory:',
       initial: detected.appServices || './app-services',
       validate: value => value.trim().length > 0
     },
     {
-      type: 'text',
-      name: 'projectId',
+      type: 'select',
+      name: 'cloudProvider',
+      message: '☁️  Cloud provider:',
+      choices: [
+        { title: 'GCP (Google Cloud Platform)', value: 'gcp' },
+        { title: 'AWS (Amazon Web Services)', value: 'aws' },
+        { title: 'Multi-cloud (AWS + GCP)', value: 'multi-cloud' }
+      ],
+      initial: 0
+    },
+    {
+      type: (prev, values) => ['gcp', 'multi-cloud'].includes(values.cloudProvider) ? 'text' : null,
+      name: 'gcpProjectId',
       message: '🌐 GCP Project ID (e.g., aaxis-rnd-non-prod):',
       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):',
+      validate: value => value.trim().length > 0
+    },
     {
       type: 'text',
       name: 'region',
-      message: '🌍 Primary Region (e.g., us-central1):',
+      message: '🌍 Primary Region (e.g., us-central1 for GCP, us-east-1 for AWS):',
       initial: 'us-central1',
       validate: value => value.trim().length > 0
     },
     {
       type: 'text',
       name: 'clusterName',
-      message: '☸️  Cluster Name (e.g., non-prod-rnd-gke):',
+      message: '☸️  Cluster Name (e.g., rnd-gke-nonprod or digital-eks-prod):',
       validate: value => value.trim().length > 0
     },
     {
@@ -307,6 +346,12 @@ 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: ''
     }
   ];
 
@@ -382,6 +427,7 @@ async function createClaudeDirectory() {
     // Create project-specific directories (NOT symlinked)
     await fs.mkdir(join(claudeDir, 'logs'), { recursive: true });
     await fs.mkdir(join(claudeDir, 'tests'), { recursive: true });
+    await fs.mkdir(join(claudeDir, 'project-context'), { recursive: true });
 
     spinner.succeed('.claude/ directory created with symlinks');
   } catch (error) {
@@ -401,10 +447,34 @@ async function generateClaudeMd(config) {
     const templatePath = getTemplatePath('CLAUDE.template.md');
     let template = await fs.readFile(templatePath, 'utf-8');
 
+    // Build project configuration section based on cloud provider
+    let projectConfig = '';
+
+    if (config.cloudProvider === 'gcp') {
+      projectConfig = `- **Cloud Provider:** GCP
+- **GCP Project ID:** ${config.gcpProjectId}
+- **Region:** ${config.region}
+- **Cluster:** ${config.clusterName}`;
+    } else if (config.cloudProvider === 'aws') {
+      projectConfig = `- **Cloud Provider:** AWS
+- **AWS Account ID:** ${config.awsAccountId}
+- **Region:** ${config.region}
+- **Cluster:** ${config.clusterName}`;
+    } else if (config.cloudProvider === 'multi-cloud') {
+      projectConfig = `- **Cloud Provider:** Multi-cloud (AWS + GCP)`;
+      if (config.gcpProjectId) {
+        projectConfig += `\n- **GCP Project ID:** ${config.gcpProjectId}`;
+      }
+      if (config.awsAccountId) {
+        projectConfig += `\n- **AWS Account ID:** ${config.awsAccountId}`;
+      }
+      projectConfig += `\n- **Primary Region:** ${config.region}
+- **Cluster:** ${config.clusterName}`;
+    }
+
     // Replace placeholders
-    template = template.replace(/{{PROJECT_ID}}/g, config.projectId);
-    template = template.replace(/{{REGION}}/g, config.region);
-    template = template.replace(/{{CLUSTER_NAME}}/g, config.clusterName);
+    template = template.replace(/{{TIMESTAMP}}/g, new Date().toISOString().split('T')[0]);
+    template = template.replace(/{{PROJECT_CONFIG}}/g, projectConfig);
     template = template.replace(/{{GITOPS_PATH}}/g, config.gitops);
     template = template.replace(/{{TERRAFORM_PATH}}/g, config.terraform);
     template = template.replace(/{{APP_SERVICES_PATH}}/g, config.appServices);
@@ -504,62 +574,100 @@ async function generateProjectContext(config) {
   const spinner = ora('Generating project-context.json...').start();
 
   try {
+    // Build metadata section based on cloud provider
+    const metadata = {
+      version: '1.0',
+      last_updated: new Date().toISOString(),
+      project_root: '.',  // Reference point: where CLAUDE.md is located
+      created_by: 'gaia-init',
+      cloud_provider: config.cloudProvider,
+      environment: 'non-prod',
+      primary_region: config.region
+    };
+
+    // Add cloud-specific metadata
+    if (config.cloudProvider === 'gcp') {
+      metadata.project_id = config.gcpProjectId;
+    } else if (config.cloudProvider === 'aws') {
+      metadata.aws_account = config.awsAccountId;
+    } else if (config.cloudProvider === 'multi-cloud') {
+      if (config.gcpProjectId) metadata.project_id = config.gcpProjectId;
+      if (config.awsAccountId) metadata.aws_account = config.awsAccountId;
+    }
+
+    // Build project_details section
+    const projectDetails = {
+      region: config.region,
+      environment: 'non-prod',
+      cluster_name: config.clusterName,
+      cloud_provider: config.cloudProvider
+    };
+
+    if (config.gcpProjectId) {
+      projectDetails.project_id = config.gcpProjectId;
+    }
+    if (config.awsAccountId) {
+      projectDetails.aws_account = config.awsAccountId;
+    }
+
+    // Build provider_credentials section
+    const providerCredentials = {};
+    if (config.gcpProjectId) {
+      providerCredentials.gcp = {
+        project: config.gcpProjectId,
+        region: config.region
+      };
+    }
+    if (config.awsAccountId) {
+      providerCredentials.aws = {
+        account_id: config.awsAccountId,
+        region: config.region
+      };
+    }
+
     const projectContext = {
-      metadata: {
-        version: '1.0',
-        last_updated: new Date().toISOString(),
-        project_root: '.',  // Reference point: where CLAUDE.md is located
-        created_by: 'gaia-init'
-      },
+      metadata,
       paths: {
         gitops: config.gitops,
         terraform: config.terraform,
         app_services: config.appServices
       },
-      project_details: {
-        id: config.projectId,
-        region: config.region,
-        environment: 'non-prod',
-        cluster_name: config.clusterName
-      },
-      terraform_infrastructure: {
-        layout: {
-          base_path: config.terraform,
-          module_structure: 'terragrunt'
+      sections: {
+        project_details: projectDetails,
+        terraform_infrastructure: {
+          layout: {
+            base_path: config.terraform,
+            module_structure: 'terragrunt'
+          },
+          provider_credentials: providerCredentials
         },
-        provider_credentials: {
-          gcp: {
-            project: config.projectId,
-            region: config.region
+        gitops_configuration: {
+          repository: {
+            path: config.gitops,
+            platform: 'flux'
+          },
+          flux_details: {
+            namespaces: []
           }
-        }
-      },
-      gitops_configuration: {
-        repository: {
-          path: config.gitops,
-          platform: 'flux'
         },
-        flux_details: {
-          namespaces: []
-        }
-      },
-      application_services: {
-        base_path: config.appServices,
-        services: []
-      },
-      operational_guidelines: {
-        commit_standards: {
-          format: 'conventional_commits',
-          validation_required: true,
-          config_path: '.claude/config/git_standards.json'
+        application_services: {
+          base_path: config.appServices,
+          services: []
+        },
+        operational_guidelines: {
+          commit_standards: {
+            format: 'conventional_commits',
+            validation_required: true,
+            config_path: '.claude/config/git_standards.json'
+          }
         }
       }
     };
 
-    const projectContextPath = join(CWD, '.claude', 'project-context.json');
+    const projectContextPath = join(CWD, '.claude', 'project-context', 'project-context.json');
     await fs.writeFile(projectContextPath, JSON.stringify(projectContext, null, 2), 'utf-8');
 
-    spinner.succeed('project-context.json generated');
+    spinner.succeed('project-context/project-context.json generated');
   } catch (error) {
     spinner.fail('Failed to generate project-context.json');
     throw error;
@@ -598,6 +706,54 @@ async function installClaudeAgentsPackage() {
   }
 }
 
+/**
+ * Clone project context repository (optional)
+ */
+async function cloneProjectContextRepo(repoUrl) {
+  if (!repoUrl || repoUrl.trim() === '') {
+    console.log(chalk.gray('\n✓ Skipping project context repo clone (not provided)\n'));
+    return;
+  }
+
+  const spinner = ora('Cloning project context repository...').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 repo directly into project-context directory
+    await execAsync(`git clone ${repoUrl} ${projectContextDir}-temp`);
+
+    // 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);
+      const dest = join(projectContextDir, file);
+      await fs.rename(src, dest);
+    }
+
+    // Remove temp directory
+    await fs.rmdir(tempDir);
+
+    spinner.succeed('Project context repository cloned');
+    console.log(chalk.green(`  → Cloned from: ${repoUrl}`));
+    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`));
+    // Don't throw - allow installation to continue
+  }
+}
+
 // ============================================================================
 // Main installer flow
 // ============================================================================
@@ -666,11 +822,22 @@ async function main() {
     // Step 9: Generate project-context.json
     await generateProjectContext(config);
 
+    // Step 10: Clone project context repository (optional)
+    if (config.projectContextRepo) {
+      await cloneProjectContextRepo(config.projectContextRepo);
+    }
+
     // Success message
     console.log(chalk.green.bold('\n✅ Installation complete!\n'));
     console.log(chalk.gray('Next steps:'));
     console.log(chalk.gray('  1. Review CLAUDE.md and adjust paths if needed'));
-    console.log(chalk.gray('  2. Update .claude/project-context.json with your services'));
+    if (!config.projectContextRepo) {
+      console.log(chalk.gray('  2. Update .claude/project-context/project-context.json with your services'));
+      console.log(chalk.gray('     OR clone your project context repo:'));
+      console.log(chalk.gray('     cd .claude && git clone <your-repo> project-context'));
+    } else {
+      console.log(chalk.gray('  2. Your project context has been cloned to .claude/project-context/'));
+    }
     console.log(chalk.gray('  3. Start Claude Code: claude-code\n'));
     console.log(chalk.cyan('📚 Documentation: .claude/config/\n'));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaguilar87/gaia-ops",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Multi-agent orchestration system for Claude Code - DevOps automation toolkit",
   "main": "index.js",
   "type": "module",

package/templates/CLAUDE.template.md

@@ -4,9 +4,6 @@ last_updated: {{TIMESTAMP}}
 description: Orchestrator instructions for Claude Code agent system
 maintainer: jaguilar@aaxis.com
 changelog: .claude/CHANGELOG.md
-project_id: {{PROJECT_ID}}
-region: {{REGION}}
-cluster: {{CLUSTER_NAME}}
 ---
 
 # CLAUDE.md
@@ -142,9 +139,7 @@ Guidance for Claude Code orchestrator working in this repository.
 ## Project Configuration
 
 **This project:**
-- **GCP Project ID:** {{PROJECT_ID}}
-- **Region:** {{REGION}}
-- **Cluster:** {{CLUSTER_NAME}}
+{{PROJECT_CONFIG}}
 - **GitOps Path:** {{GITOPS_PATH}}
 - **Terraform Path:** {{TERRAFORM_PATH}}
 - **App Services Path:** {{APP_SERVICES_PATH}}