oxe-cc 1.5.1 → 1.6.0

package/bin/oxe-cc.js

@@ -1668,10 +1668,11 @@ function runStatusFull(target) {
     sp = oxeHealth.scopedOxePaths(target, activeSession);
   }
 
-  printSection('OXE ▸ status --full');
-  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
-  console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || 'modo legado'}${c ? reset : ''}`);
-  console.log(`  ${c ? green : ''}Fase:${c ? reset : ''} ${report.phase || '—'}`);
+  printSection('OXE ▸ status --full');
+  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
+  console.log(`  ${c ? green : ''}Sessão:${c ? reset : ''} ${c ? cyan : ''}${activeSession || 'modo legado'}${c ? reset : ''}`);
+  console.log(`  ${c ? green : ''}Workspace mode:${c ? reset : ''} ${report.workspaceMode || 'oxe_project'}`);
+  console.log(`  ${c ? green : ''}Fase:${c ? reset : ''} ${report.phase || '—'}`);
 
   const healthColor = report.healthStatus === 'healthy' ? green : report.healthStatus === 'warning' ? yellow : red;
   console.log(`  ${c ? green : ''}Saúde:${c ? reset : ''} ${c ? healthColor : ''}${report.healthStatus}${c ? reset : ''}`);
@@ -1701,23 +1702,40 @@ function runStatusFull(target) {
   console.log(`  ${coverageCell(codebaseExists, 'codebase scan')}   ${coverageCell(specExists, 'SPEC.md')}   ${coverageCell(planExists, 'PLAN.md')}   ${coverageCell(verifyExists, 'VERIFY.md')}   ${coverageCell(lessonsExists, 'LESSONS.md')}`);
 
   // Readiness gate
-  const ready = specExists
-    && planExists
-    && report.executionRationalityReady
-    && !report.planWarn.length
-    && !report.runtimeWarn.length;
-  const gateColor = ready ? green : yellow;
-  console.log(`\n  ${c ? yellow : ''}Readiness gate${c ? reset : ''}`);
-  console.log(`  ${c ? gateColor : ''}${ready ? '✓ Pronto para executar' : '✗ Não pronto para executar'}${c ? reset : ''}`);
-  if (!specExists) console.log(`  ${c ? dim : ''}  • SPEC.md ausente — rode /oxe-spec${c ? reset : ''}`);
-  if (!planExists) console.log(`  ${c ? dim : ''}  • PLAN.md ausente — rode /oxe-plan${c ? reset : ''}`);
-  if (report.planWarn.length) {
-    for (const w of report.planWarn) {
-      console.log(`  ${c ? yellow : ''}  • ${w}${c ? reset : ''}`);
+  const packageMode = report.workspaceMode === 'product_package';
+  const ready = packageMode
+    ? Boolean(report.releaseReadiness && report.releaseReadiness.ok)
+    : specExists
+      && planExists
+      && report.executionRationalityReady
+      && !report.planWarn.length
+      && !report.runtimeWarn.length;
+  const gateColor = ready ? green : yellow;
+  console.log(`\n  ${c ? yellow : ''}Readiness gate${c ? reset : ''}`);
+  console.log(`  ${c ? gateColor : ''}${ready ? (packageMode ? '✓ Pronto para publicar' : '✓ Pronto para executar') : (packageMode ? '✗ Não pronto para publicar' : '✗ Não pronto para executar')}${c ? reset : ''}`);
+  if (packageMode) {
+    const releaseReadiness = report.releaseReadiness || { blockers: [], warnings: [] };
+    if (Array.isArray(releaseReadiness.blockers) && releaseReadiness.blockers.length) {
+      for (const blocker of releaseReadiness.blockers) {
+        console.log(`  ${c ? red : ''}  • ${blocker}${c ? reset : ''}`);
+      }
+    }
+    if (Array.isArray(releaseReadiness.warnings) && releaseReadiness.warnings.length) {
+      for (const warning of releaseReadiness.warnings) {
+        console.log(`  ${c ? yellow : ''}  • ${warning}${c ? reset : ''}`);
+      }
+    }
+  } else {
+    if (!specExists) console.log(`  ${c ? dim : ''}  • SPEC.md ausente — rode /oxe-spec${c ? reset : ''}`);
+    if (!planExists) console.log(`  ${c ? dim : ''}  • PLAN.md ausente — rode /oxe-plan${c ? reset : ''}`);
+    if (report.planWarn.length) {
+      for (const w of report.planWarn) {
+        console.log(`  ${c ? yellow : ''}  • ${w}${c ? reset : ''}`);
+      }
+    }
+    if (planExists) {
+      console.log(`  ${c ? dim : ''}  • Artefatos racionais:${c ? reset : ''} implementation=${report.implementationPackReady ? 'ok' : 'pendente'} · anchors=${report.referenceAnchorsReady ? 'ok' : 'pendente'} · fixtures=${report.fixturePackReady ? 'ok' : 'pendente'}`);
     }
-  }
-  if (planExists) {
-    console.log(`  ${c ? dim : ''}  • Artefatos racionais:${c ? reset : ''} implementation=${report.implementationPackReady ? 'ok' : 'pendente'} · anchors=${report.referenceAnchorsReady ? 'ok' : 'pendente'} · fixtures=${report.fixturePackReady ? 'ok' : 'pendente'}`);
   }
 
   // Active run summary
@@ -1804,7 +1822,7 @@ function runStatusFull(target) {
   }
 
   // Plan self-evaluation
-  if (report.planSelfEvaluation) {
+  if (!packageMode && report.planSelfEvaluation) {
     const pse = report.planSelfEvaluation;
     const threshold = report.planConfidenceThreshold || 90;
     console.log(`\n  ${c ? yellow : ''}Autoavaliação do plano${c ? reset : ''}`);
@@ -1840,11 +1858,13 @@ function runStatus(target, opts = {}) {
   const next = report.next;
 
   if (opts.json) {
-    /** @type {Record<string, unknown>} */
-    const payload = {
-      oxeStatusSchema: 5,
-      projectRoot: path.resolve(target),
-      nextStep: report.next.step,
+    /** @type {Record<string, unknown>} */
+    const payload = {
+      oxeStatusSchema: 5,
+      projectRoot: path.resolve(target),
+      workspaceMode: report.workspaceMode || 'oxe_project',
+      releaseReadiness: report.releaseReadiness || null,
+      nextStep: report.next.step,
       cursorCmd: report.next.cursorCmd,
       reason: report.next.reason,
       artifacts: report.next.artifacts,
@@ -1921,9 +1941,10 @@ function runStatus(target, opts = {}) {
     return;
   }
 
-  printSection('OXE ▸ status');
-  const c = useAnsiColors();
-  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
+  printSection('OXE ▸ status');
+  const c = useAnsiColors();
+  console.log(`  ${c ? green : ''}Projeto:${c ? reset : ''} ${c ? cyan : ''}${target}${c ? reset : ''}`);
+  console.log(`  ${c ? dim : ''}Workspace mode:${c ? reset : ''} ${report.workspaceMode || 'oxe_project'}`);
 
   const wfTgt = oxeWorkflows.resolveWorkflowsDir(target);
   if (!wfTgt) {
@@ -1954,16 +1975,24 @@ function runStatus(target, opts = {}) {
   }
 
   // Explicit blockage diagnosis
-  const specMissing = !fs.existsSync(path.join(target, '.oxe', 'SPEC.md'));
-  const planMissing = !fs.existsSync(path.join(target, '.oxe', 'PLAN.md'));
-  const verifyMissing = !fs.existsSync(path.join(target, '.oxe', 'VERIFY.md'));
-  if (specMissing) {
-    console.log(`  ${c ? yellow : ''}⚠ Bloqueio:${c ? reset : ''} SPEC.md ausente — rode ${c ? cyan : ''}/oxe-spec${c ? reset : ''} antes de planejar`);
-  } else if (planMissing) {
-    console.log(`  ${c ? yellow : ''}⚠ Bloqueio:${c ? reset : ''} PLAN.md ausente — rode ${c ? cyan : ''}/oxe-plan${c ? reset : ''}`);
-  } else if (verifyMissing && !planMissing) {
-    console.log(`  ${c ? dim : ''}Obs.:${c ? reset : ''} VERIFY.md ainda não gerado — rode ${c ? cyan : ''}/oxe-verify${c ? reset : ''} após executar`);
-  }
+  const packageMode = report.workspaceMode === 'product_package';
+  const specMissing = !fs.existsSync(path.join(target, '.oxe', 'SPEC.md'));
+  const planMissing = !fs.existsSync(path.join(target, '.oxe', 'PLAN.md'));
+  const verifyMissing = !fs.existsSync(path.join(target, '.oxe', 'VERIFY.md'));
+  if (packageMode) {
+    const releaseReadiness = report.releaseReadiness || { ok: false, blockers: [], warnings: [] };
+    if (!releaseReadiness.ok && Array.isArray(releaseReadiness.blockers) && releaseReadiness.blockers.length) {
+      console.log(`  ${c ? yellow : ''}⚠ Release blockers:${c ? reset : ''} ${releaseReadiness.blockers[0]}`);
+    } else if (Array.isArray(releaseReadiness.warnings) && releaseReadiness.warnings.length) {
+      console.log(`  ${c ? dim : ''}Obs.:${c ? reset : ''} release warnings ativas — ${releaseReadiness.warnings[0]}`);
+    }
+  } else if (specMissing) {
+    console.log(`  ${c ? yellow : ''}⚠ Bloqueio:${c ? reset : ''} SPEC.md ausente — rode ${c ? cyan : ''}/oxe-spec${c ? reset : ''} antes de planejar`);
+  } else if (planMissing) {
+    console.log(`  ${c ? yellow : ''}⚠ Bloqueio:${c ? reset : ''} PLAN.md ausente — rode ${c ? cyan : ''}/oxe-plan${c ? reset : ''}`);
+  } else if (verifyMissing && !planMissing) {
+    console.log(`  ${c ? dim : ''}Obs.:${c ? reset : ''} VERIFY.md ainda não gerado — rode ${c ? cyan : ''}/oxe-verify${c ? reset : ''} após executar`);
+  }
 
   if (opts.hints) {
     console.log(`\n  ${c ? cyan : ''}Lembretes (rotina OXE)${reset}`);

package/docs/RELEASE-READINESS.md

@@ -13,10 +13,13 @@ npx oxe-cc doctor --release --write-manifest
 
 O `doctor --release` deve bloquear a publicação quando encontrar:
 
+- árvore canónica `oxe/workflows/`, `oxe/workflows/references/` ou `commands/oxe/` ausente
+- `workflow-runtime-contracts.json` ausente ou inválido
 - drift de versão entre `package.json`, `packages/runtime/package.json`, `vscode-extension/package.json`, `README.md`, `CHANGELOG.md` e banner
 - topo do `CHANGELOG` ausente, sem data ou sem highlights
 - runtime não compilado em `lib/runtime/index.js`
 - wrappers dirty após `sync-runtime-metadata` e `sync:cursor`
+- drift semântico entre workflows canónicos e superfícies geradas
 - ausência ou falha dos relatórios obrigatórios da release
 
 ## Relatórios obrigatórios
@@ -44,3 +47,8 @@ O pipeline de CI e o pipeline de release devem rodar o mesmo gate:
 3. `npm run release:doctor`
 
 Se qualquer etapa falhar, a release não está pronta.
+
+## Observações operacionais
+
+- `status` e `status --full` distinguem agora `workspaceMode: product_package` de `workspaceMode: oxe_project`.
+- No repositório do pacote, readiness passa a ser de publicação; o CLI deixa de bloquear por ausência de `PLAN.md` executável quando não há ciclo ativo declarado.

package/docs/RUNTIME-SMOKE-MATRIX.md

@@ -1,6 +1,6 @@
 # OXE — Runtime Smoke Matrix
 
-> Estado de suporte por runtime de IA. Atualizado em v1.5.1.
+> Estado de suporte por runtime de IA. Atualizado em v1.6.0.
 >
 > `✓` = suportado e testado | `~` = suportado parcialmente | `✗` = não suportado | `?` = não testado
 
@@ -60,11 +60,18 @@ Este documento descreve a matrix estável da release. O artefato operacional con
 
 ### Codex CLI
 
-- Lê `.github/prompts/` via `--instructions` flag
+- Lê `.codex/prompts/` como entrypoint e depende também de skills em `.agents/skills/oxe/`
+- A smoke matrix desta release valida **prompts e skills**; falha se um dos dois lados estiver ausente ou sem a política de resolução de workflow
 - `verify` parcial: gera VERIFY.md mas evidências são menos detalhadas (sem análise de AST)
 - `runtime-first` não suportado: Codex CLI não tem acesso a subprocessos Node
 - **Limitação:** não suporta contexto multi-arquivo simultâneo em tasks longas
 
+### Escopo de instalação
+
+- `--local` define o layout do repositório (`oxe/` + `.oxe/` vs só `.oxe/`)
+- `--ide-local` define que a integração do runtime deve ser instalada no próprio projeto
+- Para Codex, `install --codex --ide-local` é o fluxo correto quando a intenção é materializar `.codex/` e `.agents/` no repositório atual
+
 ### Gemini CLI
 
 - `plan` e `execute` parciais: segue o fluxo mas pode divergir dos critérios A* do SPEC

package/lib/sdk/index.cjs

@@ -552,11 +552,13 @@ module.exports = {
   deprecateLowEffectiveness,
 
   /** Estado do projeto, SPEC/PLAN, fase, config. */
-  health: {
-    loadOxeConfigMerged: health.loadOxeConfigMerged,
-    validateConfigShape: health.validateConfigShape,
-    buildHealthReport: health.buildHealthReport,
-    suggestNextStep: health.suggestNextStep,
+  health: {
+    loadOxeConfigMerged: health.loadOxeConfigMerged,
+    validateConfigShape: health.validateConfigShape,
+    buildHealthReport: health.buildHealthReport,
+    detectWorkspaceMode: health.detectWorkspaceMode,
+    shouldSuppressExecutionWorkspaceGates: health.shouldSuppressExecutionWorkspaceGates,
+    suggestNextStep: health.suggestNextStep,
     oxePaths: health.oxePaths,
     parseStatePhase: health.parseStatePhase,
     parseLastScanDate: health.parseLastScanDate,
@@ -658,6 +660,9 @@ module.exports = {
     loadRecoveryFixtureReport: release.loadRecoveryFixtureReport,
     loadMultiAgentSoakReport: release.loadMultiAgentSoakReport,
     buildReleaseManifest: release.buildReleaseManifest,
+    inspectCanonicalSource: release.inspectCanonicalSource,
+    evaluateReleaseManifest: release.evaluateReleaseManifest,
+    inspectReleaseReadiness: release.inspectReleaseReadiness,
     checkReleaseConsistency: release.checkReleaseConsistency,
   },
 

package/lib/sdk/index.d.ts

@@ -160,6 +160,8 @@ export interface MultiAgentStatusSummary {
   summary?: Record<string, unknown> | null;
 }
 
+export type WorkspaceMode = 'product_package' | 'oxe_project';
+
 export interface ReleaseManifest {
   schema_version: number;
   generated_at: string;
@@ -168,6 +170,8 @@ export interface ReleaseManifest {
   release_contract: Record<string, unknown>;
   versions: Record<string, unknown>;
   runtime_compiled: { path: string; ok: boolean };
+  canonical_source?: Record<string, unknown>;
+  semantics?: Record<string, unknown>;
   wrappers: Record<string, unknown>;
   reports: Record<string, unknown>;
 }
@@ -283,8 +287,9 @@ export interface ExecutionRationalitySummary {
 }
 
 /** Relatório retornado por `health.buildHealthReport` e incluído em `runDoctorChecks`.healthReport. */
-export interface OxeHealthReport {
-  configPath: string | null;
+export interface OxeHealthReport {
+  workspaceMode?: WorkspaceMode;
+  configPath: string | null;
   configParseError: string | null;
   unknownConfigKeys: string[];
   typeErrors: string[];
@@ -334,9 +339,10 @@ export interface OxeHealthReport {
   contextWarn?: string[];
   semanticsWarn?: string[];
   contextPacks?: Record<string, ContextPackSummary>;
-  contextQuality?: ContextQualitySummary;
-  semanticsDrift?: SemanticsDriftSummary;
-  packFreshness?: Record<string, PackFreshness>;
+  contextQuality?: ContextQualitySummary;
+  semanticsDrift?: SemanticsDriftSummary;
+  releaseReadiness?: ReleaseConsistencyResult | null;
+  packFreshness?: Record<string, PackFreshness>;
   activeSummaryRefs?: { project: string | null; session: string | null; phase: string | null };
   scanFocusGlobs?: unknown;
   scanIgnoreGlobs?: unknown;
@@ -689,11 +695,13 @@ export interface OxeSdk {
     timeoutMs?: number;
   }) => Promise<Record<string, unknown>>;
 
-  health: {
-    loadOxeConfigMerged: (targetProject: string) => { config: Record<string, unknown>; path: string | null; parseError: string | null; sources: { system: string | null; user: string | null; project: string | null } };
-    validateConfigShape: (cfg: Record<string, unknown>) => { unknownKeys: string[]; typeErrors: string[] };
-    buildHealthReport: (target: string) => OxeHealthReport;
-    suggestNextStep: (target: string, cfg?: { discuss_before_plan?: boolean }) => OxeNextSuggestion;
+  health: {
+    loadOxeConfigMerged: (targetProject: string) => { config: Record<string, unknown>; path: string | null; parseError: string | null; sources: { system: string | null; user: string | null; project: string | null } };
+    validateConfigShape: (cfg: Record<string, unknown>) => { unknownKeys: string[]; typeErrors: string[] };
+    buildHealthReport: (target: string) => OxeHealthReport;
+    detectWorkspaceMode: (target: string) => { workspaceMode: WorkspaceMode; packageName: string | null; canonicalTreePresent: boolean; commandsTreePresent: boolean };
+    shouldSuppressExecutionWorkspaceGates: (workspaceMode: WorkspaceMode, phase?: string | null, activeSession?: string | null, activeRun?: Record<string, unknown> | null) => boolean;
+    suggestNextStep: (target: string, cfg?: { discuss_before_plan?: boolean }) => OxeNextSuggestion;
     oxePaths: (target: string) => Record<string, string>;
     parseStatePhase: (stateText: string) => string | null;
     parseLastScanDate: (stateText: string) => Date | null;
@@ -787,6 +795,9 @@ export interface OxeSdk {
     loadRecoveryFixtureReport: (projectRoot: string) => RuntimeSmokeReport;
     loadMultiAgentSoakReport: (projectRoot: string) => RuntimeSmokeReport;
     buildReleaseManifest: (projectRoot: string, options?: Record<string, unknown>) => ReleaseManifest;
+    inspectCanonicalSource: (projectRoot: string) => Record<string, unknown>;
+    evaluateReleaseManifest: (manifest: ReleaseManifest, options?: Record<string, unknown>) => ReleaseConsistencyResult;
+    inspectReleaseReadiness: (projectRoot: string, options?: Record<string, unknown>) => ReleaseConsistencyResult;
     checkReleaseConsistency: (projectRoot: string, options?: Record<string, unknown>) => ReleaseConsistencyResult;
   };
 

package/oxe/templates/CONFIG.md

@@ -8,9 +8,9 @@ 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 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`. |
+| `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 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. |
 | `after_verify_suggest_uat` | boolean | Se `true`, o **verify** gera checklist UAT (Camada 4). Ativo automaticamente com `profile: strict`. |

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:** `>90%`
+- **Limiar de execução:** `>90%`
 
 ## Onda atual
 

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

@@ -1,34 +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": []
-    }
-  ]
-}
+{
+  "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

@@ -1,21 +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
+# 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

@@ -1,52 +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": []
-    }
-  ]
-}
+{
+  "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

@@ -1,36 +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%`.
+# 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%`.