oxe-cc 1.0.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (322) hide show
  1. package/.cursor/commands/oxe-ask.md +3 -3
  2. package/.cursor/commands/oxe-capabilities.md +3 -3
  3. package/.cursor/commands/oxe-checkpoint.md +3 -3
  4. package/.cursor/commands/oxe-compact.md +3 -3
  5. package/.cursor/commands/oxe-dashboard.md +3 -3
  6. package/.cursor/commands/oxe-debug.md +3 -3
  7. package/.cursor/commands/oxe-discuss.md +3 -3
  8. package/.cursor/commands/oxe-execute.md +7 -4
  9. package/.cursor/commands/oxe-forensics.md +3 -3
  10. package/.cursor/commands/oxe-help.md +3 -3
  11. package/.cursor/commands/oxe-loop.md +3 -3
  12. package/.cursor/commands/oxe-milestone.md +3 -3
  13. package/.cursor/commands/oxe-next.md +3 -3
  14. package/.cursor/commands/oxe-obs.md +3 -3
  15. package/.cursor/commands/oxe-plan-agent.md +3 -3
  16. package/.cursor/commands/oxe-plan.md +3 -3
  17. package/.cursor/commands/oxe-project.md +3 -3
  18. package/.cursor/commands/oxe-quick.md +3 -3
  19. package/.cursor/commands/oxe-research.md +3 -3
  20. package/.cursor/commands/oxe-retro.md +3 -3
  21. package/.cursor/commands/oxe-review-pr.md +3 -3
  22. package/.cursor/commands/oxe-route.md +3 -3
  23. package/.cursor/commands/oxe-scan.md +3 -3
  24. package/.cursor/commands/oxe-security.md +3 -3
  25. package/.cursor/commands/oxe-session.md +4 -4
  26. package/.cursor/commands/oxe-ship.md +45 -0
  27. package/.cursor/commands/oxe-skill.md +3 -3
  28. package/.cursor/commands/oxe-spec.md +3 -3
  29. package/.cursor/commands/oxe-ui-review.md +3 -3
  30. package/.cursor/commands/oxe-ui-spec.md +3 -3
  31. package/.cursor/commands/oxe-update.md +3 -3
  32. package/.cursor/commands/oxe-validate-gaps.md +3 -3
  33. package/.cursor/commands/oxe-verify.md +6 -3
  34. package/.cursor/commands/oxe-workstream.md +3 -3
  35. package/.cursor/commands/oxe.md +6 -6
  36. package/.github/copilot-instructions.md +94 -4
  37. package/.github/prompts/oxe-ask.prompt.md +3 -3
  38. package/.github/prompts/oxe-capabilities.prompt.md +3 -3
  39. package/.github/prompts/oxe-checkpoint.prompt.md +3 -3
  40. package/.github/prompts/oxe-compact.prompt.md +3 -3
  41. package/.github/prompts/oxe-dashboard.prompt.md +3 -3
  42. package/.github/prompts/oxe-debug.prompt.md +3 -3
  43. package/.github/prompts/oxe-discuss.prompt.md +3 -3
  44. package/.github/prompts/oxe-execute.prompt.md +7 -4
  45. package/.github/prompts/oxe-forensics.prompt.md +3 -3
  46. package/.github/prompts/oxe-help.prompt.md +3 -3
  47. package/.github/prompts/oxe-loop.prompt.md +3 -3
  48. package/.github/prompts/oxe-milestone.prompt.md +3 -3
  49. package/.github/prompts/oxe-next.prompt.md +3 -3
  50. package/.github/prompts/oxe-obs.prompt.md +3 -3
  51. package/.github/prompts/oxe-plan-agent.prompt.md +3 -3
  52. package/.github/prompts/oxe-plan.prompt.md +3 -3
  53. package/.github/prompts/oxe-project.prompt.md +3 -3
  54. package/.github/prompts/oxe-quick.prompt.md +3 -3
  55. package/.github/prompts/oxe-research.prompt.md +3 -3
  56. package/.github/prompts/oxe-retro.prompt.md +3 -3
  57. package/.github/prompts/oxe-review-pr.prompt.md +3 -3
  58. package/.github/prompts/oxe-route.prompt.md +3 -3
  59. package/.github/prompts/oxe-scan.prompt.md +3 -3
  60. package/.github/prompts/oxe-security.prompt.md +3 -3
  61. package/.github/prompts/oxe-session.prompt.md +4 -4
  62. package/.github/prompts/oxe-ship.prompt.md +45 -0
  63. package/.github/prompts/oxe-skill.prompt.md +3 -3
  64. package/.github/prompts/oxe-spec.prompt.md +3 -3
  65. package/.github/prompts/oxe-ui-review.prompt.md +3 -3
  66. package/.github/prompts/oxe-ui-spec.prompt.md +3 -3
  67. package/.github/prompts/oxe-update.prompt.md +3 -3
  68. package/.github/prompts/oxe-validate-gaps.prompt.md +3 -3
  69. package/.github/prompts/oxe-verify.prompt.md +6 -3
  70. package/.github/prompts/oxe-workstream.prompt.md +3 -3
  71. package/.github/prompts/oxe.prompt.md +5 -5
  72. package/AGENTS.md +43 -28
  73. package/CHANGELOG.md +193 -0
  74. package/README.md +610 -529
  75. package/bin/banner.txt +1 -1
  76. package/bin/lib/oxe-agent-install.cjs +69 -69
  77. package/bin/lib/oxe-azure.cjs +1445 -1445
  78. package/bin/lib/oxe-context-engine.cjs +867 -867
  79. package/bin/lib/oxe-dashboard.cjs +76 -28
  80. package/bin/lib/oxe-operational.cjs +2144 -1340
  81. package/bin/lib/oxe-project-health.cjs +483 -1
  82. package/bin/lib/oxe-runtime-semantics.cjs +12 -0
  83. package/bin/oxe-cc.js +554 -152
  84. package/commands/oxe/ask.md +7 -3
  85. package/commands/oxe/capabilities.md +2 -2
  86. package/commands/oxe/checkpoint.md +3 -3
  87. package/commands/oxe/compact.md +3 -3
  88. package/commands/oxe/dashboard.md +2 -2
  89. package/commands/oxe/debug.md +3 -3
  90. package/commands/oxe/discuss.md +2 -2
  91. package/commands/oxe/execute.md +7 -4
  92. package/commands/oxe/forensics.md +3 -3
  93. package/commands/oxe/help.md +2 -2
  94. package/commands/oxe/loop.md +3 -3
  95. package/commands/oxe/milestone.md +3 -3
  96. package/commands/oxe/next.md +3 -3
  97. package/commands/oxe/obs.md +3 -3
  98. package/commands/oxe/oxe.md +5 -5
  99. package/commands/oxe/plan-agent.md +2 -2
  100. package/commands/oxe/plan.md +2 -2
  101. package/commands/oxe/project.md +3 -3
  102. package/commands/oxe/quick.md +2 -2
  103. package/commands/oxe/research.md +3 -3
  104. package/commands/oxe/retro.md +3 -3
  105. package/commands/oxe/review-pr.md +3 -3
  106. package/commands/oxe/route.md +3 -3
  107. package/commands/oxe/scan.md +3 -3
  108. package/commands/oxe/security.md +3 -3
  109. package/commands/oxe/session.md +4 -4
  110. package/commands/oxe/ship.md +49 -0
  111. package/commands/oxe/skill.md +2 -2
  112. package/commands/oxe/spec.md +4 -4
  113. package/commands/oxe/ui-review.md +3 -3
  114. package/commands/oxe/ui-spec.md +3 -3
  115. package/commands/oxe/update.md +2 -2
  116. package/commands/oxe/validate-gaps.md +3 -3
  117. package/commands/oxe/verify.md +7 -4
  118. package/commands/oxe/workstream.md +3 -3
  119. package/lib/runtime/audit/audit-trail.d.ts +71 -0
  120. package/lib/runtime/audit/audit-trail.js +154 -0
  121. package/lib/runtime/audit/index.d.ts +2 -0
  122. package/lib/runtime/audit/index.js +18 -0
  123. package/lib/runtime/audit/policy-pack.d.ts +15 -0
  124. package/lib/runtime/audit/policy-pack.js +57 -0
  125. package/lib/runtime/context/context-pack-builder.d.ts +15 -0
  126. package/lib/runtime/context/context-pack-builder.js +42 -0
  127. package/lib/runtime/context/context-pack-store.d.ts +38 -0
  128. package/lib/runtime/context/context-pack-store.js +142 -0
  129. package/lib/runtime/context/context-profiles.d.ts +11 -0
  130. package/lib/runtime/context/context-profiles.js +51 -0
  131. package/lib/runtime/context/index.d.ts +2 -0
  132. package/lib/runtime/context/index.js +2 -0
  133. package/lib/runtime/decision/decision-engine.d.ts +43 -0
  134. package/lib/runtime/decision/decision-engine.js +127 -0
  135. package/lib/runtime/decision/decision-memo.d.ts +53 -0
  136. package/lib/runtime/decision/decision-memo.js +173 -0
  137. package/lib/runtime/decision/index.d.ts +2 -0
  138. package/lib/runtime/decision/index.js +18 -0
  139. package/lib/runtime/delivery/branch-manager.d.ts +1 -0
  140. package/lib/runtime/delivery/branch-manager.js +7 -0
  141. package/lib/runtime/delivery/ci-checks.js +34 -1
  142. package/lib/runtime/delivery/delivery-records.d.ts +34 -0
  143. package/lib/runtime/delivery/delivery-records.js +48 -0
  144. package/lib/runtime/delivery/index.d.ts +2 -0
  145. package/lib/runtime/delivery/index.js +2 -0
  146. package/lib/runtime/delivery/promotion-pipeline.d.ts +63 -0
  147. package/lib/runtime/delivery/promotion-pipeline.js +224 -0
  148. package/lib/runtime/gate/gate-manager.d.ts +41 -0
  149. package/lib/runtime/gate/gate-manager.js +108 -1
  150. package/lib/runtime/index.d.ts +5 -2
  151. package/lib/runtime/index.js +7 -1
  152. package/lib/runtime/models/gate-decision.d.ts +4 -1
  153. package/lib/runtime/models/workspace.d.ts +3 -0
  154. package/lib/runtime/plugins/capability-adapter.d.ts +12 -0
  155. package/lib/runtime/plugins/capability-adapter.js +204 -0
  156. package/lib/runtime/plugins/capability-matrix.d.ts +25 -0
  157. package/lib/runtime/plugins/capability-matrix.js +90 -0
  158. package/lib/runtime/plugins/index.d.ts +3 -0
  159. package/lib/runtime/plugins/index.js +3 -0
  160. package/lib/runtime/plugins/plugin-abi.d.ts +2 -0
  161. package/lib/runtime/plugins/plugin-manifest.d.ts +22 -0
  162. package/lib/runtime/plugins/plugin-manifest.js +95 -0
  163. package/lib/runtime/plugins/plugin-registry.d.ts +46 -0
  164. package/lib/runtime/plugins/plugin-registry.js +84 -2
  165. package/lib/runtime/policy/policy-engine.d.ts +47 -1
  166. package/lib/runtime/policy/policy-engine.js +172 -9
  167. package/lib/runtime/projection/projection-engine.d.ts +9 -1
  168. package/lib/runtime/projection/projection-engine.js +73 -3
  169. package/lib/runtime/reducers/run-state-reducer.d.ts +26 -0
  170. package/lib/runtime/reducers/run-state-reducer.js +117 -1
  171. package/lib/runtime/scheduler/agent-registry.d.ts +44 -0
  172. package/lib/runtime/scheduler/agent-registry.js +96 -0
  173. package/lib/runtime/scheduler/agent-roles.d.ts +54 -0
  174. package/lib/runtime/scheduler/agent-roles.js +62 -0
  175. package/lib/runtime/scheduler/index.d.ts +3 -0
  176. package/lib/runtime/scheduler/index.js +3 -0
  177. package/lib/runtime/scheduler/multi-agent-coordinator.d.ts +45 -1
  178. package/lib/runtime/scheduler/multi-agent-coordinator.js +234 -35
  179. package/lib/runtime/scheduler/run-journal.d.ts +18 -0
  180. package/lib/runtime/scheduler/run-journal.js +54 -0
  181. package/lib/runtime/scheduler/scheduler.d.ts +29 -1
  182. package/lib/runtime/scheduler/scheduler.js +387 -14
  183. package/lib/runtime/verification/index.d.ts +1 -0
  184. package/lib/runtime/verification/index.js +1 -0
  185. package/lib/runtime/verification/verification-compiler.d.ts +43 -0
  186. package/lib/runtime/verification/verification-compiler.js +137 -0
  187. package/lib/runtime/verification/verification-manifest.d.ts +67 -0
  188. package/lib/runtime/verification/verification-manifest.js +179 -0
  189. package/lib/runtime/workspace/strategies/ephemeral-container.d.ts +1 -0
  190. package/lib/runtime/workspace/strategies/ephemeral-container.js +4 -0
  191. package/lib/runtime/workspace/strategies/git-worktree.d.ts +1 -0
  192. package/lib/runtime/workspace/strategies/git-worktree.js +2 -0
  193. package/lib/runtime/workspace/strategies/inplace.d.ts +1 -0
  194. package/lib/runtime/workspace/strategies/inplace.js +2 -0
  195. package/lib/runtime/workspace/workspace-manager.d.ts +2 -1
  196. package/lib/sdk/README.md +9 -9
  197. package/lib/sdk/index.cjs +33 -24
  198. package/lib/sdk/index.d.ts +149 -14
  199. package/oxe/templates/ACTIVE-RUN.template.json +32 -32
  200. package/oxe/templates/CAPABILITIES.template.md +7 -7
  201. package/oxe/templates/CAPABILITY.template.md +45 -45
  202. package/oxe/templates/CHECKPOINTS.template.md +7 -7
  203. package/oxe/templates/EXECUTION-RUNTIME.template.md +68 -68
  204. package/oxe/templates/HYPOTHESES.template.md +33 -33
  205. package/oxe/templates/LESSONS-METRICS.template.json +13 -13
  206. package/oxe/templates/NOTES.template.md +16 -16
  207. package/oxe/templates/PLAN-REVIEW.template.md +31 -31
  208. package/oxe/templates/SESSION.template.md +34 -34
  209. package/oxe/templates/SKILL.template.md +26 -26
  210. package/oxe/templates/STATE.md +55 -55
  211. package/oxe/templates/WORKFLOW_AUTHORING.md +18 -18
  212. package/oxe/workflows/ask.md +96 -92
  213. package/oxe/workflows/capabilities.md +25 -25
  214. package/oxe/workflows/checkpoint.md +14 -10
  215. package/oxe/workflows/dashboard.md +33 -33
  216. package/oxe/workflows/debug.md +19 -15
  217. package/oxe/workflows/discuss.md +12 -12
  218. package/oxe/workflows/execute.md +44 -2
  219. package/oxe/workflows/forensics.md +13 -9
  220. package/oxe/workflows/help.md +352 -304
  221. package/oxe/workflows/loop.md +17 -13
  222. package/oxe/workflows/next.md +22 -22
  223. package/oxe/workflows/obs.md +4 -0
  224. package/oxe/workflows/oxe.md +64 -31
  225. package/oxe/workflows/plan-agent.md +9 -9
  226. package/oxe/workflows/project.md +6 -1
  227. package/oxe/workflows/quick.md +10 -10
  228. package/oxe/workflows/references/reasoning-discovery.md +28 -28
  229. package/oxe/workflows/references/reasoning-execution.md +29 -29
  230. package/oxe/workflows/references/reasoning-planning.md +32 -32
  231. package/oxe/workflows/references/reasoning-review.md +29 -29
  232. package/oxe/workflows/references/reasoning-status.md +24 -24
  233. package/oxe/workflows/references/robustness-elevation.md +295 -295
  234. package/oxe/workflows/references/workflow-runtime-contracts.json +952 -907
  235. package/oxe/workflows/research.md +32 -28
  236. package/oxe/workflows/retro.md +4 -0
  237. package/oxe/workflows/review-pr.md +15 -11
  238. package/oxe/workflows/route.md +16 -16
  239. package/oxe/workflows/scan.md +4 -0
  240. package/oxe/workflows/security.md +14 -10
  241. package/oxe/workflows/session.md +213 -197
  242. package/oxe/workflows/ship.md +142 -0
  243. package/oxe/workflows/skill.md +44 -44
  244. package/oxe/workflows/spec.md +15 -0
  245. package/oxe/workflows/ui-review.md +20 -16
  246. package/oxe/workflows/ui-spec.md +7 -3
  247. package/oxe/workflows/validate-gaps.md +13 -9
  248. package/oxe/workflows/verify-audit.md +73 -73
  249. package/oxe/workflows/verify.md +52 -3
  250. package/package.json +92 -92
  251. package/packages/runtime/package.json +17 -17
  252. package/packages/runtime/src/audit/audit-trail.ts +243 -0
  253. package/packages/runtime/src/audit/index.ts +2 -0
  254. package/packages/runtime/src/audit/policy-pack.ts +62 -0
  255. package/packages/runtime/src/compiler/graph-compiler.ts +245 -245
  256. package/packages/runtime/src/compiler/index.ts +1 -1
  257. package/packages/runtime/src/context/context-pack-builder.ts +259 -193
  258. package/packages/runtime/src/context/context-pack-store.ts +197 -0
  259. package/packages/runtime/src/context/context-profiles.ts +60 -0
  260. package/packages/runtime/src/context/index.ts +3 -1
  261. package/packages/runtime/src/decision/decision-engine.ts +174 -0
  262. package/packages/runtime/src/decision/decision-memo.ts +211 -0
  263. package/packages/runtime/src/decision/index.ts +2 -0
  264. package/packages/runtime/src/delivery/branch-manager.ts +91 -84
  265. package/packages/runtime/src/delivery/ci-checks.ts +285 -252
  266. package/packages/runtime/src/delivery/delivery-records.ts +75 -0
  267. package/packages/runtime/src/delivery/index.ts +5 -3
  268. package/packages/runtime/src/delivery/pr-manager.ts +112 -112
  269. package/packages/runtime/src/delivery/promotion-pipeline.ts +334 -0
  270. package/packages/runtime/src/events/bus.ts +92 -92
  271. package/packages/runtime/src/events/catalog.ts +29 -29
  272. package/packages/runtime/src/events/envelope.ts +14 -14
  273. package/packages/runtime/src/events/index.ts +3 -3
  274. package/packages/runtime/src/evidence/evidence-store.ts +130 -130
  275. package/packages/runtime/src/evidence/index.ts +1 -1
  276. package/packages/runtime/src/gate/gate-manager.ts +289 -137
  277. package/packages/runtime/src/gate/index.ts +1 -1
  278. package/packages/runtime/src/index.ts +41 -32
  279. package/packages/runtime/src/models/attempt.ts +19 -19
  280. package/packages/runtime/src/models/evidence.ts +21 -21
  281. package/packages/runtime/src/models/gate-decision.ts +25 -21
  282. package/packages/runtime/src/models/index.ts +8 -8
  283. package/packages/runtime/src/models/run.ts +24 -24
  284. package/packages/runtime/src/models/session.ts +11 -11
  285. package/packages/runtime/src/models/verification-result.ts +10 -10
  286. package/packages/runtime/src/models/work-item.ts +25 -25
  287. package/packages/runtime/src/models/workspace.ts +31 -28
  288. package/packages/runtime/src/plugins/capability-adapter.ts +206 -0
  289. package/packages/runtime/src/plugins/capability-matrix.ts +126 -0
  290. package/packages/runtime/src/plugins/index.ts +5 -2
  291. package/packages/runtime/src/plugins/plugin-abi.ts +97 -95
  292. package/packages/runtime/src/plugins/plugin-manifest.ts +118 -0
  293. package/packages/runtime/src/plugins/plugin-registry.ts +232 -119
  294. package/packages/runtime/src/policy/index.ts +1 -1
  295. package/packages/runtime/src/policy/policy-engine.ts +330 -113
  296. package/packages/runtime/src/projection/index.ts +1 -1
  297. package/packages/runtime/src/projection/projection-engine.ts +328 -249
  298. package/packages/runtime/src/reducers/debug-reducer.ts +36 -36
  299. package/packages/runtime/src/reducers/index.ts +2 -2
  300. package/packages/runtime/src/reducers/run-state-reducer.ts +269 -127
  301. package/packages/runtime/src/scheduler/agent-registry.ts +132 -0
  302. package/packages/runtime/src/scheduler/agent-roles.ts +109 -0
  303. package/packages/runtime/src/scheduler/index.ts +4 -1
  304. package/packages/runtime/src/scheduler/multi-agent-coordinator.ts +521 -231
  305. package/packages/runtime/src/scheduler/run-journal.ts +62 -0
  306. package/packages/runtime/src/scheduler/scheduler.ts +722 -281
  307. package/packages/runtime/src/verification/index.ts +2 -1
  308. package/packages/runtime/src/verification/verification-compiler.ts +436 -225
  309. package/packages/runtime/src/verification/verification-manifest.ts +252 -0
  310. package/packages/runtime/src/workspace/index.ts +5 -5
  311. package/packages/runtime/src/workspace/strategies/ephemeral-container.ts +126 -121
  312. package/packages/runtime/src/workspace/strategies/git-worktree.ts +79 -77
  313. package/packages/runtime/src/workspace/strategies/inplace.ts +38 -35
  314. package/packages/runtime/src/workspace/workspace-manager.ts +16 -15
  315. package/packages/runtime/tsconfig.json +17 -17
  316. package/vscode-extension/.vscodeignore +7 -7
  317. package/vscode-extension/oxe-agents-1.0.0.vsix +0 -0
  318. package/vscode-extension/package.json +185 -185
  319. package/vscode-extension/src/extension.js +310 -310
  320. package/vscode-extension/src/shared/contextLoader.js +137 -137
  321. package/vscode-extension/src/shared/contractBuilder.js +159 -159
  322. package/vscode-extension/src/shared/stateReader.js +101 -101
@@ -9,7 +9,7 @@ oxe_tool_profile: write_bounded
9
9
  oxe_confidence_policy: explicit
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: 4a7e893fe47767a3
12
+ oxe_semantics_hash: df52e7982aeabf21
13
13
  ---
14
14
 
15
15
  OXE — Gerir sessões: new, list, switch, resume, status, close, migrate
@@ -25,7 +25,7 @@ OXE — Gerir sessões: new, list, switch, resume, status, close, migrate
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `4a7e893fe47767a3`
28
+ - **Checksum semântico:** `df52e7982aeabf21`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/session.md` e `.oxe/context/packs/session.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow session --json`
@@ -40,6 +40,6 @@ OXE — Gerir sessões: new, list, switch, resume, status, close, migrate
40
40
 
41
41
  Executa o workflow **OXE session** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
42
42
 
43
- `oxe/workflows/session.md`
43
+ `.oxe/workflows/session.md`
44
44
 
45
- Usa o texto adicional desta mensagem como foco do subcomando: `new <nome>`, `list`, `switch <id>`, `resume <id>`, `status`, `close` ou `migrate <nome>`. Lê `oxe/workflows/session.md` na raiz do projeto atual (CWD).
45
+ Usa o texto adicional desta mensagem como foco do subcomando: `new <nome>`, `list`, `switch <id>`, `resume <id>`, `status`, `close` ou `migrate <nome>`. Lê `.oxe/workflows/session.md` na raiz do projeto atual (CWD).
@@ -0,0 +1,45 @@
1
+ ---
2
+ description: "OXE — Entregar: cria commit local com mensagem gerada de SPEC+PLAN+VERIFY. Flags: --message, --amend, --verify-first, --dry-run"
3
+ argument-hint: "[--message 'mensagem'] [--amend] [--verify-first] [--no-checks] [--dry-run]"
4
+ oxe_workflow_slug: ship
5
+ oxe_reasoning_mode: execution
6
+ oxe_question_policy: ask_high_impact_only
7
+ oxe_output_contract: execution
8
+ oxe_tool_profile: write_bounded
9
+ oxe_confidence_policy: explicit
10
+ oxe_context_tier: standard
11
+ oxe_contract_version: 2.0.0
12
+ oxe_semantics_hash: 4a5d304e6ca781fc
13
+ ---
14
+
15
+ OXE — Entregar: cria commit local com mensagem gerada de SPEC+PLAN+VERIFY. Flags: --message, --amend, --verify-first, --dry-run
16
+
17
+ <!-- oxe-reasoning-contract:start -->
18
+
19
+ **Contrato de raciocínio OXE deste comando**
20
+ - **Workflow:** ship
21
+ - **Modo:** execução
22
+ - **Perguntas:** perguntar só alto impacto
23
+ - **Saída esperada:** execução
24
+ - **Perfil de ferramentas:** mutação limitada
25
+ - **Política de confiança:** explícita
26
+ - **Tier de contexto padrão:** padrão
27
+ - **Versão do contrato:** 2.0.0
28
+ - **Checksum semântico:** `4a5d304e6ca781fc`
29
+ - **Entrada de contexto prioritária:** `.oxe/context/packs/ship.md` e `.oxe/context/packs/ship.json`
30
+ - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
+ - **Inspeção estruturada:** `oxe-cc context inspect --workflow ship --json`
32
+ - Fazer reconhecimento curto antes de editar ou executar mutações.
33
+ - Trabalhar no menor write set viável e validar após cada fatia relevante.
34
+ - Parar e explicitar o bloqueio quando houver hipótese crítica não verificada.
35
+ - **Seções esperadas:** Contexto lido · Alvo da mudança · Validação executada · Resultado · Próximo passo
36
+ - **Bloqueios formais:** missing:verify_without_override · missing:tracked_changes
37
+ - **Referência canónica:** `oxe/workflows/references/reasoning-execution.md`
38
+
39
+ <!-- oxe-reasoning-contract:end -->
40
+
41
+ Executa o workflow **OXE ship**. Lê e aplica **integralmente**:
42
+
43
+ `.oxe/workflows/ship.md` (na raiz do repositório em contexto)
44
+
45
+ Usa `$ARGUMENTS` como flags de entrega (`--message`, `--amend`, `--verify-first`, `--no-checks`, `--dry-run`).
@@ -9,7 +9,7 @@ oxe_tool_profile: write_bounded
9
9
  oxe_confidence_policy: explicit
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: 64cec6f03fc7cfe6
12
+ oxe_semantics_hash: 3cfb16d4930b8a59
13
13
  ---
14
14
 
15
15
  OXE — Descobrir, invocar e gerenciar skills (@executor, @researcher, etc.)
@@ -25,7 +25,7 @@ OXE — Descobrir, invocar e gerenciar skills (@executor, @researcher, etc.)
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `64cec6f03fc7cfe6`
28
+ - **Checksum semântico:** `3cfb16d4930b8a59`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/skill.md` e `.oxe/context/packs/skill.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow skill --json`
@@ -40,6 +40,6 @@ OXE — Descobrir, invocar e gerenciar skills (@executor, @researcher, etc.)
40
40
 
41
41
  Executa o workflow **OXE skill** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
42
42
 
43
- `oxe/workflows/skill.md`
43
+ `.oxe/workflows/skill.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como subcomando ou invocação de skill.
@@ -9,7 +9,7 @@ oxe_tool_profile: read_heavy
9
9
  oxe_confidence_policy: explicit
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: 598fcdce72e894c8
12
+ oxe_semantics_hash: eea8766eab635c97
13
13
  ---
14
14
 
15
15
  OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora) → roteiro (.oxe/ROADMAP.md) → aprovação → plan
@@ -25,7 +25,7 @@ OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora)
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `598fcdce72e894c8`
28
+ - **Checksum semântico:** `eea8766eab635c97`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/spec.md` e `.oxe/context/packs/spec.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow spec --json`
@@ -40,6 +40,6 @@ OXE — Spec em 5 fases: perguntas → pesquisa → requisitos (R-ID v1/v2/fora)
40
40
 
41
41
  Executa o workflow **OXE spec**. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/spec.md` (na raiz do repositório em contexto)
43
+ `.oxe/workflows/spec.md` (na raiz do repositório em contexto)
44
44
 
45
45
  Usa o resto desta mensagem e ficheiros anexados como entrada do utilizador.
@@ -9,7 +9,7 @@ oxe_tool_profile: review_heavy
9
9
  oxe_confidence_policy: explicit
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: 94c1695de8d9ec7d
12
+ oxe_semantics_hash: 262a73b77bf68d6d
13
13
  ---
14
14
 
15
15
  OXE — Auditoria UI (UI-REVIEW.md) face ao UI-SPEC
@@ -25,7 +25,7 @@ OXE — Auditoria UI (UI-REVIEW.md) face ao UI-SPEC
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `94c1695de8d9ec7d`
28
+ - **Checksum semântico:** `262a73b77bf68d6d`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/ui-review.md` e `.oxe/context/packs/ui-review.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow ui-review --json`
@@ -40,6 +40,6 @@ OXE — Auditoria UI (UI-REVIEW.md) face ao UI-SPEC
40
40
 
41
41
  Executa o workflow **OXE ui-review** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/ui-review.md`
43
+ `.oxe/workflows/ui-review.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como ficheiros ou tarefas a rever.
@@ -9,7 +9,7 @@ oxe_tool_profile: mixed
9
9
  oxe_confidence_policy: rubric
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: 76ba6d1e0e2f02e6
12
+ oxe_semantics_hash: 5c8a7668f0a9fca1
13
13
  ---
14
14
 
15
15
  OXE — Contrato UI (UI-SPEC.md) a partir da SPEC
@@ -25,7 +25,7 @@ OXE — Contrato UI (UI-SPEC.md) a partir da SPEC
25
25
  - **Política de confiança:** rubrica
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `76ba6d1e0e2f02e6`
28
+ - **Checksum semântico:** `5c8a7668f0a9fca1`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/ui-spec.md` e `.oxe/context/packs/ui-spec.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow ui-spec --json`
@@ -40,6 +40,6 @@ OXE — Contrato UI (UI-SPEC.md) a partir da SPEC
40
40
 
41
41
  Executa o workflow **OXE ui-spec** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/ui-spec.md`
43
+ `.oxe/workflows/ui-spec.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como foco de ecrãs ou componentes, se houver.
@@ -8,7 +8,7 @@ oxe_tool_profile: write_bounded
8
8
  oxe_confidence_policy: explicit
9
9
  oxe_context_tier: standard
10
10
  oxe_contract_version: 2.0.0
11
- oxe_semantics_hash: 49332cbd409f2ac6
11
+ oxe_semantics_hash: afa0ff72a118df58
12
12
  ---
13
13
 
14
14
  Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE e validar com doctor
@@ -24,7 +24,7 @@ Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE
24
24
  - **Política de confiança:** explícita
25
25
  - **Tier de contexto padrão:** padrão
26
26
  - **Versão do contrato:** 2.0.0
27
- - **Checksum semântico:** `49332cbd409f2ac6`
27
+ - **Checksum semântico:** `afa0ff72a118df58`
28
28
  - **Entrada de contexto prioritária:** `.oxe/context/packs/update.md` e `.oxe/context/packs/update.json`
29
29
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
30
30
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow update --json`
@@ -39,6 +39,6 @@ Atualizar oxe-cc no projeto — verificar versão no npm, alinhar ficheiros OXE
39
39
 
40
40
  Executa o workflow **OXE update**. Lê e segue **integralmente**:
41
41
 
42
- `oxe/workflows/update.md` (na raiz do repositório em contexto; ou `.oxe/workflows/update.md` se a instalação aninhou os workflows)
42
+ `.oxe/workflows/update.md` (na raiz do repositório em contexto; ou `..oxe/workflows/update.md` se a instalação aninhou os workflows)
43
43
 
44
44
  Na prática: na raiz do projeto, correr **`npx oxe-cc update --check`**, depois (se aplicável) **`npx oxe-cc update`** ou **`npx oxe-cc update --if-newer`**, e por fim **`npx oxe-cc doctor`**.
@@ -9,7 +9,7 @@ oxe_tool_profile: review_heavy
9
9
  oxe_confidence_policy: explicit
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: 27d51ac144da4c1c
12
+ oxe_semantics_hash: 69e3f79ec51160e1
13
13
  ---
14
14
 
15
15
  OXE — Gaps de cobertura pós-verify (VALIDATION-GAPS.md)
@@ -25,7 +25,7 @@ OXE — Gaps de cobertura pós-verify (VALIDATION-GAPS.md)
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `27d51ac144da4c1c`
28
+ - **Checksum semântico:** `69e3f79ec51160e1`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/validate-gaps.md` e `.oxe/context/packs/validate-gaps.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow validate-gaps --json`
@@ -40,6 +40,6 @@ OXE — Gaps de cobertura pós-verify (VALIDATION-GAPS.md)
40
40
 
41
41
  Executa o workflow **OXE validate-gaps** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/validate-gaps.md`
43
+ `.oxe/workflows/validate-gaps.md`
44
44
 
45
45
  Requer `VERIFY.md` e `PLAN.md` já existentes. Texto adicional: foco opcional em tarefa **Tn** ou critério **A***.
@@ -9,7 +9,7 @@ oxe_tool_profile: review_heavy
9
9
  oxe_confidence_policy: explicit
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: 442bb4594208d058
12
+ oxe_semantics_hash: 8b47625394eec62a
13
13
  ---
14
14
 
15
15
  OXE — Valida implementação (.oxe/VERIFY.md)
@@ -25,7 +25,7 @@ OXE — Valida implementação (.oxe/VERIFY.md)
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `442bb4594208d058`
28
+ - **Checksum semântico:** `8b47625394eec62a`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/verify.md` e `.oxe/context/packs/verify.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow verify --json`
@@ -34,12 +34,15 @@ OXE — Valida implementação (.oxe/VERIFY.md)
34
34
  - Se não houver findings, declarar isso explicitamente e listar riscos residuais.
35
35
  - **Seções esperadas:** Findings · Perguntas abertas · Riscos residuais · Resumo
36
36
  - **Bloqueios formais:** missing:state
37
+ - **Caminho runtime padrão:** `oxe-cc runtime verify --dir <projeto>` → `oxe-cc runtime project --dir <projeto>`
38
+ - **Artefatos canónicos primários:** `.oxe/runs/<run_id>/verification-manifest.json` · `.oxe/runs/<run_id>/residual-risk-ledger.json` · `.oxe/runs/<run_id>/evidence-coverage.json` · `VERIFY.md projetado`
39
+ - **Fallback runtime:** Se runtime verify não estiver disponível, declarar fallback explícito para a verificação manual; se retornar partial, usar os gaps explícitos como backlog da revisão.
37
40
  - **Referência canónica:** `oxe/workflows/references/reasoning-review.md`
38
41
 
39
42
  <!-- oxe-reasoning-contract:end -->
40
43
 
41
44
  Executa o workflow **OXE verify**. Lê e aplica **integralmente**:
42
45
 
43
- `oxe/workflows/verify.md` (na raiz do repositório em contexto)
46
+ `.oxe/workflows/verify.md` (na raiz do repositório em contexto)
44
47
 
45
48
  Se o utilizador indicar uma tarefa `Tn`, restringe a verificação a essa tarefa.
@@ -9,7 +9,7 @@ oxe_tool_profile: write_bounded
9
9
  oxe_confidence_policy: explicit
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: 82d171363381cc0d
12
+ oxe_semantics_hash: 380bd0a3f3620845
13
13
  ---
14
14
 
15
15
  OXE — Trilhas paralelas: list, new <nome>, switch <nome>, status, close <nome> — cada trilha tem artefatos independentes em .oxe/workstreams/<nome>/
@@ -25,7 +25,7 @@ OXE — Trilhas paralelas: list, new <nome>, switch <nome>, status, close <nome>
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `82d171363381cc0d`
28
+ - **Checksum semântico:** `380bd0a3f3620845`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/workstream.md` e `.oxe/context/packs/workstream.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow workstream --json`
@@ -40,6 +40,6 @@ OXE — Trilhas paralelas: list, new <nome>, switch <nome>, status, close <nome>
40
40
 
41
41
  Executa o workflow **OXE workstream** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
42
42
 
43
- `oxe/workflows/workstream.md`
43
+ `.oxe/workflows/workstream.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como subcomando e contexto.
@@ -1,5 +1,5 @@
1
1
  ---
2
- description: "OXE — Entrada universal: próximo passo / roteamento / help dos 8 comandos essenciais"
2
+ description: "OXE — Entrada universal: próximo passo / roteamento / help da trilha OXE"
3
3
  argument-hint: "[contexto em linguagem natural | 'help' | vazio para próximo passo]"
4
4
  oxe_workflow_slug: oxe
5
5
  oxe_reasoning_mode: status
@@ -9,10 +9,10 @@ oxe_tool_profile: read_heavy
9
9
  oxe_confidence_policy: explicit
10
10
  oxe_context_tier: standard
11
11
  oxe_contract_version: 2.0.0
12
- oxe_semantics_hash: d7f65cd3f77b0abc
12
+ oxe_semantics_hash: 4a8d0d23c56065a7
13
13
  ---
14
14
 
15
- OXE — Entrada universal: próximo passo / roteamento / help dos 8 comandos essenciais
15
+ OXE — Entrada universal: próximo passo / roteamento / help da trilha OXE
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
18
18
 
@@ -25,7 +25,7 @@ OXE — Entrada universal: próximo passo / roteamento / help dos 8 comandos ess
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `d7f65cd3f77b0abc`
28
+ - **Checksum semântico:** `4a8d0d23c56065a7`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/oxe.md` e `.oxe/context/packs/oxe.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow oxe --json`
@@ -40,6 +40,6 @@ OXE — Entrada universal: próximo passo / roteamento / help dos 8 comandos ess
40
40
 
41
41
  Executa o workflow **OXE** (entrada universal) no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/oxe.md`
43
+ `.oxe/workflows/oxe.md`
44
44
 
45
- `$ARGUMENTS`: vazio → próximo passo; texto → roteamento; "help" → 8 comandos essenciais.
45
+ `$ARGUMENTS`: vazio → próximo passo; texto → roteamento; "help" → trilha principal + trilha avançada.
@@ -1,8 +1,8 @@
1
1
  # OXE — fluxo spec-driven (multi-IDE / multi-CLI)
2
2
 
3
- Este repositório (ou o pacote **oxe-cc** instalado) define o **OXE**: artefatos em **`.oxe/`** na raiz do projeto alvo e workflows em **`oxe/workflows/*.md`** (no pacote) ou **`.oxe/workflows/*.md`** / **`oxe/workflows/*.md`** no projeto, conforme a instalação (layout mínimo vs clássico). O fluxo é **agnóstico de ferramenta**; **Cursor** e **GitHub Copilot** são o caminho padrão mais conhecido, mas o mesmo OXE pode ser instalado em **Claude Code, OpenCode, Gemini CLI, Codex, Windsurf, Antigravity** e outras integrações via `oxe-cc --all-agents` (ou flags por runtime).
4
-
5
- Os prompts OXE carregam metadata cognitiva comum (`oxe_reasoning_mode`, `oxe_question_policy`, `oxe_output_contract`, `oxe_tool_profile`, `oxe_confidence_policy`). Essa metadata não substitui o workflow canónico; ela alinha a postura de raciocínio entre runtimes para discovery, planning, execution, review e status.
3
+ Este repositório (ou o pacote **oxe-cc** instalado) define o **OXE**: artefatos em **`.oxe/`** na raiz do projeto alvo e workflows em **`oxe/workflows/*.md`** (no pacote) ou **`.oxe/workflows/*.md`** / **`oxe/workflows/*.md`** no projeto, conforme a instalação (layout mínimo vs clássico). O fluxo é **agnóstico de ferramenta**; **Cursor** e **GitHub Copilot** são o caminho padrão mais conhecido, mas o mesmo OXE pode ser instalado em **Claude Code, OpenCode, Gemini CLI, Codex, Windsurf, Antigravity** e outras integrações via `oxe-cc --all-agents` (ou flags por runtime).
4
+
5
+ Os prompts OXE carregam metadata cognitiva comum (`oxe_reasoning_mode`, `oxe_question_policy`, `oxe_output_contract`, `oxe_tool_profile`, `oxe_confidence_policy`). Essa metadata não substitui o workflow canónico; ela alinha a postura de raciocínio entre runtimes para discovery, planning, execution, review e status.
6
6
 
7
7
  ## Quando aplicar
8
8
 
@@ -82,6 +82,96 @@ Se o usuário mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o
82
82
 
83
83
  ## Manutenção do pacote oxe-build
84
84
 
85
- Ao alterar comportamento OXE, edite primeiro **`oxe/workflows/*.md`**; mantenha prompts em **`.github/prompts/`**, wrappers em **`commands/oxe/`** e comandos Cursor gerados pelo sync alinhados à mesma semântica. Quando alterar metadata cognitiva ou contratos de raciocínio, rode `npm run sync:runtime-metadata` e `npm run sync:cursor`.
85
+ Ao alterar comportamento OXE, edite primeiro **`oxe/workflows/*.md`**; mantenha prompts em **`.github/prompts/`**, wrappers em **`commands/oxe/`** e comandos Cursor gerados pelo sync alinhados à mesma semântica. Quando alterar metadata cognitiva ou contratos de raciocínio, rode `npm run sync:runtime-metadata` e `npm run sync:cursor`.
86
86
 
87
87
  **Autoria de workflows:** guia em **`oxe/templates/WORKFLOW_AUTHORING.md`**. Para rever um `.md` de passo contra o guia, use o workflow **`oxe/workflows/workflow-authoring.md`** (ou `.oxe/workflows/` no projeto alvo).
88
+
89
+ <!-- oxe-cc:install-begin -->
90
+ # OXE — fluxo spec-driven (multi-IDE / multi-CLI)
91
+
92
+ Este repositório (ou o pacote **oxe-cc** instalado) define o **OXE**: artefatos em **`.oxe/`** na raiz do projeto alvo e workflows em **`.oxe/workflows/*.md`** (no pacote) ou **`..oxe/workflows/*.md`** / **`.oxe/workflows/*.md`** no projeto, conforme a instalação (layout mínimo vs clássico). O fluxo é **agnóstico de ferramenta**; **Cursor** e **GitHub Copilot** são o caminho padrão mais conhecido, mas o mesmo OXE pode ser instalado em **Claude Code, OpenCode, Gemini CLI, Codex, Windsurf, Antigravity** e outras integrações via `oxe-cc --all-agents` (ou flags por runtime).
93
+
94
+ Os prompts OXE carregam metadata cognitiva comum (`oxe_reasoning_mode`, `oxe_question_policy`, `oxe_output_contract`, `oxe_tool_profile`, `oxe_confidence_policy`). Essa metadata não substitui o workflow canónico; ela alinha a postura de raciocínio entre runtimes para discovery, planning, execution, review e status.
95
+
96
+ ## Quando aplicar
97
+
98
+ Se o usuário mencionar **OXE**, **oxe**, **/oxe-**, ou pedidos como “mapear o projeto”, “criar spec OXE”, “plano OXE com testes”, “verificar OXE”, trate como fluxo OXE e siga o arquivo de workflow correspondente abaixo.
99
+
100
+ ## Workflows (fonte única)
101
+
102
+ | Passo | Arquivo | Gatilhos naturais (exemplos) |
103
+ |-------|---------|-------------------------------|
104
+ | Scan | `.oxe/workflows/scan.md` | “oxe scan”, “mapear o repo”, “atualizar codebase OXE” |
105
+ | Spec | `.oxe/workflows/spec.md` | “oxe spec”, “escrever SPEC.md”, “requisitos OXE” |
106
+ | Discuss | `.oxe/workflows/discuss.md` | “oxe discuss”, “perguntas antes do plano”, “DISCUSS.md” |
107
+ | Plan | `.oxe/workflows/plan.md` | “oxe plan”, “PLAN.md”, “plano com testes por tarefa”, “replan” |
108
+ | Plan (agentes) | `.oxe/workflows/plan-agent.md` | “plan agent”, “plan-agents.json”, “subagentes”, “ondas por agente”, blueprint de execução *(prompt: `/oxe-plan-agent`)* |
109
+ | Quick | `.oxe/workflows/quick.md` | “oxe quick”, “fix rápido OXE”, “QUICK.md” |
110
+ | Execute | `.oxe/workflows/execute.md` | “oxe execute”, “executar onda”, “onda 2 OXE” |
111
+ | Verify | `.oxe/workflows/verify.md` | “oxe verify”, “validar plano OXE”, “VERIFY.md” |
112
+ | Validate gaps | `.oxe/workflows/validate-gaps.md` | “validate gaps”, “Nyquist-lite”, “cobertura de critérios” após verify *(prompt: `/oxe-validate-gaps`)* |
113
+ | Next | `.oxe/workflows/next.md` | “oxe next”, “próximo passo OXE” |
114
+ | Review PR | `.oxe/workflows/review-pr.md` | “revisar PR”, link `…/pull/10`, “diff entre branches” *(prompt Copilot: `/oxe-review-pr`)* |
115
+ | Help | `.oxe/workflows/help.md` | “oxe help”, “como usar OXE” |
116
+ | Update | `.oxe/workflows/update.md` | “oxe update”, “atualizar oxe-cc”, “há versão nova no npm” *(prompt: `/oxe-update`)* |
117
+ | Forensics | `.oxe/workflows/forensics.md` | “oxe forensics”, “preso após verify”, “doctor falhou”, incoerência STATE/VERIFY *(prompt: `/oxe-forensics`)* |
118
+ | Debug | `.oxe/workflows/debug.md` | “oxe debug”, teste vermelho, stack trace durante implementação *(prompt: `/oxe-debug`)* |
119
+ | Route | `.oxe/workflows/route.md` | “que comando OXE uso”, desambiguar intenção *(prompt: `/oxe-route`)* |
120
+ | Research | `.oxe/workflows/research.md` | “oxe research”, mapa de sistema, spike, engenharia reversa, modernização *(prompt: `/oxe-research`)* |
121
+ | Compact | `.oxe/workflows/compact.md` | “oxe compact”, refresh `.oxe/codebase/` vs repo + `CODEBASE-DELTA.md` + `RESUME.md` *(prompt: `/oxe-compact`)* |
122
+ | Checkpoint | `.oxe/workflows/checkpoint.md` | “oxe checkpoint”, snapshot de sessão `.oxe/checkpoints/` *(prompt: `/oxe-checkpoint`)* |
123
+ | UI spec | `.oxe/workflows/ui-spec.md` | “UI-SPEC”, contrato de interface após spec *(prompt: `/oxe-ui-spec`)* |
124
+ | UI review | `.oxe/workflows/ui-review.md` | “auditoria UI”, UI-REVIEW *(prompt: `/oxe-ui-review`)* |
125
+ | Autoria de workflow | `.oxe/workflows/workflow-authoring.md` | “rever workflow OXE”, “revisar `.oxe/workflows/foo.md` contra o guia”, alinhar passo ao `WORKFLOW_AUTHORING.md` |
126
+ | Ask | `.oxe/workflows/ask.md` | “oxe ask”, “situação atual OXE”, “o que está acontecendo”, “ler STATE” *(prompt: `/oxe-ask`)* |
127
+ | Obs | `.oxe/workflows/obs.md` | “oxe obs”, “registrar observação”, “anotar descoberta”, “restrição encontrada” *(prompt: `/oxe-obs`)* |
128
+ | Session | `.oxe/workflows/session.md` | “oxe session”, “nova sessão”, “alternar sessão”, “retomar sessão”, “fechar sessão” *(prompt: `/oxe-session`)* |
129
+ | Retro | `.oxe/workflows/retro.md` | “oxe retro”, “retrospectiva”, “lições do ciclo”, “LESSONS.md” *(prompt: `/oxe-retro`)* |
130
+ | Dashboard | `.oxe/workflows/dashboard.md` | “oxe dashboard”, “visualizar runtime”, “ondas ativas”, “status visual” *(prompt: `/oxe-dashboard`)* |
131
+ | Loop | `.oxe/workflows/loop.md` | “oxe loop”, “iterar até passar”, “loop de verify” *(prompt: `/oxe-loop`)* |
132
+ | Security | `.oxe/workflows/security.md` | “oxe security”, “auditoria OWASP”, “P0/P1 de segurança” *(prompt: `/oxe-security`)* |
133
+ | Milestone | `.oxe/workflows/milestone.md` | “oxe milestone”, “marco de entrega”, “M-01”, “fechar milestone” *(prompt: `/oxe-milestone`)* |
134
+ | Workstream | `.oxe/workflows/workstream.md` | “oxe workstream”, “trilha paralela”, “alternar workstream” *(prompt: `/oxe-workstream`)* |
135
+ | Capabilities | `.oxe/workflows/capabilities.md` | “oxe capabilities”, “listar capabilities”, “instalar capability” *(prompt: `/oxe-capabilities`)* |
136
+ | Project | `.oxe/workflows/project.md` | “oxe project”, “gestão de projeto OXE”, “milestone + workstream + checkpoint” *(prompt: `/oxe-project`)* |
137
+ | Router | `.oxe/workflows/oxe.md` | “oxe”, “que comando usar”, entrada universal *(prompt: `/oxe`)* |
138
+ | Skill | `.oxe/workflows/skill.md` | “oxe skill”, “@executor”, “@researcher”, “listar skills”, “novo skill” *(prompt: `/oxe-skill`)* |
139
+
140
+ **Regra:** leia o Markdown indicado e execute **todos** os passos e critérios de sucesso descritos nesse arquivo. Não atalhe: crie ou atualize os arquivos em `.oxe/` conforme o workflow.
141
+
142
+ **Cursor / Copilot / Claude:** slash `/oxe-*` disponíveis: `/oxe`, `/oxe-ask`, `/oxe-obs`, `/oxe-quick`, `/oxe-scan`, `/oxe-spec`, `/oxe-discuss`, `/oxe-plan`, `/oxe-plan-agent`, `/oxe-execute`, `/oxe-verify`, `/oxe-validate-gaps`, `/oxe-retro`, `/oxe-session`, `/oxe-milestone`, `/oxe-workstream`, `/oxe-project`, `/oxe-checkpoint`, `/oxe-dashboard`, `/oxe-loop`, `/oxe-security`, `/oxe-capabilities`, `/oxe-skill`, `/oxe-next`, `/oxe-update`, `/oxe-forensics`, `/oxe-debug`, `/oxe-route`, `/oxe-research`, `/oxe-compact`, `/oxe-ui-spec`, `/oxe-ui-review` — em `~/.cursor/commands/` (gerados de `.github/prompts/` via `npm run sync:cursor`). **Não** há comando slash dedicado a review-pr — use linguagem natural + `.oxe/workflows/review-pr.md` em contexto.
143
+
144
+ ## Onde ficam as integrações (após `npx oxe-cc`)
145
+
146
+ - **Cursor:** comandos em **`~/.cursor/commands/`** (slash `/oxe-*`). Diretório alternativo: variável **`CURSOR_CONFIG_DIR`**.
147
+ - **GitHub Copilot (VS Code):** integração **workspace-first**: instruções em **`.github/copilot-instructions.md`** e **prompt files** em **`.github/prompts/`** (`oxe-*.prompt.md`). Se existir conteúdo em `~/.copilot/prompts/`, trate como **legado detectável**, não como fonte primária da IDE.
148
+ - **Copilot CLI:** com `oxe-cc --copilot-cli`, use **agent skills** em **`~/.copilot/skills/`** (`/oxe`, `/oxe-scan`, …). Depois de instalar: **`/skills reload`**. Pastas **`~/.claude/commands/`** e **`~/.copilot/commands/`** são cópia legado; **`CLAUDE_CONFIG_DIR`**, **`COPILOT_CONFIG_DIR`** e **`COPILOT_HOME`** alteram os homes CLI.
149
+ - **Multi-agente:** `oxe-cc --all-agents` (menu **6**) replica fluxos para **OpenCode**, **Gemini CLI** (`/commands reload`), **Codex**, **Windsurf**, **Antigravity**, além de Cursor/Copilot/Claude. **`XDG_CONFIG_HOME`** / **`CODEX_HOME`** afetam caminhos canónicos desses destinos. O núcleo no repo continua **`.oxe/`** (SPEC/PLAN/VERIFY em Markdown).
150
+
151
+ ## Configuração do projeto
152
+
153
+ - **`.oxe/config.json`**: fluxo (`discuss_before_plan`, `scan_max_age_days`, `compact_max_age_days`, `spec_required_sections`, …) e opcionalmente **`install`** (perfil e layout quando o utilizador corre o instalador **sem** flags IDE explícitas). Referência: `.oxe/templates/CONFIG.md`. Para ignorar o bloco `install` numa corrida: **`--no-install-config`**.
154
+ - **Legado / brownfield** (COBOL, JCL, copybooks, VB6, SQL procedures): seguir também `.oxe/workflows/references/legacy-brownfield.md` quando o repo ou o pedido indicar mainframe ou desktop legado — scan preenche os sete ficheiros sem assumir Node; plan/verify aceitam evidência por Grep/leitura/checklist.
155
+ - Sem TTY (CI): **`OXE_NO_PROMPT=1`** — padrões de layout/integração; o ficheiro `install` em `config.json` aplica-se se existir e as flags não sobrepuserem.
156
+
157
+ ## Artefatos
158
+
159
+ - `.oxe/STATE.md`, `.oxe/config.json` (opcional), `.oxe/codebase/*.md`, `.oxe/SPEC.md`, `.oxe/DISCUSS.md` (opcional), `.oxe/PLAN.md`, `.oxe/plan-agents.json` (opcional, blueprint plan-agent; schema 2 com `runId` + `lifecycle`; **`/oxe-quick`** invalida), `.oxe/plan-agent-messages/` (opcional, handoffs agente→agente; ver `.oxe/workflows/references/plan-agent-chat-protocol.md`), `.oxe/VERIFY.md`, `.oxe/QUICK.md`, `.oxe/SUMMARY.md` (opcional), `.oxe/NOTES.md`, `.oxe/RESUME.md`, `.oxe/CODEBASE-DELTA.md`, `.oxe/CHECKPOINTS.md`, `.oxe/checkpoints/*.md`, `.oxe/RESEARCH.md`, `.oxe/research/*.md`, `.oxe/VALIDATION-GAPS.md`, `.oxe/FORENSICS.md`, `.oxe/DEBUG.md`, `.oxe/UI-SPEC.md`, `.oxe/UI-REVIEW.md` (opcionais conforme trilha)
160
+ - Templates: `.oxe/templates/` (ou `..oxe/templates/` em layout aninhado)
161
+
162
+ ## CLI e SDK
163
+
164
+ - **`npx oxe-cc`** ou **`npx oxe-cc install`** — instalação (equivalentes).
165
+ - **`npx oxe-cc doctor`** — validação completa (Node, workflows do pacote vs projeto, JSON, coerência STATE, regras SPEC/PLAN, **avisos** não bloqueantes sobre estrutura dos `.md` de workflow quando aplicável).
166
+ - **`npx oxe-cc status`** — mais leve: coerência `.oxe/` + **um** próximo passo (não exige o mesmo rigor de workflows que o `doctor`). **`status --json`**: saída máquina-legível para CI (`nextStep`, `diagnostics`, `staleScan`, `staleCompact`, …). **`status --hints`**: lembretes de rotina (scan/compact antigos quando configurado); com **`--json --hints`** inclui o array **`hints`**.
167
+ - **`npx oxe-cc init-oxe`**, **`uninstall`**, **`update`** — ver `oxe-cc --help` ou README do pacote.
168
+ - **SDK (Node):** `require('oxe-cc')` expõe `runDoctorChecks`, `health`, `workflows`, `install`, `manifest`, `agents` — útil para CI (`lib/sdk/README.md`, `lib/sdk/index.d.ts`).
169
+
170
+ **WSL:** usar Node **nativo do WSL**; o `oxe-cc` recusa Node do Windows dentro do WSL (caminhos incorretos).
171
+
172
+ ## Manutenção do pacote oxe-build
173
+
174
+ Ao alterar comportamento OXE, edite primeiro **`.oxe/workflows/*.md`**; mantenha prompts em **`.github/prompts/`**, wrappers em **`commands/oxe/`** e comandos Cursor gerados pelo sync alinhados à mesma semântica. Quando alterar metadata cognitiva ou contratos de raciocínio, rode `npm run sync:runtime-metadata` e `npm run sync:cursor`.
175
+
176
+ **Autoria de workflows:** guia em **`.oxe/templates/WORKFLOW_AUTHORING.md`**. Para rever um `.md` de passo contra o guia, use o workflow **`.oxe/workflows/workflow-authoring.md`** (ou `..oxe/workflows/` no projeto alvo).
177
+ <!-- oxe-cc:install-end -->
@@ -11,7 +11,7 @@ oxe_tool_profile: read_heavy
11
11
  oxe_confidence_policy: explicit
12
12
  oxe_context_tier: standard
13
13
  oxe_contract_version: 2.0.0
14
- oxe_semantics_hash: b3f89121879267f9
14
+ oxe_semantics_hash: 4af3aaa3d86aabef
15
15
  ---
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: b3f89121879267f9
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `b3f89121879267f9`
28
+ - **Checksum semântico:** `4af3aaa3d86aabef`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/ask.md` e `.oxe/context/packs/ask.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow ask --json`
@@ -40,6 +40,6 @@ oxe_semantics_hash: b3f89121879267f9
40
40
 
41
41
  Executa o workflow **OXE ask** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
42
42
 
43
- `oxe/workflows/ask.md`
43
+ `.oxe/workflows/ask.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como pergunta e foco.
@@ -11,7 +11,7 @@ oxe_tool_profile: mixed
11
11
  oxe_confidence_policy: explicit
12
12
  oxe_context_tier: standard
13
13
  oxe_contract_version: 2.0.0
14
- oxe_semantics_hash: c2dbc0e05602cd19
14
+ oxe_semantics_hash: 35b244a016d5c65c
15
15
  ---
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: c2dbc0e05602cd19
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `c2dbc0e05602cd19`
28
+ - **Checksum semântico:** `35b244a016d5c65c`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/capabilities.md` e `.oxe/context/packs/capabilities.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow capabilities --json`
@@ -40,6 +40,6 @@ oxe_semantics_hash: c2dbc0e05602cd19
40
40
 
41
41
  Executa o workflow **OXE capabilities** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
42
42
 
43
- `oxe/workflows/capabilities.md`
43
+ `.oxe/workflows/capabilities.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como ação sobre capabilities.
@@ -11,7 +11,7 @@ oxe_tool_profile: write_bounded
11
11
  oxe_confidence_policy: explicit
12
12
  oxe_context_tier: standard
13
13
  oxe_contract_version: 2.0.0
14
- oxe_semantics_hash: 09b26a7ca32729b5
14
+ oxe_semantics_hash: 536e476616b47060
15
15
  ---
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: 09b26a7ca32729b5
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `09b26a7ca32729b5`
28
+ - **Checksum semântico:** `536e476616b47060`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/checkpoint.md` e `.oxe/context/packs/checkpoint.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow checkpoint --json`
@@ -40,6 +40,6 @@ oxe_semantics_hash: 09b26a7ca32729b5
40
40
 
41
41
  Executa o workflow **OXE checkpoint** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/checkpoint.md`
43
+ `.oxe/workflows/checkpoint.md`
44
44
 
45
45
  O **primeiro** argumento deve ser o **slug** (ex. `pre-migracao-api`); o resto é nota livre.
@@ -10,7 +10,7 @@ oxe_tool_profile: mixed
10
10
  oxe_confidence_policy: explicit
11
11
  oxe_context_tier: standard
12
12
  oxe_contract_version: 2.0.0
13
- oxe_semantics_hash: 05c86e61cfc45177
13
+ oxe_semantics_hash: ad10e8dc6f83b4fe
14
14
  ---
15
15
 
16
16
  <!-- oxe-reasoning-contract:start -->
@@ -24,7 +24,7 @@ oxe_semantics_hash: 05c86e61cfc45177
24
24
  - **Política de confiança:** explícita
25
25
  - **Tier de contexto padrão:** padrão
26
26
  - **Versão do contrato:** 2.0.0
27
- - **Checksum semântico:** `05c86e61cfc45177`
27
+ - **Checksum semântico:** `ad10e8dc6f83b4fe`
28
28
  - **Entrada de contexto prioritária:** `.oxe/context/packs/compact.md` e `.oxe/context/packs/compact.json`
29
29
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
30
30
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow compact --json`
@@ -39,6 +39,6 @@ oxe_semantics_hash: 05c86e61cfc45177
39
39
 
40
40
  Executa o workflow **OXE compact** no repositório atual. Lê e aplica **integralmente**:
41
41
 
42
- `oxe/workflows/compact.md`
42
+ `.oxe/workflows/compact.md`
43
43
 
44
44
  Atualiza os **sete** mapas em **`.oxe/codebase/`** (incremental ou bootstrap como scan), gera **`.oxe/CODEBASE-DELTA.md`** e **`.oxe/RESUME.md`**. Texto extra do utilizador: foco ou decisões/bloqueios a incluir no RESUME.
@@ -11,7 +11,7 @@ oxe_tool_profile: read_heavy
11
11
  oxe_confidence_policy: explicit
12
12
  oxe_context_tier: standard
13
13
  oxe_contract_version: 2.0.0
14
- oxe_semantics_hash: 590801b870fcbb56
14
+ oxe_semantics_hash: 37f74d8be3442fe1
15
15
  ---
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: 590801b870fcbb56
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `590801b870fcbb56`
28
+ - **Checksum semântico:** `37f74d8be3442fe1`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/dashboard.md` e `.oxe/context/packs/dashboard.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow dashboard --json`
@@ -40,6 +40,6 @@ oxe_semantics_hash: 590801b870fcbb56
40
40
 
41
41
  Executa o workflow **OXE dashboard** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
42
42
 
43
- `oxe/workflows/dashboard.md`
43
+ `.oxe/workflows/dashboard.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como foco opcional.
@@ -11,7 +11,7 @@ oxe_tool_profile: write_bounded
11
11
  oxe_confidence_policy: explicit
12
12
  oxe_context_tier: standard
13
13
  oxe_contract_version: 2.0.0
14
- oxe_semantics_hash: ee0c492eabab1723
14
+ oxe_semantics_hash: 7912f4caf80c2915
15
15
  ---
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: ee0c492eabab1723
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `ee0c492eabab1723`
28
+ - **Checksum semântico:** `7912f4caf80c2915`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/debug.md` e `.oxe/context/packs/debug.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow debug --json`
@@ -40,6 +40,6 @@ oxe_semantics_hash: ee0c492eabab1723
40
40
 
41
41
  Executa o workflow **OXE debug** no repositório atual. Lê e aplica **integralmente**:
42
42
 
43
- `oxe/workflows/debug.md`
43
+ `.oxe/workflows/debug.md`
44
44
 
45
45
  Usa o texto adicional desta mensagem como sintoma, **Tn** do PLAN se souber, ou saída de erro.
@@ -11,7 +11,7 @@ oxe_tool_profile: read_heavy
11
11
  oxe_confidence_policy: explicit
12
12
  oxe_context_tier: standard
13
13
  oxe_contract_version: 2.0.0
14
- oxe_semantics_hash: fb75dc9cf2963e3c
14
+ oxe_semantics_hash: 6994c2427094eff3
15
15
  ---
16
16
 
17
17
  <!-- oxe-reasoning-contract:start -->
@@ -25,7 +25,7 @@ oxe_semantics_hash: fb75dc9cf2963e3c
25
25
  - **Política de confiança:** explícita
26
26
  - **Tier de contexto padrão:** padrão
27
27
  - **Versão do contrato:** 2.0.0
28
- - **Checksum semântico:** `fb75dc9cf2963e3c`
28
+ - **Checksum semântico:** `6994c2427094eff3`
29
29
  - **Entrada de contexto prioritária:** `.oxe/context/packs/discuss.md` e `.oxe/context/packs/discuss.json`
30
30
  - **Regra pack-first:** ler o context pack primeiro; se estiver stale, incompleto ou ausente, cair para leitura direta com fallback explícito.
31
31
  - **Inspeção estruturada:** `oxe-cc context inspect --workflow discuss --json`
@@ -40,4 +40,4 @@ oxe_semantics_hash: fb75dc9cf2963e3c
40
40
 
41
41
  Executa o workflow **OXE discuss** no repositório atual. Lê e aplica **integralmente** o ficheiro no workspace:
42
42
 
43
- `oxe/workflows/discuss.md`
43
+ `.oxe/workflows/discuss.md`