feat(ql3): audit legacy shadow terminal windows

2026-09-23 12:05:27 +08:00 · 2026-08-19 00:07:04 +08:00
parent d38f624262
commit b739d92347
10 changed files with 1991 additions and 5 deletions
@@ -0,0 +1,76 @@
+import type {
+  ExecutionOrigin,
+  RunAttemptStatus,
+  RunStatus,
+} from '../domain/run';
+
+export const MAX_LEGACY_SHADOW_TERMINAL_PAGE_SIZE = 64;
+export const MAX_LEGACY_SHADOW_TERMINAL_EVIDENCE_PER_PAGE = 512;
+
+export interface LegacyShadowTerminalCursor {
+  createdAtMs: number;
+  runId: string;
+}
+
+export interface LegacyShadowTerminalAttemptEvidence {
+  attemptId: string;
+  status: RunAttemptStatus;
+  pid?: number;
+  logArtifactId?: string;
+  createdAtMs: number;
+  startedAtMs?: number;
+  finishedAtMs?: number;
+  exitCode?: number;
+}
+
+export interface LegacyShadowTerminalCandidate {
+  runId: string;
+  legacyCronId?: number;
+  origin: ExecutionOrigin;
+  runStatus: RunStatus;
+  createdAtMs: number;
+  startedAtMs?: number;
+  finishedAtMs?: number;
+  attemptCount: number;
+  attempt?: LegacyShadowTerminalAttemptEvidence;
+}
+
+export type LegacyTerminalOutcome = 'succeeded' | 'failed' | 'stopped';
+
+export interface LegacyTerminalEvidence {
+  instanceId: number;
+  legacyCronId: number;
+  runId?: string;
+  attemptId?: string;
+  pid?: number;
+  logArtifactId?: string;
+  startedAtMs: number;
+  finishedAtMs: number;
+  outcome: LegacyTerminalOutcome;
+  exitCode?: number;
+}
+
+export interface LegacyShadowTerminalPage {
+  candidates: readonly LegacyShadowTerminalCandidate[];
+  evidence: readonly LegacyTerminalEvidence[];
+  evidenceTruncated: boolean;
+  truncated: boolean;
+  nextCursor?: LegacyShadowTerminalCursor;
+}
+
+/**
+ * Read-only local Legacy authority used by the explicit terminal-difference
+ * audit. Implementations must bound both candidate and evidence result sets.
+ */
+export interface LegacyShadowTerminalDifferenceSource {
+  listCandidates(options: {
+    projectId: string;
+    origins: readonly ExecutionOrigin[];
+    windowStartMs: number;
+    windowEndMs: number;
+    observedAtMs: number;
+    correlationToleranceMs: number;
+    cursor?: LegacyShadowTerminalCursor;
+    limit: number;
+  }): Promise<LegacyShadowTerminalPage>;
+}