@jaguilar87/gaia-ops 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -7,6 +7,71 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.2.0] - 2025-11-10
+
+### Added - Unified Settings Template & Auto-Installation
+- **NEW:** Created unified `templates/settings.template.json` (214 lines)
+  - Merged functionality from `settings.json` + `settings.local.json`
+  - Includes all hooks (PreToolUse, PostToolUse, SubagentStop)
+  - Complete permissions (75+ allow, 9 deny, 27 ask entries)
+  - Full security tier definitions (T0-T3)
+  - Environment configuration
+
+- **Auto-Installation:** `gaia-init.js` now automatically generates `.claude/settings.json`
+  - Added `generateSettingsJson()` function
+  - Integrated into installation workflow (Step 6.5)
+  - Projects get complete settings from day 1
+
+### Removed - Dead Code Elimination
+- **CLAUDE.md** from package root (only template exists now)
+- **templates/code-examples/** (321 lines - never imported or executed)
+  - `commit_validation.py`
+  - `clarification_workflow.py`
+  - `approval_gate_workflow.py`
+- **templates/project-context.template.json** (126 lines - unused, installer generates programmatically)
+- **templates/project-context.template.aws.json** (128 lines - never used)
+- **package.json:** Removed `CLAUDE.md` from files array
+
+### Changed - Package Consistency
+- **templates/CLAUDE.template.md:**
+  - Updated all references: `.claude/docs/` → `.claude/config/`
+  - Updated package name: `@aaxis/claude-agents` → `@jaguilar87/gaia-ops`
+  - Removed code-examples reference (no longer exists)
+
+- **README.en.md:**
+  - Updated API examples to use `@jaguilar87/gaia-ops`
+  - Changed `getDocPath()` → `getConfigPath()` (correct function)
+
+- **index.js:**
+  - Updated header and JSDoc comments with new package name
+  - Updated example usage
+
+- **agents/claude-architect.md:**
+  - Updated system paths to reflect gaia-ops package structure
+  - Clarified symlink architecture and layout
+
+### Improved - Package Quality
+- **Reduced template bloat by 57%:** 882 lines → 378 lines (504 lines removed)
+- **Single source of truth:** One settings template instead of scattered config
+- **Cleaner architecture:** Only actual templates remain in `templates/`
+- **Better defaults:** Projects start with complete, production-ready settings
+
+### Benefits
+- ✅ **Unified configuration:** Everything in one settings.json file
+- ✅ **Automatic setup:** No manual settings configuration needed
+- ✅ **Smaller package:** 57% reduction in template code
+- ✅ **Flexibility maintained:** Users can still create `settings.local.json` for overrides
+- ✅ **Package consistency:** All references use correct package name
+
+### Final Template Structure
+```
+templates/
+├── CLAUDE.template.md         (164 lines) - Orchestrator instructions
+└── settings.template.json     (214 lines) - Complete Claude Code settings
+```
+
+---
+
 ## [2.1.0] - 2025-11-10
 
 ### Added - Provider-Specific Context Contracts

package/README.en.md

@@ -14,6 +14,7 @@ Multi-agent orchestration system for Claude Code - DevOps automation toolkit.
 
 ### Features
 
+- **Multi-cloud support** - Works with GCP, AWS, and ready for Azure
 - **6 specialist agents** (terraform-architect, gitops-operator, gcp-troubleshooter, aws-troubleshooter, devops-developer, claude-architect)
 - **3 meta-agents** (Explore, Plan, claude-architect)
 - **Clarification engine** for ambiguity detection
@@ -160,17 +161,17 @@ If you need to programmatically access paths in the package:
 import {
   getAgentPath,
   getToolPath,
-  getDocPath
-} from '@aaxis/claude-agents';
+  getConfigPath
+} from '@jaguilar87/gaia-ops';
 
 const agentPath = getAgentPath('gitops-operator');
-// → /path/to/node_modules/@aaxis/claude-agents/agents/gitops-operator.md
+// → /path/to/node_modules/@jaguilar87/gaia-ops/agents/gitops-operator.md
 
 const toolPath = getToolPath('context_provider.py');
-// → /path/to/node_modules/@aaxis/claude-agents/tools/context_provider.py
+// → /path/to/node_modules/@jaguilar87/gaia-ops/tools/context_provider.py
 
-const docPath = getDocPath('orchestration-workflow.md');
-// → /path/to/node_modules/@aaxis/claude-agents/docs/orchestration-workflow.md
+const configPath = getConfigPath('orchestration-workflow.md');
+// → /path/to/node_modules/@jaguilar87/gaia-ops/config/orchestration-workflow.md
 ```
 
 ## Versioning

package/README.md

@@ -14,6 +14,7 @@ Sistema de orquestación multi-agente para Claude Code - Toolkit de automatizaci
 
 ### Características
 
+- **Soporte multi-cloud** - Funciona con GCP, AWS, y listo para Azure
 - **6 agentes especialistas** (terraform-architect, gitops-operator, gcp-troubleshooter, aws-troubleshooter, devops-developer, claude-architect)
 - **3 meta-agentes** (Explore, Plan, claude-architect)
 - **Motor de clarificación** para detección de ambigüedades
@@ -181,7 +182,7 @@ Este paquete sigue [Versionamiento Semántico](https://semver.org/):
 - **MINOR:** Nuevas características, agentes o mejoras
 - **PATCH:** Correcciones de bugs, clarificaciones, errores tipográficos
 
-Versión actual: **1.0.3**
+Versión actual: **2.1.0**
 
 Ver [CHANGELOG.md](./CHANGELOG.md) para el historial de versiones.
 

package/agents/claude-architect.md

@@ -15,16 +15,16 @@ You are a senior system architect and AI agent systems specialist. Your unique p
 2. **Locate & Read:** You know where EVERYTHING lives. Read only what you need for THIS request.
 3. **Analyze & Respond:** Provide comprehensive answer with evidence, examples, and actionable recommendations.
 
-**Where Everything Lives (You Know This By Heart):**
-- 🏗️ System: `/home/jaguilar/aaxis/rnd/repositories/.claude/`
-- 📋 Orchestrator: `CLAUDE.md` (workflow logic)
-- 🤖 Agents: `.claude/agents/` (5 specialists + you)
-- 🛠️ Tools: `.claude/tools/` (routing, context, validation)
-- 📊 Logs: `.claude/logs/` (JSONL audit trail)
-- ✅ Tests: `.claude/tests/` (55+ tests)
-- 🎯 Spec-Kit: `.claude/commands/speckit.*` (7 commands)
-- 💾 Sessions: `.claude/session/` (active + bundles)
-- 🔗 Multi-repo: `ops/` (symlinks: claude-rnd, claude-vtr)
+**Where Everything Lives (Package + Symlink Layout):**
+- 🏗️ Package root: `/home/jaguilar/aaxis/rnd/repositories/gaia-ops/` → mirrors `node_modules/@jaguilar87/gaia-ops/` when installed
+- 📋 Orchestrator: `CLAUDE.md` at the package root (templated into consuming repos)
+- 🤖 Agents: `agents/*.md` (6 specialists: terraform-architect, gitops-operator, gcp-troubleshooter, aws-troubleshooter, devops-developer, claude-architect)
+- 🛠️ Tools: `tools/` (context_provider.py, agent_router.py, clarify_engine.py, approval_gate.py, commit_validator.py, task_manager.py)
+- 📚 Config docs: `config/` (AGENTS, orchestration-workflow, git-standards, context-contracts, agent-catalog)
+- 🗂️ Commands: `commands/*.md` (`/architect`, `/save-session`, `/session-status`, `/speckit.*`)
+- 🎯 Spec-Kit assets: `speckit/README*.md`, `speckit/templates/`, `speckit/scripts/`, `speckit/governance.md`, `speckit/decisions/`
+- 🔧 Reference stacks: `terraform/`, `gitops/`, `app-services/` illustrate how agents interact with user IaC/App repos
+- 💾 Project data: consuming repos host `.claude/project-context.json`, `.claude/logs/`, `.claude/tests/`, while `ops/` carries shared symlink helpers
 
 **Your Superpowers:**
 - ✅ You understand the ENTIRE system (no one else does)
@@ -65,43 +65,51 @@ You have intrinsic knowledge of the system's structure. You know EXACTLY where t
 ### Core System Files (Always Available)
 
 ```
-Agent System Structure:
-├── CLAUDE.md                           # Master orchestrator logic (715 lines)
-├── .claude/
-│   ├── project-context.json           # Project SSOT (varies by project)
-│   ├── settings.json                  # System configuration
-│   ├── agents/                        # 5 specialized agents
-│   │   ├── gitops-operator.md         (340 lines)
-│   │   ├── terraform-architect.md     (270 lines)
-│   │   ├── gcp-troubleshooter.md      (305 lines)
-│   │   ├── aws-troubleshooter.md      (289 lines)
-│   │   └── devops-developer.md        (89 lines)
-│   ├── tools/                         # System intelligence
-│   │   ├── agent_router.py            # Semantic routing (92.7% accuracy target)
-│   │   ├── context_provider.py        # Deterministic context generation
-│   │   ├── context_section_reader.py  # Selective context loading
-│   │   ├── semantic_matcher.py        # Fallback routing
-│   │   ├── agent_invoker_helper.py    # Agent invocation utilities
-│   │   ├── tasks-richer.py            # Task enrichment
-│   │   └── generate_embeddings.py     # Embedding generation
-│   ├── hooks/                         # Security & audit layer
-│   │   ├── pre_tool_use.py           # Pre-execution validation
-│   │   ├── post_tool_use.py          # Post-execution audit
-│   │   └── subagent_stop.py          # Agent completion capture
-│   ├── commands/                      # 13 slash commands
-│   ├── session/                       # Session management
-│   │   ├── active/context.json       # Live session state
-│   │   ├── bundles/                  # Historical snapshots
-│   │   └── scripts/                  # Session tools
-│   ├── tests/                         # Test suite (55+ tests)
-│   │   ├── test_semantic_routing.py  # Routing accuracy tests
-│   │   ├── test_all_functionality.py # Core system tests
-│   │   └── test_ssot_policies.py     # SSOT validation
-│   ├── logs/                          # Audit trail (JSONL format)
-│   └── schemas/                       # JSON schemas
-└── improvement-ideas.md               # System improvement backlog
+gaia-ops/  (mirrors node_modules/@jaguilar87/gaia-ops/ and symlinks into project .claude/)
+├── CLAUDE.md                       # Master orchestrator logic + workflow (≈150 lines here, expanded in config/)
+├── agents/                         # 6 specialized agent prompts
+│   ├── terraform-architect.md
+│   ├── gitops-operator.md
+│   ├── gcp-troubleshooter.md
+│   ├── aws-troubleshooter.md
+│   ├── devops-developer.md
+│   └── claude-architect.md
+├── tools/                          # System intelligence + automation
+│   ├── context_provider.py         # Deterministic context generation
+│   ├── agent_router.py             # Semantic routing (92.7% target accuracy)
+│   ├── clarify_engine.py           # Ambiguity detection
+│   ├── approval_gate.py            # Tiered approval logic
+│   ├── commit_validator.py         # Conventional commits enforcement
+│   └── task_manager.py             # Large-plan chunking
+├── hooks/                          # Git + security hooks
+├── commands/                       # User-facing slash commands (architect/save-session/speckit.*)
+├── config/                         # Documentation bundle (AGENTS/orchestration-workflow/git-standards/context-contracts/agent-catalog)
+├── speckit/                        # Spec-Kit 2.0 framework (README*.md, governance.md, decisions/, templates/, scripts/)
+├── app-services/                   # Sample application services for reference
+├── gitops/                         # Reference GitOps manifests
+├── terraform/                      # Reference Terraform stacks
+├── templates/                      # CLAUDE + code templates
+├── tests/                          # Test suite (55+ cases referenced in README)
+├── CHANGELOG.md                    # Version history (Semantic Versioning)
+└── package.json / index.js         # NPM package metadata + helper exports
 ```
 
+When `npx @jaguilar87/gaia-ops init` (or `gaia-init` after a global install) runs in a consuming project it:
+1. Detects GitOps/Terraform/AppServices paths and installs Claude Code if needed.
+2. Creates `.claude/` and symlinks `agents/`, `tools/`, `hooks/`, `commands/`, `templates/`, and `config/` back to this package.
+3. Generates `CLAUDE.md`, links `AGENTS.md`, and seeds `.claude/project-context.json` (project SSOT). Project-owned items such as `.claude/logs/`, `.claude/tests/`, and session data remain local.
+
+### Installation & Project Layout (from README.md / README.en.md)
+- Quick start: `npx @jaguilar87/gaia-ops init` (or `npm install -g @jaguilar87/gaia-ops && gaia-init`) bootstraps everything; manual installs `npm install @jaguilar87/gaia-ops` + symlink commands from README.
+- Resulting structure: `your-project/.claude/{agents,tools,hooks,commands,templates,config}` → symlinked to this package under `node_modules/@jaguilar87/gaia-ops/`, while `logs/`, `tests/`, and `project-context.json` stay project-specific.
+- Reference directories `gitops/`, `terraform/`, and `app-services/` inside the package illustrate how specialized agents should reason about user IaC/App codebases.
+
+### Spec-Kit 2.0 Workflow Snapshot (from speckit/README*.md)
+- `speckit/` hosts bilingual docs, governance (`speckit/governance.md`), immutable ADRs (`speckit/decisions/ADR-*.md`), templates, and scripts backing `/speckit.*` commands.
+- Core flow: `/speckit.init` → `/speckit.specify` → `/speckit.plan` → `/speckit.tasks` → `/speckit.implement`, each auto-injecting project-context data, clarification, validation, and risk analysis (T2/T3 gates) directly into specs/plan/tasks artifacts.
+- Helper commands: `/speckit.add-task` adds enriched tasks mid-implementation, `/speckit.analyze-task` deep-dives high-risk tasks, and `/save-session` captures context bundles for portability.
+- Spec-Kit 2.0 removes standalone enrichers (`tasks-richer.py`), performs inline validation, and relies on `.claude/project-context.json` for deterministic context so the architect agent can reason about idea → spec → plan → tasks → implementation continuity.
+
 ### Key System Metrics (What to Track)
 
 - **Routing Accuracy:** Target 92.7% (from tests)
@@ -818,4 +826,3 @@ python3 -m pytest .claude/tests/ --cov=.claude/tools --cov-report=term
 ---
 
 **Remember:** You are not just analyzing files - you are understanding a living, evolving system. Your insights drive its continuous improvement.
-

package/bin/gaia-init.js

@@ -603,6 +603,29 @@ async function createClaudeDirectory() {
   }
 }
 
+/**
+ * Generate settings.json from template
+ */
+async function generateSettingsJson() {
+  const spinner = ora('Generating .claude/settings.json...').start();
+
+  try {
+    const settingsPath = join(CWD, '.claude', 'settings.json');
+    const templatePath = getTemplatePath('settings.template.json');
+
+    // Read template
+    const template = await fs.readFile(templatePath, 'utf-8');
+
+    // Write settings.json (no placeholders to replace)
+    await fs.writeFile(settingsPath, template, 'utf-8');
+
+    spinner.succeed('.claude/settings.json generated');
+  } catch (error) {
+    spinner.fail('Failed to generate settings.json');
+    throw error;
+  }
+}
+
 /**
  * Generate CLAUDE.md from template
  */
@@ -1000,6 +1023,9 @@ async function main() {
     // Step 6: Create .claude/ directory with symlinks
     await createClaudeDirectory();
 
+    // Step 6.5: Generate settings.json
+    await generateSettingsJson();
+
     // Step 7: Generate CLAUDE.md
     await generateClaudeMd(config);
 

package/index.js

@@ -1,12 +1,13 @@
 /**
- * @aaxis/claude-agents
+ * @jaguilar87/gaia-ops
  *
- * Shared Claude Code agent system for Aaxis DevOps workflows
+ * Multi-agent orchestration system for Claude Code - DevOps automation toolkit
  *
  * Usage:
- *   import { getAgentPath, getToolPath } from '@aaxis/claude-agents';
+ *   import { getAgentPath, getToolPath, getConfigPath } from '@jaguilar87/gaia-ops';
  *   const agentPath = getAgentPath('gitops-operator');
  *   const toolPath = getToolPath('context_provider.py');
+ *   const configPath = getConfigPath('orchestration-workflow.md');
  */
 
 import { fileURLToPath } from 'url';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaguilar87/gaia-ops",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Multi-agent orchestration system for Claude Code - DevOps automation toolkit",
   "main": "index.js",
   "type": "module",
@@ -39,7 +39,6 @@
     "templates/",
     "config/",
     "speckit/",
-    "CLAUDE.md",
     "CHANGELOG.md",
     "README.en.md",
     "index.js"

package/templates/CLAUDE.template.md

@@ -38,7 +38,7 @@ Guidance for Claude Code orchestrator working in this repository.
 
 ## Orchestrator Workflow
 
-**See:** `.claude/docs/orchestration-workflow.md` for complete details.
+**See:** `.claude/config/orchestration-workflow.md` for complete details.
 
 ### Rule 5.0 [P0]: Six-Phase Workflow
 
@@ -73,12 +73,12 @@ Guidance for Claude Code orchestrator working in this repository.
 - **Max:** 72 chars, imperative mood, no period
 - **Forbidden:** Claude Code attribution footers
 
-**Complete spec:** `.claude/docs/git-standards.md`
+**Complete spec:** `.claude/config/git-standards.md`
 **Config:** `.claude/config/git_standards.json`
 
 ## Context Contracts
 
-**See:** `.claude/docs/context-contracts.md` for complete contracts.
+**See:** `.claude/config/context-contracts.md` for complete contracts.
 
 | Agent | Required Context |
 |-------|-----------------|
@@ -90,7 +90,7 @@ Guidance for Claude Code orchestrator working in this repository.
 
 ## Agent System
 
-**See:** `.claude/docs/agent-catalog.md` for full capabilities.
+**See:** `.claude/config/agent-catalog.md` for full capabilities.
 
 ### Project Agents (use context_provider.py)
 
@@ -148,18 +148,17 @@ Guidance for Claude Code orchestrator working in this repository.
 
 **NOTE:** All paths are relative to this repository root, resolved at runtime via npm package.
 
-- **Agent system:** `.claude/` (symlinked to `node_modules/@aaxis/claude-agents/`)
+- **Agent system:** `.claude/` (symlinked to `node_modules/@jaguilar87/gaia-ops/`)
 - **Orchestrator:** `./CLAUDE.md` (this file)
-- **Tools:** `.claude/tools/` → `node_modules/@aaxis/claude-agents/tools/`
+- **Tools:** `.claude/tools/` → `node_modules/@jaguilar87/gaia-ops/tools/`
 - **Logs:** `.claude/logs/` (project-specific, NOT symlinked)
 - **Tests:** `.claude/tests/` (project-specific, NOT symlinked)
 - **Project SSOT:** `.claude/project-context.json` (project-specific, NOT symlinked)
 
 ## References
 
-- **Orchestration workflow:** `.claude/docs/orchestration-workflow.md`
-- **Git standards:** `.claude/docs/git-standards.md`
-- **Context contracts:** `.claude/docs/context-contracts.md`
-- **Agent catalog:** `.claude/docs/agent-catalog.md`
-- **Code examples:** `.claude/templates/code-examples/`
-- **Package source:** `@aaxis/claude-agents` (npm package)
+- **Orchestration workflow:** `.claude/config/orchestration-workflow.md`
+- **Git standards:** `.claude/config/git-standards.md`
+- **Context contracts:** `.claude/config/context-contracts.md`
+- **Agent catalog:** `.claude/config/agent-catalog.md`
+- **Package source:** `@jaguilar87/gaia-ops` (npm package)