opencastle 0.27.1 → 0.27.2

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 (66) hide show
  1. package/dist/cli/convoy/dashboard-types.d.ts +146 -0
  2. package/dist/cli/convoy/dashboard-types.d.ts.map +1 -0
  3. package/dist/cli/convoy/dashboard-types.js +2 -0
  4. package/dist/cli/convoy/dashboard-types.js.map +1 -0
  5. package/dist/cli/convoy/engine.d.ts +0 -1
  6. package/dist/cli/convoy/engine.d.ts.map +1 -1
  7. package/dist/cli/convoy/engine.js +31 -99
  8. package/dist/cli/convoy/engine.js.map +1 -1
  9. package/dist/cli/convoy/engine.test.js +88 -1
  10. package/dist/cli/convoy/engine.test.js.map +1 -1
  11. package/dist/cli/convoy/event-schemas.d.ts +9 -0
  12. package/dist/cli/convoy/event-schemas.d.ts.map +1 -0
  13. package/dist/cli/convoy/event-schemas.js +185 -0
  14. package/dist/cli/convoy/event-schemas.js.map +1 -0
  15. package/dist/cli/convoy/events.d.ts +8 -0
  16. package/dist/cli/convoy/events.d.ts.map +1 -1
  17. package/dist/cli/convoy/events.js +117 -5
  18. package/dist/cli/convoy/events.js.map +1 -1
  19. package/dist/cli/convoy/events.test.js +173 -3
  20. package/dist/cli/convoy/events.test.js.map +1 -1
  21. package/dist/cli/convoy/log-merge.test.d.ts +2 -0
  22. package/dist/cli/convoy/log-merge.test.d.ts.map +1 -0
  23. package/dist/cli/convoy/log-merge.test.js +147 -0
  24. package/dist/cli/convoy/log-merge.test.js.map +1 -0
  25. package/dist/cli/convoy/store.d.ts +52 -2
  26. package/dist/cli/convoy/store.d.ts.map +1 -1
  27. package/dist/cli/convoy/store.js +244 -17
  28. package/dist/cli/convoy/store.js.map +1 -1
  29. package/dist/cli/convoy/store.test.js +481 -22
  30. package/dist/cli/convoy/store.test.js.map +1 -1
  31. package/dist/cli/convoy/types.d.ts +271 -3
  32. package/dist/cli/convoy/types.d.ts.map +1 -1
  33. package/dist/cli/convoy/types.js +42 -1
  34. package/dist/cli/convoy/types.js.map +1 -1
  35. package/dist/cli/log.d.ts +11 -0
  36. package/dist/cli/log.d.ts.map +1 -1
  37. package/dist/cli/log.js +114 -2
  38. package/dist/cli/log.js.map +1 -1
  39. package/package.json +5 -1
  40. package/src/cli/convoy/TELEMETRY.md +203 -0
  41. package/src/cli/convoy/dashboard-types.ts +141 -0
  42. package/src/cli/convoy/engine.test.ts +99 -1
  43. package/src/cli/convoy/engine.ts +27 -96
  44. package/src/cli/convoy/event-schemas.ts +195 -0
  45. package/src/cli/convoy/events.test.ts +207 -3
  46. package/src/cli/convoy/events.ts +119 -5
  47. package/src/cli/convoy/log-merge.test.ts +179 -0
  48. package/src/cli/convoy/store.test.ts +545 -22
  49. package/src/cli/convoy/store.ts +274 -21
  50. package/src/cli/convoy/types.ts +108 -3
  51. package/src/cli/log.ts +120 -2
  52. package/src/dashboard/dist/_astro/{index.DtnyD8a5.css → index.6L3_HsPT.css} +1 -1
  53. package/src/dashboard/dist/data/.gitkeep +0 -0
  54. package/src/dashboard/dist/data/convoy-list.json +1 -0
  55. package/src/dashboard/dist/data/overall-stats.json +24 -0
  56. package/src/dashboard/dist/index.html +701 -3
  57. package/src/dashboard/node_modules/.vite/deps/_metadata.json +6 -6
  58. package/src/dashboard/public/data/.gitkeep +0 -0
  59. package/src/dashboard/public/data/convoy-list.json +1 -0
  60. package/src/dashboard/public/data/overall-stats.json +24 -0
  61. package/src/dashboard/scripts/etl.test.ts +210 -0
  62. package/src/dashboard/scripts/etl.ts +108 -0
  63. package/src/dashboard/scripts/integration-test.ts +504 -0
  64. package/src/dashboard/src/pages/index.astro +854 -15
  65. package/src/dashboard/src/styles/dashboard.css +557 -1
  66. package/src/orchestrator/prompts/generate-convoy.prompt.md +212 -13
@@ -0,0 +1,185 @@
1
+ import * as v from 'valibot';
2
+ export const EVENT_DATA_SCHEMAS = {
3
+ convoy_started: v.looseObject({ name: v.optional(v.string()) }),
4
+ convoy_finished: v.looseObject({ status: v.string() }),
5
+ convoy_failed: v.looseObject({ status: v.string(), reason: v.optional(v.string()) }),
6
+ convoy_guard: v.looseObject({ checks: v.optional(v.array(v.string())) }),
7
+ task_started: v.looseObject({ worker_id: v.optional(v.string()) }),
8
+ task_done: v.looseObject({
9
+ status: v.optional(v.string()),
10
+ retries: v.optional(v.number()),
11
+ worker_id: v.optional(v.string()),
12
+ }),
13
+ task_failed: v.looseObject({
14
+ reason: v.string(),
15
+ worker_id: v.optional(v.string()),
16
+ gate: v.optional(v.string()),
17
+ hook: v.optional(v.string()),
18
+ }),
19
+ task_skipped: v.looseObject({ reason: v.string() }),
20
+ task_retried: v.looseObject({ previous_status: v.string() }),
21
+ task_waiting_input: v.looseObject({
22
+ task_id: v.optional(v.string()),
23
+ reason: v.optional(v.string()),
24
+ }),
25
+ review_started: v.looseObject({
26
+ level: v.string(),
27
+ task_id: v.optional(v.string()),
28
+ model: v.optional(v.string()),
29
+ }),
30
+ review_verdict: v.looseObject({
31
+ level: v.string(),
32
+ verdict: v.string(),
33
+ tokens: v.number(),
34
+ model: v.optional(v.string()),
35
+ feedback_length: v.optional(v.number()),
36
+ budget_exceeded: v.optional(v.boolean()),
37
+ budget_downgrade: v.optional(v.boolean()),
38
+ budget_skip: v.optional(v.boolean()),
39
+ passes: v.optional(v.number()),
40
+ blocks: v.optional(v.number()),
41
+ }),
42
+ dispute_opened: v.looseObject({
43
+ dispute_id: v.string(),
44
+ task_id: v.string(),
45
+ agent: v.optional(v.string()),
46
+ reason: v.optional(v.string()),
47
+ }),
48
+ dlq_entry_created: v.looseObject({
49
+ dlq_id: v.string(),
50
+ task_id: v.string(),
51
+ agent: v.optional(v.string()),
52
+ attempts: v.optional(v.number()),
53
+ }),
54
+ drift_check_result: v.looseObject({
55
+ score: v.optional(v.number()),
56
+ threshold: v.optional(v.number()),
57
+ passed: v.optional(v.boolean()),
58
+ }),
59
+ drift_detected: v.looseObject({
60
+ score: v.optional(v.number()),
61
+ files: v.optional(v.array(v.string())),
62
+ }),
63
+ circuit_breaker_tripped: v.looseObject({
64
+ agent: v.optional(v.string()),
65
+ failure_count: v.optional(v.number()),
66
+ threshold: v.optional(v.number()),
67
+ }),
68
+ circuit_breaker_fallback: v.looseObject({
69
+ original_agent: v.optional(v.string()),
70
+ fallback_agent: v.optional(v.string()),
71
+ task_id: v.optional(v.string()),
72
+ }),
73
+ circuit_breaker_blocked: v.looseObject({
74
+ agent: v.optional(v.string()),
75
+ task_id: v.optional(v.string()),
76
+ }),
77
+ merge_conflict_detected: v.looseObject({
78
+ task_id: v.optional(v.string()),
79
+ files: v.optional(v.array(v.string())),
80
+ }),
81
+ merge_conflict_failed: v.looseObject({
82
+ task_id: v.optional(v.string()),
83
+ error: v.optional(v.string()),
84
+ }),
85
+ file_injection_received: v.looseObject({
86
+ task_id: v.optional(v.string()),
87
+ from_task: v.optional(v.string()),
88
+ name: v.optional(v.string()),
89
+ }),
90
+ artifact_limit_reached: v.looseObject({
91
+ task_id: v.optional(v.string()),
92
+ limit: v.optional(v.number()),
93
+ current: v.optional(v.number()),
94
+ }),
95
+ agent_identity_captured: v.looseObject({
96
+ agent: v.optional(v.string()),
97
+ task_id: v.optional(v.string()),
98
+ }),
99
+ agent_identity_rejected: v.looseObject({
100
+ agent: v.optional(v.string()),
101
+ task_id: v.optional(v.string()),
102
+ reason: v.optional(v.string()),
103
+ }),
104
+ weak_area_skipped: v.looseObject({
105
+ agent: v.optional(v.string()),
106
+ weak_areas: v.optional(v.array(v.string())),
107
+ task_files: v.optional(v.array(v.string())),
108
+ }),
109
+ swarm_concurrency_update: v.looseObject({
110
+ new_concurrency: v.optional(v.number()),
111
+ reason: v.optional(v.string()),
112
+ }),
113
+ post_convoy_hook_failed: v.looseObject({
114
+ hook: v.optional(v.string()),
115
+ error: v.optional(v.string()),
116
+ }),
117
+ session: v.looseObject({
118
+ agent: v.optional(v.string()),
119
+ model: v.optional(v.string()),
120
+ task: v.optional(v.string()),
121
+ outcome: v.optional(v.string()),
122
+ duration_min: v.optional(v.number()),
123
+ }),
124
+ delegation: v.looseObject({
125
+ agent: v.optional(v.string()),
126
+ model: v.optional(v.string()),
127
+ tier: v.optional(v.string()),
128
+ mechanism: v.optional(v.string()),
129
+ outcome: v.optional(v.string()),
130
+ }),
131
+ secret_leak_prevented: v.looseObject({
132
+ original_type: v.optional(v.string()),
133
+ patterns: v.optional(v.array(v.string())),
134
+ task_id: v.optional(v.string()),
135
+ findings_count: v.optional(v.number()),
136
+ context: v.optional(v.string()),
137
+ }),
138
+ ndjson_write_failed: v.looseObject({ original_type: v.optional(v.string()) }),
139
+ built_in_gate_result: v.looseObject({
140
+ gate: v.string(),
141
+ passed: v.boolean(),
142
+ output: v.optional(v.string()),
143
+ level: v.optional(v.string()),
144
+ }),
145
+ watch_started: v.looseObject({
146
+ trigger_type: v.optional(v.string()),
147
+ pid: v.optional(v.number()),
148
+ }),
149
+ watch_cycle_start: v.looseObject({
150
+ cycle_number: v.optional(v.number()),
151
+ triggered_by: v.optional(v.string()),
152
+ }),
153
+ watch_cycle_end: v.looseObject({
154
+ cycle_number: v.optional(v.number()),
155
+ status: v.optional(v.string()),
156
+ }),
157
+ watch_stopped: v.looseObject({ reason: v.optional(v.string()) }),
158
+ worker_killed: v.looseObject({
159
+ reason: v.optional(v.string()),
160
+ worker_id: v.optional(v.string()),
161
+ task_id: v.optional(v.string()),
162
+ }),
163
+ discovered_issue: v.looseObject({
164
+ task_id: v.optional(v.string()),
165
+ title: v.optional(v.string()),
166
+ file: v.optional(v.string()),
167
+ description: v.optional(v.string()),
168
+ severity: v.optional(v.string()),
169
+ }),
170
+ };
171
+ export function validateEventData(type, data) {
172
+ const schema = EVENT_DATA_SCHEMAS[type];
173
+ if (schema === undefined)
174
+ return { valid: true };
175
+ if (data === undefined || data === null)
176
+ return { valid: true };
177
+ const result = v.safeParse(schema, data);
178
+ if (result.success)
179
+ return { valid: true };
180
+ return {
181
+ valid: false,
182
+ issues: result.issues.map((i) => i.message),
183
+ };
184
+ }
185
+ //# sourceMappingURL=event-schemas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"event-schemas.js","sourceRoot":"","sources":["../../../src/cli/convoy/event-schemas.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,6 @@
1
1
  import type { ConvoyStore } from './store.js';
2
+ export declare function validateEventType(type: string): boolean;
3
+ export declare function ndjsonPathForConvoy(convoyId: string, basePath?: string): string;
2
4
  export interface ConvoyEventEmitter {
3
5
  emit(type: string, data?: Record<string, unknown>, ids?: {
4
6
  convoy_id?: string;
@@ -10,4 +12,10 @@ export interface ConvoyEventEmitter {
10
12
  export declare function createEventEmitter(store: ConvoyStore, options?: {
11
13
  ndjsonPath?: string;
12
14
  }): ConvoyEventEmitter;
15
+ /**
16
+ * Truncate any trailing partial line in the NDJSON file, then replay any SQLite
17
+ * events for the given convoy that are missing from the file.
18
+ * Exported for unit testing.
19
+ */
20
+ export declare function recoverNdjson(store: ConvoyStore, convoyId: string, ndjsonPath: string): void;
13
21
  //# sourceMappingURL=events.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7C,MAAM,WAAW,kBAAkB;IACjC,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACjE,IAAI,CAAA;IACP,KAAK,IAAI,IAAI,CAAA;CACd;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,kBAAkB,CAgGpB"}
1
+ {"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/cli/convoy/events.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAO7C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG/E;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACjE,IAAI,CAAA;IACP,KAAK,IAAI,IAAI,CAAA;CACd;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,kBAAkB,CAkHpB;AAUD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAmE5F"}
@@ -1,13 +1,35 @@
1
- import { appendFileSync, closeSync, fsyncSync, openSync } from 'node:fs';
1
+ import { appendFileSync, closeSync, fsyncSync, mkdirSync, openSync, readFileSync, writeFileSync } from 'node:fs';
2
+ import { dirname, join } from 'node:path';
3
+ import { KNOWN_EVENT_TYPES } from './types.js';
4
+ import { validateEventData } from './event-schemas.js';
5
+ const RESERVED_KEYS = new Set(['_event_id', 'convoy_id', 'task_id', 'worker_id', 'timestamp', 'type']);
2
6
  import { scanForSecrets } from './gates.js';
7
+ export function validateEventType(type) {
8
+ return KNOWN_EVENT_TYPES.has(type);
9
+ }
10
+ export function ndjsonPathForConvoy(convoyId, basePath) {
11
+ const base = basePath ?? process.cwd();
12
+ return join(base, '.opencastle', 'logs', 'convoys', `${convoyId}.ndjson`);
13
+ }
3
14
  export function createEventEmitter(store, options) {
15
+ if (typeof options === 'string') {
16
+ throw new TypeError('createEventEmitter options must be an object, not a string');
17
+ }
4
18
  let fd = null;
5
19
  if (options?.ndjsonPath) {
20
+ mkdirSync(dirname(options.ndjsonPath), { recursive: true });
6
21
  fd = openSync(options.ndjsonPath, 'a');
7
22
  }
8
23
  // NDJSON writes are supplementary — SQLite is the primary store. Use async
9
24
  // retries to avoid blocking the Node.js event loop.
10
25
  async function writeNdjson(type, data, ids, now, eventId, currentFd) {
26
+ const safeData = {};
27
+ if (data) {
28
+ for (const [k, v] of Object.entries(data)) {
29
+ if (!RESERVED_KEYS.has(k))
30
+ safeData[k] = v;
31
+ }
32
+ }
11
33
  const record = {
12
34
  _event_id: eventId,
13
35
  timestamp: now,
@@ -15,7 +37,7 @@ export function createEventEmitter(store, options) {
15
37
  convoy_id: ids?.convoy_id ?? null,
16
38
  task_id: ids?.task_id ?? null,
17
39
  worker_id: ids?.worker_id ?? null,
18
- ...(data ?? {}),
40
+ ...safeData,
19
41
  };
20
42
  const jsonLine = JSON.stringify(record) + '\n';
21
43
  const scanResult = scanForSecrets(jsonLine, 'ndjson');
@@ -57,9 +79,16 @@ export function createEventEmitter(store, options) {
57
79
  }
58
80
  return {
59
81
  emit(type, data, ids) {
60
- // Event data is NOT secret-scanned here because all user-generated content
61
- // (task output, DLQ entries) is scanned at its source before reaching the
62
- // event emitter. Re-scanning would be redundant. See MF-4 in panel report.
82
+ // SQLite insert is not scanned; NDJSON write is scanned via writeNdjson().
83
+ // User-generated content (task output, DLQ entries) is scanned at its source
84
+ // before reaching the event emitter. See MF-4 in panel report.
85
+ if (!validateEventType(type)) {
86
+ console.warn(`[convoy] Unknown event type: "${type}"`);
87
+ }
88
+ const dataValidation = validateEventData(type, data);
89
+ if (!dataValidation.valid) {
90
+ console.warn(`[convoy] Invalid data for event type "${type}": ${dataValidation.issues?.join(', ')}`);
91
+ }
63
92
  const now = new Date().toISOString();
64
93
  const eventId = store.insertEvent({
65
94
  convoy_id: ids?.convoy_id ?? null,
@@ -85,4 +114,87 @@ export function createEventEmitter(store, options) {
85
114
  },
86
115
  };
87
116
  }
117
+ function safeJsonParse(raw) {
118
+ try {
119
+ return JSON.parse(raw);
120
+ }
121
+ catch {
122
+ return {};
123
+ }
124
+ }
125
+ /**
126
+ * Truncate any trailing partial line in the NDJSON file, then replay any SQLite
127
+ * events for the given convoy that are missing from the file.
128
+ * Exported for unit testing.
129
+ */
130
+ export function recoverNdjson(store, convoyId, ndjsonPath) {
131
+ // 1. Read the NDJSON file (if it exists)
132
+ let fileContent;
133
+ try {
134
+ fileContent = readFileSync(ndjsonPath, 'utf8');
135
+ }
136
+ catch {
137
+ fileContent = '';
138
+ }
139
+ // 2. Truncate any partial trailing line (no \n terminator)
140
+ if (fileContent.length > 0 && !fileContent.endsWith('\n')) {
141
+ const lastNewline = fileContent.lastIndexOf('\n');
142
+ if (lastNewline === -1) {
143
+ writeFileSync(ndjsonPath, '');
144
+ fileContent = '';
145
+ }
146
+ else {
147
+ writeFileSync(ndjsonPath, fileContent.slice(0, lastNewline + 1));
148
+ fileContent = fileContent.slice(0, lastNewline + 1);
149
+ }
150
+ }
151
+ // 3. Count valid NDJSON event IDs for this convoy
152
+ const ndjsonIds = new Set();
153
+ for (const line of fileContent.split('\n')) {
154
+ if (!line.trim())
155
+ continue;
156
+ try {
157
+ const parsed = JSON.parse(line);
158
+ if (parsed.convoy_id === convoyId && parsed._event_id != null) {
159
+ ndjsonIds.add(parsed._event_id);
160
+ }
161
+ }
162
+ catch {
163
+ // Skip unparseable lines
164
+ }
165
+ }
166
+ // 4. Get all SQLite events for this convoy
167
+ const sqliteEvents = store.getEvents(convoyId);
168
+ // 5. Replay missing events (those in SQLite but not in NDJSON)
169
+ const missing = sqliteEvents.filter(e => e.id != null && !ndjsonIds.has(e.id));
170
+ if (missing.length > 0) {
171
+ const fd = openSync(ndjsonPath, 'a');
172
+ try {
173
+ for (const event of missing) {
174
+ const parsedData = event.data ? safeJsonParse(event.data) : {};
175
+ // Strip reserved keys from event.data to prevent attacker-controlled
176
+ // values from overriding canonical fields from the DB row.
177
+ const safeData = {};
178
+ for (const [key, value] of Object.entries(parsedData)) {
179
+ if (!RESERVED_KEYS.has(key))
180
+ safeData[key] = value;
181
+ }
182
+ const record = {
183
+ ...safeData,
184
+ _event_id: event.id,
185
+ timestamp: event.created_at,
186
+ type: event.type,
187
+ convoy_id: event.convoy_id,
188
+ task_id: event.task_id,
189
+ worker_id: event.worker_id,
190
+ };
191
+ appendFileSync(fd, JSON.stringify(record) + '\n');
192
+ }
193
+ fsyncSync(fd);
194
+ }
195
+ finally {
196
+ closeSync(fd);
197
+ }
198
+ }
199
+ }
88
200
  //# sourceMappingURL=events.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/cli/convoy/events.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/cli/convoy/events.ts"],"names":[],"mappings":"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"}
@@ -2,10 +2,10 @@ import { mkdtempSync, readFileSync, writeFileSync, rmSync, existsSync } from 'no
2
2
  import { tmpdir } from 'node:os';
3
3
  import { join } from 'node:path';
4
4
  import { realpathSync } from 'node:fs';
5
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
5
+ import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
6
6
  import { createConvoyStore } from './store.js';
7
- import { createEventEmitter } from './events.js';
8
- import { recoverNdjson } from './engine.js';
7
+ import { createEventEmitter, ndjsonPathForConvoy, recoverNdjson, validateEventType } from './events.js';
8
+ import { KNOWN_EVENT_TYPES } from './types.js';
9
9
  let tmpDir;
10
10
  let store;
11
11
  let ndjsonPath;
@@ -28,6 +28,10 @@ afterEach(() => {
28
28
  rmSync(tmpDir, { recursive: true, force: true });
29
29
  });
30
30
  describe('createEventEmitter', () => {
31
+ it('throws TypeError when options is a string', () => {
32
+ expect(() => createEventEmitter(store, 'bad')).toThrow(TypeError);
33
+ expect(() => createEventEmitter(store, 'bad')).toThrow('createEventEmitter options must be an object, not a string');
34
+ });
31
35
  it('inserts the event into SQLite', () => {
32
36
  const emitter = createEventEmitter(store);
33
37
  emitter.emit('task_started', { msg: 'started' }, { convoy_id: 'c1' });
@@ -112,6 +116,28 @@ describe('createEventEmitter', () => {
112
116
  emitter.close();
113
117
  expect(() => emitter.close()).not.toThrow();
114
118
  });
119
+ it('sanitizes reserved keys from caller data before NDJSON write', () => {
120
+ const emitter = createEventEmitter(store, { ndjsonPath });
121
+ emitter.emit('task_started', {
122
+ convoy_id: 'attacker',
123
+ timestamp: 'fake',
124
+ _event_id: 999,
125
+ type: 'evil',
126
+ task_id: 'injected',
127
+ worker_id: 'hacker',
128
+ custom_field: 'ok',
129
+ }, { convoy_id: 'c1', task_id: 't1', worker_id: 'w1' });
130
+ emitter.close();
131
+ const content = readFileSync(ndjsonPath, 'utf8');
132
+ const line = JSON.parse(content.trim());
133
+ expect(line.convoy_id).toBe('c1');
134
+ expect(line.task_id).toBe('t1');
135
+ expect(line.worker_id).toBe('w1');
136
+ expect(line.type).toBe('task_started');
137
+ expect(line._event_id).not.toBe(999);
138
+ expect(line.timestamp).not.toBe('fake');
139
+ expect(line.custom_field).toBe('ok');
140
+ });
115
141
  });
116
142
  describe('crash resilience', () => {
117
143
  it('1. mid-write crash: SQLite has events, recovery writes NDJSON', () => {
@@ -217,5 +243,149 @@ describe('crash resilience', () => {
217
243
  const linesAfter = readFileSync(ndjsonPath, 'utf8').split('\n').filter(l => l.trim());
218
244
  expect(linesAfter).toHaveLength(count);
219
245
  });
246
+ it('6. canonical-field protection: event.data cannot override DB row fields', () => {
247
+ // Insert an event whose data contains attacker-controlled reserved keys
248
+ store.insertEvent({
249
+ convoy_id: 'c1',
250
+ task_id: 'legit-task',
251
+ worker_id: 'legit-worker',
252
+ type: 'task_done',
253
+ data: JSON.stringify({
254
+ convoy_id: 'attacker',
255
+ timestamp: 'fake',
256
+ _event_id: 9999,
257
+ type: 'evil',
258
+ task_id: 'injected',
259
+ worker_id: 'hacker',
260
+ safe_field: 'this-is-fine',
261
+ }),
262
+ created_at: new Date().toISOString(),
263
+ });
264
+ recoverNdjson(store, 'c1', ndjsonPath);
265
+ const lines = readFileSync(ndjsonPath, 'utf8').split('\n').filter(l => l.trim());
266
+ expect(lines).toHaveLength(1);
267
+ const record = JSON.parse(lines[0]);
268
+ // Canonical fields must come from the DB row, not from data
269
+ expect(record.convoy_id).toBe('c1');
270
+ expect(record.task_id).toBe('legit-task');
271
+ expect(record.worker_id).toBe('legit-worker');
272
+ expect(record.type).toBe('task_done');
273
+ expect(record._event_id).not.toBe(9999);
274
+ expect(record.timestamp).not.toBe('fake');
275
+ // Attacker values must not appear
276
+ expect(record.convoy_id).not.toBe('attacker');
277
+ expect(record.type).not.toBe('evil');
278
+ expect(record.task_id).not.toBe('injected');
279
+ expect(record.worker_id).not.toBe('hacker');
280
+ // Safe non-reserved fields are preserved
281
+ expect(record.safe_field).toBe('this-is-fine');
282
+ });
283
+ });
284
+ describe('KNOWN_EVENT_TYPES', () => {
285
+ it('contains all canonical event types', () => {
286
+ const canonical = [
287
+ 'convoy_started', 'convoy_finished', 'convoy_failed', 'convoy_guard',
288
+ 'task_started', 'task_done', 'task_failed', 'task_skipped', 'task_retried', 'task_waiting_input',
289
+ 'review_started', 'review_verdict', 'dispute_opened', 'dlq_entry_created',
290
+ 'drift_check_result', 'drift_detected',
291
+ 'circuit_breaker_tripped', 'circuit_breaker_fallback', 'circuit_breaker_blocked',
292
+ 'merge_conflict_detected', 'merge_conflict_failed',
293
+ 'file_injection_received', 'artifact_limit_reached',
294
+ 'agent_identity_captured', 'agent_identity_rejected',
295
+ 'weak_area_skipped', 'swarm_concurrency_update', 'post_convoy_hook_failed',
296
+ 'session', 'delegation',
297
+ 'secret_leak_prevented', 'ndjson_write_failed', 'built_in_gate_result',
298
+ 'watch_started', 'watch_cycle_start', 'watch_cycle_end', 'watch_stopped',
299
+ 'worker_killed', 'discovered_issue',
300
+ ];
301
+ for (const type of canonical) {
302
+ expect(KNOWN_EVENT_TYPES.has(type)).toBe(true);
303
+ }
304
+ });
305
+ it('has no duplicates (Set size matches array)', () => {
306
+ expect(KNOWN_EVENT_TYPES.size).toBeGreaterThanOrEqual(37);
307
+ });
308
+ });
309
+ describe('ndjsonPathForConvoy', () => {
310
+ it('returns correct per-convoy path with default basePath', () => {
311
+ const result = ndjsonPathForConvoy('abc-123');
312
+ expect(result).toBe(join(process.cwd(), '.opencastle', 'logs', 'convoys', 'abc-123.ndjson'));
313
+ });
314
+ it('returns correct per-convoy path with custom basePath', () => {
315
+ const result = ndjsonPathForConvoy('xyz-456', '/custom/base');
316
+ expect(result).toBe(join('/custom/base', '.opencastle', 'logs', 'convoys', 'xyz-456.ndjson'));
317
+ });
318
+ });
319
+ describe('createEventEmitter directory creation', () => {
320
+ it('creates parent directory when ndjsonPath is in a non-existent directory', () => {
321
+ const nestedPath = join(tmpDir, 'nested', 'dir', 'events.ndjson');
322
+ const emitter = createEventEmitter(store, { ndjsonPath: nestedPath });
323
+ emitter.emit('convoy_started', { name: 'test' }, { convoy_id: 'c1' });
324
+ emitter.close();
325
+ expect(existsSync(nestedPath)).toBe(true);
326
+ const content = readFileSync(nestedPath, 'utf8');
327
+ const line = JSON.parse(content.trim());
328
+ expect(line.type).toBe('convoy_started');
329
+ });
330
+ });
331
+ describe('validateEventType', () => {
332
+ it('returns true for known event types', () => {
333
+ expect(validateEventType('convoy_started')).toBe(true);
334
+ expect(validateEventType('task_done')).toBe(true);
335
+ expect(validateEventType('watch_stopped')).toBe(true);
336
+ });
337
+ it('returns false for unknown event types', () => {
338
+ expect(validateEventType('unknown_event')).toBe(false);
339
+ expect(validateEventType('')).toBe(false);
340
+ expect(validateEventType('convoy_start')).toBe(false);
341
+ });
342
+ });
343
+ describe('emit-time data validation', () => {
344
+ let warnSpy;
345
+ beforeEach(() => {
346
+ warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
347
+ });
348
+ afterEach(() => {
349
+ warnSpy.mockRestore();
350
+ });
351
+ it('valid data passes without warning', () => {
352
+ const emitter = createEventEmitter(store);
353
+ emitter.emit('convoy_finished', { status: 'done' }, { convoy_id: 'c1' });
354
+ emitter.close();
355
+ expect(warnSpy).not.toHaveBeenCalled();
356
+ });
357
+ it('invalid data shape warns with correct message', () => {
358
+ const emitter = createEventEmitter(store);
359
+ emitter.emit('convoy_finished', { status: 123 }, { convoy_id: 'c1' });
360
+ emitter.close();
361
+ expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('Invalid data for event type "convoy_finished"'));
362
+ });
363
+ it('missing required field warns', () => {
364
+ const emitter = createEventEmitter(store);
365
+ // task_failed requires reason: string — passing {} should fail
366
+ emitter.emit('task_failed', {}, { convoy_id: 'c1' });
367
+ emitter.close();
368
+ expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('Invalid data for event type "task_failed"'));
369
+ });
370
+ it('extra fields are allowed (no warning)', () => {
371
+ const emitter = createEventEmitter(store);
372
+ emitter.emit('convoy_started', { name: 'test', extra: true }, { convoy_id: 'c1' });
373
+ emitter.close();
374
+ expect(warnSpy).not.toHaveBeenCalled();
375
+ });
376
+ it('undefined data is valid', () => {
377
+ const emitter = createEventEmitter(store);
378
+ emitter.emit('convoy_started', undefined, { convoy_id: 'c1' });
379
+ emitter.close();
380
+ expect(warnSpy).not.toHaveBeenCalled();
381
+ });
382
+ it('unknown event type bypasses data validation (only one warning)', () => {
383
+ const emitter = createEventEmitter(store);
384
+ emitter.emit('unknown_type_xyz', { any: 'data' }, { convoy_id: 'c1' });
385
+ emitter.close();
386
+ expect(warnSpy).toHaveBeenCalledTimes(1);
387
+ expect(warnSpy).toHaveBeenCalledWith(expect.stringContaining('Unknown event type: "unknown_type_xyz"'));
388
+ expect(warnSpy).not.toHaveBeenCalledWith(expect.stringContaining('Invalid data'));
389
+ });
220
390
  });
221
391
  //# sourceMappingURL=events.test.js.map