oxe-cc 0.9.3 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (151) hide show
  1. package/README.md +1 -1
  2. package/bin/banner.txt +1 -1
  3. package/bin/lib/oxe-dashboard.cjs +9 -7
  4. package/bin/lib/oxe-operational.cjs +569 -4
  5. package/bin/oxe-cc.js +141 -57
  6. package/lib/runtime/compiler/graph-compiler.d.ts +83 -0
  7. package/lib/runtime/compiler/graph-compiler.js +135 -0
  8. package/lib/runtime/compiler/index.d.ts +1 -0
  9. package/lib/runtime/compiler/index.js +17 -0
  10. package/lib/runtime/context/context-pack-builder.d.ts +36 -0
  11. package/lib/runtime/context/context-pack-builder.js +136 -0
  12. package/lib/runtime/context/index.d.ts +1 -0
  13. package/lib/runtime/context/index.js +17 -0
  14. package/lib/runtime/delivery/branch-manager.d.ts +19 -0
  15. package/lib/runtime/delivery/branch-manager.js +78 -0
  16. package/lib/runtime/delivery/ci-checks.d.ts +34 -0
  17. package/lib/runtime/delivery/ci-checks.js +209 -0
  18. package/lib/runtime/delivery/index.d.ts +3 -0
  19. package/lib/runtime/delivery/index.js +19 -0
  20. package/lib/runtime/delivery/pr-manager.d.ts +30 -0
  21. package/lib/runtime/delivery/pr-manager.js +82 -0
  22. package/lib/runtime/events/bus.d.ts +9 -0
  23. package/lib/runtime/events/bus.js +63 -0
  24. package/lib/runtime/events/catalog.d.ts +3 -0
  25. package/lib/runtime/events/catalog.js +30 -0
  26. package/lib/runtime/events/envelope.d.ts +13 -0
  27. package/lib/runtime/events/envelope.js +2 -0
  28. package/lib/runtime/events/index.d.ts +3 -0
  29. package/lib/runtime/events/index.js +19 -0
  30. package/lib/runtime/evidence/evidence-store.d.ts +22 -0
  31. package/lib/runtime/evidence/evidence-store.js +106 -0
  32. package/lib/runtime/evidence/index.d.ts +1 -0
  33. package/lib/runtime/evidence/index.js +17 -0
  34. package/lib/runtime/gate/gate-manager.d.ts +39 -0
  35. package/lib/runtime/gate/gate-manager.js +104 -0
  36. package/lib/runtime/gate/index.d.ts +1 -0
  37. package/lib/runtime/gate/index.js +17 -0
  38. package/lib/runtime/index.d.ts +16 -0
  39. package/lib/runtime/index.js +40 -0
  40. package/lib/runtime/models/attempt.d.ts +12 -0
  41. package/lib/runtime/models/attempt.js +2 -0
  42. package/lib/runtime/models/evidence.d.ts +9 -0
  43. package/lib/runtime/models/evidence.js +2 -0
  44. package/lib/runtime/models/gate-decision.d.ts +10 -0
  45. package/lib/runtime/models/gate-decision.js +2 -0
  46. package/lib/runtime/models/index.d.ts +8 -0
  47. package/lib/runtime/models/index.js +24 -0
  48. package/lib/runtime/models/run.d.ts +13 -0
  49. package/lib/runtime/models/run.js +2 -0
  50. package/lib/runtime/models/session.d.ts +10 -0
  51. package/lib/runtime/models/session.js +2 -0
  52. package/lib/runtime/models/verification-result.d.ts +9 -0
  53. package/lib/runtime/models/verification-result.js +2 -0
  54. package/lib/runtime/models/work-item.d.ts +15 -0
  55. package/lib/runtime/models/work-item.js +2 -0
  56. package/lib/runtime/models/workspace.d.ts +25 -0
  57. package/lib/runtime/models/workspace.js +2 -0
  58. package/lib/runtime/plugins/index.d.ts +2 -0
  59. package/lib/runtime/plugins/index.js +18 -0
  60. package/lib/runtime/plugins/plugin-abi.d.ts +76 -0
  61. package/lib/runtime/plugins/plugin-abi.js +2 -0
  62. package/lib/runtime/plugins/plugin-registry.d.ts +21 -0
  63. package/lib/runtime/plugins/plugin-registry.js +114 -0
  64. package/lib/runtime/policy/index.d.ts +1 -0
  65. package/lib/runtime/policy/index.js +17 -0
  66. package/lib/runtime/policy/policy-engine.d.ts +40 -0
  67. package/lib/runtime/policy/policy-engine.js +80 -0
  68. package/lib/runtime/projection/index.d.ts +1 -0
  69. package/lib/runtime/projection/index.js +17 -0
  70. package/lib/runtime/projection/projection-engine.d.ts +11 -0
  71. package/lib/runtime/projection/projection-engine.js +218 -0
  72. package/lib/runtime/reducers/debug-reducer.d.ts +10 -0
  73. package/lib/runtime/reducers/debug-reducer.js +30 -0
  74. package/lib/runtime/reducers/index.d.ts +2 -0
  75. package/lib/runtime/reducers/index.js +18 -0
  76. package/lib/runtime/reducers/run-state-reducer.d.ts +20 -0
  77. package/lib/runtime/reducers/run-state-reducer.js +110 -0
  78. package/lib/runtime/scheduler/index.d.ts +1 -0
  79. package/lib/runtime/scheduler/index.js +17 -0
  80. package/lib/runtime/scheduler/multi-agent-coordinator.d.ts +34 -0
  81. package/lib/runtime/scheduler/multi-agent-coordinator.js +166 -0
  82. package/lib/runtime/scheduler/scheduler.d.ts +39 -0
  83. package/lib/runtime/scheduler/scheduler.js +196 -0
  84. package/lib/runtime/verification/index.d.ts +1 -0
  85. package/lib/runtime/verification/index.js +17 -0
  86. package/lib/runtime/verification/verification-compiler.d.ts +56 -0
  87. package/lib/runtime/verification/verification-compiler.js +147 -0
  88. package/lib/runtime/workspace/index.d.ts +5 -0
  89. package/lib/runtime/workspace/index.js +24 -0
  90. package/lib/runtime/workspace/strategies/ephemeral-container.d.ts +22 -0
  91. package/lib/runtime/workspace/strategies/ephemeral-container.js +109 -0
  92. package/lib/runtime/workspace/strategies/git-worktree.d.ts +12 -0
  93. package/lib/runtime/workspace/strategies/git-worktree.js +79 -0
  94. package/lib/runtime/workspace/strategies/inplace.d.ts +10 -0
  95. package/lib/runtime/workspace/strategies/inplace.js +37 -0
  96. package/lib/runtime/workspace/workspace-manager.d.ts +13 -0
  97. package/lib/runtime/workspace/workspace-manager.js +2 -0
  98. package/lib/sdk/index.cjs +24 -7
  99. package/lib/sdk/index.d.ts +17 -7
  100. package/package.json +9 -3
  101. package/packages/runtime/package.json +17 -0
  102. package/packages/runtime/src/compiler/graph-compiler.ts +245 -0
  103. package/packages/runtime/src/compiler/index.ts +1 -0
  104. package/packages/runtime/src/context/context-pack-builder.ts +193 -0
  105. package/packages/runtime/src/context/index.ts +1 -0
  106. package/packages/runtime/src/delivery/branch-manager.ts +84 -0
  107. package/packages/runtime/src/delivery/ci-checks.ts +252 -0
  108. package/packages/runtime/src/delivery/index.ts +3 -0
  109. package/packages/runtime/src/delivery/pr-manager.ts +112 -0
  110. package/packages/runtime/src/events/bus.ts +92 -0
  111. package/packages/runtime/src/events/catalog.ts +29 -0
  112. package/packages/runtime/src/events/envelope.ts +14 -0
  113. package/packages/runtime/src/events/index.ts +3 -0
  114. package/packages/runtime/src/evidence/evidence-store.ts +130 -0
  115. package/packages/runtime/src/evidence/index.ts +1 -0
  116. package/packages/runtime/src/gate/gate-manager.ts +137 -0
  117. package/packages/runtime/src/gate/index.ts +1 -0
  118. package/packages/runtime/src/index.ts +32 -0
  119. package/packages/runtime/src/models/attempt.ts +19 -0
  120. package/packages/runtime/src/models/evidence.ts +21 -0
  121. package/packages/runtime/src/models/gate-decision.ts +21 -0
  122. package/packages/runtime/src/models/index.ts +8 -0
  123. package/packages/runtime/src/models/run.ts +24 -0
  124. package/packages/runtime/src/models/session.ts +11 -0
  125. package/packages/runtime/src/models/verification-result.ts +10 -0
  126. package/packages/runtime/src/models/work-item.ts +25 -0
  127. package/packages/runtime/src/models/workspace.ts +28 -0
  128. package/packages/runtime/src/plugins/index.ts +2 -0
  129. package/packages/runtime/src/plugins/plugin-abi.ts +95 -0
  130. package/packages/runtime/src/plugins/plugin-registry.ts +119 -0
  131. package/packages/runtime/src/policy/index.ts +1 -0
  132. package/packages/runtime/src/policy/policy-engine.ts +113 -0
  133. package/packages/runtime/src/projection/index.ts +1 -0
  134. package/packages/runtime/src/projection/projection-engine.ts +249 -0
  135. package/packages/runtime/src/reducers/debug-reducer.ts +36 -0
  136. package/packages/runtime/src/reducers/index.ts +2 -0
  137. package/packages/runtime/src/reducers/run-state-reducer.ts +127 -0
  138. package/packages/runtime/src/scheduler/index.ts +1 -0
  139. package/packages/runtime/src/scheduler/multi-agent-coordinator.ts +231 -0
  140. package/packages/runtime/src/scheduler/scheduler.ts +281 -0
  141. package/packages/runtime/src/verification/index.ts +1 -0
  142. package/packages/runtime/src/verification/verification-compiler.ts +225 -0
  143. package/packages/runtime/src/workspace/index.ts +5 -0
  144. package/packages/runtime/src/workspace/strategies/ephemeral-container.ts +121 -0
  145. package/packages/runtime/src/workspace/strategies/git-worktree.ts +77 -0
  146. package/packages/runtime/src/workspace/strategies/inplace.ts +35 -0
  147. package/packages/runtime/src/workspace/workspace-manager.ts +15 -0
  148. package/packages/runtime/tsconfig.json +17 -0
  149. package/vscode-extension/oxe-agents-0.9.2.vsix +0 -0
  150. package/vscode-extension/oxe-agents-1.0.0.vsix +0 -0
  151. package/vscode-extension/package.json +1 -1
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,21 @@
1
+ import type { OxePlugin, ToolProvider, WorkspaceProvider, VerifierProvider, ContextProvider } from './plugin-abi';
2
+ export declare class PluginRegistry {
3
+ private plugins;
4
+ register(plugin: OxePlugin): void;
5
+ unregister(name: string): void;
6
+ loadFromDirectory(dir: string): string[];
7
+ toolProviderFor(actionType: string): ToolProvider | null;
8
+ workspaceProviderFor(strategy: string): WorkspaceProvider | null;
9
+ verifierProviderFor(checkType: string): VerifierProvider | null;
10
+ contextProviderFor(name: string): ContextProvider | null;
11
+ allContextProviders(): ContextProvider[];
12
+ allToolProviders(): ToolProvider[];
13
+ runHook(hookName: string, ctx: Record<string, unknown>): Promise<void>;
14
+ list(): Array<{
15
+ name: string;
16
+ version?: string;
17
+ providers: string[];
18
+ }>;
19
+ }
20
+ export declare function globalRegistry(): PluginRegistry;
21
+ export declare function resetGlobalRegistry(): void;
@@ -0,0 +1,114 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.PluginRegistry = void 0;
7
+ exports.globalRegistry = globalRegistry;
8
+ exports.resetGlobalRegistry = resetGlobalRegistry;
9
+ const fs_1 = __importDefault(require("fs"));
10
+ const path_1 = __importDefault(require("path"));
11
+ class PluginRegistry {
12
+ constructor() {
13
+ this.plugins = [];
14
+ }
15
+ register(plugin) {
16
+ if (this.plugins.some((p) => p.name === plugin.name)) {
17
+ throw new Error(`Plugin "${plugin.name}" is already registered`);
18
+ }
19
+ this.plugins.push(plugin);
20
+ }
21
+ unregister(name) {
22
+ this.plugins = this.plugins.filter((p) => p.name !== name);
23
+ }
24
+ loadFromDirectory(dir) {
25
+ if (!fs_1.default.existsSync(dir))
26
+ return [];
27
+ const loaded = [];
28
+ for (const file of fs_1.default.readdirSync(dir)) {
29
+ if (!file.endsWith('.cjs') && !file.endsWith('.js'))
30
+ continue;
31
+ const fullPath = path_1.default.resolve(dir, file);
32
+ try {
33
+ // eslint-disable-next-line @typescript-eslint/no-var-requires
34
+ const mod = require(fullPath);
35
+ const plugin = 'default' in mod && mod.default ? mod.default : mod;
36
+ if (plugin && plugin.name) {
37
+ this.register(plugin);
38
+ loaded.push(plugin.name);
39
+ }
40
+ }
41
+ catch {
42
+ // skip invalid plugin files
43
+ }
44
+ }
45
+ return loaded;
46
+ }
47
+ toolProviderFor(actionType) {
48
+ for (const plugin of this.plugins) {
49
+ const provider = plugin.toolProviders?.find((p) => p.supports(actionType));
50
+ if (provider)
51
+ return provider;
52
+ }
53
+ return null;
54
+ }
55
+ workspaceProviderFor(strategy) {
56
+ for (const plugin of this.plugins) {
57
+ const provider = plugin.workspaceProviders?.find((p) => p.supportsStrategy(strategy));
58
+ if (provider)
59
+ return provider;
60
+ }
61
+ return null;
62
+ }
63
+ verifierProviderFor(checkType) {
64
+ for (const plugin of this.plugins) {
65
+ const provider = plugin.verifierProviders?.find((p) => p.supports(checkType));
66
+ if (provider)
67
+ return provider;
68
+ }
69
+ return null;
70
+ }
71
+ contextProviderFor(name) {
72
+ for (const plugin of this.plugins) {
73
+ const provider = plugin.contextProviders?.find((p) => p.name === name);
74
+ if (provider)
75
+ return provider;
76
+ }
77
+ return null;
78
+ }
79
+ allContextProviders() {
80
+ return this.plugins.flatMap((p) => p.contextProviders ?? []);
81
+ }
82
+ allToolProviders() {
83
+ return this.plugins.flatMap((p) => p.toolProviders ?? []);
84
+ }
85
+ async runHook(hookName, ctx) {
86
+ for (const plugin of this.plugins) {
87
+ const hook = plugin.hooks?.[hookName];
88
+ if (hook)
89
+ await hook(ctx);
90
+ }
91
+ }
92
+ list() {
93
+ return this.plugins.map((p) => ({
94
+ name: p.name,
95
+ version: p.version,
96
+ providers: [
97
+ ...(p.toolProviders?.map((tp) => `tool:${tp.name}`) ?? []),
98
+ ...(p.workspaceProviders?.map((wp) => `workspace:${wp.name}`) ?? []),
99
+ ...(p.verifierProviders?.map((vp) => `verifier:${vp.name}`) ?? []),
100
+ ...(p.contextProviders?.map((cp) => `context:${cp.name}`) ?? []),
101
+ ],
102
+ }));
103
+ }
104
+ }
105
+ exports.PluginRegistry = PluginRegistry;
106
+ let _globalRegistry = null;
107
+ function globalRegistry() {
108
+ if (!_globalRegistry)
109
+ _globalRegistry = new PluginRegistry();
110
+ return _globalRegistry;
111
+ }
112
+ function resetGlobalRegistry() {
113
+ _globalRegistry = null;
114
+ }
@@ -0,0 +1 @@
1
+ export * from './policy-engine';
@@ -0,0 +1,17 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./policy-engine"), exports);
@@ -0,0 +1,40 @@
1
+ export type PolicyAction = 'allow' | 'deny' | 'require_human_gate';
2
+ export interface PolicyWhenClause {
3
+ tool?: string;
4
+ env?: string;
5
+ kind?: string;
6
+ }
7
+ export interface PolicyAssertClause {
8
+ diff_within_scope?: boolean;
9
+ }
10
+ export interface PolicyRule {
11
+ id: string;
12
+ when: PolicyWhenClause;
13
+ assert?: PolicyAssertClause;
14
+ action: PolicyAction;
15
+ }
16
+ export interface PolicyContext {
17
+ tool: string;
18
+ env?: string;
19
+ kind?: string;
20
+ mutation_scope?: string[];
21
+ affected_paths?: string[];
22
+ }
23
+ export interface PolicyDecision {
24
+ allowed: boolean;
25
+ gate_required: boolean;
26
+ reason: string;
27
+ rule_id: string | null;
28
+ }
29
+ export declare class PolicyEngine {
30
+ private readonly rules;
31
+ constructor(rules?: PolicyRule[]);
32
+ evaluate(ctx: PolicyContext): PolicyDecision;
33
+ private matches;
34
+ private checkAssert;
35
+ withRule(rule: PolicyRule): PolicyEngine;
36
+ static fromConfig(config: {
37
+ policies?: PolicyRule[];
38
+ }): PolicyEngine;
39
+ static fromConfigFile(configPath: string): PolicyEngine;
40
+ }
@@ -0,0 +1,80 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.PolicyEngine = void 0;
4
+ const ALLOW_ALL = {
5
+ allowed: true,
6
+ gate_required: false,
7
+ reason: 'no matching policy — default allow',
8
+ rule_id: null,
9
+ };
10
+ class PolicyEngine {
11
+ constructor(rules = []) {
12
+ this.rules = rules;
13
+ }
14
+ evaluate(ctx) {
15
+ for (const rule of this.rules) {
16
+ if (!this.matches(rule.when, ctx))
17
+ continue;
18
+ if (rule.assert) {
19
+ const assertFailed = this.checkAssert(rule.assert, ctx);
20
+ if (assertFailed) {
21
+ return {
22
+ allowed: false,
23
+ gate_required: false,
24
+ reason: `Assert failed for rule ${rule.id}: ${assertFailed}`,
25
+ rule_id: rule.id,
26
+ };
27
+ }
28
+ }
29
+ switch (rule.action) {
30
+ case 'allow':
31
+ return { allowed: true, gate_required: false, reason: `Allowed by rule ${rule.id}`, rule_id: rule.id };
32
+ case 'deny':
33
+ return { allowed: false, gate_required: false, reason: `Denied by rule ${rule.id}`, rule_id: rule.id };
34
+ case 'require_human_gate':
35
+ return { allowed: true, gate_required: true, reason: `Gate required by rule ${rule.id}`, rule_id: rule.id };
36
+ }
37
+ }
38
+ return ALLOW_ALL;
39
+ }
40
+ matches(when, ctx) {
41
+ if (when.tool && when.tool !== ctx.tool)
42
+ return false;
43
+ if (when.env && when.env !== ctx.env)
44
+ return false;
45
+ if (when.kind && when.kind !== ctx.kind)
46
+ return false;
47
+ return true;
48
+ }
49
+ checkAssert(assert, ctx) {
50
+ if (assert.diff_within_scope === true) {
51
+ const scope = ctx.mutation_scope ?? [];
52
+ const affected = ctx.affected_paths ?? [];
53
+ if (scope.length === 0)
54
+ return null; // no scope declared — pass
55
+ const outsideScope = affected.filter((p) => !scope.some((s) => p.startsWith(s) || s.startsWith(p)));
56
+ if (outsideScope.length > 0) {
57
+ return `paths outside mutation scope: ${outsideScope.join(', ')}`;
58
+ }
59
+ }
60
+ return null;
61
+ }
62
+ withRule(rule) {
63
+ return new PolicyEngine([...this.rules, rule]);
64
+ }
65
+ static fromConfig(config) {
66
+ return new PolicyEngine(config.policies ?? []);
67
+ }
68
+ static fromConfigFile(configPath) {
69
+ try {
70
+ // Dynamic require to avoid bundling issues
71
+ // eslint-disable-next-line @typescript-eslint/no-var-requires
72
+ const cfg = require(configPath);
73
+ return PolicyEngine.fromConfig(cfg);
74
+ }
75
+ catch {
76
+ return new PolicyEngine();
77
+ }
78
+ }
79
+ }
80
+ exports.PolicyEngine = PolicyEngine;
@@ -0,0 +1 @@
1
+ export * from './projection-engine';
@@ -0,0 +1,17 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./projection-engine"), exports);
@@ -0,0 +1,11 @@
1
+ import type { RunState } from '../reducers/run-state-reducer';
2
+ import type { ExecutionGraph } from '../compiler/graph-compiler';
3
+ import type { VerificationResult } from '../models/verification-result';
4
+ import type { CheckResult } from '../verification/verification-compiler';
5
+ export declare class ProjectionEngine {
6
+ projectPlan(state: RunState, graph: ExecutionGraph): string;
7
+ projectVerify(state: RunState, results: VerificationResult[], checkResults?: CheckResult[]): string;
8
+ projectState(state: RunState): string;
9
+ projectRunSummary(state: RunState): string;
10
+ projectPRSummary(state: RunState, graph: ExecutionGraph): string;
11
+ }
@@ -0,0 +1,218 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ProjectionEngine = void 0;
4
+ function isoToDate(iso) {
5
+ if (!iso)
6
+ return '—';
7
+ return iso.slice(0, 10);
8
+ }
9
+ function statusIcon(status) {
10
+ switch (status) {
11
+ case 'completed': return '✓';
12
+ case 'failed': return '✗';
13
+ case 'blocked': return '⊘';
14
+ case 'running': return '⟳';
15
+ default: return '○';
16
+ }
17
+ }
18
+ function verifyIcon(status) {
19
+ switch (status) {
20
+ case 'pass': return '✓ PASS';
21
+ case 'fail': return '✗ FAIL';
22
+ case 'skip': return '— SKIP';
23
+ case 'error': return '! ERROR';
24
+ default: return status;
25
+ }
26
+ }
27
+ class ProjectionEngine {
28
+ projectPlan(state, graph) {
29
+ const run = state.run;
30
+ const lines = [
31
+ '# OXE — Plano de Execução',
32
+ '',
33
+ '<!-- Gerado automaticamente pelo Projection Engine — não editar diretamente -->',
34
+ '',
35
+ '## Resumo',
36
+ '',
37
+ `- **Run:** ${run?.run_id ?? '—'}`,
38
+ `- **Status:** ${run?.status ?? 'sem run'}`,
39
+ `- **Iniciado em:** ${isoToDate(run?.started_at)}`,
40
+ `- **Nós:** ${graph.metadata.node_count} tarefas em ${graph.metadata.wave_count} onda(s)`,
41
+ '',
42
+ '## Ondas e tarefas',
43
+ '',
44
+ ];
45
+ for (const wave of graph.waves) {
46
+ lines.push(`### Onda ${wave.wave_number}`);
47
+ lines.push('');
48
+ lines.push('| ID | Título | Status | Dependências |');
49
+ lines.push('|----|--------|--------|--------------|');
50
+ for (const nodeId of wave.node_ids) {
51
+ const node = graph.nodes.get(nodeId);
52
+ const wItem = state.workItems.get(nodeId);
53
+ const status = wItem?.status ?? 'pending';
54
+ const deps = node?.depends_on.join(', ') || '—';
55
+ lines.push(`| ${nodeId} | ${node?.title ?? nodeId} | ${statusIcon(status)} ${status} | ${deps} |`);
56
+ }
57
+ lines.push('');
58
+ }
59
+ if (state.completedWorkItems.size > 0 || state.failedWorkItems.size > 0) {
60
+ lines.push('## Progresso');
61
+ lines.push('');
62
+ lines.push(`- **Concluídos:** ${[...state.completedWorkItems].join(', ') || '—'}`);
63
+ lines.push(`- **Falhos:** ${[...state.failedWorkItems].join(', ') || '—'}`);
64
+ lines.push(`- **Bloqueados:** ${[...state.blockedWorkItems].join(', ') || '—'}`);
65
+ lines.push('');
66
+ }
67
+ return lines.join('\n');
68
+ }
69
+ projectVerify(state, results, checkResults) {
70
+ const run = state.run;
71
+ const lines = [
72
+ '# OXE — Verificação',
73
+ '',
74
+ '<!-- Gerado automaticamente pelo Projection Engine — não editar diretamente -->',
75
+ '',
76
+ '## Auditoria de pré-execução',
77
+ '',
78
+ `- **Run:** ${run?.run_id ?? '—'}`,
79
+ `- **Iniciado em:** ${isoToDate(run?.started_at)}`,
80
+ `- **Concluído em:** ${isoToDate(run?.ended_at)}`,
81
+ `- **Status:** ${run?.status ?? '—'}`,
82
+ '',
83
+ ];
84
+ if (results.length > 0) {
85
+ lines.push('## Critérios de aceite');
86
+ lines.push('');
87
+ lines.push('| ID | Check | Status | Evidências |');
88
+ lines.push('|----|-------|--------|------------|');
89
+ for (const r of results) {
90
+ const evidenceList = r.evidence_refs.join(', ') || '—';
91
+ lines.push(`| ${r.check_id} | ${r.summary ?? r.check_id} | ${verifyIcon(r.status)} | ${evidenceList} |`);
92
+ }
93
+ lines.push('');
94
+ }
95
+ if (checkResults && checkResults.length > 0) {
96
+ lines.push('## Resultados dos checks executados');
97
+ lines.push('');
98
+ lines.push('| Check | Aceite | Status | Duração |');
99
+ lines.push('|-------|--------|--------|---------|');
100
+ for (const cr of checkResults) {
101
+ lines.push(`| ${cr.check_id} | ${cr.acceptance_ref ?? '—'} | ${verifyIcon(cr.status)} | ${cr.duration_ms}ms |`);
102
+ }
103
+ lines.push('');
104
+ }
105
+ const passed = results.filter((r) => r.status === 'pass').length;
106
+ const failed = results.filter((r) => r.status === 'fail').length;
107
+ const allPass = failed === 0 && results.length > 0;
108
+ lines.push('## Conclusão');
109
+ lines.push('');
110
+ lines.push(`- **Total de critérios:** ${results.length}`);
111
+ lines.push(`- **Aprovados:** ${passed}`);
112
+ lines.push(`- **Reprovados:** ${failed}`);
113
+ lines.push('');
114
+ lines.push(allPass
115
+ ? '> ✓ **Verificação concluída com sucesso.** Todos os critérios foram atendidos.'
116
+ : `> ✗ **Verificação com falhas.** ${failed} critério(s) não atendido(s).`);
117
+ lines.push('');
118
+ return lines.join('\n');
119
+ }
120
+ projectState(state) {
121
+ const run = state.run;
122
+ const completed = [...state.completedWorkItems];
123
+ const failed = [...state.failedWorkItems];
124
+ const blocked = [...state.blockedWorkItems];
125
+ const lines = [
126
+ '# OXE — Estado',
127
+ '',
128
+ '<!-- Gerado automaticamente pelo Projection Engine — não editar diretamente -->',
129
+ '',
130
+ '## Fase atual',
131
+ '',
132
+ `- **Status da run:** ${run?.status ?? 'sem run ativa'}`,
133
+ `- **Run ID:** ${run?.run_id ?? '—'}`,
134
+ `- **Modo:** ${run?.mode ?? '—'}`,
135
+ '',
136
+ '## Runtime operacional',
137
+ '',
138
+ `- **runtime_status:** ${run?.status ?? '—'}`,
139
+ `- **active_run_ref:** ${run?.run_id ?? '—'}`,
140
+ '',
141
+ '## Progresso',
142
+ '',
143
+ `- **Concluídos (${completed.length}):** ${completed.join(', ') || '—'}`,
144
+ `- **Falhos (${failed.length}):** ${failed.join(', ') || '—'}`,
145
+ `- **Bloqueados (${blocked.length}):** ${blocked.join(', ') || '—'}`,
146
+ '',
147
+ `- **lifecycleStatus:** ${run?.status === 'completed' ? 'closed' : run?.status === 'running' ? 'executing' : 'pending_execute'}`,
148
+ '',
149
+ ];
150
+ return lines.join('\n');
151
+ }
152
+ projectRunSummary(state) {
153
+ const run = state.run;
154
+ const completed = [...state.completedWorkItems];
155
+ const failed = [...state.failedWorkItems];
156
+ const blocked = [...state.blockedWorkItems];
157
+ const totalAttempts = [...state.attempts.values()].reduce((s, a) => s + a.length, 0);
158
+ const lines = [
159
+ `## Run Summary — ${run?.run_id ?? 'unknown'}`,
160
+ '',
161
+ `**Status:** ${run?.status ?? '—'} `,
162
+ `**Mode:** ${run?.mode ?? '—'} `,
163
+ `**Started:** ${isoToDate(run?.started_at)} `,
164
+ `**Ended:** ${isoToDate(run?.ended_at)} `,
165
+ '',
166
+ `**Completed:** ${completed.length} tasks `,
167
+ `**Failed:** ${failed.length} tasks `,
168
+ `**Blocked:** ${blocked.length} tasks `,
169
+ `**Total attempts:** ${totalAttempts} `,
170
+ '',
171
+ ];
172
+ if (completed.length > 0) {
173
+ lines.push(`**✓ Completed:** ${completed.join(', ')}`);
174
+ }
175
+ if (failed.length > 0) {
176
+ lines.push(`**✗ Failed:** ${failed.join(', ')}`);
177
+ }
178
+ if (blocked.length > 0) {
179
+ lines.push(`**⊘ Blocked:** ${blocked.join(', ')}`);
180
+ }
181
+ return lines.join('\n');
182
+ }
183
+ projectPRSummary(state, graph) {
184
+ const run = state.run;
185
+ const completed = [...state.completedWorkItems];
186
+ const failed = [...state.failedWorkItems];
187
+ const lines = [
188
+ '## Summary',
189
+ '',
190
+ ];
191
+ if (completed.length > 0) {
192
+ for (const id of completed) {
193
+ const node = graph.nodes.get(id);
194
+ lines.push(`- ✓ ${node?.title ?? id} (\`${id}\`)`);
195
+ }
196
+ }
197
+ if (failed.length > 0) {
198
+ lines.push('');
199
+ lines.push('**⚠️ Incomplete tasks:**');
200
+ for (const id of failed) {
201
+ const node = graph.nodes.get(id);
202
+ lines.push(`- ✗ ${node?.title ?? id} (\`${id}\`)`);
203
+ }
204
+ }
205
+ lines.push('');
206
+ lines.push('## Test plan');
207
+ lines.push('');
208
+ for (const wave of graph.waves) {
209
+ lines.push(`- [ ] Wave ${wave.wave_number}: ${wave.node_ids.join(', ')}`);
210
+ }
211
+ lines.push('');
212
+ lines.push(`**Run:** \`${run?.run_id ?? '—'}\` | **Status:** ${run?.status ?? '—'}`);
213
+ lines.push('');
214
+ lines.push('🤖 Generated with [OXE Runtime](https://github.com/propagno/oxe-build)');
215
+ return lines.join('\n');
216
+ }
217
+ }
218
+ exports.ProjectionEngine = ProjectionEngine;
@@ -0,0 +1,10 @@
1
+ import type { OxeEvent } from '../events/envelope';
2
+ import type { RunState } from './run-state-reducer';
3
+ export interface ReplayStep {
4
+ index: number;
5
+ event: OxeEvent;
6
+ state: RunState;
7
+ }
8
+ export declare function stepReplay(events: OxeEvent[]): Generator<ReplayStep>;
9
+ export declare function replayUntil(events: OxeEvent[], predicate: (step: ReplayStep) => boolean): ReplayStep | null;
10
+ export declare function replaySlice(events: OxeEvent[], from: number, to: number): ReplayStep[];
@@ -0,0 +1,30 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.stepReplay = stepReplay;
4
+ exports.replayUntil = replayUntil;
5
+ exports.replaySlice = replaySlice;
6
+ const run_state_reducer_1 = require("./run-state-reducer");
7
+ function* stepReplay(events) {
8
+ let state = (0, run_state_reducer_1.createEmptyRunState)();
9
+ for (let i = 0; i < events.length; i++) {
10
+ state = (0, run_state_reducer_1.applyEventExported)(state, events[i]);
11
+ yield { index: i, event: events[i], state };
12
+ }
13
+ }
14
+ function replayUntil(events, predicate) {
15
+ for (const step of stepReplay(events)) {
16
+ if (predicate(step))
17
+ return step;
18
+ }
19
+ return null;
20
+ }
21
+ function replaySlice(events, from, to) {
22
+ const steps = [];
23
+ for (const step of stepReplay(events)) {
24
+ if (step.index >= from && step.index <= to)
25
+ steps.push(step);
26
+ if (step.index > to)
27
+ break;
28
+ }
29
+ return steps;
30
+ }
@@ -0,0 +1,2 @@
1
+ export * from './run-state-reducer';
2
+ export * from './debug-reducer';
@@ -0,0 +1,18 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./run-state-reducer"), exports);
18
+ __exportStar(require("./debug-reducer"), exports);
@@ -0,0 +1,20 @@
1
+ import type { OxeEvent } from '../events/envelope';
2
+ import type { Run } from '../models/run';
3
+ import type { WorkItem } from '../models/work-item';
4
+ import type { Attempt } from '../models/attempt';
5
+ import type { Workspace } from '../models/workspace';
6
+ export interface RunState {
7
+ run: Run | null;
8
+ workItems: Map<string, WorkItem>;
9
+ attempts: Map<string, Attempt[]>;
10
+ workspaces: Map<string, Workspace>;
11
+ completedWorkItems: Set<string>;
12
+ failedWorkItems: Set<string>;
13
+ blockedWorkItems: Set<string>;
14
+ }
15
+ export declare function createEmptyRunState(): RunState;
16
+ export declare function reduce(events: OxeEvent[]): RunState;
17
+ export { applyEvent as applyEventExported };
18
+ declare function applyEvent(state: RunState, event: OxeEvent): RunState;
19
+ export declare function getWorkItemStatus(state: RunState, workItemId: string): WorkItem['status'] | null;
20
+ export declare function getAttemptCount(state: RunState, workItemId: string): number;