Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

11.9 KB
Raw Blame
/**
 * remoteSessionSyncInvariants.test.ts —— device-link 健壮化关键接线的源不变式。
 * 锁住:重 topic 随 WS 重连重建 + 多触发源对账 + banner 接线,防回退成"订一次就不管"。
 */
import { readFileSync } from 'node:fs';
import { resolve } from 'node:path';

import { describe, expect, it } from 'vitest';

const syncSrc = readFileSync(
  resolve(__dirname, '..', 'features', 'cc-agent', 'hooks', 'useRemoteSessionSync.ts'),
  'utf8',
);
const sessionViewSrc = readFileSync(
  resolve(__dirname, '..', 'features', 'cc-agent', 'CCAgentSessionView.tsx'),
  'utf8',
);
const sessionHeaderSrc = readFileSync(
  resolve(__dirname, '..', 'features', 'cc-agent', 'SessionContentHeader.tsx'),
  'utf8',
);
const sidebarUpperSrc = readFileSync(
  resolve(__dirname, '..', 'features', 'cc-agent', 'CCAgentSidebarUpper.tsx'),
  'utf8',
);
const sessionItemSrc = readFileSync(
  resolve(__dirname, '..', 'features', 'cc-agent', 'sidebar', 'SessionItem.tsx'),
  'utf8',
);
const sessionCardSrc = readFileSync(
  resolve(__dirname, '..', 'features', 'cc-agent', 'sidebar', 'SessionCard.tsx'),
  'utf8',
);
const projectNodeSrc = readFileSync(
  resolve(__dirname, '..', 'features', 'cc-agent', 'sidebar', 'sections', 'ProjectNode.tsx'),
  'utf8',
);
const makerChatStoreSrc = readFileSync(
  resolve(__dirname, '..', 'lib', 'makerChatStore.ts'),
  'utf8',
);
const sessionInterruptBannerModelSrc = readFileSync(
  resolve(__dirname, '..', 'features', 'cc-agent', 'sessionInterruptBannerModel.ts'),
  'utf8',
);
const makerTransportSrc = readFileSync(
  resolve(__dirname, '..', 'lib', 'makerTransport.ts'),
  'utf8',
);
const chatInputSrc = readFileSync(
  resolve(__dirname, '..', 'components', 'new-chat', 'ChatInput.tsx'),
  'utf8',
);

describe('useRemoteSessionSync 接线不变式', () => {
  it('WS 重连(onStatusChanged online)重建重 topic 订阅 + 对账', () => {
    expect(syncSrc).toContain('onStatusChanged');
    expect(syncSrc).toContain("p.status !== 'online'");
    expect(syncSrc).toContain('subscribeHeavy()');
    expect(syncSrc).toContain('reconcileRemoteMessages');
  });
  it('多触发源:presence 回在线 / turn 结束(isRunning) / 窗口聚焦 / 手动 resync', () => {
    expect(syncSrc).toContain('onPresenceChanged');
    expect(syncSrc).toContain('agentStatus.isRunning');
    expect(syncSrc).toContain("addEventListener('focus'");
    expect(syncSrc).toContain('refreshRemoteDeviceSessions');
  });
  it('编排逻辑抽进注入式纯核 createRemoteSessionSyncEngine,hook 仅作 adapter', () => {
    expect(syncSrc).toContain('export function createRemoteSessionSyncEngine');
    expect(syncSrc).toContain('createRemoteSessionSyncEngine(');
    expect(syncSrc).toContain('engine.subscribeHeavy()');
    expect(syncSrc).toContain('engine.primeRunning(');
    expect(syncSrc).toContain('engine.dispose()');
  });
});

describe('CCAgentSessionView 接线不变式', () => {
  it('用 useRemoteSessionSync(替代 mount-once 重 topic effect)+ 渲染连接 banner', () => {
    expect(sessionViewSrc).toContain('useRemoteSessionSync(sessionId, remoteDeviceId)');
    expect(sessionViewSrc).toContain('useRemoteSessionConnection(remoteDeviceId)');
    expect(sessionViewSrc).toContain('<RemoteSessionBanner');
    // 旧的 mount-once 重 topic effect 已被 hook 取代(不再就地订阅 session: topic)。
    expect(sessionViewSrc).not.toContain('const topic = `session:${sessionId}`');
  });
  it('断线缓存的远程 session 可打开查看并继续乐观发送', () => {
    expect(sessionViewSrc).toContain(
      "const remoteSessionUnavailable = remoteConn === 'reconnecting' || remoteConn === 'host-offline'",
    );
    expect(sessionViewSrc).not.toContain('if (remoteSessionUnavailable) return false');
    expect(sessionViewSrc).not.toContain('remoteSessionUnavailableRef');
    expect(sessionViewSrc).toContain('if (!remoteDeviceId && !recoveringBaseline) {');
    expect(sessionViewSrc).not.toContain('beforeEnqueue: checkVendorReady');
    // device-link 远程交接期间仍要禁用(见 remoteHandoffPreparing):那几段 await
    // 可能数十秒,不禁用的话用户补发的消息会插到草稿提交的首条之前。
    expect(sessionViewSrc).toContain(
      "disabled={readOnly || remoteHandoffPreparing || session?.source === 'review'}",
    );
  });
  it('补选目录后的续发保持 delivery mode,并按本地/远端策略清理原 composer', () => {
    expect(sessionViewSrc).toContain('deliveryMode: MessageDeliveryMode;');
    expect(sessionViewSrc).toContain(
      "const dispatch = pending.deliveryMode === 'steer' ? steerMessage : sendMessage;",
    );
    expect(sessionViewSrc).toContain('if (accepted) {');
    expect(sessionViewSrc).toContain('pending.onDeferredAccepted?.();');
    expect(sessionViewSrc).toContain('dispatchDeferredUiAssignment(sessionId, undefined).catch');
    expect(sessionViewSrc).toContain(
      '...(opts?.onDeferredAccepted ? { onDeferredAccepted: opts.onDeferredAccepted } : {})',
    );
    expect(chatInputSrc).toContain('onDeferredAccepted,');
    expect(chatInputSrc).toMatch(
      /if \(optimisticallyClearRemoteComposer\) \{\s*\/\/[^\n]*\n(?:\s*\/\/[^\n]*\n){2}\s*optimisticComposerRestored = false;\s*clearSentComposer\(\{ preserveNewerContent: true \}\);\s*\} else \{[\s\S]*?clearSentComposer\(\{ preserveNewerContent: true \}\);\s*\}/,
    );
  });
  it('已有设备互联任务与保留原路由的 SSH 任务跳过来源门禁,草稿与本地任务仍保留门禁', () => {
    expect(chatInputSrc).toContain(
      'const enforceConnectedSourceGate = (!sessionId || !catalogDeviceId) && !preserveSshCodexRoute;',
    );
    expect(chatInputSrc).toContain('const preserveSshCodexRoute = !!sessionId && !!sshCodexHostId &&');
    expect(chatInputSrc).toMatch(
      /const noConnectedSource =\s*enforceConnectedSourceGate &&\s*!!currentModelAgentKind/,
    );
    expect(chatInputSrc).toMatch(
      /if\s*\(\s*enforceConnectedSourceGate\s*&&\s*!canAttemptBaselineRecovery\s*&&\s*currentModelAgentKind\s*&&[\s\S]*?\)\s*\{/,
    );
  });
  it('断线缓存的远程 session 可查看,但生命周期/元数据写操作必须走统一 gate', () => {
    expect(sessionHeaderSrc).toContain(
      'remoteSessionUnavailable || isRemoteSessionWriteBlocked(session)',
    );
    expect(sidebarUpperSrc).toContain('isRemoteSessionWriteBlocked(session)');
    expect(sidebarUpperSrc).toContain('selectedSessions.some(isRemoteSessionWriteBlocked)');
    expect(sessionItemSrc).toContain(
      "const remoteWritesBlocked = isSharedTaskPeer(session.deviceLinkDeviceId ?? '') || isRemoteSessionWriteBlocked(session)",
    );
    expect(sessionCardSrc).toContain(
      'const remoteWritesBlocked = isRemoteSessionWriteBlocked(session)',
    );
    expect(sessionViewSrc).toContain('remoteSessionUnavailable={remoteSessionUnavailable}');
  });
  it('断线 device-link session 不能触发 Stop 或新窗口写入口', () => {
    expect(sessionViewSrc).toContain('const handleStopSession = useCallback');
    expect(sessionViewSrc).toContain('if (remoteSessionUnavailable)');
    expect(sessionViewSrc).toContain('onStop={handleStopSession}');
    for (const source of [sessionHeaderSrc, sessionItemSrc, sessionCardSrc]) {
      expect(source).toMatch(/<SessionTaskMenu[\s\S]*?writeBlocked=\{remoteWritesBlocked\}/);
      expect(source).toMatch(/onOpenInNewWindow=\{handleOpenInNewWindow(?:Select)?\}/);
    }
    const menuSource = readFileSync(
      resolve(__dirname, '..', 'features', 'cc-agent', 'sidebar', 'SessionTaskMenu.tsx'),
      'utf8',
    );
    expect(menuSource).toContain('const ownerActionsBlocked = writeBlocked || guest');
    expect(menuSource).toContain("item('openInNewWindow', onOpenInNewWindow, ownerActionsBlocked)");
    expect(menuSource).toContain('disabled={disabled}');
  });
  it('live / 历史错误横幅都携带 SSH、device-link 与远程 Agent 执行端归属', () => {
    expect(sessionViewSrc).toMatch(
      /<ErrorTailErrorBanner[\s\S]*?remoteHostId=\{session\?\.remoteHostId \?\? undefined\}[\s\S]*?deviceLinkDeviceId=\{remoteDeviceId\}[\s\S]*?agentDeviceId=\{session\?\.agentDeviceId\}/,
    );
    expect(sessionViewSrc).toMatch(
      /<ErrorBanner[\s\S]*?remoteHostId=\{session\?\.remoteHostId \?\? undefined\}[\s\S]*?deviceLinkDeviceId=\{remoteDeviceId\}[\s\S]*?agentDeviceId=\{session\?\.agentDeviceId\}/,
    );
  });
  it('远程活动镜像在 turn 执行或等待交互时压过中断时间戳启发式', () => {
    expect(sessionViewSrc).toContain('useRemoteSessionActivity(sessionId');
    expect(sessionViewSrc).toContain('agentStatus.isRunning || remoteTurnActive');
    // 决策模型接入了视图;ack / remote 反驳信号在模型内保持原有优先级。
    expect(sessionViewSrc).toContain('resolveSessionInterruptCandidate({');
    expect(sessionInterruptBannerModelSrc).toContain(
      'if (input.acked || input.remoteTurnActive) return false;',
    );
  });
  it('双时间戳中断候选必须等 main 真值确认,未确认不当作中断证据(#4513)', () => {
    // 视图侧:候选出现(activeTurnStartedAt 变化)时向 main 回填一次权威运行态,
    // main 说在飞则与 isRunning/remoteTurnActive 同样锁存 ack。
    // 行为由 useSessionTurnActiveTruth.test.tsx 覆盖;这里只锁视图接线。
    expect(sessionViewSrc).toContain('useSessionTurnActiveTruth({');
    // 远程会话的真值问被控端:控制端本机 main 没有这个 turn,永远答 false。
    expect(sessionViewSrc).toContain(
      'const turnActiveDeviceId = remoteDeviceId ?? session?.deviceLinkDeviceId ?? null;',
    );
    // 链路恢复在线时重查:离线期间查询失败落 null,不重查会永久压住真中断横幅。
    expect(sessionViewSrc).toContain("online: remoteConn === 'local' || remoteConn === 'connected',");
    // 真值绑定所属会话:路由复用切会话时旧 true 不得锁存新会话的 ack(P1)。
    expect(sessionViewSrc).toContain('mainTurnActiveForSession');
    expect(sessionViewSrc).toContain(
      'if (agentStatus.isRunning || remoteTurnActive || mainTurnActiveForSession === true) setSessionInterruptAcked(true);',
    );
    // 决策侧:null=未确认(查询在途/失败/不适用),不得把候选当中断证据;
    // 只有 main 明确回答「不在 turn 中」才允许双时间戳候选渲染。
    expect(sessionInterruptBannerModelSrc).toContain('if (input.mainTurnActive !== false) return false;');
  });
  it('断线 device-link project 不能从项目标题 + 入口创建远程 draft', () => {
    expect(projectNodeSrc).toContain(
      'const projectWritesBlocked = isDeviceLinkWriteBlocked(project)',
    );
    expect(projectNodeSrc).toContain('disabled={projectWritesBlocked}');
    expect(projectNodeSrc).toContain('handleCreateInProject');
    expect(projectNodeSrc).toContain('handleArchiveAll');
    expect(sidebarUpperSrc).toContain('isDeviceLinkWriteBlocked(project)');
  });
});

describe('弱网 optimistic mutation 粘滞路由不变式', () => {
  it('发送相关的控制操作在 mirror clear 后仍使用 pinned device', () => {
    expect(makerChatStoreSrc).toContain(
      'const remoteDeviceId = getStickySessionDeviceId(sessionId);',
    );
    expect(makerChatStoreSrc).toContain(
      'const steerApi = remoteDeviceId ? makerApiForDevice(remoteDeviceId) : makerApiFor(sessionId);',
    );
    expect(makerChatStoreSrc).toContain(
      'const operation = beginInputProjectionOperation(sessionId, remoteDeviceId);',
    );
    expect(makerChatStoreSrc).toContain(
      'const triggerApi = remoteDeviceId ? makerApiForDevice(remoteDeviceId) : makerApiFor(sessionId);',
    );
    expect(makerChatStoreSrc).toMatch(/clearOperation\.api\s*\.closeSession/);
    expect(makerChatStoreSrc).toContain(
      'const remoteDeviceId = sourceRemoteDeviceId ?? getStickySessionDeviceId(sessionId);',
    );
  });

  it('自动标题和会话元数据读取使用 sticky 远端判定', () => {
    expect(makerChatStoreSrc).toContain('if (getStickySessionDeviceId(sessionId)) {');
    expect(makerTransportSrc).toContain(
      '// Session metadata is part of the same remote send attempt as the later',
    );
  });
});