aios-core 4.2.3 → 4.2.4

package/.aios-core/data/registry-update-log.jsonl

@@ -163,3 +163,11 @@
 {"timestamp":"2026-02-15T20:39:45.235Z","action":"change","path":".aios-core/core/synapse/engine.js","trigger":"watcher"}
 {"timestamp":"2026-02-15T20:39:45.236Z","action":"change","path":".aios-core/development/scripts/unified-activation-pipeline.js","trigger":"watcher"}
 {"timestamp":"2026-02-15T20:39:45.236Z","action":"add","path":".aios-core/development/tasks/publish-npm.md","trigger":"watcher"}
+{"timestamp":"2026-02-16T01:22:08.127Z","action":"add","path":".aios-core/product/templates/statusline/statusline-script.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T01:24:17.173Z","action":"add","path":".aios-core/core/code-intel/code-intel-client.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T01:24:17.174Z","action":"add","path":".aios-core/core/code-intel/code-intel-enricher.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T01:24:17.175Z","action":"add","path":".aios-core/core/code-intel/index.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T01:24:17.175Z","action":"add","path":".aios-core/core/code-intel/providers/code-graph-provider.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T01:24:17.176Z","action":"add","path":".aios-core/core/code-intel/providers/provider-interface.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T01:40:14.161Z","action":"add","path":".aios-core/product/templates/statusline/statusline-script.js","trigger":"watcher"}
+{"timestamp":"2026-02-16T01:41:14.535Z","action":"add","path":".aios-core/product/templates/statusline/statusline-script.js","trigger":"watcher"}

package/.aios-core/development/tasks/db-squad-integration.md

@@ -1,4 +1,4 @@
-# Database Integration Analysis for Expansion Pack
+# Database Integration Analysis for Squad
 
 > Task ID: db-Squad-integration
 > Agent: DB Sage (Database Architect)
@@ -218,7 +218,7 @@ Analyze an squad's data requirements and design database integration strategy. M
 
 ## Workflow
 
-### Step 1: Identify Target Expansion Pack
+### Step 1: Identify Target Squad
 
 **Elicit from user:**
 - Which squad? (mmos, creator-os, innerlens, etc.)
@@ -230,7 +230,7 @@ Analyze an squad's data requirements and design database integration strategy. M
 
 ---
 
-### Step 2: Audit Expansion Pack Data Flows
+### Step 2: Audit Squad Data Flows
 
 **Scan pack structure for data touchpoints:**
 

package/.aios-core/development/tasks/dev-develop-story.md

@@ -854,7 +854,7 @@ git checkout abc123def456 -- <file-path>
 **Output**:
 ```
 💬 Interactive Mode - Balanced Development
-📋 Story 3.15: Expansion Pack Auto Configuration
+📋 Story 3.15: Squad Auto Configuration
 
 📖 Task 1: Design configuration schema
 ❓ Decision Point - Schema Format

package/.aios-core/development/tasks/integrate-squad.md

@@ -1,4 +1,4 @@
-# Integrate with Expansion Pack
+# Integrate with Squad
 
 > Task ID: atlas-integrate-Squad
 > Agent: Atlas (Design System Builder)

package/.aios-core/development/tasks/pr-automation.md

@@ -132,7 +132,7 @@ To help users contribute to the AIOS open-source project (`@synkra/aios-core`) b
 
 6. **Validate Contribution Standards**
    - Check against contribution guidelines:
-     - [ ] **Expansion Packs**: Have README, agent.md, tasks/, proper structure
+     - [ ] **Squads**: Have README, agent.md, tasks/, proper structure
      - [ ] **Agents**: Follow agent template, have commands, dependencies
      - [ ] **Tasks**: Follow task format spec, have checklists, complete docs
      - [ ] **Tools**: Have tool definition YAML, usage examples
@@ -362,7 +362,7 @@ Thank you for your interest in contributing! 🎉
 
 ### Types of Contributions
 
-- **Expansion Packs**: New agent ecosystems
+- **Squads**: New agent ecosystems
 - **Agents**: Improved or new agents
 - **Tasks**: Enhanced or new tasks
 - **Tools**: MCP tool integrations
@@ -632,7 +632,7 @@ updated_at: 2025-11-17
 
 ## Usage Examples
 
-### Example 1: Submit New Expansion Pack
+### Example 1: Submit New Squad
 
 ```bash
 aios activate Otto  # github-devops agent

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

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

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

@@ -118,7 +118,6 @@ O sistema usa `.aios-sync.yaml` na raiz do projeto para configuração:
 active_ides:
   - claude # .claude/commands/
   - cursor # .cursor/rules/
-  # - windsurf  # .windsurf/ (descomentar para ativar)
   # - gemini    # .gemini/
 
 # Mapeamento de diretório → prefixo de comando
@@ -174,7 +173,6 @@ O `squad_aliases` mapeia o nome do diretório do squad para o prefixo usado nos
 │     ├── Claude: Copy MD → .claude/commands/       │
 │     ├── Cursor: Convert MD → MDC                  │
 │     ├── Gemini: Copy MD → .gemini/agents/         │
-│     └── Windsurf: Copy MD → .windsurf/            │
 │     ↓                                             │
 │  7. Validate created files                        │
 │     ↓                                             │

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

@@ -52,7 +52,7 @@ These paths are automatically preserved (local-only files are backed up and rest
 
 | Path | Reason |
 |------|--------|
-| `.aios-core/expansion-packs/` | Custom copywriters, data, ralph |
+| `.aios-core/squads/` | Custom copywriters, data, ralph |
 | `.aios-core/marketing/` | Marketing-specific agents/tasks |
 | `source/` | Business context YAML |
 | `Knowledge/` | Knowledge bases |
@@ -110,7 +110,7 @@ After running the script:
 
 ```bash
 # Check that local-only files are preserved
-ls -la .aios-core/expansion-packs/  # if exists
+ls -la .aios-core/squads/  # if exists
 ls -la source/                       # if exists
 
 # See what changed (unstaged)

package/.aios-core/development/tasks/validate-next-story.md

@@ -190,24 +190,13 @@ token_usage: ~3,000-10,000 tokens
 
 ```yaml
 story: N/A
-version: 2.0.0
+version: 1.0.0
 dependencies:
   - N/A
 tags:
   - automation
   - workflow
-  - self-healing
-  - auto-fix
-updated_at: 2026-02-15
-changelog:
-  - version: 2.0.0
-    date: 2026-02-15
-    author: "@po (Pax)"
-    change: "Added Step 12: Auto-Fix and Re-Validate loop — fixes template compliance, CodeRabbit, Dev Notes, Testing, Risks, and task AC mapping automatically"
-  - version: 1.0.0
-    date: 2025-11-17
-    author: "original"
-    change: "Initial validate-next-story task (report-only, no auto-fix)"
+updated_at: 2025-11-17
 ```
 
 ---
@@ -463,90 +452,4 @@ Provide a structured validation report including:
 - **NO-GO**: Story requires fixes before implementation
 - **Implementation Readiness Score**: 1-10 scale
 - **Confidence Level**: High/Medium/Low for successful implementation
-
-### 12. Auto-Fix and Re-Validate (Self-Healing Loop)
-
-**Purpose:** Automatically fix all fixable issues found during validation instead of just reporting them. This eliminates the manual round-trip of validate → report → fix → re-validate.
-
-**EXECUTION RULES:**
-
-```yaml
-auto_fix:
-  enabled: true
-  max_iterations: 2
-  fixable_categories:
-    - template_compliance    # Missing sections from story template
-    - executor_assignment    # Missing or incorrect executor/quality_gate fields
-    - story_format           # Missing "As a / I want / So that"
-    - coderabbit_section     # Missing or incomplete CodeRabbit Integration
-    - dev_notes              # Missing Dev Notes, Source Tree, Testing
-    - task_ac_mapping        # Tasks without AC references
-    - risks_section          # Missing Risks section
-    - placeholder_sections   # Missing Dev Agent Record, QA Results placeholders
-  non_fixable_categories:
-    - anti_hallucination     # Requires human verification
-    - business_logic         # Requires PO decision
-    - scope_changes          # Requires stakeholder approval
-```
-
-**SEQUENTIAL AUTO-FIX PROCEDURE:**
-
-1. **Classify issues** from Step 11 report:
-   - `FIXABLE`: Template compliance, missing sections, structural issues
-   - `NON-FIXABLE`: Business logic, scope, anti-hallucination findings
-
-2. **IF fixable issues exist AND iteration < max_iterations:**
-
-   a. **Template Compliance Fixes:**
-      - Missing Executor Assignment → Infer from story Agent field and Work Type mapping (Step 1.1 table)
-      - Missing Story format → Generate from Description section (extract role, action, benefit)
-      - Missing Dev Notes → Generate from Technical Notes, File List, and epic context
-      - Missing Testing section → Generate from Acceptance Criteria (derive test scenarios)
-      - Missing Risks section → Generate from Description and Scope (identify common risk patterns)
-      - Missing placeholder sections (Dev Agent Record, QA Results) → Add standard placeholders
-
-   b. **CodeRabbit Integration Fixes (if `coderabbit_integration.enabled: true`):**
-      - Missing section → Generate from story type analysis:
-        - Infer Primary Type from Description keywords
-        - Assign agents from Work Type mapping
-        - Add Quality Gate checkboxes (Pre-Commit always, Pre-PR if applicable)
-        - Add Self-Healing config based on primary agent
-        - Add Focus Areas based on story type
-
-   c. **Task Enhancement Fixes:**
-      - Missing AC references → Map tasks to ACs by content matching
-      - Missing subtasks → Break down vague tasks into specific subtasks
-      - Add edge case scenarios to ACs if obvious gaps found
-
-   d. **Nice-to-Have Improvements:**
-      - Add external dependency links (GitHub, npm) if referenced in Technical Notes
-      - Expand Scope IN/OUT if implicit from Description
-
-3. **Apply all fixes** to the story file using Edit tool
-
-4. **Re-validate** (run Steps 1-11 again on fixed story)
-
-5. **IF still NO-GO after max_iterations:**
-   - Report remaining NON-FIXABLE issues
-   - List what was auto-fixed vs what needs human decision
-   - HALT for user input
-
-6. **IF GO after fixes:**
-   - Update story Status from `Draft` to `Ready`
-   - Log transition in Change Log: `"Status: Draft → Ready (validation GO {score}/10, auto-fixed {N} issues)"`
-   - Report summary of all fixes applied
-
-**AUTO-FIX CHANGE LOG FORMAT:**
-```markdown
-| {date} | @po (Pax) | v{N} — Auto-fix: {comma-separated list of fixes applied} |
-| {date} | @po (Pax) | Status: Draft → Ready (validation GO {score}/10) |
-```
-
-**IMPORTANT CONSTRAINTS:**
-- NEVER change Acceptance Criteria content (only add missing edge cases as new ACs)
-- NEVER change Description or Problem/Solution
-- NEVER change Scope IN/OUT boundaries
-- NEVER change Points or Priority
-- NEVER invent technical details not present in epic/PRD context
-- All generated content MUST be traceable to existing story content or epic context
  

package/.aios-core/development/workflows/README.md

@@ -14,14 +14,12 @@ This directory contains workflow definitions for the Synkra AIOS framework. Work
 - **greenfield-ui.yaml** - Workflow for new UI/frontend projects
 
 ### Configuration Workflows
-- **setup-environment.yaml** - Configure IDE (Windsurf/Cursor/Claude Code) with AIOS development rules
 
 ## Setup Environment Workflow
 
 The `setup-environment` workflow helps developers configure their IDE for optimal AIOS development experience.
 
 ### Features
-- Detects installed IDEs (Windsurf, Cursor, Claude Code)
 - Backs up existing IDE configurations
 - Applies AIOS-specific development rules
 - Verifies GitHub CLI installation and authentication
@@ -41,14 +39,12 @@ npm run setup:environment
 ```
 
 ### What It Does
-1. **IDE Detection** - Scans for `.windsurf/`, `.cursor/`, or `.claude/` directories
 2. **GitHub CLI Check** - Ensures GitHub CLI is installed and authenticated
 3. **Backup Creation** - Saves existing rules before making changes
 4. **Rule Application** - Copies AIOS-specific rules to appropriate locations
 5. **Verification** - Confirms successful setup
 
 ### IDE Rule Locations
-- **Windsurf**: `.windsurf/rules`
 - **Cursor**: `.cursorules`
 - **Claude Code**: `.claude/CLAUDE.md`
 

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

@@ -248,7 +248,6 @@ const answer = await inquirer.prompt([
     message: colors.primary('Select your IDE:'),
     choices: [
       { name: colors.highlight('Cursor') + colors.dim(' (recommended)'), value: 'cursor' },
-      { name: 'Windsurf', value: 'windsurf' },
       { name: 'VS Code', value: 'vscode' }
     ]
   }

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

@@ -20,7 +20,7 @@
 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")
+- ✅ **Squad System** (nova terminologia, substituindo "Squad")
 - ✅ **Multi-Repo Strategy** (3 repositórios públicos + 2 privados)
 - ✅ **Quality Gates 3 Layers** (Pre-commit, PR Automation, Human Review)
 - ✅ **Story Template v2.0** (Cross-Story Decisions, CodeRabbit Integration)
@@ -47,7 +47,7 @@ Este documento é a **versão consolidada v4.0.4** que incorpora todas as mudan
 | **Service Discovery**    | ❌ None     | ✅ **BUILT-IN** | Community needs it         |
 | **Task-First Arch**      | ⚠️ Implicit | ✅ **EXPLICIT** | Architecture clarity       |
 | **Clones (DNA Mental™)** | 🔒 Closed   | 🔒 **CLOSED**   | True moat (IP)             |
-| **Expansion Packs**      | 🔒 Closed   | 🔒 **CLOSED**   | Domain expertise           |
+| **Squads**      | 🔒 Closed   | 🔒 **CLOSED**   | Domain expertise           |
 
 ### Repositório Multi-Repo Structure
 
@@ -348,7 +348,7 @@ Regras:
 
 | Termo Antigo   | Termo Novo         | Descrição              |
 | -------------- | ------------------ | ---------------------- |
-| Expansion Pack | **Squad**          | Modular AI agent teams |
+| Squad | **Squad**          | Modular AI agent teams |
 | Squads/        | **squads/**        | Diretório de Squads    |
 | pack.yaml      | **squad.yaml**     | Manifesto do Squad     |
 | @expansion/\*  | **@aios/squad-\*** | npm scope              |

package/.aios-core/docs/standards/QUALITY-GATES-SPECIFICATION.md

@@ -479,7 +479,7 @@ reviews:
     - path: ".aios-core/docs/standards/**"
       instructions: |
         Verify:
-        - Terminology uses 'Squad' not 'Expansion Pack'
+        - Terminology uses 'Squad' not 'Squad'
         - All internal links work
         - Version numbers are v4.0.4
 

package/.aios-core/docs/standards/STANDARDS-INDEX.md

@@ -75,7 +75,7 @@
 
 | Old Term | New Term | Affected Documents |
 |----------|----------|-------------------|
-| Expansion Pack | **Squad** | All standards |
+| Squad | **Squad** | All standards |
 | Squads/ | **squads/** | Directory references |
 | pack.yaml | **squad.yaml** | Manifest references |
 | @expansion/* | **@aios/squad-*** | npm scope |
@@ -169,7 +169,7 @@ Located in `docs/`:
 ### When to Update Standards
 
 1. **New features** that change framework behavior
-2. **Terminology changes** (like Expansion Pack → Squad)
+2. **Terminology changes** (like Squad → Squad)
 3. **Architecture changes** (like modular architecture)
 4. **Process changes** (like Quality Gates)
 
@@ -188,8 +188,8 @@ Located in `docs/`:
 find .aios-core/docs/standards -name "*.md" -exec markdown-link-check {} \;
 
 # Search for deprecated terminology
-grep -r "expansion pack" .aios-core/docs/standards --include="*.md"
-grep -r "Expansion Pack" .aios-core/docs/standards --include="*.md"
+grep -r "squad" .aios-core/docs/standards --include="*.md"
+grep -r "Squad" .aios-core/docs/standards --include="*.md"
 
 # Verify version numbers
 grep -r "v2.0" .aios-core/docs/standards --include="*.md"

package/.aios-core/docs/standards/STORY-TEMPLATE-V2-SPECIFICATION.md

@@ -474,7 +474,7 @@ Use this checklist when creating or reviewing stories:
 - [ ] Testing strategy clear
 
 #### Terminology
-- [ ] Uses "Squad" not "Expansion Pack"
+- [ ] Uses "Squad" not "Squad"
 - [ ] Uses "@aios/" npm scope
 - [ ] References v4.0.4 architecture
 
@@ -532,7 +532,7 @@ Use this checklist when creating or reviewing stories:
 | Decision | Source | Impact |
 |----------|--------|--------|
 | Multi-repo structure | OSR-2/OSR-11 | Standards must document 3-repo architecture |
-| Squad terminology | OSR-4 | Replace all "Expansion Pack" references |
+| Squad terminology | OSR-4 | Replace all "Squad" references |
 ```
 
 ---

package/.aios-core/framework-config.yaml

@@ -127,14 +127,18 @@ ide_sync_system:
       enabled: true
       path: ".codex/agents"
       format: "full-markdown-yaml"
+    gemini:
+      enabled: true
+      path: ".gemini/rules/AIOS/agents"
+      format: "full-markdown-yaml"
+    github-copilot:
+      enabled: true
+      path: ".github/agents"
+      format: "full-markdown-yaml"
     cursor:
       enabled: true
       path: ".cursor/rules/agents"
       format: "condensed-rules"
-    windsurf:
-      enabled: false
-      path: ".windsurf/rules/agents"
-      format: "xml-tagged-markdown"
     antigravity:
       enabled: true
       path: ".antigravity/rules/agents"

package/.aios-core/infrastructure/scripts/ide-sync/README.md

@@ -11,8 +11,10 @@ IDE Sync keeps agent definitions in `.aios-core/development/agents/` synchronize
 
 - `.claude/commands/AIOS/agents/` (Claude Code)
 - `.codex/agents/` (Codex CLI support files)
+- `.gemini/rules/AIOS/agents/` (Gemini CLI)
+- `.gemini/commands/` (Gemini slash command launcher files)
+- `.github/agents/` (GitHub Copilot support files)
 - `.cursor/rules/agents/` (Cursor)
-- `.windsurf/rules/agents/` (Windsurf)
 - `.antigravity/rules/agents/` (Antigravity)
 
 For Codex `/skills` activators, use the dedicated skills sync:
@@ -57,7 +59,10 @@ Sync specific IDE only:
 ```bash
 npm run sync:ide:cursor
 npm run sync:ide:codex
-npm run sync:ide:windsurf
+npm run sync:ide:gemini
+npm run sync:ide:github-copilot
+npm run sync:ide:antigravity
+npm run sync:ide:claude
 ```
 
 ### Validate
@@ -105,6 +110,14 @@ ideSync:
       enabled: true
       path: .codex/agents
       format: full-markdown-yaml
+    gemini:
+      enabled: true
+      path: .gemini/rules/AIOS/agents
+      format: full-markdown-yaml
+    github-copilot:
+      enabled: true
+      path: .github/agents
+      format: full-markdown-yaml
     cursor:
       enabled: true
       path: .cursor/rules/agents
@@ -122,11 +135,23 @@ Each IDE has a specific format for agent files:
 | IDE         | Format                  | Extension |
 | ----------- | ----------------------- | --------- |
 | Claude Code | Full markdown with YAML | `.md`     |
-| Codex CLI   | Condensed rules         | `.md`     |
+| Codex CLI   | Full markdown with YAML | `.md`     |
+| Gemini CLI  | Full markdown with YAML | `.md`     |
+| GitHub Copilot | Full markdown with YAML | `.md`   |
 | Cursor      | Condensed rules         | `.md`     |
-| Windsurf    | XML-tagged markdown     | `.md`     |
 | Antigravity | Cursor-style            | `.md`     |
 
+Platform-specific checks:
+
+```bash
+npm run validate:claude-sync
+npm run validate:claude-integration
+npm run validate:codex-sync
+npm run validate:codex-integration
+npm run validate:gemini-sync
+npm run validate:gemini-integration
+```
+
 ## Redirect Agents
 
 Deprecated or renamed agents are handled via redirects. When an old agent name is requested, a redirect file is created pointing to the new agent.
@@ -151,7 +176,6 @@ This agent has been renamed. Use `aios-master` instead.
 └── transformers/
     ├── claude-code.js       # Claude Code format
     ├── cursor.js            # Cursor format
-    ├── windsurf.js          # Windsurf format
     └── antigravity.js       # Antigravity format
 ```
 

package/.aios-core/infrastructure/scripts/ide-sync/gemini-commands.js

@@ -0,0 +1,205 @@
+'use strict';
+
+const fs = require('fs-extra');
+const path = require('path');
+
+const FALLBACK_DESCRIPTION = 'Agente especializado AIOS';
+const MAX_DESCRIPTION_CONTEXT = 120;
+
+const MENU_ORDER = [
+  'aios-master',
+  'analyst',
+  'architect',
+  'data-engineer',
+  'dev',
+  'devops',
+  'pm',
+  'po',
+  'qa',
+  'sm',
+  'squad-creator',
+  'ux-design-expert',
+];
+
+function commandSlugForAgent(agentId) {
+  if (agentId.startsWith('aios-')) {
+    return agentId.replace(/^aios-/, '');
+  }
+  return agentId;
+}
+
+function menuCommandName(agentId) {
+  return `/aios-${commandSlugForAgent(agentId)}`;
+}
+
+function normalizeText(text) {
+  if (!text || typeof text !== 'string') return '';
+  return text.replace(/\s+/g, ' ').trim();
+}
+
+function truncateText(text, maxLen = MAX_DESCRIPTION_CONTEXT) {
+  if (!text || text.length <= maxLen) return text;
+  return `${text.slice(0, maxLen - 1).trimEnd()}…`;
+}
+
+function summarizeWhenToUse(whenToUse) {
+  const normalized = normalizeText(whenToUse);
+  if (!normalized) return '';
+
+  // Drop redirect/negative guidance sections that are useful for routing, not for menu labels.
+  const withoutNegativeSection = normalized.split(/\b(?:NOT\s+for|NÃO\s+para)\b/i)[0].trim();
+  const primary = withoutNegativeSection || normalized;
+
+  // Keep only the first sentence/chunk for concise autocomplete labels.
+  const firstChunk = primary.split(/[.;!?](?:\s|$)/)[0].trim();
+  return truncateText(firstChunk || primary);
+}
+
+function escapeTomlString(text) {
+  return String(text || '').replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+
+function buildAgentDescription(agent) {
+  const agentData = agent.agent || {};
+  const title = normalizeText(agentData.title);
+  const whenToUseSummary = summarizeWhenToUse(agentData.whenToUse);
+
+  if (title && whenToUseSummary) {
+    return `${title} (${whenToUseSummary})`;
+  }
+  if (title) {
+    return title;
+  }
+  if (whenToUseSummary) {
+    return whenToUseSummary;
+  }
+  return `Ativar agente AIOS ${agent.id}`;
+}
+
+function buildAgentCommandPrompt(agentId) {
+  return [
+    `Ative o agente ${agentId}:`,
+    `1. Leia a definição completa em .gemini/rules/AIOS/agents/${agentId}.md`,
+    '2. Siga as activation-instructions do bloco YAML',
+    `3. Renderize o greeting via: node .aios-core/development/scripts/generate-greeting.js ${agentId}`,
+    '   Se shell nao disponivel, exiba o greeting de persona_profile.communication.greeting_levels.named',
+    '4. Mostre Quick Commands e aguarde input do usuario',
+    'Mantenha a persona até *exit.',
+  ].join('\n');
+}
+
+function buildAgentCommandFile(agentId, description = FALLBACK_DESCRIPTION) {
+  const slug = commandSlugForAgent(agentId);
+
+  const prompt = buildAgentCommandPrompt(agentId);
+  const content = [
+    `description = "${escapeTomlString(description)}"`,
+    'prompt = """',
+    prompt,
+    '"""',
+    '',
+  ].join('\n');
+
+  return {
+    filename: `aios-${slug}.toml`,
+    content,
+    agentId,
+    description,
+  };
+}
+
+function buildMenuPrompt(commandFiles) {
+  const lines = [
+    'Você está no launcher AIOS para Gemini.',
+    '',
+    'Mostre a lista de agentes abaixo em formato numerado, explicando em 1 linha quando usar cada um:',
+  ];
+
+  let index = 1;
+  for (const commandFile of commandFiles) {
+    lines.push(`${index}. ${menuCommandName(commandFile.agentId)} - ${commandFile.description}`);
+    index += 1;
+  }
+
+  lines.push('');
+  lines.push('No final, peça para o usuário escolher um número ou digitar o comando direto.');
+  return lines.join('\n');
+}
+
+function buildMenuCommandFile(commandFiles) {
+  const content = [
+    'description = "Menu rápido AIOS (lista agentes e orienta qual ativar)"',
+    'prompt = """',
+    buildMenuPrompt(commandFiles),
+    '"""',
+    '',
+  ].join('\n');
+
+  return {
+    filename: 'aios-menu.toml',
+    content,
+  };
+}
+
+function resolveAgentOrder(agentIds) {
+  const unique = [...new Set(agentIds)];
+  const known = MENU_ORDER.filter((id) => unique.includes(id));
+  const extra = unique.filter((id) => !MENU_ORDER.includes(id)).sort();
+  return [...known, ...extra];
+}
+
+function buildGeminiCommandFiles(agents) {
+  const validAgents = agents
+    .filter((agent) => !agent.error)
+    .map((agent) => ({
+      id: agent.id,
+      description: buildAgentDescription(agent),
+    }));
+
+  const ordered = resolveAgentOrder(validAgents.map((agent) => agent.id));
+  const byId = new Map(validAgents.map((agent) => [agent.id, agent]));
+  const files = ordered.map((id) => {
+    const meta = byId.get(id);
+    const description = meta?.description || FALLBACK_DESCRIPTION;
+    return buildAgentCommandFile(id, description);
+  });
+  files.unshift(buildMenuCommandFile(files));
+  return files;
+}
+
+function syncGeminiCommands(agents, projectRoot, options = {}) {
+  const commandsDir = path.join(projectRoot, '.gemini', 'commands');
+  const files = buildGeminiCommandFiles(agents);
+  const written = [];
+
+  if (!options.dryRun) {
+    fs.ensureDirSync(commandsDir);
+  }
+
+  for (const file of files) {
+    const targetPath = path.join(commandsDir, file.filename);
+    if (!options.dryRun) {
+      fs.writeFileSync(targetPath, file.content, 'utf8');
+    }
+    written.push({
+      filename: path.join('commands', file.filename),
+      path: targetPath,
+      content: file.content,
+    });
+  }
+
+  return { commandsDir, files: written };
+}
+
+module.exports = {
+  FALLBACK_DESCRIPTION,
+  MENU_ORDER,
+  commandSlugForAgent,
+  menuCommandName,
+  buildAgentDescription,
+  summarizeWhenToUse,
+  truncateText,
+  escapeTomlString,
+  buildGeminiCommandFiles,
+  syncGeminiCommands,
+};