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.
- package/.cursor/commands/oxe-ask.md +3 -3
- package/.cursor/commands/oxe-capabilities.md +3 -3
- package/.cursor/commands/oxe-checkpoint.md +3 -3
- package/.cursor/commands/oxe-compact.md +3 -3
- package/.cursor/commands/oxe-dashboard.md +3 -3
- package/.cursor/commands/oxe-debug.md +3 -3
- package/.cursor/commands/oxe-discuss.md +3 -3
- package/.cursor/commands/oxe-execute.md +7 -4
- package/.cursor/commands/oxe-forensics.md +3 -3
- package/.cursor/commands/oxe-help.md +3 -3
- package/.cursor/commands/oxe-loop.md +3 -3
- package/.cursor/commands/oxe-milestone.md +3 -3
- package/.cursor/commands/oxe-next.md +3 -3
- package/.cursor/commands/oxe-obs.md +3 -3
- package/.cursor/commands/oxe-plan-agent.md +3 -3
- package/.cursor/commands/oxe-plan.md +3 -3
- package/.cursor/commands/oxe-project.md +3 -3
- package/.cursor/commands/oxe-quick.md +3 -3
- package/.cursor/commands/oxe-research.md +3 -3
- package/.cursor/commands/oxe-retro.md +3 -3
- package/.cursor/commands/oxe-review-pr.md +3 -3
- package/.cursor/commands/oxe-route.md +3 -3
- package/.cursor/commands/oxe-scan.md +3 -3
- package/.cursor/commands/oxe-security.md +3 -3
- package/.cursor/commands/oxe-session.md +4 -4
- package/.cursor/commands/oxe-ship.md +45 -0
- package/.cursor/commands/oxe-skill.md +3 -3
- package/.cursor/commands/oxe-spec.md +3 -3
- package/.cursor/commands/oxe-ui-review.md +3 -3
- package/.cursor/commands/oxe-ui-spec.md +3 -3
- package/.cursor/commands/oxe-update.md +3 -3
- package/.cursor/commands/oxe-validate-gaps.md +3 -3
- package/.cursor/commands/oxe-verify.md +6 -3
- package/.cursor/commands/oxe-workstream.md +3 -3
- package/.cursor/commands/oxe.md +6 -6
- package/.github/copilot-instructions.md +94 -4
- package/.github/prompts/oxe-ask.prompt.md +3 -3
- package/.github/prompts/oxe-capabilities.prompt.md +3 -3
- package/.github/prompts/oxe-checkpoint.prompt.md +3 -3
- package/.github/prompts/oxe-compact.prompt.md +3 -3
- package/.github/prompts/oxe-dashboard.prompt.md +3 -3
- package/.github/prompts/oxe-debug.prompt.md +3 -3
- package/.github/prompts/oxe-discuss.prompt.md +3 -3
- package/.github/prompts/oxe-execute.prompt.md +7 -4
- package/.github/prompts/oxe-forensics.prompt.md +3 -3
- package/.github/prompts/oxe-help.prompt.md +3 -3
- package/.github/prompts/oxe-loop.prompt.md +3 -3
- package/.github/prompts/oxe-milestone.prompt.md +3 -3
- package/.github/prompts/oxe-next.prompt.md +3 -3
- package/.github/prompts/oxe-obs.prompt.md +3 -3
- package/.github/prompts/oxe-plan-agent.prompt.md +3 -3
- package/.github/prompts/oxe-plan.prompt.md +3 -3
- package/.github/prompts/oxe-project.prompt.md +3 -3
- package/.github/prompts/oxe-quick.prompt.md +3 -3
- package/.github/prompts/oxe-research.prompt.md +3 -3
- package/.github/prompts/oxe-retro.prompt.md +3 -3
- package/.github/prompts/oxe-review-pr.prompt.md +3 -3
- package/.github/prompts/oxe-route.prompt.md +3 -3
- package/.github/prompts/oxe-scan.prompt.md +3 -3
- package/.github/prompts/oxe-security.prompt.md +3 -3
- package/.github/prompts/oxe-session.prompt.md +4 -4
- package/.github/prompts/oxe-ship.prompt.md +45 -0
- package/.github/prompts/oxe-skill.prompt.md +3 -3
- package/.github/prompts/oxe-spec.prompt.md +3 -3
- package/.github/prompts/oxe-ui-review.prompt.md +3 -3
- package/.github/prompts/oxe-ui-spec.prompt.md +3 -3
- package/.github/prompts/oxe-update.prompt.md +3 -3
- package/.github/prompts/oxe-validate-gaps.prompt.md +3 -3
- package/.github/prompts/oxe-verify.prompt.md +6 -3
- package/.github/prompts/oxe-workstream.prompt.md +3 -3
- package/.github/prompts/oxe.prompt.md +5 -5
- package/AGENTS.md +43 -28
- package/CHANGELOG.md +193 -0
- package/README.md +610 -529
- package/bin/banner.txt +1 -1
- package/bin/lib/oxe-agent-install.cjs +69 -69
- package/bin/lib/oxe-azure.cjs +1445 -1445
- package/bin/lib/oxe-context-engine.cjs +867 -867
- package/bin/lib/oxe-dashboard.cjs +76 -28
- package/bin/lib/oxe-operational.cjs +2144 -1340
- package/bin/lib/oxe-project-health.cjs +483 -1
- package/bin/lib/oxe-runtime-semantics.cjs +12 -0
- package/bin/oxe-cc.js +554 -152
- package/commands/oxe/ask.md +7 -3
- package/commands/oxe/capabilities.md +2 -2
- package/commands/oxe/checkpoint.md +3 -3
- package/commands/oxe/compact.md +3 -3
- package/commands/oxe/dashboard.md +2 -2
- package/commands/oxe/debug.md +3 -3
- package/commands/oxe/discuss.md +2 -2
- package/commands/oxe/execute.md +7 -4
- package/commands/oxe/forensics.md +3 -3
- package/commands/oxe/help.md +2 -2
- package/commands/oxe/loop.md +3 -3
- package/commands/oxe/milestone.md +3 -3
- package/commands/oxe/next.md +3 -3
- package/commands/oxe/obs.md +3 -3
- package/commands/oxe/oxe.md +5 -5
- package/commands/oxe/plan-agent.md +2 -2
- package/commands/oxe/plan.md +2 -2
- package/commands/oxe/project.md +3 -3
- package/commands/oxe/quick.md +2 -2
- package/commands/oxe/research.md +3 -3
- package/commands/oxe/retro.md +3 -3
- package/commands/oxe/review-pr.md +3 -3
- package/commands/oxe/route.md +3 -3
- package/commands/oxe/scan.md +3 -3
- package/commands/oxe/security.md +3 -3
- package/commands/oxe/session.md +4 -4
- package/commands/oxe/ship.md +49 -0
- package/commands/oxe/skill.md +2 -2
- package/commands/oxe/spec.md +4 -4
- package/commands/oxe/ui-review.md +3 -3
- package/commands/oxe/ui-spec.md +3 -3
- package/commands/oxe/update.md +2 -2
- package/commands/oxe/validate-gaps.md +3 -3
- package/commands/oxe/verify.md +7 -4
- package/commands/oxe/workstream.md +3 -3
- package/lib/runtime/audit/audit-trail.d.ts +71 -0
- package/lib/runtime/audit/audit-trail.js +154 -0
- package/lib/runtime/audit/index.d.ts +2 -0
- package/lib/runtime/audit/index.js +18 -0
- package/lib/runtime/audit/policy-pack.d.ts +15 -0
- package/lib/runtime/audit/policy-pack.js +57 -0
- package/lib/runtime/context/context-pack-builder.d.ts +15 -0
- package/lib/runtime/context/context-pack-builder.js +42 -0
- package/lib/runtime/context/context-pack-store.d.ts +38 -0
- package/lib/runtime/context/context-pack-store.js +142 -0
- package/lib/runtime/context/context-profiles.d.ts +11 -0
- package/lib/runtime/context/context-profiles.js +51 -0
- package/lib/runtime/context/index.d.ts +2 -0
- package/lib/runtime/context/index.js +2 -0
- package/lib/runtime/decision/decision-engine.d.ts +43 -0
- package/lib/runtime/decision/decision-engine.js +127 -0
- package/lib/runtime/decision/decision-memo.d.ts +53 -0
- package/lib/runtime/decision/decision-memo.js +173 -0
- package/lib/runtime/decision/index.d.ts +2 -0
- package/lib/runtime/decision/index.js +18 -0
- package/lib/runtime/delivery/branch-manager.d.ts +1 -0
- package/lib/runtime/delivery/branch-manager.js +7 -0
- package/lib/runtime/delivery/ci-checks.js +34 -1
- package/lib/runtime/delivery/delivery-records.d.ts +34 -0
- package/lib/runtime/delivery/delivery-records.js +48 -0
- package/lib/runtime/delivery/index.d.ts +2 -0
- package/lib/runtime/delivery/index.js +2 -0
- package/lib/runtime/delivery/promotion-pipeline.d.ts +63 -0
- package/lib/runtime/delivery/promotion-pipeline.js +224 -0
- package/lib/runtime/gate/gate-manager.d.ts +41 -0
- package/lib/runtime/gate/gate-manager.js +108 -1
- package/lib/runtime/index.d.ts +5 -2
- package/lib/runtime/index.js +7 -1
- package/lib/runtime/models/gate-decision.d.ts +4 -1
- package/lib/runtime/models/workspace.d.ts +3 -0
- package/lib/runtime/plugins/capability-adapter.d.ts +12 -0
- package/lib/runtime/plugins/capability-adapter.js +204 -0
- package/lib/runtime/plugins/capability-matrix.d.ts +25 -0
- package/lib/runtime/plugins/capability-matrix.js +90 -0
- package/lib/runtime/plugins/index.d.ts +3 -0
- package/lib/runtime/plugins/index.js +3 -0
- package/lib/runtime/plugins/plugin-abi.d.ts +2 -0
- package/lib/runtime/plugins/plugin-manifest.d.ts +22 -0
- package/lib/runtime/plugins/plugin-manifest.js +95 -0
- package/lib/runtime/plugins/plugin-registry.d.ts +46 -0
- package/lib/runtime/plugins/plugin-registry.js +84 -2
- package/lib/runtime/policy/policy-engine.d.ts +47 -1
- package/lib/runtime/policy/policy-engine.js +172 -9
- package/lib/runtime/projection/projection-engine.d.ts +9 -1
- package/lib/runtime/projection/projection-engine.js +73 -3
- package/lib/runtime/reducers/run-state-reducer.d.ts +26 -0
- package/lib/runtime/reducers/run-state-reducer.js +117 -1
- package/lib/runtime/scheduler/agent-registry.d.ts +44 -0
- package/lib/runtime/scheduler/agent-registry.js +96 -0
- package/lib/runtime/scheduler/agent-roles.d.ts +54 -0
- package/lib/runtime/scheduler/agent-roles.js +62 -0
- package/lib/runtime/scheduler/index.d.ts +3 -0
- package/lib/runtime/scheduler/index.js +3 -0
- package/lib/runtime/scheduler/multi-agent-coordinator.d.ts +45 -1
- package/lib/runtime/scheduler/multi-agent-coordinator.js +234 -35
- package/lib/runtime/scheduler/run-journal.d.ts +18 -0
- package/lib/runtime/scheduler/run-journal.js +54 -0
- package/lib/runtime/scheduler/scheduler.d.ts +29 -1
- package/lib/runtime/scheduler/scheduler.js +387 -14
- package/lib/runtime/verification/index.d.ts +1 -0
- package/lib/runtime/verification/index.js +1 -0
- package/lib/runtime/verification/verification-compiler.d.ts +43 -0
- package/lib/runtime/verification/verification-compiler.js +137 -0
- package/lib/runtime/verification/verification-manifest.d.ts +67 -0
- package/lib/runtime/verification/verification-manifest.js +179 -0
- package/lib/runtime/workspace/strategies/ephemeral-container.d.ts +1 -0
- package/lib/runtime/workspace/strategies/ephemeral-container.js +4 -0
- package/lib/runtime/workspace/strategies/git-worktree.d.ts +1 -0
- package/lib/runtime/workspace/strategies/git-worktree.js +2 -0
- package/lib/runtime/workspace/strategies/inplace.d.ts +1 -0
- package/lib/runtime/workspace/strategies/inplace.js +2 -0
- package/lib/runtime/workspace/workspace-manager.d.ts +2 -1
- package/lib/sdk/README.md +9 -9
- package/lib/sdk/index.cjs +33 -24
- package/lib/sdk/index.d.ts +149 -14
- package/oxe/templates/ACTIVE-RUN.template.json +32 -32
- package/oxe/templates/CAPABILITIES.template.md +7 -7
- package/oxe/templates/CAPABILITY.template.md +45 -45
- package/oxe/templates/CHECKPOINTS.template.md +7 -7
- package/oxe/templates/EXECUTION-RUNTIME.template.md +68 -68
- package/oxe/templates/HYPOTHESES.template.md +33 -33
- package/oxe/templates/LESSONS-METRICS.template.json +13 -13
- package/oxe/templates/NOTES.template.md +16 -16
- package/oxe/templates/PLAN-REVIEW.template.md +31 -31
- package/oxe/templates/SESSION.template.md +34 -34
- package/oxe/templates/SKILL.template.md +26 -26
- package/oxe/templates/STATE.md +55 -55
- package/oxe/templates/WORKFLOW_AUTHORING.md +18 -18
- package/oxe/workflows/ask.md +96 -92
- package/oxe/workflows/capabilities.md +25 -25
- package/oxe/workflows/checkpoint.md +14 -10
- package/oxe/workflows/dashboard.md +33 -33
- package/oxe/workflows/debug.md +19 -15
- package/oxe/workflows/discuss.md +12 -12
- package/oxe/workflows/execute.md +44 -2
- package/oxe/workflows/forensics.md +13 -9
- package/oxe/workflows/help.md +352 -304
- package/oxe/workflows/loop.md +17 -13
- package/oxe/workflows/next.md +22 -22
- package/oxe/workflows/obs.md +4 -0
- package/oxe/workflows/oxe.md +64 -31
- package/oxe/workflows/plan-agent.md +9 -9
- package/oxe/workflows/project.md +6 -1
- package/oxe/workflows/quick.md +10 -10
- package/oxe/workflows/references/reasoning-discovery.md +28 -28
- package/oxe/workflows/references/reasoning-execution.md +29 -29
- package/oxe/workflows/references/reasoning-planning.md +32 -32
- package/oxe/workflows/references/reasoning-review.md +29 -29
- package/oxe/workflows/references/reasoning-status.md +24 -24
- package/oxe/workflows/references/robustness-elevation.md +295 -295
- package/oxe/workflows/references/workflow-runtime-contracts.json +952 -907
- package/oxe/workflows/research.md +32 -28
- package/oxe/workflows/retro.md +4 -0
- package/oxe/workflows/review-pr.md +15 -11
- package/oxe/workflows/route.md +16 -16
- package/oxe/workflows/scan.md +4 -0
- package/oxe/workflows/security.md +14 -10
- package/oxe/workflows/session.md +213 -197
- package/oxe/workflows/ship.md +142 -0
- package/oxe/workflows/skill.md +44 -44
- package/oxe/workflows/spec.md +15 -0
- package/oxe/workflows/ui-review.md +20 -16
- package/oxe/workflows/ui-spec.md +7 -3
- package/oxe/workflows/validate-gaps.md +13 -9
- package/oxe/workflows/verify-audit.md +73 -73
- package/oxe/workflows/verify.md +52 -3
- package/package.json +92 -92
- package/packages/runtime/package.json +17 -17
- package/packages/runtime/src/audit/audit-trail.ts +243 -0
- package/packages/runtime/src/audit/index.ts +2 -0
- package/packages/runtime/src/audit/policy-pack.ts +62 -0
- package/packages/runtime/src/compiler/graph-compiler.ts +245 -245
- package/packages/runtime/src/compiler/index.ts +1 -1
- package/packages/runtime/src/context/context-pack-builder.ts +259 -193
- package/packages/runtime/src/context/context-pack-store.ts +197 -0
- package/packages/runtime/src/context/context-profiles.ts +60 -0
- package/packages/runtime/src/context/index.ts +3 -1
- package/packages/runtime/src/decision/decision-engine.ts +174 -0
- package/packages/runtime/src/decision/decision-memo.ts +211 -0
- package/packages/runtime/src/decision/index.ts +2 -0
- package/packages/runtime/src/delivery/branch-manager.ts +91 -84
- package/packages/runtime/src/delivery/ci-checks.ts +285 -252
- package/packages/runtime/src/delivery/delivery-records.ts +75 -0
- package/packages/runtime/src/delivery/index.ts +5 -3
- package/packages/runtime/src/delivery/pr-manager.ts +112 -112
- package/packages/runtime/src/delivery/promotion-pipeline.ts +334 -0
- package/packages/runtime/src/events/bus.ts +92 -92
- package/packages/runtime/src/events/catalog.ts +29 -29
- package/packages/runtime/src/events/envelope.ts +14 -14
- package/packages/runtime/src/events/index.ts +3 -3
- package/packages/runtime/src/evidence/evidence-store.ts +130 -130
- package/packages/runtime/src/evidence/index.ts +1 -1
- package/packages/runtime/src/gate/gate-manager.ts +289 -137
- package/packages/runtime/src/gate/index.ts +1 -1
- package/packages/runtime/src/index.ts +41 -32
- package/packages/runtime/src/models/attempt.ts +19 -19
- package/packages/runtime/src/models/evidence.ts +21 -21
- package/packages/runtime/src/models/gate-decision.ts +25 -21
- package/packages/runtime/src/models/index.ts +8 -8
- package/packages/runtime/src/models/run.ts +24 -24
- package/packages/runtime/src/models/session.ts +11 -11
- package/packages/runtime/src/models/verification-result.ts +10 -10
- package/packages/runtime/src/models/work-item.ts +25 -25
- package/packages/runtime/src/models/workspace.ts +31 -28
- package/packages/runtime/src/plugins/capability-adapter.ts +206 -0
- package/packages/runtime/src/plugins/capability-matrix.ts +126 -0
- package/packages/runtime/src/plugins/index.ts +5 -2
- package/packages/runtime/src/plugins/plugin-abi.ts +97 -95
- package/packages/runtime/src/plugins/plugin-manifest.ts +118 -0
- package/packages/runtime/src/plugins/plugin-registry.ts +232 -119
- package/packages/runtime/src/policy/index.ts +1 -1
- package/packages/runtime/src/policy/policy-engine.ts +330 -113
- package/packages/runtime/src/projection/index.ts +1 -1
- package/packages/runtime/src/projection/projection-engine.ts +328 -249
- package/packages/runtime/src/reducers/debug-reducer.ts +36 -36
- package/packages/runtime/src/reducers/index.ts +2 -2
- package/packages/runtime/src/reducers/run-state-reducer.ts +269 -127
- package/packages/runtime/src/scheduler/agent-registry.ts +132 -0
- package/packages/runtime/src/scheduler/agent-roles.ts +109 -0
- package/packages/runtime/src/scheduler/index.ts +4 -1
- package/packages/runtime/src/scheduler/multi-agent-coordinator.ts +521 -231
- package/packages/runtime/src/scheduler/run-journal.ts +62 -0
- package/packages/runtime/src/scheduler/scheduler.ts +722 -281
- package/packages/runtime/src/verification/index.ts +2 -1
- package/packages/runtime/src/verification/verification-compiler.ts +436 -225
- package/packages/runtime/src/verification/verification-manifest.ts +252 -0
- package/packages/runtime/src/workspace/index.ts +5 -5
- package/packages/runtime/src/workspace/strategies/ephemeral-container.ts +126 -121
- package/packages/runtime/src/workspace/strategies/git-worktree.ts +79 -77
- package/packages/runtime/src/workspace/strategies/inplace.ts +38 -35
- package/packages/runtime/src/workspace/workspace-manager.ts +16 -15
- package/packages/runtime/tsconfig.json +17 -17
- package/vscode-extension/.vscodeignore +7 -7
- package/vscode-extension/oxe-agents-1.0.0.vsix +0 -0
- package/vscode-extension/package.json +185 -185
- package/vscode-extension/src/extension.js +310 -310
- package/vscode-extension/src/shared/contextLoader.js +137 -137
- package/vscode-extension/src/shared/contractBuilder.js +159 -159
- 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:
|
|
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:** `
|
|
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
|
-
|
|
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ê
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
43
|
+
`.oxe/workflows/workstream.md`
|
|
44
44
|
|
|
45
45
|
Usa o texto adicional desta mensagem como subcomando e contexto.
|
package/.cursor/commands/oxe.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: "OXE — Entrada universal: próximo passo / roteamento / help
|
|
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:
|
|
12
|
+
oxe_semantics_hash: 4a8d0d23c56065a7
|
|
13
13
|
---
|
|
14
14
|
|
|
15
|
-
OXE — Entrada universal: próximo passo / roteamento / help
|
|
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:** `
|
|
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
|
-
|
|
43
|
+
`.oxe/workflows/oxe.md`
|
|
44
44
|
|
|
45
|
-
`$ARGUMENTS`: vazio → próximo passo; texto → roteamento; "help" →
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
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:
|
|
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:** `
|
|
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
|
-
|
|
43
|
+
`.oxe/workflows/discuss.md`
|