reflectt-node 0.1.8 → 0.1.11

package/dist/routing-enforcement.test.js

@@ -0,0 +1,86 @@
+// SPDX-License-Identifier: Apache-2.0
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+const ACTIONABLE = new Set(['review_requested', 'approval_requested', 'escalation', 'handoff']);
+const VALID_URGENCY = new Set(['low', 'normal', 'high', 'critical']);
+function validate(eventType, payload) {
+    if (!ACTIONABLE.has(eventType))
+        return { valid: true, errors: [] };
+    const errors = [];
+    if (!payload.action_required || typeof payload.action_required !== 'string')
+        errors.push('action_required required');
+    if (!payload.urgency || typeof payload.urgency !== 'string')
+        errors.push('urgency required');
+    else if (!VALID_URGENCY.has(payload.urgency))
+        errors.push('invalid urgency');
+    if (!payload.owner || typeof payload.owner !== 'string')
+        errors.push('owner required');
+    return { valid: errors.length === 0, errors };
+}
+describe('routing semantics enforcement', () => {
+    it('non-actionable events always pass', () => {
+        assert.equal(validate('task_completed', {}).valid, true);
+        assert.equal(validate('memory_written', {}).valid, true);
+        assert.equal(validate('run_started', {}).valid, true);
+    });
+    it('review_requested with all fields passes', () => {
+        const r = validate('review_requested', { action_required: 'Review PR', urgency: 'normal', owner: 'kai' });
+        assert.equal(r.valid, true);
+    });
+    it('approval_requested with all fields passes', () => {
+        const r = validate('approval_requested', { action_required: 'Deploy?', urgency: 'high', owner: 'ryan' });
+        assert.equal(r.valid, true);
+    });
+    it('escalation with all fields passes', () => {
+        const r = validate('escalation', { action_required: 'Server down', urgency: 'critical', owner: 'link' });
+        assert.equal(r.valid, true);
+    });
+    it('handoff with all fields passes', () => {
+        const r = validate('handoff', { action_required: 'Continue build', urgency: 'normal', owner: 'pixel' });
+        assert.equal(r.valid, true);
+    });
+    it('rejects missing action_required', () => {
+        const r = validate('review_requested', { urgency: 'normal', owner: 'kai' });
+        assert.equal(r.valid, false);
+        assert.ok(r.errors.some(e => e.includes('action_required')));
+    });
+    it('rejects missing urgency', () => {
+        const r = validate('review_requested', { action_required: 'Review', owner: 'kai' });
+        assert.equal(r.valid, false);
+        assert.ok(r.errors.some(e => e.includes('urgency')));
+    });
+    it('rejects missing owner', () => {
+        const r = validate('review_requested', { action_required: 'Review', urgency: 'normal' });
+        assert.equal(r.valid, false);
+        assert.ok(r.errors.some(e => e.includes('owner')));
+    });
+    it('rejects invalid urgency value', () => {
+        const r = validate('review_requested', { action_required: 'Review', urgency: 'medium', owner: 'kai' });
+        assert.equal(r.valid, false);
+        assert.ok(r.errors.some(e => e.includes('urgency')));
+    });
+    it('accepts all valid urgency levels', () => {
+        for (const u of ['low', 'normal', 'high', 'critical']) {
+            const r = validate('review_requested', { action_required: 'Test', urgency: u, owner: 'kai' });
+            assert.equal(r.valid, true, `${u} should be valid`);
+        }
+    });
+    it('rejects empty payload for actionable event', () => {
+        const r = validate('approval_requested', {});
+        assert.equal(r.valid, false);
+        assert.equal(r.errors.length, 3); // missing all 3 required fields
+    });
+    it('collects all errors at once', () => {
+        const r = validate('escalation', {});
+        assert.equal(r.errors.length, 3);
+    });
+    it('rejects non-string action_required', () => {
+        const r = validate('review_requested', { action_required: 123, urgency: 'normal', owner: 'kai' });
+        assert.equal(r.valid, false);
+    });
+    it('rejects non-string owner', () => {
+        const r = validate('review_requested', { action_required: 'Review', urgency: 'normal', owner: 42 });
+        assert.equal(r.valid, false);
+    });
+});
+//# sourceMappingURL=routing-enforcement.test.js.map

package/dist/routing-enforcement.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-enforcement.test.js","sourceRoot":"","sources":["../src/routing-enforcement.test.ts"],"names":[],"mappings":"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"}

package/dist/run-retention.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-retention.test.d.ts.map

package/dist/run-retention.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-retention.test.d.ts","sourceRoot":"","sources":["../src/run-retention.test.ts"],"names":[],"mappings":""}

package/dist/run-retention.test.js

@@ -0,0 +1,57 @@
+// SPDX-License-Identifier: Apache-2.0
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+const DEFAULT_POLICY = { maxAgeDays: 30, maxCompletedRuns: 100, deleteArchived: false };
+function shouldArchive(run, policy, now) {
+    const terminal = ['completed', 'failed', 'cancelled'].includes(run.status);
+    if (!terminal)
+        return false;
+    const cutoff = now - policy.maxAgeDays * 24 * 60 * 60 * 1000;
+    return run.startedAt < cutoff;
+}
+describe('run retention policy', () => {
+    const now = Date.now();
+    const day = 24 * 60 * 60 * 1000;
+    it('does not archive active runs', () => {
+        assert.equal(shouldArchive({ status: 'working', startedAt: now - 60 * day }, DEFAULT_POLICY, now), false);
+        assert.equal(shouldArchive({ status: 'idle', startedAt: now - 60 * day }, DEFAULT_POLICY, now), false);
+        assert.equal(shouldArchive({ status: 'blocked', startedAt: now - 60 * day }, DEFAULT_POLICY, now), false);
+    });
+    it('archives completed runs older than maxAgeDays', () => {
+        assert.equal(shouldArchive({ status: 'completed', startedAt: now - 31 * day }, DEFAULT_POLICY, now), true);
+    });
+    it('does not archive recent completed runs', () => {
+        assert.equal(shouldArchive({ status: 'completed', startedAt: now - 5 * day }, DEFAULT_POLICY, now), false);
+    });
+    it('archives failed runs older than maxAgeDays', () => {
+        assert.equal(shouldArchive({ status: 'failed', startedAt: now - 31 * day }, DEFAULT_POLICY, now), true);
+    });
+    it('archives cancelled runs older than maxAgeDays', () => {
+        assert.equal(shouldArchive({ status: 'cancelled', startedAt: now - 31 * day }, DEFAULT_POLICY, now), true);
+    });
+    it('respects custom maxAgeDays', () => {
+        const policy = { ...DEFAULT_POLICY, maxAgeDays: 7 };
+        assert.equal(shouldArchive({ status: 'completed', startedAt: now - 8 * day }, policy, now), true);
+        assert.equal(shouldArchive({ status: 'completed', startedAt: now - 5 * day }, policy, now), false);
+    });
+    it('boundary: exactly at cutoff is not archived', () => {
+        const cutoff = now - 30 * day;
+        assert.equal(shouldArchive({ status: 'completed', startedAt: cutoff }, DEFAULT_POLICY, now), false);
+    });
+    it('boundary: one ms before cutoff is archived', () => {
+        const cutoff = now - 30 * day;
+        assert.equal(shouldArchive({ status: 'completed', startedAt: cutoff - 1 }, DEFAULT_POLICY, now), true);
+    });
+    it('default policy values are sensible', () => {
+        assert.equal(DEFAULT_POLICY.maxAgeDays, 30);
+        assert.equal(DEFAULT_POLICY.maxCompletedRuns, 100);
+        assert.equal(DEFAULT_POLICY.deleteArchived, false);
+    });
+    it('deleteArchived flag controls hard delete vs soft archive', () => {
+        const soft = { ...DEFAULT_POLICY, deleteArchived: false };
+        const hard = { ...DEFAULT_POLICY, deleteArchived: true };
+        assert.equal(soft.deleteArchived, false);
+        assert.equal(hard.deleteArchived, true);
+    });
+});
+//# sourceMappingURL=run-retention.test.js.map

package/dist/run-retention.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-retention.test.js","sourceRoot":"","sources":["../src/run-retention.test.ts"],"names":[],"mappings":"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"}

package/dist/run-stream.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-stream.test.d.ts.map

package/dist/run-stream.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-stream.test.d.ts","sourceRoot":"","sources":["../src/run-stream.test.ts"],"names":[],"mappings":""}

package/dist/run-stream.test.js

@@ -0,0 +1,70 @@
+// SPDX-License-Identifier: Apache-2.0
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+// Test SSE format and event filtering logic
+describe('run stream SSE', () => {
+    it('formats snapshot event correctly', () => {
+        const run = { id: 'arun-1', status: 'working', agentId: 'link' };
+        const events = [{ id: 'aevt-1', type: 'task_started' }];
+        const sseData = `event: snapshot\ndata: ${JSON.stringify({ run, events })}\n\n`;
+        assert.ok(sseData.startsWith('event: snapshot'));
+        assert.ok(sseData.includes('"arun-1"'));
+    });
+    it('formats event correctly', () => {
+        const event = { id: 'evt-1', type: 'canvas_render', data: { agentId: 'link', state: 'thinking' } };
+        const sseData = `event: ${event.type}\ndata: ${JSON.stringify(event)}\n\n`;
+        assert.ok(sseData.startsWith('event: canvas_render'));
+        assert.ok(sseData.includes('"thinking"'));
+    });
+    it('heartbeat format is valid SSE comment', () => {
+        const heartbeat = `:heartbeat\n\n`;
+        assert.ok(heartbeat.startsWith(':'));
+    });
+    it('filters events by runId', () => {
+        const targetRunId = 'arun-target';
+        const events = [
+            { data: { runId: 'arun-target', agentId: 'link' } },
+            { data: { runId: 'arun-other', agentId: 'pixel' } },
+            { data: { runId: 'arun-target', agentId: 'link' } },
+        ];
+        const matched = events.filter(e => e.data.runId === targetRunId);
+        assert.equal(matched.length, 2);
+    });
+    it('filters events by agentId', () => {
+        const targetAgent = 'link';
+        const events = [
+            { data: { agentId: 'link' } },
+            { data: { agentId: 'pixel' } },
+            { data: { agentId: 'link' } },
+            { data: { agentId: 'kai' } },
+        ];
+        const matched = events.filter(e => e.data.agentId === targetAgent);
+        assert.equal(matched.length, 2);
+    });
+    it('snapshot includes both run state and recent events', () => {
+        const snapshot = {
+            run: { id: 'arun-1', status: 'working', objective: 'Build API' },
+            events: [
+                { id: 'aevt-1', type: 'run_started' },
+                { id: 'aevt-2', type: 'task_completed' },
+            ],
+        };
+        assert.ok(snapshot.run);
+        assert.equal(snapshot.events.length, 2);
+        assert.equal(snapshot.run.status, 'working');
+    });
+    it('agent stream includes active run and events', () => {
+        const snapshot = {
+            activeRun: { id: 'arun-1', status: 'working' },
+            events: [{ id: 'aevt-1' }],
+        };
+        assert.ok(snapshot.activeRun);
+        assert.equal(snapshot.events.length, 1);
+    });
+    it('agent stream handles null active run', () => {
+        const snapshot = { activeRun: null, events: [] };
+        assert.equal(snapshot.activeRun, null);
+        assert.equal(snapshot.events.length, 0);
+    });
+});
+//# sourceMappingURL=run-stream.test.js.map

package/dist/run-stream.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-stream.test.js","sourceRoot":"","sources":["../src/run-stream.test.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,MAAM,MAAM,oBAAoB,CAAA;AAEvC,4CAA4C;AAC5C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;QAChE,MAAM,MAAM,GAAG,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;QACvD,MAAM,OAAO,GAAG,0BAA0B,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,MAAM,CAAA;QAC/E,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAA;QAChD,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,KAAK,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CAAA;QAClG,MAAM,OAAO,GAAG,UAAU,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAA;QAC1E,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAA;QACrD,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,SAAS,GAAG,gBAAgB,CAAA;QAClC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,WAAW,GAAG,aAAa,CAAA;QACjC,MAAM,MAAM,GAAG;YACb,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;YACnD,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YACnD,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;SACpD,CAAA;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC,CAAC,IAAY,CAAC,KAAK,KAAK,WAAW,CAAC,CAAA;QACzE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,WAAW,GAAG,MAAM,CAAA;QAC1B,MAAM,MAAM,GAAG;YACb,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7B,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YAC9B,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7B,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;SAC7B,CAAA;QACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAE,CAAC,CAAC,IAAY,CAAC,OAAO,KAAK,WAAW,CAAC,CAAA;QAC3E,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,QAAQ,GAAG;YACf,GAAG,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE;YAChE,MAAM,EAAE;gBACN,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE;gBACrC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,EAAE;aACzC;SACF,CAAA;QACD,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACvB,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;QACvC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,QAAQ,GAAG;YACf,SAAS,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE;YAC9C,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;SAC3B,CAAA;QACD,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;QAC7B,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,QAAQ,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAA;QAChD,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QACtC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAA;AAo3D9D,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CA8wW7D"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAA;AA63D9D,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CA0/Y7D"}