@jevitate/cli 0.12.0 → 0.13.0

package/dist/build-info.generated.js

@@ -5,6 +5,6 @@
 // this plain `tsc --build` dist (no bundler substitution), so it needs real committed values
 // here instead. See ./engine.ts, which prefers the esbuild-injected value when present and
 // falls back to these.
-export const GENERATED_COMMIT = "444f0b4";
-export const GENERATED_BUILT_AT = "2026-10-11T18:38:57.929Z";
+export const GENERATED_COMMIT = "98d84e3";
+export const GENERATED_BUILT_AT = "2026-10-12T13:40:54.217Z";
 //# sourceMappingURL=build-info.generated.js.map

package/dist/explore-cli/adversarial-strategy.d.ts

@@ -0,0 +1,3 @@
+import type { ExploreRunContext } from "./shared.js";
+/** `--strategy adversarial` (moved verbatim out of registerExploreCommands). */
+export declare function runAdversarialStrategy(ctx: ExploreRunContext): Promise<void>;

package/dist/explore-cli/adversarial-strategy.js

@@ -0,0 +1,99 @@
+import { MissingCredentialError } from "@jevitate/ai-core";
+import { ScopeUnderivableError, UnauthorizedExploreTargetError, resolveCoverageThresholds } from "@jevitate/explore";
+import { ok, fail } from "../envelope.js";
+import { runAdversarialCliMission, CLI_ADVERSARIAL_STRATEGIES, resolveExploreAllowlist } from "../explore-api.js";
+import { triagedServerLog } from "../explore-shared.js";
+import { GatewaySelectionError, buildExploreGateways } from "../cli-shared.js";
+/** `--strategy adversarial` (moved verbatim out of registerExploreCommands). */
+export async function runAdversarialStrategy(ctx) {
+    const { deps, o, emitExplore, strategy, target, browser, screenshotsOpt, emulation, overflow, withInvariants, serverLog, withPrefix, emitJourneyFailure, withEvidence, runFiling, issueFiler } = ctx;
+    if (!o.url) {
+        emitExplore(fail("E_EXPLORE_ARGS", "--url is required for --strategy adversarial"));
+        return;
+    }
+    const advAllowlist = resolveExploreAllowlist(o.url, o.allow);
+    let advJudge;
+    let advGen;
+    let advUsage;
+    try {
+        ({ judge: advJudge, gen: advGen, usage: advUsage } = await buildExploreGateways(deps, {
+            real: o.real ?? false,
+            fakeAi: o.fakeAi ?? false,
+            jevProvider: o.jevProvider,
+        }));
+    }
+    catch (err) {
+        if (err instanceof MissingCredentialError || err instanceof GatewaySelectionError) {
+            emitExplore(fail("E_AI_SETUP_REQUIRED", err.message));
+        }
+        else {
+            emitExplore(fail("E_EXPLORE_SETUP", String(err instanceof Error ? err.message : err)));
+        }
+        return;
+    }
+    let coverageThresholds;
+    try {
+        coverageThresholds = resolveCoverageThresholds({
+            ...(o.minControlCoverage === undefined ? {} : { minControlRatio: Number(o.minControlCoverage) }),
+            requireFormSubmit: o.requireFormSubmit,
+        });
+    }
+    catch (err) {
+        emitExplore(fail("E_EXPLORE_ARGS", String(err instanceof Error ? err.message : err)));
+        return;
+    }
+    const advBounds = {};
+    if (o.maxActions !== undefined)
+        advBounds.maxActions = Number(o.maxActions);
+    if (o.maxDecisions !== undefined)
+        advBounds.maxDecisions = Number(o.maxDecisions);
+    try {
+        const result = await runAdversarialCliMission({
+            ...(target === undefined ? {} : { target }),
+            ...(o.actionDeltas === true ? { actionDeltas: true } : {}),
+            seedUrl: o.url,
+            allowlist: advAllowlist,
+            usage: advUsage,
+            ...(o.route.length > 0 ? { routeGlobs: o.route } : {}),
+            coverageThresholds,
+            bounds: Object.keys(advBounds).length > 0 ? advBounds : undefined,
+            secrets: o.secret.length > 0 ? o.secret : undefined,
+            ...(runFiling === undefined ? {} : { filing: runFiling }),
+            issueFiler,
+            ...(o.hangReplays === undefined ? {} : { hangReplays: o.hangReplays }),
+            strategies: CLI_ADVERSARIAL_STRATEGIES,
+            judgment: advJudge,
+            generation: advGen,
+            browserPortFactory: deps.explore?.browserPortFactory,
+            browser,
+            ...screenshotsOpt,
+            ...(emulation === undefined ? {} : { emulation }),
+            overflow,
+            outDir: o.out,
+            ...(o.storageState !== undefined ? { storageState: o.storageState } : {}),
+            ...(o.saveStorageState !== undefined ? { saveStorageState: o.saveStorageState } : {}),
+            ...withInvariants,
+            ...triagedServerLog(serverLog, advJudge, o.real === true),
+            ...withPrefix,
+        });
+        // The typed verdict gates CI: 0 clean · 1 defects found (a failing check) · 2 the run
+        // itself broke (inconclusive/crashed) — see exit-codes.ts.
+        emitExplore(ok(await withEvidence(result)), result.exitCode);
+    }
+    catch (err) {
+        if (emitJourneyFailure(err))
+            return;
+        if (err instanceof UnauthorizedExploreTargetError) {
+            emitExplore(fail("E_UNAUTHORIZED_EXPLORE_TARGET", err.message));
+        }
+        else if (err instanceof ScopeUnderivableError) {
+            // #224: no default route scope from --url — a usage error (64), refused before any browser.
+            emitExplore(fail("E_EXPLORE_ARGS", err.message));
+        }
+        else {
+            emitExplore(fail("E_EXPLORE_RUN", String(err instanceof Error ? err.message : err)));
+        }
+    }
+    return;
+}
+//# sourceMappingURL=adversarial-strategy.js.map

package/dist/explore-cli/adversarial-strategy.js.map

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

package/dist/explore-cli/coverage-strategy.d.ts

@@ -0,0 +1,3 @@
+import type { ExploreRunContext } from "./shared.js";
+/** `--strategy coverage|exploratory` (moved verbatim out of registerExploreCommands). */
+export declare function runCoverageStrategy(ctx: ExploreRunContext<"coverage" | "exploratory">): Promise<void>;

package/dist/explore-cli/coverage-strategy.js

@@ -0,0 +1,95 @@
+import { MissingCredentialError } from "@jevitate/ai-core";
+import { ScopeUnderivableError, UnauthorizedExploreTargetError } from "@jevitate/explore";
+import { ok, fail } from "../envelope.js";
+import { runCoverageMission, resolveExploreAllowlist } from "../explore-api.js";
+import { triagedServerLog } from "../explore-shared.js";
+import { stallTimeoutMs, GatewaySelectionError, buildExploreGateways } from "../cli-shared.js";
+/** `--strategy coverage|exploratory` (moved verbatim out of registerExploreCommands). */
+export async function runCoverageStrategy(ctx) {
+    const { deps, o, emitExplore, strategy, target, browser, screenshotsOpt, emulation, overflow, withInvariants, serverLog, withPrefix, emitJourneyFailure, withEvidence } = ctx;
+    if (!o.url) {
+        emitExplore(fail("E_EXPLORE_ARGS", "--url is required"));
+        return;
+    }
+    if (o.scope !== undefined && o.scope !== "app") {
+        emitExplore(fail("E_EXPLORE_ARGS", `--scope must be "app" (got ${JSON.stringify(o.scope)})`));
+        return;
+    }
+    const covAllowlist = resolveExploreAllowlist(o.url, o.allow);
+    const covBounds = {};
+    if (o.maxActions !== undefined)
+        covBounds.maxActions = Number(o.maxActions);
+    if (o.maxDecisions !== undefined)
+        covBounds.maxDecisions = Number(o.maxDecisions);
+    // Scope containment (#89, reusing #64's model): the start URL's route plus --route globs;
+    // --scope app (or --route '/**') widens it to the whole app.
+    const covRouteGlobs = [...o.route, ...(o.scope === "app" ? ["/**"] : [])];
+    const covStall = stallTimeoutMs(o.stallTimeout);
+    if (covStall === null) {
+        emitExplore(fail("E_EXPLORE_ARGS", `--stall-timeout must be a positive number of seconds (got ${JSON.stringify(o.stallTimeout)})`));
+        return;
+    }
+    let covJudge;
+    let covGen;
+    let covUsage;
+    try {
+        ({ judge: covJudge, gen: covGen, usage: covUsage } = await buildExploreGateways(deps, {
+            real: o.real ?? false,
+            fakeAi: o.fakeAi ?? false,
+            jevProvider: o.jevProvider,
+        }));
+    }
+    catch (err) {
+        if (err instanceof MissingCredentialError || err instanceof GatewaySelectionError) {
+            emitExplore(fail("E_AI_SETUP_REQUIRED", err.message));
+        }
+        else {
+            emitExplore(fail("E_EXPLORE_SETUP", String(err instanceof Error ? err.message : err)));
+        }
+        return;
+    }
+    try {
+        const result = await runCoverageMission({
+            ...(target === undefined ? {} : { target }),
+            ...(o.actionDeltas === true ? { actionDeltas: true } : {}),
+            url: o.url,
+            allowlist: covAllowlist,
+            judge: covJudge,
+            gen: covGen,
+            usage: covUsage,
+            bounds: Object.keys(covBounds).length > 0 ? covBounds : undefined,
+            ...(covRouteGlobs.length > 0 ? { routeGlobs: covRouteGlobs } : {}),
+            strategy,
+            ...(covStall === undefined ? {} : { stallTimeoutMs: covStall }),
+            outDir: o.out,
+            browserPortFactory: deps.explore?.browserPortFactory,
+            browser,
+            ...screenshotsOpt,
+            ...(emulation === undefined ? {} : { emulation }),
+            overflow,
+            ...(o.storageState !== undefined ? { storageState: o.storageState } : {}),
+            ...(o.saveStorageState !== undefined ? { saveStorageState: o.saveStorageState } : {}),
+            ...withInvariants,
+            ...triagedServerLog(serverLog, covJudge, o.real === true),
+            ...withPrefix,
+        });
+        // Typed verdict → exit code (0 clean · 1 defects · 2 crashed; see exit-codes.ts).
+        emitExplore(ok(await withEvidence(result)), result.exitCode);
+    }
+    catch (err) {
+        if (emitJourneyFailure(err))
+            return;
+        if (err instanceof UnauthorizedExploreTargetError) {
+            emitExplore(fail("E_UNAUTHORIZED_EXPLORE_TARGET", err.message));
+        }
+        else if (err instanceof ScopeUnderivableError) {
+            // #224: no default route scope from --url — a usage error (64), refused before any browser.
+            emitExplore(fail("E_EXPLORE_ARGS", err.message));
+        }
+        else {
+            emitExplore(fail("E_EXPLORE_RUN", String(err instanceof Error ? err.message : err)));
+        }
+    }
+    return;
+}
+//# sourceMappingURL=coverage-strategy.js.map

package/dist/explore-cli/coverage-strategy.js.map

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

package/dist/explore-cli/feature-strategy.d.ts

@@ -0,0 +1,3 @@
+import type { ExploreRunContext } from "./shared.js";
+/** `--feature <name>` (moved verbatim out of registerExploreCommands). */
+export declare function runFeatureStrategy(ctx: ExploreRunContext): Promise<void>;

package/dist/explore-cli/feature-strategy.js

@@ -0,0 +1,59 @@
+import { ScopeUnderivableError, UnauthorizedExploreTargetError } from "@jevitate/explore";
+import { ok, fail } from "../envelope.js";
+import { runFeatureCliMission, resolveExploreAllowlist } from "../explore-api.js";
+import { stallTimeoutMs } from "../cli-shared.js";
+/** `--feature <name>` (moved verbatim out of registerExploreCommands). */
+export async function runFeatureStrategy(ctx) {
+    const { deps, emitExplore, target, browser, screenshotsOpt, emulation, withInvariants, withServerLog, withEvidence } = ctx;
+    const o = ctx.o;
+    if (!o.url) {
+        emitExplore(fail("E_EXPLORE_ARGS", "--url is required with --feature"));
+        return;
+    }
+    const featAllowlist = resolveExploreAllowlist(o.url, o.allow);
+    const featBounds = {};
+    if (o.maxActions !== undefined)
+        featBounds.maxActions = Number(o.maxActions);
+    if (o.maxDecisions !== undefined)
+        featBounds.maxDecisions = Number(o.maxDecisions);
+    const featStall = stallTimeoutMs(o.stallTimeout);
+    if (featStall === null) {
+        emitExplore(fail("E_EXPLORE_ARGS", `--stall-timeout must be a positive number of seconds (got ${JSON.stringify(o.stallTimeout)})`));
+        return;
+    }
+    try {
+        const result = await runFeatureCliMission({
+            ...(featStall === undefined ? {} : { stallTimeoutMs: featStall }),
+            seedUrl: o.url,
+            allowlist: featAllowlist,
+            capability: o.feature,
+            routeGlobs: o.route ?? [],
+            bounds: Object.keys(featBounds).length > 0 ? featBounds : undefined,
+            outDir: o.out,
+            browserPortFactory: deps.explore?.browserPortFactory,
+            browser,
+            ...screenshotsOpt,
+            ...(emulation === undefined ? {} : { emulation }),
+            ...(o.storageState !== undefined ? { storageState: o.storageState } : {}),
+            ...(o.saveStorageState !== undefined ? { saveStorageState: o.saveStorageState } : {}),
+            ...withInvariants,
+            ...withServerLog,
+            ...(target?.safety === undefined ? {} : { safety: target.safety }),
+        });
+        emitExplore(ok(await withEvidence(result)), result.exitCode);
+    }
+    catch (err) {
+        if (err instanceof UnauthorizedExploreTargetError) {
+            emitExplore(fail("E_UNAUTHORIZED_EXPLORE_TARGET", err.message));
+        }
+        else if (err instanceof ScopeUnderivableError) {
+            // #224: no default route scope from --url — a usage error (64), refused before any browser.
+            emitExplore(fail("E_EXPLORE_ARGS", err.message));
+        }
+        else {
+            emitExplore(fail("E_EXPLORE_RUN", String(err instanceof Error ? err.message : err)));
+        }
+    }
+    return;
+}
+//# sourceMappingURL=feature-strategy.js.map

package/dist/explore-cli/feature-strategy.js.map

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

package/dist/explore-cli/goal-strategy.d.ts

@@ -0,0 +1,3 @@
+import type { ExploreRunContext } from "./shared.js";
+/** The default goal strategy: `--url` + `--goal` (+ `--success`), with fixtures (moved verbatim out of registerExploreCommands). */
+export declare function runGoalStrategy(ctx: ExploreRunContext): Promise<void>;

package/dist/explore-cli/goal-strategy.js

@@ -0,0 +1,184 @@
+import { FixturePathError } from "@jevitate/recording";
+import { MissingCredentialError } from "@jevitate/ai-core";
+import { FixtureNotFoundError, UnauthorizedExploreTargetError } from "@jevitate/explore";
+import { ok, fail } from "../envelope.js";
+import { buildMissionFixtures, checkSetupRefs, checkUrlRefOrigin, substituteUrlSetupRefs, setupRefFreeUrl, invariantSetupTexts, substituteSpecSetupRefs, fixtureSetupFailedResult } from "../fixture-cli.js";
+import { FixtureSetupError, FixtureSpecError, UnboundSetupRefError, substituteSetupRefs } from "../mission-fixtures.js";
+import { withEngine } from "../engine.js";
+import { EXIT_CODES } from "../exit-codes.js";
+import { runExploration, parseSuccessSpec, resolveExploreAllowlist } from "../explore-api.js";
+import { triagedServerLog } from "../explore-shared.js";
+import { GatewaySelectionError, buildExploreGateways } from "../cli-shared.js";
+import { resolveJourneyPrefix } from "../journey-prefix.js";
+import { GoalRunFlagError, successWhenFromFlags } from "../goal-run-flags.js";
+/** The default goal strategy: `--url` + `--goal` (+ `--success`), with fixtures (moved verbatim out of registerExploreCommands). */
+export async function runGoalStrategy(ctx) {
+    const { deps, o, emitExplore, target, browser, screenshotsOpt, emulation, withInvariants, serverLog, emitJourneyFailure, withEvidence, runFiling, issueFiler, conversation, secretFields, secretCommand, actors, primaryStorageState, invariants, prefixRequest, typeFixtures } = ctx;
+    let { journeyPrefix } = ctx;
+    // --success may be omitted for a find-out goal (#130d): the run is then verified by a grounded
+    // `report` answer (#101) instead of an independent page/network check.
+    if (!o.url || !o.goal) {
+        emitExplore(fail("E_EXPLORE_ARGS", "--url and --goal are required"));
+        return;
+    }
+    let successChecks;
+    try {
+        successChecks = o.success.map(parseSuccessSpec);
+    }
+    catch (err) {
+        emitExplore(fail("E_EXPLORE_ASSERTION", String(err instanceof Error ? err.message : err)));
+        return;
+    }
+    let successWhen;
+    try {
+        successWhen = successWhenFromFlags(o);
+    }
+    catch (err) {
+        if (!(err instanceof GoalRunFlagError))
+            throw err;
+        emitExplore(fail(err.code, err.message));
+        return;
+    }
+    const allowlist = resolveExploreAllowlist(setupRefFreeUrl(o.url), o.allow);
+    // Fixtures (#140/#144): the spec and every ${setup.x} reference are validated here, before any
+    // browser or request; the setup itself runs just before the mission (below).
+    let fx;
+    try {
+        checkUrlRefOrigin(o.url);
+        fx = buildMissionFixtures(o, {
+            allowlist,
+            baseUrl: setupRefFreeUrl(o.url),
+            ...(primaryStorageState === undefined ? {} : { storageState: primaryStorageState }),
+            secretFields,
+            secrets: o.secret,
+            ...(target?.fixtures === undefined ? {} : { targetFixtures: target.fixtures }),
+            ...(target?.personas === undefined ? {} : { personas: target.personas }),
+        });
+        checkSetupRefs({ "--url": o.url, "--goal": o.goal, "--success": o.success, ...invariantSetupTexts(invariants), ...(journeyPrefix === undefined ? {} : { "--param": Object.values(o.param) }) }, fx);
+    }
+    catch (err) {
+        if (!(err instanceof FixtureSpecError || err instanceof UnboundSetupRefError))
+            throw err;
+        emitExplore(fail(err.code, err.message));
+        return;
+    }
+    const bounds = {};
+    if (o.maxActions !== undefined)
+        bounds.maxActions = Number(o.maxActions);
+    if (o.maxDecisions !== undefined)
+        bounds.maxDecisions = Number(o.maxDecisions);
+    let judge;
+    let gen;
+    let usage;
+    try {
+        ({ judge, gen, usage } = await buildExploreGateways(deps, { real: o.real ?? false, fakeAi: o.fakeAi ?? false, jevProvider: o.jevProvider }));
+    }
+    catch (err) {
+        if (err instanceof MissingCredentialError || err instanceof GatewaySelectionError) {
+            emitExplore(fail("E_AI_SETUP_REQUIRED", err.message));
+        }
+        else {
+            emitExplore(fail("E_EXPLORE_SETUP", String(err instanceof Error ? err.message : err)));
+        }
+        return;
+    }
+    let url = o.url;
+    let goal = o.goal;
+    let runInvariants = withInvariants;
+    if (fx !== undefined) {
+        // Never run the mission on unknown state: a failed setup ends the run inconclusive (a
+        // configuration error), after restoring whatever the partial setup created.
+        try {
+            await fx.setup();
+            const b = fx.bindings();
+            url = substituteUrlSetupRefs(o.url, b);
+            goal = substituteSetupRefs(o.goal, b, { where: "--goal" });
+            successChecks = o.success.map((spec) => parseSuccessSpec(substituteSetupRefs(spec, b, { where: "--success" })));
+            // #187: ${setup.x} in the invariants (probe paths, deniedAs.open, capture routes), origin-fixed.
+            if (invariants !== undefined)
+                runInvariants = { ...withInvariants, invariants: substituteSpecSetupRefs(invariants, b, url) };
+            // #399: `--param name=${setup.x}` for the Journey prefix is bound to the fixture's output, and the
+            // prefix re-resolved so its secret params (and so every redaction) hold the bound value.
+            if (journeyPrefix !== undefined && prefixRequest !== undefined && Object.values(o.param).some((v) => v.includes("${setup."))) {
+                const params = Object.fromEntries(Object.entries(o.param).map(([k, v]) => [k, substituteSetupRefs(v, b, { where: `--param ${k}` })]));
+                journeyPrefix = await resolveJourneyPrefix({ ...prefixRequest, params });
+                o.secret = [...new Set([...o.secret, ...journeyPrefix.secrets])];
+            }
+        }
+        catch (err) {
+            if (!(err instanceof FixtureSetupError || err instanceof UnboundSetupRefError)) {
+                await fx.restore();
+                throw err;
+            }
+            await fx.restore();
+            emitExplore(ok(withEngine(fixtureSetupFailedResult(err, fx))), EXIT_CODES.inconclusive);
+            return;
+        }
+    }
+    try {
+        const result = await runExploration({
+            ...(target === undefined ? {} : { target }),
+            url,
+            goal,
+            successChecks,
+            ...(successWhen === undefined ? {} : { successWhen }),
+            ...(o.allowVacuousChecks === true ? { allowVacuousChecks: true } : {}),
+            ...(o.actionDeltas === true ? { actionDeltas: true } : {}),
+            allowlist,
+            judge,
+            gen,
+            usage,
+            bounds: Object.keys(bounds).length > 0 ? bounds : undefined,
+            ...(o.minActions === undefined && o.minDistinctStates === undefined
+                ? {}
+                : {
+                    minEffort: {
+                        ...(o.minActions === undefined ? {} : { minActions: Number(o.minActions) }),
+                        ...(o.minDistinctStates === undefined ? {} : { minDistinctStates: Number(o.minDistinctStates) }),
+                    },
+                }),
+            secrets: o.secret.length > 0 ? o.secret : undefined,
+            ...(secretFields.length > 0 ? { secretFields } : {}),
+            ...(secretCommand === undefined ? {} : { secretCommand }),
+            ...(o.secretCmdAttempts === undefined ? {} : { secretCommandAttempts: o.secretCmdAttempts }),
+            ...(typeFixtures.length > 0 ? { typeFixtures } : {}),
+            fixture: o.fixture,
+            outDir: o.out,
+            browserPortFactory: deps.explore?.browserPortFactory,
+            browser,
+            ...screenshotsOpt,
+            ...(emulation === undefined ? {} : { emulation }),
+            ...(primaryStorageState !== undefined ? { storageState: primaryStorageState } : {}),
+            ...(o.saveStorageState !== undefined ? { saveStorageState: o.saveStorageState } : {}),
+            ...(actors === null ? {} : { actors }),
+            ...(runFiling === undefined ? {} : { filing: runFiling }),
+            issueFiler,
+            ...(o.hangReplays === undefined ? {} : { hangReplays: o.hangReplays }),
+            conversation,
+            ...runInvariants,
+            ...triagedServerLog(serverLog, judge, o.real === true),
+            ...(fx === undefined ? {} : { fixtures: fx }),
+            ...(journeyPrefix === undefined ? {} : { journeyPrefix }), // #399: re-resolved when a --param was bound
+        });
+        // 0 succeeded · 1 assertion not met · 2 the run broke (inconclusive/crashed).
+        emitExplore(ok(await withEvidence(result)), result.exitCode);
+    }
+    catch (err) {
+        if (emitJourneyFailure(err))
+            return;
+        if (err instanceof UnauthorizedExploreTargetError) {
+            emitExplore(fail("E_UNAUTHORIZED_EXPLORE_TARGET", err.message));
+        }
+        else if (err instanceof FixtureNotFoundError || err instanceof FixturePathError) {
+            emitExplore(fail("E_EXPLORE_FIXTURE", err.message));
+        }
+        else {
+            emitExplore(fail("E_EXPLORE_RUN", String(err instanceof Error ? err.message : err)));
+        }
+    }
+    finally {
+        // Every exit path restores the fixture state (a no-op when the mission already did).
+        await fx?.restore();
+    }
+}
+//# sourceMappingURL=goal-strategy.js.map

package/dist/explore-cli/goal-strategy.js.map

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

package/dist/explore-cli/options.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+/** The `jevitate explore` command and every flag it takes (moved verbatim out of registerExploreCommands). */
+export declare function declareExploreCommand(program: Command): Command;