@jaguilar87/gaia-ops 4.4.0-rc.4 → 4.4.0

package/.claude-plugin/marketplace.json

@@ -8,14 +8,8 @@
     {
       "name": "gaia-security",
       "description": "Keeps you in the loop only when it matters. Gaia Security analyzes every command and classifies it into risk tiers: read-only queries run freely, simulations and validations pass through, and state-changing operations (create, delete, apply, push) pause for your explicit approval before executing. Irreversible commands like dropping databases or deleting cloud infrastructure are permanently blocked.",
-      "version": "4.4.0-rc.4",
+      "version": "4.4.0",
       "source": "./dist/gaia-security"
-    },
-    {
-      "name": "gaia-ops",
-      "description": "Full DevOps orchestration for Claude Code. Six specialized agents handle the complete development lifecycle — analysis, planning, execution, and deployment. Gaia-Ops scans your codebase to understand it and injects the right context into each sub-agent. Every command is classified by risk: read-only runs freely, state changes pause for your approval, and irreversible operations are permanently blocked.",
-      "version": "4.4.0-rc.4",
-      "source": "./dist/gaia-ops"
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "gaia-ops",
-  "version": "4.4.0-rc.4",
+  "version": "4.4.0",
   "description": "Security-first orchestrator with specialized agents, hooks, and governance for AI coding",
   "author": {
     "name": "jaguilar87"

package/ARCHITECTURE.md

@@ -15,7 +15,7 @@ The package is published as `@jaguilar87/gaia-ops` on npm and installed into a p
 | **Hook** | Python scripts that intercept tool calls before and after execution |
 | **Tool** | Python modules in `tools/` providing context assembly, memory, and validation |
 | **Config** | JSON files in `config/` defining contracts, rules, surface routing, and security |
-| **Orchestrator** | The root `CLAUDE.md` that routes user requests to the correct agent |
+| **Orchestrator** | Identity injected by UserPromptSubmit hook; routes requests to the correct agent via on-demand skills |
 
 ## Runtime Flow
 
@@ -23,17 +23,21 @@ The package is published as `@jaguilar87/gaia-ops` on npm and installed into a p
 User request
     |
     v
-Orchestrator (CLAUDE.md)
+user_prompt_submit.py  (UserPromptSubmit hook)
+    |  Inject orchestrator identity via ops_identity.py
+    |  Skills loaded on-demand: project-dispatch, agent-response
+    v
+Orchestrator dispatches to agent
     |  Routes by surface classification
     v
 pre_tool_use.py  (PreToolUse hook)
-    |  1. Inject project-context into agent prompt
-    |  2. Inject session events
+    |  1. Inject project-context into agent prompt (Task/Agent)
+    |  2. Inject session events (Task/Agent)
     |  3. Validate Bash commands (security gate)
-    |  4. Validate Task/Agent invocations
+    |  4. Validate SendMessage (agent resumption)
     v
 Agent executes
-    |  Uses tools, follows skills, emits AGENT_STATUS
+    |  Uses tools, follows skills, emits json:contract
     v
 subagent_stop.py  (SubagentStop hook)
     |  1. Read transcript, extract task description
@@ -43,10 +47,10 @@ subagent_stop.py  (SubagentStop hook)
     |  5. Store episodic memory
     |  6. Process CONTEXT_UPDATE blocks
     v
-Orchestrator processes AGENT_STATUS
+Orchestrator processes json:contract (via agent-response skill)
     |  COMPLETE -> summarize to user
-    |  AWAITING_APPROVAL -> get approval -> resume
-    |  NEEDS_INPUT -> ask user -> resume
+    |  AWAITING_APPROVAL -> get approval -> resume via SendMessage
+    |  NEEDS_INPUT -> ask user -> resume via SendMessage
     |  BLOCKED -> report blocker
 ```
 
@@ -74,10 +78,17 @@ Order is short-circuit -- first match wins:
 
 ```
 1. Response contract guard  --> if pending repair exists, block new tasks until resolved
-2. Context injection        --> context_provider.py assembles payload, injected into prompt
-3. Session events injection --> recent git commits, pushes, file mods added to prompt
-4. Resume validation        --> validate agent ID format, detect approval nonces
-5. TaskValidator            --> validate agent name, check available agents
+2. Context injection        --> context_provider.py assembles payload, injected via additionalContext
+3. Session events injection --> recent git commits, pushes, file mods added via additionalContext
+4. TaskValidator            --> validate agent name, check available agents
+```
+
+### SendMessage Validation (PreToolUse matcher)
+
+```
+1. Agent ID format check    --> must match /^a[0-9a-f]{5,}$/
+2. Message presence check   --> non-empty message required
+3. Nonce approval check     --> detect APPROVE:{nonce}, activate pending grants
 ```
 
 ## Agent Completion Pipeline: subagent_stop.py
@@ -252,7 +263,7 @@ The adapter layer connects Claude Code's hook protocol to gaia-ops business logi
 | **File (npm channel)** | `templates/settings.template.json` -- paths use `.claude/hooks/` prefix |
 | **File (plugin channel)** | `hooks/hooks.json` -- paths use `${CLAUDE_PLUGIN_ROOT}/hooks/` prefix |
 | **What it does** | Maps Claude Code hook events to handler scripts. Defines which events fire which entry points, the tool matchers (Bash, Task, Agent, `*`), and permissions (allow/deny lists). |
-| **Events configured** | PreToolUse, PostToolUse, SubagentStop, SessionStart, Stop, TaskCompleted, SubagentStart (UserPromptSubmit is a static echo in settings.json only) |
+| **Events configured** | PreToolUse (Bash, Task, Agent, SendMessage), PostToolUse, SubagentStop, SessionStart, Stop, TaskCompleted, SubagentStart, UserPromptSubmit (identity injection) |
 
 ### HookAdapter ABC Contract
 
@@ -299,7 +310,9 @@ To support a CLI other than Claude Code (e.g., a hypothetical Cursor or Windsurf
 
 | File | Purpose |
 |------|---------|
-| `CLAUDE.md` | Orchestrator identity, routing table, tool restrictions |
+| `hooks/modules/identity/ops_identity.py` | Orchestrator identity (injected by UserPromptSubmit) |
+| `skills/project-dispatch/SKILL.md` | Agent routing table and dispatch rules (on-demand) |
+| `skills/agent-response/SKILL.md` | Contract status handling protocol (on-demand) |
 | `hooks/pre_tool_use.py` | PreToolUse hook entry point |
 | `hooks/subagent_stop.py` | SubagentStop hook entry point |
 | `hooks/modules/tools/bash_validator.py` | Bash command security gate |

package/CHANGELOG.md

@@ -1,14 +1,20 @@
 # Changelog: CLAUDE.md
 
-All notable changes to the CLAUDE.md orchestrator instructions are documented in this file.
+All notable changes to the gaia-ops orchestration system are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [4.4.0-rc.5] - 2026-03-19
 
-### Added
-- Plugin distribution: `.claude-plugin/plugin.json` manifest for Claude Code native plugin system
+### Identity Redesign
+
+Orchestrator identity is now minimal (~900 chars) and delegates to on-demand skills. CLAUDE.template.md deleted -- the UserPromptSubmit hook is the single source of truth for orchestrator identity.
+
+#### Added
+- **`skills/project-dispatch/SKILL.md`** (Reference type) -- agent routing table and dispatch rules, loaded on-demand via Skill tool
+- **`skills/agent-response/SKILL.md`** (Protocol type) -- contract status handling, loaded on-demand via Skill tool
+- Plugin distribution: `.claude-plugin/plugin.json` manifest with engines + categories for Claude Code native plugin system
 - Self-hosted marketplace: `.claude-plugin/marketplace.json` with 2 sub-plugin tiers (gaia-security, gaia-ops)
 - Adapter layer: `hooks/adapters/` with normalized types, abstract base, and Claude Code adapter
 - `hooks/hooks.json` for plugin-channel hook configuration
@@ -16,9 +22,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Integration tests for adapter -> business logic -> response flow
 - Plugin manifest validation tests
 
-### Changed
+#### Changed
+- **`hooks/modules/identity/ops_identity.py`** -- reduced to ~900 chars; tells orchestrator to load skills on-demand instead of embedding all instructions inline
+- **SendMessage validation** -- moved from invalid hook event to PreToolUse matcher (agent ID format + nonce approval check)
+- **`hooks/modules/scanning/scan_trigger.py`** -- imports `tools.scan` directly (no `bin/` dependency), works in both npm and plugin mode
+- **Agent namespace support** -- accepts both `cloud-troubleshooter` and `gaia-ops:cloud-troubleshooter` forms
+- **`hooks/user_prompt_submit.py`** -- calls `ensure_plugin_registry()` as fallback if SessionStart didn't fire
+- **`hooks/modules/context/context_injector.py`** -- path fixes for plugin mode
+- **`hooks/modules/session/session_event_injector.py`** -- path fixes for plugin mode
 - Hook entry points (pre_tool_use.py, post_tool_use.py, subagent_stop.py) now use adapter layer for stdin/stdout
 - hook_response.py delegates to ClaudeCodeAdapter internally
+- npm dist-tag now derived from version suffix (rc -> next, beta -> beta, etc.)
+
+#### Removed
+- **`templates/CLAUDE.template.md`** -- identity now injected dynamically; no generated CLAUDE.md
+- **`copy_claude_md()`** in `tools/scan/setup.py` -- deprecated to no-op (callers still reference it for backward compat)
 
 ## [4.0.0] - 2026-03-03
 

package/INSTALL.md

@@ -82,7 +82,6 @@ Creates symlinks to gaia-ops:
   .claude/templates → node_modules/.../templates
          ↓
 Generates config files:
-  - CLAUDE.md (orchestrator)
   - project-context.json
   - settings.json
          ↓
@@ -118,8 +117,8 @@ Example: Installation in project with GitOps and Terraform
 5. Creates structure:
    ✅ .claude/ created
    ✅ 8 symlinks created
-   ✅ CLAUDE.md generated (196 lines)
    ✅ project-context.json created
+   ✅ settings.json created
    ↓
 6. Result:
    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -195,7 +194,6 @@ your-project/
 │   ├── project-context/        ← Your project context (SSOT)
 │   ├── logs/                   ← Audit logs
 │   └── settings.json           ← Security configuration
-├── CLAUDE.md                   ← Main orchestrator
 └── node_modules/
     └── @jaguilar87/gaia-ops/   ← npm package
 ```
@@ -211,10 +209,10 @@ Once installed, you have access to **complete documentation** in each directory:
 ```
 .claude/
 ├── agents/               6 agents (terraform-architect, gitops-operator, etc.)
-├── skills/README.md      16 skill modules
+├── skills/README.md      20 skill modules
 ├── commands/README.md    6 slash commands (5 speckit + scan-project)
 ├── config/README.md      Contracts, git standards, universal rules
-├── hooks/README.md       9 hook scripts (3 primary + 6 event handlers)
+├── hooks/README.md       8 hook scripts (4 primary + 4 event handlers)
 ├── tools/                Context, memory, validation, review
 ├── speckit/README.md     Spec-Kit framework
 ├── templates/README.md   Installation templates
@@ -239,11 +237,11 @@ ls -la .claude/
 ### 2. Review Generated Configuration
 
 ```bash
-# View generated CLAUDE.md
-cat CLAUDE.md
-
 # View project-context.json
 cat .claude/project-context/project-context.json
+
+# View settings.json
+cat .claude/settings.json
 ```
 
 ### 3. Start Claude Code
@@ -273,27 +271,22 @@ When you update `@jaguilar87/gaia-ops`, these files are **regenerated from templ
 
 | File | Behavior | Recommended Action |
 |------|----------|-------------------|
-| `CLAUDE.md` | ⚠️ **Overwritten** | Backup if you customize |
-| `.claude/settings.json` | ✅ **Merged** (hooks/permissions deep-merged, custom rules preserved) | Safe |
+| `.claude/settings.json` | ⚠️ **Replaced** from template (source of truth) | Safe |
 | `.claude/project-context/project-context.json` | ✅ **Preserved** | Safe |
 | `.claude/logs/` | ✅ **Preserved** | Safe |
 | Other `.claude/` files | ✅ **Auto-updated via symlinks** | Safe |
 
+Orchestrator identity is injected dynamically by the UserPromptSubmit hook -- no `CLAUDE.md` is generated.
+
 ### Update Process
 
 ```bash
-# 1. Backup (optional, if you customized CLAUDE.md)
-cp CLAUDE.md CLAUDE.md.backup
-
-# 2. Update package
+# 1. Update package
 npm install @jaguilar87/gaia-ops@latest
 
-# 3. Postinstall hook automatically:
-#    - Overwrites CLAUDE.md (static orchestrator config)
-#    - Merges settings.json (hooks/permissions deep-merged, custom rules preserved)
-
-# 4. If you made a CLAUDE.md backup, compare and merge changes
-diff CLAUDE.md CLAUDE.md.backup
+# 2. Postinstall hook automatically:
+#    - Replaces settings.json from template
+#    - Fixes broken symlinks
 ```
 
 ---
@@ -398,10 +391,7 @@ npx gaia-uninstall --force --remove-all
 # 1. Remove .claude/ directory
 rm -rf .claude/
 
-# 2. Remove generated files
-rm CLAUDE.md
-
-# 3. Uninstall npm package
+# 2. Uninstall npm package
 npm uninstall @jaguilar87/gaia-ops
 ```
 
@@ -436,15 +426,12 @@ A: Yes. Install in each project and each will have its own `project-context.json
 **Q: Do symlinks work on Windows?**  
 A: Yes, but you need to enable developer mode or run as administrator.
 
-**Q: Can I customize CLAUDE.md without it being overwritten?**  
-A: Not directly. Better: contribute changes to the template in the repository.
-
-**Q: How do I update only documentation without changing code?**  
+**Q: How do I update only documentation without changing code?**
 A: `npm update @jaguilar87/gaia-ops` - symlinks point to the new version automatically.
 
 ---
 
-**Version:** 4.2.0
-**Last updated:** 2026-03-11
+**Version:** 4.4.0-rc.5
+**Last updated:** 2026-03-19
 **Maintained by:** Jorge Aguilar + Gaia (meta-agent)
 

package/README.md

@@ -1,25 +1,27 @@
-# @jaguilar87/gaia-ops
+# GAIA-Ops
+
+> **G**eneral **A**gentic **I**ntegration **A**rchitecture
 
 [![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)
 
-Multi-agent orchestration system for Claude Code - DevOps automation toolkit.
+Multi-agent DevOps system that classifies every operation by risk, routes work to specialist agents, and blocks irreversible commands automatically.
 
 ## Overview
 
-**Gaia-Ops** provides a complete agent orchestration system for Claude Code, enabling intelligent automation of DevOps workflows through specialized AI agents.
+**GAIA-Ops** is a multi-agent orchestration system for DevOps automation. It provides security-first command classification, specialized AI agents, and plugin-based distribution. Currently integrates with Claude Code.
 
 ### Features
 
 - **Multi-cloud support** - GCP, AWS
 - **6 agents** - terraform-architect, gitops-operator, cloud-troubleshooter, devops-developer, speckit-planner, gaia (meta-agent)
 - **Contracts as SSOT** - Cloud-agnostic base contracts with per-cloud extensions (GCP, AWS)
-- **Episodic Memory** - Persistent memory system for operational patterns
-- **Approval gates** for T3 operations
+- **Dynamic identity** - Orchestrator identity injected by UserPromptSubmit hook; skills loaded on-demand
+- **Approval gates** for T3 operations via nonce-based workflow
 - **Git commit validation** with Conventional Commits
-- **16 skills** - Injected procedural knowledge modules for agents
-- **1800+ tests** at 100% passing
+- **20 skills** - Injected procedural knowledge modules for agents
+- **Plugin + npm** - Distributable as Claude Code native plugin or npm package
 
 ## Installation
 
@@ -56,7 +58,9 @@ This will:
 1. Auto-detect your project structure (GitOps, Terraform, AppServices)
 2. Install Claude Code if not present
 3. Create `.claude/` directory with symlinks to this package
-4. Generate `CLAUDE.md` and `project-context.json`
+4. Generate `project-context.json` and `settings.json`
+
+No `CLAUDE.md` is generated -- orchestrator identity is injected dynamically by the UserPromptSubmit hook.
 
 ### Manual Installation
 
@@ -86,7 +90,7 @@ Once installed, the agent system is ready:
 claude
 ```
 
-Claude Code will automatically load `CLAUDE.md` and have access to all agents via `.claude/`.
+The orchestrator identity is injected dynamically by the UserPromptSubmit hook. Skills are loaded on-demand.
 
 Skills and injection diagnosis:
 
@@ -101,15 +105,15 @@ npx gaia-skills-diagnose --run-tests
 ```
 node_modules/@jaguilar87/gaia-ops/
 ├── agents/              # Agent definitions (6 agents)
-├── skills/              # Skill modules (16 skills)
+├── skills/              # Skill modules (20 skills)
 ├── tools/               # Orchestration tools
 ├── hooks/               # Claude Code hooks (modular architecture)
-├── commands/            # Slash commands (6 commands: 5 speckit + scan-project)
+├── commands/            # Slash commands (5 speckit + scan-project)
 ├── config/              # Configuration (contracts, git standards, rules)
-├── templates/           # Installation templates
-├── speckit/             # Spec-Kit framework (scripts + templates)
+├── templates/           # Installation templates (settings, governance)
+├── speckit/             # Spec-Kit framework (templates)
 ├── bin/                 # CLI utilities (11 scripts)
-└── tests/               # Test suite (1800+ tests)
+└── tests/               # Test suite
 ```
 
 ## API
@@ -129,7 +133,7 @@ This package follows [Semantic Versioning](https://semver.org/):
 - **MINOR:** New features
 - **PATCH:** Bug fixes
 
-Current version: **4.2.0**
+Current version: **4.4.0-rc.5**
 
 See [CHANGELOG.md](./CHANGELOG.md) for version history.
 

package/SECURITY.md

@@ -42,6 +42,6 @@ The following are considered security vulnerabilities in gaia-ops:
 
 ## Out of Scope
 
-- Vulnerabilities in Claude Code itself (report to Anthropic)
-- Issues in upstream dependencies (report to the respective maintainer)
-- Denial of service through large inputs (this is a local development tool)
+- Vulnerabilities in Claude Code itself (report to Anthropic).
+- Issues in upstream dependencies (report to the respective maintainer).
+- Denial of service through large inputs (this is a local development tool).

package/bin/README.md

@@ -129,7 +129,6 @@ npm uninstall @jaguilar87/gaia-ops
 
 **What it preserves:**
 - `project-context.json`
-- `CLAUDE.md`
 - `.claude/` symlinks
 
 ## Environment Variables
@@ -147,4 +146,4 @@ npx gaia-scan --non-interactive
 
 ---
 
-**Version:** 4.2.0 | **Updated:** 2026-03-11 | **Scripts:** 11
+**Version:** 4.4.0-rc.5 | **Updated:** 2026-03-19 | **Scripts:** 11

package/bin/gaia-cleanup.js

@@ -61,7 +61,7 @@ function findProjectRoot() {
 const CWD = findProjectRoot();
 
 /**
- * Remove CLAUDE.md if it exists
+ * Remove legacy CLAUDE.md if it exists (identity now injected by hook).
  */
 async function removeClaudeMd() {
   const spinner = ora('Removing CLAUDE.md...').start();

package/bin/gaia-doctor.js

@@ -73,33 +73,13 @@ async function checkSymlinks() {
 }
 
 async function checkClaudeMd() {
+  // CLAUDE.md is no longer generated -- identity is injected by UserPromptSubmit hook.
+  // If a project still has a CLAUDE.md from a previous version, that's fine but not required.
   const path = join(CWD, 'CLAUDE.md');
-
-  if (!existsSync(path)) {
-    return { name: 'CLAUDE.md', ok: false, detail: 'Missing', fix: 'Run gaia-scan' };
+  if (existsSync(path)) {
+    return { name: 'CLAUDE.md', ok: true, detail: 'Present (legacy -- identity now injected by hook)' };
   }
-
-  const content = await fs.readFile(path, 'utf-8');
-  const issues = [];
-
-  if (content.includes('{{')) {
-    issues.push('Contains raw {{placeholders}} - template was not processed');
-  }
-
-  if (content.length < 100) {
-    issues.push('File is suspiciously short');
-  }
-
-  if (!content.includes('Binary Delegation') && !content.includes('orchestrator')) {
-    issues.push('Missing core orchestrator instructions');
-  }
-
-  if (issues.length > 0) {
-    return { name: 'CLAUDE.md', ok: false, detail: issues.join('; '), fix: 'Run gaia-scan to regenerate' };
-  }
-
-  const lines = content.split('\n').length;
-  return { name: 'CLAUDE.md', ok: true, detail: `Valid (${lines} lines)` };
+  return { name: 'CLAUDE.md', ok: true, detail: 'Not present (identity injected by UserPromptSubmit hook)' };
 }
 
 async function checkSettingsJson() {
@@ -354,19 +334,7 @@ async function autoFix() {
     }
   }
 
-  // Fix CLAUDE.md with raw placeholders
-  const claudeMdPath = join(CWD, 'CLAUDE.md');
-  if (existsSync(claudeMdPath)) {
-    const content = await fs.readFile(claudeMdPath, 'utf-8');
-    if (content.includes('{{')) {
-      const templatePath = join(CWD, '.claude', 'templates', 'CLAUDE.template.md');
-      if (existsSync(templatePath)) {
-        await fs.copyFile(templatePath, claudeMdPath);
-        console.log(chalk.green('    Fixed: CLAUDE.md regenerated from template'));
-        fixed++;
-      }
-    }
-  }
+  // CLAUDE.md no longer generated -- identity injected by UserPromptSubmit hook
 
   // Create missing project dirs
   const contextPath = join(CWD, '.claude', 'project-context', 'project-context.json');

package/bin/gaia-skills-diagnose.js

@@ -690,19 +690,8 @@ function detectLegacyGapPatterns(ctx, findings, checks) {
   const conftestPath = path.join(testsDir, "conftest.py");
   if (exists(conftestPath)) {
     const content = readText(conftestPath);
-    const expectsRootClaudeMd = content.includes('(package_root / "CLAUDE.md").read_text()');
-    const hasRootClaudeMd = exists(ctx.rootClaudeMd);
-
-    if (expectsRootClaudeMd && !hasRootClaudeMd) {
-      addFinding(findings, {
-        severity: "high",
-        code: "TEST_EXPECTS_MISSING_CLAUDE_MD",
-        title: "Tests require package-root CLAUDE.md that does not exist",
-        detail: "tests/conftest.py fixture reads package_root/CLAUDE.md, causing routing-table tests to error.",
-        evidence: `${path.relative(PACKAGE_ROOT, conftestPath)} + missing ${path.relative(PACKAGE_ROOT, ctx.rootClaudeMd)}`,
-        remediation: "Either include CLAUDE.md in package root or make fixture robust to installed-project layout.",
-      });
-    }
+    // CLAUDE.md is no longer generated -- identity injected by UserPromptSubmit hook.
+    // conftest.py fixture now falls back to ops_identity.py + dispatch/response skills.
   }
 
   checks.push({
@@ -767,16 +756,7 @@ function runTestProbe(ctx, findings, checks) {
       });
     }
 
-    if (combined.includes("No such file or directory") && combined.includes("CLAUDE.md")) {
-      addFinding(findings, {
-        severity: "high",
-        code: "PYTEST_FAILS_ON_MISSING_CLAUDE_MD",
-        title: "Routing-table tests fail because package-root CLAUDE.md is missing",
-        detail: "tests/conftest.py fixture assumes package_root/CLAUDE.md exists.",
-        evidence: "FileNotFoundError: .../gaia-ops/CLAUDE.md",
-        remediation: "Provide CLAUDE.md or adjust fixture to locate generated CLAUDE.md in project context.",
-      });
-    }
+    // CLAUDE.md is no longer required -- conftest.py falls back to ops_identity.py
   }
 
   checks.push({

package/bin/gaia-update.js

@@ -10,11 +10,10 @@
  * - First-time install (.claude/ doesn't exist): skip silently (gaia-scan handles it)
  * - Update (.claude/ exists):
  *   1. Show version transition (previous → current)
- *   2. CLAUDE.md: overwrite safely (template is static)
- *   3. settings.json: REPLACE from template (template is source of truth)
- *   4. Symlinks: recreate if missing, fix broken ones
- *   5. Verify: hooks, python, project-context, config files
- *   6. Report: summary with any issues found
+ *   2. settings.json: REPLACE from template (template is source of truth)
+ *   3. Symlinks: recreate if missing, fix broken ones
+ *   4. Verify: hooks, python, project-context, config files
+ *   5. Report: summary with any issues found
  *
  * Usage:
  *   npm update @jaguilar87/gaia-ops   # Automatic via postinstall
@@ -72,27 +71,6 @@ async function readPackageVersion(path) {
 // Update Steps
 // ============================================================================
 
-async function updateClaudeMd() {
-  const spinner = ora('Updating CLAUDE.md...').start();
-  try {
-    const templatePath = join(__dirname, '../templates/CLAUDE.template.md');
-    const claudeDir = join(CWD, '.claude');
-
-    if (!existsSync(templatePath) || !existsSync(claudeDir)) {
-      spinner.info('Skipped (template or .claude/ not found)');
-      return false;
-    }
-
-    const claudeMdPath = join(CWD, 'CLAUDE.md');
-    await fs.copyFile(templatePath, claudeMdPath);
-    spinner.succeed('CLAUDE.md updated');
-    return true;
-  } catch (error) {
-    spinner.fail(`CLAUDE.md: ${error.message}`);
-    return false;
-  }
-}
-
 async function updateSettingsJson() {
   const spinner = ora('Updating settings.json...').start();
   try {
@@ -295,16 +273,15 @@ async function main() {
 
   console.log(chalk.cyan(`\n  gaia-ops update ${versionLine}\n`));
 
-  // Step 1-3: Update files
-  const claudeUpdated = await updateClaudeMd();
+  // Step 1-2: Update files
   const settingsUpdated = await updateSettingsJson();
   const { updated: symlinksUpdated, fixed: symlinksFix } = await updateSymlinks();
 
-  // Step 4: Verify
+  // Step 3: Verify
   const { issues, passed, total } = await runVerification();
 
   // Summary
-  const changes = [claudeUpdated, settingsUpdated, symlinksUpdated].filter(Boolean).length;
+  const changes = [settingsUpdated, symlinksUpdated].filter(Boolean).length;
 
   console.log('');
   if (changes > 0 || issues.length > 0) {