oxe-cc 1.4.1 → 1.5.1

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 (63) hide show
  1. package/.cursor/commands/oxe-dashboard.md +2 -2
  2. package/.cursor/commands/oxe-execute.md +2 -2
  3. package/.cursor/commands/oxe-plan.md +2 -2
  4. package/.cursor/commands/oxe-verify-audit.md +46 -0
  5. package/.cursor/commands/oxe-workflow-authoring.md +47 -0
  6. package/.github/prompts/oxe-compact.prompt.md +1 -1
  7. package/.github/prompts/oxe-dashboard.prompt.md +2 -2
  8. package/.github/prompts/oxe-execute.prompt.md +2 -2
  9. package/.github/prompts/oxe-plan-agent.prompt.md +1 -0
  10. package/.github/prompts/oxe-plan.prompt.md +2 -2
  11. package/.github/prompts/oxe-verify-audit.prompt.md +46 -0
  12. package/.github/prompts/oxe-workflow-authoring.prompt.md +47 -0
  13. package/.github/workflows/ci.yml +1 -0
  14. package/.github/workflows/release.yml +1 -0
  15. package/AGENTS.md +3 -1
  16. package/CHANGELOG.md +50 -0
  17. package/QUICKSTART.md +99 -0
  18. package/README.md +20 -11
  19. package/bin/lib/oxe-context-engine.cjs +9 -4
  20. package/bin/lib/oxe-dashboard.cjs +119 -53
  21. package/bin/lib/oxe-install-resolve.cjs +10 -0
  22. package/bin/lib/oxe-operational.cjs +34 -28
  23. package/bin/lib/oxe-project-health.cjs +407 -118
  24. package/bin/lib/oxe-rationality.cjs +385 -0
  25. package/bin/lib/oxe-release.cjs +423 -0
  26. package/bin/oxe-cc.js +446 -325
  27. package/commands/oxe/dashboard.md +2 -2
  28. package/commands/oxe/execute.md +2 -2
  29. package/commands/oxe/plan.md +2 -2
  30. package/commands/oxe/verify-audit.md +50 -0
  31. package/commands/oxe/workflow-authoring.md +50 -0
  32. package/docs/INCIDENT-PLAYBOOK.md +181 -0
  33. package/docs/RELEASE-READINESS.md +46 -0
  34. package/docs/ROLES.md +129 -0
  35. package/docs/RUNTIME-SMOKE-MATRIX.md +128 -0
  36. package/docs/TEAM-ADOPTION.md +153 -0
  37. package/docs/WALKTHROUGH.md +241 -0
  38. package/lib/runtime/scheduler/multi-agent-coordinator.d.ts +28 -0
  39. package/lib/runtime/scheduler/multi-agent-coordinator.js +152 -26
  40. package/lib/sdk/README.md +2 -0
  41. package/lib/sdk/index.cjs +32 -14
  42. package/lib/sdk/index.d.ts +138 -40
  43. package/oxe/templates/CONFIG.md +1 -1
  44. package/oxe/templates/EXECUTION-RUNTIME.template.md +1 -1
  45. package/oxe/templates/FIXTURE-PACK.template.json +34 -0
  46. package/oxe/templates/FIXTURE-PACK.template.md +21 -0
  47. package/oxe/templates/IMPLEMENTATION-PACK.template.json +52 -0
  48. package/oxe/templates/IMPLEMENTATION-PACK.template.md +36 -0
  49. package/oxe/templates/PLAN.template.md +46 -37
  50. package/oxe/templates/REFERENCE-ANCHORS.template.md +24 -0
  51. package/oxe/templates/config.template.json +2 -1
  52. package/oxe/workflows/execute.md +36 -20
  53. package/oxe/workflows/next.md +1 -1
  54. package/oxe/workflows/plan.md +80 -22
  55. package/oxe/workflows/references/flow-robustness-contract.md +3 -3
  56. package/oxe/workflows/references/workflow-runtime-contracts.json +127 -95
  57. package/oxe/workflows/verify.md +4 -4
  58. package/package.json +28 -20
  59. package/packages/runtime/package.json +1 -1
  60. package/packages/runtime/src/scheduler/multi-agent-coordinator.ts +357 -193
  61. package/vscode-extension/oxe-agents-1.5.0.vsix +0 -0
  62. package/vscode-extension/oxe-agents-1.5.1.vsix +0 -0
  63. package/vscode-extension/package.json +1 -1
@@ -254,22 +254,25 @@
254
254
  ],
255
255
  "extraction_intent": "status_read"
256
256
  },
257
- "dashboard": {
258
- "reasoning_mode": "status",
259
- "output_contract": "situational",
260
- "required_artifacts": [
261
- "state",
262
- "phase_summary",
263
- "project_summary"
264
- ],
265
- "optional_artifacts": [
266
- "session_summary",
267
- "plan",
268
- "runtime",
269
- "verify",
270
- "active_run",
271
- "events",
272
- "context_pack_dashboard"
257
+ "dashboard": {
258
+ "reasoning_mode": "status",
259
+ "output_contract": "situational",
260
+ "required_artifacts": [
261
+ "state",
262
+ "phase_summary",
263
+ "project_summary"
264
+ ],
265
+ "optional_artifacts": [
266
+ "session_summary",
267
+ "plan",
268
+ "implementation_pack_json",
269
+ "reference_anchors",
270
+ "fixture_pack_json",
271
+ "runtime",
272
+ "verify",
273
+ "active_run",
274
+ "events",
275
+ "context_pack_dashboard"
273
276
  ],
274
277
  "extraction_intent": "critical_check"
275
278
  },
@@ -319,56 +322,72 @@
319
322
  "canonical_state"
320
323
  ],
321
324
  "runtime_fallback_note": "Se o runtime não estiver compilado ou falhar por indisponibilidade do pacote, declarar fallback explícito para o fluxo legado antes de mutar.",
322
- "required_artifacts": [
323
- "state",
324
- "runtime",
325
- "checkpoints"
326
- ],
327
- "optional_artifacts": [
328
- "plan",
329
- "quick",
330
- "active_run",
331
- "events",
332
- "verify",
333
- "summary",
334
- "session_summary",
325
+ "required_artifacts": [
326
+ "state",
327
+ "runtime",
328
+ "checkpoints",
329
+ "implementation_pack_json",
330
+ "reference_anchors",
331
+ "fixture_pack_json"
332
+ ],
333
+ "optional_artifacts": [
334
+ "plan",
335
+ "quick",
336
+ "implementation_pack_md",
337
+ "fixture_pack_md",
338
+ "active_run",
339
+ "events",
340
+ "verify",
341
+ "summary",
342
+ "session_summary",
335
343
  "phase_summary",
336
344
  "project_summary",
337
345
  "capabilities_index",
338
346
  "azure_inventory"
339
347
  ],
340
- "context_tiers": {
341
- "minimal": [
342
- "state",
343
- "runtime",
344
- "checkpoints",
345
- "plan",
346
- "quick",
347
- "phase_summary"
348
- ],
349
- "standard": [
350
- "state",
351
- "runtime",
352
- "checkpoints",
353
- "plan",
354
- "quick",
355
- "phase_summary",
356
- "session_summary",
357
- "active_run",
358
- "events",
348
+ "context_tiers": {
349
+ "minimal": [
350
+ "state",
351
+ "runtime",
352
+ "checkpoints",
353
+ "plan",
354
+ "implementation_pack_json",
355
+ "reference_anchors",
356
+ "fixture_pack_json",
357
+ "quick",
358
+ "phase_summary"
359
+ ],
360
+ "standard": [
361
+ "state",
362
+ "runtime",
363
+ "checkpoints",
364
+ "plan",
365
+ "implementation_pack_json",
366
+ "reference_anchors",
367
+ "fixture_pack_json",
368
+ "quick",
369
+ "phase_summary",
370
+ "session_summary",
371
+ "active_run",
372
+ "events",
359
373
  "verify",
360
374
  "summary"
361
375
  ],
362
376
  "full": [
363
- "state",
364
- "runtime",
365
- "checkpoints",
366
- "plan",
367
- "quick",
368
- "active_run",
369
- "events",
370
- "verify",
371
- "summary",
377
+ "state",
378
+ "runtime",
379
+ "checkpoints",
380
+ "plan",
381
+ "implementation_pack_md",
382
+ "implementation_pack_json",
383
+ "reference_anchors",
384
+ "fixture_pack_md",
385
+ "fixture_pack_json",
386
+ "quick",
387
+ "active_run",
388
+ "events",
389
+ "verify",
390
+ "summary",
372
391
  "session_summary",
373
392
  "phase_summary",
374
393
  "project_summary",
@@ -511,52 +530,65 @@
511
530
  "state",
512
531
  "spec"
513
532
  ],
514
- "optional_artifacts": [
515
- "discuss",
516
- "investigations_index",
517
- "project_summary",
518
- "session_summary",
519
- "phase_summary",
520
- "global_lessons",
521
- "capabilities_index",
522
- "azure_inventory",
523
- "checkpoints",
524
- "calibration"
525
- ],
526
- "context_tiers": {
527
- "minimal": [
528
- "state",
529
- "spec",
533
+ "optional_artifacts": [
534
+ "discuss",
535
+ "investigations_index",
536
+ "project_summary",
537
+ "session_summary",
538
+ "phase_summary",
539
+ "global_lessons",
540
+ "capabilities_index",
541
+ "azure_inventory",
542
+ "checkpoints",
543
+ "calibration",
544
+ "implementation_pack_md",
545
+ "implementation_pack_json",
546
+ "reference_anchors",
547
+ "fixture_pack_md",
548
+ "fixture_pack_json"
549
+ ],
550
+ "context_tiers": {
551
+ "minimal": [
552
+ "state",
553
+ "spec",
530
554
  "session_summary",
531
555
  "phase_summary"
532
556
  ],
533
557
  "standard": [
534
- "state",
535
- "spec",
536
- "session_summary",
537
- "phase_summary",
538
- "discuss",
539
- "investigations_index",
540
- "project_summary",
541
- "global_lessons",
542
- "capabilities_index",
543
- "checkpoints"
544
- ],
545
- "full": [
546
- "state",
547
- "spec",
548
- "discuss",
558
+ "state",
559
+ "spec",
560
+ "session_summary",
561
+ "phase_summary",
562
+ "discuss",
563
+ "investigations_index",
564
+ "project_summary",
565
+ "global_lessons",
566
+ "capabilities_index",
567
+ "checkpoints",
568
+ "implementation_pack_json",
569
+ "reference_anchors",
570
+ "fixture_pack_json"
571
+ ],
572
+ "full": [
573
+ "state",
574
+ "spec",
575
+ "discuss",
549
576
  "investigations_index",
550
577
  "project_summary",
551
578
  "session_summary",
552
579
  "phase_summary",
553
- "global_lessons",
554
- "capabilities_index",
555
- "azure_inventory",
556
- "checkpoints",
557
- "calibration"
558
- ]
559
- },
580
+ "global_lessons",
581
+ "capabilities_index",
582
+ "azure_inventory",
583
+ "checkpoints",
584
+ "calibration",
585
+ "implementation_pack_md",
586
+ "implementation_pack_json",
587
+ "reference_anchors",
588
+ "fixture_pack_md",
589
+ "fixture_pack_json"
590
+ ]
591
+ },
560
592
  "extraction_intent": "planning_input"
561
593
  },
562
594
  "project": {
@@ -122,10 +122,10 @@ O preenchimento da checklist é responsabilidade do **usuário** (não do agente
122
122
  **Calibração do plano** (obrigatória quando existir `PLAN.md`)
123
123
 
124
124
  Ler a `## Autoavaliação do Plano` e comparar com o resultado real:
125
- 1. Se `Confiança >= 85%` e houver falha precoce em critérios centrais ou tarefas iniciais, marcar **erro de calibração do plano**.
126
- 2. Se `Confiança < 70%` e as falhas ocorrerem nas incertezas previstas, marcar **autoavaliação aderente**.
127
- 3. Se `Confiança >= 70%` e os critérios/tarefas passarem de forma consistente, marcar **plano calibrado**.
128
- 4. Se `Confiança < 70%` e o ciclo passar amplamente, marcar **plano conservador demais**.
125
+ 1. Se `Confiança > limiar executável` (padrão canónico `90%`) e houver falha precoce em critérios centrais ou tarefas iniciais, marcar **erro de calibração do plano**.
126
+ 2. Se `Confiança <= limiar executável` e as falhas ocorrerem nas incertezas previstas, marcar **autoavaliação aderente**.
127
+ 3. Se `Confiança > limiar executável` e os critérios/tarefas passarem de forma consistente, marcar **plano calibrado**.
128
+ 4. Se `Confiança <= limiar executável` e o ciclo passar amplamente, marcar **plano conservador demais**.
129
129
 
130
130
  Registrar em `VERIFY.md`: `Resultado de calibração | Confiança declarada | Resultado observado | Notas`.
131
131
  </calibracao_do_plano>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oxe-cc",
3
- "version": "1.4.1",
3
+ "version": "1.5.1",
4
4
  "description": "OXE — spec-driven workflows in .oxe/ with runtime enterprise, evidence-first verification and multi-runtime integrations (npx)",
5
5
  "license": "MIT",
6
6
  "author": "",
@@ -38,7 +38,8 @@
38
38
  },
39
39
  "types": "lib/sdk/index.d.ts",
40
40
  "bin": {
41
- "oxe-cc": "bin/oxe-cc.js"
41
+ "oxe-cc": "bin/oxe-cc.js",
42
+ "oxe": "bin/oxe-cc.js"
42
43
  },
43
44
  "files": [
44
45
  "bin",
@@ -46,28 +47,35 @@
46
47
  "oxe",
47
48
  "assets",
48
49
  ".cursor",
49
- ".github",
50
- "commands",
51
- "vscode-extension",
52
- "packages/runtime/src",
53
- "packages/runtime/package.json",
54
- "packages/runtime/tsconfig.json",
50
+ ".github",
51
+ "commands",
52
+ "vscode-extension",
53
+ "docs",
54
+ "QUICKSTART.md",
55
+ "packages/runtime/src",
56
+ "packages/runtime/package.json",
57
+ "packages/runtime/tsconfig.json",
55
58
  "AGENTS.md",
56
59
  "README.md",
57
60
  "CHANGELOG.md"
58
61
  ],
59
- "scripts": {
60
- "build:runtime": "cd packages/runtime && npm run build",
61
- "sync:runtime-metadata": "node scripts/sync-runtime-metadata.cjs",
62
- "sync:cursor": "node scripts/sync-cursor-from-prompts.cjs",
63
- "test:root": "node --test tests/install.test.cjs tests/oxe-project-health.test.cjs tests/oxe-dashboard.test.cjs tests/oxe-operational.test.cjs tests/oxe-azure.test.cjs tests/oxe-sdk.test.cjs tests/oxe-manifest.test.cjs tests/oxe-agent-install.test.cjs tests/oxe-install-resolve-full.test.cjs tests/oxe-health-extended.test.cjs tests/oxe-workflows-edge.test.cjs tests/oxe-sdk-edge.test.cjs tests/oxe-cli-edge.test.cjs tests/oxe-npm-version.test.cjs tests/oxe-scripts.test.cjs tests/oxe-retro-health.test.cjs tests/oxe-security-permissions.test.cjs tests/oxe-runtime-semantics.test.cjs tests/oxe-plugins.test.cjs",
64
- "test:runtime": "cd packages/runtime && npm test",
65
- "test": "npm run build:runtime && npm run test:root && npm run test:runtime",
66
- "test:coverage": "c8 --check-coverage --lines 82 --functions 85 --branches 58 --statements 82 npm test",
67
- "scan:assets": "node scripts/oxe-assets-scan.cjs",
68
- "build:vscode-ext": "cd vscode-extension && npx @vscode/vsce package --no-yarn --allow-missing-repository",
69
- "prepublishOnly": "npm run build:vscode-ext && node scripts/sync-runtime-metadata.cjs && node scripts/sync-cursor-from-prompts.cjs && npm test && npm run scan:assets && node bin/oxe-cc.js --version"
70
- },
62
+ "scripts": {
63
+ "build:runtime": "cd packages/runtime && npm run build",
64
+ "sync:runtime-metadata": "node scripts/sync-runtime-metadata.cjs",
65
+ "sync:cursor": "node scripts/sync-cursor-from-prompts.cjs",
66
+ "release:doctor": "node scripts/release-doctor.cjs",
67
+ "release:manifest": "node scripts/release-doctor.cjs --write-manifest",
68
+ "test:root": "node --test tests/install.test.cjs tests/oxe-project-health.test.cjs tests/oxe-dashboard.test.cjs tests/oxe-operational.test.cjs tests/oxe-azure.test.cjs tests/oxe-sdk.test.cjs tests/oxe-manifest.test.cjs tests/oxe-agent-install.test.cjs tests/oxe-install-resolve-full.test.cjs tests/oxe-health-extended.test.cjs tests/oxe-workflows-edge.test.cjs tests/oxe-sdk-edge.test.cjs tests/oxe-cli-edge.test.cjs tests/oxe-npm-version.test.cjs tests/oxe-scripts.test.cjs tests/oxe-retro-health.test.cjs tests/oxe-security-permissions.test.cjs tests/oxe-runtime-semantics.test.cjs tests/oxe-plugins.test.cjs",
69
+ "test:runtime": "cd packages/runtime && npm test",
70
+ "test:runtime-smoke": "node scripts/runtime-smoke-matrix.cjs",
71
+ "test:recovery-fixtures": "node scripts/run-recovery-fixtures.cjs",
72
+ "test:multi-agent-soak": "node scripts/run-multi-agent-soak.cjs",
73
+ "test": "npm run build:runtime && npm run test:root && npm run test:runtime && npm run test:runtime-smoke && npm run test:recovery-fixtures && npm run test:multi-agent-soak",
74
+ "test:coverage": "c8 --check-coverage --lines 82 --functions 85 --branches 58 --statements 82 npm test",
75
+ "scan:assets": "node scripts/oxe-assets-scan.cjs",
76
+ "build:vscode-ext": "cd vscode-extension && npx @vscode/vsce package --no-yarn --allow-missing-repository",
77
+ "prepublishOnly": "npm test && npm run scan:assets && npm run build:vscode-ext && npm run release:manifest && node bin/oxe-cc.js --version"
78
+ },
71
79
  "c8": {
72
80
  "all": true,
73
81
  "include": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@oxe/runtime",
3
- "version": "1.4.0",
3
+ "version": "1.5.1",
4
4
  "private": true,
5
5
  "license": "MIT",
6
6
  "description": "OXE agentic execution engine — enterprise runtime core",