oxe-cc 0.7.1 → 0.9.1

package/commands/oxe/verify.md

@@ -1,15 +1,48 @@
----
-name: oxe:verify
-description: Valida implementação contra SPEC e PLAN; produz checklist e gaps
-argument-hint: "[Tn opcional — focar uma tarefa]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Glob
-  - Grep
----
-
-**Workflow canónico:** `oxe/workflows/verify.md`
-
-Execute integralmente esse ficheiro. Se `$ARGUMENTS` indicar um id de tarefa (ex. `T2`), restringir a verificação a essa tarefa.
+---
+name: oxe:verify
+description: Valida implementação contra SPEC e PLAN; produz checklist e gaps
+argument-hint: "[Tn opcional — focar uma tarefa]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+oxe_workflow_slug: verify
+oxe_reasoning_mode: review
+oxe_question_policy: none
+oxe_output_contract: findings
+oxe_tool_profile: review_heavy
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 442bb4594208d058
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** verify
+- **Modo:** revisão
+- **Perguntas:** nenhuma
+- **Saída esperada:** achados
+- **Perfil de ferramentas:** revisão intensa
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `442bb4594208d058`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/verify.md` e `.oxe/context/packs/verify.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow verify --json`
+- Apresentar findings primeiro, ordenados por severidade e evidência.
+- Separar bug, risco, regressão e lacuna de teste.
+- Se não houver findings, declarar isso explicitamente e listar riscos residuais.
+- **Seções esperadas:** Findings · Perguntas abertas · Riscos residuais · Resumo
+- **Bloqueios formais:** missing:state
+- **Referência canónica:** `oxe/workflows/references/reasoning-review.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canónico:** `oxe/workflows/verify.md`
+
+Execute integralmente esse ficheiro. Se `$ARGUMENTS` indicar um id de tarefa (ex. `T2`), restringir a verificação a essa tarefa.

package/commands/oxe/workstream.md

@@ -1,16 +1,49 @@
----
-name: oxe:workstream
-description: "Trilhas paralelas — list, new <nome>, switch <nome>, status, close <nome> — artefatos independentes em .oxe/workstreams/<nome>/"
-argument-hint: "list | new <nome> | switch <nome> | status | close <nome>"
-allowed-tools:
-  - Read
-  - Bash
-  - Glob
-  - Grep
-  - Write
-  - Task
----
-
-**Workflow canónico:** `oxe/workflows/workstream.md`
-
-Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como subcomando e contexto.
+---
+name: oxe:workstream
+description: "Trilhas paralelas — list, new <nome>, switch <nome>, status, close <nome> — artefatos independentes em .oxe/workstreams/<nome>/"
+argument-hint: "list | new <nome> | switch <nome> | status | close <nome>"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+oxe_workflow_slug: workstream
+oxe_reasoning_mode: execution
+oxe_question_policy: ask_high_impact_only
+oxe_output_contract: execution
+oxe_tool_profile: write_bounded
+oxe_confidence_policy: explicit
+oxe_context_tier: standard
+oxe_contract_version: 2.0.0
+oxe_semantics_hash: 82d171363381cc0d
+---
+
+<!-- oxe-reasoning-contract:start -->
+
+**Contrato de raciocínio OXE deste comando**
+- **Workflow:** workstream
+- **Modo:** execução
+- **Perguntas:** perguntar só alto impacto
+- **Saída esperada:** execução
+- **Perfil de ferramentas:** mutação limitada
+- **Política de confiança:** explícita
+- **Tier de contexto padrão:** padrão
+- **Versão do contrato:** 2.0.0
+- **Checksum semântico:** `82d171363381cc0d`
+- **Entrada de contexto prioritária:** `.oxe/context/packs/workstream.md` e `.oxe/context/packs/workstream.json`
+- **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
+- **Inspeção estruturada:** `oxe-cc context inspect --workflow workstream --json`
+- Fazer reconhecimento curto antes de editar ou executar mutações.
+- Trabalhar no menor write set viável e validar após cada fatia relevante.
+- Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
+- **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
+- **Bloqueios formais:** missing:state · missing:plan
+- **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
+
+<!-- oxe-reasoning-contract:end -->
+
+**Workflow canónico:** `oxe/workflows/workstream.md`
+
+Execute integralmente esse ficheiro na raiz do repositório em que estás a trabalhar. Usa o texto em `$ARGUMENTS` como subcomando e contexto.

package/lib/sdk/index.cjs

@@ -17,6 +17,8 @@ const plugins = require('../../bin/lib/oxe-plugins.cjs');
 const dashboard = require('../../bin/lib/oxe-dashboard.cjs');
 const operational = require('../../bin/lib/oxe-operational.cjs');
 const azure = require('../../bin/lib/oxe-azure.cjs');
+const context = require('../../bin/lib/oxe-context-engine.cjs');
+const runtimeSemantics = require('../../bin/lib/oxe-runtime-semantics.cjs');
 
 const PACKAGE_ROOT = path.join(__dirname, '..', '..');
 
@@ -138,6 +140,70 @@ function parsePlan(planMd) {
  *   requiredSections: string[],
  * }}
  */
+
+/**
+ * Parseia o arquivo lessons-metrics.json retornando o array de lições com métricas.
+ * @param {string} metricsJson — conteúdo do arquivo lessons-metrics.json
+ * @returns {Array<{ id: string, rule: string, type: string, applied_cycles: string[], outcomes: Array<{ cycle: string, verify_status: string, saved_hours?: number, failure_condition?: string }>, success_rate: number, status: string, deprecation_threshold: number }>}
+ */
+function parseLessonsMetrics(metricsJson) {
+  try {
+    const data = JSON.parse(String(metricsJson || '{}'));
+    return Array.isArray(data.lessons) ? data.lessons : [];
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Atualiza a métrica de uma lição com um novo outcome e recalcula success_rate.
+ * @param {ReturnType<typeof parseLessonsMetrics>} metrics
+ * @param {string} lessonId
+ * @param {{ cycle: string, verify_status: string, saved_hours?: number, failure_condition?: string }} outcome
+ * @returns {ReturnType<typeof parseLessonsMetrics>}
+ */
+function updateLessonMetric(metrics, lessonId, outcome) {
+  const arr = Array.isArray(metrics) ? metrics.slice() : [];
+  const idx = arr.findIndex((l) => l.id === lessonId);
+  if (idx === -1) return arr;
+
+  const lesson = { ...arr[idx] };
+  lesson.outcomes = [...(lesson.outcomes || []), outcome];
+  if (!lesson.applied_cycles.includes(outcome.cycle)) {
+    lesson.applied_cycles = [...lesson.applied_cycles, outcome.cycle];
+  }
+
+  const total = lesson.outcomes.length;
+  const successes = lesson.outcomes.filter((o) => o.verify_status === 'complete').length;
+  lesson.success_rate = total > 0 ? Math.round((successes / total) * 100) / 100 : 0;
+
+  const threshold = typeof lesson.deprecation_threshold === 'number' ? lesson.deprecation_threshold : 0.5;
+  if (lesson.success_rate < threshold && total >= 3) {
+    lesson.status = 'deprecated';
+  }
+
+  arr[idx] = lesson;
+  return arr;
+}
+
+/**
+ * Marca como 'deprecated' todas as lições com success_rate abaixo do threshold e ≥ minObservations.
+ * @param {ReturnType<typeof parseLessonsMetrics>} metrics
+ * @param {number} [threshold=0.5]
+ * @param {number} [minObservations=3]
+ * @returns {ReturnType<typeof parseLessonsMetrics>}
+ */
+function deprecateLowEffectiveness(metrics, threshold = 0.5, minObservations = 3) {
+  return (Array.isArray(metrics) ? metrics : []).map((lesson) => {
+    const observations = (lesson.outcomes || []).length;
+    const rate = typeof lesson.success_rate === 'number' ? lesson.success_rate : 1;
+    if (lesson.status !== 'deprecated' && observations >= minObservations && rate < threshold) {
+      return { ...lesson, status: 'deprecated' };
+    }
+    return lesson;
+  });
+}
+
 function parseSpec(specMd) {
   // Objetivo
   const objMatch = specMd.match(/##\s*Objetivo\s*\n+([\s\S]*?)(?=\n##\s|\n#[^\#]|$)/im);
@@ -146,9 +212,14 @@ function parseSpec(specMd) {
   // Tabela de critérios
   /** @type {Array<{ id: string, criterion: string, howToVerify: string }>} */
   const criteria = [];
-  const tableMatch = specMd.match(/##\s*Critérios.*?aceite[\s\S]*?(\|[\s\S]*?)(?=\n##\s|\n#[^\#]|$)/im);
-  if (tableMatch) {
-    const rows = tableMatch[1].split('\n').filter((l) => l.startsWith('|'));
+  const criteriaIdx = specMd.search(/##\s*Crit.rios.*?aceite/im);
+  if (criteriaIdx !== -1) {
+    const afterSection = specMd.slice(criteriaIdx);
+    const nextHeadingMatch = afterSection.slice(3).match(/\n#{1,3} /);
+    const sectionText = nextHeadingMatch
+      ? afterSection.slice(0, nextHeadingMatch.index + 3 + 1)
+      : afterSection;
+    const rows = sectionText.split('\n').filter((l) => l.trimStart().startsWith('|'));
     for (const row of rows) {
       const cells = row.split('|').map((c) => c.trim()).filter(Boolean);
       if (cells.length >= 2 && /^A\d+$/i.test(cells[0])) {
@@ -244,9 +315,14 @@ function parseState(stateMd) {
 function validateDecisionFidelity(discussMd, planMd) {
   // Extrair decisões da tabela D-NN
   const decisionRows = [];
-  const tableMatch = discussMd.match(/##\s*Decisões[\s\S]*?(\|[\s\S]*?)(?=\n##\s|\n#[^\#]|$)/im);
-  if (tableMatch) {
-    const rows = tableMatch[1].split('\n').filter((l) => l.startsWith('|'));
+  const decisoesIdx = discussMd.search(/##\s*Decis.es/im);
+  if (decisoesIdx !== -1) {
+    const afterSection = discussMd.slice(decisoesIdx);
+    const nextHeadingMatch = afterSection.slice(3).match(/\n#{1,3} /);
+    const sectionText = nextHeadingMatch
+      ? afterSection.slice(0, nextHeadingMatch.index + 3 + 1)
+      : afterSection;
+    const rows = sectionText.split('\n').filter((l) => l.trimStart().startsWith('|'));
     for (const row of rows) {
       const cells = row.split('|').map((c) => c.trim()).filter(Boolean);
       if (cells.length >= 2 && /^D-\d+$/i.test(cells[0])) {
@@ -461,11 +537,16 @@ module.exports = {
   readPackageMeta,
   readMinNode,
 
-  /** Parsing de artefatos OXE (PLAN, SPEC, STATE). */
+  /** Parsing de artefatos OXE (PLAN, SPEC, STATE, hypotheses, confidence, lessons). */
   parsePlan,
   parseSpec,
+  parseHypotheses: context.parseHypotheses,
+  parseConfidenceVector: context.parseConfidenceVector,
   parseState,
   validateDecisionFidelity,
+  parseLessonsMetrics,
+  updateLessonMetric,
+  deprecateLowEffectiveness,
 
   /** Estado do projeto, SPEC/PLAN, fase, config. */
   health: {
@@ -480,6 +561,9 @@ module.exports = {
     parseLastRetroDate: health.parseLastRetroDate,
     isStaleScan: health.isStaleScan,
     isStaleLessons: health.isStaleLessons,
+    copilotWorkspacePaths: health.copilotWorkspacePaths,
+    copilotLegacyPaths: health.copilotLegacyPaths,
+    copilotIntegrationReport: health.copilotIntegrationReport,
     planAgentsWarnings: health.planAgentsWarnings,
     phaseCoherenceWarnings: health.phaseCoherenceWarnings,
     specSectionWarnings: health.specSectionWarnings,
@@ -533,6 +617,9 @@ module.exports = {
     scanFileForSecrets: security.scanFileForSecrets,
     scanDirForSecretFiles: security.scanDirForSecretFiles,
     validatePlanPaths: security.validatePlanPaths,
+    checkFilePermission: security.checkFilePermission,
+    checkPermissions: security.checkPermissions,
+    globToRegex: security.globToRegex,
     DEFAULT_SECRET_PATTERNS: security.DEFAULT_SECRET_PATTERNS,
     DEFAULT_SECRET_CONTENT_PATTERNS: security.DEFAULT_SECRET_CONTENT_PATTERNS,
     DEFAULT_DENIED_PATH_PATTERNS: security.DEFAULT_DENIED_PATH_PATTERNS,
@@ -544,6 +631,8 @@ module.exports = {
     runHook: plugins.runHook,
     validatePlugins: plugins.validatePlugins,
     initPluginsDir: plugins.initPluginsDir,
+    resolvePluginSources: plugins.resolvePluginSources,
+    installNpmPlugin: plugins.installNpmPlugin,
   },
 
   /** Dashboard local: contexto consolidado e persistência de revisão do plano. */
@@ -567,6 +656,50 @@ module.exports = {
     parseCapabilityManifest: operational.parseCapabilityManifest,
     readCapabilityCatalog: operational.readCapabilityCatalog,
     buildMemoryLayers: operational.buildMemoryLayers,
+    replayEvents: operational.replayEvents,
+  },
+
+  /** Context Engine V2: seleção, compressão e inspeção determinística de artefatos. */
+  context: {
+    contextPaths: context.contextPaths,
+    resolveArtifactCandidates: context.resolveArtifactCandidates,
+    buildProjectSummary: context.buildProjectSummary,
+    buildSessionSummary: context.buildSessionSummary,
+    buildPhaseSummary: context.buildPhaseSummary,
+    buildContextIndex: context.buildContextIndex,
+    buildContextPack: context.buildContextPack,
+    inspectContextPack: context.inspectContextPack,
+    buildAllContextPacks: context.buildAllContextPacks,
+    computeContextQuality: context.computeContextQuality,
+    computePackFreshness: context.computePackFreshness,
+    resolvePackFile: context.resolvePackFile,
+    summarizeText: context.summarizeText,
+    extractSemanticFragment: context.extractSemanticFragment,
+    parseHypotheses: context.parseHypotheses,
+    parseConfidenceVector: context.parseConfidenceVector,
+  },
+
+  /** Semântica canónica multi-runtime para workflows, wrappers e prompts gerados. */
+  runtimeSemantics: {
+    CONTRACT_VERSION: runtimeSemantics.CONTRACT_VERSION,
+    CONTRACTS_PATH: runtimeSemantics.CONTRACTS_PATH,
+    CONTRACTS_REGISTRY: runtimeSemantics.CONTRACTS_REGISTRY,
+    REQUIRED_CONTRACT_FIELDS: runtimeSemantics.REQUIRED_CONTRACT_FIELDS,
+    RUNTIME_METADATA_KEYS: runtimeSemantics.RUNTIME_METADATA_KEYS,
+    validateWorkflowContractsRegistry: runtimeSemantics.validateWorkflowContractsRegistry,
+    getWorkflowContract: runtimeSemantics.getWorkflowContract,
+    getAllWorkflowContracts: runtimeSemantics.getAllWorkflowContracts,
+    computeSemanticsHash: runtimeSemantics.computeSemanticsHash,
+    getRuntimeMetadataForSlug: runtimeSemantics.getRuntimeMetadataForSlug,
+    renderRuntimeMetadataLines: runtimeSemantics.renderRuntimeMetadataLines,
+    buildReasoningContractBlock: runtimeSemantics.buildReasoningContractBlock,
+    pickRuntimeMetadata: runtimeSemantics.pickRuntimeMetadata,
+    splitFrontmatter: runtimeSemantics.splitFrontmatter,
+    parseFrontmatterMap: runtimeSemantics.parseFrontmatterMap,
+    slugFromPromptFilename: runtimeSemantics.slugFromPromptFilename,
+    slugFromCommandFilename: runtimeSemantics.slugFromCommandFilename,
+    auditWrapperText: runtimeSemantics.auditWrapperText,
+    auditRuntimeTargets: runtimeSemantics.auditRuntimeTargets,
   },
 
   /** Provider Azure nativo via Azure CLI. */