@agent-surface/cli 0.15.0 → 0.16.0

package/dist/inspect-3YFPCYQJ.js

@@ -1,226 +0,0 @@
-import {
-  coverageReport,
-  inventoryReport,
-  scenarioReport
-} from "./chunk-Y2LSPEVK.js";
-import {
-  createPresenter,
-  joinCoverage,
-  mountScenarios,
-  readInventory,
-  scopeCapabilityIds,
-  scopeInventory,
-  staticConfigScope
-} from "./chunk-A5UCBF7D.js";
-import {
-  write
-} from "./chunk-GYYWHZPM.js";
-import {
-  READING_SOURCE,
-  buildView,
-  catalogDetailParts,
-  catalogRows,
-  coverageSections,
-  failureSection,
-  flatRows,
-  mountingLabel,
-  neverCallable,
-  neverCallableSection,
-  noVerdictSection,
-  runHeaderBlocks,
-  scenarioStats,
-  scenarioTable,
-  surfaceSummaryRows,
-  trackReach
-} from "./chunk-NFK3XWWH.js";
-
-// src/commands/inspect.ts
-async function runInspect(options) {
-  const analysis = {
-    configPath: options.configPath,
-    depth: options.depth,
-    ...options.scenario ? { scenario: options.scenario } : {},
-    ...options.scope ? { scope: options.scope } : {},
-    ...options.tsconfig ? { tsconfig: options.tsconfig } : {},
-    ...options.baselineDir ? { baselineDir: options.baselineDir } : {}
-  };
-  const detail = options.detail === true || options.explain === true || options.schemas === true;
-  const present = await createPresenter(options);
-  if (!options.json) await present.wait(READING_SOURCE);
-  const inventory = readInventory(analysis);
-  const scenarios = [];
-  const stats = [];
-  const views = [];
-  const reach = /* @__PURE__ */ new Map();
-  let plan;
-  const scope = () => plan?.scope ?? staticConfigScope(analysis);
-  const scopedInventory = () => scopeInventory(inventory, scope());
-  const domainCount = () => plan?.domainManifestConfigured ? scopeCapabilityIds(plan.domainCapabilities, scope()).length : void 0;
-  const header = async () => {
-    present.settle();
-    if (options.json) return;
-    const active = scope();
-    const catalog2 = scopedInventory();
-    await present.emit(
-      // At `--depth static` the catalog *is* the answer, so it opens the report
-      // beside the run it came from. At every other depth it is a detail behind
-      // the summary, and prints down there instead.
-      {
-        kind: "blocks",
-        blocks: runHeaderBlocks(
-          "SURFACE INSPECT",
-          {
-            configPath: options.configPath,
-            depth: options.depth,
-            ...active ? { scope: active } : {},
-            ...plan ? { scenarios: plan.scenarios, declaredScenarios: plan.declaredScenarios } : {}
-          },
-          plan ? void 0 : catalog2,
-          domainCount()
-        )
-      },
-      ...!plan && catalog2 ? catalogDetailParts(catalog2, { ...detail ? { detail: true } : {} }) : []
-    );
-  };
-  const runtime = await mountScenarios(analysis, {
-    onPlan: async (current) => {
-      plan = current;
-      await header();
-      if (current.scenarios.length > 0) await present.wait(mountingLabel(current.scenarios, 0));
-    },
-    onEach: async (result) => {
-      const view = buildView(result, {
-        ...options.explain ? { explain: true } : {},
-        ...options.schemas ? { schemas: true } : {}
-      });
-      trackReach(reach, flatRows(view), result.scenario);
-      stats.push(scenarioStats(result));
-      if (options.json) {
-        scenarios.push(
-          scenarioReport(result, {
-            ...options.explain ? { attribution: true } : {},
-            ...options.schemas ? { schemas: true } : {}
-          })
-        );
-      } else {
-        views.push(view);
-      }
-      if (plan && stats.length < plan.scenarios.length) {
-        await present.wait(mountingLabel(plan.scenarios, stats.length));
-      }
-    }
-  });
-  present.settle();
-  if (!runtime) await header();
-  const effectiveScope = options.scope ?? runtime?.scope ?? staticConfigScope(analysis);
-  const reportInventory = scopeInventory(inventory, effectiveScope);
-  const reportDomain = runtime?.domainManifestConfigured ? scopeCapabilityIds(runtime.domainCapabilities, effectiveScope) : void 0;
-  const coverage = joinCoverage(inventory, runtime, analysis);
-  const dark = neverCallable(reach);
-  if (options.json) {
-    write(
-      JSON.stringify(
-        {
-          // One shape whatever the depth, so a consumer never branches on how
-          // the command was invoked. A half the depth did not compute is
-          // `null`, which is a different statement from `[]` or `{}`.
-          depth: options.depth,
-          catalog: inventoryReport(reportInventory, reportDomain),
-          scenarios,
-          failures: runtime?.failures ?? [],
-          coverage: coverageReport(coverage),
-          // Mounted, and callable in no scenario — a gap the coverage join
-          // cannot see, because every one of these *was* reached.
-          neverCallable: dark.map((entry) => ({
-            capabilityId: entry.capabilityId,
-            outcome: entry.best,
-            ...entry.note ? { reason: entry.note } : {},
-            scenarios: entry.scenarios
-          }))
-        },
-        null,
-        2
-      )
-    );
-    return runtime && runtime.failures.length > 0 ? 2 : 0;
-  }
-  if (!runtime) return 0;
-  for (const failure of runtime.failures) {
-    stats.push({
-      scenario: failure.scenario,
-      callable: 0,
-      disabled: 0,
-      hidden: 0,
-      rejected: 0,
-      failed: true,
-      failure: failure.message
-    });
-  }
-  stats.sort((a, b) => runtime.scenarios.indexOf(a.scenario) - runtime.scenarios.indexOf(b.scenario));
-  const mounted = stats.filter((entry) => !entry.failed).length;
-  const parts = [
-    {
-      kind: "blocks",
-      blocks: [
-        {
-          title: "SURFACE SUMMARY",
-          rows: surfaceSummaryRows({
-            depth: options.depth,
-            ...coverage ? { coverage } : {},
-            scenarios: stats,
-            failures: runtime.failures.length,
-            reach
-          })
-        }
-      ]
-    }
-  ];
-  if (stats.length > 1) {
-    const table = scenarioTable(stats);
-    parts.push({
-      kind: "table",
-      title: `SCENARIOS  (${stats.length})`,
-      headers: table.headers,
-      rows: table.rows
-    });
-  }
-  if (runtime.failures.length > 0) {
-    parts.push({
-      kind: "findings",
-      stream: "err",
-      sections: [
-        failureSection(runtime.failures),
-        ...inventory ? [noVerdictSection(runtime.failures)] : []
-      ]
-    });
-  }
-  const sections = [
-    ...coverage ? coverageSections(coverage) : [],
-    ...dark.length > 0 && mounted > 1 ? [neverCallableSection(dark)] : []
-  ];
-  if (sections.length > 0) parts.push({ kind: "findings", sections });
-  const catalog = scopeInventory(inventory, effectiveScope);
-  if (catalog) {
-    parts.push({
-      kind: "blocks",
-      blocks: [
-        {
-          title: "STATIC CATALOG",
-          rows: catalogRows(catalog, {
-            ...domainCount() === void 0 ? {} : { domainCapabilities: domainCount() },
-            mounted: true
-          })
-        }
-      ]
-    });
-  }
-  for (const view of views) {
-    parts.push({ kind: "surface", view, ...detail ? { detail: true } : {} });
-  }
-  await present.emit(...parts);
-  return runtime.failures.length > 0 ? 2 : 0;
-}
-export {
-  runInspect
-};
-//# sourceMappingURL=inspect-3YFPCYQJ.js.map

package/dist/inspect-3YFPCYQJ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/inspect.ts"],"sourcesContent":["import {\n  joinCoverage,\n  mountScenarios,\n  readInventory,\n  scopeCapabilityIds,\n  scopeInventory,\n  staticConfigScope,\n  type AnalysisOptions,\n  type Depth,\n  type RuntimePlan,\n} from \"../analysis.js\";\nimport { buildView, flatRows, type SurfaceView } from \"../render/model.js\";\nimport { createPresenter } from \"../render/present.js\";\nimport {\n  catalogDetailParts,\n  catalogRows,\n  coverageSections,\n  failureSection,\n  mountingLabel,\n  neverCallable,\n  neverCallableSection,\n  noVerdictSection,\n  READING_SOURCE,\n  runHeaderBlocks,\n  scenarioStats,\n  scenarioTable,\n  surfaceSummaryRows,\n  trackReach,\n  type CapabilityReach,\n  type FindingSection,\n  type ReportPart,\n  type ScenarioStats,\n} from \"../render/summary.js\";\nimport { write } from \"../output.js\";\nimport {\n  coverageReport,\n  inventoryReport,\n  scenarioReport,\n  type ScenarioReport,\n} from \"../report.js\";\n\nexport interface InspectOptions {\n  configPath: string;\n  depth: Depth;\n  scenario?: string;\n  scope?: string[];\n  tsconfig?: string;\n  baselineDir?: string;\n  detail?: boolean;\n  explain?: boolean;\n  schemas?: boolean;\n  json?: boolean;\n  plain?: boolean;\n}\n\n/**\n * The whole surface: what this codebase authors, what a mount surfaces, and the\n * difference between them.\n *\n * It answers findings, it does not gate on them — exit `0` whatever it reports,\n * because `check` is the gate and a viewer that sometimes fails is a viewer\n * nobody puts in a pipeline. The exception is `2`, which is not a finding: the\n * command could not run at all.\n *\n * The report is read top-down, so it is written top-down: **summaries first,\n * details after.**\n *\n * 1. **The run** — the config, the depth, the scope, the scenarios. All of it is\n *    known before the first mount, and the mounts are the slow half, so it\n *    prints immediately rather than making a reader wait to learn what is being\n *    measured.\n * 2. **The summary** — reach, what is callable, what the surface can do, the\n *    verdict. The answer, before anything it was derived from.\n * 3. **One row per scenario**, for a config with more than one.\n * 4. **The findings** — unreached, never callable, unread call sites — each with\n *    what to do about it.\n * 5. **The details** — the static catalog, then each scenario's own table.\n *\n * That order costs the streaming this command used to do: the summary is a\n * statement about every scenario, so it cannot be written until every scenario\n * has mounted. A terminal is told what it is waiting for instead — the header\n * is already on screen and a spinner names the scenario being mounted — and\n * `check`, whose output has always been a report, works the same way.\n */\nexport async function runInspect(options: InspectOptions): Promise<number> {\n  const analysis: AnalysisOptions = {\n    configPath: options.configPath,\n    depth: options.depth,\n    ...(options.scenario ? { scenario: options.scenario } : {}),\n    ...(options.scope ? { scope: options.scope } : {}),\n    ...(options.tsconfig ? { tsconfig: options.tsconfig } : {}),\n    ...(options.baselineDir ? { baselineDir: options.baselineDir } : {}),\n  };\n\n  // Policy chains and JSON Schemas are multi-line by nature, so asking for\n  // either is asking for the view that can hold them.\n  const detail = options.detail === true || options.explain === true || options.schemas === true;\n  const present = await createPresenter(options);\n\n  // The TypeScript program is read synchronously and the app loads after it;\n  // together that is seconds on a real repository, and a terminal that shows\n  // nothing for them looks wedged.\n  if (!options.json) await present.wait(READING_SOURCE);\n\n  const inventory = readInventory(analysis);\n  const scenarios: ScenarioReport[] = [];\n  const stats: ScenarioStats[] = [];\n  const views: SurfaceView[] = [];\n  const reach = new Map<string, CapabilityReach>();\n  let plan: RuntimePlan | undefined;\n\n  const scope = (): string[] | undefined => plan?.scope ?? staticConfigScope(analysis);\n  const scopedInventory = (): ReturnType<typeof scopeInventory> =>\n    scopeInventory(inventory, scope());\n  const domainCount = (): number | undefined =>\n    plan?.domainManifestConfigured\n      ? scopeCapabilityIds(plan.domainCapabilities, scope()).length\n      : undefined;\n\n  const header = async (): Promise<void> => {\n    present.settle();\n    if (options.json) return;\n    const active = scope();\n    const catalog = scopedInventory();\n    await present.emit(\n      // At `--depth static` the catalog *is* the answer, so it opens the report\n      // beside the run it came from. At every other depth it is a detail behind\n      // the summary, and prints down there instead.\n      {\n        kind: \"blocks\",\n        blocks: runHeaderBlocks(\n          \"SURFACE INSPECT\",\n          {\n            configPath: options.configPath,\n            depth: options.depth,\n            ...(active ? { scope: active } : {}),\n            ...(plan\n              ? { scenarios: plan.scenarios, declaredScenarios: plan.declaredScenarios }\n              : {}),\n          },\n          plan ? undefined : catalog,\n          domainCount(),\n        ),\n      },\n      ...(!plan && catalog\n        ? catalogDetailParts(catalog, { ...(detail ? { detail: true } : {}) })\n        : []),\n    );\n  };\n\n  const runtime = await mountScenarios(analysis, {\n    onPlan: async (current) => {\n      plan = current;\n      await header();\n      if (current.scenarios.length > 0) await present.wait(mountingLabel(current.scenarios, 0));\n    },\n    onEach: async (result) => {\n      const view = buildView(result, {\n        ...(options.explain ? { explain: true } : {}),\n        ...(options.schemas ? { schemas: true } : {}),\n      });\n      trackReach(reach, flatRows(view), result.scenario);\n      stats.push(scenarioStats(result));\n      if (options.json) {\n        scenarios.push(\n          scenarioReport(result, {\n            ...(options.explain ? { attribution: true } : {}),\n            ...(options.schemas ? { schemas: true } : {}),\n          }),\n        );\n      } else {\n        views.push(view);\n      }\n      // Named, and only while there is one left: a spinner announcing work\n      // nobody is doing has to be read twice before it can be dismissed.\n      if (plan && stats.length < plan.scenarios.length) {\n        await present.wait(mountingLabel(plan.scenarios, stats.length));\n      }\n    },\n  });\n  present.settle();\n  if (!runtime) await header();\n\n  const effectiveScope = options.scope ?? runtime?.scope ?? staticConfigScope(analysis);\n  const reportInventory = scopeInventory(inventory, effectiveScope);\n  const reportDomain = runtime?.domainManifestConfigured\n    ? scopeCapabilityIds(runtime.domainCapabilities, effectiveScope)\n    : undefined;\n  const coverage = joinCoverage(inventory, runtime, analysis);\n  const dark = neverCallable(reach);\n\n  if (options.json) {\n    write(\n      JSON.stringify(\n        {\n          // One shape whatever the depth, so a consumer never branches on how\n          // the command was invoked. A half the depth did not compute is\n          // `null`, which is a different statement from `[]` or `{}`.\n          depth: options.depth,\n          catalog: inventoryReport(reportInventory, reportDomain),\n          scenarios,\n          failures: runtime?.failures ?? [],\n          coverage: coverageReport(coverage),\n          // Mounted, and callable in no scenario — a gap the coverage join\n          // cannot see, because every one of these *was* reached.\n          neverCallable: dark.map((entry) => ({\n            capabilityId: entry.capabilityId,\n            outcome: entry.best,\n            ...(entry.note ? { reason: entry.note } : {}),\n            scenarios: entry.scenarios,\n          })),\n        },\n        null,\n        2,\n      ),\n    );\n    return runtime && runtime.failures.length > 0 ? 2 : 0;\n  }\n\n  if (!runtime) return 0;\n\n  // A scenario that threw is not in `stats`, and every count below is missing\n  // whatever it held — so it takes a row of its own rather than appearing only\n  // at the bottom of the report.\n  for (const failure of runtime.failures) {\n    stats.push({\n      scenario: failure.scenario,\n      callable: 0,\n      disabled: 0,\n      hidden: 0,\n      rejected: 0,\n      failed: true,\n      failure: failure.message,\n    });\n  }\n  stats.sort((a, b) => runtime.scenarios.indexOf(a.scenario) - runtime.scenarios.indexOf(b.scenario));\n  const mounted = stats.filter((entry) => !entry.failed).length;\n\n  const parts: ReportPart[] = [\n    {\n      kind: \"blocks\",\n      blocks: [\n        {\n          title: \"SURFACE SUMMARY\",\n          rows: surfaceSummaryRows({\n            depth: options.depth,\n            ...(coverage ? { coverage } : {}),\n            scenarios: stats,\n            failures: runtime.failures.length,\n            reach,\n          }),\n        },\n      ],\n    },\n  ];\n\n  // One row per scenario, so a config with more than one can be compared in a\n  // single place rather than by scrolling through its tables.\n  if (stats.length > 1) {\n    const table = scenarioTable(stats);\n    parts.push({\n      kind: \"table\",\n      title: `SCENARIOS  (${stats.length})`,\n      headers: table.headers,\n      rows: table.rows,\n    });\n  }\n\n  if (runtime.failures.length > 0) {\n    parts.push({\n      kind: \"findings\",\n      stream: \"err\",\n      sections: [\n        failureSection(runtime.failures),\n        ...(inventory ? [noVerdictSection(runtime.failures)] : []),\n      ],\n    });\n  }\n\n  // Over one scenario, \"never callable\" repeats that scenario's own table row\n  // for row. It is a finding only once there is more than one scenario for a\n  // capability to have been callable in.\n  const sections: FindingSection[] = [\n    ...(coverage ? coverageSections(coverage) : []),\n    ...(dark.length > 0 && mounted > 1 ? [neverCallableSection(dark)] : []),\n  ];\n  if (sections.length > 0) parts.push({ kind: \"findings\", sections });\n\n  // Details. The catalog first, because the scenario tables below are what it\n  // is the denominator of.\n  const catalog = scopeInventory(inventory, effectiveScope);\n  if (catalog) {\n    parts.push({\n      kind: \"blocks\",\n      blocks: [\n        {\n          title: \"STATIC CATALOG\",\n          rows: catalogRows(catalog, {\n            ...(domainCount() === undefined ? {} : { domainCapabilities: domainCount()! }),\n            mounted: true,\n          }),\n        },\n      ],\n    });\n  }\n\n  for (const view of views) {\n    parts.push({ kind: \"surface\", view, ...(detail ? { detail: true } : {}) });\n  }\n\n  await present.emit(...parts);\n\n  // A scenario that would not mount is not a finding about the surface, it is\n  // the command failing to observe one. `2` — the same code a usage error gets,\n  // because CI has to tell both apart from \"the surface changed\".\n  return runtime.failures.length > 0 ? 2 : 0;\n}\n"],"mappings":"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","names":["catalog"]}

package/dist/snapshot-5QKLZKZI.js

@@ -1,130 +0,0 @@
-import {
-  scenarioBaseline
-} from "./chunk-Y2LSPEVK.js";
-import {
-  createPresenter,
-  joinCoverage,
-  mountScenarios,
-  readInventory
-} from "./chunk-A5UCBF7D.js";
-import {
-  UsageError,
-  baselinePath,
-  writeBaseline,
-  writeScenarioManifest
-} from "./chunk-GYYWHZPM.js";
-import {
-  READING_SOURCE,
-  buildView,
-  coverageSections,
-  displayPath,
-  failureSection,
-  flatRows,
-  mountingLabel,
-  neverCallable,
-  neverCallableSection,
-  noVerdictSection,
-  runHeaderBlocks,
-  scenarioStats,
-  surfaceSummaryRows,
-  trackReach
-} from "./chunk-NFK3XWWH.js";
-
-// src/commands/snapshot.ts
-async function runSnapshot(options) {
-  if (options.depth === "static") {
-    throw new UsageError(
-      "snapshot --depth static has nothing to write \u2014 a baseline is a projection, and at this depth nothing is mounted."
-    );
-  }
-  const analysis = {
-    configPath: options.configPath,
-    depth: options.depth,
-    ...options.scenario ? { scenario: options.scenario } : {},
-    ...options.scope ? { scope: options.scope } : {},
-    ...options.tsconfig ? { tsconfig: options.tsconfig } : {},
-    ...options.baselineDir ? { baselineDir: options.baselineDir } : {}
-  };
-  const present = await createPresenter(options);
-  await present.wait(READING_SOURCE);
-  const inventory = readInventory(analysis);
-  let scenarios = [];
-  let mountedCount = 0;
-  const runtime = await mountScenarios(analysis, {
-    onPlan: async (plan) => {
-      scenarios = plan.scenarios;
-      await present.emit({
-        kind: "blocks",
-        blocks: runHeaderBlocks("SURFACE SNAPSHOT", {
-          configPath: options.configPath,
-          depth: options.depth,
-          ...plan.scope ? { scope: plan.scope } : {},
-          scenarios: plan.scenarios,
-          declaredScenarios: plan.declaredScenarios
-        })
-      });
-      if (scenarios.length > 0) await present.wait(mountingLabel(scenarios, 0));
-    },
-    onEach: async () => {
-      mountedCount += 1;
-      if (mountedCount < scenarios.length) {
-        await present.wait(mountingLabel(scenarios, mountedCount));
-      }
-    }
-  });
-  present.settle();
-  if (!runtime) throw new UsageError("snapshot needs a mount, and this depth performs none");
-  const written = [];
-  for (const result of runtime.results) {
-    const path = baselinePath(runtime.baselineDir, result.scenario);
-    writeBaseline(path, scenarioBaseline(result));
-    written.push({ cells: [result.scenario, displayPath(path)] });
-  }
-  writeScenarioManifest(runtime.baselineDir, runtime.declaredScenarios);
-  const reach = /* @__PURE__ */ new Map();
-  for (const result of runtime.results) {
-    trackReach(reach, flatRows(buildView(result)), result.scenario);
-  }
-  const coverage = joinCoverage(inventory, runtime, analysis);
-  const stats = runtime.results.map(scenarioStats);
-  const dark = neverCallable(reach);
-  const parts = [
-    { kind: "table", title: `WROTE  (${written.length})`, headers: ["SCENARIO", "FILE"], rows: written }
-  ];
-  const sections = [
-    ...coverage ? coverageSections(coverage) : [],
-    ...dark.length > 0 && stats.length > 1 ? [neverCallableSection(dark)] : []
-  ];
-  if (sections.length > 0) parts.push({ kind: "findings", sections });
-  parts.push({
-    kind: "blocks",
-    blocks: [
-      {
-        title: "SURFACE SUMMARY",
-        rows: surfaceSummaryRows({
-          depth: options.depth,
-          ...coverage ? { coverage } : {},
-          scenarios: stats,
-          failures: runtime.failures.length,
-          reach
-        })
-      }
-    ]
-  });
-  if (runtime.failures.length > 0) {
-    parts.push({
-      kind: "findings",
-      stream: "err",
-      sections: [
-        failureSection(runtime.failures),
-        ...inventory ? [noVerdictSection(runtime.failures)] : []
-      ]
-    });
-  }
-  await present.emit(...parts);
-  return runtime.failures.length > 0 ? 2 : 0;
-}
-export {
-  runSnapshot
-};
-//# sourceMappingURL=snapshot-5QKLZKZI.js.map

package/dist/snapshot-5QKLZKZI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/snapshot.ts"],"sourcesContent":["import {\n  joinCoverage,\n  mountScenarios,\n  readInventory,\n  UsageError,\n  type AnalysisOptions,\n  type Depth,\n} from \"../analysis.js\";\nimport { baselinePath, writeBaseline, writeScenarioManifest } from \"../baseline.js\";\nimport { scenarioBaseline } from \"../report.js\";\nimport { buildView, flatRows } from \"../render/model.js\";\nimport { createPresenter } from \"../render/present.js\";\nimport {\n  coverageSections,\n  displayPath,\n  failureSection,\n  mountingLabel,\n  neverCallable,\n  neverCallableSection,\n  noVerdictSection,\n  READING_SOURCE,\n  runHeaderBlocks,\n  scenarioStats,\n  surfaceSummaryRows,\n  trackReach,\n  type CapabilityReach,\n  type ReportPart,\n} from \"../render/summary.js\";\n\nexport interface SnapshotOptions {\n  configPath: string;\n  depth: Depth;\n  scenario?: string;\n  scope?: string[];\n  tsconfig?: string;\n  baselineDir?: string;\n  json?: boolean;\n  plain?: boolean;\n}\n\n/**\n * Writes (or refreshes) the committed baseline `check` compares against.\n *\n * It prints the coverage verdict too. This is the command you run to *accept* a\n * change to the surface, which makes it the last moment before a reviewer sees\n * the diff — and accepting a projection while a capability sits behind a route\n * no scenario visits is exactly the state worth hearing about. It reports;\n * `check` is still the only thing that fails.\n *\n * Its report opens the way every other one does (`AS-CLI-013`): what the run\n * was pointed at, then what it wrote, then the verdict. It used to open with\n * bare `wrote …` lines and no header at all, which left the one command that\n * *changes committed files* as the only one that never said what it had been\n * pointed at while it did.\n */\nexport async function runSnapshot(options: SnapshotOptions): Promise<number> {\n  if (options.depth === \"static\") {\n    throw new UsageError(\n      \"snapshot --depth static has nothing to write — a baseline is a projection, and \" +\n        \"at this depth nothing is mounted.\",\n    );\n  }\n\n  const analysis: AnalysisOptions = {\n    configPath: options.configPath,\n    depth: options.depth,\n    ...(options.scenario ? { scenario: options.scenario } : {}),\n    ...(options.scope ? { scope: options.scope } : {}),\n    ...(options.tsconfig ? { tsconfig: options.tsconfig } : {}),\n    ...(options.baselineDir ? { baselineDir: options.baselineDir } : {}),\n  };\n\n  const present = await createPresenter(options);\n  await present.wait(READING_SOURCE);\n\n  const inventory = readInventory(analysis);\n  let scenarios: string[] = [];\n  let mountedCount = 0;\n  const runtime = await mountScenarios(analysis, {\n    onPlan: async (plan) => {\n      scenarios = plan.scenarios;\n      await present.emit({\n        kind: \"blocks\",\n        blocks: runHeaderBlocks(\"SURFACE SNAPSHOT\", {\n          configPath: options.configPath,\n          depth: options.depth,\n          ...(plan.scope ? { scope: plan.scope } : {}),\n          scenarios: plan.scenarios,\n          declaredScenarios: plan.declaredScenarios,\n        }),\n      });\n      if (scenarios.length > 0) await present.wait(mountingLabel(scenarios, 0));\n    },\n    onEach: async () => {\n      mountedCount += 1;\n      if (mountedCount < scenarios.length) {\n        await present.wait(mountingLabel(scenarios, mountedCount));\n      }\n    },\n  });\n  present.settle();\n  if (!runtime) throw new UsageError(\"snapshot needs a mount, and this depth performs none\");\n\n  const written: Array<{ cells: string[] }> = [];\n  for (const result of runtime.results) {\n    const path = baselinePath(runtime.baselineDir, result.scenario);\n    writeBaseline(path, scenarioBaseline(result));\n    written.push({ cells: [result.scenario, displayPath(path)] });\n  }\n  writeScenarioManifest(runtime.baselineDir, runtime.declaredScenarios);\n\n  const reach = new Map<string, CapabilityReach>();\n  for (const result of runtime.results) {\n    trackReach(reach, flatRows(buildView(result)), result.scenario);\n  }\n  const coverage = joinCoverage(inventory, runtime, analysis);\n  const stats = runtime.results.map(scenarioStats);\n  const dark = neverCallable(reach);\n\n  const parts: ReportPart[] = [\n    { kind: \"table\", title: `WROTE  (${written.length})`, headers: [\"SCENARIO\", \"FILE\"], rows: written },\n  ];\n\n  // Over one scenario, \"never callable\" repeats that scenario's own table row\n  // for row — see neverCallableSection().\n  const sections = [\n    ...(coverage ? coverageSections(coverage) : []),\n    ...(dark.length > 0 && stats.length > 1 ? [neverCallableSection(dark)] : []),\n  ];\n  if (sections.length > 0) parts.push({ kind: \"findings\", sections });\n\n  parts.push({\n    kind: \"blocks\",\n    blocks: [\n      {\n        title: \"SURFACE SUMMARY\",\n        rows: surfaceSummaryRows({\n          depth: options.depth,\n          ...(coverage ? { coverage } : {}),\n          scenarios: stats,\n          failures: runtime.failures.length,\n          reach,\n        }),\n      },\n    ],\n  });\n\n  if (runtime.failures.length > 0) {\n    // A baseline written for some scenarios and not others is a baseline that\n    // will fail `check` for a reason that has nothing to do with the surface.\n    parts.push({\n      kind: \"findings\",\n      stream: \"err\",\n      sections: [\n        failureSection(runtime.failures),\n        ...(inventory ? [noVerdictSection(runtime.failures)] : []),\n      ],\n    });\n  }\n\n  await present.emit(...parts);\n  return runtime.failures.length > 0 ? 2 : 0;\n}\n"],"mappings":"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","names":[]}

package/dist/vitest.d.ts

@@ -1,30 +0,0 @@
-import { RenderedAgentSurface } from '@agent-surface/testing/react';
-import { AgentConsumer } from '@agent-surface/core';
-import { M as MountResult, S as ScenarioProps, a as SurfaceConfig } from './config-rHD2wEws.js';
-import 'react';
-
-declare const DEFAULT_CLI_CONSUMER: AgentConsumer;
-interface MountScenarioOptions {
-    consumer?: AgentConsumer;
-}
-interface MountedScenario<TApp> {
-    scenario: string;
-    surface: RenderedAgentSurface;
-    mounted: MountResult<TApp>;
-    /**
-     * Whatever `mount()` returned as `app`. Typed as `TApp` rather than
-     * `TApp | undefined` because a config that never sets it infers `TApp` as
-     * `unknown`, and forcing a `!` on every test that *does* set it is worse
-     * than trusting the config's own return type.
-     */
-    app: TApp;
-    consumer: AgentConsumer;
-}
-/**
- * The one mounting path. `agent-surface inspect` and the Vitest helper both
- * come through here, so a scenario cannot behave one way in CI and another in
- * the terminal — which is the entire reason scenarios live in one file.
- */
-declare function mountScenario<TScenario extends ScenarioProps, TApp>(config: SurfaceConfig<TScenario, TApp>, scenario: string, options?: MountScenarioOptions): Promise<MountedScenario<TApp>>;
-
-export { DEFAULT_CLI_CONSUMER, MountResult, type MountScenarioOptions, type MountedScenario, ScenarioProps, SurfaceConfig, mountScenario };

package/dist/vitest.js

@@ -1,9 +0,0 @@
-import {
-  DEFAULT_CLI_CONSUMER,
-  mountScenario
-} from "./chunk-A2G4QLX5.js";
-export {
-  DEFAULT_CLI_CONSUMER,
-  mountScenario
-};
-//# sourceMappingURL=vitest.js.map

package/dist/vitest.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}