refactor(captures)!: require canonical producer metadata

Require process retention accounting, browser network transaction identity, and all web comparison dimensions. Remove obsolete omission repairs and derive completeness from the owning producer facts.

BREAKING CHANGE: Historical captures without current producer accounting or transaction identity, and web diffs missing accessibility or storage dimensions, are rejected.
This commit is contained in:
morluto
2026-10-09 23:35:19 +08:00
parent dea3498b2b
commit 3283a45d09
33 changed files with 624 additions and 303 deletions
@@ -6,6 +6,7 @@ import { isInitializedPtyRoot, readLinuxChildren } from "./ProcessSampling.js";
import { TerminalRenderer } from "./TerminalRenderer.js";
import { parseProcessScenario } from "../../domain/process/processScenario.js";
import { type ProcessCapture } from "../../domain/process/processCaptureParsing.js";
import type { ProcessCaptureTruncationDetails } from "../../domain/process/processCaptureCoverage.js";
import { emptyProcessCapture as emptyCapture } from "../../domain/process/processCapture.fixture.js";
const base = {
@@ -13,6 +14,51 @@ const base = {
working_directory: "/tmp",
};
const emptyFilesystemCoverage = () =>
emptyCapture().truncation_details.filesystem_before;
const truncationDetails = (
frames: readonly ProcessCapture["frames"][number][],
renderedFrames: readonly ProcessCapture["rendered_frames"][number][],
samples: readonly ProcessCapture["process_samples"][number][],
): ProcessCaptureTruncationDetails => {
const emptyDetails = emptyCapture().truncation_details;
const rawBytes = frames.reduce(
(total, frame) => total + Buffer.byteLength(frame.raw_data ?? frame.data),
0,
);
const renderedBytes = renderedFrames.reduce(
(total, frame) =>
frame.lines.reduce(
(sum, line) => sum + Buffer.byteLength(line),
total + Buffer.byteLength(frame.serialized_state),
),
0,
);
return {
raw_terminal: {
...emptyDetails.raw_terminal,
observed_bytes: rawBytes,
retained_bytes: rawBytes,
observed_frames: frames.length,
retained_frames: frames.length,
},
rendered_terminal: {
...emptyDetails.rendered_terminal,
observed_bytes: renderedBytes,
retained_bytes: renderedBytes,
observed_frames: renderedFrames.length,
retained_frames: renderedFrames.length,
},
filesystem_before: emptyDetails.filesystem_before,
filesystem_after: emptyDetails.filesystem_after,
process: {
...emptyDetails.process,
retained_samples: samples.length,
},
};
};
it("returns detached terminal observations", async () => {
const observed: string[] = [];
const renderer = new TerminalRenderer({
@@ -72,9 +118,19 @@ it("preserves rendered observation order instead of timestamp sorting", () => {
frames: [],
exit: { exitCode: 0, reason: "exited" },
samples: [],
before: { files: [], truncated: false, completeRoots: [] },
after: { files: [], truncated: false, completeRoots: [] },
truncated: false,
before: {
files: [],
truncated: false,
completeRoots: [],
coverage: emptyFilesystemCoverage(),
},
after: {
files: [],
truncated: false,
completeRoots: [],
coverage: emptyFilesystemCoverage(),
},
truncationDetails: truncationDetails([], renderedFrames, []),
scenario: parseProcessScenario(base),
rootPid: 1,
samplingPartial: false,
@@ -98,9 +154,19 @@ it("marks redacted scripted input as an interaction unknown", () => {
frames: [],
exit: { exitCode: 0, reason: "exited" },
samples: [],
before: { files: [], truncated: false, completeRoots: [] },
after: { files: [], truncated: false, completeRoots: [] },
truncated: false,
before: {
files: [],
truncated: false,
completeRoots: [],
coverage: emptyFilesystemCoverage(),
},
after: {
files: [],
truncated: false,
completeRoots: [],
coverage: emptyFilesystemCoverage(),
},
truncationDetails: truncationDetails([], [], []),
scenario: parseProcessScenario({
...base,
events: [{ type: "input", at_ms: 0, data: "secret", sensitive: true }],