@jevitate/cli 0.12.0 → 0.13.0

package/dist/mcp-tools/journey.js

@@ -0,0 +1,260 @@
+import { SiteGateRefusedError } from "@jevitate/runtime";
+import { findCapabilities } from "@jevitate/mcp-facade";
+import { FsJourneyStore, JourneyRegistry } from "@jevitate/journey";
+import { existsSync } from "node:fs";
+import { ParamValidationError } from "@jevitate/journey";
+import { safeRunPolicy as defaultRunPolicy } from "@jevitate/domain";
+import { stampRunMetadata, withRunMetadata } from "../run-metadata.js";
+import { JourneyRequiresAuthError, UnknownJourneyError } from "../journey-api.js";
+import { ExtensionMismatchError } from "../browser-run-options.js";
+import { browserRunFromFlags, emulationFromFlags } from "../cli-shared.js";
+import { environmentFromFlags, isEnvironmentError } from "../environments.js";
+import { buildMissionFixtures, checkSetupRefs } from "../fixture-cli.js";
+import { FixtureSetupError, FixtureSpecError, UnboundSetupRefError } from "../mission-fixtures.js";
+import { parseScreenshotsArg } from "../run-screenshots.js";
+import { makeEvidenceSelfHealer } from "../self-heal-adapter.js";
+import { JourneyHealArgsError, MCP_HEAL_NAMES, journeyHealBudget, readJourneyChangeScope, validateJourneyHeal } from "../journey-heal.js";
+import { ChangesArgsError, ChangesInputError } from "../change-context.js";
+import { MAX_STEP_RESPONSE_TIMEOUT_MS } from "../journey-network-checks.js";
+import { McpArgError, argErrorBody, optBool, optEnum, optInt, optNamedSessions, optPath, optExtensions, optRecordVideo, optScreenshots, optString, optStringArray, optStringMap, optViewport } from "../mcp-args.js";
+import { resourcePreflight } from "../resource-preflight.js";
+import { jsonResult, errorResult, governanceArgs, withJourneyExitCode, SetupRequired, redactCredentials, tagsArg } from "./shared.js";
+/** `find_capabilities` and `run_journey`: the promoted-Journey tools. */
+export function journeyTools(ctx) {
+    const { deps, pathRoots, credentialStore, runJourney } = ctx;
+    const findCaps = deps.findCapabilities ??
+        ((query) => findCapabilities(new JourneyRegistry(new FsJourneyStore(deps.journeysDir)), query));
+    /**
+     * #255: `run_journey`'s CLI-parity options, resolved exactly as `journey run` resolves its flags
+     * (the same helpers: environmentFromFlags, browserRunFromFlags, parseScreenshotsArg,
+     * emulationFromFlags, buildMissionFixtures) — every refusal typed, before any browser opens.
+     */
+    const resolveJourneyRun = async (args) => {
+        // Params keep their historical leniency for a non-object (treated as none); a non-string VALUE is refused.
+        const params = args.params && typeof args.params === "object" && !Array.isArray(args.params) ? (optStringMap(args, "params") ?? {}) : {};
+        const envName = optString(args, "env");
+        const baseUrl = optString(args, "baseUrl");
+        const environment = environmentFromFlags({ ...(envName === undefined ? {} : { env: envName }), ...(baseUrl === undefined ? {} : { baseUrl }) }, { ...(deps.environmentsFile === undefined ? {} : { environmentsFile: deps.environmentsFile }), ...(deps.targetsConfigPath === undefined ? {} : { targetsFile: deps.targetsConfigPath }) });
+        // --storage-state wins; else the environment's own session (~/.jevitate/targets.json[<origin>]).
+        const storageState = optPath(args, "storageState", pathRoots, { session: true }) ?? environment?.storageState;
+        if (args.storageState !== undefined && storageState !== undefined && !existsSync(storageState))
+            throw new McpArgError(`storage state not found: ${storageState}`);
+        const headed = optBool(args, "headed");
+        const slowMo = optInt(args, "slowMo", 0);
+        const recordVideo = optRecordVideo(args, pathRoots);
+        const extension = optExtensions(args, pathRoots);
+        const governance = governanceArgs(args);
+        let browser;
+        let screenshots;
+        let emulation;
+        try {
+            browser = browserRunFromFlags({ browserArg: [], ...governance, ...(extension === undefined ? {} : { extension }), ...(headed === undefined ? {} : { headed }), ...(slowMo === undefined ? {} : { slowMo }), ...(recordVideo === undefined ? {} : { recordVideo }) });
+            screenshots = parseScreenshotsArg(optScreenshots(args, pathRoots));
+            const viewport = optViewport(args);
+            const device = optString(args, "device");
+            const geolocation = optString(args, "geolocation");
+            emulation = emulationFromFlags({ ...(viewport === undefined ? {} : { viewport }), ...(device === undefined ? {} : { device }), ...(geolocation === undefined ? {} : { geolocation }) });
+        }
+        catch (err) {
+            if (err instanceof McpArgError || argErrorBody(err) !== undefined)
+                throw err;
+            throw new McpArgError(err instanceof Error ? err.message : String(err));
+        }
+        const fixturesFile = optPath(args, "fixtures", pathRoots);
+        const fixtureIdentity = optNamedSessions(args, "fixtureIdentity", pathRoots);
+        // The environment's hooks apply as on the CLI; they need --allow-shell-hooks, which MCP never sets.
+        const fixtureFlags = {
+            ...(fixturesFile === undefined ? {} : { fixtures: fixturesFile }),
+            ...(fixtureIdentity === undefined ? {} : { fixtureIdentity }),
+            ...(environment?.hooks?.before === undefined ? {} : { before: environment.hooks.before }),
+            ...(environment?.hooks?.after === undefined ? {} : { after: environment.hooks.after }),
+        };
+        const fixtures = (site) => {
+            const fx = buildMissionFixtures(fixtureFlags, {
+                allowlist: environment === undefined ? [site] : environment.allowedOrigins,
+                baseUrl: site,
+                ...(storageState !== undefined ? { storageState } : {}),
+                ...(environment?.fixtures === undefined ? {} : { targetFixtures: environment.fixtures }),
+            });
+            checkSetupRefs({ "--param": Object.values(params) }, fx);
+            return fx;
+        };
+        const selfHeal = optEnum(args, "selfHeal", ["fail-closed", "hybrid", "full"]) ?? "fail-closed";
+        const real = optBool(args, "real") ?? false;
+        const fakeAi = optBool(args, "fakeAi") ?? false;
+        // #429: the Jev provider for self-heal judgments (typesafe | openrouter), as `--jev-provider`.
+        const jevProvider = optEnum(args, "jevProvider", ["typesafe", "openrouter"]);
+        // #453 Q1: the same refusals as `journey run` — a heal needs a change context, the change and
+        // budget arguments need a heal — before any gateway, Journey lookup or browser.
+        const changes = optString(args, "changes");
+        const healMaxAttempts = optInt(args, "healMaxAttempts", 1);
+        const healMaxModelCalls = optInt(args, "healMaxModelCalls", 1);
+        const healMaxMs = optInt(args, "healMaxMs", 1);
+        const healMaxRunAttempts = optInt(args, "healMaxRunAttempts", 1);
+        const healMaxRunMs = optInt(args, "healMaxRunMs", 1);
+        const stepResponseTimeoutMs = optInt(args, "stepResponseTimeoutMs", 1);
+        if (stepResponseTimeoutMs !== undefined && stepResponseTimeoutMs > MAX_STEP_RESPONSE_TIMEOUT_MS) {
+            throw new McpArgError(`'stepResponseTimeoutMs' must be an integer from 1 to ${MAX_STEP_RESPONSE_TIMEOUT_MS}`);
+        }
+        const healRequest = {
+            selfHeal,
+            ...(changes === undefined ? {} : { changes }),
+            changeNotes: optStringArray(args, "changeNote") ?? [],
+            ...(healMaxAttempts === undefined ? {} : { maxAttempts: healMaxAttempts }),
+            ...(healMaxModelCalls === undefined ? {} : { maxModelCalls: healMaxModelCalls }),
+            ...(healMaxMs === undefined ? {} : { maxMs: healMaxMs }),
+            ...(healMaxRunAttempts === undefined ? {} : { maxRunAttempts: healMaxRunAttempts }),
+            ...(healMaxRunMs === undefined ? {} : { maxRunMs: healMaxRunMs }),
+        };
+        validateJourneyHeal(healRequest, MCP_HEAL_NAMES);
+        const healScope = selfHeal === "fail-closed" ? undefined : await readJourneyChangeScope(healRequest, deps.journeysDir);
+        let selfHealer;
+        let policy = defaultRunPolicy();
+        let usage;
+        if (selfHeal !== "fail-closed") {
+            if (deps.selfHealGateways === undefined)
+                throw new SetupRequired("run_journey selfHeal needs the model gateways, which this server was not given");
+            // #453: the healer is evidence-only — its model is an advisory ranker; judgment never decides a heal.
+            let gen;
+            try {
+                ({ gen, usage } = await deps.selfHealGateways({ real, fakeAi, ...(jevProvider === undefined ? {} : { jevProvider }) }));
+            }
+            catch (err) {
+                throw new SetupRequired(redactCredentials(err instanceof Error ? err.message : String(err), credentialStore));
+            }
+            selfHealer = makeEvidenceSelfHealer(gen, usage === undefined ? {} : { usage });
+            policy = { ...policy, selfHeal: { mode: selfHeal, budget: journeyHealBudget(healRequest) } };
+        }
+        return {
+            params,
+            ...(storageState === undefined ? {} : { storageState }),
+            options: {
+                policy,
+                fixtures,
+                ...(selfHealer === undefined ? {} : { selfHealer }),
+                ...(healScope === undefined ? {} : { heal: { scope: healScope } }),
+                ...(environment === undefined ? {} : { environment }),
+                ...(browser === undefined ? {} : { browser }),
+                ...(emulation === undefined ? {} : { emulation }),
+                ...(screenshots === undefined ? {} : { screenshots }),
+                ...(optBool(args, "actionDeltas") === true ? { actionDeltas: true } : {}),
+                ...(stepResponseTimeoutMs === undefined ? {} : { stepResponseTimeoutMs }),
+            },
+            ...(usage === undefined ? {} : { usage }),
+        };
+    };
+    return {
+        find_capabilities: {
+            description: "Find promoted Journeys (capabilities) whose metadata matches a query.",
+            inputSchema: { type: "object", properties: { query: { type: "string" } }, required: ["query"] },
+            handler: async (args) => jsonResult(await findCaps(typeof args.query === "string" ? args.query : "")),
+        },
+        run_journey: {
+            description: "Run a PUBLISHED Journey by id with string params (fail-closed policy) — `jevitate journey run`. Never accepts inline steps. " +
+                "Optional 'storageState': a PATH (on the machine running this MCP server; inside the project or ~/.jevitate, never a repo's .jevitate/) to a Playwright storageState " +
+                "JSON file, for a Journey authored behind a login (#118) — the file's contents are read only by the " +
+                "server's own browser, never returned or logged. A Journey that declares metadata.requiresAuth refuses " +
+                "with a clear error when no storageState is given. #255 (same as the CLI flags): 'env' (a named environment in .jevitate/environments.json; its session from ~/.jevitate/targets.json) and/or 'baseUrl'; " +
+                "'headed' (needs a display) and 'slowMo'; 'recordVideo' (true, or a directory) → videoPaths; 'screenshots' (true | screens | steps | mode:<dir> | <dir>) → screenshotPaths; " +
+                "'viewport' {width,height} or 'device' (mutually exclusive); 'geolocation' '<lat>,<lng>[,<accuracy m>]' (#329); 'fixtures' (a fixtures JSON path: setup before, restore after; 'fixtureIdentity' (#243) 'name=<storageState path>' entries name who a step with auth.identity authenticates as; an environment's shell hooks are never run over MCP — they refuse as the CLI does without --allow-shell-hooks); " +
+                "'extension' (#256: unpacked extension directories inside the project or ~/.jevitate; a Journey recorded with extensions needs the same build); 'selfHeal' fail-closed (default) | hybrid | full with 'real' or 'fakeAi' (a write step never self-heals; 'jevProvider' typesafe | openrouter picks the Jev key with real, #429) — #453: a heal mode needs a change context, 'changes' (a git range such as HEAD~1..HEAD, read-only) and/or 'changeNote' (strings), else it is refused; only a break that change explains is retargeted, one-for-one, and the run ends healed-pending-review (exitCode 5: a proposed revision a person accepts, never a pass); budgets 'healMaxAttempts'/'healMaxModelCalls'/'healMaxMs' (per broken step) and 'healMaxRunAttempts'/'healMaxRunMs' (per run), each >= 1; the result's 'exitCode' is the CLI's (0 ok, 5 pending review, 1 failed); 'actionDeltas' (#303, opt-in: each replayed step's action delta, compared with the recorded one → actionDeltas); 'stepResponseTimeoutMs' (#486, 1..300000, default 15000: how long a step's responseStatus check waits for a request sent but not yet answered, e.g. a cold start — a late 2xx is an advisory slowSteps finding; a step's own responseTimeoutMs overrides it); 'maxBrowsers'/'maxBrowserMemory' (#205: machine-wide browser cap, browser memory ceiling in MiB); 'tags' (#426: {key: value} run metadata, returned on the result — never a secret). A site-policy refusal is {error: throttled, retryAfter}.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: { type: "string" },
+                    params: { type: "object", additionalProperties: { type: "string" } },
+                    storageState: { type: "string" },
+                    env: { type: "string" },
+                    baseUrl: { type: "string" },
+                    headed: { type: "boolean" },
+                    slowMo: { type: "integer", minimum: 0 },
+                    recordVideo: { type: ["boolean", "string"] },
+                    screenshots: { type: ["boolean", "string"] },
+                    viewport: { type: "object", properties: { width: { type: "integer" }, height: { type: "integer" } }, required: ["width", "height"] },
+                    device: { type: "string" },
+                    geolocation: { type: "string" },
+                    fixtures: { type: "string" },
+                    fixtureIdentity: { type: "array", items: { type: "string" } },
+                    selfHeal: { type: "string", enum: ["fail-closed", "hybrid", "full"] },
+                    changes: { type: "string" },
+                    changeNote: { type: "array", items: { type: "string" } },
+                    healMaxAttempts: { type: "integer", minimum: 1 },
+                    healMaxModelCalls: { type: "integer", minimum: 1 },
+                    healMaxMs: { type: "integer", minimum: 1 },
+                    healMaxRunAttempts: { type: "integer", minimum: 1 },
+                    healMaxRunMs: { type: "integer", minimum: 1 },
+                    real: { type: "boolean" },
+                    fakeAi: { type: "boolean" },
+                    jevProvider: { type: "string", enum: ["typesafe", "openrouter"] },
+                    extension: { type: "array", items: { type: "string" } },
+                    maxBrowsers: { type: "integer", minimum: 1 },
+                    maxBrowserMemory: { type: "integer", minimum: 1 },
+                    actionDeltas: { type: "boolean" },
+                    stepResponseTimeoutMs: { type: "integer", minimum: 1, maximum: MAX_STEP_RESPONSE_TIMEOUT_MS },
+                    tags: { type: "object", additionalProperties: { type: "string" } },
+                },
+                required: ["id"],
+            },
+            handler: async (args) => {
+                if (typeof args.id !== "string" || args.id.length === 0) {
+                    return errorResult({ error: "invalid_args", message: "run_journey requires a non-empty string 'id'" });
+                }
+                const tagged = tagsArg(args);
+                if ("error" in tagged)
+                    return errorResult(tagged.error);
+                // Invariant #5: only id + params (+ a storageState PATH and the run options below) are
+                // threaded through — any inline `steps`/`recording` in the arguments is deliberately ignored.
+                let resolved;
+                try {
+                    resolved = await resolveJourneyRun(args);
+                }
+                catch (err) {
+                    const body = argErrorBody(err) ?? (isEnvironmentError(err) ? { error: "invalid_args", code: err.code, message: err.message } : undefined);
+                    if (body !== undefined)
+                        return errorResult(body);
+                    if (err instanceof JourneyHealArgsError || err instanceof ChangesArgsError || err instanceof ChangesInputError) {
+                        return errorResult({ error: "invalid_args", code: err.code, message: err.message });
+                    }
+                    if (err instanceof SetupRequired)
+                        return errorResult({ error: "setup_required", message: err.message });
+                    throw err;
+                }
+                // #205: the same pre-run checks as `jevitate journey run` (orphan sweep, starved-host refusal).
+                const starved = await resourcePreflight({});
+                if (starved !== null)
+                    return errorResult({ error: "refused", code: starved.error?.code, message: starved.error?.message });
+                try {
+                    const id = args.id;
+                    const result = await withRunMetadata({ tags: tagged.tags }, () => runJourney(id, resolved.params, resolved.storageState, resolved.options));
+                    // #163: a self-healing run's model usage lands on its result, as on the CLI. #426: so do its tags.
+                    const withUsage = resolved.usage === undefined || result === null || typeof result !== "object" ? result : { ...result, usage: resolved.usage.snapshot() };
+                    // #453: the CLI's exit code for the outcome — 0 ok, 5 healed-pending-review (a proposed revision, never a pass), 1 otherwise.
+                    return jsonResult(stampRunMetadata(withJourneyExitCode(withUsage), { tags: tagged.tags }));
+                }
+                catch (err) {
+                    // A site-policy refusal (throttle, budget, quiet hours) is an answer the agent acts on — when to retry.
+                    if (err instanceof SiteGateRefusedError) {
+                        return errorResult({ error: "throttled", reason: err.reason, retryAfter: err.retryAfter, message: err.message });
+                    }
+                    if (err instanceof UnknownJourneyError)
+                        return errorResult({ error: "not_found", id: args.id, message: err.message });
+                    if (err instanceof JourneyRequiresAuthError)
+                        return errorResult({ error: "invalid_args", code: "E_JOURNEY_REQUIRES_AUTH", message: err.message });
+                    if (err instanceof ExtensionMismatchError)
+                        return errorResult({ error: "invalid_args", code: err.code, message: err.message });
+                    if (err instanceof ParamValidationError)
+                        return errorResult({ error: "invalid_args", code: "E_INVALID_PARAMS", message: err.message });
+                    if (isEnvironmentError(err) || err instanceof FixtureSpecError || err instanceof UnboundSetupRefError) {
+                        return errorResult({ error: "invalid_args", code: err.code, message: err.message });
+                    }
+                    // Never run on unknown state: inconclusive (exit 2) — proves nothing, so an error result.
+                    if (err instanceof FixtureSetupError) {
+                        return errorResult({ outcome: "inconclusive", reason: err.message, failure: { kind: "configuration", message: err.message }, attribution: "configuration", exitCode: 2 });
+                    }
+                    throw err;
+                }
+            },
+        },
+    };
+}
+//# sourceMappingURL=journey.js.map

package/dist/mcp-tools/journey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey.js","sourceRoot":"","sources":["../../src/mcp-tools/journey.ts"],"names":[],"mappings":"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"}

package/dist/mcp-tools/shared.d.ts

@@ -0,0 +1,39 @@
+import { type CredentialStore } from "@jevitate/ai-core";
+import { type GovernanceFlags } from "../resource-preflight.js";
+import type { McpApiDeps, McpTool, McpToolResult } from "../mcp-api.js";
+/** The dependencies a tool group closes over (built once by `buildMcpTools`). */
+export interface McpToolCtx {
+    readonly deps: McpApiDeps;
+    readonly pathRoots: readonly string[];
+    readonly credentialStore: CredentialStore;
+    readonly runJourney: NonNullable<McpApiDeps["runJourney"]>;
+    readonly verifyFixImpl: NonNullable<McpApiDeps["verifyFix"]>;
+}
+/** One group's tool descriptors, keyed by tool name (the name is added by `buildMcpTools`). */
+export type McpToolGroup = Record<string, Omit<McpTool, "name">>;
+/** #205: a native tool's `maxBrowsers` / `maxBrowserMemory` (MiB) arguments, typed like the CLI flags. */
+export declare function governanceArgs(args: Record<string, unknown>): GovernanceFlags;
+/** #453: a Journey run result with the CLI's exit code for its outcome (anything else unchanged). */
+export declare function withJourneyExitCode(result: unknown): unknown;
+export declare function jsonResult(value: unknown): McpToolResult;
+export declare function errorResult(value: unknown): McpToolResult;
+/** Strips any known credential VALUE from a diagnostic string so a provider
+ *  SDK error (which can echo request internals verbatim) never surfaces a key
+ *  through the MCP result. The message returned to the caller is generic and
+ *  key-free; this is belt-and-braces on top of the gateway's outbound guard. */
+/** #217: a persisted goal result's own ending (`result.goalOutcome`), when present. */
+export declare function goalOutcomeOf(file: object): unknown;
+/** #423: a persisted result's `defectOutcome.status` (`none`/`defects`), when present. */
+export declare function defectStatusOf(file: object): unknown;
+/** One field of a persisted result's `result` object, else undefined. */
+export declare function resultField(file: object, key: string): unknown;
+/** A model-backed option was asked for without usable gateways/keys (typed `setup_required`). */
+export declare class SetupRequired extends Error {
+}
+export declare function redactCredentials(message: string, store: CredentialStore): string;
+/** #426: the run tools' `tags` object — validated like `--tag` (an invalid one is invalid_args, never dropped). */
+export declare const tagsArg: (args: Record<string, unknown>) => {
+    tags: Record<string, string>;
+} | {
+    error: Record<string, unknown>;
+};

package/dist/mcp-tools/shared.js

@@ -0,0 +1,69 @@
+import { ALL_CREDENTIAL_KEYS } from "@jevitate/ai-core";
+import { RunTagError, JOURNEY_RUN_OUTCOMES, journeyExitCode, validateRunTags } from "@jevitate/domain";
+import { optInt } from "../mcp-args.js";
+/** #205: a native tool's `maxBrowsers` / `maxBrowserMemory` (MiB) arguments, typed like the CLI flags. */
+export function governanceArgs(args) {
+    const maxBrowsers = optInt(args, "maxBrowsers", 1);
+    const maxBrowserMemory = optInt(args, "maxBrowserMemory", 1);
+    return { ...(maxBrowsers === undefined ? {} : { maxBrowsers }), ...(maxBrowserMemory === undefined ? {} : { maxBrowserMemory }) };
+}
+/** #453: a Journey run result with the CLI's exit code for its outcome (anything else unchanged). */
+export function withJourneyExitCode(result) {
+    if (result === null || typeof result !== "object")
+        return result;
+    const outcome = result.outcome;
+    if (typeof outcome !== "string" || !JOURNEY_RUN_OUTCOMES.includes(outcome))
+        return result;
+    return { ...result, exitCode: journeyExitCode(outcome) };
+}
+export function jsonResult(value) {
+    return { content: [{ type: "text", text: JSON.stringify(value) }] };
+}
+export function errorResult(value) {
+    return { content: [{ type: "text", text: JSON.stringify(value) }], isError: true };
+}
+/** Strips any known credential VALUE from a diagnostic string so a provider
+ *  SDK error (which can echo request internals verbatim) never surfaces a key
+ *  through the MCP result. The message returned to the caller is generic and
+ *  key-free; this is belt-and-braces on top of the gateway's outbound guard. */
+/** #217: a persisted goal result's own ending (`result.goalOutcome`), when present. */
+export function goalOutcomeOf(file) {
+    const result = file.result;
+    return result !== null && typeof result === "object" && "goalOutcome" in result ? result.goalOutcome : undefined;
+}
+/** #423: a persisted result's `defectOutcome.status` (`none`/`defects`), when present. */
+export function defectStatusOf(file) {
+    const outcome = resultField(file, "defectOutcome");
+    return outcome !== null && typeof outcome === "object" && "status" in outcome ? outcome.status : undefined;
+}
+/** One field of a persisted result's `result` object, else undefined. */
+export function resultField(file, key) {
+    const result = file.result;
+    return result !== null && typeof result === "object" && key in result ? result[key] : undefined;
+}
+/** A model-backed option was asked for without usable gateways/keys (typed `setup_required`). */
+export class SetupRequired extends Error {
+}
+export function redactCredentials(message, store) {
+    let out = message;
+    for (const key of ALL_CREDENTIAL_KEYS) {
+        const value = store.read(key);
+        if (value)
+            out = out.split(value).join("***REDACTED***");
+    }
+    return out;
+}
+/** #426: the run tools' `tags` object — validated like `--tag` (an invalid one is invalid_args, never dropped). */
+export const tagsArg = (args) => {
+    if (args.tags === undefined)
+        return { tags: {} };
+    try {
+        return { tags: validateRunTags(args.tags, "tags") };
+    }
+    catch (err) {
+        if (!(err instanceof RunTagError))
+            throw err;
+        return { error: { error: "invalid_args", code: err.code, message: err.message } };
+    }
+};
+//# sourceMappingURL=shared.js.map

package/dist/mcp-tools/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/mcp-tools/shared.ts"],"names":[],"mappings":"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"}

package/dist/sweep-api.d.ts

@@ -37,6 +37,13 @@ export declare const MAX_SWEEP_CONCURRENCY = 16;
 export declare const MAX_SWEEP_TARGETS = 1000;
 /** The target option name → its typed explore argument (the allowed set). */
 export declare function sweepTargetOptions(): Readonly<Record<string, CliParam>>;
+/**
+ * #513: a sweep fixture, checked synchronously against the project root exactly like every upload
+ * fixture (#498): inside the root (after realpath), an existing file, not sensitive. Returns the absolute
+ * path (a relative one resolves against the working directory, as `explore --fixture` does).
+ * Throws `FixturePathError`.
+ */
+export declare function confineSweepFixture(raw: string, root: string | undefined): string;
 export interface SweepPersona {
     readonly name: string;
     /** Absolute, confined path of the persona's storage state (its contents are never read). */
@@ -64,6 +71,8 @@ export interface LoadSweepTargetsOptions {
     /** Extra roots a persona storage state may live in (default: the project and `~/.jevitate`). */
     readonly roots?: readonly string[];
     readonly env?: NodeJS.ProcessEnv;
+    /** The project root a target's `options.fixture` is confined to (default: the folder holding `.jevitate/`). */
+    readonly projectRoot?: string;
 }
 /**
  * Loads and validates a targets file (`.tsv`: a header row then one target per line; `.json`: an

package/dist/sweep-api.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, realpathSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname, extname, join, resolve } from "node:path";
 import { MISSION_EXIT_CODES, RunTagError, clock, combineOutcomes, validateRunTags, } from "@jevitate/domain";
 import { currentEngineInfo } from "./engine.js";
@@ -10,6 +10,8 @@ import { confineMcpPath, defaultMcpPathRoots } from "./mcp-paths.js";
 import { EXPLORE_STRATEGIES } from "./cli-shared.js";
 import { STARVED_LOAD_PER_CORE, hostProbe, validateAllowControlPatterns, validateDenyPatterns } from "@jevitate/explore";
 import { parseAuthCheck } from "./persona-login.js";
+import { journeyFixtureBaseDir } from "./journey-api.js";
+import { FixturePathError, fixtureEscapesRoot, fixtureNoRoot, fixtureNotFound, fixtureOutsideProject, fixtureRootRefusal, fixtureSensitive, fixtureSensitiveReason, fixtureUnsafeRoot, } from "@jevitate/recording";
 /**
  * `jevitate sweep` (#425): one release check over many targets (features/routes) × personas, run
  * with bounded concurrency, resumable, with ONE aggregated `sweep.result.json`.
@@ -96,8 +98,48 @@ export function sweepTargetOptions() {
             continue;
         out[name] = p;
     }
+    // `fixture` is a path kind on MCP (so excluded above), but the CLI's `explore --fixture` is confined to
+    // the project root (#498) and the sweep re-checks it when the spec loads: a target may set it (#513).
+    out.fixture = { kind: "string", flag: "--fixture" };
     return out;
 }
+/**
+ * #513: a sweep fixture, checked synchronously against the project root exactly like every upload
+ * fixture (#498): inside the root (after realpath), an existing file, not sensitive. Returns the absolute
+ * path (a relative one resolves against the working directory, as `explore --fixture` does).
+ * Throws `FixturePathError`.
+ */
+export function confineSweepFixture(raw, root) {
+    if (root === undefined)
+        throw fixtureNoRoot(raw);
+    const unsafe = fixtureRootRefusal(root);
+    if (unsafe !== null)
+        throw fixtureUnsafeRoot(raw, root, unsafe);
+    const absolute = resolve(raw);
+    const { escapes, real } = fixtureEscapesRoot(absolute, root);
+    if (escapes)
+        throw fixtureOutsideProject(real === absolute ? absolute : `${absolute} (→ ${real})`, root);
+    let isFile = false;
+    try {
+        isFile = statSync(real).isFile();
+    }
+    catch {
+        // not there
+    }
+    if (!isFile)
+        throw fixtureNotFound(absolute, root);
+    let realRoot = resolve(root);
+    try {
+        realRoot = realpathSync(root);
+    }
+    catch {
+        // keep the lexical root
+    }
+    const sensitive = fixtureSensitiveReason(real, realRoot) ?? fixtureSensitiveReason(absolute, resolve(root));
+    if (sensitive !== null)
+        throw fixtureSensitive(absolute, root, sensitive);
+    return absolute;
+}
 function isRecord(v) {
     return v !== null && typeof v === "object" && !Array.isArray(v);
 }
@@ -302,10 +344,23 @@ const OPTION_SPEC = (params) => ({
     description: "",
     command: { path: "explore", params, omitted: {} },
 });
+/**
+ * Browser launch settings are per-sweep, never per-target: a run's browser is launched the same way
+ * for every target. Set them with the `sweep` command's own flag; a target's option is refused.
+ */
+const BROWSER_TARGET_OPTIONS = {
+    browserArg: "--browser-arg",
+    browserExecutable: "--browser-executable",
+    browserChannel: "--browser-channel",
+};
 /** A target's options as explore flags (typed and closed: an unknown option or a wrong type is a problem). */
 function optionArgvOf(options, where, problems) {
     const allowed = sweepTargetOptions();
-    const unknown = Object.keys(options).filter((k) => allowed[k] === undefined);
+    for (const [key, flag] of Object.entries(BROWSER_TARGET_OPTIONS)) {
+        if (options[key] !== undefined)
+            problems.push(`${where}: ${key} is not a per-target option — a sweep launches every run's browser the same way: pass ${flag} to \`jevitate sweep\``);
+    }
+    const unknown = Object.keys(options).filter((k) => allowed[k] === undefined && BROWSER_TARGET_OPTIONS[k] === undefined);
     if (unknown.length > 0) {
         problems.push(`${where}: unknown or not-allowed explore option(s) ${unknown.join(", ")} (a target may set: ${Object.keys(allowed).sort().join(", ")}; ` +
             "url/route, persona, strategy, goal and tags are their own fields)");
@@ -450,6 +505,19 @@ export function loadSweepTargets(path, opts = {}) {
         if ((effectiveStrategy === "goal" || effectiveStrategy === "usability") && typeof goal !== "string" && options.feature === undefined) {
             problems.push(`${where}: strategy ${effectiveStrategy} needs a goal${effectiveStrategy === "goal" ? " (or options.feature for a feature run)" : ""}`);
         }
+        if (typeof options.fixture === "string") {
+            try {
+                options.fixture = confineSweepFixture(options.fixture, opts.projectRoot ?? journeyFixtureBaseDir());
+            }
+            catch (err) {
+                if (!(err instanceof FixturePathError))
+                    throw err;
+                problems.push(`${where}: options.fixture ${JSON.stringify(options.fixture)} refused (${err.code}): ${err.message}`);
+                delete options.fixture;
+            }
+        }
+        else if (options.fixture !== undefined)
+            problems.push(`${where}: options.fixture must be a file path`);
         const optionArgv = optionArgvOf(options, where, problems);
         validateRunShaping(options, effectiveStrategy, where, problems);
         let tags = { ...defaultTags };