niceeval 0.12.2-canary.31 → 0.13.1

package/dist/cli.cjs

@@ -19,11 +19,12 @@ exports.experimentRenameExitCode = experimentRenameExitCode;
 //   niceeval exp [组|配置] [pattern]    跑实验
 //   niceeval debug <配置> <eval>        只规划一个配对的 Sandbox / Plugin lifecycle
 //   niceeval accept @<locator>...       接受多条历史结果并重锚到当前配置
-//   niceeval show [selection]        终端渲染一次固定的 ReportExecution
+//   niceeval show [selection]        终端渲染固定 Sample 的一个目标 Page
 //   niceeval list                    只列出发现到的 eval
 //   niceeval clean [--record <root>] [--yes]    删除未完成 Run
 //   niceeval migrate [--record <root>] [--yes]  显式迁移 Record
 const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
 const node_os_1 = require("node:os");
 const promises_1 = require("node:fs/promises");
 const node_fs_1 = require("node:fs");
@@ -31,22 +32,25 @@ const node_path_1 = require("node:path");
 const node_util_1 = require("node:util");
 const effect_1 = require("effect");
 const attempt_locator_ts_1 = require("./attempt-locator.cjs");
-const discover_ts_1 = require("./runner/discover.cjs");
 const aggregate_ts_1 = require("./shared/aggregate.cjs");
-const run_ts_1 = require("./runner/run.cjs");
-const fingerprint_ts_1 = require("./runner/fingerprint.cjs");
+const index_ts_1 = require("./experiment/host/index.cjs");
 const project_current_ts_1 = require("./runner/project-current.cjs");
-const index_ts_1 = require("./record/index.cjs");
-const index_ts_2 = require("./analysis/index.cjs");
+const index_ts_2 = require("./record/index.cjs");
+const identifiers_ts_1 = require("./record/codec/identifiers.cjs");
 const attempt_overview_ts_1 = require("./report/built-in/attempt-overview.cjs");
 const overview_ts_1 = require("./report/built-in/overview.cjs");
 const run_membership_overview_ts_1 = require("./report/built-in/run-membership-overview.cjs");
 const execution_ts_1 = require("./report/built-in/execution.cjs");
 const source_ts_1 = require("./report/built-in/source.cjs");
-const identity_ts_1 = require("./report/author/identity.cjs");
+const model_ts_1 = require("./report/execution/model.cjs");
+const from_record_ts_1 = require("./report/host/from-record.cjs");
+const execute_ts_1 = require("./report/host/execute.cjs");
+const paths_ts_1 = require("./report/execution/paths.cjs");
 const index_ts_3 = require("./report/host/index.cjs");
+const panel_ts_1 = require("./report/model/panel.cjs");
+const progress_ts_1 = require("./report/host/progress.cjs");
+const static_ts_1 = require("./report/host/static.cjs");
 const node_ts_1 = require("./report/host/node.cjs");
-const server_ts_1 = require("./view/server.cjs");
 const record_ts_1 = require("./cli/record.cjs");
 const eval_selection_ts_1 = require("./runner/eval-selection.cjs");
 const registry_ts_1 = require("./sandbox/registry.cjs");
@@ -57,15 +61,12 @@ const experiment_cleanup_registry_ts_1 = require("./runner/experiment-cleanup-re
 const lock_ts_1 = require("./runner/lock.cjs");
 const gate_lease_ts_1 = require("./runner/gate-lease.cjs");
 const cleanup_timeout_ts_1 = require("./runner/cleanup-timeout.cjs");
+const report_view_cache_ts_1 = require("./view/report-view-cache.cjs");
 const timeout_ts_1 = require("./runner/timeout.cjs");
-const record_ts_2 = require("./runner/record.cjs");
-const reuse_readback_ts_1 = require("./runner/reuse-readback.cjs");
 const teardown_registry_ts_1 = require("./runner/teardown-registry.cjs");
 const rename_experiment_ts_1 = require("./runner/rename-experiment.cjs");
 const verdict_ts_1 = require("./shared/verdict.cjs");
-const facts_ts_1 = require("./shared/facts.cjs");
 const sandbox_selection_ts_1 = require("./runner/sandbox-selection.cjs");
-const plan_ts_2 = require("./sandbox/plan.cjs");
 const json_ts_1 = require("./runner/reporters/json.cjs");
 const index_ts_4 = require("./runner/feedback/index.cjs");
 const index_ts_5 = require("./i18n/index.cjs");
@@ -112,14 +113,28 @@ function renderCliFailure(failure) {
     if (isReportCliOperation(failure.operation)) {
         const code = failureCode(failure.cause);
         if (code !== undefined) {
-            const reason = failure.cause instanceof node_ts_1.ReportModuleLoadError ? `: ${failure.cause.reason}` : "";
-            return `${code}${reason}\n`;
+            if (failure.cause instanceof node_ts_1.ReportModuleLoadError) {
+                return `${code}: ${failure.cause.reason}\n`;
+            }
+            const reason = stringProperty(failure.cause, "reason");
+            const operation = stringProperty(failure.cause, "operation");
+            if (reason !== undefined) {
+                const stage = operation === undefined ? "" : `${operation}: `;
+                const retry = code === "report-view-server-failed" && operation === "listen"
+                    ? "\nChoose another port with --port <port>, or stop the process already listening there."
+                    : "";
+                return `${code}: ${stage}${reason}${retry}\n`;
+            }
+            return `${code}\n`;
         }
     }
     return (0, index_ts_5.t)("cli.error", { error: (0, util_ts_1.formatThrown)(failure.cause) });
 }
 function isReportCliOperation(operation) {
-    return operation === "execute report from Record" ||
+    return operation === "load trusted Report config" ||
+        operation === "load trusted Report module" ||
+        operation === "load trusted Theme module" ||
+        operation === "execute report from Record" ||
         operation === "render Report show output" ||
         operation === "open report view session" ||
         operation === "open report view" ||
@@ -169,7 +184,7 @@ const FLAG_OPTIONS = {
     tag: { type: "string" },
     /** 额外写一份 JUnit XML 报告到指定路径,供 CI 消费。 */
     junit: { type: "string" },
-    /** `exp` 运行在 stdout 输出单一有序的 NDJSON 事件流；`exp --dry` 与 `debug` 输出各自的单个 JSON 计划文档。`show` 输出同一 ReportExecution 的宿主数据与状态，不打开第二条取数路径。 */
+    /** `exp` 运行在 stdout 输出单一有序的 NDJSON 事件流；`exp --dry` 与 `debug` 输出各自的单个 JSON 计划文档。`show` 输出 Host 拥有的内建或自定义单目标机器文档，不形成完整站点或打开第二条取数路径。 */
     json: { type: "boolean" },
     /** `docker profile doctor` 专用：启动受限 DinD 容器并运行内层容器。 */
     smoke: { type: "boolean" },
@@ -421,7 +436,7 @@ function parseArgs(argv) {
 function projectCurrentDryPlan(input) {
     return Object.freeze({
         slots: Object.freeze(input.slots.map(projectCurrentDryPlanSlot)),
-        readbacks: Object.freeze(input.readbacks.map(reuse_readback_ts_1.projectCurrentReuseReadback)),
+        readbacks: Object.freeze([...input.readbacks]),
     });
 }
 function projectCurrentDryPlanSlot(slot) {
@@ -557,8 +572,6 @@ function firstViewerOnlyFlag(flags) {
         return { flag: "--stats", command: SHOW };
     if (flags.experiment !== undefined)
         return { flag: "--experiment", command: BOTH };
-    if (flags.record !== undefined)
-        return { flag: "--record", command: BOTH };
     if (flags.report !== undefined)
         return { flag: "--report", command: BOTH };
     if (flags.theme !== undefined)
@@ -691,8 +704,7 @@ function parseAcceptLocators(positionals, flags) {
 /** 调用 acceptance core；CLI 只负责 cwd/记录根边界、输出与退出码，不重建结果或启动 runner。 */
 function runAcceptCommand(cwd, locators, recordRoot) {
     return effect_1.Effect.gen(function* () {
-        const mod = (yield* cliPromise("load acceptance command", () => __niceevalDynamicImport("./runner/accept.cjs")));
-        const results = yield* cliEffect("accept locators", mod.acceptLocators({
+        const results = yield* cliEffect("accept locators", index_ts_1.experimentHost.accept({
             cwd,
             locators,
             ...(recordRoot !== undefined ? { recordRoot } : {}),
@@ -1289,12 +1301,6 @@ function agentRunFromExperiment(experiment, selectedEvalIds, overrides = {}) {
         classifyFailure: experiment.classifyFailure,
     };
 }
-function uniqueExactOrPrefix(candidates, selector) {
-    const exact = candidates.find((candidate) => candidate.id === selector);
-    return exact === undefined
-        ? candidates.filter((candidate) => candidate.id.startsWith(selector))
-        : [exact];
-}
 function renderDebugPlanJson(input) {
     return `${JSON.stringify({
         format: "niceeval.debug-plan/v1",
@@ -1311,89 +1317,68 @@ function runDebugCommand(cwd, positionals, flags) {
             return 1;
         }
         const [experimentSelector, evalSelector] = positionals;
-        const config = yield* loadConfig(cwd);
-        const evals = yield* cliEffect("discover evals for lifecycle debug", (0, discover_ts_1.discoverEvals)(cwd));
-        const experiments = yield* cliEffect("discover experiments for lifecycle debug", (0, discover_ts_1.discoverExperiments)(cwd));
-        const experimentIds = experiments.map((experiment) => experiment.id);
-        const matchedExperiments = uniqueExactOrPrefix(experiments, experimentSelector)
-            .slice()
-            .sort((left, right) => left.id.localeCompare(right.id));
-        if (matchedExperiments.length === 0) {
-            yield* writeStderr((0, index_ts_5.t)("cli.debug.experimentNoMatch", {
-                selector: experimentSelector,
-                candidates: [...experimentIds].sort().join(", ") || (0, index_ts_5.t)("cli.none"),
-            }));
-            return 1;
-        }
-        if (matchedExperiments.length > 1) {
-            yield* writeStderr((0, index_ts_5.t)("cli.debug.experimentAmbiguous", {
-                selector: experimentSelector,
-                candidates: matchedExperiments.map((experiment) => experiment.id).join(", "),
-            }));
-            return 1;
-        }
-        const experiment = matchedExperiments[0];
-        const { selectorEvals } = (0, eval_selection_ts_1.resolveExperimentEvals)({
-            experimentId: experiment.id,
-            selector: experiment.evals,
-            cliPatterns: [],
-            evals,
-        });
-        const matchedEvals = uniqueExactOrPrefix(selectorEvals, evalSelector)
-            .slice()
-            .sort((left, right) => left.id.localeCompare(right.id));
-        if (matchedEvals.length === 0) {
-            yield* writeStderr((0, index_ts_5.t)("cli.debug.evalNoMatch", {
-                selector: evalSelector,
-                experimentId: experiment.id,
-                candidates: selectorEvals.map((evalDef) => evalDef.id).sort().join(", ") || (0, index_ts_5.t)("cli.none"),
-            }));
-            return 1;
-        }
-        if (matchedEvals.length > 1) {
-            yield* writeStderr((0, index_ts_5.t)("cli.debug.evalAmbiguous", {
-                selector: evalSelector,
-                experimentId: experiment.id,
-                candidates: matchedEvals.map((evalDef) => evalDef.id).join(", "),
-            }));
-            return 1;
-        }
-        const evalDef = matchedEvals[0];
-        const run = agentRunFromExperiment(experiment, [evalDef.id]);
-        const prepared = yield* cliEffect("plan sandbox lifecycle debug", (0, sandbox_selection_ts_1.prepareRunSandboxes)(evals, [run], (0, plan_ts_2.liveSandboxPlanningServices)(), {
-            ...(config.timeoutMs === undefined ? {} : { configTimeoutMs: config.timeoutMs }),
+        const result = yield* cliEffect("debug Experiment lifecycle", index_ts_1.experimentHost.debug({
+            cwd,
+            experimentSelector,
+            evalSelector,
         }));
-        const commandPlan = (0, index_ts_4.assembleCommandPlan)({
-            rows: [{
-                    experimentId: experiment.id,
-                    evalId: evalDef.id,
-                    ...(evalDef.evalGroup === undefined ? {} : { evalGroupId: evalDef.evalGroup.id }),
-                    attempts: run.attempts,
-                    dispatch: [{ attempts: Array.from({ length: run.attempts }, (_, attempt) => attempt) }],
-                }],
-            preparedPairsByKey: (0, sandbox_selection_ts_1.preparedPairsByKey)(prepared),
-        });
-        yield* writeStdout(flags.json
-            ? renderDebugPlanJson({ experimentId: experiment.id, evalId: evalDef.id, commandPlan })
-            : (0, index_ts_4.renderHumanCommandPlan)(commandPlan, {
-                isTTY: process.stdout.isTTY,
-                noColor: process.env.NO_COLOR,
-                width: process.stdout.columns,
-            }));
-        return 0;
+        switch (result.status) {
+            case "experiment-no-match":
+                yield* writeStderr((0, index_ts_5.t)("cli.debug.experimentNoMatch", {
+                    selector: result.selector,
+                    candidates: result.candidates.join(", ") || (0, index_ts_5.t)("cli.none"),
+                }));
+                return 1;
+            case "experiment-ambiguous":
+                yield* writeStderr((0, index_ts_5.t)("cli.debug.experimentAmbiguous", {
+                    selector: result.selector,
+                    candidates: result.candidates.join(", "),
+                }));
+                return 1;
+            case "eval-no-match":
+                yield* writeStderr((0, index_ts_5.t)("cli.debug.evalNoMatch", {
+                    selector: result.selector,
+                    experimentId: result.experimentId,
+                    candidates: result.candidates.join(", ") || (0, index_ts_5.t)("cli.none"),
+                }));
+                return 1;
+            case "eval-ambiguous":
+                yield* writeStderr((0, index_ts_5.t)("cli.debug.evalAmbiguous", {
+                    selector: result.selector,
+                    experimentId: result.experimentId,
+                    candidates: result.candidates.join(", "),
+                }));
+                return 1;
+            case "planned":
+                yield* writeStdout(flags.json
+                    ? renderDebugPlanJson(result)
+                    : (0, index_ts_4.renderHumanCommandPlan)(result.commandPlan, {
+                        isTTY: process.stdout.isTTY,
+                        noColor: process.env.NO_COLOR,
+                        width: process.stdout.columns,
+                    }));
+                return 0;
+        }
     });
 }
 function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
     return effect_1.Effect.gen(function* () {
+        // Keep project-local coordination (sessions, locks, kept sandboxes) separate
+        // from the portable Record root selected by `--record` below.
+        const coordinationRoot = (0, node_path_1.resolve)(cwd, ".niceeval");
         const config = yield* loadConfig(cwd);
         const maxBuildConcurrency = flags.maxBuildConcurrency ?? config.maxBuildConcurrency ?? 2;
         if (!Number.isInteger(maxBuildConcurrency) || maxBuildConcurrency <= 0) {
             yield* writeStderr(`maxBuildConcurrency must be a positive integer, got ${maxBuildConcurrency}.\n`);
             return 1;
         }
-        const allEvals = yield* cliEffect("discover evals", (0, discover_ts_1.discoverEvals)(cwd));
-        const evals = flags.tag ? allEvals.filter((evalDefinition) => evalDefinition.tags?.includes(flags.tag)) : allEvals;
+        let evals = Object.freeze([]);
         if (command === "list") {
+            const listed = yield* cliEffect("list evals", index_ts_1.experimentHost.list({
+                cwd,
+                ...(flags.tag === undefined ? {} : { tag: flags.tag }),
+            }));
+            evals = listed.evals;
             yield* writeStdout((0, index_ts_5.t)("cli.list.header", { count: evals.length }));
             for (const evalDefinition of evals) {
                 yield* writeStdout(`  ${evalDefinition.id}${evalDefinition.description ? `  — ${evalDefinition.description}` : ""}\n`);
@@ -1412,35 +1397,36 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
                 yield* writeStderr((0, index_ts_5.t)("cli.exp.forceUnsupported"));
                 return 1;
             }
+            // `--record` selects the fact root for `exp`; `check` has no Record
+            // reader or writer, so accepting it there would silently discard input.
+            if (command === "check" && flags.record !== undefined) {
+                yield* writeStderr((0, index_ts_5.t)("cli.check.recordUnsupported"));
+                return 1;
+            }
             const viewerFlag = firstViewerOnlyFlag(flags);
             if (viewerFlag) {
                 yield* writeStderr((0, index_ts_5.t)("cli.exp.viewerFlagUnsupported", { flag: viewerFlag.flag, command: viewerFlag.command }));
                 return 1;
             }
-            const experiments = yield* cliEffect("discover experiments", (0, discover_ts_1.discoverExperiments)(cwd));
             if (command === "exp" && positionals[0] === "list") {
                 if (positionals.length > 2) {
                     yield* writeStderr("niceeval exp list accepts at most one experiment prefix.\n");
                     return 1;
                 }
                 const selector = positionals[1];
-                const ids = experiments.map((experiment) => experiment.id);
-                const selectedIds = selector === undefined ? new Set(ids) : new Set((0, aggregate_ts_1.matchExperimentSelector)(ids, selector));
-                const selected = experiments.filter((experiment) => selectedIds.has(experiment.id));
-                if (selected.length === 0 && selector !== undefined) {
+                const listed = yield* cliEffect("list experiments", index_ts_1.experimentHost.list({
+                    cwd,
+                    ...(flags.tag === undefined ? {} : { tag: flags.tag }),
+                    ...(selector === undefined ? {} : { selector }),
+                }));
+                if (listed.selections.length === 0 && selector !== undefined) {
                     yield* writeStderr((0, index_ts_5.t)("cli.experiment.noMatch", {
                         arg: selector,
-                        experiments: (0, aggregate_ts_1.browsableExperimentPaths)(ids).join(", ") || (0, index_ts_5.t)("cli.none"),
+                        experiments: (0, aggregate_ts_1.browsableExperimentPaths)(listed.experimentIds).join(", ") || (0, index_ts_5.t)("cli.none"),
                     }));
                     return 1;
                 }
-                const rows = selected.map((experiment) => {
-                    const { selectedEvalIds } = (0, eval_selection_ts_1.resolveExperimentEvals)({
-                        experimentId: experiment.id,
-                        selector: experiment.evals,
-                        cliPatterns: [],
-                        evals,
-                    });
+                const rows = listed.selections.map(({ experiment, selectedEvalIds }) => {
                     return {
                         experimentId: experiment.id,
                         ...(experiment.description !== undefined ? { description: experiment.description } : {}),
@@ -1473,9 +1459,15 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
             const expArg = positionals[0];
             const extraPatterns = positionals.slice(1);
             experimentSelection = positionals.join(" ") || (0, index_ts_5.t)("cli.all");
-            availableExperimentPaths = (0, aggregate_ts_1.browsableExperimentPaths)(experiments.map((experiment) => experiment.id)).join(", ") || (0, index_ts_5.t)("cli.none");
-            const selectedIds = expArg === undefined ? undefined : new Set((0, aggregate_ts_1.matchExperimentSelector)(experiments.map((experiment) => experiment.id), expArg));
-            const selected = selectedIds === undefined ? experiments : experiments.filter((experiment) => selectedIds.has(experiment.id));
+            const listed = yield* cliEffect("select experiments", index_ts_1.experimentHost.list({
+                cwd,
+                ...(flags.tag === undefined ? {} : { tag: flags.tag }),
+                ...(expArg === undefined ? {} : { selector: expArg }),
+                ...(extraPatterns.length === 0 ? {} : { evalPatterns: extraPatterns }),
+            }));
+            evals = listed.evals;
+            const selected = listed.selections;
+            availableExperimentPaths = (0, aggregate_ts_1.browsableExperimentPaths)(listed.experimentIds).join(", ") || (0, index_ts_5.t)("cli.none");
             if (selected.length === 0) {
                 yield* writeStderr((0, index_ts_5.t)("cli.experiment.noMatch", {
                     arg: expArg ?? (0, index_ts_5.t)("cli.all"),
@@ -1495,7 +1487,9 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
             const orphans = yield* (0, cli_commands_ts_1.orphanReminderEffect)(cwd).pipe(effect_1.Effect.catchAll(() => effect_1.Effect.succeed(undefined)));
             if (orphans)
                 yield* writeStderr(orphans);
-            const teardownReminder = yield* (0, teardown_registry_ts_1.orphanedTeardownReminderEffect)((0, node_path_1.resolve)(cwd, ".niceeval"), new Set(selected.filter((experiment) => experiment.teardown).map((experiment) => experiment.id)), (0, node_os_1.hostname)()).pipe(effect_1.Effect.catchAll(() => effect_1.Effect.succeed(undefined)));
+            const teardownReminder = yield* (0, teardown_registry_ts_1.orphanedTeardownReminderEffect)(coordinationRoot, new Set(selected
+                .filter(({ experiment }) => experiment.teardown)
+                .map(({ experiment }) => experiment.id)), (0, node_os_1.hostname)()).pipe(effect_1.Effect.catchAll(() => effect_1.Effect.succeed(undefined)));
             if (teardownReminder)
                 yield* writeStderr(teardownReminder);
             if (flags.teardown) {
@@ -1503,24 +1497,17 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
                     yield* writeStderr((0, index_ts_5.t)("cli.exp.teardownNoEvalPatterns"));
                     return 1;
                 }
-                const niceevalRootForTeardown = (0, node_path_1.resolve)(cwd, ".niceeval");
+                const niceevalRootForTeardown = coordinationRoot;
                 let anyFailed = false;
-                for (const experiment of selected) {
+                for (const { experiment, selectedEvalIds } of selected) {
                     if (!experiment.teardown)
                         continue;
-                    const { selectedEvalIds } = (0, eval_selection_ts_1.resolveExperimentEvals)({
-                        experimentId: experiment.id,
-                        selector: experiment.evals,
-                        cliPatterns: [],
-                        evals,
-                    });
                     const ctx = {
                         experimentId: experiment.id,
                         selectedEvalIds,
                         signal: new AbortController().signal,
                         progress: () => { },
                         diagnostic: (input) => process.stderr.write(`${input.message}\n`),
-                        fact: (key, value) => (0, facts_ts_1.recordFact)({}, key, value),
                     };
                     const registrations = yield* (0, teardown_registry_ts_1.readTeardownRegistrationsEffect)(niceevalRootForTeardown).pipe(effect_1.Effect.catchAll(() => effect_1.Effect.succeed([])));
                     const matching = registrations.filter(({ entry }) => entry.experimentId === experiment.id);
@@ -1546,15 +1533,9 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
                 return anyFailed ? 1 : 0;
             }
             const experimentScopeIds = new Set();
-            for (const experiment of selected) {
-                const { selectedEvalIds, selectorEvals } = (0, eval_selection_ts_1.resolveExperimentEvals)({
-                    experimentId: experiment.id,
-                    selector: experiment.evals,
-                    cliPatterns: extraPatterns,
-                    evals,
-                });
-                for (const evalDefinition of selectorEvals)
-                    experimentScopeIds.add(evalDefinition.id);
+            for (const { experiment, selectedEvalIds, selectorEvalIds } of selected) {
+                for (const evalId of selectorEvalIds)
+                    experimentScopeIds.add(evalId);
                 agentRuns.push(agentRunFromExperiment(experiment, selectedEvalIds, flags));
             }
             for (const pattern of extraPatterns) {
@@ -1569,10 +1550,18 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
             }
         }
         else {
-            const experiments = yield* cliEffect("discover experiments", (0, discover_ts_1.discoverExperiments)(cwd));
-            const ids = experiments.map((experiment) => experiment.id);
-            const matchedIds = new Set(positionals.flatMap((pattern) => (0, aggregate_ts_1.matchExperimentSelector)(ids, pattern)));
-            const asExp = experiments.filter((experiment) => matchedIds.has(experiment.id));
+            const listed = yield* cliEffect("list experiments", index_ts_1.experimentHost.list({
+                cwd,
+                ...(flags.tag === undefined ? {} : { tag: flags.tag }),
+            }));
+            const selectedByPattern = yield* effect_1.Effect.all(positionals.map((selector) => cliEffect("select experiments", index_ts_1.experimentHost.list({
+                cwd,
+                ...(flags.tag === undefined ? {} : { tag: flags.tag }),
+                selector,
+            }))));
+            const asExp = [...new Map(selectedByPattern
+                    .flatMap((selection) => selection.selections)
+                    .map(({ experiment }) => [experiment.id, experiment])).values()];
             yield* writeStderr((0, index_ts_5.t)("cli.run.experimentRequired"));
             if (asExp.length > 0) {
                 yield* writeStderr((0, index_ts_5.t)("cli.run.experimentRequiredHint", {
@@ -1582,7 +1571,7 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
             }
             else {
                 yield* writeStderr((0, index_ts_5.t)("cli.run.experimentRequiredKnown", {
-                    experiments: experiments.map((experiment) => experiment.id).join(", ") || (0, index_ts_5.t)("cli.none"),
+                    experiments: listed.experimentIds.join(", ") || (0, index_ts_5.t)("cli.none"),
                 }));
             }
             return 1;
@@ -1604,33 +1593,29 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
             yield* writeStdout(`Sandbox layers linked: ${pairCount} pair${pairCount === 1 ? "" : "s"}.\n`);
             return 0;
         }
-        const targetPlan = yield* cliEffect("plan current ProjectTarget", (0, fingerprint_ts_1.planProjectTarget)(evals, agentRuns, config.timeoutMs, {
-            configJudge: config.judge,
-            keepSandbox: flags.keepSandbox,
+        const recordTarget = yield* effect_1.Effect.try({
+            try: () => parseActualRecordRoot(cwd, flags.record),
+            catch: (cause) => cliFailure("parse experiment Record root", cause),
+        });
+        const experimentPlan = yield* cliEffect("plan Experiment", index_ts_1.experimentHost.plan({
+            evals,
+            agentRuns,
+            config,
+            recordRoot: recordTarget.root,
+            ...(flags.rerun === undefined ? {} : { rerun: flags.rerun }),
+            ...(flags.keepSandbox === undefined ? {} : { keepSandbox: flags.keepSandbox }),
+            ...(flags.dry ? { previewStartedAt: Date.now() } : {}),
         }));
+        const targetPlan = experimentPlan.target;
         if (flags.dry) {
-            const reuse = yield* cliEffect("prepare current Record reuse", (0, record_ts_2.prepareRunnerRecordReuse)({
-                evals,
-                runs: agentRuns,
-                config: { timeoutMs: config.timeoutMs },
-                plannedFingerprints: targetPlan.plannedFingerprints,
-                plannedConfigHashes: targetPlan.plannedConfigHashes,
-                rerun: flags.rerun,
-                keepSandbox: flags.keepSandbox,
-            }));
-            const currentPlan = yield* cliEffect("preview current Record reuse", (0, record_ts_2.withRunnerCurrentReusePreview)({
-                niceevalRoot: (0, node_path_1.resolve)(cwd, ".niceeval"),
-                startedAt: Date.now(),
-                evals,
-                runs: agentRuns,
-                reuse,
-                // `readReadbacks` is deliberately consumed and projected before this
-                // callback returns, while the exact frozen Record capability is live.
-                use: ({ reusePlan, readReadbacks }) => readReadbacks().pipe(effect_1.Effect.map((readbacks) => projectCurrentDryPlan({ slots: reusePlan.slots, readbacks }))),
-            }));
+            const current = experimentPlan.current;
+            if (current === undefined) {
+                return yield* effect_1.Effect.fail(cliFailure("preview Experiment", new Error("Experiment Host did not return the requested dry plan.")));
+            }
+            const currentPlan = projectCurrentDryPlan(current);
             const rows = currentDryPlanRows(currentPlan);
             const now = Date.now();
-            const lockedFlags = yield* effect_1.Effect.all(rows.map((row) => (0, lock_ts_1.readCaseLockEffect)((0, node_path_1.resolve)(cwd, ".niceeval"), row.experimentId, row.evalId).pipe(effect_1.Effect.catchAll(() => effect_1.Effect.succeed(undefined)), effect_1.Effect.map((lock) => lock !== undefined && !(0, lock_ts_1.isCaseLockExpired)(lock, now)))), { concurrency: "unbounded" });
+            const lockedFlags = yield* effect_1.Effect.all(rows.map((row) => (0, lock_ts_1.readCaseLockEffect)(coordinationRoot, row.experimentId, row.evalId).pipe(effect_1.Effect.catchAll(() => effect_1.Effect.succeed(undefined)), effect_1.Effect.map((lock) => lock !== undefined && !(0, lock_ts_1.isCaseLockExpired)(lock, now)))), { concurrency: "unbounded" });
             const evalGroupsByEvalId = new Map(evals.flatMap((evalDef) => evalDef.evalGroup === undefined ? [] : [[evalDef.id, {
                         ...evalDef.evalGroup,
                         index: evalDef.evalGroup.evalIds.indexOf(evalDef.id),
@@ -1686,7 +1671,7 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
         const renderer = outputForm === "human"
             ? (0, index_ts_4.createHumanRenderer)({ io, command: commandLabel })
             : (0, index_ts_4.createJsonRenderer)({ io });
-        const sessionTracker = new session_ts_1.SessionTracker((0, node_path_1.resolve)(cwd, ".niceeval"));
+        const sessionTracker = new session_ts_1.SessionTracker(coordinationRoot);
         const coordinator = (0, index_ts_4.createFeedbackCoordinator)({
             profile: outputForm,
             renderer,
@@ -1729,7 +1714,7 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
                 },
             },
         });
-        // This synchronous hand-off and the following `runEvals` yield have no
+        // This synchronous hand-off and the following Experiment Host yield have no
         // asynchronous gap. A first signal therefore either interrupts the root
         // before dispatch begins, or aborts this Invocation so it can close its
         // durable interrupted receipt before the CLI returns.
@@ -1739,7 +1724,7 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
         // Runner remains Effect-native. During graceful dispatch the application
         // edge translates SIGINT into this Invocation signal, letting dispatch
         // settle and the receipt close before the process exits with 130.
-        const receipt = yield* cliEffect("run evaluations", (0, run_ts_1.runEvals)({
+        const receipt = yield* cliEffect("run Experiment", index_ts_1.experimentHost.run({
             config,
             evals,
             agentRuns,
@@ -1748,7 +1733,8 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
             maxBuildConcurrency,
             keepSandbox: flags.keepSandbox,
             rerun: flags.rerun,
-            niceevalRoot: (0, node_path_1.resolve)(cwd, ".niceeval"),
+            coordinationRoot,
+            recordRoot: recordTarget.root,
             session: sessionTracker,
             onCurrentRecordReusePlan: (current) => effect_1.Effect.sync(() => coordinator.start({
                 ...plan,
@@ -1769,6 +1755,18 @@ function runEvaluationCommand(cwd, command, positionals, flags, interruption) {
         return (0, index_ts_4.computeExitCode)({ ...summary, failed: foldedStats.failed, errored: foldedStats.errored }, completion);
     });
 }
+/** Resolve the CLI's one portable Record target without treating `.niceeval` as Record data. */
+function parseActualRecordRoot(cwd, rootText) {
+    if (rootText !== undefined && rootText.trim() === "") {
+        throw usageError("--record requires an actual Record root directory.\n");
+    }
+    const rootPath = (0, node_path_1.resolve)(cwd, rootText ?? ".niceeval/record");
+    const root = (0, index_ts_2.makeRecordRoot)(rootPath);
+    if (effect_1.Either.isLeft(root)) {
+        throw usageError(`Invalid --record root: ${root.left.code}.\n`);
+    }
+    return Object.freeze({ root: root.right, rootPath });
+}
 /**
  * The CLI validates selection identity before Record I/O. It never turns a
  * prefix, a path, or a directory entry into a Run / Experiment selection.
@@ -1779,15 +1777,7 @@ function parseReportCliRequest(input) {
         throw usageError(`niceeval ${input.command} does not accept ${unsupported}.\n`);
     }
     const runs = input.flags.run ?? [];
-    const rootText = input.flags.record;
-    if (rootText !== undefined && rootText.trim() === "") {
-        throw usageError("--record requires an actual Record root directory.\n");
-    }
-    const rootPath = (0, node_path_1.resolve)(input.cwd, rootText ?? ".niceeval/record");
-    const root = (0, index_ts_1.makeRecordRoot)(rootPath);
-    if (effect_1.Either.isLeft(root)) {
-        throw usageError(`Invalid --record root: ${root.left.code}.\n`);
-    }
+    const { root, rootPath } = parseActualRecordRoot(input.cwd, input.flags.record);
     const page = parseReportRoute(input.flags.page);
     const evidenceReports = [
         input.flags.source !== undefined ? "--source" : undefined,
@@ -1819,7 +1809,7 @@ function parseReportCliRequest(input) {
         return Object.freeze({
             command: input.command,
             cwd: input.cwd,
-            root: root.right,
+            root,
             rootPath,
             target: Object.freeze({ kind: "attempt", locator: parsedLocator }),
             reportSelection: Object.freeze({ kind: "fixed", report }),
@@ -1845,7 +1835,7 @@ function parseReportCliRequest(input) {
         return Object.freeze({
             command: input.command,
             cwd: input.cwd,
-            root: root.right,
+            root,
             rootPath,
             target: Object.freeze({ kind: "attempt", locator: parsedLocator }),
             reportSelection: Object.freeze({
@@ -1871,11 +1861,13 @@ function parseReportCliRequest(input) {
             throw usageError("niceeval show --source requires one current Record Attempt locator.\n");
         }
         const parsedLocator = parseCurrentAttemptLocator(locator);
-        const report = (0, source_ts_1.sourceEvidenceReport)();
+        const report = (0, source_ts_1.sourceEvidenceReport)({
+            ...(typeof input.flags.source === "string" ? { file: input.flags.source } : {}),
+        });
         return Object.freeze({
             command: input.command,
             cwd: input.cwd,
-            root: root.right,
+            root,
             rootPath,
             target: Object.freeze({ kind: "attempt", locator: parsedLocator }),
             reportSelection: Object.freeze({ kind: "fixed", report }),
@@ -1898,7 +1890,7 @@ function parseReportCliRequest(input) {
         return Object.freeze({
             command: input.command,
             cwd: input.cwd,
-            root: root.right,
+            root,
             rootPath,
             target: Object.freeze({ kind: "attempt", locator: parsedLocator }),
             reportSelection: input.flags.report === undefined
@@ -1926,7 +1918,7 @@ function parseReportCliRequest(input) {
     return Object.freeze({
         command: input.command,
         cwd: input.cwd,
-        root: root.right,
+        root,
         rootPath,
         target,
         reportSelection: report,
@@ -1989,11 +1981,11 @@ function reportUnsupportedFlag(command, flags) {
 function parseReportRoute(value) {
     if (value === undefined)
         return undefined;
-    const parsed = (0, identity_ts_1.reportRoute)(value);
-    if (effect_1.Either.isLeft(parsed)) {
-        throw usageError(`Invalid --page route "${value}": ${parsed.left.reason}.\n`);
+    const issue = (0, paths_ts_1.validateReportRoute)(value);
+    if (issue !== undefined) {
+        throw usageError(`Invalid --page route "${value}": ${issue.reason}.\n`);
     }
-    return parsed.right;
+    return value;
 }
 function reportSelection(cwd, value) {
     if (value === undefined)
@@ -2028,14 +2020,14 @@ function explicitSelection(values) {
     const nonEmptyRunIds = [first, ...rest];
     return Object.freeze({
         policy: "explicit-runs",
-        input: Object.freeze({ runIds: nonEmptyRunIds }),
+        runIds: nonEmptyRunIds,
     });
 }
 function uniqueExactRunIds(values) {
     const result = [];
     const seen = new Set();
     for (const value of values) {
-        const decoded = effect_1.Schema.decodeUnknownEither(index_ts_1.RunIdSchema)(value);
+        const decoded = effect_1.Schema.decodeUnknownEither(index_ts_2.RunIdSchema)(value);
         if (effect_1.Either.isLeft(decoded)) {
             throw usageError(`Invalid --run value "${value}": expected one exact portable RunId.\n`);
         }
@@ -2050,7 +2042,7 @@ function uniqueExactExperimentIds(values) {
     const result = [];
     const seen = new Set();
     for (const value of values) {
-        const decoded = effect_1.Schema.decodeUnknownEither(index_ts_2.ExperimentIdSchema)(value);
+        const decoded = effect_1.Schema.decodeUnknownEither(identifiers_ts_1.ExperimentIdSchema)(value);
         if (effect_1.Either.isLeft(decoded)) {
             throw usageError(`Invalid --experiment value "${value}": expected one exact ExperimentId.\n`);
         }
@@ -2085,38 +2077,44 @@ function loadCliReportInputs(request) {
             }))
             : undefined;
         const configured = yield* cliEffect("load trusted Report config", (0, node_ts_1.loadTrustedReportConfig)(request.cwd));
-        const selectedReport = yield* reportFromSelection(request.reportSelection, configured.report);
+        const selectedReport = yield* reportFromSelection(request.reportSelection, configured.report, configured.watchInputs);
         const selectedTheme = yield* themeFromSelection(request.themeSelection, configured.theme);
         const projectCurrentSelection = projectCurrent === undefined
             ? undefined
             : Object.freeze({
                 policy: "project-current",
-                input: Object.freeze({
-                    target: projectCurrent.target,
-                }),
+                currentSlots: projectCurrent.currentSlots,
+                ...(request.target.kind === "project-current" && request.target.experimentIds !== undefined
+                    ? { experimentIds: request.target.experimentIds }
+                    : {}),
             });
+        const sourceWatchInputs = uniqueWatchInputs([
+            ...(projectCurrent?.watchInputs ?? []),
+            ...configured.watchInputs,
+            ...selectedReport.watchInputs,
+            ...selectedTheme.watchInputs,
+        ]);
         return Object.freeze({
             report: selectedReport.value,
             theme: selectedTheme.value,
+            reportWatchInputs: uniqueWatchInputs(selectedReport.watchInputs),
+            sourceWatchInputs,
             ...(projectCurrentSelection === undefined ? {} : { projectCurrentSelection }),
             watchInputs: uniqueWatchInputs([
                 request.rootPath,
-                ...(projectCurrent?.watchInputs ?? []),
-                ...configured.watchInputs,
-                ...selectedReport.watchInputs,
-                ...selectedTheme.watchInputs,
+                ...sourceWatchInputs,
             ]),
         });
     });
 }
-function reportFromSelection(selection, configured) {
+function reportFromSelection(selection, configured, configuredWatchInputs) {
     switch (selection.kind) {
         case "fixed":
             return effect_1.Effect.succeed(Object.freeze({ value: selection.report, watchInputs: Object.freeze([]) }));
         case "config":
             return effect_1.Effect.succeed(Object.freeze({
                 value: configured ?? overview_ts_1.defaultOverviewReport,
-                watchInputs: Object.freeze([]),
+                watchInputs: configured === undefined ? Object.freeze([]) : configuredWatchInputs,
             }));
         case "built-in":
             return effect_1.Effect.succeed(Object.freeze({ value: overview_ts_1.defaultOverviewReport, watchInputs: Object.freeze([]) }));
@@ -2140,21 +2138,23 @@ function themeFromSelection(selection, configured) {
 function uniqueWatchInputs(paths) {
     return Object.freeze([...new Set(paths.map((path) => (0, node_path_1.resolve)(path)))].sort());
 }
-function executeCliReport(request, inputs) {
-    const execution = request.target.kind === "attempt"
-        ? (0, index_ts_3.executeReportForAttemptFromRecord)({
+function buildCliReportSite(request, inputs) {
+    const revision = request.target.kind === "attempt"
+        ? (0, from_record_ts_1.buildReportSiteFromRecord)({
             root: request.root,
             locator: request.target.locator,
             report: inputs.report,
+            theme: inputs.theme,
         })
-        : (0, index_ts_3.executeReportFromRecord)({
+        : (0, from_record_ts_1.buildReportSiteFromRecord)({
             root: request.root,
             selection: request.target.kind === "selection"
                 ? request.target.selection
                 : inputs.projectCurrentSelection,
             report: inputs.report,
+            theme: inputs.theme,
         });
-    return execution.pipe(effect_1.Effect.mapError(reportExecutionFailure));
+    return revision.pipe(effect_1.Effect.mapError(reportExecutionFailure));
 }
 function reportExecutionFailure(error) {
     switch (failureCode(error)) {
@@ -2177,27 +2177,92 @@ function reportExecutionFailure(error) {
         case "record-bootstrap-invalid":
             return usageError("record-bootstrap-invalid\nPass --record <actual-record-root> or create a current NiceEval Record.\n");
         case "record-format-unsupported":
-            return usageError("record-format-unsupported\nUse a NiceEval version that supports this Record format.\n");
+            return usageError("record-format-unsupported\nThis Record was created by a NiceEval version that is no longer supported. Remove .niceeval (for example, rm -rf .niceeval) and rerun the evaluation.\n");
         case "record-migration-interrupted":
             return usageError("record-migration-interrupted\nRestore the Record from Git or a backup before retrying.\n");
+        case "report-route-invalid":
+            return usageError(`Unknown Report route "${stringProperty(error, "route") ?? "unknown"}".\n`);
+        case "report-build-budget-exceeded":
+            return usageError(reportBuildBudgetExceededMessage(error));
+        case "report-site-execution-problem":
+            return usageError(reportSiteExecutionProblemMessage(error));
         default:
             return cliFailure("execute report from Record", error);
     }
 }
+/** Preserve the actionable dimension and target from the Host's closed budget error. */
+function reportBuildBudgetExceededMessage(error) {
+    const budget = stringProperty(error, "budget");
+    const maximum = finiteNumberProperty(error, "maximum");
+    const observedAtLeast = finiteNumberProperty(error, "observedAtLeast");
+    if (budget === undefined || maximum === undefined || observedAtLeast === undefined) {
+        return "report-build-budget-exceeded\n";
+    }
+    const pageId = stringProperty(error, "pageId");
+    const route = stringProperty(error, "route");
+    const target = pageId === undefined && route === undefined
+        ? ""
+        : ` (${[
+            ...(pageId === undefined ? [] : [`page ${JSON.stringify(pageId)}`]),
+            ...(route === undefined ? [] : [`route ${JSON.stringify(route)}`]),
+        ].join(", ")})`;
+    return `report-build-budget-exceeded: ${budget} observed at least ${observedAtLeast}; maximum ${maximum}${target}\n`;
+}
+const REPORT_CLI_PROBLEMS_MAX = 20;
+const REPORT_CLI_PROBLEM_TEXT_MAX = 1024;
+/** Keep the concrete closed-problem reason while bounding author-controlled diagnostics. */
+function reportSiteExecutionProblemMessage(error) {
+    if (typeof error !== "object" || error === null)
+        return "report-site-execution-problem\n";
+    const problems = Reflect.get(error, "problems");
+    if (!Array.isArray(problems))
+        return "report-site-execution-problem\n";
+    const lines = problems
+        .slice(0, REPORT_CLI_PROBLEMS_MAX)
+        .flatMap((problem) => {
+        const code = boundedReportCliProblemText(stringProperty(problem, "code"));
+        const summary = boundedReportCliProblemText(stringProperty(problem, "summary"));
+        if (code === undefined && summary === undefined)
+            return [];
+        if (code === undefined)
+            return [summary];
+        return [summary === undefined ? code : `${code}: ${summary}`];
+    });
+    const omitted = Math.max(0, problems.length - REPORT_CLI_PROBLEMS_MAX);
+    return [
+        "report-site-execution-problem",
+        ...lines,
+        ...(omitted === 0 ? [] : [`${omitted} additional Report problem(s) omitted.`]),
+        "",
+    ].join("\n");
+}
+function boundedReportCliProblemText(value) {
+    if (value === undefined)
+        return undefined;
+    const bounded = value
+        .replace(/[\u0000-\u001f\u007f-\u009f]/g, " ")
+        .slice(0, REPORT_CLI_PROBLEM_TEXT_MAX)
+        .trim();
+    return bounded === "" ? undefined : bounded;
+}
 function stringProperty(value, key) {
     if (typeof value !== "object" || value === null)
         return undefined;
     const candidate = Reflect.get(value, key);
     return typeof candidate === "string" ? candidate : undefined;
 }
-function requireKnownReportPage(execution, page) {
-    if (page === undefined || execution.pages.some((candidate) => candidate.route === page)) {
+function finiteNumberProperty(value, key) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const candidate = Reflect.get(value, key);
+    return typeof candidate === "number" && Number.isFinite(candidate) ? candidate : undefined;
+}
+function requireKnownReportPage(revision, page) {
+    const routes = (0, model_ts_1.closedSiteRevisionData)(revision).routes;
+    if (page === undefined || routes.includes(page)) {
         return effect_1.Effect.void;
     }
-    const available = execution.pages
-        .flatMap((candidate) => candidate.route === undefined ? [] : [candidate.route])
-        .sort()
-        .join(", ");
+    const available = [...routes].sort().join(", ");
     return effect_1.Effect.fail(usageError(`Unknown Report route "${page}". Available routes: ${available || "none"}.\n`));
 }
 const cliReportConsole = Object.freeze({
@@ -2211,32 +2276,149 @@ const cliReportConsole = Object.freeze({
         }),
     }),
 });
+const reportHostPhaseLabels = Object.freeze({
+    "record-open": "Open Record",
+    "selection": "Select runs and attempts",
+    "sample-open": "Open analysis Sample",
+    "report-execution": "Execute Report and read requested facts",
+});
+function formatReportProgressDuration(durationMs) {
+    if (durationMs < 1000)
+        return `${Math.round(durationMs)}ms`;
+    return `${(durationMs / 1000).toFixed(1)}s`;
+}
+function writeReportProgress(text) {
+    try {
+        process.stderr.write(text);
+    }
+    catch {
+        // Progress is diagnostic only; it must never alter Report execution.
+    }
+}
+const cliProgressFrames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+/**
+ * Keeps interactive progress on one terminal line, while preserving plain
+ * line-oriented diagnostics when stderr is redirected to a file or CI log.
+ */
+class CliReportProgress {
+    active;
+    start(label) {
+        if (!process.stderr.isTTY) {
+            writeReportProgress(`⠋ ${label}…\n`);
+            return () => undefined;
+        }
+        if (this.active !== undefined)
+            clearInterval(this.active.timer);
+        let frame = 0;
+        const render = () => writeReportProgress(`\r\u001b[2K${cliProgressFrames[frame++ % cliProgressFrames.length]} ${label}…`);
+        render();
+        const timer = setInterval(render, 80);
+        const active = { label, timer };
+        this.active = active;
+        return () => {
+            if (this.active !== active)
+                return;
+            clearInterval(timer);
+            this.active = undefined;
+        };
+    }
+    complete(label, text) {
+        if (process.stderr.isTTY) {
+            if (this.active?.label === label) {
+                clearInterval(this.active.timer);
+                this.active = undefined;
+            }
+            writeReportProgress(`\r\u001b[2K${text}\n`);
+            return;
+        }
+        writeReportProgress(`${text}\n`);
+    }
+}
+function makeCliReportProgress(rootPath, progress) {
+    return Object.freeze({
+        report: (event) => {
+            const label = event.phase === "record-open"
+                ? `${reportHostPhaseLabels[event.phase]} (${rootPath})`
+                : reportHostPhaseLabels[event.phase];
+            if (event.type === "start") {
+                progress.start(label);
+                return;
+            }
+            const marker = event.outcome === "success" ? "✓" : "×";
+            const outcome = event.outcome === "success" ? "" : ` · ${event.outcome}`;
+            progress.complete(label, `${marker} ${label} (${formatReportProgressDuration(event.durationMs)}${outcome})`);
+        },
+    });
+}
+function cliPhaseOutcome(exit) {
+    if (effect_1.Exit.isSuccess(exit))
+        return "success";
+    if (effect_1.Cause.isInterruptedOnly(exit.cause))
+        return "interrupted";
+    return effect_1.Cause.defects(exit.cause).pipe((defects) => defects.length > 0) ? "defect" : "failure";
+}
+function withCliReportPhase(progress, label, effect) {
+    return effect_1.Effect.gen(function* () {
+        const startedAt = yield* effect_1.Clock.currentTimeNanos;
+        const stopProgress = yield* effect_1.Effect.sync(() => progress.start(label));
+        return yield* effect.pipe(effect_1.Effect.onExit((exit) => effect_1.Effect.gen(function* () {
+            const completedAt = yield* effect_1.Clock.currentTimeNanos;
+            const durationMs = Math.max(0, Number(completedAt - startedAt) / 1000000);
+            const outcome = cliPhaseOutcome(exit);
+            const marker = outcome === "success" ? "✓" : "×";
+            const detail = outcome === "success" ? "" : ` · ${outcome}`;
+            yield* effect_1.Effect.sync(() => {
+                stopProgress();
+                progress.complete(label, `${marker} ${label} (${formatReportProgressDuration(durationMs)}${detail})`);
+            });
+        })));
+    });
+}
 function runShowCommand(cwd, positionals, flags) {
     return effect_1.Effect.gen(function* () {
+        const progress = new CliReportProgress();
         const request = yield* effect_1.Effect.try({
             try: () => parseReportCliRequest({ command: "show", cwd, positionals, flags }),
             catch: (cause) => cliFailure("parse show arguments", cause),
         });
-        const inputs = yield* loadCliReportInputs(request);
-        const execution = yield* executeCliReport(request, inputs);
-        yield* requireKnownReportPage(execution, request.page);
-        yield* (0, index_ts_3.showReport)({
-            execution,
-            ...(flags.json ? { format: "json" } : {}),
-            ...(request.page === undefined ? {} : { page: request.page }),
-        }).pipe(effect_1.Effect.provideService(index_ts_3.ReportConsole, cliReportConsole), effect_1.Effect.mapError((error) => cliFailure("render Report show output", error)));
+        const inputs = yield* withCliReportPhase(progress, "Load project, config, Report, and Theme", loadCliReportInputs(request));
+        const textProjection = flags.json
+            ? undefined
+            : (0, panel_ts_1.panelCapabilityOf)({
+                isTTY: process.stdout.isTTY,
+                width: process.stdout.columns,
+            });
+        const show = request.target.kind === "attempt"
+            ? index_ts_3.reportHost.show({
+                root: request.root,
+                locator: request.target.locator,
+                report: inputs.report,
+                ...(request.page === undefined ? {} : { route: request.page }),
+                ...(textProjection === undefined ? {} : { textProjection: { width: textProjection.width, panelMode: textProjection.mode } }),
+                format: flags.json ? "json" : "text",
+            })
+            : index_ts_3.reportHost.show({
+                root: request.root,
+                selection: request.target.kind === "selection"
+                    ? request.target.selection
+                    : inputs.projectCurrentSelection,
+                report: inputs.report,
+                ...(request.page === undefined ? {} : { route: request.page }),
+                ...(textProjection === undefined ? {} : { textProjection: { width: textProjection.width, panelMode: textProjection.mode } }),
+                format: flags.json ? "json" : "text",
+            });
+        const output = yield* show.pipe(effect_1.Effect.provideService(progress_ts_1.ReportHostProgressObserver, makeCliReportProgress(request.rootPath, progress)), effect_1.Effect.mapError(reportExecutionFailure));
+        yield* cliReportConsole.write(output).pipe(effect_1.Effect.mapError((error) => cliFailure("render Report show output", error)));
         return 0;
     });
 }
 function runViewCommand(cwd, positionals, flags) {
     return effect_1.Effect.gen(function* () {
+        const progress = new CliReportProgress();
         const request = yield* effect_1.Effect.try({
             try: () => parseReportCliRequest({ command: "view", cwd, positionals, flags }),
             catch: (cause) => cliFailure("parse view arguments", cause),
         });
-        const initialInputs = yield* loadCliReportInputs(request);
-        const initial = yield* executeCliReport(request, initialInputs);
-        yield* requireKnownReportPage(initial, request.page);
         if (flags.out !== undefined) {
             if (flags.out.trim() === "") {
                 return yield* effect_1.Effect.fail(usageError("--out requires a target directory.\n"));
@@ -2244,32 +2426,34 @@ function runViewCommand(cwd, positionals, flags) {
             if (flags.port !== undefined || flags.host !== undefined || flags.open === true) {
                 return yield* effect_1.Effect.fail(usageError("view --out does not start a server; remove --port, --host, and --open.\n"));
             }
-            const receipt = yield* (0, index_ts_3.exportStaticReport)({
-                execution: initial,
+            if (request.page !== undefined) {
+                return yield* effect_1.Effect.fail(usageError("view --out does not accept --page.\n"));
+            }
+            const inputs = yield* withCliReportPhase(progress, "Load project, config, Report, and Theme", loadCliReportInputs(request));
+            const revision = yield* buildCliReportSite(request, inputs).pipe(effect_1.Effect.provideService(progress_ts_1.ReportHostProgressObserver, makeCliReportProgress(request.rootPath, progress)));
+            const receipt = yield* withCliReportPhase(progress, "Export static report site", index_ts_3.reportHost.export({
+                revision,
                 out: (0, node_path_1.resolve)(cwd, flags.out),
-                theme: initialInputs.theme,
-            }).pipe(effect_1.Effect.provideService(index_ts_3.ReportFileSystem, (0, node_ts_1.makeNodeReportFileSystem)()), effect_1.Effect.mapError((error) => staticExportFailure(error, (0, node_path_1.resolve)(cwd, flags.out))));
+            }).pipe(effect_1.Effect.provideService(static_ts_1.ReportFileSystem, (0, node_ts_1.makeNodeReportFileSystem)()), effect_1.Effect.mapError((error) => staticExportFailure(error, (0, node_path_1.resolve)(cwd, flags.out)))));
             yield* writeStdout(`Exported static report site: ${receipt.out}\n`);
             return 0;
         }
+        const initialInputs = yield* withCliReportPhase(progress, "Load project, config, Report, and Theme", loadCliReportInputs(request));
+        const initial = yield* buildCliReportSite(request, initialInputs).pipe(effect_1.Effect.provideService(progress_ts_1.ReportHostProgressObserver, makeCliReportProgress(request.rootPath, progress)));
+        yield* requireKnownReportPage(initial, request.page);
+        const buildCache = yield* makeReportViewBuildCache(request, initialInputs, initial);
         const { host, port } = yield* effect_1.Effect.try({
             try: () => ({ host: viewHost(flags.host), port: viewPort(flags.port) }),
             catch: (cause) => cliFailure("parse view server arguments", cause),
         });
-        const session = yield* (0, index_ts_3.openReportViewSession)({
+        const server = yield* withCliReportPhase(progress, "Start HTTP server and file watcher", index_ts_3.reportHost.serve({
             url: `http://${host.includes(":") ? `[${host}]` : host}:${port}/`,
-            theme: initialInputs.theme,
             watchInputs: initialInputs.watchInputs,
             initial: effect_1.Effect.succeed(initial),
-            rebuild: () => rebuildReportView(request),
-        }).pipe(effect_1.Effect.mapError((error) => cliFailure("open report view session", error)));
-        // Watch set is owned by the session revision; openViewServer only transports
-        // fs.watch hints and replaces them after each successful rebuild.
-        const server = yield* (0, server_ts_1.openViewServer)({
-            session,
+            rebuild: () => rebuildReportView(request, buildCache),
             host,
             port,
-        }).pipe(effect_1.Effect.mapError((error) => cliFailure("open report view", error)));
+        }).pipe(effect_1.Effect.mapError((error) => cliFailure("open report view", error))));
         const urls = server.urls.map((url) => request.page === undefined ? url : new URL(request.page, url).toString());
         const url = urls[0];
         if (!isLoopbackViewHost(host)) {
@@ -2283,21 +2467,72 @@ function runViewCommand(cwd, positionals, flags) {
         return yield* effect_1.Effect.never;
     });
 }
-/**
- * A watcher signal is only a hint. Every refresh re-reads config plus its
- * fresh author graph and Record before one completed immutable revision is
- * published with its next recoverable watch set; a typed boundary failure is
- * logged once and leaves last-good execution and the prior watch set.
- */
-function rebuildReportView(request) {
+function rebuildReportView(request, cache) {
     return effect_1.Effect.gen(function* () {
         const inputs = yield* loadCliReportInputs(request);
-        const execution = yield* executeCliReport(request, inputs);
-        yield* requireKnownReportPage(execution, request.page);
+        const [snapshotIdentity, sourceFingerprint, reportInputFingerprint, themeCss] = yield* effect_1.Effect.all([
+            readReportSnapshotIdentity(request, inputs),
+            fingerprintReportSourceInputs(inputs.sourceWatchInputs),
+            fingerprintReportSourceInputs(inputs.reportWatchInputs),
+            closeReportThemeStylesheet(inputs.theme),
+        ]);
+        const pageIdentity = reportPageCacheIdentity(request, inputs, {
+            snapshotIdentity,
+            reportInputs: reportInputFingerprint,
+        });
+        const themeIdentity = reportCacheBytesIdentity(themeCss);
+        const cachedPages = cache.pageBytes;
+        const reusePages = cachedPages !== undefined &&
+            snapshotIdentity === cache.snapshotIdentity &&
+            pageIdentity !== undefined && pageIdentity === cache.pageIdentity;
+        const exactNoop = reusePages && themeIdentity === cache.themeIdentity &&
+            sameReportInputFingerprint(sourceFingerprint, cache.sourceFingerprint);
+        let revision;
+        let pageBytes;
+        if (exactNoop) {
+            revision = cache.revision;
+            pageBytes = cachedPages;
+        }
+        else if (reusePages && themeIdentity !== cache.themeIdentity) {
+            const rethemed = (0, report_view_cache_ts_1.rethemeClosedReportPageBytes)(cachedPages, themeCss, static_ts_1.signClosedSiteRevision);
+            if (rethemed === undefined) {
+                revision = yield* buildCliReportSite(request, inputs);
+                pageBytes = (0, report_view_cache_ts_1.closeReportPageBytes)(revision, {
+                    selectionIdentity: reportSelectionCacheIdentity(request, inputs),
+                    themeIdentity,
+                });
+            }
+            else {
+                revision = rethemed;
+                pageBytes = (0, report_view_cache_ts_1.closeReportPageBytes)(revision, {
+                    selectionIdentity: reportSelectionCacheIdentity(request, inputs),
+                    themeIdentity,
+                });
+            }
+        }
+        else {
+            revision = yield* buildCliReportSite(request, inputs);
+            pageBytes = (0, report_view_cache_ts_1.closeReportPageBytes)(revision, {
+                selectionIdentity: reportSelectionCacheIdentity(request, inputs),
+                themeIdentity,
+            });
+        }
+        yield* requireKnownReportPage(revision, request.page);
+        cache.revision = revision;
+        cache.pageBytes = pageBytes;
+        cache.watchInputs = inputs.watchInputs;
+        cache.sourceFingerprint = sourceFingerprint;
+        cache.snapshotIdentity = pageBytes?.sampleIdentity ?? snapshotIdentity;
+        cache.pageIdentity = pageBytes === undefined
+            ? undefined
+            : reportPageCacheIdentity(request, inputs, {
+                snapshotIdentity: pageBytes.sampleIdentity,
+                reportInputs: reportInputFingerprint,
+            });
+        cache.themeIdentity = themeIdentity;
         return Object.freeze({
-            kind: "execution",
-            execution,
-            theme: inputs.theme,
+            kind: "site",
+            site: revision,
             watchInputs: inputs.watchInputs,
         });
     }).pipe(effect_1.Effect.catchAll((failure) => {
@@ -2305,6 +2540,144 @@ function rebuildReportView(request) {
         return writeStderr(`view rebuild failed: ${problem.summary}\n`).pipe(effect_1.Effect.zipRight(effect_1.Effect.fail(problem)));
     }));
 }
+function makeReportViewBuildCache(request, inputs, revision) {
+    return effect_1.Effect.gen(function* () {
+        const [sourceFingerprint, reportInputFingerprint, themeCss] = yield* effect_1.Effect.all([
+            fingerprintReportSourceInputs(inputs.sourceWatchInputs),
+            fingerprintReportSourceInputs(inputs.reportWatchInputs),
+            closeReportThemeStylesheet(inputs.theme),
+        ]);
+        const themeIdentity = reportCacheBytesIdentity(themeCss);
+        const selectionIdentity = reportSelectionCacheIdentity(request, inputs);
+        const pageBytes = (0, report_view_cache_ts_1.closeReportPageBytes)(revision, { selectionIdentity, themeIdentity });
+        const pageIdentity = reportPageCacheIdentity(request, inputs, {
+            snapshotIdentity: pageBytes?.sampleIdentity ?? "",
+            reportInputs: reportInputFingerprint,
+        });
+        return {
+            revision,
+            ...(pageBytes === undefined ? {} : { pageBytes }),
+            watchInputs: inputs.watchInputs,
+            sourceFingerprint,
+            snapshotIdentity: pageBytes?.sampleIdentity ?? "",
+            ...(pageBytes === undefined || pageIdentity === undefined ? {} : { pageIdentity }),
+            themeIdentity,
+        };
+    });
+}
+function sameReportInputFingerprint(left, right) {
+    return left.complete && right.complete && left.digest === right.digest;
+}
+function reportPageCacheIdentity(request, inputs, input) {
+    if (input.snapshotIdentity.length === 0 || !input.reportInputs.complete)
+        return undefined;
+    return (0, node_crypto_1.createHash)("sha256").update(JSON.stringify([
+        "niceeval.report-page-bytes/v1",
+        static_ts_1.REPORT_STATIC_RENDERER,
+        input.snapshotIdentity,
+        input.reportInputs.digest,
+        (0, execute_ts_1.reportDefinitionIdentity)(inputs.report),
+        reportSelectionCacheIdentity(request, inputs),
+    ])).digest("hex");
+}
+function reportCacheBytesIdentity(bytes) {
+    return (0, node_crypto_1.createHash)("sha256").update(bytes).digest("hex");
+}
+/** Delegates the exact Theme stylesheet closure to the static Host. */
+function closeReportThemeStylesheet(theme) {
+    return effect_1.Effect.try({
+        try: () => (0, static_ts_1.closeStaticThemeStylesheet)(theme),
+        catch: (cause) => cliFailure("close Report theme stylesheet", cause),
+    });
+}
+/**
+ * The Host owns Record selection, project-current narrowing, and semantic
+ * snapshot construction. This probe deliberately never opens a Sample.
+ */
+function readReportSnapshotIdentity(request, inputs) {
+    const target = request.target.kind === "attempt"
+        ? Object.freeze({ root: request.root, locator: request.target.locator })
+        : Object.freeze({
+            root: request.root,
+            selection: request.target.kind === "selection"
+                ? request.target.selection
+                : inputs.projectCurrentSelection,
+        });
+    return (0, from_record_ts_1.reportSnapshotIdentityFromRecord)(target).pipe(effect_1.Effect.mapError(reportExecutionFailure));
+}
+function reportSelectionCacheIdentity(request, inputs) {
+    const target = request.target.kind === "project-current"
+        ? inputs.projectCurrentSelection
+        : request.target;
+    return (0, node_crypto_1.createHash)("sha256").update(JSON.stringify(target)).digest("hex");
+}
+/**
+ * A source-watch signal is only a hint. This digest deliberately excludes the
+ * Record root: selected Record equivalence comes only from the Host-owned
+ * semantic snapshot probe. Links and special files make the result incomplete,
+ * so unprovable input can never produce an exact no-op; a missing optional
+ * path is a complete, watchable source-state observation.
+ */
+function fingerprintReportSourceInputs(paths) {
+    return effect_1.Effect.tryPromise({
+        try: async () => {
+            const hash = (0, node_crypto_1.createHash)("sha256");
+            const visited = new Set();
+            let complete = true;
+            const visit = async (path) => {
+                const absolute = (0, node_path_1.resolve)(path);
+                if (visited.has(absolute))
+                    return;
+                visited.add(absolute);
+                let info;
+                try {
+                    info = await (0, promises_1.lstat)(absolute);
+                }
+                catch (cause) {
+                    if (typeof cause === "object" && cause !== null && Reflect.get(cause, "code") === "ENOENT") {
+                        // An absent optional config/module entry is itself a complete
+                        // source-state observation. A later creation emits a watcher
+                        // signal and changes this digest.
+                        hash.update(`missing\0${absolute}\0`);
+                        return;
+                    }
+                    throw cause;
+                }
+                hash.update(`path\0${absolute}\0`);
+                if (info.isSymbolicLink()) {
+                    complete = false;
+                    hash.update(`link\0${await (0, promises_1.readlink)(absolute)}\0`);
+                    return;
+                }
+                if (info.isFile()) {
+                    hash.update("file\0");
+                    hash.update(await (0, promises_1.readFile)(absolute));
+                    hash.update("\0");
+                    return;
+                }
+                if (!info.isDirectory()) {
+                    complete = false;
+                    hash.update(`opaque\0${info.mode}\0`);
+                    return;
+                }
+                hash.update("directory\0");
+                const names = (await (0, promises_1.readdir)(absolute)).sort();
+                for (const name of names)
+                    yieldName(hash, name);
+                for (const name of names)
+                    await visit((0, node_path_1.join)(absolute, name));
+            };
+            for (const path of [...new Set(paths.map((entry) => (0, node_path_1.resolve)(entry)))].sort()) {
+                await visit(path);
+            }
+            return Object.freeze({ digest: hash.digest("hex"), complete });
+        },
+        catch: (cause) => cliFailure("fingerprint Report source inputs", cause),
+    });
+}
+function yieldName(hash, name) {
+    hash.update(`entry\0${name}\0`);
+}
 function staticExportFailure(error, out) {
     if (failureCode(error) === "report-export-target-exists") {
         return usageError(`report-export-target-exists\nRemove ${out} before retrying.\n`);
@@ -2321,7 +2694,7 @@ function isLoopbackViewHost(host) {
     return host === "127.0.0.1" || host === "::1" || host === "localhost";
 }
 function viewPort(value) {
-    const port = value ?? 4173;
+    const port = value ?? 0;
     if (!Number.isInteger(port) || port < 0 || port > 65535) {
         throw usageError(`--port must be an integer from 0 through 65535, got ${port}.\n`);
     }