oxe-cc 0.3.6 → 0.3.8

package/bin/oxe-cc.js

@@ -326,6 +326,8 @@ function parseInstallArgs(argv) {
     ignoreInstallConfig: false,
     /** Saída JSON em `status` (CI / agentes). */
     jsonOutput: false,
+    /** Lembretes agregados scan/compact em `status`. */
+    statusHints: false,
     restPositional: [],
   };
   for (let i = 0; i < argv.length; i++) {
@@ -369,6 +371,7 @@ function parseInstallArgs(argv) {
     else if (a === '--dir' && argv[i + 1]) {
       out.dir = path.resolve(argv[++i]);
     } else if (a === '--json') out.jsonOutput = true;
+    else if (a === '--hints') out.statusHints = true;
     else if (!a.startsWith('-')) out.restPositional.push(a);
     else {
       out.parseError = true;
@@ -669,7 +672,7 @@ function applyInstallFromOxeConfig(opts, targetDir) {
 }
 
 /**
- * Mapa número da lista → chaves de runtime (estilo GSD).
+ * Mapa número da lista → chaves de runtime 
  * @param {string} input
  * @returns {string[]}
  */
@@ -765,7 +768,7 @@ async function promptRuntimeSelection() {
   }
 }
 
-/** Global vs local (pastas do projeto), estilo GSD. */
+/** Global vs local (pastas do projeto) */
 async function promptIdeLocation(opts) {
   const rl = readlinePromises.createInterface({ input: process.stdin, output: process.stdout });
   const c = useAnsiColors();
@@ -1048,12 +1051,47 @@ function bootstrapOxe(target, opts) {
   ensureGitignoreIgnoresOxeDir(target, { dryRun: false });
 }
 
+/**
+ * Lembretes de rotina (scan/compact antigos) para `status --hints` ou JSON.
+ * @param {string} target
+ * @param {ReturnType<typeof oxeHealth.buildHealthReport>} r
+ * @param {ReturnType<typeof oxeHealth.loadOxeConfigMerged>['config']} config
+ * @returns {string[]}
+ */
+function collectOxeRoutineHints(target, r, config) {
+  /** @type {string[]} */
+  const out = [];
+  const statePath = path.join(target, '.oxe', 'STATE.md');
+  const hasState = fs.existsSync(statePath);
+  if (config.scan_max_age_days > 0 && r.scanDate && r.stale.stale) {
+    out.push(
+      `Último scan há ~${r.stale.days} dia(s) (limite: ${config.scan_max_age_days}) — considere /oxe-scan`
+    );
+  } else if (config.scan_max_age_days > 0 && !r.scanDate && hasState) {
+    out.push(
+      'Preencha **Data:** em STATE.md (secção Último scan) para o aviso de scan antigo, ou use scan_max_age_days: 0'
+    );
+  }
+  if (config.compact_max_age_days > 0 && r.compactDate && r.staleCompact.stale) {
+    out.push(
+      `Último compact há ~${r.staleCompact.days} dia(s) (limite: ${config.compact_max_age_days}) — considere /oxe-compact se .oxe/codebase/ divergiu do código`
+    );
+  } else if (config.compact_max_age_days > 0 && !r.compactDate && hasState) {
+    out.push(
+      'Preencha **Data:** em STATE.md (secção Último compact) para o aviso de compact antigo, ou use compact_max_age_days: 0'
+    );
+  }
+  return out;
+}
+
 /**
  * Doctor / status: config estendida, fase STATE, scan antigo, SUMMARY, SPEC/PLAN.
  * @param {string} target
  * @param {boolean} c
+ * @param {{ skipScanCompactAgeWarnings?: boolean }} [diagOpts]
  */
-function printOxeHealthDiagnostics(target, c) {
+function printOxeHealthDiagnostics(target, c, diagOpts = {}) {
+  const skipAge = Boolean(diagOpts.skipScanCompactAgeWarnings);
   const r = oxeHealth.buildHealthReport(target);
   const { config } = oxeHealth.loadOxeConfigMerged(target);
 
@@ -1077,14 +1115,30 @@ function printOxeHealthDiagnostics(target, c) {
     console.log(`  ${c ? dim : ''}Fase (STATE.md):${c ? reset : ''} ${r.phase}`);
   }
 
-  if (config.scan_max_age_days > 0 && r.scanDate && r.stale.stale) {
-    console.log(
-      `  ${yellow}AVISO${reset} Último scan há ~${r.stale.days} dia(s) (limite: ${config.scan_max_age_days}) — considere ${cyan}/oxe-scan${reset}`
-    );
-  } else if (config.scan_max_age_days > 0 && !r.scanDate && fs.existsSync(path.join(target, '.oxe', 'STATE.md'))) {
-    console.log(
-      `  ${dim}Obs.:${reset} Preencha **Data:** em STATE.md (secção Último scan) para o aviso de scan antigo, ou use scan_max_age_days: 0`
-    );
+  if (!skipAge) {
+    if (config.scan_max_age_days > 0 && r.scanDate && r.stale.stale) {
+      console.log(
+        `  ${yellow}AVISO${reset} Último scan há ~${r.stale.days} dia(s) (limite: ${config.scan_max_age_days}) — considere ${cyan}/oxe-scan${reset}`
+      );
+    } else if (config.scan_max_age_days > 0 && !r.scanDate && fs.existsSync(path.join(target, '.oxe', 'STATE.md'))) {
+      console.log(
+        `  ${dim}Obs.:${reset} Preencha **Data:** em STATE.md (secção Último scan) para o aviso de scan antigo, ou use scan_max_age_days: 0`
+      );
+    }
+
+    if (config.compact_max_age_days > 0 && r.compactDate && r.staleCompact.stale) {
+      console.log(
+        `  ${yellow}AVISO${reset} Último compact há ~${r.staleCompact.days} dia(s) (limite: ${config.compact_max_age_days}) — considere ${cyan}/oxe-compact${reset} se .oxe/codebase/ estiver desatualizado`
+      );
+    } else if (
+      config.compact_max_age_days > 0 &&
+      !r.compactDate &&
+      fs.existsSync(path.join(target, '.oxe', 'STATE.md'))
+    ) {
+      console.log(
+        `  ${dim}Obs.:${reset} Preencha **Data:** em STATE.md (secção Último compact) para o aviso de compact antigo, ou use compact_max_age_days: 0`
+      );
+    }
   }
 
   if (Array.isArray(config.scan_focus_globs) && config.scan_focus_globs.length) {
@@ -1110,17 +1164,18 @@ function printOxeHealthDiagnostics(target, c) {
 
 /**
  * @param {string} target
- * @param {{ json?: boolean }} [opts]
+ * @param {{ json?: boolean, hints?: boolean }} [opts]
  */
 function runStatus(target, opts = {}) {
   const { config } = oxeHealth.loadOxeConfigMerged(target);
   const next = oxeHealth.suggestNextStep(target, { discuss_before_plan: config.discuss_before_plan });
   const report = oxeHealth.buildHealthReport(target);
+  const routineHints = collectOxeRoutineHints(target, report, config);
 
   if (opts.json) {
     /** @type {Record<string, unknown>} */
     const payload = {
-      oxeStatusSchema: 1,
+      oxeStatusSchema: 2,
       projectRoot: path.resolve(target),
       nextStep: report.next.step,
       cursorCmd: report.next.cursorCmd,
@@ -1129,6 +1184,8 @@ function runStatus(target, opts = {}) {
       phase: report.phase,
       scanDate: report.scanDate,
       staleScan: report.stale,
+      compactDate: report.compactDate,
+      staleCompact: report.staleCompact,
       diagnostics: {
         configParseError: report.configParseError,
         typeErrors: report.typeErrors,
@@ -1139,6 +1196,9 @@ function runStatus(target, opts = {}) {
         planWarnings: report.planWarn,
       },
     };
+    if (opts.hints) {
+      payload.hints = routineHints;
+    }
     console.log(JSON.stringify(payload));
     return;
   }
@@ -1152,7 +1212,18 @@ function runStatus(target, opts = {}) {
     console.log(`  ${yellow}AVISO${reset} Workflows OXE não encontrados — ${cyan}npx oxe-cc@latest${reset}`);
   }
 
-  printOxeHealthDiagnostics(target, c);
+  printOxeHealthDiagnostics(target, c, { skipScanCompactAgeWarnings: Boolean(opts.hints) });
+
+  if (opts.hints) {
+    console.log(`\n  ${c ? cyan : ''}Lembretes (rotina OXE)${reset}`);
+    if (routineHints.length) {
+      for (const h of routineHints) {
+        console.log(`  ${c ? dim : ''}•${c ? reset : ''} ${h}`);
+      }
+    } else {
+      console.log(`  ${c ? dim : ''}•${c ? reset : ''} Nenhum (ajuste scan_max_age_days / compact_max_age_days em .oxe/config.json se quiser lembretes por idade)${reset}`);
+    }
+  }
 
   console.log(`\n  ${c ? yellow : ''}Próximo passo sugerido (único)${reset}`);
   console.log(`  ${c ? dim : ''}Passo:${c ? reset : ''} ${c ? green : ''}${next.step}${reset}`);
@@ -1451,6 +1522,7 @@ ${green}Opções da instalação:${reset}
 ${green}status${reset} (coerência .oxe/ + um próximo passo sugerido; não exige pacote de workflows completo)
   --dir <pasta>   raiz do projeto (padrão: diretório atual)
   --json          imprime um único objeto JSON (próximo passo + diagnósticos) em stdout; adequado a CI
+  --hints         lembretes de rotina (idade scan/compact quando configurado em config.json); com --json inclui array \`hints\`
 
 ${green}Atualizar (projeto já tem OXE):${reset}
   /oxe-update                            no Cursor (outras IDEs: mesmo fluxo pelo terminal)
@@ -2442,7 +2514,7 @@ async function main() {
       console.error(`${yellow}Diretório não encontrado: ${target}${reset}`);
       process.exit(1);
     }
-    runStatus(target, { json: opts.jsonOutput });
+    runStatus(target, { json: opts.jsonOutput, hints: opts.statusHints });
     return;
   }
 

package/commands/oxe/checkpoint.md

@@ -0,0 +1,16 @@
+---
+name: oxe:checkpoint
+description: OXE — Marco em .oxe/checkpoints/ + CHECKPOINTS.md
+argument-hint: "<slug> [nota]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+---
+
+**Workflow canónico:** `oxe/workflows/checkpoint.md`
+
+Execute integralmente. `$ARGUMENTS` = slug obrigatório + nota opcional.

package/commands/oxe/compact.md

@@ -0,0 +1,10 @@
+---
+name: oxe:compact
+description: OXE — refresh codebase vs repo + CODEBASE-DELTA + RESUME (rotina de projeto)
+---
+
+# OXE — compact
+
+**Workflow canónico:** `oxe/workflows/compact.md`
+
+Execute integralmente. Atualiza **`.oxe/codebase/*.md`**, **`.oxe/CODEBASE-DELTA.md`** e **`.oxe/RESUME.md`**. `$ARGUMENTS` = foco opcional (ex. módulo) ou notas para Decisões/Bloqueios no RESUME.

package/commands/oxe/debug.md

@@ -0,0 +1,16 @@
+---
+name: oxe:debug
+description: OXE — Debug técnico durante execute (.oxe/DEBUG.md)
+argument-hint: "[Tn ou erro/stack]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+---
+
+**Workflow canónico:** `oxe/workflows/debug.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como sintoma ou tarefa **Tn**.

package/commands/oxe/forensics.md

@@ -0,0 +1,16 @@
+---
+name: oxe:forensics
+description: OXE — Forensics pós-falha (.oxe/FORENSICS.md + próximo passo scan/plan/execute)
+argument-hint: "[sintoma opcional]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+---
+
+**Workflow canónico:** `oxe/workflows/forensics.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como contexto do sintoma.

package/commands/oxe/plan-agent.md

@@ -0,0 +1,15 @@
+---
+name: oxe:plan-agent
+description: Gera PLAN.md e plan-agents.json (blueprint de agentes e ondas)
+argument-hint: "[--replan se já existe PLAN.md]"
+allowed-tools:
+  - Read
+  - Write
+  - Glob
+  - Grep
+  - Bash
+---
+
+**Workflow canónico:** `oxe/workflows/plan-agent.md`
+
+Execute integralmente esse ficheiro. Se `$ARGUMENTS` contiver `--replan`, seguir a variante de replanejamento descrita no workflow.

package/commands/oxe/research.md

@@ -0,0 +1,16 @@
+---
+name: oxe:research
+description: OXE — Pesquisa exploratória (notas datadas em .oxe/research/ + RESEARCH.md)
+argument-hint: "[âmbito: spike, mapa sistema, reversa, modernização, …]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+---
+
+**Workflow canónico:** `oxe/workflows/research.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como âmbito e perguntas.

package/commands/oxe/route.md

@@ -0,0 +1,11 @@
+---
+name: oxe:route
+description: OXE — Router linguagem natural → um comando/workflow
+argument-hint: "[frase do utilizador]"
+allowed-tools:
+  - Read
+---
+
+**Workflow canónico:** `oxe/workflows/route.md`
+
+Execute integralmente esse ficheiro. Usa `$ARGUMENTS` como pedido a classificar (ver tabela Router em `help.md`).

package/commands/oxe/ui-review.md

@@ -0,0 +1,16 @@
+---
+name: oxe:ui-review
+description: OXE — Auditoria UI (.oxe/UI-REVIEW.md)
+argument-hint: "[paths ou Tn opcional]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+---
+
+**Workflow canónico:** `oxe/workflows/ui-review.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como âmbito da revisão.

package/commands/oxe/ui-spec.md

@@ -0,0 +1,16 @@
+---
+name: oxe:ui-spec
+description: OXE — Contrato UI (.oxe/UI-SPEC.md) a partir da SPEC
+argument-hint: "[âmbito UI opcional]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+---
+
+**Workflow canónico:** `oxe/workflows/ui-spec.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Usa `$ARGUMENTS` como foco opcional de UI.

package/commands/oxe/validate-gaps.md

@@ -0,0 +1,16 @@
+---
+name: oxe:validate-gaps
+description: OXE — Auditoria Nyquist-lite (.oxe/VALIDATION-GAPS.md) após verify
+argument-hint: "[opcional: Tn ou A*]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+---
+
+**Workflow canónico:** `oxe/workflows/validate-gaps.md`
+
+Execute integralmente esse ficheiro na raiz do repositório. Pré-requisito: `VERIFY.md` e `PLAN.md`. `$ARGUMENTS` = foco opcional.

package/lib/sdk/README.md

@@ -52,3 +52,15 @@ const { options, warnings: w } = oxe.install.resolveOptionsFromConfig(dir, {
 | **doctor** | `runDoctorChecks` — resultado estruturado (erros + avisos + diff de workflows + `workflowShape` com lint leve dos `.md`) |
 
 TypeScript: ver `index.d.ts` junto deste ficheiro.
+
+## `health.buildHealthReport` e `parseLastCompactDate`
+
+- **`parseLastCompactDate(stateText)`** — lê a data em **`.oxe/STATE.md`** na secção **Último compact** (mesma convenção que **Último scan**). Devolve `Date | null` se a linha for placeholder ou ilegível.
+- **`buildHealthReport(projectRoot)`** — agrega fase, datas, avisos de SPEC/PLAN/VERIFY e o próximo passo sugerido. Campos usados em CI e em `oxe-cc status --json`:
+  - **`scanDate`**, **`stale`** — último scan e idade face a `scan_max_age_days` (`stale: { stale, days }`).
+  - **`compactDate`**, **`staleCompact`** — último compact e idade face a `compact_max_age_days`.
+  - **`next`** — `{ step, cursorCmd, reason, artifacts }` (espelha a lógica de `suggestNextStep`).
+
+## `runDoctorChecks` e relatório de saúde
+
+O resultado inclui **`healthReport`** com a mesma forma que `buildHealthReport` — útil em pipelines para falhar ou avisar quando `healthReport.stale.stale` ou `healthReport.staleCompact.stale` é verdadeiro (alinhado aos avisos do `oxe-cc doctor`).

package/lib/sdk/index.cjs

@@ -193,6 +193,7 @@ module.exports = {
     oxePaths: health.oxePaths,
     parseStatePhase: health.parseStatePhase,
     parseLastScanDate: health.parseLastScanDate,
+    parseLastCompactDate: health.parseLastCompactDate,
     isStaleScan: health.isStaleScan,
     phaseCoherenceWarnings: health.phaseCoherenceWarnings,
     specSectionWarnings: health.specSectionWarnings,

package/lib/sdk/index.d.ts

@@ -32,6 +32,39 @@ export interface WorkflowShapeResult {
   warnings: DoctorIssue[];
 }
 
+/** Idade do scan ou do compact face a `scan_max_age_days` / `compact_max_age_days`. */
+export interface HealthStaleInfo {
+  stale: boolean;
+  days: number | null;
+}
+
+export interface OxeNextSuggestion {
+  step: string;
+  cursorCmd: string;
+  reason: string;
+  artifacts: string[];
+}
+
+/** Relatório retornado por `health.buildHealthReport` e incluído em `runDoctorChecks`.healthReport. */
+export interface OxeHealthReport {
+  configPath: string | null;
+  configParseError: string | null;
+  unknownConfigKeys: string[];
+  typeErrors: string[];
+  phase: string | null;
+  scanDate: Date | null;
+  stale: HealthStaleInfo;
+  compactDate: Date | null;
+  staleCompact: HealthStaleInfo;
+  phaseWarn: string[];
+  summaryGapWarn: string | null;
+  specWarn: string[];
+  planWarn: string[];
+  next: OxeNextSuggestion;
+  scanFocusGlobs?: unknown;
+  scanIgnoreGlobs?: unknown;
+}
+
 export interface DoctorChecksResult {
   ok: boolean;
   errors: DoctorIssue[];
@@ -46,7 +79,7 @@ export interface DoctorChecksResult {
     parseError: string | null;
   };
   validation: { unknownKeys: string[]; typeErrors: string[] };
-  healthReport: Record<string, unknown>;
+  healthReport: OxeHealthReport;
   workflowShape: WorkflowShapeResult | null;
 }
 

package/oxe/schemas/plan-agents.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://oxe-cc.local/schemas/plan-agents.schema.json",
+  "title": "OXE plan-agents blueprint",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["oxePlanAgentsSchema", "goal", "agents", "execution"],
+  "properties": {
+    "oxePlanAgentsSchema": {
+      "type": "integer",
+      "enum": [1, 2]
+    },
+    "goal": { "type": "string", "minLength": 1 },
+    "specRef": { "type": "string" },
+    "runId": {
+      "type": "string",
+      "minLength": 8,
+      "description": "Obrigatório quando oxePlanAgentsSchema === 2"
+    },
+    "lifecycle": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "since"],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["pending_execute", "executing", "closed", "invalidated"]
+        },
+        "since": { "type": "string", "minLength": 1 },
+        "invalidatedReason": { "type": "string" },
+        "invalidatedBy": {
+          "type": "string",
+          "enum": ["quick", "out_of_scope", "new_plan", "manual"]
+        }
+      },
+      "description": "Obrigatório quando oxePlanAgentsSchema === 2"
+    },
+    "agents": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "role", "scope", "taskIds"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[a-z0-9][a-z0-9-]*$"
+          },
+          "role": { "type": "string", "minLength": 1 },
+          "scope": {
+            "type": "array",
+            "items": { "type": "string" },
+            "minItems": 1
+          },
+          "taskIds": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "pattern": "^T[1-9][0-9]*$"
+            },
+            "minItems": 1
+          },
+          "dependencies": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "inputs": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "outputs": {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        }
+      }
+    },
+    "execution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["strategy", "waves"],
+      "properties": {
+        "strategy": {
+          "type": "string",
+          "enum": ["sequential", "parallel_per_wave", "hybrid"]
+        },
+        "waves": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string" }
+          }
+        }
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "oxePlanAgentsSchema": { "const": 2 } },
+        "required": ["oxePlanAgentsSchema"]
+      },
+      "then": {
+        "required": ["oxePlanAgentsSchema", "goal", "agents", "execution", "runId", "lifecycle"]
+      }
+    }
+  ]
+}

package/oxe/templates/CHECKPOINT.template.md

@@ -0,0 +1,37 @@
+---
+oxe_checkpoint: true
+created: YYYY-MM-DDTHH:mm
+slug: short-slug
+linked:
+  - .oxe/STATE.md
+---
+
+# Checkpoint OXE — <slug>
+
+> Marco **nomeado** em disco. Para retomar: lê este ficheiro + os **linked** acima; não substitui o fluxo canónico.
+
+## Nota do utilizador
+
+(O que o utilizador pediu a gravar em `$ARGUMENTS`, ou *—*.)
+
+## Snapshot (colado ou resumido)
+
+### STATE (trecho relevante)
+
+```text
+(colar cabeçalho / fase / próximo passo)
+```
+
+### SPEC — objetivo (uma linha)
+
+…
+
+### PLAN — resumo
+
+- Ondas: …
+- Tarefas abertas (Tn): …
+
+## Restaurar
+
+1. Abrir ficheiros em `linked` no frontmatter (atualizar paths se renomeaste).
+2. Próximo comando OXE: (preencher, ex. `oxe:execute` onda N)

package/oxe/templates/CODEBASE-DELTA.template.md

@@ -0,0 +1,33 @@
+# OXE — Delta do codebase (último compact)
+
+> Gerado por **`/oxe-compact`**: o que **mudou na documentação** em `.oxe/codebase/` face à leitura anterior do repo. **Não** é diff de Git; é **sincronização documentação ↔ código**.
+
+## Meta
+
+- **Atualizado:** YYYY-MM-DD (ISO)
+- **Modo:** incremental | bootstrap-completo *(bootstrap = faltavam mapas ou scan equivalente foi aplicado)*
+
+## Resumo executivo
+
+- (3–7 bullets: principais divergências corrigidas, novos módulos/pastas, stack ou testes que mudaram)
+- (ex.: *STACK: migração Angular 17 → 21 refletida; TESTING: `ng test` / CI atualizados*)
+
+## Por ficheiro em `.oxe/codebase/`
+
+| Ficheiro | Mudança na doc |
+|----------|------------------|
+| OVERVIEW.md | ex.: atualizado — novo domínio X |
+| STACK.md | ex.: **Angular 17 → 21** conforme repo; ou *sem alteração relevante* |
+| STRUCTURE.md | … |
+| TESTING.md | … |
+| INTEGRATIONS.md | … |
+| CONVENTIONS.md | … |
+| CONCERNS.md | … |
+
+## Lacunas / não verificado aqui
+
+- (comandos não corridos, paths não abertos, incertezas — ou *Nenhuma*)
+
+## Ligação à trilha OXE
+
+- Ver também **`.oxe/RESUME.md`** para fase, SPEC/PLAN e próximo passo.

package/oxe/templates/CONFIG.md

@@ -9,6 +9,7 @@ Copie `oxe/templates/config.template.json` para **`.oxe/config.json`** no seu pr
 | `after_verify_draft_commit` | boolean | Se `true`, o **verify** propõe rascunho de mensagem de commit alinhado aos critérios de aceite. |
 | `default_verify_command` | string | Comando guarda-chuva opcional (ex.: `npm test`) sugerido em **plan**/**verify** quando o projeto não define outro. |
 | `scan_max_age_days` | number | Se **> 0**, `oxe-cc doctor` / `status` avisam quando a **Data** do último scan em `STATE.md` é mais antiga que esse número de dias. Use **0** para desligar. |
+| `compact_max_age_days` | number | Se **> 0**, `oxe-cc doctor` / `status` avisam quando a **Data** em **Último compact (codebase + RESUME)** em `STATE.md` é mais antiga que esse número de dias (preenchida por **`/oxe-compact`**). Use **0** para desligar. |
 | `scan_focus_globs` | string[] | Padrões (ex.: `src/api/**`) que o workflow **scan** deve priorizar; só orientação para o agente. |
 | `scan_ignore_globs` | string[] | Padrões a tratar como baixa prioridade ou omitir no scan (ex.: `**/dist/**`). |
 | `spec_required_sections` | string[] | Cabeçalhos que **devem** existir em `SPEC.md` (ex.: `"## Critérios de aceite"`). `doctor` / `status` emitem aviso se faltar. |