@agent-surface/cli 0.9.1 → 0.11.0

package/dist/init-LYYVXFEQ.js

@@ -0,0 +1,141 @@
+import {
+  authoredIds,
+  extractCapabilities,
+  findTsconfig,
+  unresolved
+} from "./chunk-GXXKZTQB.js";
+import {
+  UsageError,
+  isPlain,
+  loadInk,
+  write,
+  writeError
+} from "./chunk-QIVOZAWX.js";
+
+// src/commands/init.tsx
+import { existsSync, writeFileSync } from "fs";
+import { join, relative } from "path";
+import { jsx } from "react/jsx-runtime";
+var CONFIG_NAME = "agent-surface.config.tsx";
+var ENTRY_CANDIDATES = [
+  "src/main.tsx",
+  "src/main.ts",
+  "src/index.tsx",
+  "src/App.tsx",
+  "src/app/App.tsx",
+  "app/root.tsx"
+];
+function scaffold(entry) {
+  const importPath = entry ? `./${entry.replace(/\.tsx?$/, ".js")}` : "./src/App.js";
+  return `import { defineSurface } from "@agent-surface/cli";
+// TODO: point these at your own composition root \u2014 whatever \`main.tsx\` calls.
+// The config should *reuse* how the app builds itself, not restate it.
+import { App } from "${importPath}";
+
+export default defineSurface({
+  mount: ({ user }) => {
+    // TODO: build the app the way the app builds itself, and hand back the
+    // registry it created plus the tree that registers into it.
+    const app = createApp({ environment: "test", user });
+    return { registry: app.registry, ui: <App app={app} />, app };
+  },
+
+  // Named prop bundles. Free-form \u2014 a user, a route, a feature flag; the CLI
+  // never interprets them. Every scenario you leave out is a surface nothing
+  // measures, which is what \`--depth full\` reports as unreached.
+  scenarios: {
+    default: { user: { id: "u_1", permissions: [] } },
+  },
+});
+`;
+}
+async function runInit(options) {
+  const configPath = join(options.cwd, CONFIG_NAME);
+  if (existsSync(configPath)) {
+    throw new UsageError(
+      `${relative(process.cwd(), configPath)} already exists \u2014 edit it, or delete it and re-run`
+    );
+  }
+  const tsconfig = options.tsconfig ?? findTsconfig(options.cwd);
+  if (!tsconfig) {
+    throw new UsageError(
+      `no tsconfig.json found from ${options.cwd} \u2014 agent-surface reads your TypeScript program to find registration call sites, and cannot do that without one`
+    );
+  }
+  const inventory = extractCapabilities({ root: options.cwd, tsconfig });
+  const ids = authoredIds(inventory);
+  const unread = unresolved(inventory);
+  const components = new Set(
+    [...ids].map((id) => id.replace(/^view:/, "").split(".").slice(0, -1).join("."))
+  );
+  write(`Read ${inventory.filesAnalyzed} file${inventory.filesAnalyzed === 1 ? "" : "s"} from ${relative(process.cwd(), tsconfig) || "tsconfig.json"}`);
+  write("");
+  write(`  authored capabilities   ${ids.size}`);
+  write(`  components              ${components.size}`);
+  write(`  unread call sites       ${unread.length}`);
+  if (ids.size === 0) {
+    write("");
+    write(
+      "Nothing is annotated yet \u2014 that is the default, and it is the safe one: a capability exists only where someone wrote one. Start with `useAgentComponent` in a component that owns state worth acting on, then re-run this."
+    );
+  } else {
+    write("");
+    for (const component of [...components].sort()) write(`  ${component}`);
+  }
+  const entry = ENTRY_CANDIDATES.find((candidate) => existsSync(join(options.cwd, candidate)));
+  write("");
+  write(`Write ${relative(process.cwd(), configPath)}?`);
+  write(
+    entry ? `  it will import from ./${entry}, which you will still have to wire into a mount()` : "  no app entry found, so the import line is a placeholder you will have to point somewhere"
+  );
+  if (!options.yes) {
+    const answered = await ask(options, `Write ${CONFIG_NAME}?`);
+    if (!answered) {
+      write("");
+      write("Nothing written.");
+      return 0;
+    }
+  }
+  writeFileSync(configPath, scaffold(entry), "utf8");
+  write("");
+  write(`wrote ${relative(process.cwd(), configPath)}`);
+  write("");
+  write("Next:");
+  write("  1. fill in mount() \u2014 it should call your existing composition root");
+  write("  2. `agent-surface inspect` to see what an agent can reach");
+  write("  3. `agent-surface snapshot` to commit the baseline, then `check` in CI");
+  return 0;
+}
+async function ask(options, question) {
+  if (isPlain(options) || process.stdin.isTTY !== true) {
+    writeError("");
+    writeError("stdin is not a terminal, so there is nobody to ask \u2014 re-run with --yes to accept.");
+    return false;
+  }
+  const ink = await loadInk();
+  if (!ink) {
+    writeError("");
+    writeError("no interactive renderer available here \u2014 re-run with --yes to accept.");
+    return false;
+  }
+  const { render } = await import("ink");
+  return new Promise((resolve) => {
+    const instance = render(
+      /* @__PURE__ */ jsx(
+        ink.Confirm,
+        {
+          question,
+          onAnswer: (yes) => {
+            instance.clear();
+            instance.unmount();
+            resolve(yes);
+          }
+        }
+      )
+    );
+  });
+}
+export {
+  runInit
+};
+//# sourceMappingURL=init-LYYVXFEQ.js.map

package/dist/init-LYYVXFEQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/init.tsx"],"sourcesContent":["import { existsSync, writeFileSync } from \"node:fs\";\nimport { join, relative } from \"node:path\";\nimport { UsageError } from \"../analysis.js\";\nimport { authoredIds, extractCapabilities, findTsconfig, unresolved } from \"../extract.js\";\nimport { isPlain, loadInk, write, writeError } from \"../output.js\";\n\nexport interface InitOptions {\n  cwd: string;\n  tsconfig?: string;\n  yes?: boolean;\n  plain?: boolean;\n}\n\nconst CONFIG_NAME = \"agent-surface.config.tsx\";\n\n/**\n * Where an app is usually assembled. `init` does not *probe* these — it cannot,\n * because a surface config needs a `mount()` that builds the app, and there is\n * no export a tool can import to get one. It names the likeliest file so the\n * scaffold's import line points somewhere real more often than not.\n */\nconst ENTRY_CANDIDATES = [\n  \"src/main.tsx\",\n  \"src/main.ts\",\n  \"src/index.tsx\",\n  \"src/App.tsx\",\n  \"src/app/App.tsx\",\n  \"app/root.tsx\",\n];\n\nfunction scaffold(entry: string | undefined): string {\n  const importPath = entry ? `./${entry.replace(/\\.tsx?$/, \".js\")}` : \"./src/App.js\";\n  return `import { defineSurface } from \"@agent-surface/cli\";\n// TODO: point these at your own composition root — whatever \\`main.tsx\\` calls.\n// The config should *reuse* how the app builds itself, not restate it.\nimport { App } from \"${importPath}\";\n\nexport default defineSurface({\n  mount: ({ user }) => {\n    // TODO: build the app the way the app builds itself, and hand back the\n    // registry it created plus the tree that registers into it.\n    const app = createApp({ environment: \"test\", user });\n    return { registry: app.registry, ui: <App app={app} />, app };\n  },\n\n  // Named prop bundles. Free-form — a user, a route, a feature flag; the CLI\n  // never interprets them. Every scenario you leave out is a surface nothing\n  // measures, which is what \\`--depth full\\` reports as unreached.\n  scenarios: {\n    default: { user: { id: \"u_1\", permissions: [] } },\n  },\n});\n`;\n}\n\n/**\n * `agent-surface init` — the on-ramp.\n *\n * It reads the codebase first and writes nothing before it has shown you what\n * it found. That order is the whole point: the number it prints is the one\n * every later command is relative to, and a scaffold that appears before the\n * summary asks you to accept a config for a codebase neither of you has looked\n * at yet.\n *\n * It mounts nothing and needs no config to exist — it is `--depth static` with\n * a file write on the end.\n */\nexport async function runInit(options: InitOptions): Promise<number> {\n  const configPath = join(options.cwd, CONFIG_NAME);\n  if (existsSync(configPath)) {\n    throw new UsageError(\n      `${relative(process.cwd(), configPath)} already exists — edit it, or delete it and re-run`,\n    );\n  }\n\n  const tsconfig = options.tsconfig ?? findTsconfig(options.cwd);\n  if (!tsconfig) {\n    throw new UsageError(\n      `no tsconfig.json found from ${options.cwd} — agent-surface reads your TypeScript program ` +\n        \"to find registration call sites, and cannot do that without one\",\n    );\n  }\n\n  const inventory = extractCapabilities({ root: options.cwd, tsconfig });\n  const ids = authoredIds(inventory);\n  const unread = unresolved(inventory);\n  const components = new Set(\n    [...ids].map((id) => id.replace(/^view:/, \"\").split(\".\").slice(0, -1).join(\".\")),\n  );\n\n  write(`Read ${inventory.filesAnalyzed} file${inventory.filesAnalyzed === 1 ? \"\" : \"s\"} from ${relative(process.cwd(), tsconfig) || \"tsconfig.json\"}`);\n  write(\"\");\n  write(`  authored capabilities   ${ids.size}`);\n  write(`  components              ${components.size}`);\n  write(`  unread call sites       ${unread.length}`);\n\n  if (ids.size === 0) {\n    write(\"\");\n    write(\n      \"Nothing is annotated yet — that is the default, and it is the safe one: a capability \" +\n        \"exists only where someone wrote one. Start with `useAgentComponent` in a component \" +\n        \"that owns state worth acting on, then re-run this.\",\n    );\n  } else {\n    write(\"\");\n    for (const component of [...components].sort()) write(`  ${component}`);\n  }\n\n  const entry = ENTRY_CANDIDATES.find((candidate) => existsSync(join(options.cwd, candidate)));\n  write(\"\");\n  write(`Write ${relative(process.cwd(), configPath)}?`);\n  write(\n    entry\n      ? `  it will import from ./${entry}, which you will still have to wire into a mount()`\n      : \"  no app entry found, so the import line is a placeholder you will have to point somewhere\",\n  );\n\n  if (!options.yes) {\n    const answered = await ask(options, `Write ${CONFIG_NAME}?`);\n    if (!answered) {\n      write(\"\");\n      write(\"Nothing written.\");\n      return 0;\n    }\n  }\n\n  writeFileSync(configPath, scaffold(entry), \"utf8\");\n  write(\"\");\n  write(`wrote ${relative(process.cwd(), configPath)}`);\n  write(\"\");\n  write(\"Next:\");\n  write(\"  1. fill in mount() — it should call your existing composition root\");\n  write(\"  2. `agent-surface inspect` to see what an agent can reach\");\n  write(\"  3. `agent-surface snapshot` to commit the baseline, then `check` in CI\");\n  return 0;\n}\n\n/**\n * There is no prompt to give when nothing is attached to answer it. Failing\n * with the flag that would have worked beats writing a file the caller never\n * agreed to, and beats hanging on a read that will never return.\n */\nasync function ask(options: InitOptions, question: string): Promise<boolean> {\n  if (isPlain(options) || process.stdin.isTTY !== true) {\n    writeError(\"\");\n    writeError(\"stdin is not a terminal, so there is nobody to ask — re-run with --yes to accept.\");\n    return false;\n  }\n  const ink = await loadInk();\n  if (!ink) {\n    writeError(\"\");\n    writeError(\"no interactive renderer available here — re-run with --yes to accept.\");\n    return false;\n  }\n  const { render } = await import(\"ink\");\n  return new Promise<boolean>((resolve) => {\n    const instance = render(\n      <ink.Confirm\n        question={question}\n        onAnswer={(yes) => {\n          instance.clear();\n          instance.unmount();\n          resolve(yes);\n        }}\n      />,\n    );\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/ink-P23VKP4H.js

@@ -0,0 +1,217 @@
+import {
+  flatRows
+} from "./chunk-DYDSJM7R.js";
+
+// src/render/ink.tsx
+import { Box, Static, Text, useInput } from "ink";
+import Spinner from "ink-spinner";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var OUTCOME = {
+  expose: { mark: "\u25CF", color: "green", state: "callable" },
+  disable: { mark: "\u25D0", color: "yellow", state: "disabled" },
+  hide: { mark: "\u25CB", color: "red", state: "hidden" }
+};
+var NONE = "\u2014";
+function widthsFor(headers, rows) {
+  return headers.map(
+    (header, column) => Math.max(header.length, ...rows.map((row) => (row[column] ?? "").length))
+  );
+}
+function pad(value, width) {
+  return value.padEnd(width);
+}
+function Confirm({
+  question,
+  onAnswer
+}) {
+  useInput((input, key) => {
+    if (key.return || input.toLowerCase() === "y") onAnswer(true);
+    else if (key.escape || input.toLowerCase() === "n" || key.ctrl && input === "c") {
+      onAnswer(false);
+    }
+  });
+  return /* @__PURE__ */ jsxs(Box, { marginTop: 1, children: [
+    /* @__PURE__ */ jsx(Text, { bold: true, children: question }),
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "  (Y/n) " })
+  ] });
+}
+function Loading({ label }) {
+  return /* @__PURE__ */ jsxs(Text, { children: [
+    /* @__PURE__ */ jsx(Text, { color: "cyan", children: /* @__PURE__ */ jsx(Spinner, { type: "dots" }) }),
+    ` ${label}`
+  ] });
+}
+function PolicyLine({
+  policy
+}) {
+  const vote = policy.discovery?.decision;
+  const color = vote === "hide" ? "red" : vote === "disable" ? "yellow" : "green";
+  return /* @__PURE__ */ jsxs(Box, { paddingLeft: 6, children: [
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "policy " }),
+    /* @__PURE__ */ jsx(Text, { bold: true, children: policy.name }),
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: ` (${policy.scope}${policy.phases.length ? `, ${policy.phases.join("/")}` : ""}) ` }),
+    vote ? /* @__PURE__ */ jsxs(Text, { color, children: [
+      vote,
+      policy.discovery?.decision === "disable" ? ` \u2014 ${policy.discovery.reason}` : ""
+    ] }) : /* @__PURE__ */ jsx(Text, { dimColor: true, children: "no discovery hook" }),
+    policy.threw ? /* @__PURE__ */ jsx(Text, { color: "red", bold: true, children: " THREW" }) : null,
+    policy.confirmationEscalation ? /* @__PURE__ */ jsx(Text, { color: "magenta", children: " escalates-confirmation" }) : null
+  ] });
+}
+function Capability({ row }) {
+  const outcome = OUTCOME[row.outcome];
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsx(Text, { color: outcome.color, children: `  ${outcome.mark} ` }),
+      /* @__PURE__ */ jsx(Text, { bold: true, children: row.name }),
+      row.tags.length > 0 ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${row.tags.join(" \xB7 ")}` }) : null
+    ] }),
+    /* @__PURE__ */ jsx(Box, { paddingLeft: 4, children: /* @__PURE__ */ jsx(Text, { dimColor: true, wrap: "wrap", children: row.description }) }),
+    row.reason ? /* @__PURE__ */ jsx(Box, { paddingLeft: 4, children: /* @__PURE__ */ jsx(Text, { color: "yellow", wrap: "wrap", children: `\u2937 ${row.reason}` }) }) : null,
+    row.policies ? row.policies.length > 0 ? row.policies.map((policy, index) => /* @__PURE__ */ jsx(PolicyLine, { policy }, `${policy.name}-${index}`)) : [
+      /* @__PURE__ */ jsx(Box, { paddingLeft: 6, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: "policies: none" }) }, "none")
+    ] : null,
+    row.policies && row.availability && !row.availability.available ? /* @__PURE__ */ jsx(Box, { paddingLeft: 6, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: `availability: unavailable${row.availability.reason ? ` \u2014 ${row.availability.reason}` : ""}` }) }) : null,
+    row.schemas?.input !== void 0 ? /* @__PURE__ */ jsx(Box, { paddingLeft: 6, children: /* @__PURE__ */ jsx(Text, { dimColor: true, wrap: "wrap", children: `input: ${JSON.stringify(row.schemas.input)}` }) }) : null,
+    row.schemas?.output !== void 0 ? /* @__PURE__ */ jsx(Box, { paddingLeft: 6, children: /* @__PURE__ */ jsx(Text, { dimColor: true, wrap: "wrap", children: `output: ${JSON.stringify(row.schemas.output)}` }) }) : null
+  ] });
+}
+function Group({ group }) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsx(Text, { backgroundColor: "blueBright", color: "black", bold: true, children: ` ${group.heading} ` }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${group.rows.length}` })
+    ] }),
+    group.rows.map((row) => /* @__PURE__ */ jsx(Capability, { row }, `${row.capabilityId}-${row.name}`))
+  ] });
+}
+function Header({ view }) {
+  return /* @__PURE__ */ jsxs(Box, { children: [
+    /* @__PURE__ */ jsx(Text, { bold: true, children: view.scenario }),
+    view.route ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${view.route}` }) : null,
+    view.scope && view.scope.length > 0 ? /* @__PURE__ */ jsx(Text, { color: "cyan", children: `  scope ${view.scope.join(" ")}` }) : null,
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "  \xB7  " }),
+    /* @__PURE__ */ jsx(Text, { color: "green", children: `${view.counts.callable} callable` }),
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: ", " }),
+    /* @__PURE__ */ jsx(Text, { color: "yellow", children: `${view.counts.disabled} visible-disabled` }),
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: ", " }),
+    /* @__PURE__ */ jsx(Text, { color: "red", children: `${view.counts.hidden} hidden` }),
+    view.rejections.length > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: ", " }),
+      /* @__PURE__ */ jsx(Text, { color: "magenta", children: `${view.rejections.length} registration${view.rejections.length === 1 ? "" : "s"} rejected` })
+    ] }) : null
+  ] });
+}
+function Rejections({ view }) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsx(Text, { backgroundColor: "magenta", color: "black", bold: true, children: " rejected during mount " }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${view.rejections.length}` })
+    ] }),
+    view.rejections.map((rejection) => /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsx(Text, { color: "magenta", children: "  ! " }),
+      /* @__PURE__ */ jsx(Text, { bold: true, children: `${rejection.componentType} (${rejection.instanceId})` }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: rejection.reason === "duplicate" ? "  duplicate \u2014 an earlier registration holds this key" : "  guard \u2014 onRegister rejected this registration" })
+    ] }, `${rejection.componentType}@${rejection.instanceId}-${rejection.reason}`))
+  ] });
+}
+function Empty({ view }) {
+  if (view.counts.hidden > 0) {
+    return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+      /* @__PURE__ */ jsxs(Text, { dimColor: true, wrap: "wrap", children: [
+        `Nothing is callable here \u2014 all ${view.counts.hidden} registered capabilities were hidden by policy. `,
+        "The surface is empty by decision, not because nothing was annotated."
+      ] }),
+      view.explained ? null : /* @__PURE__ */ jsx(Text, { dimColor: true, children: "Re-run with --explain to see which policy hid them." })
+    ] });
+  }
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsx(Text, { dimColor: true, wrap: "wrap", children: "Nothing is registered for this scenario \u2014 the agent has no surface here. That is the default: capabilities exist only where they were explicitly annotated." }),
+    view.explained ? null : /* @__PURE__ */ jsx(Text, { dimColor: true, children: "Re-run with --explain to see whether a policy hid it." })
+  ] });
+}
+var HEADERS = ["CAPABILITY", "KIND", "EFFECT", "STATE", "FLAGS"];
+function cellsFor(row) {
+  return [
+    row.path,
+    row.kind,
+    row.effect ?? NONE,
+    OUTCOME[row.outcome].state,
+    row.flags.length > 0 ? row.flags.join(" \xB7 ") : NONE
+  ];
+}
+function TableRow({
+  row,
+  cells,
+  widths
+}) {
+  const outcome = OUTCOME[row.outcome];
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsx(Text, { bold: true, children: `${pad(cells[0], widths[0])}  ` }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: `${pad(cells[1], widths[1])}  ` }),
+      /* @__PURE__ */ jsx(Text, { children: `${pad(cells[2], widths[2])}  ` }),
+      /* @__PURE__ */ jsx(Text, { color: outcome.color, children: `${pad(cells[3], widths[3])}  ` }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: cells[4] })
+    ] }),
+    row.reason ? /* @__PURE__ */ jsx(Box, { paddingLeft: 4, children: /* @__PURE__ */ jsx(Text, { color: "yellow", wrap: "wrap", children: `\u2937 ${row.reason}` }) }) : null
+  ] });
+}
+function CapabilityTable({ rows }) {
+  const cells = rows.map(cellsFor);
+  const widths = widthsFor(HEADERS, cells);
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsx(Box, { children: HEADERS.map((header, column) => /* @__PURE__ */ jsx(Text, { dimColor: true, bold: true, children: column === HEADERS.length - 1 ? header : `${pad(header, widths[column])}  ` }, header)) }),
+    rows.map((row, index) => /* @__PURE__ */ jsx(
+      TableRow,
+      {
+        row,
+        cells: cells[index],
+        widths
+      },
+      `${row.capabilityId}-${index}`
+    ))
+  ] });
+}
+function Surface({
+  view,
+  detail
+}) {
+  const populated = view.groups.filter((group) => group.rows.length > 0);
+  const rows = flatRows(view);
+  const blocks = [
+    { key: "__header" },
+    ...detail ? populated.map((group) => ({ key: group.heading, group })) : rows.length > 0 ? [{ key: "__table", rows }] : []
+  ];
+  return /* @__PURE__ */ jsx(Static, { items: blocks, children: (block) => block.group ? /* @__PURE__ */ jsx(Group, { group: block.group }, block.key) : block.rows ? /* @__PURE__ */ jsx(CapabilityTable, { rows: block.rows }, block.key) : /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx(Header, { view }),
+    view.rejections.length > 0 ? /* @__PURE__ */ jsx(Rejections, { view }) : null,
+    rows.length === 0 ? /* @__PURE__ */ jsx(Empty, { view }) : null
+  ] }, block.key) });
+}
+function Coverage({ report }) {
+  const clean = report.unreached.length === 0 && report.unresolved.length === 0 && report.staleAllowlist.length === 0;
+  return /* @__PURE__ */ jsx(Static, { items: [{ key: "__coverage" }], children: (block) => /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+    report.unreached.length > 0 ? /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsxs(Box, { children: [
+        /* @__PURE__ */ jsx(Text, { backgroundColor: "red", color: "black", bold: true, children: " UNREACHED " }),
+        /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  authored, and no scenario mounts it  ${report.unreached.length}` })
+      ] }),
+      report.unreached.map((entry) => /* @__PURE__ */ jsxs(Box, { paddingLeft: 2, children: [
+        /* @__PURE__ */ jsx(Text, { bold: true, children: entry.capabilityId }),
+        /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${entry.origin.file}:${entry.origin.line}` })
+      ] }, entry.capabilityId))
+    ] }) : null,
+    /* @__PURE__ */ jsxs(Box, { marginTop: report.unreached.length > 0 ? 1 : 0, children: [
+      /* @__PURE__ */ jsx(Text, { color: clean ? "green" : "red", bold: true, children: `${report.authored} authored \xB7 ${report.reached} reached \xB7 ${report.unreached.length} unreached` }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${report.scenarios.join(", ")}` })
+    ] })
+  ] }, block.key) });
+}
+export {
+  Confirm,
+  Coverage,
+  Loading,
+  Surface
+};
+//# sourceMappingURL=ink-P23VKP4H.js.map

package/dist/ink-P23VKP4H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/render/ink.tsx"],"sourcesContent":["import type { ReactElement } from \"react\";\nimport { Box, Static, Text, useInput } from \"ink\";\nimport Spinner from \"ink-spinner\";\nimport type { CapabilityRow, CapabilityGroup, SurfaceView } from \"./model.js\";\nimport { flatRows } from \"./model.js\";\nimport type { CoverageReport } from \"../coverage.js\";\n\nconst OUTCOME = {\n  expose: { mark: \"●\", color: \"green\" as const, state: \"callable\" },\n  disable: { mark: \"◐\", color: \"yellow\" as const, state: \"disabled\" },\n  hide: { mark: \"○\", color: \"red\" as const, state: \"hidden\" },\n};\n\nconst NONE = \"—\";\n\n/**\n * Same column widths as the plain renderer computes, and for the same reason:\n * from the content, never from the terminal. A TTY table that reflows on resize\n * and a piped table that does not would be two different renderings of one view\n * model, which is exactly what this file exists to prevent.\n */\nfunction widthsFor(headers: string[], rows: string[][]): number[] {\n  return headers.map((header, column) =>\n    Math.max(header.length, ...rows.map((row) => (row[column] ?? \"\").length)),\n  );\n}\n\nfunction pad(value: string, width: number): string {\n  return value.padEnd(width);\n}\n\n/**\n * `init`'s one question. Enter accepts, because the answer this asks for is the\n * one the summary above it has already made the case for — and because a\n * scaffold is the least destructive thing this package writes.\n */\nexport function Confirm({\n  question,\n  onAnswer,\n}: {\n  question: string;\n  onAnswer: (yes: boolean) => void;\n}): ReactElement {\n  useInput((input, key) => {\n    if (key.return || input.toLowerCase() === \"y\") onAnswer(true);\n    else if (key.escape || input.toLowerCase() === \"n\" || (key.ctrl && input === \"c\")) {\n      onAnswer(false);\n    }\n  });\n  return (\n    <Box marginTop={1}>\n      <Text bold>{question}</Text>\n      <Text dimColor>{\"  (Y/n) \"}</Text>\n    </Box>\n  );\n}\n\nexport function Loading({ label }: { label: string }): ReactElement {\n  return (\n    <Text>\n      <Text color=\"cyan\">\n        <Spinner type=\"dots\" />\n      </Text>\n      {` ${label}`}\n    </Text>\n  );\n}\n\nfunction PolicyLine({\n  policy,\n}: {\n  policy: NonNullable<CapabilityRow[\"policies\"]>[number];\n}): ReactElement {\n  const vote = policy.discovery?.decision;\n  const color = vote === \"hide\" ? \"red\" : vote === \"disable\" ? \"yellow\" : \"green\";\n  return (\n    <Box paddingLeft={6}>\n      <Text dimColor>policy </Text>\n      <Text bold>{policy.name}</Text>\n      <Text dimColor>{` (${policy.scope}${policy.phases.length ? `, ${policy.phases.join(\"/\")}` : \"\"}) `}</Text>\n      {vote ? (\n        <Text color={color}>\n          {vote}\n          {policy.discovery?.decision === \"disable\" ? ` — ${policy.discovery.reason}` : \"\"}\n        </Text>\n      ) : (\n        <Text dimColor>no discovery hook</Text>\n      )}\n      {policy.threw ? <Text color=\"red\" bold>{\" THREW\"}</Text> : null}\n      {policy.confirmationEscalation ? (\n        <Text color=\"magenta\">{\" escalates-confirmation\"}</Text>\n      ) : null}\n    </Box>\n  );\n}\n\nfunction Capability({ row }: { row: CapabilityRow }): ReactElement {\n  const outcome = OUTCOME[row.outcome];\n  return (\n    <Box flexDirection=\"column\" marginTop={1}>\n      <Box>\n        <Text color={outcome.color}>{`  ${outcome.mark} `}</Text>\n        <Text bold>{row.name}</Text>\n        {row.tags.length > 0 ? <Text dimColor>{`  ${row.tags.join(\" · \")}`}</Text> : null}\n      </Box>\n      <Box paddingLeft={4}>\n        <Text dimColor wrap=\"wrap\">\n          {row.description}\n        </Text>\n      </Box>\n      {row.reason ? (\n        <Box paddingLeft={4}>\n          <Text color=\"yellow\" wrap=\"wrap\">{`⤷ ${row.reason}`}</Text>\n        </Box>\n      ) : null}\n      {row.policies\n        ? row.policies.length > 0\n          ? row.policies.map((policy, index) => (\n              <PolicyLine key={`${policy.name}-${index}`} policy={policy} />\n            ))\n          : [\n              <Box key=\"none\" paddingLeft={6}>\n                <Text dimColor>policies: none</Text>\n              </Box>,\n            ]\n        : null}\n      {row.policies && row.availability && !row.availability.available ? (\n        <Box paddingLeft={6}>\n          <Text dimColor>{`availability: unavailable${\n            row.availability.reason ? ` — ${row.availability.reason}` : \"\"\n          }`}</Text>\n        </Box>\n      ) : null}\n      {row.schemas?.input !== undefined ? (\n        <Box paddingLeft={6}>\n          <Text dimColor wrap=\"wrap\">{`input: ${JSON.stringify(row.schemas.input)}`}</Text>\n        </Box>\n      ) : null}\n      {row.schemas?.output !== undefined ? (\n        <Box paddingLeft={6}>\n          <Text dimColor wrap=\"wrap\">{`output: ${JSON.stringify(row.schemas.output)}`}</Text>\n        </Box>\n      ) : null}\n    </Box>\n  );\n}\n\nfunction Group({ group }: { group: CapabilityGroup }): ReactElement {\n  return (\n    <Box flexDirection=\"column\" marginTop={1}>\n      <Box>\n        <Text backgroundColor=\"blueBright\" color=\"black\" bold>{` ${group.heading} `}</Text>\n        <Text dimColor>{`  ${group.rows.length}`}</Text>\n      </Box>\n      {group.rows.map((row) => (\n        <Capability key={`${row.capabilityId}-${row.name}`} row={row} />\n      ))}\n    </Box>\n  );\n}\n\n/**\n * The header states everything the counts are relative to (`AS-CLI-007`): the\n * scenario, the route, and the scope when one is active — a scope filters both\n * projections, so an unqualified count reads as a claim about the whole surface.\n * `hidden` is unconditional here for the same reason it is in plain text.\n */\nfunction Header({ view }: { view: SurfaceView }): ReactElement {\n  return (\n    <Box>\n      <Text bold>{view.scenario}</Text>\n      {view.route ? <Text dimColor>{`  ${view.route}`}</Text> : null}\n      {view.scope && view.scope.length > 0 ? (\n        <Text color=\"cyan\">{`  scope ${view.scope.join(\" \")}`}</Text>\n      ) : null}\n      <Text dimColor>{\"  ·  \"}</Text>\n      <Text color=\"green\">{`${view.counts.callable} callable`}</Text>\n      <Text dimColor>{\", \"}</Text>\n      <Text color=\"yellow\">{`${view.counts.disabled} visible-disabled`}</Text>\n      <Text dimColor>{\", \"}</Text>\n      <Text color=\"red\">{`${view.counts.hidden} hidden`}</Text>\n      {view.rejections.length > 0 ? (\n        <>\n          <Text dimColor>{\", \"}</Text>\n          <Text color=\"magenta\">\n            {`${view.rejections.length} registration${\n              view.rejections.length === 1 ? \"\" : \"s\"\n            } rejected`}\n          </Text>\n        </>\n      ) : null}\n    </Box>\n  );\n}\n\n/**\n * Rejected registrations (`AS-CLI-006`). A dead handle leaves no trace in either\n * projection, so without this block a copy-pasted component `type` removes a\n * capability and prints nothing anywhere.\n */\nfunction Rejections({ view }: { view: SurfaceView }): ReactElement {\n  return (\n    <Box flexDirection=\"column\" marginTop={1}>\n      <Box>\n        <Text backgroundColor=\"magenta\" color=\"black\" bold>\n          {\" rejected during mount \"}\n        </Text>\n        <Text dimColor>{`  ${view.rejections.length}`}</Text>\n      </Box>\n      {view.rejections.map((rejection) => (\n        <Box key={`${rejection.componentType}@${rejection.instanceId}-${rejection.reason}`}>\n          <Text color=\"magenta\">{\"  ! \"}</Text>\n          <Text bold>{`${rejection.componentType} (${rejection.instanceId})`}</Text>\n          <Text dimColor>\n            {rejection.reason === \"duplicate\"\n              ? \"  duplicate — an earlier registration holds this key\"\n              : \"  guard — onRegister rejected this registration\"}\n          </Text>\n        </Box>\n      ))}\n    </Box>\n  );\n}\n\nfunction Empty({ view }: { view: SurfaceView }): ReactElement {\n  if (view.counts.hidden > 0) {\n    return (\n      <Box flexDirection=\"column\" marginTop={1}>\n        <Text dimColor wrap=\"wrap\">\n          {`Nothing is callable here — all ${view.counts.hidden} registered capabilities were hidden by policy. `}\n          The surface is empty by decision, not because nothing was annotated.\n        </Text>\n        {view.explained ? null : (\n          <Text dimColor>Re-run with --explain to see which policy hid them.</Text>\n        )}\n      </Box>\n    );\n  }\n  return (\n    <Box flexDirection=\"column\" marginTop={1}>\n      <Text dimColor wrap=\"wrap\">\n        Nothing is registered for this scenario — the agent has no surface here. That is the\n        default: capabilities exist only where they were explicitly annotated.\n      </Text>\n      {view.explained ? null : (\n        <Text dimColor>Re-run with --explain to see whether a policy hid it.</Text>\n      )}\n    </Box>\n  );\n}\n\nconst HEADERS = [\"CAPABILITY\", \"KIND\", \"EFFECT\", \"STATE\", \"FLAGS\"];\n\nfunction cellsFor(row: CapabilityRow): string[] {\n  return [\n    row.path,\n    row.kind,\n    row.effect ?? NONE,\n    OUTCOME[row.outcome].state,\n    row.flags.length > 0 ? row.flags.join(\" · \") : NONE,\n  ];\n}\n\nfunction TableRow({\n  row,\n  cells,\n  widths,\n}: {\n  row: CapabilityRow;\n  cells: string[];\n  widths: number[];\n}): ReactElement {\n  const outcome = OUTCOME[row.outcome];\n  return (\n    <Box flexDirection=\"column\">\n      <Box>\n        <Text bold>{`${pad(cells[0]!, widths[0]!)}  `}</Text>\n        <Text dimColor>{`${pad(cells[1]!, widths[1]!)}  `}</Text>\n        <Text>{`${pad(cells[2]!, widths[2]!)}  `}</Text>\n        <Text color={outcome.color}>{`${pad(cells[3]!, widths[3]!)}  `}</Text>\n        <Text dimColor>{cells[4]!}</Text>\n      </Box>\n      {row.reason ? (\n        <Box paddingLeft={4}>\n          <Text color=\"yellow\" wrap=\"wrap\">{`⤷ ${row.reason}`}</Text>\n        </Box>\n      ) : null}\n    </Box>\n  );\n}\n\n/**\n * One capability per line, aligned — the scanning view, and the default. The\n * grouped paragraphs below stay for `--detail`, `--explain` and `--schemas`,\n * whose payloads (policy chains, JSON Schemas) cannot live in a table cell.\n */\nfunction CapabilityTable({ rows }: { rows: CapabilityRow[] }): ReactElement {\n  const cells = rows.map(cellsFor);\n  const widths = widthsFor(HEADERS, cells);\n  return (\n    <Box flexDirection=\"column\" marginTop={1}>\n      <Box>\n        {HEADERS.map((header, column) => (\n          <Text key={header} dimColor bold>\n            {column === HEADERS.length - 1 ? header : `${pad(header, widths[column]!)}  `}\n          </Text>\n        ))}\n      </Box>\n      {rows.map((row, index) => (\n        <TableRow\n          key={`${row.capabilityId}-${index}`}\n          row={row}\n          cells={cells[index]!}\n          widths={widths}\n        />\n      ))}\n    </Box>\n  );\n}\n\ntype Block = { key: string; group?: CapabilityGroup; rows?: CapabilityRow[] };\n\nexport function Surface({\n  view,\n  detail,\n}: {\n  view: SurfaceView;\n  detail?: boolean;\n}): ReactElement {\n  const populated = view.groups.filter((group) => group.rows.length > 0);\n  const rows = flatRows(view);\n\n  // Everything goes through <Static>, header included. Ink paints static output\n  // once, permanently, above the live frame — and erases the live frame on\n  // unmount. A one-shot render that leaves anything outside <Static> therefore\n  // prints it and then wipes it, which is exactly what happened to this header.\n  const blocks: Block[] = [\n    { key: \"__header\" },\n    ...(detail\n      ? populated.map((group) => ({ key: group.heading, group }))\n      : rows.length > 0\n        ? [{ key: \"__table\", rows }]\n        : []),\n  ];\n\n  return (\n    <Static items={blocks}>\n      {(block) =>\n        block.group ? (\n          <Group key={block.key} group={block.group} />\n        ) : block.rows ? (\n          <CapabilityTable key={block.key} rows={block.rows} />\n        ) : (\n          <Box key={block.key} flexDirection=\"column\">\n            <Header view={view} />\n            {view.rejections.length > 0 ? <Rejections view={view} /> : null}\n            {rows.length === 0 ? <Empty view={view} /> : null}\n          </Box>\n        )\n      }\n    </Static>\n  );\n}\n\n/**\n * The verdict — authored minus reached. The finding the command surface used to\n * keep behind a fifth command, so it is the last thing painted and the thing a\n * reader stops on.\n */\nexport function Coverage({ report }: { report: CoverageReport }): ReactElement {\n  const clean =\n    report.unreached.length === 0 &&\n    report.unresolved.length === 0 &&\n    report.staleAllowlist.length === 0;\n\n  return (\n    <Static items={[{ key: \"__coverage\" }]}>\n      {(block) => (\n        <Box key={block.key} flexDirection=\"column\" marginTop={1}>\n          {report.unreached.length > 0 ? (\n            <Box flexDirection=\"column\">\n              <Box>\n                <Text backgroundColor=\"red\" color=\"black\" bold>\n                  {\" UNREACHED \"}\n                </Text>\n                <Text dimColor>{`  authored, and no scenario mounts it  ${report.unreached.length}`}</Text>\n              </Box>\n              {report.unreached.map((entry) => (\n                <Box key={entry.capabilityId} paddingLeft={2}>\n                  <Text bold>{entry.capabilityId}</Text>\n                  <Text dimColor>{`  ${entry.origin.file}:${entry.origin.line}`}</Text>\n                </Box>\n              ))}\n            </Box>\n          ) : null}\n          <Box marginTop={report.unreached.length > 0 ? 1 : 0}>\n            <Text color={clean ? \"green\" : \"red\"} bold>\n              {`${report.authored} authored · ${report.reached} reached · ${report.unreached.length} unreached`}\n            </Text>\n            <Text dimColor>{`  ${report.scenarios.join(\", \")}`}</Text>\n          </Box>\n        </Box>\n      )}\n    </Static>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/inspect-3CBRKTDM.js

@@ -0,0 +1,108 @@
+import {
+  renderCatalogPlain,
+  renderCoveragePlain,
+  renderFailuresPlain,
+  renderNoVerdictPlain,
+  renderSurfacePlain
+} from "./chunk-RXX63JSL.js";
+import {
+  buildView
+} from "./chunk-DYDSJM7R.js";
+import {
+  joinCoverage,
+  mountScenarios,
+  readInventory
+} from "./chunk-GXXKZTQB.js";
+import {
+  isPlain,
+  loadInk,
+  paint,
+  write,
+  writeError
+} from "./chunk-QIVOZAWX.js";
+
+// src/commands/inspect.tsx
+import { jsx } from "react/jsx-runtime";
+function jsonForScenario(result, explain) {
+  return {
+    scenario: result.scenario,
+    ...result.scope ? { scope: result.scope } : {},
+    snapshot: result.snapshot,
+    // Unconditional, and unconditionally present even when empty (`AS-CLI-006`):
+    // a consumer that has to distinguish "no rejections" from "this CLI predates
+    // the field" cannot rely on an absent key.
+    rejections: result.rejections,
+    ...explain ? { explanation: result.explanation } : {}
+  };
+}
+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 inventory = readInventory(analysis);
+  if (inventory && !options.json) {
+    write(renderCatalogPlain(inventory, { standalone: options.depth === "static" }));
+  }
+  const ink = isPlain(options) ? null : await loadInk();
+  const scenarios = [];
+  let printed = 0;
+  const runtime = await mountScenarios(analysis, async (result) => {
+    if (options.json) {
+      scenarios.push(jsonForScenario(result, options.explain === true));
+      return;
+    }
+    const view = buildView(result, {
+      ...options.explain ? { explain: true } : {},
+      ...options.schemas ? { schemas: true } : {}
+    });
+    if (ink) await paint(/* @__PURE__ */ jsx(ink.Surface, { view, detail }));
+    else {
+      const rendered = renderSurfacePlain(view, { detail });
+      write(printed === 0 && !inventory ? rendered : `
+${rendered}`);
+    }
+    printed += 1;
+  });
+  const coverage = joinCoverage(inventory, runtime, analysis);
+  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: inventory ?? null,
+          scenarios,
+          failures: runtime?.failures ?? [],
+          coverage: coverage ?? null
+        },
+        null,
+        2
+      )
+    );
+    return runtime && runtime.failures.length > 0 ? 2 : 0;
+  }
+  if (runtime && runtime.failures.length > 0) {
+    writeError(`
+${renderFailuresPlain(runtime.failures)}`);
+  }
+  if (coverage) {
+    write("");
+    write(renderCoveragePlain(coverage));
+  } else if (inventory && runtime && runtime.failures.length > 0) {
+    writeError(`
+${renderNoVerdictPlain(runtime.failures)}`);
+  }
+  return runtime && runtime.failures.length > 0 ? 2 : 0;
+}
+export {
+  runInspect
+};
+//# sourceMappingURL=inspect-3CBRKTDM.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/inspect.tsx"],"sourcesContent":["import {\n  joinCoverage,\n  mountScenarios,\n  readInventory,\n  type AnalysisOptions,\n  type Depth,\n} from \"../analysis.js\";\nimport { buildView } from \"../render/model.js\";\nimport {\n  renderCatalogPlain,\n  renderCoveragePlain,\n  renderFailuresPlain,\n  renderNoVerdictPlain,\n  renderSurfacePlain,\n} from \"../render/plain.js\";\nimport { isPlain, loadInk, paint, transient, write, writeError } from \"../output.js\";\nimport type { CollectResult } from \"../collect.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\nfunction jsonForScenario(result: CollectResult, explain: boolean): Record<string, unknown> {\n  return {\n    scenario: result.scenario,\n    ...(result.scope ? { scope: result.scope } : {}),\n    snapshot: result.snapshot,\n    // Unconditional, and unconditionally present even when empty (`AS-CLI-006`):\n    // a consumer that has to distinguish \"no rejections\" from \"this CLI predates\n    // the field\" cannot rely on an absent key.\n    rejections: result.rejections,\n    ...(explain ? { explanation: result.explanation } : {}),\n  };\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 * **Order is the design.** The catalog prints first because it is ready before\n * anything mounts; each scenario prints as it finishes, so a config with ten of\n * them is not ten mounts of blank terminal; the verdict prints last, because it\n * is the only part that needs every scenario to have finished — and because a\n * reader who stops at the bottom should stop on the finding.\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\n  const inventory = readInventory(analysis);\n  if (inventory && !options.json) {\n    // At `--depth static` this listing is the output. At `--depth full` the\n    // scenario tables below carry the same capabilities and the verdict names\n    // the ones they miss, so only the summary line prints here.\n    write(renderCatalogPlain(inventory, { standalone: options.depth === \"static\" }));\n  }\n\n  // `null` when Ink cannot run here (React 18 host), which is a fallback to\n  // plain text rather than a failed command — see loadInk().\n  const ink = isPlain(options) ? null : await loadInk();\n  const scenarios: Array<Record<string, unknown>> = [];\n  let printed = 0;\n\n  const runtime = await mountScenarios(analysis, async (result) => {\n    if (options.json) {\n      scenarios.push(jsonForScenario(result, options.explain === true));\n      return;\n    }\n    const view = buildView(result, {\n      ...(options.explain ? { explain: true } : {}),\n      ...(options.schemas ? { schemas: true } : {}),\n    });\n    if (ink) await paint(<ink.Surface view={view} detail={detail} />);\n    else {\n      const rendered = renderSurfacePlain(view, { detail });\n      write(printed === 0 && !inventory ? rendered : `\\n${rendered}`);\n    }\n    printed += 1;\n  });\n\n  const coverage = joinCoverage(inventory, runtime, analysis);\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: inventory ?? null,\n          scenarios,\n          failures: runtime?.failures ?? [],\n          coverage: coverage ?? null,\n        },\n        null,\n        2,\n      ),\n    );\n    return runtime && runtime.failures.length > 0 ? 2 : 0;\n  }\n\n  if (runtime && runtime.failures.length > 0) {\n    writeError(`\\n${renderFailuresPlain(runtime.failures)}`);\n  }\n  if (coverage) {\n    write(\"\");\n    write(renderCoveragePlain(coverage));\n  } else if (inventory && runtime && runtime.failures.length > 0) {\n    writeError(`\\n${renderNoVerdictPlain(runtime.failures)}`);\n  }\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 && runtime.failures.length > 0 ? 2 : 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAiGyB;AAjEzB,SAAS,gBAAgB,QAAuB,SAA2C;AACzF,SAAO;AAAA,IACL,UAAU,OAAO;AAAA,IACjB,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,IAC9C,UAAU,OAAO;AAAA;AAAA;AAAA;AAAA,IAIjB,YAAY,OAAO;AAAA,IACnB,GAAI,UAAU,EAAE,aAAa,OAAO,YAAY,IAAI,CAAC;AAAA,EACvD;AACF;AAiBA,eAAsB,WAAW,SAA0C;AACzE,QAAM,WAA4B;AAAA,IAChC,YAAY,QAAQ;AAAA,IACpB,OAAO,QAAQ;AAAA,IACf,GAAI,QAAQ,WAAW,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;AAAA,IACzD,GAAI,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,IAChD,GAAI,QAAQ,WAAW,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;AAAA,IACzD,GAAI,QAAQ,cAAc,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;AAAA,EACpE;AAIA,QAAM,SAAS,QAAQ,WAAW,QAAQ,QAAQ,YAAY,QAAQ,QAAQ,YAAY;AAE1F,QAAM,YAAY,cAAc,QAAQ;AACxC,MAAI,aAAa,CAAC,QAAQ,MAAM;AAI9B,UAAM,mBAAmB,WAAW,EAAE,YAAY,QAAQ,UAAU,SAAS,CAAC,CAAC;AAAA,EACjF;AAIA,QAAM,MAAM,QAAQ,OAAO,IAAI,OAAO,MAAM,QAAQ;AACpD,QAAM,YAA4C,CAAC;AACnD,MAAI,UAAU;AAEd,QAAM,UAAU,MAAM,eAAe,UAAU,OAAO,WAAW;AAC/D,QAAI,QAAQ,MAAM;AAChB,gBAAU,KAAK,gBAAgB,QAAQ,QAAQ,YAAY,IAAI,CAAC;AAChE;AAAA,IACF;AACA,UAAM,OAAO,UAAU,QAAQ;AAAA,MAC7B,GAAI,QAAQ,UAAU,EAAE,SAAS,KAAK,IAAI,CAAC;AAAA,MAC3C,GAAI,QAAQ,UAAU,EAAE,SAAS,KAAK,IAAI,CAAC;AAAA,IAC7C,CAAC;AACD,QAAI,IAAK,OAAM,MAAM,oBAAC,IAAI,SAAJ,EAAY,MAAY,QAAgB,CAAE;AAAA,SAC3D;AACH,YAAM,WAAW,mBAAmB,MAAM,EAAE,OAAO,CAAC;AACpD,YAAM,YAAY,KAAK,CAAC,YAAY,WAAW;AAAA,EAAK,QAAQ,EAAE;AAAA,IAChE;AACA,eAAW;AAAA,EACb,CAAC;AAED,QAAM,WAAW,aAAa,WAAW,SAAS,QAAQ;AAE1D,MAAI,QAAQ,MAAM;AAChB;AAAA,MACE,KAAK;AAAA,QACH;AAAA;AAAA;AAAA;AAAA,UAIE,OAAO,QAAQ;AAAA,UACf,SAAS,aAAa;AAAA,UACtB;AAAA,UACA,UAAU,SAAS,YAAY,CAAC;AAAA,UAChC,UAAU,YAAY;AAAA,QACxB;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AACA,WAAO,WAAW,QAAQ,SAAS,SAAS,IAAI,IAAI;AAAA,EACtD;AAEA,MAAI,WAAW,QAAQ,SAAS,SAAS,GAAG;AAC1C,eAAW;AAAA,EAAK,oBAAoB,QAAQ,QAAQ,CAAC,EAAE;AAAA,EACzD;AACA,MAAI,UAAU;AACZ,UAAM,EAAE;AACR,UAAM,oBAAoB,QAAQ,CAAC;AAAA,EACrC,WAAW,aAAa,WAAW,QAAQ,SAAS,SAAS,GAAG;AAC9D,eAAW;AAAA,EAAK,qBAAqB,QAAQ,QAAQ,CAAC,EAAE;AAAA,EAC1D;AAKA,SAAO,WAAW,QAAQ,SAAS,SAAS,IAAI,IAAI;AACtD;","names":[]}

package/dist/snapshot-DJ22WCT4.js

@@ -0,0 +1,59 @@
+import {
+  renderCoveragePlain,
+  renderFailuresPlain
+} from "./chunk-RXX63JSL.js";
+import "./chunk-DYDSJM7R.js";
+import {
+  baselinePath,
+  joinCoverage,
+  mountScenarios,
+  normalize,
+  readInventory,
+  writeBaseline
+} from "./chunk-GXXKZTQB.js";
+import {
+  UsageError,
+  write,
+  writeError
+} from "./chunk-QIVOZAWX.js";
+
+// src/commands/snapshot.ts
+import { relative } from "path";
+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 inventory = readInventory(analysis);
+  const runtime = await mountScenarios(analysis);
+  if (!runtime) throw new UsageError("snapshot needs a mount, and this depth performs none");
+  for (const result of runtime.results) {
+    const path = baselinePath(runtime.baselineDir, result.scenario);
+    writeBaseline(path, normalize(result.snapshot));
+    write(`wrote ${relative(process.cwd(), path)}`);
+  }
+  const coverage = joinCoverage(inventory, runtime, analysis);
+  if (coverage) {
+    write("");
+    write(renderCoveragePlain(coverage));
+  }
+  if (runtime.failures.length > 0) {
+    writeError(`
+${renderFailuresPlain(runtime.failures)}`);
+    return 2;
+  }
+  return 0;
+}
+export {
+  runSnapshot
+};
+//# sourceMappingURL=snapshot-DJ22WCT4.js.map

package/dist/snapshot-DJ22WCT4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/snapshot.ts"],"sourcesContent":["import { relative } from \"node:path\";\nimport {\n  joinCoverage,\n  mountScenarios,\n  readInventory,\n  UsageError,\n  type AnalysisOptions,\n  type Depth,\n} from \"../analysis.js\";\nimport { baselinePath, normalize, writeBaseline } from \"../baseline.js\";\nimport { renderCoveragePlain, renderFailuresPlain } from \"../render/plain.js\";\nimport { write, writeError } from \"../output.js\";\n\nexport interface SnapshotOptions {\n  configPath: string;\n  depth: Depth;\n  scenario?: string;\n  scope?: string[];\n  tsconfig?: string;\n  baselineDir?: string;\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 */\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 inventory = readInventory(analysis);\n  const runtime = await mountScenarios(analysis);\n  if (!runtime) throw new UsageError(\"snapshot needs a mount, and this depth performs none\");\n\n  for (const result of runtime.results) {\n    const path = baselinePath(runtime.baselineDir, result.scenario);\n    writeBaseline(path, normalize(result.snapshot));\n    write(`wrote ${relative(process.cwd(), path)}`);\n  }\n\n  const coverage = joinCoverage(inventory, runtime, analysis);\n  if (coverage) {\n    write(\"\");\n    write(renderCoveragePlain(coverage));\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    writeError(`\\n${renderFailuresPlain(runtime.failures)}`);\n    return 2;\n  }\n  return 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,SAAS,gBAAgB;AA+BzB,eAAsB,YAAY,SAA2C;AAC3E,MAAI,QAAQ,UAAU,UAAU;AAC9B,UAAM,IAAI;AAAA,MACR;AAAA,IAEF;AAAA,EACF;AAEA,QAAM,WAA4B;AAAA,IAChC,YAAY,QAAQ;AAAA,IACpB,OAAO,QAAQ;AAAA,IACf,GAAI,QAAQ,WAAW,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;AAAA,IACzD,GAAI,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,IAChD,GAAI,QAAQ,WAAW,EAAE,UAAU,QAAQ,SAAS,IAAI,CAAC;AAAA,IACzD,GAAI,QAAQ,cAAc,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;AAAA,EACpE;AAEA,QAAM,YAAY,cAAc,QAAQ;AACxC,QAAM,UAAU,MAAM,eAAe,QAAQ;AAC7C,MAAI,CAAC,QAAS,OAAM,IAAI,WAAW,sDAAsD;AAEzF,aAAW,UAAU,QAAQ,SAAS;AACpC,UAAM,OAAO,aAAa,QAAQ,aAAa,OAAO,QAAQ;AAC9D,kBAAc,MAAM,UAAU,OAAO,QAAQ,CAAC;AAC9C,UAAM,SAAS,SAAS,QAAQ,IAAI,GAAG,IAAI,CAAC,EAAE;AAAA,EAChD;AAEA,QAAM,WAAW,aAAa,WAAW,SAAS,QAAQ;AAC1D,MAAI,UAAU;AACZ,UAAM,EAAE;AACR,UAAM,oBAAoB,QAAQ,CAAC;AAAA,EACrC;AAEA,MAAI,QAAQ,SAAS,SAAS,GAAG;AAG/B,eAAW;AAAA,EAAK,oBAAoB,QAAQ,QAAQ,CAAC,EAAE;AACvD,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}