* refactor(browser): share captured-script acquisition boundaries Reuse stable capture/source acquisition and identity validation for module and source-map analysis. Preserve host I/O, malformed input, unavailable source and digest mismatch diagnostics. Refs #851 Assisted-by: Yukari (gensokyo-skills:yukari-boundary-analysis) Assisted-by: Kogasa (gensokyo-skills:kogasa-surprise-testing) * feat(browser): trace captured website source-map locations Refs #851. Preserve selected capture/map byte identity, duplicate mappings and embedded source evidence through the pinned upstream codec. Assisted-by: Yukari (gensokyo-skills:yukari-boundary-analysis) Assisted-by: Kogasa (gensokyo-skills:kogasa-surprise-testing) * test(browser): verify source-map artifacts and synchronize generated contracts Cover byte-preserving map reads and actionable filesystem constraints. Refresh generated public schemas and metadata on current main. Assisted-by: Yukari (gensokyo-skills:yukari-boundary-analysis) Assisted-by: Kogasa (gensokyo-skills:kogasa-surprise-testing) * fix(browser): preserve inert source-map URL context The selected URL is local codec context and grants no transport authority. Preserve its reported text and verify normal/userinfo contexts through real public interfaces, alongside independent manifest byte identity. Assisted-by: Yukari (gensokyo-skills:yukari-boundary-analysis) Assisted-by: Kogasa (gensokyo-skills:kogasa-surprise-testing)
57 lines
2.1 KiB
TypeScript
57 lines
2.1 KiB
TypeScript
import { z } from "incur";
|
|
import { createWebSourceLocationService } from "../composition/webSourceLocations.js";
|
|
import { CLI_COMMANDS } from "../cliCommandNames.js";
|
|
import { logCliCommand } from "../cliLogging.js";
|
|
import { projectAnalysisError } from "../domain/analysisErrorProjection.js";
|
|
import type { Logger } from "../logger.js";
|
|
import type { CliInstance } from "./types.js";
|
|
import { withCommandCancellation } from "./commandCancellation.js";
|
|
|
|
/** Expose the same explicit selected map/point contract through the CLI. */
|
|
export const registerWebSourceLocationCommands = (
|
|
cli: CliInstance,
|
|
logger: Logger,
|
|
environment: Readonly<NodeJS.ProcessEnv>,
|
|
): void => {
|
|
const service = createWebSourceLocationService(environment);
|
|
cli.command(CLI_COMMANDS.traceWebSourceLocation, {
|
|
description:
|
|
"Trace one retained script position through an explicitly selected local source map",
|
|
args: z.object({
|
|
manifestPath: z
|
|
.string()
|
|
.describe("Absolute export_web_scripts manifest path"),
|
|
scriptIndex: z.coerce
|
|
.number()
|
|
.int()
|
|
.min(0)
|
|
.describe("Zero-based manifest script index"),
|
|
sourceMapPath: z.string().describe("Absolute local source-map path"),
|
|
sourceMapUrl: z
|
|
.string()
|
|
.describe("Absolute source-map URL context; no fetch"),
|
|
line: z.coerce.number().int().min(1).describe("One-based generated line"),
|
|
column: z.coerce
|
|
.number()
|
|
.int()
|
|
.min(0)
|
|
.describe("Zero-based UTF-16 generated column"),
|
|
}),
|
|
run: ({ args }) =>
|
|
withCommandCancellation((signal) =>
|
|
logCliCommand(logger, CLI_COMMANDS.traceWebSourceLocation, async () => {
|
|
const result = await service.trace(
|
|
{
|
|
manifest_path: args.manifestPath,
|
|
script_index: args.scriptIndex,
|
|
source_map: { path: args.sourceMapPath, url: args.sourceMapUrl },
|
|
generated_position: { line: args.line, column: args.column },
|
|
},
|
|
{ signal },
|
|
);
|
|
return result.ok ? result.value : projectAnalysisError(result.error);
|
|
}),
|
|
),
|
|
});
|
|
};
|