oxe-cc 1.12.0 → 1.16.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/.github/dependabot.yml +31 -0
- package/.github/workflows/ci.yml +141 -56
- package/.github/workflows/release.yml +114 -89
- package/CHANGELOG.md +866 -754
- package/README.md +600 -736
- package/bin/lib/oxe-agent-install.cjs +299 -284
- package/bin/lib/oxe-artifact-catalog.cjs +376 -0
- package/bin/lib/oxe-command-registry.cjs +31 -0
- package/bin/lib/oxe-context-engine.cjs +11 -11
- package/bin/lib/oxe-core-command-handlers.cjs +82 -0
- package/bin/lib/oxe-dashboard.cjs +140 -140
- package/bin/lib/oxe-manifest.cjs +20 -20
- package/bin/lib/oxe-npm-version.cjs +6 -4
- package/bin/lib/oxe-plugin-cli.cjs +95 -0
- package/bin/lib/oxe-plugins.cjs +94 -3
- package/bin/lib/oxe-process.cjs +67 -0
- package/bin/lib/oxe-project-health.cjs +2846 -2781
- package/bin/lib/oxe-runtime-semantics.cjs +68 -69
- package/bin/oxe-cc.js +369 -353
- package/docs/INTEGRATION.md +182 -0
- package/docs/QUALITY-GATES.md +46 -0
- package/docs/RELEASE-READINESS.md +86 -61
- package/docs/RUNTIME-SMOKE-MATRIX.md +137 -135
- package/docs/oxe-artifact-map.html +1172 -0
- package/lib/sdk/index.cjs +20 -0
- package/lib/sdk/index.d.ts +971 -876
- package/lib/sdk/index.types.ts +933 -0
- package/oxe/templates/PLUGINS.md +8 -1
- package/oxe/templates/STATE-REFERENCE.md +125 -0
- package/oxe/templates/STATE.md +11 -121
- package/oxe/workflows/help.md +2 -0
- package/package.json +129 -108
- package/packages/runtime/package.json +18 -18
- package/packages/runtime/src/evidence/evidence-store.ts +2 -2
- package/packages/runtime/src/scheduler/multi-agent-coordinator.ts +728 -728
- package/packages/runtime/src/workspace/strategies/git-worktree.ts +24 -24
- package/packages/runtime/tsconfig.json +8 -2
- package/vscode-extension/.vscodeignore +2 -0
- package/vscode-extension/package.json +193 -185
- package/vscode-extension/src/extension.js +11 -1
package/oxe/templates/PLUGINS.md
CHANGED
|
@@ -4,7 +4,14 @@ Plugins OXE são módulos CJS colocados em **`.oxe/plugins/`** que se executam e
|
|
|
4
4
|
|
|
5
5
|
## Instalação
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Para instalar um plugin publicado no npm, use um nome de pacote npm válido. O prefixo `npm:` é opcional:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
oxe-cc plugins install @scope/meu-plugin 1.2.3
|
|
11
|
+
# equivalente: oxe-cc plugins install npm:@scope/meu-plugin 1.2.3
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
O comando `plugins install` aceita somente pacotes npm; ele não instala paths, URLs ou arquivos locais. Para um plugin local, crie um arquivo `.cjs` em `.oxe/plugins/`:
|
|
8
15
|
|
|
9
16
|
```js
|
|
10
17
|
// .oxe/plugins/meu-plugin.cjs
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
# OXE — Seções opcionais do STATE.md (referência)
|
|
2
|
+
|
|
3
|
+
Estas seções **não** vêm no `STATE.md` enxuto criado no install. O agente (ou o
|
|
4
|
+
runtime, via `runtime project`) deve **anexá-las ao `.oxe/STATE.md` sob demanda**,
|
|
5
|
+
apenas quando o recurso correspondente passa a ser usado. Copie só a seção
|
|
6
|
+
necessária — mantenha a porta de entrada curta. Cada bloco abaixo é
|
|
7
|
+
auto-contido e usa o mesmo formato que o `oxe-cc doctor`/`status` espera ler.
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Último scan
|
|
12
|
+
|
|
13
|
+
- **Data:** (use **YYYY-MM-DD** para o `oxe-cc doctor` avisar scan antigo com `scan_max_age_days` em `.oxe/config.json`)
|
|
14
|
+
- **Notas:** (opcional)
|
|
15
|
+
|
|
16
|
+
## Último compact (codebase + RESUME) (opcional)
|
|
17
|
+
|
|
18
|
+
- **Data:** (**YYYY-MM-DD** — preenchido por **`/oxe-compact`**: refresh incremental dos mapas em `.oxe/codebase/` + `CODEBASE-DELTA.md` + `RESUME.md`)
|
|
19
|
+
- **Notas:** (opcional; ex.: "só STRUCTURE e TESTING")
|
|
20
|
+
- **last_retro:** (YYYY-MM-DD — preenchido por **`/oxe-retro`** ao concluir retrospectiva; lido por `oxe-cc doctor` para rastrear ciclos sem lições)
|
|
21
|
+
|
|
22
|
+
## Contexto do plano / quick (opcional)
|
|
23
|
+
|
|
24
|
+
- **Spec / plano:** (revisão informal ou data de `.oxe/SPEC.md` / `.oxe/PLAN.md`)
|
|
25
|
+
- **Última onda executada:** (número ou —)
|
|
26
|
+
- **Tarefas concluídas:** (ex.: T1, T2 ou passos 1–3 do QUICK.md)
|
|
27
|
+
|
|
28
|
+
## Checkpoints de aprovação (opcional)
|
|
29
|
+
|
|
30
|
+
- **checkpoint_status:** `pending_approval` | `approved` | `rejected` | `overridden` | —
|
|
31
|
+
- **checkpoint_ref:** `.oxe/CHECKPOINTS.md` ou artefato de sessão correspondente
|
|
32
|
+
- **Notas:** (ex.: aguardando aprovação para Onda 2)
|
|
33
|
+
|
|
34
|
+
## Runtime operacional (opcional)
|
|
35
|
+
|
|
36
|
+
- **runtime_status:** `planned` | `running` | `paused` | `waiting_approval` | `failed` | `completed` | `replaying` | `aborted` | —
|
|
37
|
+
- **runtime_ref:** `.oxe/EXECUTION-RUNTIME.md` ou artefato de sessão correspondente
|
|
38
|
+
- **active_run_ref:** `.oxe/ACTIVE-RUN.json` ou artefato de sessão correspondente
|
|
39
|
+
- **events_ref:** `.oxe/OXE-EVENTS.ndjson` ou artefato de sessão correspondente
|
|
40
|
+
- **Notas:** (agentes ativos, bloqueio principal, handoff pendente)
|
|
41
|
+
|
|
42
|
+
## Revisão do plano (opcional — dashboard / aprovação)
|
|
43
|
+
|
|
44
|
+
- **plan_review_status:** `draft` | `in_review` | `approved` | `rejected` | `needs_revision` | —
|
|
45
|
+
- **plan_review_updated:** (ISO legível — ex.: `2026-04-10T14:22:00-03:00`)
|
|
46
|
+
- **plan_review_ref:** `.oxe/PLAN-REVIEW.md` ou artefato de sessão correspondente
|
|
47
|
+
- **Notas:** (ex.: aprovado para execute; revisão pendente da onda 2)
|
|
48
|
+
|
|
49
|
+
## Blueprint de agentes (sessão) (opcional — `/oxe-plan-agent`)
|
|
50
|
+
|
|
51
|
+
Espelho do **`.oxe/plan-agents.json`** ativo (schema ≥ 2). Atualizar em **`/oxe-plan-agent`**, **`/oxe-execute`**, **`/oxe-verify`**, **`/oxe-quick`** quando o lifecycle mudar.
|
|
52
|
+
|
|
53
|
+
- **run_id:** (igual a `runId` no JSON; — se não houver blueprint)
|
|
54
|
+
- **lifecycle_status:** `pending_execute` | `executing` | `closed` | `invalidated` | —
|
|
55
|
+
- **Última onda (execute):** (número ou —)
|
|
56
|
+
- **Notas:** (ex.: invalidado por quick; mensagens em `.oxe/plan-agent-messages/`)
|
|
57
|
+
|
|
58
|
+
## Quick agents (sessão) (opcional — `/oxe-quick` com PDDA)
|
|
59
|
+
|
|
60
|
+
Preenchido por **`/oxe-quick`** quando Plan-Driven Dynamic Agents lean estiver ativo.
|
|
61
|
+
|
|
62
|
+
- **quick_id:** (ex.: `quick-2026-04-05-a1b2c3` — gerado por `/oxe-quick`)
|
|
63
|
+
- **quick_agents_status:** `active` | `done` | `invalidated` | —
|
|
64
|
+
- **Notas:** (ex.: invalidado ao iniciar novo quick ou promover a spec/plan)
|
|
65
|
+
|
|
66
|
+
## Loop (sessão) (opcional — `/oxe-loop`)
|
|
67
|
+
|
|
68
|
+
Preenchido por **`/oxe-loop`** durante retry iterativo de onda.
|
|
69
|
+
|
|
70
|
+
- **loop_onda:** (número da onda em retry, ex.: `2`)
|
|
71
|
+
- **loop_iteracao:** (tentativa atual / máximo, ex.: `2/3`)
|
|
72
|
+
- **loop_status:** `retrying` | `passed` | `escalated` | —
|
|
73
|
+
- **Notas:** (ex.: escalado para `/oxe-forensics` após 3 tentativas)
|
|
74
|
+
|
|
75
|
+
## Checklist da onda OXE (opcional — workflow execute)
|
|
76
|
+
|
|
77
|
+
_(O agente pode preencher após cada onda.)_
|
|
78
|
+
|
|
79
|
+
- [ ] Onda N — pré-requisitos conferidos
|
|
80
|
+
- [ ] Onda N — implementação concluída
|
|
81
|
+
- [ ] Onda N — **Verificar** executado ou agendado
|
|
82
|
+
|
|
83
|
+
## Milestone ativo (opcional — `/oxe-milestone`)
|
|
84
|
+
|
|
85
|
+
- **ID:** (ex.: M-01 — ou — se não houver milestone ativo)
|
|
86
|
+
- **Nome:** (ex.: v1.0 — autenticação básica)
|
|
87
|
+
- **Iniciado:** (YYYY-MM-DD)
|
|
88
|
+
- **Progresso:** (N/M critérios verificados)
|
|
89
|
+
|
|
90
|
+
## Último milestone encerrado (opcional)
|
|
91
|
+
|
|
92
|
+
- **ID:** —
|
|
93
|
+
- **Data de encerramento:** —
|
|
94
|
+
- **Artefatos:** `.oxe/milestones/M-NN/`
|
|
95
|
+
|
|
96
|
+
## Workstreams ativos (opcional — `/oxe-workstream`)
|
|
97
|
+
|
|
98
|
+
- (nenhum ou lista de nomes: ex.: `feature-billing`, `bugfix-auth`)
|
|
99
|
+
|
|
100
|
+
## Workstream ativo (contexto atual)
|
|
101
|
+
|
|
102
|
+
- (nome do workstream ativo — ou — para pipeline principal)
|
|
103
|
+
|
|
104
|
+
## Memory (sidecars de sessão) (opcional — `/oxe-memory`)
|
|
105
|
+
|
|
106
|
+
Sidecars de memória persistente por agente/sessão. Armazenados em `.oxe/memory/`.
|
|
107
|
+
|
|
108
|
+
- (nenhum ou lista: ex.: `architect-2025-01-15.md`, `researcher-auth-2025-01-14.md`)
|
|
109
|
+
|
|
110
|
+
## Camadas de memória (contrato)
|
|
111
|
+
|
|
112
|
+
- **memory_read_order:** `runtime_state -> session_memory -> project_memory -> evidence`
|
|
113
|
+
- **session_memory_ref:** `SESSION.md` ou —
|
|
114
|
+
- **project_memory_ref:** `.oxe/global/LESSONS.md`
|
|
115
|
+
- **evidence_ref:** `INVESTIGATIONS.md`, `VERIFY.md` e derivados
|
|
116
|
+
|
|
117
|
+
## Capabilities nativas (opcional)
|
|
118
|
+
|
|
119
|
+
- **capabilities_ref:** `.oxe/CAPABILITIES.md`
|
|
120
|
+
- **Capabilities ativas:** (IDs ou —)
|
|
121
|
+
|
|
122
|
+
## Investigações estruturadas (opcional)
|
|
123
|
+
|
|
124
|
+
- **investigations_ref:** `.oxe/INVESTIGATIONS.md` ou índice de sessão
|
|
125
|
+
- **Última investigação:** (path ou —)
|
package/oxe/templates/STATE.md
CHANGED
|
@@ -1,140 +1,30 @@
|
|
|
1
1
|
# OXE — Estado
|
|
2
2
|
|
|
3
|
+
> Porta de entrada enxuta do projeto. Mantenha curto: só o que orienta o próximo passo.
|
|
4
|
+
> Catálogo completo dos artefatos do `.oxe/`: veja **`.oxe/README.md`** ou rode **`oxe-cc map`**.
|
|
5
|
+
> Seções avançadas (runtime, blueprint de agentes, milestones, workstreams, loop, memória)
|
|
6
|
+
> são opcionais e devem ser anexadas **sob demanda** quando o recurso for usado —
|
|
7
|
+
> modelo em `oxe/templates/STATE-REFERENCE.md`.
|
|
8
|
+
|
|
3
9
|
## Fase atual
|
|
4
10
|
|
|
5
|
-
`initial` —
|
|
11
|
+
`initial` — após o primeiro scan use: `scan_complete` | `spec_ready` | `discuss_complete` | `plan_ready` | `quick_active` | `executing` | `verify_complete` | `verify_failed`
|
|
6
12
|
|
|
7
13
|
## Sessão ativa (opcional — `/oxe-session`)
|
|
8
14
|
|
|
9
15
|
- **active_session:** (path relativo a `.oxe/` — ex.: `sessions/s001-auth-redesign` — ou — se nenhuma)
|
|
10
16
|
- **session_id:** (ex.: `s001` — ou —)
|
|
11
17
|
|
|
12
|
-
##
|
|
13
|
-
|
|
14
|
-
- **Data:** (use **YYYY-MM-DD** para o `oxe-cc doctor` avisar scan antigo com `scan_max_age_days` em `.oxe/config.json`)
|
|
15
|
-
- **Notas:** (opcional)
|
|
16
|
-
|
|
17
|
-
## Último compact (codebase + RESUME) (opcional)
|
|
18
|
-
|
|
19
|
-
- **Data:** (**YYYY-MM-DD** — preenchido por **`/oxe-compact`**: refresh incremental dos mapas em `.oxe/codebase/` + `CODEBASE-DELTA.md` + `RESUME.md`)
|
|
20
|
-
- **Notas:** (opcional; ex.: "só STRUCTURE e TESTING")
|
|
21
|
-
- **last_retro:** (YYYY-MM-DD — preenchido por **`/oxe-retro`** ao concluir retrospectiva; lido por `oxe-cc doctor` para rastrear ciclos sem lições)
|
|
22
|
-
|
|
23
|
-
## Contexto do plano / quick (opcional)
|
|
24
|
-
|
|
25
|
-
- **Spec / plano:** (revisão informal ou data de `.oxe/SPEC.md` / `.oxe/PLAN.md`)
|
|
26
|
-
- **Última onda executada:** (número ou —)
|
|
27
|
-
- **Tarefas concluídas:** (ex.: T1, T2 ou passos 1–3 do QUICK.md)
|
|
28
|
-
|
|
29
|
-
## Checkpoints de aprovação (opcional)
|
|
30
|
-
|
|
31
|
-
- **checkpoint_status:** `pending_approval` | `approved` | `rejected` | `overridden` | —
|
|
32
|
-
- **checkpoint_ref:** `.oxe/CHECKPOINTS.md` ou artefato de sessão correspondente
|
|
33
|
-
- **Notas:** (ex.: aguardando aprovação para Onda 2)
|
|
34
|
-
|
|
35
|
-
## Runtime operacional (opcional)
|
|
36
|
-
|
|
37
|
-
- **runtime_status:** `planned` | `running` | `paused` | `waiting_approval` | `failed` | `completed` | `replaying` | `aborted` | —
|
|
38
|
-
- **runtime_ref:** `.oxe/EXECUTION-RUNTIME.md` ou artefato de sessão correspondente
|
|
39
|
-
- **active_run_ref:** `.oxe/ACTIVE-RUN.json` ou artefato de sessão correspondente
|
|
40
|
-
- **events_ref:** `.oxe/OXE-EVENTS.ndjson` ou artefato de sessão correspondente
|
|
41
|
-
- **Notas:** (agentes ativos, bloqueio principal, handoff pendente)
|
|
42
|
-
|
|
43
|
-
## Revisão do plano (opcional — dashboard / aprovação)
|
|
44
|
-
|
|
45
|
-
- **plan_review_status:** `draft` | `in_review` | `approved` | `rejected` | `needs_revision` | —
|
|
46
|
-
- **plan_review_updated:** (ISO legível — ex.: `2026-04-10T14:22:00-03:00`)
|
|
47
|
-
- **plan_review_ref:** `.oxe/PLAN-REVIEW.md` ou artefato de sessão correspondente
|
|
48
|
-
- **Notas:** (ex.: aprovado para execute; revisão pendente da onda 2)
|
|
49
|
-
|
|
50
|
-
## Blueprint de agentes (sessão) (opcional — `/oxe-plan-agent`)
|
|
51
|
-
|
|
52
|
-
Espelho do **`.oxe/plan-agents.json`** ativo (schema ≥ 2). Atualizar em **`/oxe-plan-agent`**, **`/oxe-execute`**, **`/oxe-verify`**, **`/oxe-quick`** quando o lifecycle mudar.
|
|
53
|
-
|
|
54
|
-
- **run_id:** (igual a `runId` no JSON; — se não houver blueprint)
|
|
55
|
-
- **lifecycle_status:** `pending_execute` | `executing` | `closed` | `invalidated` | —
|
|
56
|
-
- **Última onda (execute):** (número ou —)
|
|
57
|
-
- **Notas:** (ex.: invalidado por quick; mensagens em `.oxe/plan-agent-messages/`)
|
|
58
|
-
|
|
59
|
-
## Quick agents (sessão) (opcional — `/oxe-quick` com PDDA)
|
|
60
|
-
|
|
61
|
-
Preenchido por **`/oxe-quick`** quando Plan-Driven Dynamic Agents lean estiver ativo.
|
|
62
|
-
|
|
63
|
-
- **quick_id:** (ex.: `quick-2026-04-05-a1b2c3` — gerado por `/oxe-quick`)
|
|
64
|
-
- **quick_agents_status:** `active` | `done` | `invalidated` | —
|
|
65
|
-
- **Notas:** (ex.: invalidado ao iniciar novo quick ou promover a spec/plan)
|
|
66
|
-
|
|
67
|
-
## Loop (sessão) (opcional — `/oxe-loop`)
|
|
68
|
-
|
|
69
|
-
Preenchido por **`/oxe-loop`** durante retry iterativo de onda.
|
|
70
|
-
|
|
71
|
-
- **loop_onda:** (número da onda em retry, ex.: `2`)
|
|
72
|
-
- **loop_iteracao:** (tentativa atual / máximo, ex.: `2/3`)
|
|
73
|
-
- **loop_status:** `retrying` | `passed` | `escalated` | —
|
|
74
|
-
- **Notas:** (ex.: escalado para `/oxe-forensics` após 3 tentativas)
|
|
75
|
-
|
|
76
|
-
## Checklist da onda OXE (opcional — workflow execute)
|
|
77
|
-
|
|
78
|
-
_(O agente pode preencher após cada onda.)_
|
|
79
|
-
|
|
80
|
-
- [ ] Onda N — pré-requisitos conferidos
|
|
81
|
-
- [ ] Onda N — implementação concluída
|
|
82
|
-
- [ ] Onda N — **Verificar** executado ou agendado
|
|
83
|
-
|
|
84
|
-
## Milestone ativo (opcional — `/oxe-milestone`)
|
|
85
|
-
|
|
86
|
-
- **ID:** (ex.: M-01 — ou — se não houver milestone ativo)
|
|
87
|
-
- **Nome:** (ex.: v1.0 — autenticação básica)
|
|
88
|
-
- **Iniciado:** (YYYY-MM-DD)
|
|
89
|
-
- **Progresso:** (N/M critérios verificados)
|
|
90
|
-
|
|
91
|
-
## Último milestone encerrado (opcional)
|
|
92
|
-
|
|
93
|
-
- **ID:** —
|
|
94
|
-
- **Data de encerramento:** —
|
|
95
|
-
- **Artefatos:** `.oxe/milestones/M-NN/`
|
|
96
|
-
|
|
97
|
-
## Workstreams ativos (opcional — `/oxe-workstream`)
|
|
98
|
-
|
|
99
|
-
- (nenhum ou lista de nomes: ex.: `feature-billing`, `bugfix-auth`)
|
|
100
|
-
|
|
101
|
-
## Workstream ativo (contexto atual)
|
|
102
|
-
|
|
103
|
-
- (nome do workstream ativo — ou — para pipeline principal)
|
|
104
|
-
|
|
105
|
-
## Memory (sidecars de sessão) (opcional — `/oxe-memory`)
|
|
106
|
-
|
|
107
|
-
Sidecars de memória persistente por agente/sessão. Armazenados em `.oxe/memory/`.
|
|
108
|
-
|
|
109
|
-
- (nenhum ou lista: ex.: `architect-2025-01-15.md`, `researcher-auth-2025-01-14.md`)
|
|
110
|
-
|
|
111
|
-
## Camadas de memória (contrato)
|
|
112
|
-
|
|
113
|
-
- **memory_read_order:** `runtime_state -> session_memory -> project_memory -> evidence`
|
|
114
|
-
- **session_memory_ref:** `SESSION.md` ou —
|
|
115
|
-
- **project_memory_ref:** `.oxe/global/LESSONS.md`
|
|
116
|
-
- **evidence_ref:** `INVESTIGATIONS.md`, `VERIFY.md` e derivados
|
|
117
|
-
|
|
118
|
-
## Capabilities nativas (opcional)
|
|
119
|
-
|
|
120
|
-
- **capabilities_ref:** `.oxe/CAPABILITIES.md`
|
|
121
|
-
- **Capabilities ativas:** (IDs ou —)
|
|
122
|
-
|
|
123
|
-
## Investigações estruturadas (opcional)
|
|
18
|
+
## Próximo passo sugerido
|
|
124
19
|
|
|
125
|
-
-
|
|
126
|
-
-
|
|
20
|
+
- Comando: `oxe:scan` | `oxe:spec` | `oxe:discuss` | `oxe:plan` | `oxe:quick` | `oxe:execute` | `oxe:verify`
|
|
21
|
+
*(no **Cursor**: `/oxe-scan`, `/oxe-spec`, …; Copilot prompts: `oxe-scan`, …)*
|
|
22
|
+
- Motivo: (uma linha)
|
|
127
23
|
|
|
128
24
|
## Decisões persistentes
|
|
129
25
|
|
|
130
26
|
- (bullet: D-NN: decisão → data)
|
|
131
27
|
|
|
132
|
-
## Próximo passo sugerido
|
|
133
|
-
|
|
134
|
-
- Comando: `oxe:scan` | `oxe:spec` | `oxe:discuss` | `oxe:plan` | `oxe:quick` | `oxe:execute` | `oxe:verify`
|
|
135
|
-
*(no **Cursor**: `/oxe-scan`, `/oxe-spec`, `/oxe-discuss`, …; Copilot prompts: `oxe-scan`, …)*
|
|
136
|
-
- Motivo: (uma linha)
|
|
137
|
-
|
|
138
28
|
## Bloqueios
|
|
139
29
|
|
|
140
30
|
- (nenhum ou lista)
|
package/oxe/workflows/help.md
CHANGED
|
@@ -12,6 +12,8 @@ OXE é um fluxo **spec-driven** com artefatos em `.oxe/` no projeto alvo — **o
|
|
|
12
12
|
O OXE distingue cinco famílias de raciocínio multi-runtime: `discovery`, `planning`, `execution`, `review` e `status`. Essa semântica nasce em `oxe/workflows/references/reasoning-*.md`, entra nos workflows canónicos e é renderizada nos prompts/skills de cada runtime. A mesma etapa deve produzir respostas mais exploratórias, decision-complete e auditáveis em qualquer agente suportado.
|
|
13
13
|
|
|
14
14
|
No **projeto**, os passos canónicos estão em **`.oxe/workflows/*.md`** (layout mínimo) ou **`oxe/workflows/*.md`** (layout clássico com `--global`); no **pacote npm**, os modelos vivem em **`oxe/workflows/*.md`**.
|
|
15
|
+
|
|
16
|
+
**`.oxe/` enxuto (1.15.0+):** o install cria só o núcleo — `STATE.md`, `config.json` e `README.md` (legenda gerada). Todo o resto (`codebase/`, `SPEC.md`, `PLAN.md`, `agent/`, `swarm/`, `memory/`, `runs/`, sessões…) **nasce sob demanda** no primeiro uso do workflow correspondente. Para ver o que já existe e o que está disponível sob demanda, rode **`oxe-cc map`** (`--json` para hosts). A legenda completa fica em **`.oxe/README.md`** (re-gerada por `oxe-cc doctor`). O `STATE.md` é a porta de entrada curta; as seções avançadas (runtime, blueprint de agentes, milestones, workstreams, loop, memória) são anexadas sob demanda a partir de `oxe/templates/STATE-REFERENCE.md`.
|
|
15
17
|
</context>
|
|
16
18
|
|
|
17
19
|
<output>
|
package/package.json
CHANGED
|
@@ -1,108 +1,129 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "oxe-cc",
|
|
3
|
-
"version": "1.
|
|
4
|
-
"description": "OXE — spec-driven workflows in .oxe/ with runtime enterprise, evidence-first verification and multi-runtime integrations (npx)",
|
|
5
|
-
"license": "MIT",
|
|
6
|
-
"author": "",
|
|
7
|
-
"homepage": "https://www.npmjs.com/package/oxe-cc",
|
|
8
|
-
"bugs": {
|
|
9
|
-
"url": "https://github.com/propagno/oxe-build/issues"
|
|
10
|
-
},
|
|
11
|
-
"repository": {
|
|
12
|
-
"type": "git",
|
|
13
|
-
"url": "git+https://github.com/propagno/oxe-build.git"
|
|
14
|
-
},
|
|
15
|
-
"keywords": [
|
|
16
|
-
"cursor",
|
|
17
|
-
"github-copilot",
|
|
18
|
-
"copilot",
|
|
19
|
-
"claude",
|
|
20
|
-
"claude-code",
|
|
21
|
-
"opencode",
|
|
22
|
-
"gemini-cli",
|
|
23
|
-
"codex",
|
|
24
|
-
"windsurf",
|
|
25
|
-
"antigravity",
|
|
26
|
-
"spec-driven",
|
|
27
|
-
"context-engineering",
|
|
28
|
-
"ai-agents",
|
|
29
|
-
"oxe"
|
|
30
|
-
],
|
|
31
|
-
"engines": {
|
|
32
|
-
"node": ">=18.0.0"
|
|
33
|
-
},
|
|
34
|
-
"
|
|
35
|
-
|
|
36
|
-
"
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
"
|
|
40
|
-
|
|
41
|
-
"
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
"
|
|
45
|
-
"bin",
|
|
46
|
-
"
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
"
|
|
50
|
-
"
|
|
51
|
-
"
|
|
52
|
-
"
|
|
53
|
-
"
|
|
54
|
-
"
|
|
55
|
-
"
|
|
56
|
-
"
|
|
57
|
-
"
|
|
58
|
-
"
|
|
59
|
-
"
|
|
60
|
-
"
|
|
61
|
-
"
|
|
62
|
-
"
|
|
63
|
-
"
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
"
|
|
67
|
-
"
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
"
|
|
71
|
-
"
|
|
72
|
-
"
|
|
73
|
-
"
|
|
74
|
-
"
|
|
75
|
-
"
|
|
76
|
-
"
|
|
77
|
-
"test:
|
|
78
|
-
"test:
|
|
79
|
-
"
|
|
80
|
-
"test": "npm
|
|
81
|
-
"test:
|
|
82
|
-
"
|
|
83
|
-
"
|
|
84
|
-
"
|
|
85
|
-
"
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
"
|
|
89
|
-
"
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
"
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
"
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
"
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
1
|
+
{
|
|
2
|
+
"name": "oxe-cc",
|
|
3
|
+
"version": "1.16.0",
|
|
4
|
+
"description": "OXE — spec-driven workflows in .oxe/ with runtime enterprise, evidence-first verification and multi-runtime integrations (npx)",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"author": "",
|
|
7
|
+
"homepage": "https://www.npmjs.com/package/oxe-cc",
|
|
8
|
+
"bugs": {
|
|
9
|
+
"url": "https://github.com/propagno/oxe-build/issues"
|
|
10
|
+
},
|
|
11
|
+
"repository": {
|
|
12
|
+
"type": "git",
|
|
13
|
+
"url": "git+https://github.com/propagno/oxe-build.git"
|
|
14
|
+
},
|
|
15
|
+
"keywords": [
|
|
16
|
+
"cursor",
|
|
17
|
+
"github-copilot",
|
|
18
|
+
"copilot",
|
|
19
|
+
"claude",
|
|
20
|
+
"claude-code",
|
|
21
|
+
"opencode",
|
|
22
|
+
"gemini-cli",
|
|
23
|
+
"codex",
|
|
24
|
+
"windsurf",
|
|
25
|
+
"antigravity",
|
|
26
|
+
"spec-driven",
|
|
27
|
+
"context-engineering",
|
|
28
|
+
"ai-agents",
|
|
29
|
+
"oxe"
|
|
30
|
+
],
|
|
31
|
+
"engines": {
|
|
32
|
+
"node": ">=18.0.0"
|
|
33
|
+
},
|
|
34
|
+
"workspaces": [
|
|
35
|
+
"packages/runtime",
|
|
36
|
+
"vscode-extension"
|
|
37
|
+
],
|
|
38
|
+
"main": "lib/sdk/index.cjs",
|
|
39
|
+
"exports": {
|
|
40
|
+
".": "./lib/sdk/index.cjs",
|
|
41
|
+
"./package.json": "./package.json"
|
|
42
|
+
},
|
|
43
|
+
"types": "lib/sdk/index.d.ts",
|
|
44
|
+
"bin": {
|
|
45
|
+
"oxe-cc": "bin/oxe-cc.js",
|
|
46
|
+
"oxe": "bin/oxe-cc.js"
|
|
47
|
+
},
|
|
48
|
+
"files": [
|
|
49
|
+
"bin",
|
|
50
|
+
"lib",
|
|
51
|
+
"oxe",
|
|
52
|
+
"assets",
|
|
53
|
+
".cursor",
|
|
54
|
+
".github",
|
|
55
|
+
"commands",
|
|
56
|
+
"vscode-extension/package.json",
|
|
57
|
+
"vscode-extension/.vscodeignore",
|
|
58
|
+
"vscode-extension/LICENSE",
|
|
59
|
+
"vscode-extension/src",
|
|
60
|
+
"docs",
|
|
61
|
+
"QUICKSTART.md",
|
|
62
|
+
"packages/runtime/src",
|
|
63
|
+
"packages/runtime/package.json",
|
|
64
|
+
"packages/runtime/tsconfig.json",
|
|
65
|
+
"AGENTS.md",
|
|
66
|
+
"README.md",
|
|
67
|
+
"CHANGELOG.md"
|
|
68
|
+
],
|
|
69
|
+
"scripts": {
|
|
70
|
+
"build:runtime": "npm run build --workspace @oxe/runtime",
|
|
71
|
+
"generate:sdk-types": "node scripts/generate-sdk-types.cjs",
|
|
72
|
+
"check:sdk-types": "node scripts/generate-sdk-types.cjs --check",
|
|
73
|
+
"sync:runtime-metadata": "node scripts/sync-runtime-metadata.cjs",
|
|
74
|
+
"sync:cursor": "node scripts/sync-cursor-from-prompts.cjs",
|
|
75
|
+
"release:doctor": "node scripts/release-doctor.cjs",
|
|
76
|
+
"release:manifest": "node scripts/release-doctor.cjs --write-manifest",
|
|
77
|
+
"test:root": "node scripts/quality-check.cjs test-root",
|
|
78
|
+
"test:sdk-types": "npm run check:sdk-types && node --test tests/oxe-sdk-types.test.cjs",
|
|
79
|
+
"test:packed-consumer": "npm run check:sdk-types && npm run build:runtime && node scripts/test-packed-consumer.cjs",
|
|
80
|
+
"test:runtime": "npm test --workspace @oxe/runtime",
|
|
81
|
+
"test:runtime-smoke": "node scripts/runtime-smoke-matrix.cjs",
|
|
82
|
+
"test:runtime-real": "node scripts/runtime-real-suite.cjs",
|
|
83
|
+
"test:recovery-fixtures": "node scripts/run-recovery-fixtures.cjs",
|
|
84
|
+
"test:multi-agent-soak": "node scripts/run-multi-agent-soak.cjs",
|
|
85
|
+
"test:multi-agent-real": "node scripts/run-multi-agent-real.cjs",
|
|
86
|
+
"test:runtime-llm": "node scripts/test-runtime-llm.cjs",
|
|
87
|
+
"benchmark:autonomy": "node scripts/benchmark-autonomy.cjs",
|
|
88
|
+
"lint": "node scripts/quality-check.cjs lint",
|
|
89
|
+
"format": "node scripts/quality-check.cjs format",
|
|
90
|
+
"format:check": "node scripts/quality-check.cjs format-check",
|
|
91
|
+
"test": "npm run lint && npm run format:check && npm run build:runtime && npm run test:root && npm run test:sdk-types && npm run test:packed-consumer && npm run test:runtime && npm run test:runtime-smoke && npm run test:runtime-real && npm run test:recovery-fixtures && npm run test:multi-agent-soak && npm run test:multi-agent-real",
|
|
92
|
+
"test:coverage": "c8 --reporter=text-summary --reporter=json-summary npm test && node scripts/coverage-ratchet.cjs",
|
|
93
|
+
"scan:assets": "node scripts/oxe-assets-scan.cjs",
|
|
94
|
+
"release:pack-check": "node scripts/release-pack-check.cjs",
|
|
95
|
+
"test:vscode-ext": "npm test --workspace oxe-agents",
|
|
96
|
+
"build:vscode-ext": "npm run package --workspace oxe-agents",
|
|
97
|
+
"quality:report": "node scripts/quality-report.cjs finalize",
|
|
98
|
+
"prepack": "npm run generate:sdk-types && npm run build:runtime",
|
|
99
|
+
"prepublishOnly": "npm test && npm run scan:assets && npm run build:vscode-ext && npm run release:manifest && npm run release:pack-check && node bin/oxe-cc.js --version"
|
|
100
|
+
},
|
|
101
|
+
"c8": {
|
|
102
|
+
"all": true,
|
|
103
|
+
"include": [
|
|
104
|
+
"bin/oxe-cc.js",
|
|
105
|
+
"bin/lib/**/*.cjs",
|
|
106
|
+
"lib/**/*.cjs",
|
|
107
|
+
"scripts/**/*.cjs"
|
|
108
|
+
],
|
|
109
|
+
"exclude": [
|
|
110
|
+
"**/node_modules/**",
|
|
111
|
+
"scripts/benchmark-autonomy.cjs",
|
|
112
|
+
"scripts/test-runtime-llm.cjs"
|
|
113
|
+
],
|
|
114
|
+
"reporter": [
|
|
115
|
+
"text-summary",
|
|
116
|
+
"json-summary"
|
|
117
|
+
]
|
|
118
|
+
},
|
|
119
|
+
"devDependencies": {
|
|
120
|
+
"c8": "^11.0.0",
|
|
121
|
+
"eslint": "^9.31.0",
|
|
122
|
+
"globals": "^15.14.0",
|
|
123
|
+
"typescript": "^5.9.3"
|
|
124
|
+
},
|
|
125
|
+
"dependencies": {
|
|
126
|
+
"@types/node": "^18.19.120",
|
|
127
|
+
"semver": "^7.7.4"
|
|
128
|
+
}
|
|
129
|
+
}
|
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@oxe/runtime",
|
|
3
|
-
"version": "1.
|
|
4
|
-
"private": true,
|
|
5
|
-
"license": "MIT",
|
|
6
|
-
"description": "OXE agentic execution engine — enterprise runtime core",
|
|
7
|
-
"main": "../../lib/runtime/index.js",
|
|
8
|
-
"types": "../../lib/runtime/index.d.ts",
|
|
9
|
-
"scripts": {
|
|
10
|
-
"build": "tsc",
|
|
11
|
-
"test": "tsc --project tsconfig.test.json && node --test dist-tests/tests/*.test.js",
|
|
12
|
-
"clean": "node -e \"const fs=require('fs');['../../lib/runtime','dist-tests'].forEach(d=>{try{fs.rmSync(d,{recursive:true})}catch{}});\""
|
|
13
|
-
},
|
|
14
|
-
"devDependencies": {
|
|
15
|
-
"@types/node": "^25.6.0",
|
|
16
|
-
"typescript": "^5.4.5"
|
|
17
|
-
}
|
|
18
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"name": "@oxe/runtime",
|
|
3
|
+
"version": "1.16.0",
|
|
4
|
+
"private": true,
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"description": "OXE agentic execution engine — enterprise runtime core",
|
|
7
|
+
"main": "../../lib/runtime/index.js",
|
|
8
|
+
"types": "../../lib/runtime/index.d.ts",
|
|
9
|
+
"scripts": {
|
|
10
|
+
"build": "tsc",
|
|
11
|
+
"test": "tsc --project tsconfig.test.json && node --test dist-tests/tests/*.test.js",
|
|
12
|
+
"clean": "node -e \"const fs=require('fs');['../../lib/runtime','dist-tests'].forEach(d=>{try{fs.rmSync(d,{recursive:true})}catch{}});\""
|
|
13
|
+
},
|
|
14
|
+
"devDependencies": {
|
|
15
|
+
"@types/node": "^25.6.0",
|
|
16
|
+
"typescript": "^5.4.5"
|
|
17
|
+
}
|
|
18
|
+
}
|
|
@@ -75,8 +75,8 @@ export class EvidenceStore {
|
|
|
75
75
|
const ext = EXT_MAP[type] ?? 'bin';
|
|
76
76
|
|
|
77
77
|
const existing = this.readIndex(run_id, work_item_id, attempt_number);
|
|
78
|
-
const seq = existing.filter((e) => e.type === type).length + 1;
|
|
79
|
-
const filename = seq === 1 ? `${type}.${ext}` : `${type}-${seq}.${ext}`;
|
|
78
|
+
const seq = existing.filter((e) => e.type === type).length + 1;
|
|
79
|
+
const filename = seq === 1 ? `${type}.${ext}` : `${type}-${seq}.${ext}`;
|
|
80
80
|
const filePath = path.join(dir, filename);
|
|
81
81
|
|
|
82
82
|
fs.writeFileSync(filePath, buf);
|