stealthos-cli 0.1.0-alpha.3 → 0.1.0-alpha.4

package/ai/clients/antigravity.md

@@ -0,0 +1,125 @@
+---
+version: 1.1.0
+updated: 2026-05-16
+tier: on-demand
+tokens: ~600
+---
+
+# Antigravity (Google) + Gemini CLI
+
+**Status**: supported
+**Versão mínima**: Antigravity Workbench atual / Gemini CLI v0.1+
+**Entry-points**:
+- `GEMINI.md` (raiz do projeto, já existente)
+- `~/.gemini/GEMINI.md` (global, já existente)
+**MCP**:
+- **Antigravity nativo**: `%USERPROFILE%\.gemini\antigravity\mcp_config.json` (global, path próprio)
+- **Gemini CLI**: `.gemini/settings.json` (projeto) ou `~/.gemini/settings.json` (global)
+
+> ⚠️ Antigravity e Gemini CLI **não compartilham** o mesmo arquivo de config MCP. Cada um tem o seu.
+
+## Capability matrix
+
+| Capacidade | Antigravity nativo | Gemini CLI |
+|---|---|---|
+| Auto-load de GEMINI.md | ✅ | ✅ |
+| MCP server | ✅ (path próprio) | ✅ (`.gemini/settings.json`) |
+| Slash commands `/analyze`, `/audit` etc. | ❌ (são exclusivos do Claude Code) | ❌ |
+| Tools `aios_*` via MCP | ✅ | ✅ |
+| Hooks equivalentes | ❌ | ❌ |
+| `${workspaceFolder}` em paths | ❌ **usar absoluto** | ❌ usar absoluto |
+| Janela de contexto 1M+ | ✅ (Gemini 2.5+) | ✅ |
+
+## ❓ Por que os slash commands (`/init`, `/sync`, `/work`) não aparecem no chat nativo do Antigravity?
+
+Slash commands são **exclusivos do Claude Code** — definidos em `.claude/commands/*.md`. Essa convenção **não é portável**. Quando você usa a *extensão Claude Code dentro do Antigravity*, ela mostra esses comandos porque carrega `.claude/commands/`. O chat nativo do Antigravity (Gemini 3.1 Pro) ignora essa pasta.
+
+**A portabilidade real acontece via MCP tools, não slash commands.** No chat nativo do Antigravity você não digita `/init` — pede em linguagem natural:
+
+| Em vez de digitar | Peça em linguagem natural | Tool MCP chamada |
+|---|---|---|
+| `/init` | "inicialize o conhecimento do projeto" | `aios_run_workflow({name:"init"})` |
+| `/sync` | "sincroniza o estado do projeto" | `aios_run_workflow({name:"sync"})` |
+| `/work <intent>` | "trabalhe nesta tarefa: <intent>" | `aios_run_workflow({name:"work", input:{intent}})` |
+| (retomar pause) | "retome a execução X" | `aios_resume_workflow({execution_id, user_input})` |
+| ad-hoc: state | "qual a phase atual?" | `aios_state_get/set/advance` |
+| ad-hoc: confidence | "avalie confidence" | `aios_confidence_assess` |
+| ad-hoc: drift | "houve drift?" | `aios_detect_drift` |
+| ad-hoc: contexto compilado | "carregue runtime-context" | `aios_compile_runtime_context` |
+| ad-hoc: health check | "qual o status do AI OS?" | `aios_health` |
+| ad-hoc: listar workflows | "quais workflows estão disponíveis?" | `aios_list_workflows` |
+
+**34 tools MCP** estão expostas no total. Workflows `work` v3 e `init` v3 incluem `pause_for` — retornam `status:"paused"` + `execution_id`; o Antigravity (Gemini) deve apresentar o `prompt` da pausa e retomar via `aios_resume_workflow`. Para uso de tool primitiva específica fora de workflow, peça explicitamente: "use a tool `aios_snapshot` com label 'pre-refactor'".
+
+Se o Antigravity não chama as tools `aios_*`, é porque o MCP não está conectado — ver troubleshooting abaixo.
+
+## Ativação em 3 passos — Antigravity nativo
+
+1. **Instalar** Antigravity: <https://antigravity.google>.
+2. **Configurar MCP global** (não há config por-projeto no Antigravity):
+   - No Antigravity, abrir o painel **MCP** (geralmente no topo da sidebar do agent).
+   - Clicar em **Manage MCP Servers** → **View raw config**.
+   - Isso abre `%USERPROFILE%\.gemini\antigravity\mcp_config.json` no editor.
+   - Colar o snippet abaixo (mesclando se já houver outros servers).
+3. **Reiniciar Antigravity** → conferir que `ai-os` aparece conectado no painel MCP.
+
+### Snippet MCP — Antigravity (`%USERPROFILE%\.gemini\antigravity\mcp_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "ai-os": {
+      "command": "node",
+      "args": ["C:\\Users\\PC\\Desktop\\Estrutura para IA\\Harness\\.ai\\server\\aios-server.mjs"]
+    }
+  }
+}
+```
+
+> **Path absoluto obrigatório** — Antigravity não expande `${workspaceFolder}`. Se for usar em outro projeto, ajustar o path. Snippet base em [`snippets/mcp-absolute-paths.json`](./snippets/mcp-absolute-paths.json).
+
+## Ativação — Gemini CLI
+
+1. **Instalar**: `npm i -g @google/gemini-cli`.
+2. **Config já commitado**: `.gemini/settings.json` no projeto (path relativo `.ai/server/aios-server.mjs` funciona aqui).
+3. **Testar**: `cd` para o projeto, rodar `gemini` → `gemini mcp list` deve listar `ai-os`.
+
+## Validação
+
+### Antigravity Workbench
+1. Verificar no painel **MCP** que `ai-os` está conectado (bolinha verde).
+2. Novo agent task no projeto, mandar: `health check do ai os` (linguagem natural — **não** digite `/`).
+3. **Esperado**:
+   - Primeira linha da resposta: `OS:loaded(...)` (sinal de que `GEMINI.md` foi lido).
+   - Resposta inclui chamada à tool `aios_health` retornando JSON `{ status: "ok", version: "4.1.0", ... }`.
+
+### Gemini CLI
+```powershell
+cd "C:\Users\PC\Desktop\Estrutura para IA\Harness"
+gemini mcp list
+# Esperado: ai-os listado
+
+gemini
+> qual o status do AI OS?
+# Esperado: OS:loaded(...) + chamada a aios_health
+```
+
+## Troubleshooting
+
+| Sintoma | Causa provável | Fix |
+|---|---|---|
+| `/algo` mostra "No matching results" | Slash commands do Claude Code **não portam**; usar linguagem natural | Veja a tabela acima — peça em texto |
+| MCP painel vazio / sem `ai-os` | `mcp_config.json` não foi editado no path correto | Confirme: **Manage MCP Servers > View raw config** abre o arquivo certo? |
+| Sem `OS:loaded` na 1ª linha | `GEMINI.md` não foi carregado | Confirmar presença na raiz do projeto + `~/.gemini/GEMINI.md` global |
+| `ai-os` no painel mas com erro "Failed to start" | path errado ou Node fora do PATH | Testar `node -v` no PowerShell; usar absoluto em `command`: `"C:\\Program Files\\nodejs\\node.exe"` |
+| `aios_*` listados mas não chamados | Modelo escolheu não usar — depende do prompt | Peça explicitamente: "use a tool aios_analyze_project" |
+| `${workspaceFolder}` não expande | Antigravity não suporta essa variável | Trocar por path absoluto |
+| Conflito entre projeto e global | Configs duplicadas (raro no Antigravity, pois ele é global) | Para Gemini CLI: projeto vence; remover bloco duplicado no global |
+
+## Limitações
+
+- **Slash commands não portam** entre IDEs — esse é um trade-off da convenção do Claude Code, não do AI OS.
+- Config MCP do Antigravity é **global** (não por projeto) — múltiplos projetos compartilham mesmo `ai-os` se o path apontar para um deles.
+- Sem hooks → `[OS Audit]` depende da disciplina do modelo.
+- Antigravity ainda em evolução (UI/UX em ajuste).
+- Janela de 1M tokens é vantagem, mas não substitui o ROUTER — usar tier discipline.

package/ai/clients/claude-code.md

@@ -0,0 +1,65 @@
+---
+version: 1.0.0
+updated: 2026-05-15
+tier: on-demand
+tokens: ~400
+---
+
+# Claude Code
+
+**Status**: supported (configuração de referência — outros clientes espelham este)
+**Versão mínima**: Claude Code CLI atual
+**Entry-point**: `CLAUDE.md` (raiz do projeto) + `~/.claude/CLAUDE.md` (global)
+**MCP**: sim, via `.claude/settings.json`
+**Hooks**: sim — 3 hooks ativos
+
+## Capability matrix
+
+| Capacidade | Status |
+|---|---|
+| Auto-load de regras via system prompt | ✅ (CLAUDE.md) |
+| MCP server (stdio) | ✅ (`.claude/settings.json` → `mcpServers.ai-os`) |
+| Hooks (UserPromptSubmit, PreToolUse, Stop) | ✅ |
+| Slash commands customizados | ✅ (`.claude/commands/`) |
+| TodoWrite, subagents (Explore/Plan) | ✅ (nativos) |
+
+## Configuração atual (já aplicada — referência)
+
+A configuração já existe e funciona. Arquivos relevantes:
+
+- `CLAUDE.md` (raiz) — bridge do Claude para `.ai/INDEX.md`
+- `~/.claude/CLAUDE.md` — regras globais imutáveis
+- `.claude/settings.json` — hooks + MCP server
+- `.claude/commands/*.md` — slash commands (`/analyze`, `/audit`, `/context`, `/snapshot`, etc.)
+- `.ai/hooks/inject-os-reminder.ps1` (UserPromptSubmit)
+- `.ai/hooks/guard-edit.ps1` (PreToolUse Edit/Write)
+- `.ai/hooks/enforce-audit.ps1` (Stop)
+
+## Validação
+
+```powershell
+# 1. Abrir o projeto no Claude Code CLI e mandar:
+oi
+
+# Esperado:
+# - Primeira linha começa com OS:loaded(
+# - Segunda linha tem Task class:
+
+# 2. Listar MCP tools:
+/mcp
+
+# Esperado: tools aios_* listados (aios_get_core_bundle, aios_health, etc.)
+```
+
+## Troubleshooting
+
+| Sintoma | Causa provável | Fix |
+|---|---|---|
+| Sem `OS:loaded` na resposta | Hook `inject-os-reminder` não rodou | checar `.claude/settings.json` + permissões PS1 |
+| Sem tools `aios_*` em `/mcp` | Daemon não iniciou | rodar manualmente: `node .ai/server/aios-server.mjs`; ver erros |
+| Hook `guard-edit` bloqueando edit legítimo | Arquivo entrou na lista protegida sem necessidade | revisar `.ai/hooks/guard-edit.ps1` e abrir ADR se mudança é estrutural |
+| `[OS Audit]` faltando ao parar | Hook `Stop` não disparou | verificar config + log do hook |
+
+## Limitações
+
+Nenhuma conhecida — é o ambiente de referência.

package/ai/clients/cline.md

@@ -0,0 +1,69 @@
+---
+version: 1.0.0
+updated: 2026-05-15
+tier: on-demand
+tokens: ~380
+---
+
+# Cline (VSCode)
+
+**Status**: supported
+**Versão mínima**: Cline extension recente (saoudrizwan.claude-dev)
+**Entry-point**: `.clinerules` (raiz do projeto)
+**MCP**: sim — config global em VSCode (`cline_mcp_settings.json`)
+
+## Capability matrix
+
+| Capacidade | Status |
+|---|---|
+| Auto-load de rules | ✅ (`.clinerules`) |
+| MCP server (stdio) | ✅ (config global VSCode) |
+| Hooks equivalentes | ❌ |
+| Slash commands | ❌ |
+
+## Ativação em 3 passos
+
+1. **Instalar** VSCode + extensão Cline.
+2. **Abrir o projeto Harness** no VSCode.
+3. **Configurar MCP global**:
+   - Editar `cline_mcp_settings.json` em:
+     `%APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json`
+   - Colar o snippet abaixo.
+   - Reiniciar VSCode (ou recarregar a janela: `Ctrl+Shift+P` → `Developer: Reload Window`).
+
+## Snippet MCP (`cline_mcp_settings.json`)
+
+```json
+{
+  "mcpServers": {
+    "ai-os": {
+      "command": "node",
+      "args": ["C:\\Users\\PC\\Desktop\\Estrutura para IA\\Harness\\.ai\\server\\aios-server.mjs"]
+    }
+  }
+}
+```
+
+Path absoluto é obrigatório (config global).
+
+## Validação
+
+1. Abrir o panel do Cline.
+2. Mandar: `oi`
+3. **Esperado**:
+   - Primeira linha: `OS:loaded(...)`
+   - No header do Cline, mensagem: `Connected MCP server: ai-os` (ou similar)
+
+## Troubleshooting
+
+| Sintoma | Causa provável | Fix |
+|---|---|---|
+| Sem `OS:loaded` | `.clinerules` não carregou | conferir nome exato; reiniciar VSCode |
+| MCP "Server failed to start" | Path errado / Node não acessível | testar `node -v` no terminal integrado; usar absoluto para o node se necessário |
+| Cline ignora MCP | versão antiga | atualizar extensão (Cline ganhou MCP em versões recentes) |
+| Path com espaços quebra | Windows + JSON | confirmar escape `\\` no snippet |
+
+## Limitações
+
+- Config MCP global → cuidado ao trocar de projeto: mude o path se for usar `ai-os` em outro lugar.
+- Sem hooks → audit depende do modelo.

package/ai/clients/codex-aider-cli.md

@@ -0,0 +1,82 @@
+---
+version: 1.0.0
+updated: 2026-05-15
+tier: on-demand
+tokens: ~400
+---
+
+# Codex / Aider / Sourcegraph Amp / Jules / outras CLIs
+
+**Status**: supported via `AGENTS.md`
+**Entry-point**: `AGENTS.md` (raiz do projeto)
+**MCP**: varia por ferramenta
+
+## Por que AGENTS.md?
+
+`AGENTS.md` é uma convenção aberta adotada por múltiplas ferramentas (OpenAI Codex, Aider, Sourcegraph Amp, Jules, Cursor moderno também lê). Ao manter `AGENTS.md` na raiz, qualquer dessas ferramentas carrega o protocolo do AI OS automaticamente.
+
+## Ativação
+
+### OpenAI Codex
+1. `codex` na raiz do projeto.
+2. Codex lê `AGENTS.md` automaticamente.
+3. Validar: mensagem inicial menciona `AGENTS.md` carregado.
+
+### Aider
+1. `aider` na raiz do projeto.
+2. Aider mostra `Loaded AGENTS.md` no startup.
+3. MCP em Aider ainda em evolução — consultar docs atuais.
+
+### Sourcegraph Amp
+1. Amp lê `AGENTS.md` automaticamente em projetos onde está conectado.
+2. Configurar via `amp config`.
+
+### Jules
+1. Jules (background agent do GitHub) lê `AGENTS.md` ao receber tarefa.
+
+### Aplicáveis a CLIs MCP-aware
+Para qualquer CLI que aceite MCP via JSON-RPC stdio, usar o snippet base:
+
+```json
+{
+  "mcpServers": {
+    "ai-os": {
+      "command": "node",
+      "args": [".ai/server/aios-server.mjs"]
+    }
+  }
+}
+```
+
+Ou HTTP:
+```
+node .ai/server/aios-server.mjs --http
+curl http://127.0.0.1:47781/health
+```
+
+## Validação cross-cutting
+
+```powershell
+cd "C:\Users\PC\Desktop\Estrutura para IA\Harness"
+
+# 1. Daemon HTTP responde?
+node .ai/server/aios-server.mjs --http
+# (em outro terminal)
+curl http://127.0.0.1:47781/health
+
+# 2. Tools listadas?
+curl http://127.0.0.1:47781/tools
+```
+
+## Troubleshooting
+
+| Sintoma | Causa provável | Fix |
+|---|---|---|
+| Tool não carrega `AGENTS.md` | versão antiga sem suporte | atualizar; alguns só ganharam em 2025-2026 |
+| `OS:loaded` ausente | modelo não seguiu instruções | reforçar via prompt: "siga o protocolo em AGENTS.md" |
+| MCP daemon não conecta | porta ocupada / Node não no PATH | usar `--http` em outra porta; testar `node -v` |
+
+## Limitações
+
+- `AGENTS.md` depende do tool ler — não há hook que force.
+- Cada CLI tem nuances; este doc é guia geral, consultar docs específicas de cada uma.

package/ai/clients/continue.md

@@ -0,0 +1,67 @@
+---
+version: 1.0.0
+updated: 2026-05-15
+tier: on-demand
+tokens: ~400
+---
+
+# Continue (VSCode / JetBrains)
+
+**Status**: supported
+**Versão mínima**: Continue v1+ (schema YAML)
+**Entry-point**: `.continue/rules/ai-os.md` (escopo projeto)
+**MCP**: sim — `.continue/config.yaml` (projeto) ou `~/.continue/config.yaml` (global)
+
+## Capability matrix
+
+| Capacidade | Status |
+|---|---|
+| Auto-load de rules | ✅ (arquivos em `.continue/rules/`) |
+| MCP server (stdio) | ✅ |
+| Hooks equivalentes | ❌ |
+| Slash commands | ✅ (definíveis em config) |
+
+## Ativação em 3 passos
+
+1. **Instalar** Continue (VSCode marketplace ou JetBrains plugins).
+2. **Abrir o projeto Harness**.
+3. **Recarregar config**: `Ctrl+Shift+P` → `Continue: Reload Config`.
+
+## Snippet MCP (`.continue/config.yaml` — já commitado)
+
+```yaml
+name: AI OS — Harness project config
+version: 0.0.1
+schema: v1
+
+mcpServers:
+  - name: ai-os
+    command: node
+    args:
+      - .ai/server/aios-server.mjs
+    description: AI Operating System daemon (aios.* tools)
+```
+
+> Se preferir global, mescle o bloco `mcpServers` em `~/.continue/config.yaml`.
+
+## Validação
+
+1. `Continue: Reload Config` no Command Palette.
+2. Abrir Continue chat, mandar: `oi`
+3. **Esperado**:
+   - Primeira linha: `OS:loaded(...)`
+   - Em `Settings > MCP`, ai-os listado com tools `aios.*`.
+
+## Troubleshooting
+
+| Sintoma | Causa provável | Fix |
+|---|---|---|
+| Sem `OS:loaded` | rule em `.continue/rules/` não foi indexado | reload config; conferir extensão `.md` |
+| Reload falha com erro de YAML | indentação errada em `config.yaml` | validar: `node -e "console.log(require('js-yaml').load(require('fs').readFileSync('.continue/config.yaml','utf8')))"` |
+| MCP ai-os não aparece | bloco `mcpServers` em lugar errado do YAML | conferir nível raiz, não aninhado |
+| Tools `aios.*` ausentes | daemon não startou | testar manualmente: `node .ai/server/aios-server.mjs --http` + `curl /health` |
+
+## Limitações
+
+- Continue rules têm escopo amplo — não há `globs` por arquivo como no Cursor MDC.
+- Sem hooks.

package/ai/clients/copilot.md

@@ -0,0 +1,49 @@
+---
+version: 1.0.0
+updated: 2026-05-15
+tier: on-demand
+tokens: ~350
+---
+
+# GitHub Copilot (VSCode)
+
+**Status**: supported (limitado — sem MCP)
+**Versão mínima**: VSCode + GitHub Copilot extension com suporte a `copilot-instructions.md`
+**Entry-point**: `.github/copilot-instructions.md`
+**MCP**: ❌ (Copilot ainda não suporta MCP até 2026-05)
+
+## Capability matrix
+
+| Capacidade | Status |
+|---|---|
+| Auto-load de instructions | ✅ (`.github/copilot-instructions.md`) |
+| MCP server | ❌ |
+| Hooks equivalentes | ❌ |
+| Slash commands customizados | ❌ |
+
+## Ativação
+
+1. **Instalar** GitHub Copilot + Copilot Chat (VSCode).
+2. **Garantir setting**: `github.copilot.chat.codeGeneration.useInstructionFiles` = `true` (geralmente padrão).
+3. **Abrir o projeto** — `.github/copilot-instructions.md` carrega automaticamente em todo Copilot Chat.
+
+## Validação
+
+1. Abrir Copilot Chat (`Ctrl+Alt+I`).
+2. Mandar: `me explique o protocolo deste repo`
+3. **Esperado**: resposta menciona `.ai/INDEX.md`, `OS:loaded`, `[OS Audit]`, hierarquia de regras.
+
+## Troubleshooting
+
+| Sintoma | Causa provável | Fix |
+|---|---|---|
+| Resposta genérica (sem mencionar AI OS) | `copilot-instructions.md` não foi lido | conferir setting acima; conferir path exato `.github/copilot-instructions.md` |
+| Instructions truncadas | arquivo muito longo | versão atual já está enxuta (~10 linhas, ~150 tokens) — manter assim |
+| Copilot ignora protocolo em código gerado | natureza do produto: instructions guiam, não força | usar Claude Code / Cursor / Cline para tarefas que dependem de protocolo rígido |
+
+## Limitações
+
+- **Sem MCP**: nada de tools `aios.*` aqui. Use outra IDE para Runtime v0.1.
+- **Sem hooks**: `[OS Audit]` é disciplina pura.
+- **Truncamento**: Copilot é conhecido por truncar instructions longas → manter o stub minimalista.
+- **Não suporta `[OS Audit]` consistentemente**: chats são curtos e focados em código.

package/ai/clients/cursor.md

@@ -0,0 +1,81 @@
+---
+version: 1.0.0
+updated: 2026-05-15
+tier: on-demand
+tokens: ~450
+---
+
+# Cursor
+
+**Status**: supported
+**Versão mínima**: Cursor com suporte a `.cursor/rules/*.mdc` (formato MDC, atual em 2026)
+**Entry-points**: `.cursorrules` (legado) + `.cursor/rules/ai-os.mdc` (MDC, preferido)
+**MCP**: sim — `.cursor/mcp.json` (escopo projeto)
+
+## Capability matrix
+
+| Capacidade | Status |
+|---|---|
+| Auto-load de rules (always-apply) | ✅ via MDC `alwaysApply: true` |
+| MCP server (stdio) | ✅ via `.cursor/mcp.json` |
+| Hooks equivalentes | ❌ (sem hooks customizáveis) |
+| Slash commands | parcial (built-ins apenas) |
+
+## Ativação em 3 passos
+
+1. **Instalar** Cursor: <https://cursor.com>
+2. **Abrir o projeto Harness** no Cursor (`File > Open Folder`).
+3. **Reiniciar conversa** (novo chat) — `.cursorrules` e `.cursor/rules/ai-os.mdc` carregam automaticamente; `.cursor/mcp.json` é detectado em `Settings > MCP`.
+
+## Snippets (já commitados)
+
+### `.cursor/rules/ai-os.mdc` (rule MDC, sempre aplicada)
+
+```mdc
+---
+description: AI Operating System protocol — read .ai/INDEX.md first, emit OS:loaded tag, follow CONTRACT.md
+globs: ["**/*"]
+alwaysApply: true
+---
+(corpo: ver arquivo)
+```
+
+### `.cursor/mcp.json` (MCP server)
+
+```json
+{
+  "mcpServers": {
+    "ai-os": {
+      "command": "node",
+      "args": ["${workspaceFolder}/.ai/server/aios-server.mjs"]
+    }
+  }
+}
+```
+
+> Se `${workspaceFolder}` não expandir corretamente no seu Cursor, troque por caminho absoluto (snippet em `.ai/clients/snippets/mcp-absolute-paths.json`).
+
+## Validação
+
+1. Abrir novo chat no Cursor.
+2. Mandar: `qual a stack deste projeto?`
+3. **Esperado**:
+   - Primeira linha: `OS:loaded(...)`
+   - Resposta menciona ter lido `.ai/INDEX.md` ou `.ai/memory/project-context.md`.
+4. Conferir `Settings > MCP`: ai-os listado como conectado, com tools `aios.*`.
+
+## Troubleshooting
+
+| Sintoma | Causa provável | Fix |
+|---|---|---|
+| Sem `OS:loaded` | rule MDC não carregou | conferir frontmatter (`alwaysApply: true`); reiniciar Cursor |
+| Conflito entre `.cursorrules` e MDC | ambos ativos com conteúdo diferente | manter sincronizados; preferir MDC (legado é fallback) |
+| MCP ai-os não conecta | `${workspaceFolder}` não expandiu | usar caminho absoluto |
+| `node not found` | Node não no PATH do Cursor | usar caminho absoluto: `"command": "C:\\Program Files\\nodejs\\node.exe"` |
+| Token tax / contexto grande | rule MDC muito grande | manter abaixo de 200 palavras para always-apply |
+
+## Limitações
+
+- Sem mecanismo nativo de hooks → enforcement vem só do system prompt.
+- `[OS Audit]` depende da disciplina do modelo — não há hook `Stop`.
+- Cursor pode truncar rules muito longas em certas modes ("Auto", "Plan", "Debug").

package/ai/clients/snippets/mcp-absolute-paths.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "ai-os": {
+      "command": "node",
+      "args": ["C:\\Users\\PC\\Desktop\\Estrutura para IA\\Harness\\.ai\\server\\aios-server.mjs"],
+      "description": "AI Operating System daemon — absolute path variant for IDEs that don't expand workspace variables (Cline, Windsurf, TRAE global configs)."
+    }
+  }
+}

package/ai/clients/snippets/mcp-http.json

@@ -0,0 +1,7 @@
+{
+  "name": "ai-os",
+  "transport": "http",
+  "url": "http://127.0.0.1:47781/rpc",
+  "health": "http://127.0.0.1:47781/health",
+  "description": "AI Operating System daemon over HTTP. Requires running: node .ai/server/aios-server.mjs --http (port auto-falls back from 47781)."
+}

package/ai/clients/snippets/mcp-stdio.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "ai-os": {
+      "command": "node",
+      "args": [".ai/server/aios-server.mjs"],
+      "description": "AI Operating System daemon (aios.* tools). Stdio transport. Working dir must be the project root."
+    }
+  }
+}

package/ai/clients/trae.md

@@ -0,0 +1,69 @@
+---
+version: 1.0.0
+updated: 2026-05-15
+tier: on-demand
+tokens: ~400
+---
+
+# TRAE (ByteDance)
+
+**Status**: supported (experimental — produto novo)
+**Versão mínima**: TRAE v1.3.0+ (com suporte a `.rules` e MCP)
+**Entry-point**: `.trae/rules/project_rules.md`
+**MCP**: sim — via painel "MCP" do TRAE
+
+## Capability matrix
+
+| Capacidade | Status |
+|---|---|
+| Auto-load de rules | ✅ (`.trae/rules/project_rules.md`) |
+| Auto-load de rules de usuário | ✅ (`user_rules.md` no perfil) |
+| MCP server | ✅ (v1.3+) |
+| Hooks equivalentes | ❌ |
+
+## Ativação em 3 passos
+
+1. **Instalar** TRAE: <https://traeide.com>
+2. **Abrir o projeto Harness** no TRAE.
+3. **Configurar MCP**:
+   - No TRAE, abrir o painel "MCP" (ou `Settings > MCP`).
+   - Adicionar server `ai-os` com o snippet abaixo.
+   - Reiniciar TRAE.
+
+## Snippet MCP
+
+```json
+{
+  "mcpServers": {
+    "ai-os": {
+      "command": "node",
+      "args": ["C:\\Users\\PC\\Desktop\\Estrutura para IA\\Harness\\.ai\\server\\aios-server.mjs"]
+    }
+  }
+}
+```
+
+> Path absoluto recomendado. Se TRAE expor variável de workspace, prefira ela.
+
+## Validação
+
+1. Abrir agent no TRAE.
+2. Mandar: `oi`
+3. **Esperado**:
+   - Primeira linha: `OS:loaded(...)`
+   - Tools `aios.*` visíveis no painel MCP.
+
+## Troubleshooting
+
+| Sintoma | Causa provável | Fix |
+|---|---|---|
+| Sem `OS:loaded` | `.trae/rules/project_rules.md` não foi indexado | conferir path exato; reiniciar |
+| Painel MCP não existe | TRAE < v1.3 | atualizar para v1.3+ |
+| MCP "Connection failed" | path errado ou Node ausente | testar `node -v` no terminal; usar absoluto |
+| Docs em mandarim | UI internacional incompleta | consultar <https://docs.trae.ai/ide/rules?_lang=en> |
+
+## Limitações
+
+- Produto novo — convenções podem mudar entre versões.
+- Path do `mcp_config` exato dentro do perfil TRAE pode variar; preferir UI.
+- Sem hooks.