@agent-surface/cli 0.12.1 → 0.14.0

package/dist/inspect-XMDZBSK2.js

@@ -1,119 +0,0 @@
-import {
-  coverageReport,
-  inventoryReport,
-  renderCatalogPlain,
-  renderCoveragePlain,
-  renderFailuresPlain,
-  renderNoVerdictPlain,
-  renderSurfacePlain,
-  scenarioReport
-} from "./chunk-J2NN3J5N.js";
-import {
-  buildView
-} from "./chunk-DYDSJM7R.js";
-import {
-  authoredIds,
-  joinCoverage,
-  mountScenarios,
-  readInventory,
-  scopeCapabilityIds,
-  scopeInventory,
-  staticConfigScope
-} from "./chunk-Q5WOLWEW.js";
-import {
-  isPlain,
-  loadInk,
-  paint,
-  write,
-  writeError
-} from "./chunk-QIVOZAWX.js";
-
-// src/commands/inspect.tsx
-import { jsx } from "react/jsx-runtime";
-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);
-  const initialInventory = scopeInventory(inventory, staticConfigScope(analysis));
-  if (initialInventory && !options.json && options.depth === "static") {
-    write(renderCatalogPlain(initialInventory, { standalone: true, detail }));
-  }
-  const ink = isPlain(options) ? null : await loadInk();
-  const scenarios = [];
-  let printed = 0;
-  const runtime = await mountScenarios(analysis, async (result) => {
-    if (options.json) {
-      scenarios.push(
-        scenarioReport(result, {
-          ...options.explain ? { attribution: true } : {},
-          ...options.schemas ? { schemas: 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 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);
-  if (reportInventory && !options.json && options.depth === "full") {
-    write(
-      `${printed > 0 ? "\n" : ""}${renderCatalogPlain(reportInventory, {
-        ...coverage && runtime?.domainManifestConfigured ? { domainCapabilities: coverage.authored - authoredIds(reportInventory).size } : {}
-      })}`
-    );
-  }
-  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)
-        },
-        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-XMDZBSK2.js.map

package/dist/inspect-XMDZBSK2.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/inspect.tsx"],"sourcesContent":["import {\n  joinCoverage,\n  mountScenarios,\n  readInventory,\n  scopeCapabilityIds,\n  scopeInventory,\n  staticConfigScope,\n  type AnalysisOptions,\n  type Depth,\n} from \"../analysis.js\";\nimport { buildView } from \"../render/model.js\";\nimport { authoredIds } from \"../extract.js\";\nimport {\n  renderCatalogPlain,\n  renderCoveragePlain,\n  renderFailuresPlain,\n  renderNoVerdictPlain,\n  renderSurfacePlain,\n} from \"../render/plain.js\";\nimport { isPlain, loadInk, paint, write, writeError } 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 * Each scenario prints as it finishes, so a config with ten of them is not ten\n * mounts of blank terminal. The normalized catalog summary and verdict follow\n * once effective config scope and the domain manifest are known.\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  const initialInventory = scopeInventory(inventory, staticConfigScope(analysis));\n  if (initialInventory && !options.json && options.depth === \"static\") {\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(initialInventory, { standalone: true, detail }));\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: ScenarioReport[] = [];\n  let printed = 0;\n\n  const runtime = await mountScenarios(analysis, async (result) => {\n    if (options.json) {\n      scenarios.push(\n        scenarioReport(result, {\n          ...(options.explain ? { attribution: true } : {}),\n          ...(options.schemas ? { schemas: true } : {}),\n        }),\n      );\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 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  if (reportInventory && !options.json && options.depth === \"full\") {\n    write(\n      `${printed > 0 ? \"\\n\" : \"\"}${renderCatalogPlain(reportInventory, {\n        ...(coverage && runtime?.domainManifestConfigured\n          ? { domainCapabilities: coverage.authored - authoredIds(reportInventory).size }\n          : {}),\n      })}`,\n    );\n  }\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        },\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":"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","names":[]}

package/dist/snapshot-FLXE5UC6.js

@@ -1,61 +0,0 @@
-import {
-  renderCoveragePlain,
-  renderFailuresPlain,
-  scenarioBaseline
-} from "./chunk-J2NN3J5N.js";
-import "./chunk-DYDSJM7R.js";
-import {
-  baselinePath,
-  joinCoverage,
-  mountScenarios,
-  readInventory,
-  writeBaseline,
-  writeScenarioManifest
-} from "./chunk-Q5WOLWEW.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, scenarioBaseline(result));
-    write(`wrote ${relative(process.cwd(), path)}`);
-  }
-  writeScenarioManifest(runtime.baselineDir, runtime.declaredScenarios);
-  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-FLXE5UC6.js.map

package/dist/snapshot-FLXE5UC6.js.map

@@ -1 +0,0 @@
-{"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, writeBaseline, writeScenarioManifest } from \"../baseline.js\";\nimport { scenarioBaseline } from \"../report.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, scenarioBaseline(result));\n    write(`wrote ${relative(process.cwd(), path)}`);\n  }\n  writeScenarioManifest(runtime.baselineDir, runtime.declaredScenarios);\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;AAgCzB,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,iBAAiB,MAAM,CAAC;AAC5C,UAAM,SAAS,SAAS,QAAQ,IAAI,GAAG,IAAI,CAAC,EAAE;AAAA,EAChD;AACA,wBAAsB,QAAQ,aAAa,QAAQ,iBAAiB;AAEpE,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":[]}