oxe-cc 1.10.0 → 1.12.0

package/CHANGELOG.md

@@ -4,6 +4,126 @@ Todas as versões seguem [Semantic Versioning](https://semver.org/). As mudança
 
 ---
 
+## [1.12.0] — 2026-05-12
+
+### Agent Mode, Swarm Mode, Memory Kernel & Learning Kernel
+
+Esta release transforma o OXE em um sistema autônomo orientado a objetivos. O usuário escreve `/oxe <objetivo em linguagem natural>` e o Conductor decide automaticamente o fluxo, os agentes e a estratégia de execução — sem precisar escolher comandos manualmente.
+
+#### Conductor Agent (`oxe/workflows/conduct.md`)
+
+- novo workflow que age como ponto de entrada para objetivos de implementação em linguagem natural
+- classifica complexidade em três scores: simples | médio | complexo
+- recupera memória relevante das 5 camadas (runtime_state, session_memory, project_memory, lessons, observations)
+- seleciona personas aplicáveis por `intent_tags` (backend → executor/architect, frontend → ui-specialist, storage → db-specialist, etc.)
+- decide automaticamente **Agent Mode** (simples/médio) ou **Swarm Mode** (complexo/multi-domínio)
+- `oxe/workflows/oxe.md` e `route.md` atualizados: objetivos de implementação redirecionam para `conduct.md`
+
+#### Agent Mode (`oxe/workflows/agent-mode.md`)
+
+- Conductor age sozinho com a persona selecionada para objetivos de 1–2 domínios e ≤ 8 arquivos
+- grava `AGENT-SESSION.json` em `.oxe/agent/` com intent, skills, tool_calls e reconciliação
+- discovery mínimo antes de mutar: confirma write_set, padrões, riscos
+- se write_set exceder threshold para `intent_score=simples`, eleva automaticamente para Swarm Mode
+- `RECONCILIATION.md` gerado ao final com arquivos alterados e objective_satisfied
+
+#### Swarm Mode (`oxe/workflows/swarm-mode.md`)
+
+- orquestração de 5 papéis em pipeline controlado: Scout → Coordinator → Builder(s) → Reviewer → Verifier
+- **Scout** (`oxe/workflows/swarm/scout.md`): produz CODEBASE-MAP.md, PATTERNS.md, RISK-MAP.md, FILE-CANDIDATES.json e TEST-CANDIDATES.json antes de qualquer mutação
+- **File Ownership** (`FILE-OWNERSHIP.json`): cada Builder declara `write_set`; conflitos → Coordinator serializa em waves sequenciais
+- **Board** (`oxe/workflows/swarm/board.md`): BOARD.md e BOARD.json atualizados em tempo real por fase
+- **Quality Gates** automáticos: arquivo high-risk → gate humano; cobertura abaixo de threshold → gate auto
+- **Reviewer**: produz `.oxe/swarm/reviews/<task_id>-REVIEW.md` por tarefa antes de integração
+- **Verifier/Integrator**: FINAL-INTEGRATION.md com evidências completas e VERIFY.md atualizado
+- novo schema `oxe/schemas/swarm-run.schema.json` (JSON Schema Draft-07) para SWARM-RUN.json
+
+#### Memory Kernel (`oxe/workflows/memory.md` + `bin/lib/oxe-memory-kernel.cjs`)
+
+- ativa o modelo de 4 camadas de memória já definido em `oxe-operational.cjs:2364`
+- `retrieveMemory(projectRoot, intentTags, phase, objective)`: filtra fragmentos por relevância e phase; ranking por score (tag match, impacto, frequência)
+- `saveContextPack()`: grava context pack em `.oxe/agent/MEMORY-INJECTIONS.md` ou `.oxe/swarm/DECISIONS.md` + snapshot auditável em `.oxe/memory/retrieved/<phase>.md`
+- novos templates: `REPO-MEMORY.template.md` (decisões cross-session, pitfalls, preferências, padrões validados) e `MEMORY-INDEX.template.json`
+
+#### Learning Kernel (`oxe/workflows/distill.md` + `bin/lib/oxe-learning-kernel.cjs`)
+
+- detecta padrões automaticamente ao final de cada run: blocker_pattern, success_pattern, anti_pattern, file_conflict_pattern, integration_gap, scope_expansion
+- atualiza `LESSONS.md` com dedup correto (Frequência++ para lições repetidas, não duplicatas)
+- popula `lessons-metrics.json` com `outcomes` e `success_rate` por lição; deprecação automática se `success_rate < 0.5` e `apply_count >= 3`
+- enfileira skill candidatas em `.oxe/learning/PROMOTION-QUEUE.md` quando padrão aparece em 2+ runs
+- atualiza `REPO-MEMORY.md` com decisões arquiteturais e pitfalls novos
+
+#### Skill Runtime (`bin/lib/oxe-skill-loader.cjs`)
+
+- `loadSkill(id, projectRoot)`: resolve por ordem de precedência projeto → capabilities → global
+- `listSkills()`: enumera active/proposed/archived/global por diretório
+- `selectPersonasForIntent(intentTags, projectRoot)`: mapeia intent_tags para personas primárias e secundárias
+- `recordSkillsLoaded()`: grava snapshot das personas ativas em `.oxe/agent/SKILLS-LOADED.json`
+
+#### Event Bus (`bin/lib/oxe-event-bus.cjs`)
+
+- `OXE-EVENTS.ndjson` passa a ser efetivamente populado durante runs (antes: schema definido, nunca emitido)
+- helpers tipados: `emitRunStarted`, `emitWorkItemCompleted`, `emitWorkItemBlocked`, `emitRunCompleted`, `emitGateRequested`, `emitGateResolved`, `emitLessonPromoted`, `emitRetroPublished`
+- `readEvents(projectRoot, filters)`: leitura com filtro por `run_id`, `type`, `since`
+
+#### Runtime contracts
+
+- `workflow-runtime-contracts.json` atualizado com contratos semânticos para todos os 5 novos workflows (conduct, agent-mode, swarm-mode, memory, distill)
+- `help.md` router: nova entrada de prioridade máxima para objetivos de implementação → `/oxe <objetivo>` → Conductor
+
+#### Templates adicionados
+
+- `.oxe/templates/AGENT-SESSION.template.json`
+- `.oxe/templates/swarm/SWARM-RUN.template.json`
+- `.oxe/templates/swarm/FILE-OWNERSHIP.template.json`
+- `.oxe/templates/swarm/BOARD.template.md`
+- `.oxe/templates/swarm/QUALITY-GATES.template.md`
+- `.oxe/templates/REPO-MEMORY.template.md`
+- `.oxe/templates/MEMORY-INDEX.template.json`
+- `.oxe/templates/learning/CANDIDATES.template.ndjson`
+- `.oxe/templates/learning/PROMOTION-QUEUE.template.md`
+
+---
+
+## [1.11.0] — 2026-05-06
+
+### Spec Lifecycle Automation & CLI Gaps
+
+Esta release fecha os gaps de adoção identificados na análise de maturidade v1.10.0, com foco em automação do ciclo de vida do SPEC, configuração de provider e tolerância de formato no parser de planos.
+
+#### Automação do ciclo de vida (SPEC.md)
+
+- nova função `applySpecChecklistSync` em `oxe-operational.cjs`: ao executar `runtime project` com um run `completed`, marca automaticamente `**DoD Wave N:**` e seções MVP/v0.x.x do checklist no `SPEC.md` com `[x]`
+- v1.0.0 checklist não é marcado automaticamente — requer sign-off explícito
+- exportada no módulo para testes de integração e uso programático
+
+#### CLI — `runtime execute`
+
+- novo flag `--agents-plan <path>`: override explícito para localização do `plan-agents.json`, com prioridade sobre detecção automática por sessão e raiz do projeto
+- novo flag `--api-key-env <VAR>`: lê API key de variável de ambiente nomeada em vez de `OXE_LLM_API_KEY`
+- novo subcomando `runtime configure`: wizard interativo que persiste `baseUrl`, `model`, `apiKey` em `.oxe/config.json` (seção `runtime.provider`)
+
+#### Provider LLM auto-wired
+
+- `createExecutionContext` passa a instanciar `PolicyEngine.fromConfigFile()` automaticamente quando `.oxe/config.json` contém seção `runtime.policy`
+- `loadRuntimeProviderConfig` / `saveRuntimeProviderConfig` exportados de `oxe-operational.cjs`
+- health checks de `runtime.provider` e `runtime.policy` adicionados ao `oxe-cc status`
+
+#### Parser de planos — tolerância de formato (Gap E)
+
+- `parsePlan` agora aceita `**Verificação:**`, `**Verify command:**` e `**Verification:**` além do formato `Verificação:` sem negrito
+- planos gerados por LLM com markdown bold deixam de silenciosamente omitir verify commands
+
+#### Spec-criteria enrichment (Gap B)
+
+- `compileExecutionGraphFromArtifacts` extrai comandos backtick dos campos `howToVerify` dos critérios de aceite da SPEC e os anexa a `node.verify.command` quando ausente no PLAN
+
+#### Testes e benchmark
+
+- novo `test:runtime-llm` (`scripts/test-runtime-llm.cjs`): valida `LlmTaskExecutor` end-to-end com LLM real; skipa automaticamente quando `OXE_LLM_API_KEY` não está definido
+- novo `benchmark:autonomy` (`scripts/benchmark-autonomy.cjs`): 5 fixtures de referência (simple → medium → parallel), mede taxa de compilação→execução→verify sem intervenção; saída em `.oxe/release/benchmark-autonomy-report.json`
+- novos testes: `gap-spec-enrichment.test.cjs` (5 casos) e `gap-spec-checklist-sync.test.cjs` (4 casos)
+
 ## [1.10.0] — 2026-05-05
 
 ### Operational Maturity