@jaguilar87/gaia-ops 2.4.2 → 2.4.4

package/bin/gaia-update.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+
+/**
+ * @jaguilar87/gaia-ops - Auto-update script
+ *
+ * Runs automatically on npm install/update (postinstall hook)
+ *
+ * Purpose:
+ * - Regenerate CLAUDE.md from template (preserving existing values)
+ * - Regenerate settings.json from template
+ * - Only runs if CLAUDE.md already exists (skip first-time install, let gaia-init handle it)
+ *
+ * Usage: Automatic (npm postinstall hook)
+ */
+
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import fs from 'fs/promises';
+import { existsSync } from 'fs';
+import chalk from 'chalk';
+import ora from 'ora';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const CWD = process.cwd();
+
+/**
+ * Extract placeholder values from existing CLAUDE.md
+ */
+async function extractExistingValues() {
+  const claudeMdPath = join(CWD, 'CLAUDE.md');
+
+  if (!existsSync(claudeMdPath)) {
+    return null; // First time install, skip
+  }
+
+  try {
+    const content = await fs.readFile(claudeMdPath, 'utf-8');
+
+    // Extract values from CLAUDE.md (simple pattern matching)
+    const gitopsMatch = content.match(/- \*\*GitOps Path:\*\* (.+)/);
+    const terraformMatch = content.match(/- \*\*Terraform Path:\*\* (.+)/);
+    const appServicesMatch = content.match(/- \*\*App Services Path:\*\* (.+)/);
+    const projectConfigMatch = content.match(/\*\*This project:\*\*\s+([\s\S]+?)## System Paths/);
+
+    return {
+      gitops: gitopsMatch ? gitopsMatch[1].trim() : './gitops',
+      terraform: terraformMatch ? terraformMatch[1].trim() : './terraform',
+      appServices: appServicesMatch ? appServicesMatch[1].trim() : './app-services',
+      projectConfig: projectConfigMatch ? projectConfigMatch[1].trim() : ''
+    };
+  } catch (error) {
+    console.warn(chalk.yellow(`⚠️  Could not extract existing values: ${error.message}`));
+    return null;
+  }
+}
+
+/**
+ * Regenerate CLAUDE.md from template
+ */
+async function updateClaudeMd() {
+  const spinner = ora('Updating CLAUDE.md...').start();
+
+  try {
+    // Get template path from gaia-ops package
+    const templatePath = join(__dirname, '../templates/CLAUDE.template.md');
+
+    if (!existsSync(templatePath)) {
+      spinner.warn('Template not found, skipping CLAUDE.md update');
+      return false;
+    }
+
+    let template = await fs.readFile(templatePath, 'utf-8');
+
+    // Extract existing values if CLAUDE.md exists
+    const existingValues = await extractExistingValues();
+
+    if (!existingValues) {
+      // First time install - don't auto-generate, gaia-init handles it
+      spinner.info('First-time installation detected - skipping auto-update');
+      return false;
+    }
+
+    // Replace placeholders with extracted values
+    template = template.replace(/{{GITOPS_PATH}}/g, existingValues.gitops);
+    template = template.replace(/{{TERRAFORM_PATH}}/g, existingValues.terraform);
+    template = template.replace(/{{APP_SERVICES_PATH}}/g, existingValues.appServices);
+
+    if (existingValues.projectConfig) {
+      template = template.replace(/{{PROJECT_CONFIG}}/g, existingValues.projectConfig);
+    }
+
+    // Write updated CLAUDE.md
+    const claudeMdPath = join(CWD, 'CLAUDE.md');
+    await fs.writeFile(claudeMdPath, template, 'utf-8');
+
+    spinner.succeed('CLAUDE.md updated successfully');
+    return true;
+  } catch (error) {
+    spinner.fail(`Failed to update CLAUDE.md: ${error.message}`);
+    return false;
+  }
+}
+
+/**
+ * Regenerate settings.json from template
+ */
+async function updateSettingsJson() {
+  const spinner = ora('Updating settings.json...').start();
+
+  try {
+    const templatePath = join(__dirname, '../templates/settings.template.json');
+    const settingsPath = join(CWD, '.claude', 'settings.json');
+
+    if (!existsSync(templatePath)) {
+      spinner.warn('Settings template not found, skipping');
+      return false;
+    }
+
+    if (!existsSync(join(CWD, '.claude'))) {
+      spinner.info('First-time installation detected - skipping auto-update');
+      return false;
+    }
+
+    // Copy template to settings.json (overwrite to get latest)
+    const template = await fs.readFile(templatePath, 'utf-8');
+    await fs.writeFile(settingsPath, template, 'utf-8');
+
+    spinner.succeed('settings.json updated successfully');
+    return true;
+  } catch (error) {
+    spinner.fail(`Failed to update settings.json: ${error.message}`);
+    return false;
+  }
+}
+
+/**
+ * Main function
+ */
+async function main() {
+  console.log(chalk.cyan('\n🔄 @jaguilar87/gaia-ops auto-update\n'));
+
+  try {
+    const claudeUpdated = await updateClaudeMd();
+    const settingsUpdated = await updateSettingsJson();
+
+    if (claudeUpdated || settingsUpdated) {
+      console.log(chalk.green('\n✅ Auto-update completed\n'));
+      console.log(chalk.gray('Next steps:'));
+      if (claudeUpdated) {
+        console.log(chalk.gray('  • Review CLAUDE.md for any needed adjustments'));
+      }
+      if (settingsUpdated) {
+        console.log(chalk.gray('  • Review settings.json for security rules'));
+      }
+    } else {
+      // Silent exit on first-time install (gaia-init will handle it)
+      process.exit(0);
+    }
+  } catch (error) {
+    console.error(chalk.red(`\n❌ Auto-update failed: ${error.message}\n`));
+    // Don't fail npm install, just warn
+    process.exit(0);
+  }
+}
+
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaguilar87/gaia-ops",
-  "version": "2.4.2",
+  "version": "2.4.4",
   "description": "Multi-agent orchestration system for Claude Code - DevOps automation toolkit",
   "main": "index.js",
   "type": "module",
@@ -51,7 +51,8 @@
     "validate": "python3 tools/commit_validator.py",
     "lint": "eslint .",
     "clean": "find . -type d -name '__pycache__' -exec rm -rf {} + 2>/dev/null || true",
-    "prepublishOnly": "npm run clean"
+    "prepublishOnly": "npm run clean",
+    "postinstall": "node bin/gaia-update.js"
   },
   "dependencies": {
     "prompts": "^2.4.2",

package/templates/CLAUDE.template.md

@@ -30,13 +30,11 @@
 | 0 | Clarification (if ambiguous) | `clarification` module | Conditional |
 | 1 | Route to agent | `agent_router.py` | Yes |
 | 2 | Provision context | `context_provider.py` | Yes |
-| 3 | Invoke (Planning) | `Task` tool | Yes |
+| 3 | Invoke (Planning) | `Task(subagent_type=<agent>, prompt=<enriched>)` | Yes |
 | 4 | Approval Gate | `approval_gate.py` | **Yes (T3)** |
 | 5 | Realization | `Task` tool (re-invoke) | Yes |
 | 6 | Update SSOT | Edit `project-context.json`, `tasks.md` | Yes |
 
-**See:** `.claude/config/orchestration-workflow.md` for complete details.
-
 ### Rule 5.0.1 [P0]: Phase 0 Implementation
 
 **When to invoke Phase 0:**
@@ -86,7 +84,7 @@ if result.get("needs_manual_questioning"):
 
 **See:** `.claude/config/orchestration-workflow.md` lines 25-150 for complete Phase 0 protocol.
 
-### Rule 5.1 [P0]: Approval Gate Enforcement
+### Rule 5.1 [P0]: Phase Checkpoint Enforcement
 - Phase 4 CANNOT be skipped for T3 operations
 - Phase 5 requires `validation["approved"] == True`
 - Phase 6 updates MUST complete after successful realization

package/templates/settings.template.json

@@ -54,7 +54,6 @@
       "mcp__ide__executeCode",
       "WebSearch",
       "WebFetch",
-
       "Bash(kubectl get:*)",
       "Bash(kubectl describe:*)",
       "Bash(kubectl logs:*)",
@@ -64,24 +63,20 @@
       "Bash(kubectl top:*)",
       "Bash(kubectl wait:*)",
       "Bash(kubectl run:*)",
-
       "Bash(flux check:*)",
       "Bash(flux get:*)",
       "Bash(flux version:*)",
-
       "Bash(helm list:*)",
       "Bash(helm status:*)",
       "Bash(helm version:*)",
       "Bash(helm template:*)",
       "Bash(helm lint:*)",
-
       "Bash(git status:*)",
       "Bash(git log:*)",
       "Bash(git diff:*)",
       "Bash(git show:*)",
       "Bash(git branch:*)",
       "Bash(git init:*)",
-
       "Bash(gcloud version:*)",
       "Bash(gcloud config:*)",
       "Bash(gcloud auth:*)",
@@ -101,13 +96,20 @@
       "Bash(gcloud iam.*describe:*)",
       "Bash(gcloud logging read:*)",
       "Bash(gsutil ls:*)",
-
       "Bash(terraform version:*)",
       "Bash(terraform fmt:*)",
       "Bash(terraform validate:*)",
       "Bash(terraform show:*)",
       "Bash(terraform output:*)",
-
+      "Bash(terraform output:*)",
+      "Bash(terragrunt init:*)",
+      "Bash(terragrunt plan:*)",
+      "Bash(terragrunt output:*)",
+      "Bash(terragrunt state list:*)",      
+      "Bash(terragrunt show:*)",
+      "Bash(terragrunt validate:*)",
+      "Bash(terragrunt version:*)",
+      "Bash(terragrunt fmt:*)",
       "Bash(aws s3 ls:*)",
       "Bash(aws s3api get-:*)",
       "Bash(aws s3api list-:*)",
@@ -128,7 +130,6 @@
       "Bash(aws logs describe-:*)",
       "Bash(aws logs get-log-events:*)",
       "Bash(aws sts get-caller-identity:*)",
-
       "Bash(docker ps:*)",
       "Bash(docker images:*)",
       "Bash(docker inspect:*)",
@@ -141,7 +142,6 @@
       "Bash(docker version:*)",
       "Bash(docker info:*)",
       "Bash(docker system df:*)",
-
       "Bash(ls:*)",
       "Bash(pwd:*)",
       "Bash(cd:*)",
@@ -172,33 +172,16 @@
       "Bash(gcloud compute networks delete:*)",
       "Bash(gsutil rm.*-r:*)",
       "Bash(gsutil rb:*)",
-
       "Bash(kubectl drain:*)",
       "Bash(kubectl cordon:*)",
       "Bash(kubectl uncordon:*)",
-
-      "Bash(terraform destroy:*)",
-      "Bash(terragrunt destroy:*)",
-
       "Bash(aws ec2 terminate-instances:*)",
       "Bash(aws rds delete-db-instance:*)",
       "Bash(aws rds delete-db-cluster:*)",
       "Bash(aws iam delete-:*)",
       "Bash(aws iam.*delete.*policy:*)",
       "Bash(aws cloudformation delete-stack:*)",
-      "Bash(aws lambda delete-function:*)",
-      "Bash(aws s3.*rb :*)",
-      "Bash(aws s3 rm.*--recursive:*)",
-
-      "Bash(docker rm:*)",
-      "Bash(docker rmi:*)",
-      "Bash(docker volume rm:*)",
-      "Bash(docker network rm:*)",
-      "Bash(docker system prune.*--all:*)",
-      "Bash(docker container prune:*)",
-      "Bash(docker image prune.*--all:*)",
-      "Bash(docker compose down.*--volumes:*)",
-
+      "Bash(aws lambda delete-function:*)",  
       "Bash(dd:*)",
       "Bash(mkfs:*)",
       "Bash(fdisk:*)"
@@ -208,7 +191,6 @@
       "Edit",
       "Write",
       "NotebookEdit",
-
       "Bash(kubectl delete:*)",
       "Bash(kubectl rollout:*)",
       "Bash(kubectl scale:*)",
@@ -217,41 +199,33 @@
       "Bash(kubectl apply:*)",
       "Bash(kubectl replace:*)",
       "Bash(kubectl exec:*)",
-
       "Bash(flux delete:*)",
       "Bash(flux reconcile:*)",
       "Bash(flux create:*)",
       "Bash(flux suspend:*)",
       "Bash(flux resume:*)",
-
       "Bash(helm install:*)",
       "Bash(helm upgrade:*)",
       "Bash(helm uninstall:*)",
       "Bash(helm delete:*)",
       "Bash(helm rollback:*)",
-
       "Bash(git commit:*)",
       "Bash(git push:*)",
       "Bash(git merge:*)",
       "Bash(git rebase:*)",
       "Bash(git cherry-pick:*)",
       "Bash(git add:*)",
-
       "Bash(terraform plan:*)",
       "Bash(terraform apply:*)",
       "Bash(terragrunt plan:*)",
       "Bash(terragrunt apply:*)",
-
       "Bash(rm:*)",
       "Bash(rmdir:*)",
       "Bash(mv:*)",
       "Bash(cp:*)",
       "Bash(chmod:*)",
       "Bash(chown:*)",
-
-      "Bash(aws.*--dryrun:*)",
-      "Bash(aws s3 mb:*)",
-      "Bash(aws s3 cp:*)",
+      
       "Bash(aws s3api put-:*)",
       "Bash(aws ec2 run-instances:*)",
       "Bash(aws ec2 create-:*)",
@@ -269,8 +243,6 @@
       "Bash(aws lambda update-:*)",
       "Bash(aws cloudformation create-stack:*)",
       "Bash(aws cloudformation update-stack:*)",
-
-      "Bash(gcloud.*--dryrun:*)",
       "Bash(gcloud compute instances create:*)",
       "Bash(gcloud compute instances stop:*)",
       "Bash(gcloud compute instances start:*)",
@@ -286,28 +258,10 @@
       "Bash(gsutil mb:*)",
       "Bash(gsutil cp:*)",
       "Bash(gcloud functions deploy:*)",
-
-      "Bash(docker build:*)",
-      "Bash(docker run:*)",
-      "Bash(docker commit:*)",
-      "Bash(docker start:*)",
-      "Bash(docker stop:*)",
-      "Bash(docker restart:*)",
-      "Bash(docker pause:*)",
-      "Bash(docker unpause:*)",
-      "Bash(docker rename:*)",
-      "Bash(docker cp:*)",
-      "Bash(docker tag:*)",
-      "Bash(docker push:*)",
-      "Bash(docker pull:*)",
-      "Bash(docker volume create:*)",
-      "Bash(docker network create:*)",
-      "Bash(docker network connect:*)",
-      "Bash(docker compose up:*)",
-      "Bash(docker compose down:*)",
-      "Bash(docker compose stop:*)",
-      "Bash(docker compose start:*)",
-      "Bash(docker compose restart:*)"
+      "Bash(terragrunt apply:*)",
+      "Bash(terragrunt destroy:*)",
+      "Bash(terraform destroy:*)",
+      "Bash(terraform destroy:*)"     
     ]
   },
 
@@ -345,29 +299,9 @@
       "gcloud compute networks delete",
       "gsutil rm.*-r",
       "gsutil rb",
-      "terraform destroy",
-      "terragrunt destroy",
       "git push.*--force",
-      "git push.*-f ",
       "git reset.*--hard",
-      "kubectl drain",
-      "rm -rf /",
-      "dd if=",
-      "mkfs\\.",
-      "fdisk",
-      "aws ec2 terminate-instances",
-      "aws rds delete-db-instance",
-      "aws rds delete-db-cluster",
-      "aws iam delete-",
-      "aws cloudformation delete-stack",
-      "aws lambda delete-function",
-      "aws s3.*rb",
-      "docker rm",
-      "docker rmi",
-      "docker volume rm",
-      "docker network rm",
-      "docker system prune.*--all",
-      "docker compose down.*--volumes"
+      "kubectl drain"    
     ]
   },