@jevitate/cli 0.1.0 → 0.2.0

package/dist/explore-goal.js

@@ -0,0 +1,374 @@
+// explore-goal.ts — the goal-directed explore runner (`runExploration`) and its goal-only helpers (#231).
+import { sessionLostReason } from "./session-check.js";
+import { logsDirFor } from "./project-dir.js";
+import { join, resolve as resolvePath } from "node:path";
+import { PlaywrightBrowserPort, resolveEmulation } from "@jevitate/playwright";
+import { closeOnce, demoOverlayOf, finalizeVideos, runVideoDir, sessionLaunchOptions } from "./browser-run-options.js";
+import { runCaptureFor } from "./run-screenshots.js";
+import { evidenceOf, withRunEvidence } from "./defect-evidence.js";
+import { CastActor, BrowseTheWeb } from "@jevitate/screenplay";
+import { runGoalBasedMission, assertAuthorizedExploreTarget, resolveMissionFixture, Http5xxOracle, secretFieldSecrets } from "@jevitate/explore";
+import { conversationConfig } from "./conversation-options.js";
+import { foldGoalOutcome } from "@jevitate/domain";
+import { draftForCrash, draftForHang } from "@jevitate/explore";
+import { processIssueDrafts } from "./findings-filing.js";
+import { currentEngineInfo } from "./engine.js";
+import { MissionJournal, artifactStamp, closeQuietly, resultPathFor, writeMissionResult } from "./mission-journal.js";
+import { MISSION_RESULT_SCHEMA_VERSION, unifiedDefects } from "./result-schema.js";
+import { applyHttp5xxGoalOutcome, describeHttp5xx, http5xxGoalReason } from "./http-5xx-outcome.js";
+import { goalExitCode } from "./mission-exit.js";
+import { launchArmed } from "./launch-armed.js";
+import { finishHostHealth } from "./host-health-run.js";
+import { openServerLogRuntime } from "./log-correlation.js";
+import { fixtureReplayOpener, recordingFixture } from "./mission-fixtures.js";
+import { observerSessions, persistedActors } from "./mission-actors.js";
+import { serverLogResult, recordingEmulation, DRAFTS_ONLY, NO_FILER, draftContext, freshSessionOpener, currentUrlSafe, assertSaveStorageStateOutsideProject, persistStorageState, browserVersionOf, declaredResult } from "./explore-shared.js";
+/** Outcomes that already mean the run itself broke or hung — a server-log finding never downgrades
+ *  (or, for the oracle-unreadable case, elevates) one of these; they already prove more, or the same. */
+const BROKEN_GOAL_OUTCOMES = new Set(["inconclusive", "crashed", "hang", "intermittent"]);
+/**
+ * Folds a server-log correlation result into the goal mission's own `GoalBasedOutcome` (#142): a
+ * found `server-log` defect makes an otherwise-not-broken run `defects-found`; an unreadable
+ * `--log-defect` oracle turns an otherwise-`succeeded` run `inconclusive` — mirrors
+ * `applyServerLogOutcome` (the `MissionOutcome` version the other three builders use), but
+ * `GoalBasedOutcome` has its own extra values (`succeeded`/`exhausted`/`blocked`).
+ */
+function applyServerLogGoalOutcome(outcome, run) {
+    if (run === undefined)
+        return outcome;
+    if (run.defects.length > 0 && !BROKEN_GOAL_OUTCOMES.has(outcome))
+        return "defects-found";
+    if (!run.summary.oracleOk && outcome === "succeeded")
+        return "inconclusive";
+    return outcome;
+}
+/** One-line reason for a server-log-driven outcome change (`reason` is unset otherwise for `succeeded`). */
+function serverLogOutcomeReason(newOutcome, run) {
+    if (newOutcome === "defects-found") {
+        const n = run?.defects.length ?? 0;
+        return `${n} server-log defect${n === 1 ? "" : "s"} found (--log-defect)`;
+    }
+    // #169: the summary already knows WHICH source(s) made the oracle unhealthy and why (failed to
+    // open vs. declared but silent) — this default only covers the (should-be-unreachable) case of no
+    // summary at all.
+    return (run?.summary.oracleReason ??
+        "the --log-defect oracle could not run: every declared --log-source failed to open or read a line — an absence of server-log defects proves nothing");
+}
+/** Outcomes whose `reason` describes a UI-side blocker worth pairing with a correlated server cause. */
+const BLOCKED_LIKE_OUTCOMES = new Set(["blocked", "exhausted", "failed", "inconclusive"]);
+const SERVER_CAUSE_MAX_CHARS = 160;
+/**
+ * The most informative correlated server-log line attached to the LAST transcript step (#165's
+ * "Also" — the step the run ended on is the one whose UI blocker `mission.reason` already
+ * describes): an `error` line wins over a `warn` one; ties keep the first (arrival order). `undefined`
+ * when `--log-source` was not given, or nothing warn/error-level attached to that step.
+ */
+function lastStepServerCause(transcript) {
+    const logs = transcript?.[transcript.length - 1]?.serverLogs;
+    if (logs === undefined || logs.length === 0)
+        return undefined;
+    let line;
+    for (const l of logs) {
+        if (l.level !== "error" && l.level !== "warn")
+            continue;
+        if (line === undefined || (line.level !== "error" && l.level === "error"))
+            line = l;
+    }
+    if (line === undefined)
+        return undefined;
+    const body = line.message.length > SERVER_CAUSE_MAX_CHARS ? `${line.message.slice(0, SERVER_CAUSE_MAX_CHARS)}…` : line.message;
+    return `${line.level}${line.target === undefined ? "" : ` ${line.target}`} ${quote(body)}`;
+}
+function quote(s) {
+    return `"${s}"`;
+}
+/**
+ * Pairs an already-computed UI-side `reason` with the correlated server cause on the step the run
+ * ended on (#165 "Also"): `"<UI reason>; server: <level> \"<message>\""`. A no-op when there is no
+ * `reason` to pair with, the outcome isn't one of blocked/exhausted/inconclusive (a `defects-found`
+ * or an oracle-unhealthy `inconclusive` already gets its own `serverLogOutcomeReason`), or no
+ * server-log evidence attached to that step — including when `--log-source` was never given.
+ */
+export function withServerCause(reason, outcome, transcript) {
+    if (reason === undefined || !BLOCKED_LIKE_OUTCOMES.has(outcome))
+        return reason;
+    const cause = lastStepServerCause(transcript);
+    return cause === undefined ? reason : `${reason}; server: ${cause}`;
+}
+export async function runExploration(opts) {
+    // Guardrail #1 — authorize BEFORE opening a browser. Throws on refusal.
+    const origin = assertAuthorizedExploreTarget(opts.url, opts.allowlist);
+    assertSaveStorageStateOutsideProject(opts.saveStorageState);
+    // Fail fast on a missing fixture BEFORE launching Chromium.
+    const fixture = opts.fixture === undefined ? undefined : await resolveMissionFixture(opts.fixture);
+    // A bound secret (or TOTP seed) is a run secret too: kept out of the issue drafts as well. So is a
+    // declared probe's resolved auth token (#135) — redacted everywhere a run secret is, not only in
+    // the invariant monitor's own evidence.
+    const authTokenValues = [...(opts.invariantAuthTokens?.values() ?? [])];
+    const bound = [...secretFieldSecrets(opts.secretFields), ...(opts.fixtures?.secrets() ?? []), ...authTokenValues];
+    const secrets = opts.secrets === undefined && bound.length === 0 ? undefined : [...(opts.secrets ?? []), ...bound];
+    // The state the mission starts from — replays restore THIS fixture and rebind its recorded outputs.
+    const fx = opts.fixtures;
+    const missionFixture = fx === undefined ? undefined : { record: fx.record(), persisted: fx.persisted() };
+    // #149: refused BEFORE any browser opens (an unknown --device, or --viewport + --device together).
+    const resolvedEmulation = resolveEmulation(opts.emulation);
+    if (opts.actors !== undefined && opts.storageState !== undefined && resolvePath(opts.storageState) !== opts.actors.primary.storageState) {
+        throw new Error("runExploration: storageState must be the primary actor's own");
+    }
+    const primaryState = opts.actors?.primary.storageState ?? opts.storageState;
+    // #250/#251: a recorded or screenshotted run's sessions carry the live pixel mask from their first
+    // paint; `--screenshots` captures after each step (the Recording path names their folder).
+    const capture = runCaptureFor({
+        recordsVideo: opts.browser?.recordVideo !== undefined,
+        screenshots: opts.screenshots,
+        secrets: secrets ?? [],
+        artifactPath: () => journal.recordingPath,
+        title: `goal: ${opts.goal}`,
+    });
+    const portFactory = capture.wrap(opts.browserPortFactory ?? (() => new PlaywrightBrowserPort()));
+    const port = portFactory();
+    const outDir = opts.outDir ?? logsDirFor();
+    const iso = (opts.nowIso ?? (() => new Date().toISOString()))();
+    // Crash-safe: the transcript and partial Recording are flushed after every step. `MissionJournal`
+    // itself creates `outDir` synchronously (mkdirSync).
+    const journal = new MissionJournal(join(outDir, `explore-${artifactStamp(iso)}.json`));
+    // #245: every session this run opens (mission, observers, hang replays) is shown/recorded alike.
+    const videoDir = runVideoDir(opts.browser, journal.recordingPath);
+    const shown = sessionLaunchOptions(opts.browser, videoDir);
+    const launch = {
+        ...shown,
+        allowedOrigins: [...opts.allowlist],
+        baseUrl: origin,
+        ...opts.emulation,
+        ...(primaryState !== undefined ? { storageState: primaryState } : {}),
+    };
+    // Crash-safe on SIGTERM/SIGINT too (#94): a partial `inconclusive` result is written from
+    // whatever the journal has already flushed, and the process exits with the conventional code.
+    // #163: this run's own share of a (possibly shared) tracker: its usage and sidecar.
+    const runUsage = opts.usage?.scope();
+    // #226: the kill switch is armed BEFORE the host sampler and the browser launch (see launch-armed.ts).
+    const { disarmKillSwitch, health, session, snapshotter } = await launchArmed({
+        hostHealth: opts.hostHealth,
+        saveStorageState: opts.saveStorageState !== undefined,
+        open: () => port.open(launch),
+        mission: (hooks) => ({
+            // #220: the killed run's partial result carries the unified schema's common fields too.
+            strategy: "goal",
+            target: { seedUrl: opts.url, allowlist: [...opts.allowlist], ...(primaryState !== undefined ? { storageStatePath: resolvePath(primaryState) } : {}) },
+            recordingPath: journal.recordingPath,
+            hostHealth: hooks.hostHealth,
+            transcriptPath: journal.transcriptPath,
+            transcript: () => journal.transcript,
+            ...(videoDir === undefined ? {} : { videoDir }),
+            ...(runUsage === undefined ? {} : { usage: runUsage }),
+            ...(opts.saveStorageState === undefined ? {} : { storageState: { path: opts.saveStorageState, snapshot: hooks.snapshot } }),
+        }),
+    });
+    // #208: the shared HTTP 5xx hard signal, listening from before the first navigation.
+    const http5xx = new Http5xxOracle(session.page, { allowlist: opts.allowlist });
+    // #147: each observer in its OWN fresh context (only its own storageState), opened on first use.
+    const observers = opts.actors === undefined || opts.actors.observers.length === 0
+        ? undefined
+        : observerSessions(portFactory, { ...shown, allowedOrigins: [...opts.allowlist], baseUrl: origin }, opts.actors.observers);
+    // Backend log correlation (#142): opened BEFORE the mission runs so its window covers the seed
+    // load too; a no-op (`undefined`) when `--log-source` was not given.
+    const serverLog = openServerLogRuntime({
+        sources: opts.serverLog?.sources ?? [],
+        logDefect: opts.serverLog?.logDefect ?? [],
+        quietOk: opts.serverLog?.quietOk ?? [],
+        logIgnore: opts.serverLog?.logIgnore ?? [],
+        ...(opts.serverLog?.drainMs === undefined ? {} : { drainMs: opts.serverLog.drainMs }),
+        secrets: secrets ?? [],
+        onTranscriptEntry: journal.onTranscriptEntry,
+    });
+    // #159: every settled step also refreshes the in-memory storageState snapshot (cheap no-op when
+    // `--save-storage-state` was not given — `snapshotter.noteSettledStep` checks `enabled` itself).
+    const onTranscriptEntry = (entry, all) => {
+        capture.noteEntry(session.page, entry);
+        health.noteStep(entry);
+        http5xx.noteStep(entry);
+        (serverLog?.onTranscriptEntry ?? journal.onTranscriptEntry)(entry, all);
+        snapshotter.noteSettledStep(currentUrlSafe(session));
+    };
+    // #159/#245: persisted and closed once — early (before the result is written) when recording video.
+    const closeSession = closeOnce(async () => {
+        await persistStorageState(session, opts.saveStorageState, snapshotter);
+        await closeQuietly(session);
+    });
+    try {
+        const actor = CastActor.named("explorer").whoCan(new BrowseTheWeb(session, [...opts.allowlist]));
+        const mission = await runGoalBasedMission({
+            ...(opts.target?.timing === undefined ? {} : { timingConfig: opts.target.timing }),
+            ...(opts.target?.settle === undefined ? {} : { settle: opts.target.settle }),
+            ...(opts.target?.hangs === undefined ? {} : { hangs: opts.target.hangs }),
+            ...(opts.target?.safety === undefined ? {} : { safety: opts.target.safety }),
+            // A hang is reproduced by replaying its steps in fresh contexts (same auth, same fixture state).
+            openFreshSession: fx === undefined || missionFixture === undefined
+                ? freshSessionOpener(portFactory, launch, opts.allowlist)
+                : fixtureReplayOpener(freshSessionOpener(portFactory, launch, opts.allowlist), fx, missionFixture.record.outputs),
+            ...(opts.hangReplays === undefined ? {} : { hangReplays: opts.hangReplays }),
+            onTranscriptEntry,
+            onRecording: journal.onRecording,
+            actor,
+            judge: opts.judge,
+            gen: opts.gen,
+            goal: opts.goal,
+            allowlist: opts.allowlist,
+            startUrl: opts.url,
+            ...(opts.successAssertion === undefined ? {} : { successAssertion: opts.successAssertion }),
+            ...(opts.successChecks === undefined ? {} : { successChecks: opts.successChecks }),
+            ...(opts.successWhen === undefined ? {} : { successWhen: opts.successWhen }),
+            ...(opts.allowVacuousChecks === true ? { allowVacuousChecks: true } : {}),
+            bounds: opts.bounds,
+            secrets,
+            ...(opts.secretFields === undefined ? {} : { secretFields: opts.secretFields }),
+            site: origin,
+            fixture,
+            ...conversationConfig(opts.conversation),
+            ...(opts.invariants === undefined ? {} : { invariants: opts.invariants }),
+            ...(opts.invariantAuthTokens === undefined ? {} : { invariantAuthTokens: opts.invariantAuthTokens }),
+            ...(observers === undefined ? {} : { observers }),
+            ...(opts.actors === undefined ? {} : { primaryActor: opts.actors.primary.name }),
+            hostHealth: health,
+            demoOverlay: demoOverlayOf(opts.browser),
+        });
+        await observers?.close();
+        // The mission (and its hang replays) is done: restore now, so the persisted log includes it. The
+        // caller restores again on every exit path (a no-op once restored).
+        await fx?.restore();
+        const recording = {
+            ...mission.recording,
+            ...(missionFixture === undefined ? {} : { fixture: recordingFixture(missionFixture.record) }),
+            ...(resolvedEmulation === undefined ? {} : { emulation: recordingEmulation(resolvedEmulation) }),
+        };
+        // Never blocks the mission itself: the drain wait happens AFTER `runGoalBasedMission` returned.
+        const serverLogRun = serverLog === undefined ? undefined : await serverLog.finish(mission.transcript);
+        // #142 follow-up: a found server-log defect counts as `defects-found` (exit 1); an unreadable
+        // `--log-defect` oracle turns an otherwise-`succeeded` run `inconclusive` (exit 2) — never clean.
+        const loggedOutcome = applyServerLogGoalOutcome(mission.outcome, serverLogRun);
+        // #208: an HTTP 5xx is a hard-signal defect — `defects-found` even when the goal's checks held.
+        const httpDefects = http5xx.defects(mission.transcript, mission.recording.pages.flatMap((p) => p.steps)[0]?.step.kind === "navigate" ? 1 : 0);
+        const hardOutcome = applyHttp5xxGoalOutcome(loggedOutcome, httpDefects);
+        // #203: most steps on a starved host → `inconclusive` (degraded-environment), never a pass/fail.
+        // #213: a starved `failed` goal keeps the check that did not hold in its degraded reason.
+        const host = await finishHostHealth(health, hardOutcome, {
+            ...(hardOutcome === mission.outcome && (mission.failure?.message ?? mission.reason) !== undefined
+                ? { wouldHaveBeen: mission.failure?.message ?? mission.reason }
+                : {}),
+        });
+        const goalOutcome = host.outcome;
+        journal.writeRecording(recording);
+        journal.writeTranscript(serverLogRun?.transcript ?? mission.transcript);
+        const engine = currentEngineInfo();
+        const ctx = draftContext(origin, journal, secrets ?? [], browserVersionOf(session.page), engine);
+        const resultPath = resultPathFor(journal.recordingPath);
+        const drafts = [];
+        if (mission.run.crash !== undefined)
+            drafts.push(draftForCrash(mission.run.crash, mission.transcript, ctx));
+        if (mission.hang !== undefined) {
+            drafts.push(draftForHang(mission.hang, {
+                ...ctx,
+                verifyCommand: `jevitate verify-fix --result ${resultPath} --fingerprint ${mission.hang.fingerprint}`,
+            }));
+        }
+        const issues = await processIssueDrafts(journal.recordingPath, drafts, opts.filing ?? DRAFTS_ONLY, opts.issueFiler ?? NO_FILER, iso);
+        // #245: every context closed (videos finalized) before the result naming them is written.
+        const shotFields = await capture.finish();
+        const videos = await finalizeVideos(videoDir, closeSession);
+        const result = {
+            schemaVersion: MISSION_RESULT_SCHEMA_VERSION,
+            strategy: "goal",
+            missionOutcome: foldGoalOutcome(goalOutcome),
+            goalOutcome,
+            issues,
+            timing: mission.run.timing,
+            outcome: goalOutcome,
+            runOutcome: mission.run.outcome,
+            ...(mission.run.answer === undefined ? {} : { answer: mission.run.answer }),
+            assertionPassed: mission.assertionPassed,
+            checks: mission.checks,
+            ...(mission.warnings === undefined ? {} : { checkWarnings: mission.warnings }),
+            ...(() => {
+                const lost = sessionLostReason({
+                    target: primaryState === undefined ? {} : { storageStatePath: resolvePath(primaryState) },
+                    transcript: serverLogRun?.transcript ?? mission.transcript,
+                });
+                return lost === undefined ? {} : { sessionLost: { reason: lost } };
+            })(),
+            stop: mission.run.stop,
+            finalUrl: mission.finalUrl,
+            decisions: mission.run.decisions,
+            actions: mission.run.actions,
+            recordingPaths: [journal.recordingPath],
+            recordingPath: journal.recordingPath,
+            ...videos,
+            ...shotFields,
+            transcriptPath: journal.transcriptPath,
+            transcript: serverLogRun?.transcript ?? mission.transcript,
+            exitCode: goalExitCode(goalOutcome),
+            resultPath,
+            target: {
+                seedUrl: opts.url,
+                allowlist: [...opts.allowlist],
+                ...(primaryState !== undefined ? { storageStatePath: resolvePath(primaryState) } : {}),
+                ...(opts.actors === undefined ? {} : { actors: persistedActors(opts.actors) }),
+            },
+            recording,
+            hangs: mission.hang === undefined ? [] : [mission.hang],
+            ...(mission.intermittentHangs === undefined ? {} : { intermittentHangs: mission.intermittentHangs }),
+            ...(mission.run.crash === undefined ? {} : { crash: mission.run.crash }),
+            // #180: the declared budgets' observed trajectory, whatever the outcome (a hang included).
+            ...(mission.budget === undefined ? {} : { budget: mission.budget }),
+            sideEffects: mission.run.sideEffects,
+            ...(mission.run.sideEffectsTruncated === undefined ? {} : { sideEffectsTruncated: mission.run.sideEffectsTruncated }),
+            engine,
+            ...(fx === undefined || missionFixture === undefined
+                ? {}
+                : {
+                    fixtures: {
+                        ...missionFixture.record,
+                        cycles: fx.record().cycles,
+                        log: fx.record().log,
+                        ...(missionFixture.persisted.spec === undefined ? {} : { spec: missionFixture.persisted.spec }),
+                        ...(missionFixture.persisted.hooks === undefined ? {} : { hooks: missionFixture.persisted.hooks }),
+                    },
+                }),
+            // #209: a goal-specific miss (`success-check-failed`, `vacuous-check`) is typed too — after an
+            // engine failure or a starved host, which explain the run before the check does.
+            ...(() => {
+                const f = mission.run.failure ?? host.failure ?? mission.failure;
+                return f === undefined ? {} : { failure: f };
+            })(),
+            ...(host.failure !== undefined
+                ? { reason: host.failure.message }
+                : goalOutcome === mission.outcome
+                    ? (() => {
+                        const reason = withServerCause(mission.reason, goalOutcome, serverLogRun?.transcript);
+                        // #208: a broken run keeps its outcome, but its reason still names the server error.
+                        const withHttp = httpDefects.length === 0 ? reason : `${reason ?? goalOutcome}; HTTP 5xx: ${describeHttp5xx(httpDefects)}`;
+                        return withHttp === undefined ? {} : { reason: withHttp };
+                    })()
+                    : loggedOutcome === mission.outcome
+                        ? { reason: http5xxGoalReason(httpDefects, mission.assertionPassed) }
+                        : { reason: serverLogOutcomeReason(goalOutcome, serverLogRun) }),
+            ...declaredResult(opts.invariants, mission.invariantDefects, mission.invariants),
+            ...(runUsage === undefined ? {} : { usage: runUsage.snapshot() }),
+            ...serverLogResult(serverLogRun),
+            defects: unifiedDefects([...(opts.invariants === undefined ? [] : (mission.invariantDefects ?? [])), ...httpDefects], serverLogRun?.defects),
+            ...host.fields,
+        };
+        // Persisted so `verify-fix` can replay a hang later (the typed result next to the Recording).
+        writeMissionResult(journal.recordingPath, result.missionOutcome, result.exitCode, result, runUsage);
+        return await withRunEvidence(result, evidenceOf(opts, secrets ?? []));
+    }
+    finally {
+        disarmKillSwitch();
+        health.stop();
+        // Safety net: if the mission threw before `serverLog.finish()` ran, close sources immediately
+        // (no drain wait) rather than leaving them open until process exit.
+        await serverLog?.abort();
+        await observers?.close().catch(() => undefined);
+        await closeSession();
+    }
+}
+//# sourceMappingURL=explore-goal.js.map

package/dist/explore-goal.js.map

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

package/dist/explore-shared.d.ts

@@ -0,0 +1,152 @@
+import type { JudgmentPort, GenerationPort, CredentialKey, UsageTracker } from "@jevitate/ai-core";
+import { type BrowserPort } from "@jevitate/playwright";
+import { type InvariantSpec, type RecordingEmulation } from "@jevitate/recording";
+import type { InvariantDefect, InvariantReport } from "@jevitate/explore";
+import { type DraftContext, type VerifySession } from "@jevitate/explore";
+import { type FilingConfig, type IssueFilerPort } from "@jevitate/domain";
+import { type EngineInfo } from "./engine.js";
+import { MissionJournal } from "./mission-journal.js";
+import { StorageStateSnapshotter } from "./storage-state-snapshot.js";
+import { type ServerLogDefect, type ServerLogsSummary } from "./log-correlation.js";
+import type { LogSourceSpec } from "./log-sources.js";
+import type { LogDefectMatcher, LogIgnoreMatcher } from "./log-lines.js";
+/**
+ * Backend log correlation (#142): already-validated `--log-source`/`--log-defect` specs, threaded
+ * into every mission-type builder below the same way `invariants` is. `undefined`/empty ⇒ no
+ * sources ⇒ `openServerLogRuntime` is a complete no-op (existing runs pay nothing).
+ */
+export interface ServerLogOptions {
+    readonly sources: readonly LogSourceSpec[];
+    readonly logDefect: readonly LogDefectMatcher[];
+    readonly allowLogCmd?: boolean;
+    readonly drainMs?: number;
+    /** Raw `--log-source` specs (`--log-quiet-ok`, #169) allowed to deliver zero lines without making
+     *  `serverLogs.oracleOk` false — for a source the operator KNOWS is legitimately quiet. */
+    readonly quietOk?: readonly string[];
+    /** Already-parsed `--log-ignore` matchers (#169 item 3): known-noise lines excluded from
+     *  correlation and the defect oracle. */
+    readonly logIgnore?: readonly LogIgnoreMatcher[];
+}
+export declare function serverLogResult(runtimeResult: {
+    summary: ServerLogsSummary;
+    defects: ServerLogDefect[];
+} | undefined): {
+    serverLogs?: ServerLogsSummary;
+    serverLogDefects?: ServerLogDefect[];
+};
+/**
+ * Overflow/emulation CLI flags shared by every strategy (#149): `emulation` is validated and
+ * resolved by `PlaywrightBrowserPort.open` itself (an unknown device or --viewport+--device
+ * together refuses BEFORE any browser opens); `overflow` gates and configures the horizontal-
+ * overflow hard signal (coverage only, for now).
+ */
+export interface OverflowFlags {
+    readonly checkOverflow?: boolean;
+    readonly toleranceCss?: number;
+    readonly ignoreSelectors?: readonly string[];
+}
+/** The viewport/device emulation actually applied to a session — recorded on the Recording (#149). */
+export declare function recordingEmulation(resolved: {
+    viewport: {
+        width: number;
+        height: number;
+    };
+    device?: string;
+    deviceScaleFactor?: number;
+    isMobile?: boolean;
+    hasTouch?: boolean;
+} | undefined): RecordingEmulation | undefined;
+/** Filing is off by default: drafts only, never a tracker call. */
+export declare const DRAFTS_ONLY: FilingConfig;
+export declare const NO_FILER: () => IssueFilerPort;
+export declare function draftContext(origin: string, journal: MissionJournal, secrets: readonly string[], browserVersion: string | undefined, engine: EngineInfo): DraftContext;
+/**
+ * Opens a FRESH browser session for replays (hang reproduction): a new context from the same port
+ * and options — same authenticated storageState, never the session the finding was made in.
+ */
+export declare function freshSessionOpener(portFactory: () => BrowserPort, launch: Parameters<BrowserPort["open"]>[0], allowlist: readonly string[]): () => Promise<VerifySession>;
+/** `session.page.url()`, or `undefined` when reading it throws (a closed/crashed page/context). */
+export declare function currentUrlSafe(session: {
+    page: {
+        url(): string;
+    };
+}): string | undefined;
+/**
+ * Writes the browser context's storageState (cookies + origin storage) to `file` when the caller
+ * asked for one (CLI `--save-storage-state`, #82) — so a rotating refresh token stays usable across
+ * runs instead of the `--storage-state` file it started from going stale on first use. Called from
+ * every mission's `finally`, so a thrown error still reaches it (#159) — the context is still open at
+ * that point, whatever failed inside the mission itself. A no-op when `file` is undefined.
+ *
+ * #159 — never persists a lost/logged-out session over a good file: when the CURRENT page looks
+ * login-like (`isLoginLikeUrl`, the #82 signal), a live capture is skipped in favor of `snapshotter`'s
+ * last known-good in-memory snapshot (refreshed after each settled step — see
+ * `storage-state-snapshot.ts` — and itself never updated from a login-like page, so it always holds
+ * the most recent GOOD state). The same fallback covers a live capture that simply fails (a
+ * crashed/closed context after the page url could still be read). If neither a safe live capture nor
+ * a snapshot is available, nothing is written — any existing file at `file` is left untouched. There
+ * is no flag today for an operator to force the write anyway; see `saveStorageState`'s own doc.
+ *
+ * The file holds live session credentials: written with mode 0600 (owner read/write only), and its
+ * contents are never logged either way.
+ */
+/**
+ * #195: refused BEFORE a browser opens — a `saveStorageState` inside a repo's `.jevitate/` (which
+ * never holds sessions or secrets). `persistStorageState` re-checks at the write itself.
+ */
+export declare function assertSaveStorageStateOutsideProject(file: string | undefined): void;
+export declare function persistStorageState(session: {
+    page: {
+        url(): string;
+    };
+    saveStorageState(file: string): Promise<void>;
+}, file: string | undefined, snapshotter?: StorageStateSnapshotter): Promise<void>;
+export declare function browserVersionOf(page: {
+    context(): {
+        browser(): {
+            version(): string;
+        } | null;
+    };
+}): string | undefined;
+/** The adversarial outcome plus where its Recording and decision transcript were written. */
+/** Where a mission ran — enough for `verify-fix` to replay one of its defects in a fresh session. */
+export interface MissionTarget {
+    readonly seedUrl: string;
+    readonly allowlist: string[];
+    /** Absolute path of the storageState file the run started from (never its contents). */
+    readonly storageStatePath?: string;
+    /** #147: every actor's name, role and storageState PATH (never its contents) — for verify-fix. */
+    readonly actors?: ReadonlyArray<{
+        readonly name: string;
+        readonly storageStatePath: string;
+        readonly role: "primary" | "observer";
+    }>;
+}
+/**
+ * The declared-invariant fields of a persisted result (#86): the defects (top-level `defects`, where
+ * `verify-fix` looks), the per-invariant report, and the spec itself so a later `verify-fix`
+ * re-checks exactly what the run checked. Nothing at all when the run had no `--invariants`.
+ */
+export declare function declaredResult(spec: InvariantSpec | undefined, defects: readonly InvariantDefect[] | undefined, report: readonly InvariantReport[] | undefined): {
+    defects?: InvariantDefect[];
+    invariants?: InvariantReport[];
+    invariantSpec?: InvariantSpec;
+};
+/** Injectable wiring for the `explore` CLI command (all optional). */
+export interface ExploreCliDeps {
+    /** Injected issue filer (tests use a fake — nothing real is ever filed from a test). */
+    issueFiler?: () => IssueFilerPort;
+    /** Injected filing config file path (tests). Default `~/.jevitate/filing.json`. */
+    filingConfigPath?: string;
+    /** Injected per-target config file path (tests). Default `~/.jevitate/targets.json`. */
+    targetsConfigPath?: string;
+    /** Injected judgment gateway (tests). */
+    judge?: JudgmentPort;
+    /** Injected generation gateway (tests). */
+    gen?: GenerationPort;
+    /** Injected usage tracker (tests): injected gateways that record into it report known costs (#163). */
+    usage?: UsageTracker;
+    browserPortFactory?: () => BrowserPort;
+    env?: Record<string, string | undefined>;
+    localConfig?: Partial<Record<CredentialKey, string>>;
+}