feat(ql3): establish 3.0 incubation baseline

2026-09-22 10:32:40 +08:00 · 2026-08-12 00:25:26 +08:00
parent 4bf92dcfeb
commit c699c32461
2817 changed files with 779642 additions and 653 deletions
@@ -0,0 +1,75 @@
+const assert = require('node:assert/strict');
+const { test } = require('node:test');
+
+const {
+  createLocalApiRunReadRoute,
+} = require('../dist/run/runReadRoute.js');
+
+function run(overrides = {}) {
+  return {
+    id: 'run_123',
+    projectId: 'prj_default',
+    taskId: 'task_1',
+    taskRevision: 'revision_7',
+    taskName: 'must not cross the wire',
+    taskSnapshotRef: 'secret-adjacent-ref',
+    triggerType: 'manual',
+    executionOrigin: 'manual',
+    executionOwner: 'runtime',
+    triggeredBy: 'private-user-id',
+    requestId: 'private-request-id',
+    status: 'running',
+    version: 4,
+    eventSequence: 6,
+    priority: 10,
+    inputRef: 'private-input-ref',
+    outputRef: 'private-output-ref',
+    createdAtMs: 1_000,
+    queuedAtMs: 2_000,
+    startedAtMs: 3_000,
+    errorCode: 'private-error-code',
+    errorSummary: 'private error detail',
+    ...overrides,
+  };
+}
+
+test('returns the shared bounded Run projection without secret-adjacent fields', async () => {
+  const route = createLocalApiRunReadRoute({
+    async findRunById(runId) {
+      assert.equal(runId, 'run_123');
+      return run({ version: 0 });
+    },
+  });
+
+  const response = await route.handle({
+    projectId: 'prj_default',
+    runId: 'run_123',
+  });
+  assert.equal(response.statusCode, 200);
+  assert.equal(response.body.run.projectId, 'prj_default');
+  assert.equal(response.body.run.version, 0);
+  assert.equal(JSON.stringify(response).includes('private'), false);
+});
+
+test('collapses absent and cross-project Runs and fails closed on repository errors', async () => {
+  for (const value of [null, run({ projectId: 'another_project' })]) {
+    const route = createLocalApiRunReadRoute({
+      async findRunById() {
+        return value;
+      },
+    });
+    assert.deepEqual(
+      await route.handle({ projectId: 'prj_default', runId: 'run_123' }),
+      { statusCode: 404, body: { code: 'run_not_found' } },
+    );
+  }
+  const unavailable = createLocalApiRunReadRoute({
+    async findRunById() {
+      throw new Error('database unavailable');
+    },
+  });
+  assert.deepEqual(
+    await unavailable.handle({ projectId: 'prj_default', runId: 'run_123' }),
+    { statusCode: 503, body: { code: 'run_query_unavailable' } },
+  );
+});