@openchambery/web 2.0.0-beta.1 → 2.0.0-beta.10

package/server/lib/opencode/proxy.test.js

@@ -195,6 +195,175 @@ describe('resolveSessionTurnAdmissionRequest', () => {
   });
 });
 
+describe('registerOpenCodeProxy runtime contract gate (ticket 11)', () => {
+  it('blocks execution paths when runtime contract denies execution', async () => {
+    const app = express();
+    registerOpenCodeProxy(app, {
+      fs: { promises: { realpath: async (v) => v } },
+      os: {},
+      path: {},
+      OPEN_CODE_READY_GRACE_MS: 12_000,
+      LONG_REQUEST_TIMEOUT_MS: 60_000,
+      getRuntime: () => ({
+        openCodePort: 4096,
+        isOpenCodeReady: true,
+        openCodeNotReadySince: 0,
+        isRestartingOpenCode: false,
+        runtimeContract: {
+          executionAllowed: false,
+          phase: 'incompatible',
+          reasons: ['below-min-verified'],
+          serveVersion: '2.0.5',
+          minVerifiedVersion: '2.0.12',
+        },
+      }),
+      getOpenCodeAuthHeaders: () => ({}),
+      buildOpenCodeUrl: (pathname) => `http://opencode.test${pathname}`,
+      ensureOpenCodeApiPrefix: () => {},
+      getUiNotificationClients: () => [],
+    });
+
+    const response = await request(app)
+      .post('/api/session/ses_1/prompt')
+      .send({ parts: [] })
+      .expect(409);
+
+    expect(response.body.errorCode).toBe('RUNTIME_CONTRACT_EXECUTION_BLOCKED');
+    expect(response.body.phase).toBe('incompatible');
+  });
+
+  it('keeps interrupt available when execution is limited', async () => {
+    const upstreamUrls = [];
+    globalThis.fetch = vi.fn(async (url) => {
+      upstreamUrls.push(String(url));
+      return {
+        ok: true,
+        status: 200,
+        headers: new Headers({ 'content-type': 'application/json' }),
+        json: async () => ({}),
+        text: async () => '{}',
+        body: null,
+      };
+    });
+
+    const app = express();
+    registerOpenCodeProxy(app, {
+      fs: { promises: { realpath: async (v) => v } },
+      os: {},
+      path: {},
+      OPEN_CODE_READY_GRACE_MS: 12_000,
+      LONG_REQUEST_TIMEOUT_MS: 60_000,
+      getRuntime: () => ({
+        openCodePort: 4096,
+        isOpenCodeReady: true,
+        openCodeNotReadySince: 0,
+        isRestartingOpenCode: false,
+        runtimeContract: {
+          executionAllowed: false,
+          phase: 'ready-unverified',
+          reasons: ['unverified-newer'],
+          serveVersion: '2.1.0',
+          minVerifiedVersion: '2.0.12',
+        },
+      }),
+      getOpenCodeAuthHeaders: () => ({}),
+      buildOpenCodeUrl: (pathname) => `http://opencode.test${pathname}`,
+      ensureOpenCodeApiPrefix: () => {},
+      getUiNotificationClients: () => [],
+    });
+
+    // Gate must not 409 interrupt; proxy may still forward or fail transport — not contract block.
+    const response = await request(app)
+      .post('/api/session/ses_1/interrupt')
+      .send({});
+    expect(response.status).not.toBe(409);
+    expect(response.body?.errorCode).not.toBe('RUNTIME_CONTRACT_EXECUTION_BLOCKED');
+  });
+
+  it('blocks writes when runtimeContract is null (production default, no bypass)', async () => {
+    const app = express();
+    registerOpenCodeProxy(app, {
+      fs: { promises: { realpath: async (v) => v } },
+      os: {},
+      path: {},
+      OPEN_CODE_READY_GRACE_MS: 12_000,
+      LONG_REQUEST_TIMEOUT_MS: 60_000,
+      getRuntime: () => ({
+        openCodePort: 4096,
+        isOpenCodeReady: true,
+        openCodeNotReadySince: 0,
+        isRestartingOpenCode: false,
+        runtimeContract: null,
+      }),
+      getOpenCodeAuthHeaders: () => ({}),
+      buildOpenCodeUrl: (pathname) => `http://opencode.test${pathname}`,
+      ensureOpenCodeApiPrefix: () => {},
+      getUiNotificationClients: () => [],
+    });
+
+    const response = await request(app)
+      .post('/api/session/ses_1/prompt')
+      .send({ parts: [] })
+      .expect(409);
+    expect(response.body.errorCode).toBe('RUNTIME_CONTRACT_EXECUTION_BLOCKED');
+  });
+
+  it('re-gates after readiness hold when stale permit becomes incompatible', async () => {
+    // Race: early gate sees executionAllowed true (old instance), hold waits for
+    // restart, then new instance publishes incompatible — must 409, not forward.
+    const notReadySince = Date.now();
+    let tick = 0;
+    const app = express();
+    registerOpenCodeProxy(app, {
+      fs: { promises: { realpath: async (v) => v } },
+      os: {},
+      path: {},
+      OPEN_CODE_READY_GRACE_MS: 12_000,
+      LONG_REQUEST_TIMEOUT_MS: 60_000,
+      getRuntime: () => {
+        tick += 1;
+        if (tick <= 2) {
+          return {
+            openCodePort: 4096,
+            isOpenCodeReady: false,
+            openCodeNotReadySince: notReadySince,
+            isRestartingOpenCode: true,
+            runtimeContract: {
+              executionAllowed: true,
+              phase: 'ready',
+              serveVersion: '2.0.12',
+            },
+          };
+        }
+        return {
+          openCodePort: 4096,
+          isOpenCodeReady: true,
+          openCodeNotReadySince: 0,
+          isRestartingOpenCode: false,
+          runtimeContract: {
+            executionAllowed: false,
+            phase: 'incompatible',
+            reasons: ['below-min-verified'],
+            serveVersion: '2.0.5',
+            minVerifiedVersion: '2.0.12',
+          },
+        };
+      },
+      getOpenCodeAuthHeaders: () => ({}),
+      buildOpenCodeUrl: (pathname) => `http://opencode.test${pathname}`,
+      ensureOpenCodeApiPrefix: () => {},
+      getUiNotificationClients: () => [],
+    });
+
+    const response = await request(app)
+      .post('/api/session/ses_1/prompt')
+      .send({ parts: [] })
+      .expect(409);
+    expect(response.body.errorCode).toBe('RUNTIME_CONTRACT_EXECUTION_BLOCKED');
+    expect(response.body.phase).toBe('incompatible');
+  });
+});
+
 describe('registerOpenCodeProxy reasoning projection routes', () => {
   it('strips includeReasoning from SSE upstream and drops reasoning events when false', async () => {
     const upstreamUrls = [];
@@ -291,6 +460,21 @@ describe('registerOpenCodeProxy reasoning projection routes', () => {
     expect(JSON.stringify(res.body)).not.toContain('hidden');
   });
 
+  it.each(['message', 'context'])('filters native v2 %s before outbound transport', async (surface) => {
+    const upstreamUrls = [];
+    globalThis.fetch = vi.fn(async (url) => {
+      upstreamUrls.push(String(url));
+      return new Response(JSON.stringify({ data: [{ id: 'm', type: 'assistant', content: [
+        { type: 'reasoning', text: 'hidden' }, { type: 'text', text: 'visible' },
+      ] }], cursor: { next: 'older' } }), { headers: { 'content-type': 'application/json' } });
+    });
+    const res = await request(mountProxy()).get(`/api/session/ses_1/${surface}?includeReasoning=false`);
+    expect(res.status).toBe(200);
+    expect(res.body.data[0].content).toEqual([{ type: 'text', text: 'visible' }]);
+    expect(res.body.cursor.next).toBe('older');
+    expect(upstreamUrls[0]).not.toContain('includeReasoning');
+  });
+
   it('keeps reasoning parts on session.messages list when includeReasoning is omitted', async () => {
     globalThis.fetch = vi.fn(async () => ({
       ok: true,
@@ -334,7 +518,7 @@ describe('registerOpenCodeProxy session metadata overlay', () => {
     return app;
   };
 
-  it('merges Host store metadata onto session list and detail (store keys win)', async () => {
+  it('merges side-store gaps onto the OpenCode record without letting the side row win conflicts', async () => {
     globalThis.fetch = vi.fn(async (url) => {
       const path = String(url).split('?')[0];
       if (path.endsWith('/api/session') || path.endsWith('/session')) {
@@ -382,7 +566,7 @@ describe('registerOpenCodeProxy session metadata overlay', () => {
       id: 'ses_1',
       metadata: {
         fromOpenCode: true,
-        shared: 'ours',
+        shared: 'theirs',
         openchamber: { goal: { status: 'active' } },
       },
     });
@@ -394,13 +578,13 @@ describe('registerOpenCodeProxy session metadata overlay', () => {
       id: 'ses_1',
       metadata: {
         fromOpenCode: true,
-        shared: 'ours',
+        shared: 'theirs',
         openchamber: { goal: { status: 'active' } },
       },
     });
   });
 
-  it('leaves upstream records untouched when the store throws', async () => {
+  it('returns retryable 503 when the configured store throws (never silent upstream)', async () => {
     vi.spyOn(console, 'warn').mockImplementation(() => {});
     globalThis.fetch = vi.fn(async () => ({
       ok: true,
@@ -415,8 +599,57 @@ describe('registerOpenCodeProxy session metadata overlay', () => {
       throw new Error('store down');
     });
 
+    const list = await request(app).get('/api/session');
+    expect(list.status).toBe(503);
+    expect(list.body).toMatchObject({
+      retryable: true,
+      code: 'session_metadata_unavailable',
+    });
+  });
+
+  it('projects Host archive onto time.archived and preserves list cursor envelopes', async () => {
+    globalThis.fetch = vi.fn(async () => ({
+      ok: true,
+      status: 200,
+      headers: new Headers({ 'content-type': 'application/json' }),
+      text: async () => JSON.stringify({
+        data: [
+          {
+            id: 'ses_1',
+            title: 'Alpha',
+            time: { created: 1, updated: 2, archived: 50 },
+          },
+        ],
+        cursor: 'next-page',
+      }),
+    }));
+
+    const app = mountProxyWithMetadata(async () => ({
+      ses_1: { openchamber: { archive: { archivedAt: 99 } } },
+    }));
+
     const list = await request(app).get('/api/session');
     expect(list.status).toBe(200);
-    expect(list.body[0]).toEqual({ id: 'ses_1', title: 'Alpha', metadata: { fromOpenCode: true } });
+    expect(list.body.cursor).toBe('next-page');
+    expect(list.body.data[0].time.archived).toBe(99);
+    expect(list.body.data[0].metadata.openchamber.archive.archivedAt).toBe(99);
+  });
+
+  it('explicit Host archivedAt 0 clears upstream historical time.archived', async () => {
+    globalThis.fetch = vi.fn(async () => ({
+      ok: true,
+      status: 200,
+      headers: new Headers({ 'content-type': 'application/json' }),
+      text: async () => JSON.stringify([
+        { id: 'ses_1', time: { created: 1, updated: 2, archived: 50 } },
+      ]),
+    }));
+
+    const app = mountProxyWithMetadata(async () => ({
+      ses_1: { openchamber: { archive: { archivedAt: 0 } } },
+    }));
+
+    const list = await request(app).get('/api/session');
+    expect(list.body[0].time.archived).toBeUndefined();
   });
 });