oxe-cc 1.8.0 → 1.9.1

package/AGENTS.md

@@ -99,4 +99,4 @@ Os wrappers por runtime podem carregar metadata cognitiva (`oxe_reasoning_mode`,
 
 Para `execute` e `verify`, o comportamento atual esperado é **runtime-first**: se `oxe-cc runtime` estiver disponível, preferir `runtime compile/project/verify/gates` e tratar markdown como projeção derivada; se o runtime não puder ser executado, declarar `fallback legado` explicitamente.
 
-Para publicação, o gate local esperado passa por `oxe-cc doctor --release --write-manifest`. Essa verificação deve falhar se houver drift de versão, topo inválido no `CHANGELOG`, ausência da árvore canónica `oxe/`, `workflow-runtime-contracts.json` inválido, wrapper dirty após sync, runtime não compilado ou ausência dos relatórios `.oxe/release/*.json` exigidos pela release.
+Para publicação, o gate local esperado passa por `npm test`, `npm run release:pack-check` e `oxe-cc doctor --release --write-manifest`. Essa verificação deve falhar se houver drift de versão, topo inválido no `CHANGELOG`, ausência da árvore canónica `oxe/`, `workflow-runtime-contracts.json` inválido, wrapper dirty após sync, runtime não compilado, pacote npm com artefatos indevidos ou ausência dos relatórios `.oxe/release/*.json` exigidos pela release, incluindo `runtime-real-report.json` e, a partir da `1.9.1`, `multi-agent-real-report.json`.

package/CHANGELOG.md

@@ -4,6 +4,100 @@ Todas as versões seguem [Semantic Versioning](https://semver.org/). As mudança
 
 ---
 
+## [1.9.1] — 2026-05-04
+
+### Multi-Agent Real
+
+Esta release endurece a coordenação multi-agent sobre workspaces reais, sem abrir novos comandos públicos.
+
+- multi-agent real passa a exigir workspaces isolados `git_worktree` para modos `parallel`, `competitive` e `cooperative`
+- `runtime execute` valida `plan-agents.json` antes de iniciar agentes e usa `GitWorktreeManager` por padrão no caminho multi-agent
+- novo artefato por run `.oxe/runs/<run_id>/workspace-merge-report.json` com worktrees, ownership, merge blockers e readiness
+- `runtime agents status --json`, `status --json` e recovery passam a expor merge readiness, blockers, arbitration e worktrees órfãos
+- novo `npm run test:multi-agent-real` gera `.oxe/release/multi-agent-real-report.json` usando repositório git temporário com worktrees reais
+- `doctor --release` passa a exigir `multi-agent-real-report.json` em versões `>=1.9.1`
+
+## [1.9.0] — 2026-05-04
+
+### Runtime Real Maturity
+
+Esta release eleva a maturidade prática do OXE com foco em prova determinística do ciclo real `spec -> plan -> execute -> verify -> status/doctor`, sem abrir novos comandos públicos.
+
+#### Runtime real
+
+- nova suíte `test:runtime-real` valida projetos representativos com executor mockado e sem chamada a LLM/API externa
+- `runtime execute` passa a bloquear antes da mutação quando confiança, rationality packs ou gates não estão prontos
+- `runtime verify` continua evidence-first e passa a ser validado dentro do fluxo real de execução
+
+#### Release proof
+
+- novo relatório obrigatório `.oxe/release/runtime-real-report.json`
+- `doctor --release` passa a bloquear publicação quando a prova de runtime real estiver ausente ou falha
+- novo `release:pack-check` valida o tarball npm em dry-run contra artefatos indevidos
+
+## [1.8.3] — 2026-05-04
+
+### Release readiness e higiene de publicação
+
+Esta release consolida a linha `1.8.3` para publicação no npm com foco em consistência de versão, alinhamento documental e pacote distribuído mais limpo.
+
+#### Publicação
+
+- alinhamento da versão `1.8.3` entre manifesto raiz, runtime, extensão VS Code, README e changelog
+- fechamento do gate oficial `doctor --release` para a linha atual
+- preparação do pacote npm para sair sem drift entre versão publicada e documentação principal
+
+#### Higiene do pacote
+
+- exclusão dos arquivos `.vsix` históricos da extensão VS Code do tarball npm
+- manutenção apenas do código-fonte da extensão dentro do pacote, evitando distribuir binários legados desnecessários
+
+## [1.8.2] — 2026-04-30
+
+### Fluxo inicial mais coerente e geração de `spec`/`plan` mais forte
+
+Esta release fecha a linha de robustez do ciclo `install -> status/doctor -> /oxe -> spec -> plan -> execute -> verify` sem abrir nova superfície pública. O foco foi remover ruído operacional em projetos novos e aumentar a densidade executável dos artefatos que o OXE induz.
+
+#### Fluxo operacional
+
+- `install`, `status` e `doctor` passam a convergir em `/oxe` como próximo passo canônico para projetos recém-inicializados
+- `doctor` e `status` deixam de tratar `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS` e `FIXTURE-PACK` como blocker primário antes de existir `PLAN.md`
+- o relatório racional agora marca o estado sem plano como `não aplicável ainda`, sem contaminar o próximo passo
+- instalações e desinstalações locais por runtime continuam simétricas, com inferência de artefatos locais preservada
+
+#### Indução mais forte de SPEC e PLAN
+
+- `SPEC.template.md` passou a exigir outcome observável, público-alvo, restrições técnicas, setup externo, conteúdo/fluxos obrigatórios e contratos esperados para o plano
+- `PLAN.template.md` ganhou contrato operacional da solução, densidade operacional mínima, `symbols alvo`, `estado/fluxo coberto` e `fixture/anchor obrigatório` por tarefa
+- `oxe/workflows/spec.md` agora força extração explícita de blocos de interface, conteúdo mínimo, interações, responsividade e acessibilidade em demandas de produto/app/UI
+- `oxe/workflows/plan.md` agora endurece o gate de confiança `>90%` para tarefas mutáveis vagas e exige fechamento mais forte de interface, conteúdo, estado persistido, anchors e fixtures em apps/UI estáticos
+
+#### Testes
+
+- novo teste cobrindo o estado racional não bloqueante antes da existência de `PLAN.md`
+- suíte focada de CLI/health atualizada para manter o comportamento novo estável
+
+## [1.8.1] — 2026-04-30
+
+### Hotfix — Gaps implementados no fonte TypeScript (não em arquivos compilados)
+
+A v1.8.0 aplicou as 5 correções críticas diretamente nos arquivos `.js` compilados (`lib/runtime/`), que são sobrescritos a cada `npm run build:runtime`. Esta release porta todas as correções para o fonte TypeScript em `packages/runtime/src/`, tornando-as permanentes.
+
+#### Correções portadas para TypeScript
+
+- **`models/failure.ts`**: `FailureClass` agora inclui `'verify'` e `'llm'` como classes canônicas
+- **`scheduler/scheduler.ts`**: `TaskResult` com campo opcional `completed_by`; `TaskExecutor.execute()` aceita `options?: { previousError? }`; `verifyNode()` importa e chama `verifyRun` da fonte TS; `executeNode()` repassa `options`; `requestGateForNode()` com warning quando manager ausente
+- **`executor/built-in-tools.ts`**: `finishTask` handler + registro em `BUILT_IN_TOOLS`
+- **`executor/action-tool-map.ts`**: `finish_task` injetado universalmente em `selectToolsForActions()`
+- **`executor/node-prompt-builder.ts`**: parâmetro `options`, seção de retry context, instrução `finish_task`
+- **`executor/llm-task-executor.ts`**: detecção de `finish_task`, `completed_by` no retorno, `turn_limit_exhausted` retorna `success: false`
+
+#### Testes
+- 542 testes passando (era 542 na v1.8.0, nenhuma regressão)
+- 36 testes de gaps (gap1–gap5) todos passando contra o código compilado
+
+---
+
 ## [1.8.0] — 2026-04-29
 
 ### Autonomous Execution — 5 Critical Gaps Resolved

package/README.md

@@ -7,7 +7,7 @@
 [![npm](https://img.shields.io/npm/v/oxe-cc.svg?style=flat-square)](https://www.npmjs.com/package/oxe-cc)
 [![license](https://img.shields.io/npm/l/oxe-cc.svg?style=flat-square)](LICENSE)
 
-**Versão:** `1.8.0` · [package.json](package.json)
+**Versão:** `1.9.1` · [package.json](package.json)
 
 **Framework OXE — Orchestrated eXperience Engineering**
 
@@ -459,20 +459,23 @@ O `status --full` mostra em ANSI: readiness do ciclo, autoavaliação do plano,
 
 O pacote está pronto para uma publicação robusta quando estes sinais estiverem verdes no repositório da release:
 
-- `npm test`
-- `npm run scan:assets`
-- `npm run build:vscode-ext`
-- `node bin/oxe-cc.js doctor --release --write-manifest`
-- `node bin/oxe-cc.js status --full`
+- `npm test`
+- `npm run scan:assets`
+- `npm run build:vscode-ext`
+- `node bin/oxe-cc.js doctor --release --write-manifest`
+- `npm run release:pack-check`
+- `node bin/oxe-cc.js status --full`
 
 Artefatos obrigatórios desta fase:
 
-- `.oxe/release/release-manifest.json`
-- `.oxe/release/runtime-smoke-report.json`
-- `.oxe/release/recovery-fixture-report.json`
-- `.oxe/release/multi-agent-soak-report.json`
-
-Não há outro bloqueador funcional do plano runtime core para esta publicação. O que sobra depois dela é evolução de ergonomia e expansão de targets, não correção estrutural do contrato atual.
+- `.oxe/release/release-manifest.json`
+- `.oxe/release/runtime-smoke-report.json`
+- `.oxe/release/runtime-real-report.json`
+- `.oxe/release/recovery-fixture-report.json`
+- `.oxe/release/multi-agent-soak-report.json`
+- `.oxe/release/multi-agent-real-report.json`
+
+Na linha `1.9.1`, `runtime-real-report.json` prova o ciclo real `compile -> execute mockado -> verify -> project -> status --json`, e `multi-agent-real-report.json` prova coordenação com `git_worktree`, ownership, arbitragem e merge readiness antes da publicação.
 
 ### `/oxe-retro` — loop de aprendizado
 

package/bin/lib/oxe-manifest.cjs

@@ -51,19 +51,26 @@ function writeFileManifest(home, files, version) {
  * Before overwriting with --force, backup files that diverged from last manifest.
  * @param {string} home
  * @param {Record<string, string>} prevManifest
- * @param {{ dryRun: boolean, force: boolean }} opts
- * @param {{ yellow: string, cyan: string, dim: string, reset: string }} colors
- * @returns {string[]} modified paths
- */
-function backupModifiedFromManifest(home, prevManifest, opts, colors) {
-  const { yellow, cyan, dim, reset } = colors;
-  if (!opts.force || opts.dryRun) return [];
-  const modified = [];
-  for (const [absPath, oldHash] of Object.entries(prevManifest)) {
-    if (!fs.existsSync(absPath)) continue;
-    let now;
-    try {
-      now = sha256File(absPath);
+ * @param {{ dryRun: boolean, force: boolean }} opts
+ * @param {{ yellow: string, cyan: string, dim: string, reset: string }} colors
+ * @param {{ scopeRoots?: string[] }} [scope]
+ * @returns {string[]} modified paths
+ */
+function backupModifiedFromManifest(home, prevManifest, opts, colors, scope = {}) {
+  const { yellow, cyan, dim, reset } = colors;
+  if (!opts.force || opts.dryRun) return [];
+  const normalizedRoots = Array.isArray(scope.scopeRoots)
+    ? scope.scopeRoots.map((root) => path.resolve(root))
+    : [];
+  const modified = [];
+  for (const [absPath, oldHash] of Object.entries(prevManifest)) {
+    if (normalizedRoots.length > 0 && !normalizedRoots.some((root) => absPath === root || absPath.startsWith(`${root}${path.sep}`))) {
+      continue;
+    }
+    if (!fs.existsSync(absPath)) continue;
+    let now;
+    try {
+      now = sha256File(absPath);
     } catch {
       continue;
     }