Fixture Replay

replayAgentUiFixture 用 contracts fixtures 验证 projection 是否符合标准。

实现锚点：packages/agent-runtime-projection/src/fixtureReplay.ts。

API

export function replayAgentUiFixture<TEvent extends AgentRuntimeExecutionEvent>(
  fixture: AgentUiFixture<TEvent>
): AgentUiFixtureReplayResult<TEvent>;

export interface AgentUiFixtureReplayResult<TEvent = AgentRuntimeExecutionEvent> {
  fixtureId: string;
  state: AgentUiProjectionState<TEvent>;
  validationIssues: AgentUiContractValidationIssue[];
  diagnostics: string[];
  passed: boolean;
}

Example

import { getAgentUiFixture } from "@limecloud/agent-ui-contracts";
import { replayAgentUiFixture } from "@limecloud/agent-runtime-projection";

const result = replayAgentUiFixture(getAgentUiFixture("hitl-action"));

if (!result.passed) {
  console.error(result.diagnostics);
}

Checks

Replay 当前检查：

Check	Description
validation issues	复用 contracts validation。
message count	expected.messagePartCount 下限。
timeline count	expected.timelineEntryCount 下限。
graph count	expected.graphNodeCount 下限。
pending action count	expected.pendingActionCount 精确值。
artifact / evidence count	refs 下限。
team workbench counts	expected.teamWorkbench 中 roster、work item、handoff、review、lane count。
expected diagnostics	允许特定 repair / failure diagnostics。

teamWorkbench 是必填 projection state 字段。Replay 对没有 team facts 的 fixture 也应确认它存在，并且 hasTeamSurface 与空数组一致。

Required Fixtures

每次修改 projection 逻辑，至少跑内置 fixtures：

for (const fixture of agentUiConformanceFixtures) {
  expect(replayAgentUiFixture(fixture).passed).toBe(true);
}

Boundary

• Fixture replay 不是 production transport。
• Replay 不调用 App Server。
• Replay 不渲染 React。
• Replay 不替代 GUI smoke；它证明 projection reducer 对标准 facts 的理解。