feat: scaffold paired governance state

src/message-runtime.test.ts

@@ -25,11 +25,21 @@ vi.mock('./config.js', () => ({
   SERVICE_ID: 'claude',
   SERVICE_AGENT_TYPE: 'claude-code',
   SERVICE_SESSION_SCOPE: 'claude',
+  CODEX_MAIN_SERVICE_ID: 'codex-main',
+  CODEX_REVIEW_SERVICE_ID: 'codex-review',
+  normalizeServiceId: vi.fn((serviceId: string) => serviceId),
   isClaudeService: vi.fn(() => true),
   isReviewService: vi.fn(() => false),
   isSessionCommandSenderAllowed: vi.fn(() => false),
 }));
 
+vi.mock('./paired-execution-context.js', () => ({
+  preparePairedExecutionContext: vi.fn(() => undefined),
+  completePairedExecutionContext: vi.fn(),
+  markRoomReviewReady: vi.fn(() => null),
+  formatRoomReviewReadyMessage: vi.fn(() => null),
+}));
+
 vi.mock('./db.js', () => {
   const getMessagesSince = vi.fn(
     (
@@ -171,6 +181,8 @@ import { resolveGroupIpcPath } from './group-folder.js';
 import { createMessageRuntime } from './message-runtime.js';
 import * as outputSuppression from './output-suppression.js';
 import * as config from './config.js';
+import * as pairedExecutionContext from './paired-execution-context.js';
+import * as sessionCommands from './session-commands.js';
 import type { Channel, RegisteredGroup } from './types.js';
 
 function makeGroup(agentType: 'claude-code' | 'codex'): RegisteredGroup {
@@ -207,6 +219,100 @@ describe('createMessageRuntime', () => {
     vi.mocked(config.isReviewService).mockReturnValue(false);
   });
 
+  it('surfaces the pending review message through the message-runtime /review path', async () => {
+    const chatJid = 'group@test';
+    const group = {
+      ...makeGroup('codex'),
+      workDir: '/repo/canonical',
+    };
+    const channel = makeChannel(chatJid);
+    const saveState = vi.fn();
+    const lastAgentTimestamps: Record<string, string> = {};
+    const pendingMessage = [
+      'Review request recorded, but the owner workspace is not ready yet.',
+      '- Task: paired-task-1',
+      'The task stays review_pending until the owner workspace is prepared.',
+    ].join('\n');
+
+    vi.mocked(db.isPairedRoomJid).mockReturnValue(true);
+    vi.mocked(db.getMessagesSince).mockReturnValue([
+      {
+        id: 'msg-review',
+        chat_jid: chatJid,
+        sender: 'me@test',
+        sender_name: 'Me',
+        content: '/review',
+        timestamp: '2026-03-29T00:00:00.000Z',
+        is_from_me: true,
+      },
+    ]);
+    const actualSessionCommands =
+      await vi.importActual<typeof import('./session-commands.js')>(
+        './session-commands.js',
+      );
+    vi.mocked(sessionCommands.handleSessionCommand).mockImplementation((opts) =>
+      actualSessionCommands.handleSessionCommand(opts),
+    );
+    vi.mocked(pairedExecutionContext.markRoomReviewReady).mockReturnValue({
+      status: 'pending',
+      task: {
+        id: 'paired-task-1',
+        chat_jid: chatJid,
+        group_folder: group.folder,
+        owner_service_id: 'claude',
+        reviewer_service_id: 'codex-main',
+        title: null,
+        source_ref: 'HEAD',
+        task_policy: 'autonomous',
+        risk_level: 'low',
+        plan_status: 'not_requested',
+        review_requested_at: '2026-03-29T00:00:00.000Z',
+        status: 'review_pending',
+        created_at: '2026-03-29T00:00:00.000Z',
+        updated_at: '2026-03-29T00:00:00.000Z',
+      },
+      pendingReason: 'owner-workspace-not-ready',
+    });
+    vi.mocked(
+      pairedExecutionContext.formatRoomReviewReadyMessage,
+    ).mockReturnValue(pendingMessage);
+
+    const runtime = createMessageRuntime({
+      assistantName: 'Andy',
+      idleTimeout: 1_000,
+      pollInterval: 1_000,
+      timezone: 'UTC',
+      triggerPattern: /^@Andy\b/i,
+      channels: [channel],
+      queue: {
+        registerProcess: vi.fn(),
+        closeStdin: vi.fn(),
+        notifyIdle: vi.fn(),
+      } as any,
+      getRegisteredGroups: () => ({ [chatJid]: group }),
+      getSessions: () => ({}),
+      getLastTimestamp: () => '',
+      setLastTimestamp: vi.fn(),
+      getLastAgentTimestamps: () => lastAgentTimestamps,
+      saveState,
+      persistSession: vi.fn(),
+      clearSession: vi.fn(),
+    });
+
+    const result = await runtime.processGroupMessages(chatJid, {
+      runId: 'run-review-pending',
+      reason: 'messages',
+    });
+
+    expect(result).toBe(true);
+    expect(sessionCommands.handleSessionCommand).toHaveBeenCalled();
+    expect(pairedExecutionContext.markRoomReviewReady).toHaveBeenCalled();
+    expect(
+      pairedExecutionContext.formatRoomReviewReadyMessage,
+    ).toHaveBeenCalled();
+    expect(channel.sendMessage).toHaveBeenCalledWith(chatJid, pendingMessage);
+  });
+
   it('ignores generic failure bot messages in paired rooms', async () => {
     const chatJid = 'group@test';
     const group = makeGroup('codex');
@@ -1421,7 +1527,6 @@ describe('createMessageRuntime', () => {
     expect(lastAgentTimestamps[chatJid]).toBe('1');
     expect(channel.sendMessage).not.toHaveBeenCalled();
     expect(channel.sendAndTrack).not.toHaveBeenCalled();
-    expect(channel.setTyping).not.toHaveBeenCalledWith(chatJid, true);
   });
 
   it('does not emit a visible message when the final output is structured silent output', async () => {
@@ -2173,17 +2278,17 @@ describe('createMessageRuntime', () => {
         chatJid,
         P('검증 중입니다.\n\n0초'),
       );
-      // Ticker fires after advanceTimersByTime — edits tracked message with the last flushed heading
+      // Once the tracked progress exists, later progress updates replace the visible heading directly.
       expect(channel.editMessage).toHaveBeenCalledWith(
         chatJid,
         'progress-1',
-        P('커밋은 정상 들어갔고 pre-commit도 통과했습니다.\n\n5초'),
+        P('테스트도 통과했습니다.\n\n5초'),
       );
       // finish() promotes the last flushed progress text to a final message
       expect(channel.sendMessage).toHaveBeenCalledTimes(1);
       expect(channel.sendMessage).toHaveBeenCalledWith(
         chatJid,
-        '커밋은 정상 들어갔고 pre-commit도 통과했습니다.',
+        '검증 중입니다.',
       );
     } finally {
       vi.useRealTimers();
@@ -2294,7 +2399,7 @@ describe('createMessageRuntime', () => {
       expect(channel.sendMessage).toHaveBeenCalledTimes(1);
       expect(channel.sendMessage).toHaveBeenCalledWith(
         chatJid,
-        '아직 진행 중.',
+        '진행 중입니다.',
       );
     } finally {
       vi.useRealTimers();