oxe-cc 1.5.0 → 1.5.1

package/lib/sdk/index.d.ts

@@ -225,17 +225,62 @@ export interface AuditSummary {
   actions: Record<string, number>;
 }
 
-export interface PromotionSummary {
-  status: string | null;
-  targetKind: string | null;
-  remote: string | null;
-  targetRef: string | null;
-  prUrl: string | null;
-  prNumber: number | null;
-  coveragePercent: number | null;
-  reasons: string[];
-  path: string;
-}
+export interface PromotionSummary {
+  status: string | null;
+  targetKind: string | null;
+  remote: string | null;
+  targetRef: string | null;
+  prUrl: string | null;
+  prNumber: number | null;
+  coveragePercent: number | null;
+  reasons: string[];
+  path: string;
+}
+
+export interface ExecutionImplementationPackSummary {
+  path: string | null;
+  exists: boolean;
+  parseError: string | null;
+  ready: boolean;
+  tasks: Array<Record<string, unknown>>;
+  taskCount: number;
+  mutatingTasks: number;
+  criticalGaps: string[];
+}
+
+export interface ExecutionReferenceAnchorsSummary {
+  path: string | null;
+  exists: boolean;
+  ready: boolean;
+  anchors: Array<Record<string, unknown>>;
+  missingCriticalCount: number;
+  staleCount: number;
+  criticalGaps: string[];
+}
+
+export interface ExecutionFixturePackSummary {
+  path: string | null;
+  exists: boolean;
+  parseError: string | null;
+  ready: boolean;
+  fixtures: Array<Record<string, unknown>>;
+  fixtureCount: number;
+  criticalGaps: string[];
+}
+
+export interface ExecutionRationalitySummary {
+  applicable: boolean;
+  planTaskCount: number;
+  externalReferenceCount: number;
+  implementationPackReady: boolean;
+  referenceAnchorsReady: boolean;
+  fixturePackReady: boolean;
+  executionRationalityReady: boolean;
+  criticalExecutionGaps: string[];
+  implementationPack: ExecutionImplementationPackSummary;
+  referenceAnchors: ExecutionReferenceAnchorsSummary;
+  fixturePack: ExecutionFixturePackSummary;
+}
 
 /** Relatório retornado por `health.buildHealthReport` e incluído em `runDoctorChecks`.healthReport. */
 export interface OxeHealthReport {
@@ -260,10 +305,16 @@ export interface OxeHealthReport {
   copilotWarn?: string[];
   copilot?: CopilotIntegrationReport | null;
   summaryGapWarn: string | null;
-  specWarn: string[];
-  planWarn: string[];
-  planSelfEvaluation?: Record<string, unknown> | null;
-  planReviewStatus?: string | null;
+  specWarn: string[];
+  planWarn: string[];
+  planSelfEvaluation?: Record<string, unknown> | null;
+  implementationPackReady?: boolean;
+  referenceAnchorsReady?: boolean;
+  fixturePackReady?: boolean;
+  executionRationalityReady?: boolean;
+  criticalExecutionGaps?: string[];
+  executionRationality?: ExecutionRationalitySummary | null;
+  planReviewStatus?: string | null;
   activeRun?: Record<string, unknown> | null;
   eventsSummary?: Record<string, unknown> | null;
   memoryLayers?: Record<string, unknown> | null;
@@ -616,11 +667,12 @@ export interface OxeSdk {
   readMinNode: (packageRoot: string) => number;
 
   /** Parsing de artefatos OXE. */
-  parsePlan: (planMd: string) => ParsedPlan;
-  parseHypotheses: (planText: string) => CriticalHypothesis[];
-  parseConfidenceVector: (planText: string) => ConfidenceVector | null;
-  parseSpec: (specMd: string) => ParsedSpec;
-  parseState: (stateMd: string) => ParsedState;
+  parsePlan: (planMd: string) => ParsedPlan;
+  parseHypotheses: (planText: string) => CriticalHypothesis[];
+  parseConfidenceVector: (planText: string) => ConfidenceVector | null;
+  parseExecutionPlanTasks: (planPath: string | null) => Array<Record<string, unknown>>;
+  parseSpec: (specMd: string) => ParsedSpec;
+  parseState: (stateMd: string) => ParsedState;
   validateDecisionFidelity: (discussMd: string, planMd: string) => DecisionFidelityResult;
   parseLessonsMetrics: (metricsJson: string) => LessonMetric[];
   updateLessonMetric: (metrics: LessonMetric[], lessonId: string, outcome: LessonOutcome) => LessonMetric[];
@@ -654,10 +706,12 @@ export interface OxeSdk {
     copilotIntegrationReport: (target: string) => CopilotIntegrationReport;
     planAgentsWarnings: (target: string) => string[];
     phaseCoherenceWarnings: (phase: string, paths: Record<string, string>) => string[];
-    specSectionWarnings: (specPath: string, requiredHeadings: string[]) => string[];
-    planWaveWarningsFixed: (planPath: string, maxPerWave: number) => string[];
-    planTaskAceiteWarnings: (planPath: string) => string[];
-    verifyGapsWithoutSummaryWarning: (verifyPath: string, summaryPath: string) => string | null;
+    specSectionWarnings: (specPath: string, requiredHeadings: string[]) => string[];
+    planWaveWarningsFixed: (planPath: string, maxPerWave: number) => string[];
+    planTaskAceiteWarnings: (planPath: string) => string[];
+    buildExecutionRationality: (paths?: Record<string, string | null | undefined>) => ExecutionRationalitySummary;
+    executionRationalityWarningsFromSummary: (summary: ExecutionRationalitySummary) => string[];
+    verifyGapsWithoutSummaryWarning: (verifyPath: string, summaryPath: string) => string | null;
     expandExecutionProfile: (profile: string) => Record<string, unknown>;
     ALLOWED_CONFIG_KEYS: string[];
     EXECUTION_PROFILES: string[];

package/oxe/templates/CONFIG.md

@@ -9,7 +9,7 @@ Copie `oxe/templates/config.template.json` para **`.oxe/config.json`** no seu pr
 | `profile` | string | Profile de execução: `balanced` (padrão) \| `strict` \| `fast` \| `legacy`. Expande automaticamente outras keys — keys explícitas prevalecem. Ver tabela abaixo. |
 | `discuss_before_plan` | boolean | Se `true`, o fluxo recomenda **`oxe:discuss`** entre spec e plan. |
 | `verification_depth` | string | Profundidade da verificação: `standard` (padrão) \| `thorough` (ativa Camada 5 — validate-gaps automático) \| `quick` (skip camadas 3–4 e UAT). |
-| `plan_confidence_threshold` | number | Limiar mínimo de confiança para o `execute` aceitar um `PLAN.md`. Padrão: `70`. Abaixo disso, o fluxo deve reduzir incerteza antes de implementar. |
+| `plan_confidence_threshold` | number | Limiar mínimo de confiança para o `execute` aceitar um `PLAN.md`. Padrão canónico: `90`, com gate estrito (`Confiança` precisa ser **maior que** o limiar). Valores menores que 90 não reduzem esse gate. |
 | `security_in_verify` | boolean | Se `true`, executa auditoria OWASP automaticamente no **verify** como **Camada 6** (produz `.oxe/SECURITY.md`). Achados P0 bloqueiam `verify_complete`. Padrão: `false`. |
 | `after_verify_suggest_pr` | boolean | Se `true`, o workflow **verify** inclui checklist de PR no fim. |
 | `after_verify_draft_commit` | boolean | Se `true`, o **verify** propõe rascunho de mensagem de commit alinhado aos critérios de aceite. |

package/oxe/templates/EXECUTION-RUNTIME.template.md

@@ -16,7 +16,7 @@ updated: YYYY-MM-DD
 - **Active run:** `.oxe/ACTIVE-RUN.json` ou artefato equivalente de sessão
 - **Trace log:** `.oxe/OXE-EVENTS.ndjson` ou artefato equivalente de sessão
 - **Autoavaliação do plano:** melhor=`sim|não` | confiança=`NN%`
-- **Limiar de execução:** `70%`
+- **Limiar de execução:** `>90%`
 
 ## Onda atual
 

package/oxe/templates/FIXTURE-PACK.template.json

@@ -0,0 +1,34 @@
+{
+  "schema_version": "1",
+  "generated_at": "YYYY-MM-DDTHH:MM:SSZ",
+  "ready": false,
+  "critical_gaps": [],
+  "fixtures": [
+    {
+      "id": "FX-01",
+      "task_id": "T1",
+      "status": "ready",
+      "inputs": [
+        {
+          "kind": "payload",
+          "ref": ".oxe/investigations/fixtures/example-input.json",
+          "summary": "payload base para validar o fluxo"
+        }
+      ],
+      "expected_outputs": [
+        {
+          "kind": "status",
+          "summary": "deve concluir sem erro e persistir o artefato esperado"
+        }
+      ],
+      "expected_checks": [
+        "npm test -- example"
+      ],
+      "critical_fields": [
+        "id",
+        "status"
+      ],
+      "critical_gaps": []
+    }
+  ]
+}

package/oxe/templates/FIXTURE-PACK.template.md

@@ -0,0 +1,21 @@
+# OXE — Fixture Pack
+
+> Fixtures mínimos para reduzir improviso em parsing, integração, transformação, migração e builders.
+
+## Status
+
+- **Status:** ready | not_ready | not_applicable
+- **Critical gaps abertos:** nenhum | listar
+
+## Fixtures
+
+### FX-01 — T1
+
+- **Task:** T1
+- **Status:** ready | missing | not_applicable
+- **Inputs:** payload, arquivo exemplo, query, blob ou mensagem
+- **Expected outputs:** linha, evento, arquivo, rowset, status etc.
+- **Expected checks:** `...`
+- **Campos críticos / offsets:** ...
+- **Smoke command:** `...`
+- **Critical gaps:** nenhum | listar

package/oxe/templates/IMPLEMENTATION-PACK.template.json

@@ -0,0 +1,52 @@
+{
+  "schema_version": "1",
+  "generated_at": "YYYY-MM-DDTHH:MM:SSZ",
+  "ready": false,
+  "critical_gaps": [],
+  "tasks": [
+    {
+      "id": "T1",
+      "title": "substituir pelo título da tarefa",
+      "mode": "mutating",
+      "ready": false,
+      "exact_paths": [
+        "src/example.ts"
+      ],
+      "write_set": "closed",
+      "symbols": [
+        {
+          "kind": "function",
+          "name": "exampleHandler",
+          "path": "src/example.ts",
+          "signature": "(input: ExampleInput) => ExampleOutput"
+        }
+      ],
+      "contracts": [
+        {
+          "name": "example-contract",
+          "input_shape": "ExampleInput",
+          "output_shape": "ExampleOutput",
+          "invariants": [
+            "não perder campos obrigatórios"
+          ],
+          "not_allowed": [
+            "mutar schema fora do write set"
+          ]
+        }
+      ],
+      "snippets": [
+        {
+          "source_ref": "not_applicable",
+          "path": "not_applicable",
+          "summary": "not_applicable",
+          "status": "not_applicable"
+        }
+      ],
+      "expected_checks": [
+        "npm test -- example"
+      ],
+      "requires_fixture": false,
+      "critical_gaps": []
+    }
+  ]
+}

package/oxe/templates/IMPLEMENTATION-PACK.template.md

@@ -0,0 +1,36 @@
+# OXE — Implementation Pack
+
+> Contrato racional de implementação por tarefa. Este arquivo complementa o `PLAN.md` e fecha write-set, symbols, contracts e checks esperados antes do `/oxe-execute`.
+
+## Status
+
+- **Status:** ready | not_ready | not_applicable
+- **Critical gaps abertos:** nenhum | listar
+- **Fonte:** `PLAN.md` + código real + anchors locais
+
+## Tarefas
+
+### T1 — (título)
+
+- **Mode:** mutating | docs_only | external | not_applicable
+- **Ready:** true | false
+- **Exact paths:** `src/...`, `config/...`
+- **Write set:** closed | external | not_applicable
+- **Symbols alvo:**
+  - `kind:name(path)` — assinatura ou shape esperado
+- **Contracts:**
+  - **Nome:** (ex.: payload parser)
+  - **Entrada:** ...
+  - **Saída:** ...
+  - **Invariants:** ...
+  - **Not allowed:** ...
+- **Expected checks:**
+  - `...`
+- **Requires fixture:** true | false
+- **Snippet/base local:** path ou `not_applicable`
+- **Critical gaps:** nenhum | listar
+
+## Observações
+
+- Use caminhos exatos; não usar `...`.
+- Tarefa mutável sem `symbols`, `contracts`, `write_set: closed` e `expected_checks` não deve sustentar confiança `> 90%`.

package/oxe/templates/PLAN.template.md

@@ -14,35 +14,36 @@ inputs: []
 
 > Gerado a partir de `.oxe/SPEC.md`. Cada tarefa deve ter bloco **Verificar**.
 
-## Resumo
-
-- **Spec vinculada:** (data ou versão informal)
-- **Ondas:** (número)
-- **Tarefas:** (número)
+## Resumo
+
+- **Spec vinculada:** (data ou versão informal)
+- **Ondas:** (número)
+- **Tarefas:** (número)
+- **Artefatos racionais:** `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS`, `FIXTURE-PACK`
 
 ## Autoavaliação do Plano
 
 - **Melhor plano atual:** sim
-- **Confiança:** 80%
+- **Confiança:** 92%
 - **Base da confiança:**
-  - Completude dos requisitos: 20/25
-  - Dependências conhecidas: 12/15
-  - Risco técnico: 15/20
-  - Impacto no código existente: 12/15
-  - Clareza da validação / testes: 13/15
-  - Lacunas externas / decisões pendentes: 8/10
+  - Completude dos requisitos: 23/25
+  - Dependências conhecidas: 14/15
+  - Risco técnico: 18/20
+  - Impacto no código existente: 14/15
+  - Clareza da validação / testes: 14/15
+  - Lacunas externas / decisões pendentes: 9/10
 - **Principais incertezas:** (0–3 bullets)
 - **Alternativas descartadas:** (1–2 linhas)
 - **Condição para replanejar:** (critério objetivo)
 
 <confidence_vector cycle="C-NN" generated_at="YYYY-MM-DDTHH:MM:SSZ">
-  <dim name="requirements"   score="0.80" weight="25" note="completude dos requisitos" />
-  <dim name="dependencies"   score="0.80" weight="15" note="dependências conhecidas" />
-  <dim name="technical_risk" score="0.75" weight="20" note="risco técnico — ajustar se H* pendentes" />
-  <dim name="code_impact"    score="0.80" weight="15" note="impacto no código existente" />
-  <dim name="validation"     score="0.87" weight="15" note="clareza da validação / testes" />
-  <dim name="open_gaps"      score="0.80" weight="10" note="lacunas externas / decisões pendentes" />
-  <global score="0.80" gate="proceed_with_risk" />
+  <dim name="requirements"   score="0.92" weight="25" note="completude dos requisitos" />
+  <dim name="dependencies"   score="0.93" weight="15" note="dependências conhecidas" />
+  <dim name="technical_risk" score="0.90" weight="20" note="risco técnico — ajustar se H* pendentes" />
+  <dim name="code_impact"    score="0.93" weight="15" note="impacto no código existente" />
+  <dim name="validation"     score="0.93" weight="15" note="clareza da validação / testes" />
+  <dim name="open_gaps"      score="0.90" weight="10" note="lacunas externas / decisões pendentes" />
+  <global score="0.92" gate="proceed" />
 </confidence_vector>
 
 <!--
@@ -66,11 +67,18 @@ inputs: []
 </hypothesis>
 -->
 
-## Dependências globais
-
-- (ex.: branch base, feature flags, migrations)
-
-## Replanejamento
+## Dependências globais
+
+- (ex.: branch base, feature flags, migrations)
+
+## Artefatos racionais de execução
+
+- **IMPLEMENTATION-PACK:** `ready | not_ready | not_applicable`
+- **REFERENCE-ANCHORS:** `ready | not_ready | not_applicable`
+- **FIXTURE-PACK:** `ready | not_ready | not_applicable`
+- **Critical gaps abertos:** (nenhum | listar IDs/causas)
+
+## Replanejamento
 
 > Preencher apenas em **--replan** ou após verify falhado. Manter histórico legível.
 
@@ -80,18 +88,19 @@ inputs: []
 
 ## Tarefas
 
-### T1 — (título)
-
-- **Arquivos prováveis:** `…`
-- **Depende de:** —
-- **Onda:** 1
-- **Complexidade:** S
-- **Verificar:**
-  - Comando: `…`
-  - Manual: (opcional) …
-- **Implementar:** o mínimo para fazer a verificação acima passar.
-- **Aceite vinculado:** A1, A2 (IDs da tabela de critérios em SPEC.md)
-
----
+### T1 — (título)
+
+- **Arquivos prováveis:** `…`
+- **Depende de:** —
+- **Onda:** 1
+- **Complexidade:** S
+- **Verificar:**
+  - Comando: `…`
+  - Manual: (opcional) …
+- **Implementar:** o mínimo para fazer a verificação acima passar.
+- **Aceite vinculado:** A1, A2 (IDs da tabela de critérios em SPEC.md)
+- **Contrato racional:** ver `IMPLEMENTATION-PACK.json` (task `T1`)
+
+---
 
 _(Adicione T2, T3, … conforme o comando oxe:plan.)_

package/oxe/templates/REFERENCE-ANCHORS.template.md

@@ -0,0 +1,24 @@
+# OXE — Reference Anchors
+
+> Materialização de referências críticas usadas pelo plano. Toda referência externa, predecessor, layout ou contrato que sustente uma tarefa deve virar âncora reproduzível aqui.
+
+<reference_anchors version="1" ready="false" status="not_ready">
+  <anchor
+    id="RA-01"
+    task="T1"
+    critical="true"
+    status="resolved"
+    source_type="local"
+    path=".oxe/investigations/externals/exemplo.txt"
+    source_ref="external-ref: exemplo">
+    <relevance>Por que esta referência sustenta a tarefa.</relevance>
+    <action>copy | adapt | consult</action>
+    <summary>Resumo semântico curto do trecho relevante ou do contrato.</summary>
+  </anchor>
+</reference_anchors>
+
+## Regras
+
+- Se não houver referência aplicável, usar `<reference_anchors ... status="not_applicable" ready="true">`.
+- `critical="true"` exige `status="resolved"` antes do execute.
+- `path` deve ser reproduzível no workspace ou materializado em `.oxe/investigations/externals/`.

package/oxe/templates/config.template.json

@@ -3,7 +3,7 @@
   "profile": "balanced",
   "discuss_before_plan": false,
   "verification_depth": "standard",
-  "plan_confidence_threshold": 70,
+  "plan_confidence_threshold": 90,
   "security_in_verify": false,
   "adversarial_verify": false,
   "after_verify_suggest_pr": true,

package/oxe/workflows/execute.md

@@ -120,9 +120,16 @@ Quando o comando `**Verificar:**` de uma tarefa `Tn` falha, **não parar silenci
 <context>
 **Contrato de raciocínio:** aplicar `oxe/workflows/references/reasoning-execution.md`. Antes de mutar, fazer reconhecimento curto; durante a execução, operar no menor write set viável e validar após cada fatia relevante.
 
-**Contrato de robustez:** seguir `oxe/workflows/references/flow-robustness-contract.md`. Antes de executar, validar os artefatos obrigatórios e o gate do plano.
-
-**Context pack prioritário:** antes de abrir o conjunto amplo de artefatos, resolver `.oxe/context/packs/execute.md` e `.oxe/context/packs/execute.json` como entrada principal do passo. Se o pack estiver fresco/coerente, usar `read_order` e `selected_artifacts` para limitar o reconhecimento inicial à onda/tarefa atual. Se estiver stale, ausente ou com lacunas críticas, fazer fallback explícito para leitura direta e registrar isso no runtime ou no resumo da execução.
+**Contrato de robustez:** seguir `oxe/workflows/references/flow-robustness-contract.md`. Antes de executar, validar os artefatos obrigatórios e o gate do plano.
+
+**Context pack prioritário:** antes de abrir o conjunto amplo de artefatos, resolver `.oxe/context/packs/execute.md` e `.oxe/context/packs/execute.json` como entrada principal do passo. Se o pack estiver fresco/coerente, usar `read_order` e `selected_artifacts` para limitar o reconhecimento inicial à onda/tarefa atual. Se estiver stale, ausente ou com lacunas críticas, fazer fallback explícito para leitura direta e registrar isso no runtime ou no resumo da execução.
+
+**Artefatos racionais obrigatórios:** quando a execução vier de `PLAN.md`, ler antes da primeira mutação:
+- `IMPLEMENTATION-PACK.md` / `IMPLEMENTATION-PACK.json`
+- `REFERENCE-ANCHORS.md`
+- `FIXTURE-PACK.md` / `FIXTURE-PACK.json`
+
+O `execute` é **pack-first**, não apenas `plan-first`. Esses artefatos existem para impedir improviso de paths, interfaces, referências externas e fixtures. Se estiverem ausentes, inconsistentes ou com `critical_gap`, a execução deve bloquear e devolver para replanejamento.
 
 **Runtime operacional:** usar `EXECUTION-RUNTIME.md` do escopo resolvido como artefato tático da execução. Ele deve refletir agentes ativos, onda atual, handoffs, evidências, retries, checkpoints pendentes e tarefas bloqueadas. O `PLAN.md` continua estratégico; o runtime regista a operação do ciclo.
 
@@ -182,14 +189,20 @@ Se condições não atendidas: responder sem persona; sugerir `/oxe-plan-agent`
    - se estiver stale, incompleto ou ausente, declarar `fallback para leitura direta` antes de seguir.
 1b. **Verificação de hipóteses críticas:** se o context pack contiver o campo `hypotheses` com entradas `status: pending` cujo `checkpoint` coincide com a onda atual — validar cada uma antes de iniciar qualquer mutação. Se a hipótese for refutada, registrar bloqueio explícito em `EXECUTION-RUNTIME.md` e não editar código antes de resolver. Se for validada, atualizar `status: validated` no `PLAN.md`.
 1c. Fazer reconhecimento curto dos artefatos e arquivos prováveis da onda atual antes da primeira mudança. Com pack válido, limitar essa leitura aos artefatos de `read_order` e aos arquivos prováveis da onda; sem pack válido, expandir só o necessário.
-2. Se existir `PLAN.md`, validar a seção `## Autoavaliação do Plano` antes de qualquer implementação:
-   - `Melhor plano atual` deve ser `sim`;
-   - `Confiança` deve existir em `0–100%`;
-   - se `.oxe/config.json` definir `plan_confidence_threshold`, usar esse limiar; senão, usar `70%`;
-   - se a confiança estiver abaixo do limiar, **não executar**. Registrar o bloqueio e orientar redução de incerteza (`/oxe-discuss`, `/oxe-research` ou `/oxe-plan --replan`).
-3. Antes da primeira mudança, verificar `CHECKPOINTS.md` e `EXECUTION-RUNTIME.md` do escopo resolvido:
-   - se houver checkpoint `pending_approval` que se aplique à onda atual, **não avançar**;
-   - inicializar ou atualizar o runtime com onda atual, status, agentes ativos, handoffs e evidências esperadas.
+2. Se existir `PLAN.md`, validar a seção `## Autoavaliação do Plano` antes de qualquer implementação:
+   - `Melhor plano atual` deve ser `sim`;
+   - `Confiança` deve existir em `0–100%`;
+   - o bloco `<confidence_vector>` deve existir e ser coerente com a confiança declarada;
+   - se `.oxe/config.json` definir `plan_confidence_threshold`, usar esse limiar respeitando o piso canónico de `90%`; senão, usar `90%`;
+   - se a confiança não superar o limiar (`<=`) ou se a autoavaliação estiver incompleta, **não executar**. Registrar o bloqueio e orientar redução de incerteza (`/oxe-discuss`, `/oxe-research` ou `/oxe-plan --replan`).
+2a. Antes da primeira mutação, validar os artefatos racionais do plano:
+   - `IMPLEMENTATION-PACK.json` deve existir, estar `ready`, cobrir cada `Tn` mutável e usar `exact_paths` sem `...`, `symbols`, `contracts`, `write_set: "closed"` e `expected_checks`;
+   - `REFERENCE-ANCHORS.md` deve existir e manter todas as âncoras críticas em `status: resolved`;
+   - `FIXTURE-PACK.json` deve existir, estar `ready` e cobrir tarefas de parser/layout/integração/transformação/fila/migração/builder;
+   - se algum pack tiver `critical_gap`, **não executar**. Registrar o bloqueio explicitamente em `EXECUTION-RUNTIME.md` / `STATE.md` e recomendar um único próximo passo: normalmente `/oxe-plan --replan`.
+3. Antes da primeira mudança, verificar `CHECKPOINTS.md` e `EXECUTION-RUNTIME.md` do escopo resolvido:
+   - se houver checkpoint `pending_approval` que se aplique à onda atual, **não avançar**;
+   - inicializar ou atualizar o runtime com onda atual, status, agentes ativos, handoffs e evidências esperadas.
 3a. **Caminho padrão do runtime enterprise:** se `oxe-cc runtime` estiver disponível:
    - executar ou solicitar `oxe-cc runtime compile --dir <projeto>` antes da primeira mutação;
    - se compilar com sucesso, tratar `ACTIVE-RUN.json`, `.oxe/runs/<run_id>.json`, `compiled_graph` e `canonical_state` como estado operacional primário da execução;
@@ -209,11 +222,12 @@ Se condições não atendidas: responder sem persona; sugerir `/oxe-plan-agent`
    - O mesmo gate aplica-se em Azure `apply` quando `scope: apply` ou `all`
 6. **Seleção de modo** (apenas se PLAN.md com 2+ ondas e `execute_mode` não definido em STATE): se o argumento já for `A`, `B` ou `C`, usá-lo diretamente; senão apresentar opções A/B/C e aguardar escolha; registrar em STATE.md.
 7. Identificar **onda ou bloco atual**: no PLAN, todas as tarefas da mesma onda sem dependências pendentes; no QUICK, passos ainda não marcados como feitos.
-8. Listar no chat: tarefas/passos desta onda, arquivos prováveis, comando **Verificar** de cada tarefa.
-8a. Antes de implementar, explicitar no chat:
-   - **Contexto lido** (incluindo se veio de pack fresco ou de fallback)
-   - **Alvo da mudança**
-   - **Validação prevista**
+8. Listar no chat: tarefas/passos desta onda, arquivos prováveis, comando **Verificar** de cada tarefa.
+8a. Antes de implementar, explicitar no chat:
+   - **Contexto lido** (incluindo se veio de pack fresco ou de fallback)
+   - **Artefatos racionais lidos** (implementation/anchors/fixtures e eventuais gaps)
+   - **Alvo da mudança**
+   - **Validação prevista**
 9. **Implementar** conforme o modo escolhido:
    - **Modo Completo:** executar todas as ondas em sequência com verificação inline entre ondas; sumarizar ao final.
    - **Modo Por onda:** executar onda atual, apresentar checklist, parar.
@@ -239,9 +253,11 @@ Se condições não atendidas: responder sem persona; sugerir `/oxe-plan-agent`
 - [ ] Onda ou bloco de passos explicitado antes de "implementar".
 - [ ] Checklist da onda apresentado ou refletido no STATE.md.
 - [ ] STATE.md registra progresso (Tn ou passos) e próximo passo.
-- [ ] Verificação alinhada ao bloco **Verificar** do PLAN ou QUICK.
-- [ ] OBS pendentes verificadas antes de cada onda: `blocking` resolvidos antes de avançar, `adjustment` incorporados como restrições, `info`/legado incorporados normalmente.
-- [ ] Com quick-agents ativos: cada agente trabalha só em seus `steps[]`; ao concluir, `quick-agents.json` → `done`.
-- [ ] Com blueprint schema 2 válido: não adotar persona para pedidos fora das `Tn`; `runId` alinhado entre JSON e STATE; handoffs escritos quando protocolo exige.
+- [ ] Verificação alinhada ao bloco **Verificar** do PLAN ou QUICK.
+- [ ] Com `PLAN.md`, `IMPLEMENTATION-PACK`, `REFERENCE-ANCHORS` e `FIXTURE-PACK` foram lidos e validados antes da primeira mutação.
+- [ ] Se qualquer artefato racional estiver ausente ou inconsistente, a execução bloqueia explicitamente e recomenda `/oxe-plan --replan`.
+- [ ] OBS pendentes verificadas antes de cada onda: `blocking` resolvidos antes de avançar, `adjustment` incorporados como restrições, `info`/legado incorporados normalmente.
+- [ ] Com quick-agents ativos: cada agente trabalha só em seus `steps[]`; ao concluir, `quick-agents.json` → `done`.
+- [ ] Com blueprint schema 2 válido: não adotar persona para pedidos fora das `Tn`; `runId` alinhado entre JSON e STATE; handoffs escritos quando protocolo exige.
 - [ ] Quando `oxe-cc runtime` estiver disponível, `runtime compile` foi tentado antes da primeira mutação e `runtime project` foi usado para reprojetar artefatos após a onda/bloco.
 </success_criteria>

package/oxe/workflows/next.md

@@ -22,7 +22,7 @@ Inspecionar `.oxe/STATE.md` global, a sessão ativa quando existir, e a existên
    - Senão → **execute** (há passos curtos a implementar).
 4. Se não houver `SPEC.md` no escopo resolvido e não for quick intencional declarado → **spec** (passo único).
 5. Se houver SPEC no escopo resolvido mas não PLAN → se `.oxe/config.json` tiver `discuss_before_plan: true` e faltar **`DISCUSS.md`** com decisões → **discuss**; senão → **plan**.
-6. Se PLAN existe mas a seção **Autoavaliação do Plano** disser `Melhor plano atual: não`, ou a `Confiança` estiver abaixo do limiar configurado (padrão 70%), o próximo passo deve ser **plan** (replanejar) ou **discuss/research** se a própria autoavaliação indicar isso.
+6. Se PLAN existe mas a seção **Autoavaliação do Plano** estiver incompleta, disser `Melhor plano atual: não`, ou a `Confiança` não superar o limiar configurado (padrão canónico `>90%`), o próximo passo deve ser **plan** (replanejar) ou **discuss/research** se a própria autoavaliação indicar isso.
 7. Se PLAN existe, **VERIFY.md** ainda **não** existe ou está claramente antes da implementação atual → **execute** (onda atual).
 8. Se PLAN existe e VERIFY falta após implementação declarada → **verify**.
 9. Se VERIFY indica falha ou gaps não resolvidos → **plan** (replanejamento) como passo único, com referência a `SUMMARY.md`.