aios-core 4.0.2 → 4.1.0

package/.aios-core/development/tasks/publish-npm.md

@@ -0,0 +1,257 @@
+---
+id: publish-npm
+name: npm Publishing Pipeline (Preview to Latest)
+agent: devops
+category: release
+complexity: high
+tools:
+  - github-cli
+  - git
+checklists:
+  - release-checklist.md
+---
+
+# npm Publishing Pipeline: Preview to Latest
+
+## Purpose
+
+Safe, validated npm publishing using a two-phase release strategy:
+1. **Preview**: Publish to `preview` dist-tag for testing
+2. **Promote**: After validation, promote `preview` to `latest`
+
+This prevents broken releases reaching users (like v4.0.0-v4.0.4 incident).
+
+## Commands
+
+### `*publish-preview` - Publish as Preview
+
+Publishes a new version to npm under the `preview` dist-tag.
+
+#### Workflow
+
+```
+1. PRE-FLIGHT CHECKS
+   - Verify: branch = main, working tree clean
+   - Verify: git is up-to-date with remote (git fetch + compare)
+
+2. QUALITY GATES
+   - npm run lint
+   - npm run typecheck
+   - npm test
+
+3. PACKAGE VALIDATION
+   - npm run validate:package
+   (runs scripts/validate-package-completeness.js)
+   - Confirms: hooks, rules, bin, core config present
+   - Confirms: pro/ NOT in tarball
+
+4. VERSION BUMP
+   - Ask user: patch | minor | major
+   - npm version {type} --no-git-tag-version
+   - git add package.json package-lock.json
+   - git commit -m "chore(release): bump version to {new_version}"
+
+5. PUBLISH
+   - npm publish --tag preview
+   - Verify: npm view aios-core@preview version === {new_version}
+
+6. SMOKE TEST
+   - Create temp directory
+   - npm init -y
+   - npm install aios-core@preview
+   - Verify critical files exist in node_modules/aios-core/:
+     - .claude/hooks/synapse-engine.js
+     - .aios-core/core-config.yaml
+     - bin/aios.js
+   - Clean up temp directory
+
+7. PUSH VERSION COMMIT
+   - git push origin main
+
+8. REPORT
+   - "v{X.Y.Z} published as preview"
+   - "Test with: npm install aios-core@preview"
+   - "When ready: *promote-latest"
+```
+
+#### Pre-conditions
+
+- [ ] On `main` branch
+- [ ] Working tree clean (no uncommitted changes)
+- [ ] All quality gates pass (lint, typecheck, test)
+- [ ] Package validation passes (validate-package-completeness.js)
+- [ ] npm auth configured (`npm whoami` succeeds)
+
+#### Post-conditions
+
+- [ ] New version published to npm with `preview` tag
+- [ ] `npm view aios-core@preview` returns new version
+- [ ] Smoke test passes (critical files present in installed package)
+- [ ] Version bump committed and pushed to main
+
+---
+
+### `*promote-latest` - Promote Preview to Latest
+
+Promotes a tested `preview` version to the `latest` dist-tag.
+
+#### Workflow
+
+```
+1. VERIFY PREVIEW EXISTS
+   - npm view aios-core@preview version
+   - If no preview: HALT with "No preview version found"
+
+2. CONFIRM WITH USER
+   - Display: "Promote v{X.Y.Z} from preview to latest?"
+   - Show current latest: npm view aios-core@latest version
+   - Require explicit confirmation
+
+3. PROMOTE
+   - npm dist-tag add aios-core@{version} latest
+
+4. VERIFY
+   - npm view aios-core@latest version === {version}
+   - If mismatch: HALT with error
+
+5. TAG & RELEASE
+   - git tag v{version}
+   - git push origin v{version}
+   - gh release create v{version} --generate-notes --latest
+
+6. REPORT
+   - "v{X.Y.Z} promoted to latest"
+   - Release URL
+   - "Install with: npm install aios-core"
+```
+
+#### Pre-conditions
+
+- [ ] Preview version exists (`npm view aios-core@preview`)
+- [ ] User has tested the preview version
+- [ ] npm auth configured
+- [ ] GitHub CLI authenticated (`gh auth status`)
+
+#### Post-conditions
+
+- [ ] `npm view aios-core@latest` returns promoted version
+- [ ] Git tag `v{version}` created and pushed
+- [ ] GitHub Release created with auto-generated notes
+
+---
+
+### `*test-install` - Test Installation in Clean Environment
+
+Tests package installation from a specific dist-tag in a clean temporary directory.
+
+#### Workflow
+
+```
+1. SETUP
+   - Create temporary directory
+   - npm init -y
+
+2. INSTALL
+   - npm install aios-core@{tag} (default: latest)
+   - Record: install time, exit code, warnings
+
+3. VERIFY FILES
+   - Check node_modules/aios-core/ contains:
+     - .aios-core/core-config.yaml
+     - .aios-core/constitution.md
+     - .aios-core/development/agents/ (non-empty)
+     - .aios-core/development/tasks/ (non-empty)
+     - .claude/hooks/synapse-engine.js
+     - .claude/hooks/precompact-session-digest.js
+     - .claude/rules/ (non-empty)
+     - bin/aios.js
+     - bin/aios-minimal.js
+   - Check node_modules/aios-core/ does NOT contain:
+     - pro/
+     - .env
+     - .git/
+     - tests/
+
+4. TEST INSTALLER (optional, if --full flag)
+   - npx aios-core install --preset minimal
+   - Verify: .aios-core/ created
+   - Verify: .claude/hooks/ created
+   - Verify: .claude/rules/ created
+
+5. CLEANUP
+   - Remove temporary directory
+
+6. REPORT
+   - Package version installed
+   - All critical files: present/missing
+   - Excluded content: clean/leaked
+   - Overall: PASS/FAIL
+```
+
+#### Parameters
+
+- `tag`: dist-tag to test (default: `latest`)
+- `--full`: Also test `npx aios-core install`
+
+---
+
+## Rollback Procedure
+
+If a broken version reaches `latest`:
+
+```bash
+# 1. Identify previous good version
+npm view aios-core versions --json
+
+# 2. Point latest back to previous version
+npm dist-tag add aios-core@{previous-good-version} latest
+
+# 3. Deprecate broken version with message
+npm deprecate aios-core@{broken-version} "Known issues, use v{previous-good-version}"
+
+# 4. Verify
+npm view aios-core@latest version
+```
+
+**Important:** `npm deprecate` shows a warning on install but does NOT prevent installation.
+To fully block a version, use `npm unpublish aios-core@{version}` (within 72h of publish only).
+
+---
+
+## Configuration Reference
+
+See `core-config.yaml` section `npm_registry` for:
+- Required files list
+- Excluded paths list
+- Smoke test configuration
+- Auth strategy
+
+---
+
+## Error Handling
+
+| Error | Cause | Resolution |
+|-------|-------|------------|
+| `npm ERR! 403` | Auth issue | Run `npm login`, check token permissions |
+| `npm ERR! 402` | Paid feature | Ensure package is public (`--access public`) |
+| Smoke test fails | Files missing from tarball | Fix `files` array in package.json, re-validate |
+| promote fails | Version not on preview | Run `*publish-preview` first |
+| Tag already exists | Re-publishing same version | Bump version or use `--force` (with caution) |
+
+---
+
+## Metadata
+
+```yaml
+story: INS-2 (Release Pipeline: Preview to Latest)
+version: 1.0.0
+dependencies:
+  - release-management.md
+  - github-devops-pre-push-quality-gate.md
+tags:
+  - npm
+  - release
+  - publishing
+  - preview
+created: 2026-02-13
+```

package/.aios-core/development/tasks/release-management.md

@@ -77,14 +77,14 @@ To automate the complete software release process, including:
 
 - **git_tag**: `string`
   - **Description**: Git tag created
-  - **Example**: `"v2.1.3"`
+  - **Example**: `"v4.0.4.3"`
 
 - **changelog**: `string`
   - **Description**: Generated CHANGELOG.md content for this release
 
 - **release_url**: `string`
   - **Description**: URL to GitHub/GitLab Release
-  - **Example**: `"https://github.com/user/repo/releases/tag/v2.1.3"`
+  - **Example**: `"https://github.com/user/repo/releases/tag/v4.0.4.3"`
 
 - **published_packages**: `array<object>`
   - **Description**: Published packages with URLs
@@ -120,8 +120,8 @@ To automate the complete software release process, including:
      ```
 
 3. **Analyze Commits Since Last Release**
-   - Get last version tag (e.g., `v2.1.2`)
-   - Get commits since last tag: `git log v2.1.2..HEAD`
+   - Get last version tag (e.g., `v4.0.4.2`)
+   - Get commits since last tag: `git log v4.0.4.2..HEAD`
    - Parse commit messages (Conventional Commits)
 
 4. **Determine Version Bump**

package/.aios-core/development/tasks/setup-github.md

@@ -866,7 +866,7 @@ Write-Host "✅ Setup report saved to .aios/devops-setup-report.yaml"
 - [GitHub Actions Documentation](https://docs.github.com/en/actions)
 - [GitHub Branch Protection API](https://docs.github.com/en/rest/branches/branch-protection)
 - [CodeRabbit Documentation](https://docs.coderabbit.ai/)
-- [Story 5.10 - GitHub DevOps Setup](docs/stories/v2.1/sprint-5/story-5.10-github-devops-user-projects.md)
+- [Story 5.10 - GitHub DevOps Setup](docs/stories/v4.0.4/sprint-5/story-5.10-github-devops-user-projects.md)
 
 ---
 

package/.aios-core/development/tasks/squad-creator-migrate.md

@@ -37,7 +37,7 @@ Migrates legacy squad formats to AIOS 2.1 standard.
 # Migrate with detailed output
 *migrate-squad ./squads/my-squad --verbose
 
-# Migrate expansion pack
+# Migrate squad
 *migrate-squad ./expansion-packs/my-pack --verbose
 ```
 

package/.aios-core/development/tasks/squad-creator-sync-ide-command.md

@@ -122,7 +122,7 @@ active_ides:
   # - gemini    # .gemini/
 
 # Mapeamento de diretório → prefixo de comando
-pack_aliases:
+squad_aliases:
   legal: Legal
   copy: Copy
   hr: HR
@@ -134,7 +134,7 @@ sync_mappings:
     source: 'squads/*/agents/'
     destinations:
       claude:
-        - path: '.claude/commands/{pack}/agents/'
+        - path: '.claude/commands/{squad_alias}/agents/'
           format: 'md'
       cursor:
         - path: '.cursor/rules/'
@@ -142,9 +142,9 @@ sync_mappings:
           wrapper: 'cursor-rule'
 ```
 
-### Pack Aliases
+### Squad Aliases
 
-O `pack_aliases` mapeia o nome do diretório do squad para o prefixo usado nos comandos:
+O `squad_aliases` mapeia o nome do diretório do squad para o prefixo usado nos comandos:
 
 | Diretório       | Alias   | Comando Claude              |
 | --------------- | ------- | --------------------------- |
@@ -163,7 +163,7 @@ O `pack_aliases` mapeia o nome do diretório do squad para o prefixo usado nos c
 │     ↓                                             │
 │  2. Load .aios-sync.yaml                          │
 │     ↓ (not found → create default)                │
-│  3. Resolve pack alias                            │
+│  3. Resolve squad alias                           │
 │     ↓                                             │
 │  4. Locate source files in squads/                │
 │     ↓ (not found → error)                         │
@@ -243,7 +243,7 @@ A description é extraída de:
 Sincroniza um arquivo de agent:
 
 - Source: `squads/{squad}/agents/{name}.md`
-- Claude: `.claude/commands/{Pack}/agents/{name}.md`
+- Claude: `.claude/commands/{SquadAlias}/agents/{name}.md`
 - Cursor: `.cursor/rules/{name}.mdc`
 
 ### Task (`*command task {name}`)
@@ -251,14 +251,14 @@ Sincroniza um arquivo de agent:
 Sincroniza um arquivo de task:
 
 - Source: `squads/{squad}/tasks/{name}.md`
-- Claude: `.claude/commands/{Pack}/tasks/{name}.md`
+- Claude: `.claude/commands/{SquadAlias}/tasks/{name}.md`
 
 ### Workflow (`*command workflow {name}`)
 
 Sincroniza um arquivo de workflow:
 
 - Source: `squads/{squad}/workflows/{name}.yaml`
-- Claude: `.claude/commands/{Pack}/workflows/{name}.yaml`
+- Claude: `.claude/commands/{SquadAlias}/workflows/{name}.yaml`
 
 ### Squad (`*command squad {name}`)
 
@@ -276,7 +276,7 @@ Sincroniza TODOS os componentes de um squad:
 | Error                  | Causa                           | Solução                     |
 | ---------------------- | ------------------------------- | --------------------------- |
 | `Source not found`     | Arquivo não existe em squads/   | Verifique o nome e tipo     |
-| `Pack alias not found` | Squad não está em pack_aliases  | Adicione ao .aios-sync.yaml |
+| `Squad alias not found` | Squad não está em squad_aliases | Adicione ao .aios-sync.yaml |
 | `File exists`          | Destino já existe               | Use --force ou escolha ação |
 | `IDE not active`       | IDE não está em active_ides     | Ative no .aios-sync.yaml    |
 | `Invalid YAML`         | Arquivo fonte com YAML inválido | Corrija o arquivo fonte     |
@@ -300,7 +300,7 @@ if (!validTypes.includes(type)) {
 // 3. Carregar configuração
 const syncConfig = loadYaml('.aios-sync.yaml');
 const activeIdes = syncConfig.active_ides || ['claude'];
-const packAliases = syncConfig.pack_aliases || {};
+const squadAliases = syncConfig.squad_aliases || syncConfig.pack_aliases || {};
 
 // 4. Localizar source
 let sourceFiles = [];
@@ -317,14 +317,14 @@ if (type === 'squad') {
   sourceFiles = [sourceFile];
 }
 
-// 5. Determinar pack alias
+// 5. Determinar squad alias
 const squadName = extractSquadName(sourceFiles[0]);
-const packAlias = packAliases[squadName] || capitalize(squadName);
+const squadAlias = squadAliases[squadName] || capitalize(squadName);
 
 // 6. Verificar existentes
 for (const file of sourceFiles) {
   for (const ide of activeIdes) {
-    const destPath = getDestPath(ide, packAlias, file);
+    const destPath = getDestPath(ide, squadAlias, file);
     if (fs.existsSync(destPath) && !flags.force) {
       const action = await askUser(`${destPath} exists. Overwrite?`);
       if (action === 'skip') continue;
@@ -337,7 +337,7 @@ if (flags.dryRun) {
   output('DRY RUN - Would sync:');
   for (const file of sourceFiles) {
     for (const ide of activeIdes) {
-      output(`  ${file} → ${getDestPath(ide, packAlias, file)}`);
+      output(`  ${file} → ${getDestPath(ide, squadAlias, file)}`);
     }
   }
   return;

package/.aios-core/development/tasks/update-aios.md

@@ -146,6 +146,6 @@ git checkout -- .aios-core/
 | Version | Date | Changes |
 |---------|------|---------|
 | 4.0.0 | 2026-01-31 | **SIMPLIFIED:** Git-native approach, 15-line bash script replaces 847-line JS |
-| 3.1.0 | 2026-01-30 | Dynamic protection for expansion pack commands |
+| 3.1.0 | 2026-01-30 | Dynamic protection for squad commands |
 | 3.0.0 | 2026-01-29 | YOLO mode with rsync |
 | 1.0.0 | 2026-01-29 | Initial version (verbose, interactive) |

package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-QUICK-REFERENCE.md

@@ -68,7 +68,7 @@ console.log(status.tip('Press Enter to continue'));
 
 ### Welcome Screen
 ```javascript
-console.log(headings.h1('🎉 Welcome to AIOS v2.1 Installer!'));
+console.log(headings.h1('🎉 Welcome to AIOS v4.0.4 Installer!'));
 console.log(colors.info('Let\'s configure your project...\n'));
 ```
 

package/.aios-core/docs/standards/AIOS-COLOR-PALETTE-V2.1.md

@@ -1,4 +1,4 @@
-# AIOS Color Palette v2.1
+# AIOS Color Palette v4.0.4
 
 **Version:** 2.1.0  
 **Created:** 2025-01-20  
@@ -66,7 +66,7 @@ For special effects, animations, and branding moments:
 ```javascript
 const chalk = require('chalk');
 
-// AIOS Color Palette v2.1
+// AIOS Color Palette v4.0.4
 const colors = {
   // Core Brand Colors
   primary: chalk.hex('#8B5CF6'),      // ClickUp-inspired purple
@@ -162,7 +162,7 @@ module.exports = {
 - Example: Welcome screens, major section headers
 
 ```javascript
-console.log(colors.brandPrimary('🎉 AIOS v2.1 Installer'));
+console.log(colors.brandPrimary('🎉 AIOS v4.0.4 Installer'));
 ```
 
 **Level 2: Primary Content**
@@ -193,7 +193,7 @@ console.log(colors.info('💡 Tip: You can change this later'));
 **Installer & Wizards:**
 ```javascript
 // Welcome
-console.log(colors.brandPrimary('\n🎉 Welcome to AIOS v2.1\n'));
+console.log(colors.brandPrimary('\n🎉 Welcome to AIOS v4.0.4\n'));
 console.log(colors.info('Let\'s get your project set up...\n'));
 
 // Questions
@@ -341,7 +341,7 @@ For future design system integration:
 ## 🔗 Related Documents
 
 - [AIOS-LIVRO-DE-OURO-V2.1](./AIOS-LIVRO-DE-OURO-V2.1-SUMMARY.md) - Complete AIOS standards
-- [Story 1.2](../stories/v2.1/sprint-1/story-1.2-interactive-wizard-foundation.md) - Interactive Wizard (first implementation)
+- [Story 1.2](../stories/v4.0.4/sprint-1/story-1.2-interactive-wizard-foundation.md) - Interactive Wizard (first implementation)
 - [ClickUp Brand Guidelines](https://clickup.com/brand) - Primary color reference
 
 ---

package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md

@@ -1,4 +1,4 @@
-# AIOS Framework - Livro de Ouro v2.1 (Complete)
+# AIOS Framework - Livro de Ouro v4.0.4 (Complete)
 
 ## O Sistema Operacional Definitivo para Orquestração de Agentes IA
 
@@ -17,7 +17,7 @@
 
 ## 📣 IMPORTANTE: Sobre Este Documento
 
-Este documento é a **versão consolidada v2.1** que incorpora todas as mudanças dos Sprints 2-5:
+Este documento é a **versão consolidada v4.0.4** que incorpora todas as mudanças dos Sprints 2-5:
 
 - ✅ **Modular Architecture** (4 módulos: core, development, product, infrastructure)
 - ✅ **Squad System** (nova terminologia, substituindo "Expansion Pack")
@@ -34,13 +34,13 @@ Este documento é a **versão consolidada v2.1** que incorpora todas as mudança
 
 ---
 
-## 📜 Open Source vs. Serviço - Business Model v2.1
+## 📜 Open Source vs. Serviço - Business Model v4.0.4
 
-### O Que Mudou de v2.0 para v2.1
+### O Que Mudou de v2.0 para v4.0.4
 
-**IMPORTANTE: v2.1 alterou fundamentalmente o business model!**
+**IMPORTANTE: v4.0.4 alterou fundamentalmente o business model!**
 
-| Componente               | v2.0        | v2.1            | Rationale                  |
+| Componente               | v2.0        | v4.0.4            | Rationale                  |
 | ------------------------ | ----------- | --------------- | -------------------------- |
 | **11 Agents**            | ✅ Open     | ✅ Open         | Core functionality         |
 | **Workers (97+)**        | ❌ Closed   | ✅ **OPEN**     | Commodity, network effects |
@@ -106,7 +106,7 @@ Este documento é a **versão consolidada v2.1** que incorpora todas as mudança
 | LangChain     | ✅ Complete              | ❌ None (commodity)            |
 | CrewAI        | ✅ Complete              | ❌ None (commodity)            |
 | AutoGen       | ✅ Complete              | ❌ None (commodity)            |
-| **AIOS v2.1** | ✅ **Complete**          | ✅ **Clones (DNA Mental™)** ⭐ |
+| **AIOS v4.0.4** | ✅ **Complete**          | ✅ **Clones (DNA Mental™)** ⭐ |
 
 **Analogia:** Linux é open source, mas Red Hat Enterprise Linux adiciona suporte e otimizações. Ambos são Linux, mas o valor agregado varia. AIOS funciona igual.
 
@@ -119,7 +119,7 @@ Este não é um documento para ser lido do início ao fim. É um **sistema de ap
 - 🚀 **Layer 0: DISCOVERY** - Descubra seu caminho (5 min)
 - 🎯 **Layer 1: UNDERSTANDING** - 5 essays que ensinam o modelo mental (75 min)
 - 🎨 **Layer 2: COMPONENT LIBRARY** - Catálogo completo de componentes
-- 📋 **Layer 3: USAGE GUIDE** - Como usar AIOS v2.1 no seu contexto
+- 📋 **Layer 3: USAGE GUIDE** - Como usar AIOS v4.0.4 no seu contexto
 - 📚 **Layer 4: COMPLETE REFERENCE** - Especificação técnica completa
 - 🔄 **META: EVOLUTION** - Como contribuir e evoluir o framework
 
@@ -129,7 +129,7 @@ Este não é um documento para ser lido do início ao fim. É um **sistema de ap
 
 # 🚀 LAYER 0: DISCOVERY ROUTER
 
-## Bem-vindo ao AIOS v2.1 - Vamos Encontrar Seu Caminho
+## Bem-vindo ao AIOS v4.0.4 - Vamos Encontrar Seu Caminho
 
 ### Learning Tracks Disponíveis
 
@@ -192,7 +192,7 @@ AIOS fornece **orquestração estruturada**:
 
 ---
 
-## Essay 3: Business Model v2.1
+## Essay 3: Business Model v4.0.4
 
 ### Por Que Workers São Open-Source Agora?
 
@@ -212,7 +212,7 @@ AIOS fornece **orquestração estruturada**:
 
 ## Essay 4: Agent System
 
-### Os 11 Agents v2.1
+### Os 11 Agents v4.0.4
 
 | Agent     | ID              | Archetype    | Responsabilidade        |
 | --------- | --------------- | ------------ | ----------------------- |
@@ -288,7 +288,7 @@ responsavel_type: Clone    # Year 2
 
 # 🎨 LAYER 2: COMPONENT LIBRARY
 
-## Arquitetura Modular v2.1
+## Arquitetura Modular v4.0.4
 
 ### Os 4 Módulos
 
@@ -342,7 +342,7 @@ Regras:
 
 ---
 
-## Squad System (Novo em v2.1)
+## Squad System (Novo em v4.0.4)
 
 ### Terminologia
 
@@ -600,7 +600,7 @@ npm install @aios/mcp-presets
 
 # 📋 LAYER 3: USAGE GUIDE
 
-## Quick Start v2.1
+## Quick Start v4.0.4
 
 ### Installation (5 minutes)
 
@@ -609,7 +609,7 @@ npm install @aios/mcp-presets
 $ npx @SynkraAI/aios@latest init
 
 # Existing project (Brownfield)
-$ npx @SynkraAI/aios migrate v2.0-to-v2.1
+$ npx @SynkraAI/aios migrate v2.0-to-v4.0.4
 ```
 
 ### First Steps
@@ -700,7 +700,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 # 📚 LAYER 4: COMPLETE REFERENCE
 
-## Source Tree v2.1 (Current)
+## Source Tree v4.0.4 (Current)
 
 ```
 @synkra/aios-core/                        # Root project
@@ -733,7 +733,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 │
 ├── docs/                              # Project docs
 │   ├── stories/                       # Development stories
-│   │   └── v2.1/                      # v2.1 stories
+│   │   └── v4.0.4/                      # v4.0.4 stories
 │   │       ├── sprint-1/
 │   │       ├── sprint-2/
 │   │       ├── sprint-3/
@@ -785,7 +785,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 ### Installation
 
-| Metric          | v2.0       | v2.1      | Improvement     |
+| Metric          | v2.0       | v4.0.4      | Improvement     |
 | --------------- | ---------- | --------- | --------------- |
 | Time to install | 2-4 hours  | 5 minutes | **96% faster**  |
 | Steps required  | 15+ manual | 1 command | **93% simpler** |
@@ -793,7 +793,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 ### Development Speed
 
-| Metric                | v2.0     | v2.1       | Improvement       |
+| Metric                | v2.0     | v4.0.4       | Improvement       |
 | --------------------- | -------- | ---------- | ----------------- |
 | Find reusable Worker  | N/A      | 30 seconds | **∞**             |
 | Quality issues caught | 20%      | 80%        | **4x**            |
@@ -801,7 +801,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 ### Quality
 
-| Metric              | v2.0       | v2.1          |
+| Metric              | v2.0       | v4.0.4          |
 | ------------------- | ---------- | ------------- |
 | Quality Gate Layers | 1 (manual) | 3 (automated) |
 | Auto-caught issues  | 0%         | 80%           |
@@ -834,4 +834,4 @@ $ aios workflow brownfield-integration --target=./existing-project
 
 ---
 
-_Este documento consolida AIOS-LIVRO-DE-OURO.md (v2.0) + deltas v2.1 em um único documento completo._
+_Este documento consolida AIOS-LIVRO-DE-OURO.md (v2.0) + deltas v4.0.4 em um único documento completo._