LuisandN0zoM1z0
bb154d1067
Inspect bounded offline aioquic1.5.0 JSON qlog0.3 and page retained event/transport facts with explicit trace and stream selectors. Preserve producer coordinates, exact numeric lexemes, global pre-selection fact scope and endpoint declaration uncertainty. Verified four real HTTP/3 recordings with an independent interval oracle, public CLI/MCP/schema parity, auth exclusions, source-deletion views and actual decoder heap exhaustion. Unverified producer platforms and qlog-specific lifecycle induction remain documented. Co-authored-by: LuisTaffelli <86675342+LuisTaffelli@users.noreply.github.com> Co-authored-by: N0zoM1z0 <161784452+N0zoM1z0@users.noreply.github.com>
64 lines
2.3 KiB
TypeScript
64 lines
2.3 KiB
TypeScript
import { z } from "incur";
|
|
import { WEB_NETWORK_CAPTURE_FORMATS } from "../domain/webNetworkCapture.js";
|
|
import { createWebNetworkCaptureService } from "../composition/webNetworkCaptures.js";
|
|
import { CLI_COMMANDS } from "../cliCommandNames.js";
|
|
import { logCliCommand } from "../cliLogging.js";
|
|
import { projectAnalysisError } from "../domain/analysisErrorProjection.js";
|
|
import type { Logger } from "pino";
|
|
import type { CliInstance } from "./types.js";
|
|
import { withCommandCancellation } from "./commandCancellation.js";
|
|
|
|
/** Expose offline historical capture inspection with the same selection contract as MCP. */
|
|
export const registerWebNetworkCaptureCommands = (
|
|
cli: CliInstance,
|
|
logger: Logger,
|
|
environment: Readonly<NodeJS.ProcessEnv>,
|
|
): void => {
|
|
const service = createWebNetworkCaptureService(environment);
|
|
cli.command(CLI_COMMANDS.inspectWebNetworkCapture, {
|
|
description:
|
|
"Inspect retained HAR, native mitmproxy, Fiddler SAZ or aioquic qlog records without fetching recorded URLs",
|
|
args: z.object({
|
|
capturePath: z.string().describe("Absolute local capture path"),
|
|
format: z
|
|
.enum(WEB_NETWORK_CAPTURE_FORMATS)
|
|
.describe("Producer capture format"),
|
|
}),
|
|
options: z.object({
|
|
record: z
|
|
.array(z.coerce.number().int().nonnegative())
|
|
.optional()
|
|
.describe("Zero-based producer ordinals; repeat to select several"),
|
|
sensitiveValue: z
|
|
.array(z.string().min(1))
|
|
.default([])
|
|
.describe(
|
|
"Literal string values explicitly marked sensitive; repeat as needed",
|
|
),
|
|
}),
|
|
run: ({ args, options }) =>
|
|
withCommandCancellation((signal) =>
|
|
logCliCommand(
|
|
logger,
|
|
CLI_COMMANDS.inspectWebNetworkCapture,
|
|
async () => {
|
|
const result = await service.inspect(
|
|
{
|
|
capture_path: args.capturePath,
|
|
format: args.format,
|
|
sensitive_values: options.sensitiveValue,
|
|
...(options.record === undefined
|
|
? {}
|
|
: { record_ordinals: options.record }),
|
|
},
|
|
{ signal },
|
|
);
|
|
return result.ok
|
|
? result.value
|
|
: projectAnalysisError(result.error);
|
|
},
|
|
),
|
|
),
|
|
});
|
|
};
|