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

package/ai/hooks/inject-os-reminder.ps1

@@ -0,0 +1,40 @@
+# UserPromptSubmit hook
+# Injeta lembrete do AI Operating System em toda mensagem do usuário.
+# Output em additionalContext é incorporado ao contexto do agente nesse turno.
+
+$projectDir = $env:CLAUDE_PROJECT_DIR
+if (-not $projectDir) { $projectDir = (Get-Location).Path }
+
+$indexPath = Join-Path $projectDir ".ai\INDEX.md"
+$contractPath = Join-Path $projectDir ".ai\CONTRACT.md"
+$routerPath = Join-Path $projectDir ".ai\ROUTER.md"
+
+if (-not (Test-Path $indexPath)) {
+    # .ai/ não existe — sugerir bootstrap
+    $msg = "[OS REMINDER] O diretorio .ai/ nao existe neste projeto. Pergunte ao usuario se quer rodar o bootstrap (.ai/scripts/init-ai-os.ps1)."
+} else {
+    $msg = @"
+[OS REMINDER] Antes de responder:
+1. Emitir tag OS:loaded(<arquivos>) na primeira linha.
+2. Consultar .ai/ROUTER.md para decidir o que carregar alem do CORE.
+3. Classificar a tarefa: trivial | simple | complex.
+4. Para simple/complex: terminar com bloco [OS Audit].
+5. Nunca inventar arquivos, validacoes ou resultados.
+
+CORE sempre carregado: INDEX, CONTRACT, ROUTER, rules/dont, rules/behavior, memory/project-context.
+
+Hierarquia: rules/dont > rules/do > operating-system > skills > evolution.
+Conflito com usuario: instrucao do usuario vence, exceto dont.md.
+"@
+}
+
+# Output JSON com hookSpecificOutput para injecao em context (Claude Code 1.x+)
+$payload = @{
+    hookSpecificOutput = @{
+        hookEventName = "UserPromptSubmit"
+        additionalContext = $msg
+    }
+} | ConvertTo-Json -Depth 5 -Compress
+
+Write-Output $payload
+exit 0

package/ai/hooks/inject-os-reminder.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# UserPromptSubmit hook (Unix)
+# Injeta lembrete do AI Operating System em toda mensagem do usuario.
+set -euo pipefail
+
+PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+INDEX="$PROJECT_DIR/.ai/INDEX.md"
+
+if [[ ! -f "$INDEX" ]]; then
+    MSG='[OS REMINDER] O diretorio .ai/ nao existe neste projeto. Pergunte ao usuario se quer rodar o bootstrap (.ai/scripts/init-ai-os.sh).'
+else
+    MSG='[OS REMINDER] Antes de responder:\n1. Emitir tag OS:loaded(<arquivos>) na primeira linha.\n2. Consultar .ai/ROUTER.md para decidir o que carregar alem do CORE.\n3. Classificar a tarefa: trivial | simple | complex.\n4. Para simple/complex: terminar com bloco [OS Audit].\n5. Nunca inventar arquivos, validacoes ou resultados.\n\nCORE sempre carregado: INDEX, CONTRACT, ROUTER, rules/dont, rules/behavior, memory/project-context.\n\nHierarquia: rules/dont > rules/do > operating-system > skills > evolution.\nConflito com usuario: instrucao do usuario vence, exceto dont.md.\n\nSe daemon AI OS estiver ativo, preferir aios.* tools (MCP) para acesso rapido.'
+fi
+
+printf '{"hookSpecificOutput":{"hookEventName":"UserPromptSubmit","additionalContext":"%s"}}\n' "$MSG"
+exit 0

package/ai/manifest.json

@@ -0,0 +1,238 @@
+{
+  "$schema": "./manifest.schema.json",
+  "name": "ai-operating-system",
+  "version": "4.1.0",
+  "updated": "2026-05-15",
+  "description": "AI Development Operating System (AI-DOS) — Context Engine + Multi-agent + Spec-Driven + Pipeline com gates + memória evolutiva + Runtime v0.1 executável (Project State / Context Packager / Snapshot).",
+  "capabilities": {
+    "runtime_v0_1": true,
+    "context_packager": true,
+    "project_state_engine": true,
+    "snapshot_system": true,
+    "agents_executable": false,
+    "intent_analyzer_dialog": false,
+    "spec_generator": false
+  },
+  "tiers": {
+    "core": {
+      "description": "Sempre carregado. Custo baixo, valor máximo.",
+      "max_total_tokens": 3000,
+      "files": [
+        ".ai/INDEX.md",
+        ".ai/CONTRACT.md",
+        ".ai/ROUTER.md",
+        ".ai/rules/dont.md",
+        ".ai/rules/behavior.md",
+        ".ai/memory/project-context.md"
+      ]
+    },
+    "conditional": {
+      "description": "Carregado por match em ROUTER.md.",
+      "rule": "Ver .ai/ROUTER.md"
+    },
+    "on_demand": {
+      "description": "Carregado apenas quando explicitamente referenciado pelo agente ou pelo usuário.",
+      "rule": "Resto do .ai/"
+    }
+  },
+  "required_files": [
+    ".ai/CONTRACT.md",
+    ".ai/INDEX.md",
+    ".ai/README.md",
+    ".ai/ROUTER.md",
+    ".ai/agents/README.md",
+    ".ai/agents/architect.md",
+    ".ai/agents/backend-engineer.md",
+    ".ai/agents/founder.md",
+    ".ai/agents/frontend-engineer.md",
+    ".ai/agents/product-manager.md",
+    ".ai/agents/qa-engineer.md",
+    ".ai/agents/researcher.md",
+    ".ai/agents/reviewer.md",
+    ".ai/agents/security-engineer.md",
+    ".ai/agents/sre-engineer.md",
+    ".ai/agents/tech-lead.md",
+    ".ai/architecture/README.md",
+    ".ai/architecture/components.md",
+    ".ai/architecture/containers.md",
+    ".ai/architecture/event-flows.md",
+    ".ai/architecture/sequence-diagrams.md",
+    ".ai/architecture/system-context.md",
+    ".ai/architecture/threat-modeling.md",
+    ".ai/bootstrap/discovery-questions.md",
+    ".ai/bootstrap/dispatcher.md",
+    ".ai/bootstrap/existing-project.md",
+    ".ai/bootstrap/new-project.md",
+    ".ai/bootstrap/tech-mapping.md",
+    ".ai/context/README.md",
+    ".ai/context/active-goals.md",
+    ".ai/context/architecture-state.md",
+    ".ai/context/assumptions.md",
+    ".ai/context/business-context.md",
+    ".ai/context/constraints.md",
+    ".ai/context/glossary.md",
+    ".ai/context/project-state.md",
+    ".ai/context/roadmap.md",
+    ".ai/context/technical-context.md",
+    ".ai/context/technical-debt.md",
+    ".ai/core/pipeline/execution-engine.md",
+    ".ai/engineering/README.md",
+    ".ai/engineering/observability/incident-response.md",
+    ".ai/execution/README.md",
+    ".ai/execution/backlog.md",
+    ".ai/execution/milestones.md",
+    ".ai/execution/roadmap.md",
+    ".ai/execution/sprint.md",
+    ".ai/governance/README.md",
+    ".ai/governance/architecture-principles.md",
+    ".ai/governance/definition-of-done.md",
+    ".ai/governance/definition-of-ready.md",
+    ".ai/governance/engineering-principles.md",
+    ".ai/governance/quality-gates.md",
+    ".ai/governance/security-policies.md",
+    ".ai/product/README.md",
+    ".ai/product/business-rules.md",
+    ".ai/product/personas.md",
+    ".ai/product/user-journeys.md",
+    ".ai/product/vision.md",
+    ".ai/specs/README.md",
+    ".ai/specs/ADR/_TEMPLATE.md",
+    ".ai/specs/BRD/_TEMPLATE.md",
+    ".ai/specs/PRD/_TEMPLATE.md",
+    ".ai/specs/RFC/_TEMPLATE.md",
+    ".ai/specs/RUNBOOKS/_TEMPLATE.md",
+    ".ai/specs/SDD/_TEMPLATE.md",
+    ".ai/specs/TASKS/_TEMPLATE.md",
+    ".ai/evolution/agent-evolution.md",
+    ".ai/evolution/improvements.md",
+    ".ai/evolution/learnings.md",
+    ".ai/evolution/patterns-discovered.md",
+    ".ai/hooks/enforce-audit.ps1",
+    ".ai/hooks/enforce-audit.sh",
+    ".ai/hooks/guard-edit.ps1",
+    ".ai/hooks/guard-edit.sh",
+    ".ai/hooks/inject-os-reminder.ps1",
+    ".ai/hooks/inject-os-reminder.sh",
+    ".ai/memory/completed-tasks.md",
+    ".ai/memory/decisions.md",
+    ".ai/memory/errors-and-solutions.md",
+    ".ai/memory/known-issues.md",
+    ".ai/memory/pending-tasks.md",
+    ".ai/memory/project-context.md",
+    ".ai/operating-system/architecture.md",
+    ".ai/operating-system/coding-standards.md",
+    ".ai/operating-system/folder-structure.md",
+    ".ai/operating-system/performance-rules.md",
+    ".ai/operating-system/quality-control.md",
+    ".ai/operating-system/security-rules.md",
+    ".ai/operating-system/workflow.md",
+    ".ai/rules/behavior.md",
+    ".ai/rules/do.md",
+    ".ai/rules/dont.md",
+    ".ai/rules/execution-flow.md",
+    ".ai/runtime.md",
+    ".ai/scripts/detect-stack.ps1",
+    ".ai/scripts/detect-stack.sh",
+    ".ai/scripts/init-ai-os.ps1",
+    ".ai/scripts/init-ai-os.sh",
+    ".ai/scripts/lint-os.ps1",
+    ".ai/scripts/lint-os.sh",
+    ".ai/scripts/start-os.ps1",
+    ".ai/scripts/start-os.sh",
+    ".ai/server/aios-server.mjs",
+    ".ai/server/package.json",
+    ".ai/server/tsconfig.json",
+    ".ai/server/README.md",
+    ".ai/specs/ADR/ADR-0002-typescript-runtime.md",
+    ".ai/skills/architecture-design.md",
+    ".ai/skills/backend-engineering.md",
+    ".ai/skills/database-design.md",
+    ".ai/skills/frontend-engineering.md",
+    ".ai/skills/performance.md",
+    ".ai/skills/scalability.md",
+    ".ai/skills/security.md",
+    ".ai/skills/testing.md",
+    ".ai/tools/debugging.md",
+    ".ai/tools/dependency-analysis.md",
+    ".ai/tools/internet-research.md",
+    ".ai/tools/mcp-discovery.md",
+    ".claude/commands/init.md",
+    ".claude/commands/sync.md",
+    ".claude/commands/work.md",
+    ".ai/workflows/_schema.json",
+    ".ai/workflows/init.json",
+    ".ai/workflows/sync.json",
+    ".ai/workflows/work.json",
+    ".ai/runtime/state.schema.json",
+    ".ai/runtime/state.json",
+    ".ai/specs/RFC/RFC-0001-runtime-orchestrator.md",
+    ".ai/specs/RFC/RFC-0002-runtime-orchestrator-extended.md",
+    ".ai/specs/ADR/ADR-0004-runtime-orchestrator.md",
+    ".ai/specs/ADR/ADR-0005-workflow-engine.md",
+    ".ai/specs/ADR/ADR-0006-runtime-state.md",
+    ".ai/specs/ADR/ADR-0007-state-compiler-drift-context-layers-artifact-index.md",
+    ".ai/specs/ADR/ADR-0008-intent-runtime-discovery-branching.md",
+    ".ai/specs/ADR/ADR-0009-confidence-system-maturity-tracking.md",
+    ".ai/specs/ADR/ADR-0010-structural-architecture-standards.md",
+    ".ai/rules/structure-canon.md",
+    ".ai/rules/structural-constraints.md",
+    ".ai/blueprints/_schema.json",
+    ".ai/blueprints/README.md",
+    ".ai/blueprints/web.json",
+    ".ai/blueprints/saas.json",
+    ".ai/blueprints/crm.json",
+    ".ai/blueprints/mobile.json",
+    ".ai/blueprints/game.json",
+    ".ai/blueprints/ai-platform.json",
+    ".ai/blueprints/telemetry.json",
+    ".ai/blueprints/realtime.json",
+    ".claude/settings.json",
+    ".claude/settings.unix.json",
+    "CLAUDE.md",
+    "GEMINI.md",
+    "GPT.md"
+  ],
+  "memory_hygiene": {
+    "max_lines_per_file": 500,
+    "archive_dir": ".ai/memory/archive",
+    "rotation": "quarterly",
+    "summary_file": ".ai/memory/_summary.md"
+  },
+  "evolution_gates": {
+    "learning_promotion_min_occurrences": 3,
+    "pattern_recognition_min_occurrences": 3,
+    "require_human_approval_for": [
+      ".ai/rules/*",
+      ".ai/operating-system/*",
+      ".ai/CONTRACT.md",
+      ".ai/ROUTER.md",
+      ".ai/manifest.json"
+    ]
+  },
+  "supported_models": {
+    "claude-code": {
+      "entry": "CLAUDE.md",
+      "settings": ".claude/settings.json",
+      "hooks": true,
+      "skills": true,
+      "subagents": true
+    },
+    "claude-api": {
+      "entry": "CLAUDE.md",
+      "hooks": false,
+      "enforcement": "system_prompt + self_audit"
+    },
+    "gemini": {
+      "entry": "GEMINI.md",
+      "hooks": false,
+      "enforcement": "system_prompt + self_audit",
+      "context_strategy": "preload_full_tier_when_headroom"
+    },
+    "gpt": {
+      "entry": "GPT.md",
+      "hooks": false,
+      "enforcement": "system_prompt + json_schema_routing"
+    }
+  },
+  "layout": "consolidated-in-.ai"
+}

package/ai/memory/_detected-stack.json

@@ -0,0 +1,33 @@
+{
+    "detected_at":  "2026-05-16 14:26:47",
+    "target":  "C:\\Users\\PC\\Desktop\\Estrutura para IA\\Harness",
+    "languages":  [
+
+                  ],
+    "frameworks":  [
+
+                   ],
+    "databases":  [
+
+                  ],
+    "infra":  [
+
+              ],
+    "ci_cd":  [
+
+              ],
+    "test_frameworks":  [
+
+                        ],
+    "linters":  [
+
+                ],
+    "formatters":  [
+
+                   ],
+    "package_manager":  null,
+    "structure_style":  null,
+    "smells":  [
+                   "README.md ausente"
+               ]
+}

package/ai/memory/_summary.md

@@ -0,0 +1,49 @@
+---
+version: 1.0.0
+updated: 2026-05-14
+tier: on_demand
+tokens: ~200
+load: when_memory_referenced
+---
+
+# Memory Summary (90 dias)
+
+> Resumo rotativo dos últimos 90 dias. Atualizado automaticamente ou pelo comando `/compact-memory`.
+> Carrega este arquivo em vez dos logs completos quando o agente só precisa de panorama.
+
+---
+
+## Período coberto
+
+**De**: _(preencher)_
+**Até**: _(preencher)_
+
+## Tarefas concluídas (top 10)
+
+_(lista das mais recentes/relevantes)_
+
+## ADRs ativos
+
+_(lista de ADRs aceitos, não substituídos)_
+
+## Erros recorrentes resolvidos
+
+_(top 5 padrões de erro com correção)_
+
+## Pendências críticas (P0/P1)
+
+_(itens de pending-tasks.md)_
+
+## Issues abertos
+
+_(de known-issues.md, severidade alta+)_
+
+---
+
+## Política de Rotação
+
+- A cada 90 dias, mover entradas para `memory/archive/YYYY-QX.md`.
+- Manter os 5-10 itens mais relevantes em cada arquivo de memória vivo.
+- Atualizar este resumo após cada rotação.
+
+Comando: `/compact-memory` (ver `.ai/operating-system/quality-control.md` se configurado).

package/ai/memory/archive/.gitkeep

@@ -0,0 +1,3 @@
+# Diretório de arquivamento de memórias rotacionadas.
+# Entradas movidas de completed-tasks, errors-and-solutions, decisions a cada 90 dias.
+# Formato: YYYY-QX.md (ex: 2026-Q2.md)

package/ai/memory/completed-tasks.md

@@ -0,0 +1,156 @@
+---
+version: 1.0.0
+updated: 2026-05-14
+tier: on_demand
+tokens: ~varies
+load: completion_audit
+mutable: append_only
+---
+
+# Completed Tasks
+
+> Log append-only de tarefas concluídas. Mais recente no topo.
+
+## Formato
+
+```
+## AAAA-MM-DD — Título curto
+- Descrição: o que foi feito
+- Arquivos: lista de paths tocados
+- Validação: como foi verificado (testes, lint, manual)
+- Origem: pending-tasks.md? bug report? request direto?
+- Decisão associada: ADR-NNN (se aplicável)
+```
+
+## Regras
+
+1. Append-only. Nunca apagar entradas antigas.
+2. Uma entrada por tarefa atômica.
+3. Se a tarefa originou-se em `pending-tasks.md`, removê-la de lá.
+4. Não duplicar com `decisions.md`: lá vai o **porquê** arquitetural; aqui vai o **o quê** e **quando**.
+
+## Entradas
+
+<!-- adicionar abaixo -->
+
+## 2026-05-16 — Structural Architecture Standards (ADR-0010) + docs cross-IDE atualizados
+- Descrição: implementada camada de Standards estruturais inspirada em análise externa (síntese filtrada de Vertical Slice Architecture + Modular Monolith DDD + AI-native monorepo 2026). Criados: princípios qualitativos universais (`.ai/rules/structure-canon.md` — 7 princípios: domain-first, vertical slice, boundaries explícitos, no global utils, AI-navigable, contracts required, evolutionary), limites quantitativos (`.ai/rules/structural-constraints.md`), schema declarativo para blueprints, 8 blueprints (web/saas/crm/mobile/game/ai-platform/telemetry/realtime — cada um declara folders, modules, packages_recommended, integrations_recommended, constraints_overrides; suporta `extends` transitivo), e Composition Engine (3 novas tools MCP) que resolve extends, faz union semântica dedupe de folders/modules/packages/integrations e merge de constraints (mais restritivo vence). Concomitantemente, docs cross-IDE atualizados para refletir o estado final pós-Fase 5: `.ai/clients/README.md` ganhou nova tabela com 34 tools por camada + seção sobre pause/resume; `.ai/clients/antigravity.md` tabela "linguagem natural" expandida; `AGENTS.md` lista completa das 34 tools por camada.
+- Arquivos novos (13): `.ai/specs/ADR/ADR-0010-structural-architecture-standards.md`, `.ai/rules/structure-canon.md`, `.ai/rules/structural-constraints.md`, `.ai/blueprints/_schema.json`, `.ai/blueprints/README.md`, `.ai/blueprints/{web,saas,crm,mobile,game,ai-platform,telemetry,realtime}.json`.
+- Arquivos modificados: `.ai/server/aios-server.mjs` (+3 tools `aios_list_blueprints` / `aios_get_blueprint` / `aios_compose_structure` + funções listBlueprints/loadBlueprint/getBlueprint/resolveExtendsTransitive/mergeConstraints/composeStructure); `.ai/manifest.json` (+ ADR-0010 + canon + constraints + 8 blueprints + README + schema; bypass `.claude/.unlock` removido); `.ai/clients/README.md`, `.ai/clients/antigravity.md`, `AGENTS.md` (tabelas e capability matrices).
+- Validação: `lint-os.ps1` → Errors: 0; daemon expõe **38 tools** (era 34, +3 blueprints + 1 acumulado); `aios_list_blueprints` retornou 8 blueprints com extends e module_counts corretos; `aios_compose_structure({types:["saas","telemetry","realtime"]})` → resolveu extends transitivo para `["web","saas","telemetry","realtime"]`, mesclou em 20 folders e **23 modules únicos** (alerts, audit, auth, billing, broadcasts, devices, event-streams, events, feature-flags, fleet, geofencing, notifications, permissions, presence, providers, queues, subscriptions, telemetry, tenancy, tracking, trips, users, websockets), constraints merged (max_modules_before_split=20 como mais restritivo vencendo overrides 25/30 dos blueprints).
+- Pesquisa: confirmou state-of-the-art via WebSearch — Milan Jovanović "Vertical Slices Inside Modular Monolith" (milanjovanovic.tech); kgrzybek "modular-monolith-with-ddd" (github); Spectro Cloud "Will AI Turn 2026 into the Year of the Monorepo"; d4b.dev "AI agents in monorepos: what to configure differently".
+- Origem: análise externa apresentada pelo usuário ("Structural Architecture Standards" / "AI-Native Project Architecture Standards" — domain-first, vertical slice, blueprints híbridos, composition engine) + pedido explícito "Pesquise na internet se precisar".
+- Decisão associada: ADR-0010 (Structural Architecture Standards).
+
+## 2026-05-16 — Runtime Orchestrator Fase 5: Confidence System + Maturity Tracking
+- Descrição: implementada Fase 5 do RFC-0002 (ADR-0009) — última fase. `state.json` ganhou bloco `confidence` (categories: { name: { level: low|medium|high, reason, updated_at } }, default_level). 3 novas tools MCP: `aios_confidence_get({category?})`, `aios_confidence_set({category, level, reason})`, `aios_confidence_assess()` (heurística que olha state + project-state + ADRs e propõe níveis + maturity sem aplicar). `aios_compile_runtime_context` (ADR-0007) ganhou campo `low_confidence_flags: [{ category, reason }]` (top 3 categorias com level=low) para LLM ler diretamente do runtime-context. Maturity heuristic: empty (sem project_name + sem ADRs), minimal (project_name + ≤2 ADRs), partial (3-9 ADRs + project-state), mature (≥10 ADRs + >10 módulos + ≥3 syncs).
+- Arquivos novos: `.ai/specs/ADR/ADR-0009-confidence-system-maturity-tracking.md`.
+- Arquivos modificados: `.ai/server/aios-server.mjs` (+3 tools + funções ensureConfidenceBlock/confidenceGet/confidenceSet/confidenceAssess + low_confidence_flags em compileRuntimeContext); `.ai/runtime/state.schema.json` (+ bloco confidence); `.ai/manifest.json` (+ ADR-0009; bypass `.claude/.unlock` removido).
+- Validação: `lint-os.ps1` → Errors: 0; daemon expõe **34 tools** (era 31, +3 confidence); `aios_confidence_assess` → current_maturity=mature, suggested_maturity=partial (7 ADRs, 16 módulos, 0 smells, 0 syncs), suggestões: decisions=medium, architecture=high, modules=high, domain=medium, telemetry=low; `aios_confidence_set({category:"telemetry",level:"low",reason:"sem instrumentação"})` → registrado; `aios_compile_runtime_context` propagou flag `[{category:"telemetry",reason:"sem instrumentação"}]` em `low_confidence_flags`; runtime-context.json ainda em 1258 tokens (orçamento 4000).
+- Origem: continuação da refatoração aprovada — Fase 5 (final).
+- Decisão associada: ADR-0009 (Fase 5). RFC-0002 completamente implementado (todas as 4 fases de extensão + Fase 5 entregues).
+- Status global: Runtime Orchestrator entregue end-to-end (Fases 1-5). 34 tools MCP, 3 commands consolidados, 3 workflows declarativos, state persistente com lifecycle/confidence, execution contracts, pause/resume, branches, state compiler, drift detection, context layers, artifact index, maturity tracking.
+
+## 2026-05-16 — Runtime Orchestrator Fase 4: Intent Runtime para /work + Discovery Runtime ramificado + pause/resume
+- Descrição: implementada Fase 4 do RFC-0002 (ADR-0008). Workflow Engine ganhou 2 capacidades: (1) **pause_for** — step pode declarar `pause_for: { when: before|after, reason, prompt, expected_input }`; engine pausa, salva execução em `.ai/runtime/paused-executions/<execution_id>.json` (TTL 30 min), retorna `status: "paused"` + `execution_id` + `pause_info`; cliente externo retoma com `aios_resume_workflow({execution_id, user_input})`. (2) **branches** — step pode ter `branches: [{when: "<dotted.path> <op> <literal>", steps: [...]}, {default: true, steps: [...]}]`; engine expande inline antes de executar; operadores `==`, `!=`, `in`. 3 novas tools: `aios_resume_workflow`, `aios_list_paused_executions`, `aios_cancel_paused_execution`. Workflow `init` v3.0.0 ramificado (Discovery Runtime para projeto novo via `state.identity.maturity == "empty"`, com pause_for perguntando nome do projeto; Reverse Engineering Runtime como default para projetos existentes). Workflow `work` v3.0.0 (Intent Runtime completo): load_runtime_context → classify → route → search_memory → **pause: clarification_questions** → focused_context → **pause: plan_approval** → validate_lint → record_completion → post_snapshot.
+- Arquivos novos: `.ai/specs/ADR/ADR-0008-intent-runtime-discovery-branching.md`. Diretório `.ai/runtime/paused-executions/` criado on-demand pelo engine.
+- Arquivos modificados: `.ai/server/aios-server.mjs` (+3 tools + funções expandSteps/evalBranchCondition/savePausedExecution/pauseExecution/resumeWorkflow/listPausedExecutions/cancelPausedExecution; runWorkflow refatorado para chamar executeStepsFrom; novo namespace ctx.resumed_input); `.ai/workflows/_schema.json` (+ campos pause_for, branches no step); `.ai/workflows/init.json` v3.0.0 (com branches); `.ai/workflows/work.json` v3.0.0 (com 2 pause_for); `.ai/manifest.json` (+ ADR-0008; bypass `.claude/.unlock` removido).
+- Validação: `lint-os.ps1` → Errors: 0; daemon expõe **31 tools** (era 28); E2E pause/resume: `aios_run_workflow({name:"work"})` → `status: paused`, execution_id, pause `clarification_questions`; `aios_resume_workflow({execution_id, user_input:"ok"})` → 2ª pausa `plan_approval`; segundo resume → `status: ok`, todas 4 guarantees met (`runtime_context_compiled, task_classified, query_routed, memory_searched`), 10 steps.
+- Origem: continuação da refatoração aprovada (Fases 2→3→4→5 em sequência).
+- Decisão associada: ADR-0008 (Fase 4). Próxima: ADR-0009 (Fase 5 — Confidence System).
+
+## 2026-05-16 — Runtime Orchestrator Fase 3: State Compiler + Drift Detection + Context Layers + Artifact Index
+- Descrição: implementada Fase 3 do RFC-0002 (ADR-0007). 4 novas tools MCP: (1) `aios_compile_runtime_context` — Project State Compiler que consolida state.json + project-state + top-N módulos por conectividade + N ADRs recentes + memory rotating num único `.ai/runtime/runtime-context.json` otimizado (target ≤4000 tokens); (2) `aios_detect_drift` — Documentation Drift Detection que compara módulos do snapshot vs estado atual + identifica orphan modules sem referência em specs (severity: info); (3) `aios_get_context(layer)` — atalho para tiers `core | working | deep`; (4) `aios_artifact_list({type?, status?})` — catálogo de specs (ADR/RFC/PRD/SDD/RUNBOOKS/TASKS/BRD) + snapshots + packages + workflows, com auto-write de `.ai/artifacts/index.json`. Workflow `sync` v3.0.0 ganhou 2 steps finais (compile_runtime_context + detect_drift) e guarantees correspondentes (`runtime_context_compiled`, `drift_checked`).
+- Arquivos novos: `.ai/specs/ADR/ADR-0007-state-compiler-drift-context-layers-artifact-index.md`, `.ai/runtime/runtime-context.json` (gerado pelo compiler), `.ai/artifacts/index.json` (gerado pelo artifact_list).
+- Arquivos modificados: `.ai/server/aios-server.mjs` (+4 tools + funções compileRuntimeContext/detectDrift/getContextLayer/artifactList + helpers safeReadJson/safeReadText/estimateTokens/listAdrs + 2 novas guarantees em GUARANTEE_PROVIDERS + import readdirSync); `.ai/workflows/sync.json` v3.0.0; `.ai/manifest.json` (+ ADR-0007; bypass `.claude/.unlock` removido).
+- Validação: `lint-os.ps1` → Errors: 0; daemon expõe **28 tools** (era 23); `aios_compile_runtime_context` gerou runtime-context.json com **1116 tokens** (dentro do orçamento de 4000); `aios_detect_drift` contra snapshot `phase3-validate` → 16 módulos persistidos, 0 added/removed, 16 orphan_modules_no_spec_reference (esperado: runtime é código novo sem SDD); `aios_get_context({layer:"working"})` retornou identity + lifecycle + 3 ADRs recentes; `aios_artifact_list({})` retornou 12 itens (5 ADRs + 3 workflows + 2 RFCs + 1 snapshot + 1 package). Fix mid-flight: snapshot v0.1 salva `state.json` não `project-state.json` — drift agora tenta ambos.
+- Origem: continuação da refatoração aprovada em 2026-05-16 ("Adotar TUDO incluindo Confidence System" + "Tudo em sequência").
+- Decisão associada: ADR-0007 (Fase 3). Próxima: ADR-0008 (Fase 4 — Intent Runtime + Discovery Runtime ramificado).
+
+## 2026-05-16 — Runtime Orchestrator Fase 2: Runtime State + Lifecycle + Context TTL + Execution Contracts + Safety Rule
+- Descrição: implementada Fase 2 do RFC-0002 (extensão do RFC-0001). Persistência operacional em `.ai/runtime/state.json` (versionado, schema-validated): identity (project_name, maturity, stack), lifecycle (phase ∈ discovery|planning|implementation|stabilization|production, mode ∈ readonly|analysis|execution|validation), persistent (architecture_decisions_refs, rules_refs), rotating (ttl_days, active_focus, recent_errors, open_questions), workflow_history (últimas 20 execuções). 4 novas tools MCP (`aios_state_get`, `aios_state_set`, `aios_state_advance`, `aios_state_reset`). Workflow engine estendido: schema ganhou `guarantees: []` (lista auditável de invariantes) e `safety: { project_files_readonly }`; engine valida cumprimento de guarantees após cada run via mapeamento fixo `GUARANTEE_PROVIDERS` (10 garantias mapeadas para tools provedoras); relatório inclui `declared_guarantees`, `guarantees_met`, `unmet_guarantees`; status pode ser `ok | ok_with_warnings | aborted`. Substituição de template em workflow ganhou `${state.X}`. Workflow history é gravado automaticamente em `state.workflow_history` (FIFO 20).
+- Arquivos novos: `.ai/specs/RFC/RFC-0002-runtime-orchestrator-extended.md`, `.ai/specs/ADR/ADR-0006-runtime-state.md`, `.ai/runtime/state.schema.json`, `.ai/runtime/state.json` (inicializado para AI OS Harness em fase implementation).
+- Arquivos modificados: `.ai/server/aios-server.mjs` (+4 tools state + helpers loadState/saveState/getByPath/setByPath/stateGet/stateSet/stateAdvance/stateReset/recordWorkflowHistory; runWorkflow agora popula `ctx.state`, valida guarantees, grava history); `.ai/workflows/_schema.json` (campos `guarantees`, `safety`); `.ai/workflows/{init,sync,work}.json` (v2.0.0: declaram guarantees, safety, e adicionam step final de state advance/set); `.ai/manifest.json` (+ state schema + state.json + RFC-0002 + ADR-0006; bypass `.claude/.unlock` removido).
+- Validação: `lint-os.ps1` → Errors: 0, Warnings: 3 (pré-existentes); daemon expõe **23 tools** (era 19); `aios_state_get({path:"lifecycle"})` retornou `{phase:"implementation",mode:"execution"}`; `aios_run_workflow({name:"work",input:{intent:"fase 2 smoke test"}})` → `status: ok`, 5/5 guarantees met (`task_classified, query_routed, core_loaded, memory_searched, context_compiled`), 6/6 steps ok; `state.json` atualizado automaticamente com `rotating.active_focus="fase 2 smoke test"` e nova entrada em `workflow_history`.
+- Origem: análise externa apresentada pelo usuário em 2026-05-16 (após Fase 1); usuário aprovou "Adotar TUDO incluindo Confidence System (Fase 5)" + "Tudo em sequência (2 → 3 → 4) até acabar".
+- Decisão associada: ADR-0006 (Fase 2). Próxima: ADR-0007 (Fase 3 — State Compiler + Drift + Context Layers + Artifact Index).
+
+## 2026-05-16 — Runtime Orchestrator Fase 1: Workflow Engine MVP + 3 commands consolidados
+- Descrição: implementada Fase 1 do Runtime Orchestrator (ADR-0004). Workflow Engine determinístico orquestra as 17 tools MCP primitivas via workflows JSON declarativos. Substituídos os 8 slash commands granulares (`/analyze`, `/audit`, `/compact-memory`, `/context`, `/load-os`, `/os-status`, `/promote-learning`, `/snapshot`) por 3 consolidados (`/init`, `/sync`, `/work`). Cada command chama `aios_run_workflow({ name })` que carrega `.ai/workflows/<name>.json`, itera steps com substituição de variáveis (`${input.X}`, `${timestamp}`), suporta `on_error: abort|continue`, retorna relatório JSON com status/duração/preview por step. Zero novas dependências (JSON parser built-in Node).
+- Arquivos novos: `.ai/specs/RFC/RFC-0001-runtime-orchestrator.md` (visão das 4 fases), `.ai/specs/ADR/ADR-0004-runtime-orchestrator.md` (decisão consolidada), `.ai/specs/ADR/ADR-0005-workflow-engine.md` (Fase 1), `.ai/workflows/_schema.json` + `init.json` + `sync.json` + `work.json`, `.claude/commands/{init,sync,work}.md`.
+- Arquivos modificados: `.ai/server/aios-server.mjs` (+2 tools: `aios_run_workflow`, `aios_list_workflows`; +helpers `resolveTemplateValue`, `resolveArgs`, `loadWorkflow`, `runWorkflow`, `listWorkflows`); `.ai/manifest.json` (8 commands antigos removidos da `required_files`, 3 novos + 4 workflows + 3 specs adicionados — bypass via `.claude/.unlock` temporário, removido depois); `AGENTS.md`, `.ai/clients/{README,antigravity}.md`, `.ai/runtime.md` (tabelas: 8 commands antigos → 3 novos; 17 → 19 tools).
+- Arquivos deletados (8): `.claude/commands/{analyze,audit,compact-memory,context,load-os,os-status,promote-learning,snapshot}.md`.
+- Validação: `lint-os.ps1` → Errors: 0, Warnings: 3 (todos pré-existentes); daemon HTTP `aios_list_workflows()` → 3 workflows listados; `aios_run_workflow({name: "work", input: {intent: "corrige um bug no login que ignora MFA"}})` → status `ok`, 5 steps em ~1700ms total (classify → simple, route → 9 arquivos via rota "Bugs e erros", load_core → 26562 chars, search_memory → [], build_focused_context → 5 módulos / ~1250 tokens estimados).
+- Origem: análise externa apresentada pelo usuário sobre AI Engineering Runtime vs MCP puro; síntese filtrada e refinada em RFC-0001. Decisões confirmadas via AskUserQuestion (sessão 2026-05-16): "Fases 1+2+3+4 (refatoração completa)" + "Substituir tudo pelos 3 novos".
+- Decisão associada: ADR-0004 (consolidada) + ADR-0005 (Fase 1). Fases 2-4 pendentes (ADR-0006, 0007, 0008).
+
+## 2026-05-16 — Rename de tools MCP de dot-namespace para underscore (compat Gemini/Antigravity)
+- Descrição: Antigravity (Gemini API) rejeitou todas as 17 tools `aios.*` com erro `tool name mcp_ai-os_aios.X violates ^[a-zA-Z0-9_-]{1,64}$` — o regex de Function Declaration do Google não aceita ponto. Renomeação em massa de `aios.<tool>` → `aios_<tool>` no servidor MCP + todas as referências (slash commands, docs, settings). Compat preservada com Claude Code/Cursor/Cline (todos aceitam underscore). Decisão registrada via AskUserQuestion (usuário escolheu "Renomear tudo para underscore"). 23 arquivos atualizados via find-replace literal `aios.` → `aios_` (sem falsos-positivos confirmados via Grep prévio).
+- Arquivos: `.ai/server/aios-server.mjs` (17 tools renomeadas + 17 handlers); `.claude/commands/{analyze,context,snapshot,os-status,load-os,compact-memory,promote-learning}.md`; `.claude/settings.local.json` (curl commands); `AGENTS.md`; `.ai/clients/{README,antigravity,claude-code}.md`; `.cursor/rules/ai-os.mdc`; `.ai/{runtime,README}.md`; `.ai/server/README.md`; `.ai/specs/ADR/ADR-0002-typescript-runtime.md`; `.ai/evolution/improvements.md`; `.ai/agents/{tech-lead,reviewer,architect,product-manager}.md`.
+- Validação: `lint-os.ps1` → Errors: 0, Warnings: 3 (pré-existentes). Daemon HTTP em 47782 → `/tools` lista `aios_get_core_bundle`, `aios_route_query`, `aios_classify_task`, ... (todas com underscore); `/health` → `status: ok, version: 4.1.0, runtime_v0_1: true`. Grep final `aios\.[a-z]` → "No files found" (zero ocorrências de dot-namespace restantes). Validação efetiva no Antigravity: usuário precisa clicar Refresh no painel MCP (daemon spawnado pelo Antigravity foi morto para forçar reload).
+- Origem: erro reportado pelo usuário em screenshots do painel "Manage MCP servers" do Antigravity ("Error: tool name ... violates ^[a-zA-Z0-9_-]{1,64}$").
+- Decisão associada: n/a — escolha técnica documentada em `improvements.md` se quiser ADR futuro; por ora, mudança é mecânica e reversível.
+
+## 2026-05-16 — Portabilidade do AI OS para múltiplas IDEs e CLIs
+- Descrição: criados entry-points específicos para cada IDE/CLI alvo (Cursor, Windsurf, Cline, Continue, Copilot, TRAE, Antigravity/Gemini CLI, Codex/Aider via AGENTS.md), além de configs MCP de escopo projeto onde suportado. Estratégia: stub curto (12-18 linhas) referenciando `.ai/INDEX.md` (sem duplicar CORE), respeitando convenção que cada ferramenta auto-carrega. Catálogo canônico em `.ai/clients/` com README + 9 docs por IDE (capability matrix, ativação em 3 passos, snippet inline, validação, troubleshooting, limitações).
+- Arquivos novos (22): `AGENTS.md`, `.cursorrules`, `.cursor/rules/ai-os.mdc`, `.cursor/mcp.json`, `.windsurfrules`, `.clinerules`, `.continue/rules/ai-os.md`, `.continue/config.yaml`, `.github/copilot-instructions.md`, `.trae/rules/project_rules.md`, `.gemini/settings.json`, `.ai/clients/README.md`, `.ai/clients/{claude-code,cursor,windsurf,cline,continue,copilot,trae,antigravity,codex-aider-cli}.md`, `.ai/clients/snippets/{mcp-stdio,mcp-http,mcp-absolute-paths}.json`. Zero modificações em `.ai/` core (CONTRACT, ROUTER, rules, operating-system, manifest intactos).
+- Validação: `lint-os.ps1` → Errors: 0, Warnings: 3 (todos pré-existentes em `context/project-state.md`, `context/packages/*`, `snapshots/*`). Daemon HTTP: `node .ai/server/aios-server.mjs --http` + `curl /health` → 200 OK com `runtime_v0_1: true`, version 4.1.0. Validação por IDE individual depende do usuário ter cada ferramenta instalada — instruções de teste end-to-end em cada `.ai/clients/<ide>.md`.
+- Origem: request direto do usuário ("Eu só estou conseguindo usar os comando pelo painel e chat da Claude Code, preciso que tudo funcione em outras ferramentas tbm").
+- Decisão associada: n/a (sem ADR — escolha do usuário foi não tocar em `manifest.json` para registrar `client_adapters`; pode virar entrega futura).
+- Plano: arquivado no histórico local do Claude Code (não versionado).
+- Pesquisas: confirmadas via WebSearch — Cursor MDC frontmatter (`description`/`globs`/`alwaysApply`); Windsurf MCP em `%USERPROFILE%\.codeium\windsurf\mcp_config.json`; TRAE v1.3+ suporta `.trae/rules/project_rules.md` + MCP.
+
+## 2026-05-15 — Framework v4.0.0: AI-DOS completo (Context Engine + Multi-agent + Spec-Driven + Pipeline)
+- Descrição: evolução major do `.ai/` de framework de regras para **AI Development Operating System completo**, paridade com processo de empresas maduras. Adicionadas 6 camadas: (1) `governance/` com princípios inegociáveis + DoR/DoD + 10 quality gates + security/architecture policies; (2) `agents/` com 10 especialistas (founder, product-manager, architect, tech-lead, backend-engineer, frontend-engineer, qa-engineer, security-engineer, sre-engineer, reviewer, researcher) com contratos I/O; (3) `specs/` com templates canônicos (PRD, SDD, ADR, RFC, BRD, Runbook, Task); (4) `context/` Context Engine vivo separado da memória histórica (10 docs); (5) `core/pipeline/execution-engine.md` com pipeline IDEIA→DISCOVERY→PRD→ARCH→SDD→TASKS→IMPL→TEST→REVIEW→DEPLOY→OBSERVE→APRENDIZADO e gates G1-G10; (6) pastas-irmãs `product/`, `architecture/` (C4 + threat modeling), `engineering/` (com observability/incident-response), `execution/` (backlog/sprint/roadmap/milestones).
+- Arquivos: ~50 novos files. `INDEX.md` v4.0.0, `ROUTER.md` com 7 rotas novas, `manifest.json` v4.0.0 com required_files de 69 → 137. ADR-0003 documenta a decisão completa. Entrada v4.0.0 em `agent-evolution.md`.
+- Validação: `lint-os.ps1` → 0 errors, 0 warnings; 137/137 required_files presentes.
+- Origem: pedido do usuário (Spec-Driven Development, Context Engineering, multi-agent, "empresa de uma pessoa").
+- Decisão associada: ADR-0003.
+
+## 2026-05-15 — Framework v3.4.0: guard-edit com split em subcomandos + allowlist read-only (IMP-002 aplicado)
+- Descrição: `.ai/hooks/guard-edit.{ps1,sh}` reescritos para tratar comandos compostos corretamente. Antes: bloqueava qualquer comando que tivesse write verb + path protegido juntos, mesmo em subcomandos diferentes ou com write verb como argumento (`grep Set-Content settings.json` bloqueava sem razão). Agora: (1) **split** do comando por `&&`/`||`/`;`/`|`/newline respeitando aspas; (2) **allowlist de prefixos read-only** (grep/cat/head/tail/ls/find/wc/stat/file/which/echo/printf/Get-Content/Get-ChildItem/Select-String/Test-Path/Resolve-Path/Get-Item/gci/gc/sls) — subcomando que começa com um destes nunca bloqueia, EXCETO se houver redirect (`>` ou `>>`) no mesmo subcomando. (3) Os 11 paths protegidos permanecem inalterados; comportamento Edit/Write/NotebookEdit idêntico.
+- Arquivos tocados: `.ai/hooks/guard-edit.ps1` (reescrito ~30 linhas), `.ai/hooks/guard-edit.sh` (reescrito split via awk + read-only prefix regex), `.ai/evolution/improvements.md` (IMP-002 status `aplicado`), `.ai/evolution/agent-evolution.md` (entrada v3.4.0 — pendente abaixo). Sincronizado para `sistema-de-diesel/.ai/hooks/`.
+- Validação: **38/38 cenários PASS** (20 PowerShell + 18 Bash em sandbox `mktemp -d`). Casos novos cobertos: `rm -rf dist && cat .ai/manifest.json` (não bloqueia), `grep Set-Content .claude/settings.json` (não bloqueia), `echo x > .claude/settings.json && ls` (bloqueia subcomando 1), `cat foo && rm .ai/CONTRACT.md` (bloqueia subcomando 2), `cat /dev/null > .ai/CONTRACT.md` (bloqueia: redirect anula allowlist), `cat .ai/CONTRACT.md | grep foo` (não bloqueia), unlock bypass funcional.
+- Origem: false positives observados na sessão (usuário comentou explicitamente: "refinar o guard contra false positives").
+- Decisão associada: n/a (refinamento técnico de regra existente; IMP-002 documentado em `evolution/improvements.md`).
+- Pendência: nenhuma deste ciclo.
+
+## 2026-05-14 — Framework v3.3.0: tech-mapping protocol + `.ai/` instalado no Strak + 3 fixes técnicos
+- Descrição: framework pai ganhou **protocolo de tech-mapping** (`.ai/bootstrap/tech-mapping.md`, novo) — bootstrap (novo OU existente) agora produz `operating-system/architecture.md` organizado por especificação técnica (Frontend, Backend, BD, Infra, Integrações, Tools, APIs, MCPs, Dados/Samples, Pendências de Mapeamento). Caso real de aplicação: `.ai/` instalado no subprojeto Strak com architecture.md preenchido nesse formato. ADR-0002 registra a decisão. Em paralelo, 3 melhorias no Strak: chunking do bundle (ADR-0002 do Strak, manualChunks), scripts `server/scripts/*` robustecidos a qualquer cwd (paths relativos a `__dirname`), `.env` confirmado já untracked (não havia ação a fazer).
+- Arquivos tocados (framework pai): `.ai/bootstrap/tech-mapping.md` (novo), `.ai/bootstrap/existing-project.md`, `.ai/bootstrap/new-project.md`, `.ai/operating-system/folder-structure.md`, `.ai/INDEX.md`, `.ai/manifest.json`, `.ai/ROUTER.md`, `.ai/memory/decisions.md` (ADR-0002 novo), `.ai/evolution/agent-evolution.md` (entrada v3.3.0).
+- Arquivos tocados (Strak): instalação completa do `.ai/` + entry points (`CLAUDE.md`/`GEMINI.md`/`GPT.md`) + `.claude/` (commands + settings.json + settings.unix.json); `.ai/memory/project-context.md` populado; `.ai/operating-system/architecture.md` reescrito como mapa técnico; `.ai/memory/decisions.md` com ADR-0001 (adoção do OS) e ADR-0002 (chunking); `vite.config.ts` (manualChunks); 5 scripts em `server/scripts/` (paths robustos).
+- Validação:
+  - tsc front Strak → 0 erros
+  - tsc server Strak → 0 erros
+  - vite build Strak → OK em 19.85s. Maior chunk era 1523 KB; agora maior é `pdf` 422 KB (138 KB gzip), `app` 388 KB (118 KB gzip), `charts` 302 KB, `xlsx` 283 KB, `maps-leaflet` 154 KB, `storage` 97 KB, `motion` 96 KB, `date` 46 KB.
+  - vitest Strak → 32/32 PASS
+  - `lint-os.ps1` framework pai → 0 errors, 0 warnings
+  - `lint-os.ps1` Strak → 0 errors, 0 warnings
+- Origem: pedido direto do usuário em duas partes — (a) "instalar `.ai/` no Strak para que ele aprenda tudo sobre o sistema, sendo o especialista dele"; (b) "lembre que na sua estrutura de orientação deve ter um processo interno que toda vez que um projeto novo é iniciado ou se for um projeto existente, vc analisa a estrutura e organiza tudo por especificações técnicas".
+- Decisões associadas:
+  - Framework pai: **ADR-0002** — Tech-mapping obrigatório no bootstrap.
+  - Strak: **ADR-0001** — Adoção do AI OS no Strak; **ADR-0002** (do Strak) — Code-splitting via manualChunks.
+- Pendência: nenhuma deste ciclo. Strak agora tem cérebro persistente próprio. Workings em `Arquivos Base/` (11 MB) preservados, gitignored. `.unlock` foi usado e removido conforme protocolo.
+
+## 2026-05-14 — Bootstrap + saneamento do subprojeto `sistema-de-diesel/` (Strak)
+- Descrição: subprojeto separado em `sistema-de-diesel/` (sem `.ai/` próprio) recebeu primeira passagem de bootstrap dialógico — diagnóstico read-only (tsc/build/vitest), correção de 8 erros TS em `server/src/infra/database.ts` (sobrecarga de `pg.Pool.query`), atualização de 2 testes desalinhados com a regra em `src/services/__tests__/analysis.test.ts` (Null Island filter + threshold de 3 records consecutivos), remoção do framework legado `.agent/` (Antigravity Kit, 2.1 MB) por ordem do usuário, exclusão de leftovers (`metadata.json`, `test-db.cjs` na raiz, `server/test_upload.js` com path hardcoded), reorganização de 6 scripts ad-hoc em `server/scripts/`, padronização do nome para **Strak** (System Track) no README, criação de `server/.env.example` baseado no README, ajustes no `.gitignore` (Arquivos Base/, samples/, .ai/.runtime/).
+- Arquivos tocados (no subprojeto, não no `.ai/`): `sistema-de-diesel/server/src/infra/database.ts`, `sistema-de-diesel/src/services/__tests__/analysis.test.ts`, `sistema-de-diesel/README.md`, `sistema-de-diesel/.gitignore`, `sistema-de-diesel/server/.env.example` (novo); removidos: `.agent/` (recursivo), `metadata.json`, `test-db.cjs`, `server/test_upload.js`, `dist/`; movidos para `server/scripts/`: `check-count.cjs`, `check-indexes.cjs`, `test-db.ts`, `test-perf.cjs`, `test-sql.cjs`, `run-schema.ts`.
+- Validação: tsc front → 0 erros; tsc server → 0 erros (era 8); vite build → OK em ~23s; vitest run → **32/32 PASS** (era 30/32).
+- Origem: pedido direto do usuário ("ajude a estruturar e corrigir problemas existentes").
+- Decisão associada: n/a (sem ADR — o subprojeto não tem `.ai/` próprio e os ADRs do framework não se aplicam).
+- Pendência registrada: subprojeto Strak ficou **sem cérebro persistente** após remoção do `.agent/`. Para continuar a evolução com memória, instalar `.ai/` AI OS dentro de `sistema-de-diesel/` em sessão futura. Per `dont.md` regra 9 (não cruzar contexto entre projetos), o contexto técnico do Strak não deve viver na memória do framework — só nesta linha referencial.
+
+## 2026-05-14 — v3.2.0: IMP-001 aplicado + daemon validado end-to-end
+- Descrição: fechado IMP-001 (Bash bypass do guard). Reescritos `guard-edit.{ps1,sh}` limpos (estavam corrompidos), adicionado branch Bash com detecção de verbos de escrita, suporte a `.claude/.unlock` para override autorizado. Matcher em `settings.json` e `settings.unix.json` atualizado para `Edit|Write|NotebookEdit|Bash`. Corrigido bug do `start-os.ps1` em paths com espaço. Daemon HTTP subido e validado em 8 endpoints (health, tools, classify_task, route_query, lint, get_core_bundle, validate_audit, search_memory). Daemon parado ao final.
+- Arquivos: `.ai/hooks/guard-edit.ps1` (reescrito), `.ai/hooks/guard-edit.sh` (reescrito), `.claude/settings.json` (matcher), `.claude/settings.unix.json` (matcher), `.ai/scripts/start-os.ps1` (fix path-com-espaço), `.ai/memory/decisions.md` (ADR-0001 novo), `.ai/evolution/improvements.md` (IMP-001 → status aplicado), `.ai/evolution/agent-evolution.md` (entrada v3.2.0).
+- Validação: sintaxe PS+SH OK; 19 cenários de smoke-test dos hooks (9 PS + 10 SH) → 19/19 PASS; 8 endpoints do daemon HTTP → todos OK; `lint-os.ps1` → 0 errors, 0 warnings.
+- Origem: solicitação direta do usuário ("IMP-001 ... pode realizar essa pendencia").
+- Decisão associada: ADR-0001 (primeiro ADR do projeto).
+
+## 2026-05-14 — Finalização do AI OS v3.1.0 (README + limpeza)
+- Descrição: criado `.ai/README.md` (documentação humana completa: o que é, instalação, daemon MCP, hooks, slash commands, memória, troubleshooting, filosofia). Removidos os dois scripts temporários de migração na raiz (`_migrate.mjs`, `_migrate2.mjs`) deixados após a consolidação em `.ai/` na v3.0.
+- Arquivos: `.ai/README.md` (criado), `_migrate.mjs` (removido), `_migrate2.mjs` (removido)
+- Validação: `scripts/lint-os.ps1` → Errors: 0, Warnings: 0. Todos os 72 `required_files` do manifest presentes.
+- Origem: solicitação direta do usuário ("deixar tudo pronto e no README colocar todas as orientações").
+- Decisão associada: n/a (README era `required_file` previamente ausente).
+- Open: IMP-001 (Bash bypass do guard-edit) permanece `proposto` — não tocado nesta entrega; usuário não solicitou.