sdd-agent-platform 0.4.2 → 0.5.1

package/node_modules/@sdd-agent-platform/core/src/run-state/task-evidence.ts

@@ -1,252 +1,198 @@
-import { branchToSafePartition } from '../path-safety.js';
-import { isBranchStageEvidenceRef, toBranchStageEvidenceRef } from '../runtime-paths.js';
-import { listRuntimeAcceptanceEvidenceMaps, listRuntimeAgentExecutions, listRuntimeArtifactPayloads, listRuntimeDurableGaps, listRuntimeFanInEvidenceSets, listRuntimeLlmAdvisorAssessments, listRuntimeStageRoleResults, listRuntimeStageTeamSessions, listRuntimeTeamSessions, listRuntimeTestRuns, listRuntimeValidationEnvironmentSessions, listRuntimeValidationWaveRuns, listRuntimeWorkflowGateDecisions, listRuntimeWorkerRuntimes } from '../storage/runtime-store.js';
-import type { RuntimeAcceptanceEvidenceMapRecord, RuntimeArtifactPayloadRecord, RuntimeDurableGapRecord, RuntimeTestRunRecord, RuntimeValidationEnvironmentSessionRecord, RuntimeValidationWaveRunRecord } from '../storage/runtime-store.js';
-import type { SddStage } from '../contracts.js';
-import type { AgentExecutionRecord, TeamSessionRecord } from '../router/agent-runtime.js';
-import type { ResidentWorkerRuntimeRecord } from '../execution/resident-worker.js';
-import type { FanInEvidenceSetRecord, LlmAdvisorAssessmentRecord, StageRoleResultRecord, StageTeamSessionRecord } from '../execution/stage-team-runtime.js';
-import type { WorkflowGateDecision } from '../workflow-gate/types.js';
-import type { RunState } from './model.js';
-import { resolveWorkflowState } from '../workflow-state/resolve.js';
-import type { LatestEligibleRunCandidate, LatestEligibleRunSelection } from '../workflow-state/latest-eligible-run.js';
-import type { SddTaskGap } from '../sdd-docs/task-parser.js';
-
-export const TASK_EVIDENCE_VIEW_CONTRACT_VERSION = 'phase-8.12-task-evidence-view-v1';
-
-export interface TaskEvidencePayloadGroups {
-  active: RuntimeArtifactPayloadRecord[];
-  candidate: RuntimeArtifactPayloadRecord[];
-  partial: RuntimeArtifactPayloadRecord[];
-  active_attempt: RuntimeArtifactPayloadRecord[];
-  rejected: RuntimeArtifactPayloadRecord[];
-  superseded: RuntimeArtifactPayloadRecord[];
-  quarantined: RuntimeArtifactPayloadRecord[];
-  stale: RuntimeArtifactPayloadRecord[];
-  all: RuntimeArtifactPayloadRecord[];
-}
-
-export interface TaskEvidenceRuntimeActivity {
-  agentExecutions: AgentExecutionRecord[];
-  teamSessions: TeamSessionRecord[];
-  workerRuntimes: ResidentWorkerRuntimeRecord[];
-}
-
-export interface TaskEvidenceValidationView {
-  runValidation: RunState['validation'] | null;
-  testRuns: RuntimeTestRunRecord[];
-  validationWaves: RuntimeValidationWaveRunRecord[];
-  environmentSessions: RuntimeValidationEnvironmentSessionRecord[];
-  acceptanceEvidenceMaps: RuntimeAcceptanceEvidenceMapRecord[];
-}
-
-export interface TaskEvidenceStageTeamView {
-  sessions: StageTeamSessionRecord[];
-  roleResults: StageRoleResultRecord[];
-  advisorAssessments: LlmAdvisorAssessmentRecord[];
-  fanInEvidenceSets: FanInEvidenceSetRecord[];
-}
-
-export interface TaskEvidenceWorkflowGateView {
-  latestDecision: WorkflowGateDecision | null;
-  decisions: WorkflowGateDecision[];
-}
-
-export interface TaskEvidenceView {
-  contract: typeof TASK_EVIDENCE_VIEW_CONTRACT_VERSION;
-  generatedAt: string;
-  retrievalMemoryOnly: false;
-  source: 'runtime.sqlite+branch-evidence-payloads';
-  branch: string;
-  taskId: string;
-  latestEligibleRun: LatestEligibleRunCandidate | null;
-  candidates: LatestEligibleRunCandidate[];
-  rejected: LatestEligibleRunCandidate[];
-  compatibility: LatestEligibleRunCandidate['compatibility'] | null;
-  payloads: TaskEvidencePayloadGroups;
-  validation: TaskEvidenceValidationView;
-  runtimeActivity: TaskEvidenceRuntimeActivity;
-  gaps: SddTaskGap[];
-  durableGaps: RuntimeDurableGapRecord[];
-  stageTeam: TaskEvidenceStageTeamView;
-  workflowGate: TaskEvidenceWorkflowGateView;
-}
-
-export async function readTaskEvidenceView(projectRoot: string, input: { branch?: string | null; taskId: string }): Promise<TaskEvidenceView> {
-  const workflow = await resolveWorkflowState(projectRoot, { branch: input.branch, branchSource: input.branch ? 'cli_option' : undefined, taskId: input.taskId });
-  const selection = workflow.latestEligibleRunsByTask.find((entry) => entry.taskId === input.taskId) ?? emptySelection(workflow.branch, input.taskId);
-  const selectedRunState = selection.selected?.runId === workflow.latestRunState?.runId ? workflow.latestRunState : null;
-  const runIds = uniqueRunIds(selection);
-  const payloads = await readTaskPayloads(projectRoot, workflow.branch, input.taskId, runIds);
-  const [testRuns, validationWaveEvidence, runtimeActivity, durableGaps, stageTeam, workflowGate] = selection.selected
-    ? await Promise.all([
-      listRuntimeTestRuns(projectRoot, selection.selected.runId),
-      readValidationWaveEvidence(projectRoot, workflow.branch, input.taskId, selection.selected.runId),
-      readRuntimeActivity(projectRoot, selection.selected.runId),
-      listRuntimeDurableGaps(projectRoot, { partition: workflow.branch, taskId: input.taskId, status: 'open_terminal' }),
-      readStageTeamEvidence(projectRoot, workflow.branch, input.taskId, selection.selected.runId),
-      readWorkflowGateEvidence(projectRoot, workflow.branch, input.taskId, selection.selected.runId)
-    ])
-    : await Promise.all([
-      Promise.resolve([]),
-      readValidationWaveEvidence(projectRoot, workflow.branch, input.taskId, null),
-      Promise.resolve(emptyRuntimeActivity()),
-      listRuntimeDurableGaps(projectRoot, { partition: workflow.branch, taskId: input.taskId, status: 'open_terminal' }),
-      readStageTeamEvidence(projectRoot, workflow.branch, input.taskId, null),
-      readWorkflowGateEvidence(projectRoot, workflow.branch, input.taskId, null)
-    ]);
-
-  const [validationWaves, environmentSessions, acceptanceEvidenceMaps] = validationWaveEvidence;
-  return {
-    contract: TASK_EVIDENCE_VIEW_CONTRACT_VERSION,
-    generatedAt: new Date().toISOString(),
-    retrievalMemoryOnly: false,
-    source: 'runtime.sqlite+branch-evidence-payloads',
-    branch: workflow.branch,
-    taskId: input.taskId,
-    latestEligibleRun: selection.selected,
-    candidates: selection.candidates,
-    rejected: selection.rejected,
-    compatibility: selection.selected?.compatibility ?? null,
-    payloads,
-    validation: {
-      runValidation: selectedRunState?.validation ?? null,
-      testRuns: testRuns.filter((run) => run.taskId === input.taskId),
-      validationWaves,
-      environmentSessions,
-      acceptanceEvidenceMaps
-    },
-    runtimeActivity,
-    gaps: [...workflow.visibleGaps.filter((gap) => gap.taskId === input.taskId || gap.taskId === null), ...runtimeTaskGaps(selectedRunState?.tasks[input.taskId])],
-    durableGaps,
-    stageTeam,
-    workflowGate
-  };
-}
-
-function emptySelection(partition: string, taskId: string): LatestEligibleRunSelection {
-  return { partition, taskId, selected: null, candidates: [], rejected: [] };
-}
-
-function uniqueRunIds(selection: LatestEligibleRunSelection): string[] {
-  return Array.from(new Set([...selection.candidates, ...selection.rejected].map((candidate) => candidate.runId)));
-}
-
-async function readTaskPayloads(projectRoot: string, branch: string, taskId: string, runIds: string[]): Promise<TaskEvidencePayloadGroups> {
-  const payloads = runIds.length > 0
-    ? (await Promise.all(runIds.map((runId) => listRuntimeArtifactPayloads(projectRoot, { runId, taskId })))).flat()
-    : await listRuntimeArtifactPayloads(projectRoot, { branchSlug: branchToSafePartition(branch), taskId });
-  const normalizedPayloads = payloads.map((payload) => normalizeTaskEvidencePayload(branch, payload));
-  return {
-    active: normalizedPayloads.filter((payload) => payload.status === 'active'),
-    candidate: normalizedPayloads.filter((payload) => payload.status === 'candidate'),
-    partial: normalizedPayloads.filter((payload) => payload.status === 'partial'),
-    active_attempt: normalizedPayloads.filter((payload) => payload.status === 'active_attempt'),
-    rejected: normalizedPayloads.filter((payload) => payload.status === 'rejected'),
-    superseded: normalizedPayloads.filter((payload) => payload.status === 'superseded'),
-    quarantined: normalizedPayloads.filter((payload) => payload.status === 'quarantined'),
-    stale: normalizedPayloads.filter((payload) => payload.status === 'stale'),
-    all: normalizedPayloads
-  };
-}
-
-function normalizeTaskEvidencePayload(branch: string, payload: RuntimeArtifactPayloadRecord): RuntimeArtifactPayloadRecord {
-  const fileName = payload.logicalRef.replace(/\\/g, '/').split('/').filter(Boolean).pop();
-  if (!fileName) {
-    return payload;
-  }
-  const logicalRef = isBranchStageEvidenceRef(payload.logicalRef)
-    ? payload.logicalRef
-    : toBranchStageEvidenceRef(branch, stageForPayload(payload, fileName), fileName);
-  const physicalPayloadPath = payload.physicalPayloadPath.replace(/\\/g, '/').replace(/^artifacts\//, '');
-  return {
-    ...payload,
-    logicalRef,
-    physicalPayloadPath,
-    payload: normalizeTaskEvidencePayloadMetadata(payload.payload, logicalRef, physicalPayloadPath)
-  };
-}
-
-function normalizeTaskEvidencePayloadMetadata(value: unknown, logicalRef: string, physicalPayloadPath: string): unknown {
-  if (!value || typeof value !== 'object' || Array.isArray(value)) {
-    return value;
-  }
-  return {
-    ...value,
-    logicalRef,
-    artifactPath: logicalRef,
-    physicalPayloadPath
-  };
-}
-
-function stageForPayload(payload: RuntimeArtifactPayloadRecord, fileName: string): SddStage {
-  const role = payload.artifactRole.toLowerCase();
-  if (role.includes('goal') || fileName.startsWith('acceptance-coverage-')) {
-    return 'goal-verify';
-  }
-  if (role.includes('validation') || fileName.startsWith('validation-') || fileName.startsWith('test-validation-')) {
-    return 'test';
-  }
-  if (role.includes('ship') || fileName.startsWith('ship-') || fileName.startsWith('release-')) {
-    return 'ship';
-  }
-  return 'do';
-}
-
-async function readValidationWaveEvidence(projectRoot: string, partition: string, taskId: string, runId: string | null): Promise<[RuntimeValidationWaveRunRecord[], RuntimeValidationEnvironmentSessionRecord[], RuntimeAcceptanceEvidenceMapRecord[]]> {
-  const query = runId ? { partition, runId, taskId } : { partition, taskId };
-  const validationWaves = await listRuntimeValidationWaveRuns(projectRoot, query);
-  const waveRunIds = validationWaves.map((wave) => wave.waveRunId);
-  const [environmentSessions, acceptanceEvidenceMaps] = await Promise.all([
-    Promise.all(waveRunIds.map((waveRunId) => listRuntimeValidationEnvironmentSessions(projectRoot, { partition, waveRunId }))).then((items) => items.flat()),
-    Promise.all(waveRunIds.map((waveRunId) => listRuntimeAcceptanceEvidenceMaps(projectRoot, { partition, taskId, waveRunId }))).then((items) => items.flat())
-  ]);
-  return [validationWaves, environmentSessions, acceptanceEvidenceMaps];
-}
-
-
-async function readRuntimeActivity(projectRoot: string, runId: string): Promise<TaskEvidenceRuntimeActivity> {
-  const [agentExecutions, teamSessions, workerRuntimes] = await Promise.all([
-    listRuntimeAgentExecutions(projectRoot, runId),
-    listRuntimeTeamSessions(projectRoot, runId),
-    listRuntimeWorkerRuntimes(projectRoot, runId)
-  ]);
-  return { agentExecutions, teamSessions, workerRuntimes };
-}
-
-async function readStageTeamEvidence(projectRoot: string, partition: string, taskId: string, runId: string | null): Promise<TaskEvidenceStageTeamView> {
-  const query = runId ? { partition, taskId, runId } : { partition, taskId };
-  const [sessions, roleResults, advisorAssessments, fanInEvidenceSets] = await Promise.all([
-    listRuntimeStageTeamSessions(projectRoot, query),
-    listRuntimeStageRoleResults(projectRoot, query),
-    listRuntimeLlmAdvisorAssessments(projectRoot, query),
-    listRuntimeFanInEvidenceSets(projectRoot, query)
-  ]);
-  return { sessions, roleResults, advisorAssessments, fanInEvidenceSets };
-}
-
-async function readWorkflowGateEvidence(projectRoot: string, partition: string, taskId: string, runId: string | null): Promise<TaskEvidenceWorkflowGateView> {
-  const query = runId ? { partition, taskId, runId } : { partition, taskId };
-  const decisions = await listRuntimeWorkflowGateDecisions(projectRoot, query);
-  return { latestDecision: decisions[0] ?? null, decisions };
-}
-
-function emptyRuntimeActivity(): TaskEvidenceRuntimeActivity {
-  return { agentExecutions: [], teamSessions: [], workerRuntimes: [] };
-}
-
-function runtimeTaskGaps(taskState: unknown): SddTaskGap[] {
-  if (!taskState || typeof taskState !== 'object' || !('gaps' in taskState)) {
-    return [];
-  }
-  const gaps = (taskState as { gaps?: unknown }).gaps;
-  return Array.isArray(gaps) ? gaps.filter(isTaskGap) : [];
-}
-
-function isTaskGap(value: unknown): value is SddTaskGap {
-  if (!value || typeof value !== 'object') {
-    return false;
-  }
-  const gap = value as Partial<SddTaskGap>;
-  return typeof gap.type === 'string' && typeof gap.severity === 'string' && typeof gap.field === 'string' && typeof gap.message === 'string' && typeof gap.recommendation === 'string';
-}
+import { branchToSafePartition } from '../path-safety.js';
+import { listRuntimeAcceptanceEvidenceMaps, listRuntimeAgentExecutions, listRuntimeArtifactPayloads, listRuntimeDurableGaps, listRuntimeFanInEvidenceSets, listRuntimeLlmAdvisorAssessments, listRuntimeStageRoleResults, listRuntimeStageTeamSessions, listRuntimeTeamSessions, listRuntimeTestRuns, listRuntimeValidationEnvironmentSessions, listRuntimeValidationWaveRuns, listRuntimeWorkflowGateDecisions, listRuntimeWorkerRuntimes } from '../storage/runtime-store.js';
+import type { RuntimeAcceptanceEvidenceMapRecord, RuntimeArtifactPayloadRecord, RuntimeDurableGapRecord, RuntimeTestRunRecord, RuntimeValidationEnvironmentSessionRecord, RuntimeValidationWaveRunRecord } from '../storage/runtime-store.js';
+import type { AgentExecutionRecord, TeamSessionRecord } from '../router/agent-runtime.js';
+import type { ResidentWorkerRuntimeRecord } from '../execution/resident-worker.js';
+import type { FanInEvidenceSetRecord, LlmAdvisorAssessmentRecord, StageRoleResultRecord, StageTeamSessionRecord } from '../execution/stage-team-runtime.js';
+import type { WorkflowGateDecision } from '../workflow-gate/types.js';
+import type { RunState } from './model.js';
+import { resolveWorkflowState } from '../workflow-state/resolve.js';
+import type { LatestEligibleRunCandidate, LatestEligibleRunSelection } from '../workflow-state/latest-eligible-run.js';
+import type { SddTaskGap } from '../sdd-docs/task-parser.js';
+
+export const TASK_EVIDENCE_VIEW_CONTRACT_VERSION = 'phase-8.12-task-evidence-view-v1';
+
+export interface TaskEvidencePayloadGroups {
+  active: RuntimeArtifactPayloadRecord[];
+  candidate: RuntimeArtifactPayloadRecord[];
+  rejected: RuntimeArtifactPayloadRecord[];
+  superseded: RuntimeArtifactPayloadRecord[];
+  all: RuntimeArtifactPayloadRecord[];
+}
+
+export interface TaskEvidenceRuntimeActivity {
+  agentExecutions: AgentExecutionRecord[];
+  teamSessions: TeamSessionRecord[];
+  workerRuntimes: ResidentWorkerRuntimeRecord[];
+}
+
+export interface TaskEvidenceValidationView {
+  runValidation: RunState['validation'] | null;
+  testRuns: RuntimeTestRunRecord[];
+  validationWaves: RuntimeValidationWaveRunRecord[];
+  environmentSessions: RuntimeValidationEnvironmentSessionRecord[];
+  acceptanceEvidenceMaps: RuntimeAcceptanceEvidenceMapRecord[];
+}
+
+export interface TaskEvidenceStageTeamView {
+  sessions: StageTeamSessionRecord[];
+  roleResults: StageRoleResultRecord[];
+  advisorAssessments: LlmAdvisorAssessmentRecord[];
+  fanInEvidenceSets: FanInEvidenceSetRecord[];
+}
+
+export interface TaskEvidenceWorkflowGateView {
+  latestDecision: WorkflowGateDecision | null;
+  decisions: WorkflowGateDecision[];
+}
+
+export interface TaskEvidenceView {
+  contract: typeof TASK_EVIDENCE_VIEW_CONTRACT_VERSION;
+  generatedAt: string;
+  retrievalMemoryOnly: false;
+  source: 'runtime.sqlite+branch-evidence-payloads';
+  branch: string;
+  taskId: string;
+  latestEligibleRun: LatestEligibleRunCandidate | null;
+  candidates: LatestEligibleRunCandidate[];
+  rejected: LatestEligibleRunCandidate[];
+  compatibility: LatestEligibleRunCandidate['compatibility'] | null;
+  payloads: TaskEvidencePayloadGroups;
+  validation: TaskEvidenceValidationView;
+  runtimeActivity: TaskEvidenceRuntimeActivity;
+  gaps: SddTaskGap[];
+  durableGaps: RuntimeDurableGapRecord[];
+  stageTeam: TaskEvidenceStageTeamView;
+  workflowGate: TaskEvidenceWorkflowGateView;
+}
+
+export async function readTaskEvidenceView(projectRoot: string, input: { branch?: string | null; taskId: string }): Promise<TaskEvidenceView> {
+  const workflow = await resolveWorkflowState(projectRoot, { branch: input.branch, branchSource: input.branch ? 'cli_option' : undefined, taskId: input.taskId });
+  const selection = workflow.latestEligibleRunsByTask.find((entry) => entry.taskId === input.taskId) ?? emptySelection(workflow.branch, input.taskId);
+  const selectedRunState = selection.selected?.runId === workflow.latestRunState?.runId ? workflow.latestRunState : null;
+  const runIds = uniqueRunIds(selection);
+  const payloads = await readTaskPayloads(projectRoot, workflow.branch, input.taskId, runIds);
+  const [testRuns, validationWaveEvidence, runtimeActivity, durableGaps, stageTeam, workflowGate] = selection.selected
+    ? await Promise.all([
+      listRuntimeTestRuns(projectRoot, selection.selected.runId),
+      readValidationWaveEvidence(projectRoot, workflow.branch, input.taskId, selection.selected.runId),
+      readRuntimeActivity(projectRoot, selection.selected.runId),
+      listRuntimeDurableGaps(projectRoot, { partition: workflow.branch, taskId: input.taskId, status: 'open_terminal' }),
+      readStageTeamEvidence(projectRoot, workflow.branch, input.taskId, selection.selected.runId),
+      readWorkflowGateEvidence(projectRoot, workflow.branch, input.taskId, selection.selected.runId)
+    ])
+    : await Promise.all([
+      Promise.resolve([]),
+      readValidationWaveEvidence(projectRoot, workflow.branch, input.taskId, null),
+      Promise.resolve(emptyRuntimeActivity()),
+      listRuntimeDurableGaps(projectRoot, { partition: workflow.branch, taskId: input.taskId, status: 'open_terminal' }),
+      readStageTeamEvidence(projectRoot, workflow.branch, input.taskId, null),
+      readWorkflowGateEvidence(projectRoot, workflow.branch, input.taskId, null)
+    ]);
+
+  const [validationWaves, environmentSessions, acceptanceEvidenceMaps] = validationWaveEvidence;
+  return {
+    contract: TASK_EVIDENCE_VIEW_CONTRACT_VERSION,
+    generatedAt: new Date().toISOString(),
+    retrievalMemoryOnly: false,
+    source: 'runtime.sqlite+branch-evidence-payloads',
+    branch: workflow.branch,
+    taskId: input.taskId,
+    latestEligibleRun: selection.selected,
+    candidates: selection.candidates,
+    rejected: selection.rejected,
+    compatibility: selection.selected?.compatibility ?? null,
+    payloads,
+    validation: {
+      runValidation: selectedRunState?.validation ?? null,
+      testRuns: testRuns.filter((run) => run.taskId === input.taskId),
+      validationWaves,
+      environmentSessions,
+      acceptanceEvidenceMaps
+    },
+    runtimeActivity,
+    gaps: [...workflow.visibleGaps.filter((gap) => gap.taskId === input.taskId || gap.taskId === null), ...runtimeTaskGaps(selectedRunState?.tasks[input.taskId])],
+    durableGaps,
+    stageTeam,
+    workflowGate
+  };
+}
+
+function emptySelection(partition: string, taskId: string): LatestEligibleRunSelection {
+  return { partition, taskId, selected: null, candidates: [], rejected: [] };
+}
+
+function uniqueRunIds(selection: LatestEligibleRunSelection): string[] {
+  return Array.from(new Set([...selection.candidates, ...selection.rejected].map((candidate) => candidate.runId)));
+}
+
+async function readTaskPayloads(projectRoot: string, branch: string, taskId: string, runIds: string[]): Promise<TaskEvidencePayloadGroups> {
+  const payloads = runIds.length > 0
+    ? (await Promise.all(runIds.map((runId) => listRuntimeArtifactPayloads(projectRoot, { runId, taskId })))).flat()
+    : await listRuntimeArtifactPayloads(projectRoot, { branchSlug: branchToSafePartition(branch), taskId });
+  return {
+    active: payloads.filter((payload) => payload.status === 'active'),
+    candidate: payloads.filter((payload) => payload.status === 'candidate'),
+    rejected: payloads.filter((payload) => payload.status === 'rejected'),
+    superseded: payloads.filter((payload) => payload.status === 'superseded'),
+    all: payloads
+  };
+}
+
+async function readValidationWaveEvidence(projectRoot: string, partition: string, taskId: string, runId: string | null): Promise<[RuntimeValidationWaveRunRecord[], RuntimeValidationEnvironmentSessionRecord[], RuntimeAcceptanceEvidenceMapRecord[]]> {
+  const query = runId ? { partition, runId, taskId } : { partition, taskId };
+  const validationWaves = await listRuntimeValidationWaveRuns(projectRoot, query);
+  const waveRunIds = validationWaves.map((wave) => wave.waveRunId);
+  const [environmentSessions, acceptanceEvidenceMaps] = await Promise.all([
+    Promise.all(waveRunIds.map((waveRunId) => listRuntimeValidationEnvironmentSessions(projectRoot, { partition, waveRunId }))).then((items) => items.flat()),
+    Promise.all(waveRunIds.map((waveRunId) => listRuntimeAcceptanceEvidenceMaps(projectRoot, { partition, taskId, waveRunId }))).then((items) => items.flat())
+  ]);
+  return [validationWaves, environmentSessions, acceptanceEvidenceMaps];
+}
+
+
+async function readRuntimeActivity(projectRoot: string, runId: string): Promise<TaskEvidenceRuntimeActivity> {
+  const [agentExecutions, teamSessions, workerRuntimes] = await Promise.all([
+    listRuntimeAgentExecutions(projectRoot, runId),
+    listRuntimeTeamSessions(projectRoot, runId),
+    listRuntimeWorkerRuntimes(projectRoot, runId)
+  ]);
+  return { agentExecutions, teamSessions, workerRuntimes };
+}
+
+async function readStageTeamEvidence(projectRoot: string, partition: string, taskId: string, runId: string | null): Promise<TaskEvidenceStageTeamView> {
+  const query = runId ? { partition, taskId, runId } : { partition, taskId };
+  const [sessions, roleResults, advisorAssessments, fanInEvidenceSets] = await Promise.all([
+    listRuntimeStageTeamSessions(projectRoot, query),
+    listRuntimeStageRoleResults(projectRoot, query),
+    listRuntimeLlmAdvisorAssessments(projectRoot, query),
+    listRuntimeFanInEvidenceSets(projectRoot, query)
+  ]);
+  return { sessions, roleResults, advisorAssessments, fanInEvidenceSets };
+}
+
+async function readWorkflowGateEvidence(projectRoot: string, partition: string, taskId: string, runId: string | null): Promise<TaskEvidenceWorkflowGateView> {
+  const query = runId ? { partition, taskId, runId } : { partition, taskId };
+  const decisions = await listRuntimeWorkflowGateDecisions(projectRoot, query);
+  return { latestDecision: decisions[0] ?? null, decisions };
+}
+
+function emptyRuntimeActivity(): TaskEvidenceRuntimeActivity {
+  return { agentExecutions: [], teamSessions: [], workerRuntimes: [] };
+}
+
+function runtimeTaskGaps(taskState: unknown): SddTaskGap[] {
+  if (!taskState || typeof taskState !== 'object' || !('gaps' in taskState)) {
+    return [];
+  }
+  const gaps = (taskState as { gaps?: unknown }).gaps;
+  return Array.isArray(gaps) ? gaps.filter(isTaskGap) : [];
+}
+
+function isTaskGap(value: unknown): value is SddTaskGap {
+  if (!value || typeof value !== 'object') {
+    return false;
+  }
+  const gap = value as Partial<SddTaskGap>;
+  return typeof gap.type === 'string' && typeof gap.severity === 'string' && typeof gap.field === 'string' && typeof gap.message === 'string' && typeof gap.recommendation === 'string';
+}