@agent-surface/cli 0.19.1 → 0.20.1

package/dist/bin.js

@@ -3,12 +3,12 @@ import {
   DEFAULT_SNAPSHOT,
   readBaseManifest,
   readManifest,
-  renderReport,
   writeManifest
-} from "./chunk-X6RGGBQ4.js";
+} from "./chunk-XCQACLOT.js";
 import {
-  diffContracts
-} from "./chunk-IA7FUP4R.js";
+  diffContracts,
+  renderReport
+} from "./chunk-KMAH2WU5.js";
 
 // src/bin.ts
 import { realpathSync } from "fs";
@@ -71,12 +71,13 @@ function shouldFail(policy, changes) {
 }
 async function present(report, options) {
   const interactive = options.format === "human" && !options.plain && process.stdout.isTTY === true && !process.env["CI"] && !process.env["NO_COLOR"];
+  const render = { root: options.root, ...options.detail ? { detail: true } : {} };
   if (interactive) {
-    const { renderInk } = await import("./ink-E6DATMUQ.js");
-    await renderInk(report);
+    const { renderInk } = await import("./ink-4CUU77KD.js");
+    await renderInk(report, render);
     return;
   }
-  process.stdout.write(renderReport(report, options.format));
+  process.stdout.write(renderReport(report, options.format, render));
 }
 async function runInspect(options) {
   const manifest = await compile(options);
@@ -139,24 +140,33 @@ async function runCheck(options) {
 var USAGE = `agent-surface \u2014 compiled production capability contract
 
 Usage
-  agent-surface inspect
-  agent-surface snapshot
-  agent-surface check --base origin/main --format github
+  agent-surface inspect [options]     view the contract and any drift
+  agent-surface snapshot [options]    write the committed contract
+  agent-surface check [options]       fail on drift, for CI
 
-Options
+Compilation
   --root <path>       application root (default: cwd)
   --config <path>     Vite config, relative to root
-  --snapshot <path>   committed contract (default: .agent-surface/contract.json)
   --target <name>     production build target; repeatable
-  --base <git-ref>    render committed PR drift against Git base
   --allow <pkg>=<d>   approve a dependency to contribute capabilities; repeatable
+
+Contract
+  --snapshot <path>   committed contract (default: .agent-surface/contract.json)
+  --base <git-ref>    render committed PR drift against Git base
   --policy <mode>     all | widening | narrowing | neutral | none (default: all)
+
+Output
+  --detail            add descriptions, confirmation, policies, and tags
   --format <format>   human | json | github | markdown (default: human)
   --json              alias for --format json
-  --plain             disable Ink terminal rendering
+  --plain             plain text instead of the drawn terminal view
   -h, --help
   -v, --version
 
+Examples
+  agent-surface inspect --detail
+  agent-surface check --base origin/main --format github
+
 Exit: 0 clean/viewed, 1 deterministic drift/policy finding, 2 completeness failure.
 `;
 var COMMANDS = /* @__PURE__ */ new Set(["inspect", "snapshot", "check"]);
@@ -166,11 +176,15 @@ function write(text, error = false) {
   (error ? process.stderr : process.stdout).write(text.endsWith("\n") ? text : `${text}
 `);
 }
+function stripSeparator(argv) {
+  const index = argv.indexOf("--");
+  return index === -1 ? argv : [...argv.slice(0, index), ...argv.slice(index + 1)];
+}
 async function main(argv = process.argv.slice(2)) {
   let parsed;
   try {
     parsed = parseArgs({
-      args: argv,
+      args: stripSeparator(argv),
       allowPositionals: true,
       options: {
         root: { type: "string", default: process.cwd() },
@@ -183,6 +197,7 @@ async function main(argv = process.argv.slice(2)) {
         format: { type: "string", default: "human" },
         json: { type: "boolean", default: false },
         plain: { type: "boolean", default: false },
+        detail: { type: "boolean", default: false },
         help: { type: "boolean", short: "h", default: false },
         version: { type: "boolean", short: "v", default: false }
       }
@@ -236,7 +251,8 @@ async function main(argv = process.argv.slice(2)) {
     format,
     policy: values.policy,
     ...allow.length > 0 ? { externalContracts: { allow } } : {},
-    ...values.plain ? { plain: true } : {}
+    ...values.plain ? { plain: true } : {},
+    ...values.detail ? { detail: true } : {}
   };
   try {
     if (command === "inspect") return await runInspect(options);

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bin.ts","../src/commands.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { realpathSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { parseArgs } from \"node:util\";\nimport { runCheck, runInspect, runSnapshot, type CommandOptions } from \"./commands.js\";\nimport type { OutputFormat } from \"./report.js\";\n\nconst USAGE = `agent-surface — compiled production capability contract\n\nUsage\n  agent-surface inspect\n  agent-surface snapshot\n  agent-surface check --base origin/main --format github\n\nOptions\n  --root <path>       application root (default: cwd)\n  --config <path>     Vite config, relative to root\n  --snapshot <path>   committed contract (default: .agent-surface/contract.json)\n  --target <name>     production build target; repeatable\n  --base <git-ref>    render committed PR drift against Git base\n  --allow <pkg>=<d>   approve a dependency to contribute capabilities; repeatable\n  --policy <mode>     all | widening | narrowing | neutral | none (default: all)\n  --format <format>   human | json | github | markdown (default: human)\n  --json              alias for --format json\n  --plain             disable Ink terminal rendering\n  -h, --help\n  -v, --version\n\nExit: 0 clean/viewed, 1 deterministic drift/policy finding, 2 completeness failure.\n`;\n\nconst COMMANDS = new Set([\"inspect\", \"snapshot\", \"check\"]);\nconst FORMATS = new Set<OutputFormat>([\"human\", \"json\", \"github\", \"markdown\"]);\nconst POLICIES = new Set([\"all\", \"widening\", \"narrowing\", \"neutral\", \"none\"]);\n\nfunction write(text: string, error = false): void {\n  (error ? process.stderr : process.stdout).write(text.endsWith(\"\\n\") ? text : `${text}\\n`);\n}\n\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<number> {\n  let parsed;\n  try {\n    parsed = parseArgs({\n      args: argv,\n      allowPositionals: true,\n      options: {\n        root: { type: \"string\", default: process.cwd() },\n        config: { type: \"string\" },\n        snapshot: { type: \"string\" },\n        target: { type: \"string\", multiple: true },\n        base: { type: \"string\" },\n        allow: { type: \"string\", multiple: true },\n        policy: { type: \"string\", default: \"all\" },\n        format: { type: \"string\", default: \"human\" },\n        json: { type: \"boolean\", default: false },\n        plain: { type: \"boolean\", default: false },\n        help: { type: \"boolean\", short: \"h\", default: false },\n        version: { type: \"boolean\", short: \"v\", default: false },\n      },\n    });\n  } catch (error) {\n    write(error instanceof Error ? error.message : String(error), true);\n    write(USAGE, true);\n    return 2;\n  }\n  const { values, positionals } = parsed;\n  if (values.help) {\n    write(USAGE);\n    return 0;\n  }\n  if (values.version) {\n    write(await readVersion());\n    return 0;\n  }\n  const [command, ...extra] = positionals;\n  if (!command || !COMMANDS.has(command) || extra.length > 0) {\n    write(command === \"init\" ? \"init removed: configure the Vite compiler plugin\" : `invalid command ${command ?? \"\"}`, true);\n    write(USAGE, true);\n    return 2;\n  }\n  const format = (values.json ? \"json\" : values.format) as OutputFormat;\n  if (!FORMATS.has(format)) {\n    write(`--format must be human, json, github, or markdown`, true);\n    return 2;\n  }\n  if (!POLICIES.has(values.policy)) {\n    write(`--policy must be all, widening, narrowing, neutral, or none`, true);\n    return 2;\n  }\n  const allow = [];\n  for (const entry of values.allow ?? []) {\n    const separator = entry.lastIndexOf(\"=\");\n    const name = separator === -1 ? \"\" : entry.slice(0, separator);\n    const digest = separator === -1 ? \"\" : entry.slice(separator + 1);\n    if (!name || !/^[0-9a-f]{64}$/.test(digest)) {\n      write(`--allow must be <package>=<sha256>, got \"${entry}\"`, true);\n      return 2;\n    }\n    allow.push({ package: name, digest });\n  }\n  const options: CommandOptions = {\n    root: values.root,\n    ...(values.config ? { configFile: values.config } : {}),\n    ...(values.snapshot ? { snapshot: values.snapshot } : {}),\n    targets: values.target ?? [],\n    ...(values.base ? { base: values.base } : {}),\n    format,\n    policy: values.policy as CommandOptions[\"policy\"],\n    ...(allow.length > 0 ? { externalContracts: { allow } } : {}),\n    ...(values.plain ? { plain: true } : {}),\n  };\n  try {\n    if (command === \"inspect\") return await runInspect(options);\n    if (command === \"snapshot\") return await runSnapshot(options);\n    return await runCheck(options);\n  } catch (error) {\n    write(error instanceof Error ? error.message : String(error), true);\n    if (error instanceof Error && error.stack && process.env[\"AGENT_SURFACE_DEBUG\"]) {\n      write(error.stack, true);\n    }\n    return 2;\n  }\n}\n\nasync function readVersion(): Promise<string> {\n  const { readFileSync } = await import(\"node:fs\");\n  const path = fileURLToPath(new URL(\"../package.json\", import.meta.url));\n  return (JSON.parse(readFileSync(path, \"utf8\")) as { version: string }).version;\n}\n\nfunction invokedAsBinary(): boolean {\n  const entry = process.argv[1];\n  if (!entry) return false;\n  try {\n    return fileURLToPath(import.meta.url) === realpathSync(entry);\n  } catch {\n    return false;\n  }\n}\n\nif (invokedAsBinary()) {\n  void main().then((code) => {\n    process.exitCode = code;\n  });\n}\n","import { resolve } from \"node:path\";\nimport type { CapabilityContractEntry, CapabilityContractManifest } from \"@agent-surface/core\";\nimport {\n  compileCapabilityContract,\n  computeManifestHash,\n  type ExternalContractPolicy,\n} from \"@agent-surface/compiler\";\nimport { diffContracts, type ChangeClassification } from \"./diff.js\";\nimport { DEFAULT_SNAPSHOT, readBaseManifest, readManifest, writeManifest } from \"./files.js\";\nimport type { ContractReport, OutputFormat } from \"./report.js\";\nimport { renderReport } from \"./report.js\";\n\nexport interface CommandOptions {\n  root: string;\n  configFile?: string;\n  snapshot?: string;\n  targets: string[];\n  base?: string;\n  format: OutputFormat;\n  policy: \"all\" | ChangeClassification | \"none\";\n  /** Dependencies approved to contribute, as `--allow <package>=<sha256>`. */\n  externalContracts?: ExternalContractPolicy;\n  plain?: boolean;\n}\n\nfunction mergeManifests(manifests: CapabilityContractManifest[]): CapabilityContractManifest {\n  const entries = new Map<string, CapabilityContractEntry>();\n  for (const manifest of manifests) {\n    for (const entry of manifest.capabilities) {\n      const key = `${entry.declarationId}\\0${entry.capabilityId}`;\n      const existing = entries.get(key);\n      if (!existing) entries.set(key, { ...entry, targets: [...entry.targets] });\n      else {\n        if (existing.contractHash !== entry.contractHash) {\n          throw new Error(`contract ${entry.declarationId} / ${entry.capabilityId} differs across targets`);\n        }\n        existing.targets = [...new Set([...existing.targets, ...entry.targets])].sort();\n      }\n    }\n  }\n  const payload = {\n    formatVersion: 5 as const,\n    compilerVersion: manifests[0]?.compilerVersion ?? \"unknown\",\n    targets: [...new Set(manifests.flatMap((manifest) => manifest.targets))].sort(),\n    capabilities: [...entries.values()].sort((a, b) =>\n      `${a.declarationId}\\0${a.capabilityId}`.localeCompare(`${b.declarationId}\\0${b.capabilityId}`),\n    ),\n    // One attribution per package: the same dependency contributes identically\n    // to every target, and a divergence would already have failed the compile.\n    externalContracts: manifests\n      .flatMap((manifest) => manifest.externalContracts)\n      .filter((entry, index, all) => all.findIndex((candidate) => candidate.package === entry.package) === index)\n      .sort((a, b) => a.package.localeCompare(b.package)),\n    completeness: { status: \"proven\" as const },\n  };\n  return { ...payload, hash: computeManifestHash(payload) };\n}\n\nasync function compile(options: CommandOptions): Promise<CapabilityContractManifest> {\n  const targets = options.targets.length > 0 ? options.targets : [\"web-production\"];\n  const manifests = await Promise.all(\n    targets.map((target) =>\n      compileCapabilityContract({\n        root: options.root,\n        ...(options.configFile ? { configFile: options.configFile } : {}),\n        ...(options.externalContracts ? { externalContracts: options.externalContracts } : {}),\n        target,\n      }),\n    ),\n  );\n  return mergeManifests(manifests);\n}\n\nfunction shouldFail(\n  policy: CommandOptions[\"policy\"],\n  changes: ReturnType<typeof diffContracts>,\n): boolean {\n  if (policy === \"none\") return false;\n  if (policy === \"all\") return changes.length > 0;\n  return changes.some((change) => change.classification === policy);\n}\n\nasync function present(report: ContractReport, options: CommandOptions): Promise<void> {\n  const interactive =\n    options.format === \"human\" &&\n    !options.plain &&\n    process.stdout.isTTY === true &&\n    !process.env[\"CI\"] &&\n    !process.env[\"NO_COLOR\"];\n  if (interactive) {\n    const { renderInk } = await import(\"./ink.js\");\n    await renderInk(report);\n    return;\n  }\n  process.stdout.write(renderReport(report, options.format));\n}\n\nexport async function runInspect(options: CommandOptions): Promise<number> {\n  const manifest = await compile(options);\n  const snapshotPath = resolve(options.root, options.snapshot ?? DEFAULT_SNAPSHOT);\n  const snapshot = readManifest(snapshotPath);\n  const integrityChanges = diffContracts(snapshot, manifest);\n  const report: ContractReport = {\n    command: \"inspect\",\n    status: \"view\",\n    manifest,\n    snapshotPath,\n    integrity: {\n      status: !snapshot ? \"missing\" : snapshot.hash === manifest.hash ? \"current\" : \"stale\",\n      changes: integrityChanges,\n    },\n    ...(options.base\n      ? {\n          pullRequest: {\n            base: options.base,\n            changes: diffContracts(readBaseManifest(options.base, snapshotPath, options.root), manifest),\n          },\n        }\n      : {}),\n  };\n  await present(report, options);\n  return 0;\n}\n\nexport async function runSnapshot(options: CommandOptions): Promise<number> {\n  const manifest = await compile(options);\n  const snapshotPath = resolve(options.root, options.snapshot ?? DEFAULT_SNAPSHOT);\n  writeManifest(snapshotPath, manifest);\n  await present({ command: \"snapshot\", status: \"written\", manifest, snapshotPath }, options);\n  return 0;\n}\n\nexport async function runCheck(options: CommandOptions): Promise<number> {\n  const manifest = await compile(options);\n  const snapshotPath = resolve(options.root, options.snapshot ?? DEFAULT_SNAPSHOT);\n  const snapshot = readManifest(snapshotPath);\n  const integrityChanges = diffContracts(snapshot, manifest);\n  const integrityCurrent = snapshot?.hash === manifest.hash;\n  const pr = options.base\n    ? {\n        base: options.base,\n        changes: diffContracts(readBaseManifest(options.base, snapshotPath, options.root), snapshot ?? manifest),\n      }\n    : undefined;\n  const failed = !integrityCurrent || (pr ? shouldFail(options.policy, pr.changes) : false);\n  const report: ContractReport = {\n    command: \"check\",\n    status: failed ? \"fail\" : \"pass\",\n    manifest,\n    snapshotPath,\n    integrity: {\n      status: !snapshot ? \"missing\" : integrityCurrent ? \"current\" : \"stale\",\n      changes: integrityChanges,\n    },\n    ...(pr ? { pullRequest: pr } : {}),\n  };\n  await present(report, options);\n  return failed ? 1 : 0;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/bin.ts","../src/commands.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { realpathSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { parseArgs } from \"node:util\";\nimport { runCheck, runInspect, runSnapshot, type CommandOptions } from \"./commands.js\";\nimport type { OutputFormat } from \"./report.js\";\n\nconst USAGE = `agent-surface — compiled production capability contract\n\nUsage\n  agent-surface inspect [options]     view the contract and any drift\n  agent-surface snapshot [options]    write the committed contract\n  agent-surface check [options]       fail on drift, for CI\n\nCompilation\n  --root <path>       application root (default: cwd)\n  --config <path>     Vite config, relative to root\n  --target <name>     production build target; repeatable\n  --allow <pkg>=<d>   approve a dependency to contribute capabilities; repeatable\n\nContract\n  --snapshot <path>   committed contract (default: .agent-surface/contract.json)\n  --base <git-ref>    render committed PR drift against Git base\n  --policy <mode>     all | widening | narrowing | neutral | none (default: all)\n\nOutput\n  --detail            add descriptions, confirmation, policies, and tags\n  --format <format>   human | json | github | markdown (default: human)\n  --json              alias for --format json\n  --plain             plain text instead of the drawn terminal view\n  -h, --help\n  -v, --version\n\nExamples\n  agent-surface inspect --detail\n  agent-surface check --base origin/main --format github\n\nExit: 0 clean/viewed, 1 deterministic drift/policy finding, 2 completeness failure.\n`;\n\nconst COMMANDS = new Set([\"inspect\", \"snapshot\", \"check\"]);\nconst FORMATS = new Set<OutputFormat>([\"human\", \"json\", \"github\", \"markdown\"]);\nconst POLICIES = new Set([\"all\", \"widening\", \"narrowing\", \"neutral\", \"none\"]);\n\nfunction write(text: string, error = false): void {\n  (error ? process.stderr : process.stdout).write(text.endsWith(\"\\n\") ? text : `${text}\\n`);\n}\n\n/**\n * `pnpm run <script> -- --plain` forwards the separator itself, and `parseArgs`\n * turns everything after it into positionals — so the flag arrived as a second\n * command and the run failed as `invalid command inspect`. This CLI takes no\n * literal operands, so the first separator is dropped and the pass-through\n * idiom every package manager documents works.\n */\nfunction stripSeparator(argv: string[]): string[] {\n  const index = argv.indexOf(\"--\");\n  return index === -1 ? argv : [...argv.slice(0, index), ...argv.slice(index + 1)];\n}\n\nexport async function main(argv: string[] = process.argv.slice(2)): Promise<number> {\n  let parsed;\n  try {\n    parsed = parseArgs({\n      args: stripSeparator(argv),\n      allowPositionals: true,\n      options: {\n        root: { type: \"string\", default: process.cwd() },\n        config: { type: \"string\" },\n        snapshot: { type: \"string\" },\n        target: { type: \"string\", multiple: true },\n        base: { type: \"string\" },\n        allow: { type: \"string\", multiple: true },\n        policy: { type: \"string\", default: \"all\" },\n        format: { type: \"string\", default: \"human\" },\n        json: { type: \"boolean\", default: false },\n        plain: { type: \"boolean\", default: false },\n        detail: { type: \"boolean\", default: false },\n        help: { type: \"boolean\", short: \"h\", default: false },\n        version: { type: \"boolean\", short: \"v\", default: false },\n      },\n    });\n  } catch (error) {\n    write(error instanceof Error ? error.message : String(error), true);\n    write(USAGE, true);\n    return 2;\n  }\n  const { values, positionals } = parsed;\n  if (values.help) {\n    write(USAGE);\n    return 0;\n  }\n  if (values.version) {\n    write(await readVersion());\n    return 0;\n  }\n  const [command, ...extra] = positionals;\n  if (!command || !COMMANDS.has(command) || extra.length > 0) {\n    write(command === \"init\" ? \"init removed: configure the Vite compiler plugin\" : `invalid command ${command ?? \"\"}`, true);\n    write(USAGE, true);\n    return 2;\n  }\n  const format = (values.json ? \"json\" : values.format) as OutputFormat;\n  if (!FORMATS.has(format)) {\n    write(`--format must be human, json, github, or markdown`, true);\n    return 2;\n  }\n  if (!POLICIES.has(values.policy)) {\n    write(`--policy must be all, widening, narrowing, neutral, or none`, true);\n    return 2;\n  }\n  const allow = [];\n  for (const entry of values.allow ?? []) {\n    const separator = entry.lastIndexOf(\"=\");\n    const name = separator === -1 ? \"\" : entry.slice(0, separator);\n    const digest = separator === -1 ? \"\" : entry.slice(separator + 1);\n    if (!name || !/^[0-9a-f]{64}$/.test(digest)) {\n      write(`--allow must be <package>=<sha256>, got \"${entry}\"`, true);\n      return 2;\n    }\n    allow.push({ package: name, digest });\n  }\n  const options: CommandOptions = {\n    root: values.root,\n    ...(values.config ? { configFile: values.config } : {}),\n    ...(values.snapshot ? { snapshot: values.snapshot } : {}),\n    targets: values.target ?? [],\n    ...(values.base ? { base: values.base } : {}),\n    format,\n    policy: values.policy as CommandOptions[\"policy\"],\n    ...(allow.length > 0 ? { externalContracts: { allow } } : {}),\n    ...(values.plain ? { plain: true } : {}),\n    ...(values.detail ? { detail: true } : {}),\n  };\n  try {\n    if (command === \"inspect\") return await runInspect(options);\n    if (command === \"snapshot\") return await runSnapshot(options);\n    return await runCheck(options);\n  } catch (error) {\n    write(error instanceof Error ? error.message : String(error), true);\n    if (error instanceof Error && error.stack && process.env[\"AGENT_SURFACE_DEBUG\"]) {\n      write(error.stack, true);\n    }\n    return 2;\n  }\n}\n\nasync function readVersion(): Promise<string> {\n  const { readFileSync } = await import(\"node:fs\");\n  const path = fileURLToPath(new URL(\"../package.json\", import.meta.url));\n  return (JSON.parse(readFileSync(path, \"utf8\")) as { version: string }).version;\n}\n\nfunction invokedAsBinary(): boolean {\n  const entry = process.argv[1];\n  if (!entry) return false;\n  try {\n    return fileURLToPath(import.meta.url) === realpathSync(entry);\n  } catch {\n    return false;\n  }\n}\n\nif (invokedAsBinary()) {\n  void main().then((code) => {\n    process.exitCode = code;\n  });\n}\n","import { resolve } from \"node:path\";\nimport type { CapabilityContractEntry, CapabilityContractManifest } from \"@agent-surface/core\";\nimport {\n  compileCapabilityContract,\n  computeManifestHash,\n  type ExternalContractPolicy,\n} from \"@agent-surface/compiler\";\nimport { diffContracts, type ChangeClassification } from \"./diff.js\";\nimport { DEFAULT_SNAPSHOT, readBaseManifest, readManifest, writeManifest } from \"./files.js\";\nimport type { ContractReport, OutputFormat, RenderOptions } from \"./report.js\";\nimport { renderReport } from \"./report.js\";\n\nexport interface CommandOptions {\n  root: string;\n  configFile?: string;\n  snapshot?: string;\n  targets: string[];\n  base?: string;\n  format: OutputFormat;\n  policy: \"all\" | ChangeClassification | \"none\";\n  /** Dependencies approved to contribute, as `--allow <package>=<sha256>`. */\n  externalContracts?: ExternalContractPolicy;\n  plain?: boolean;\n  detail?: boolean;\n}\n\nfunction mergeManifests(manifests: CapabilityContractManifest[]): CapabilityContractManifest {\n  const entries = new Map<string, CapabilityContractEntry>();\n  for (const manifest of manifests) {\n    for (const entry of manifest.capabilities) {\n      const key = `${entry.declarationId}\\0${entry.capabilityId}`;\n      const existing = entries.get(key);\n      if (!existing) entries.set(key, { ...entry, targets: [...entry.targets] });\n      else {\n        if (existing.contractHash !== entry.contractHash) {\n          throw new Error(`contract ${entry.declarationId} / ${entry.capabilityId} differs across targets`);\n        }\n        existing.targets = [...new Set([...existing.targets, ...entry.targets])].sort();\n      }\n    }\n  }\n  const payload = {\n    formatVersion: 5 as const,\n    compilerVersion: manifests[0]?.compilerVersion ?? \"unknown\",\n    targets: [...new Set(manifests.flatMap((manifest) => manifest.targets))].sort(),\n    capabilities: [...entries.values()].sort((a, b) =>\n      `${a.declarationId}\\0${a.capabilityId}`.localeCompare(`${b.declarationId}\\0${b.capabilityId}`),\n    ),\n    // One attribution per package: the same dependency contributes identically\n    // to every target, and a divergence would already have failed the compile.\n    externalContracts: manifests\n      .flatMap((manifest) => manifest.externalContracts)\n      .filter((entry, index, all) => all.findIndex((candidate) => candidate.package === entry.package) === index)\n      .sort((a, b) => a.package.localeCompare(b.package)),\n    completeness: { status: \"proven\" as const },\n  };\n  return { ...payload, hash: computeManifestHash(payload) };\n}\n\nasync function compile(options: CommandOptions): Promise<CapabilityContractManifest> {\n  const targets = options.targets.length > 0 ? options.targets : [\"web-production\"];\n  const manifests = await Promise.all(\n    targets.map((target) =>\n      compileCapabilityContract({\n        root: options.root,\n        ...(options.configFile ? { configFile: options.configFile } : {}),\n        ...(options.externalContracts ? { externalContracts: options.externalContracts } : {}),\n        target,\n      }),\n    ),\n  );\n  return mergeManifests(manifests);\n}\n\nfunction shouldFail(\n  policy: CommandOptions[\"policy\"],\n  changes: ReturnType<typeof diffContracts>,\n): boolean {\n  if (policy === \"none\") return false;\n  if (policy === \"all\") return changes.length > 0;\n  return changes.some((change) => change.classification === policy);\n}\n\nasync function present(report: ContractReport, options: CommandOptions): Promise<void> {\n  const interactive =\n    options.format === \"human\" &&\n    !options.plain &&\n    process.stdout.isTTY === true &&\n    !process.env[\"CI\"] &&\n    !process.env[\"NO_COLOR\"];\n  const render: RenderOptions = { root: options.root, ...(options.detail ? { detail: true } : {}) };\n  if (interactive) {\n    const { renderInk } = await import(\"./ink.js\");\n    await renderInk(report, render);\n    return;\n  }\n  process.stdout.write(renderReport(report, options.format, render));\n}\n\nexport async function runInspect(options: CommandOptions): Promise<number> {\n  const manifest = await compile(options);\n  const snapshotPath = resolve(options.root, options.snapshot ?? DEFAULT_SNAPSHOT);\n  const snapshot = readManifest(snapshotPath);\n  const integrityChanges = diffContracts(snapshot, manifest);\n  const report: ContractReport = {\n    command: \"inspect\",\n    status: \"view\",\n    manifest,\n    snapshotPath,\n    integrity: {\n      status: !snapshot ? \"missing\" : snapshot.hash === manifest.hash ? \"current\" : \"stale\",\n      changes: integrityChanges,\n    },\n    ...(options.base\n      ? {\n          pullRequest: {\n            base: options.base,\n            changes: diffContracts(readBaseManifest(options.base, snapshotPath, options.root), manifest),\n          },\n        }\n      : {}),\n  };\n  await present(report, options);\n  return 0;\n}\n\nexport async function runSnapshot(options: CommandOptions): Promise<number> {\n  const manifest = await compile(options);\n  const snapshotPath = resolve(options.root, options.snapshot ?? DEFAULT_SNAPSHOT);\n  writeManifest(snapshotPath, manifest);\n  await present({ command: \"snapshot\", status: \"written\", manifest, snapshotPath }, options);\n  return 0;\n}\n\nexport async function runCheck(options: CommandOptions): Promise<number> {\n  const manifest = await compile(options);\n  const snapshotPath = resolve(options.root, options.snapshot ?? DEFAULT_SNAPSHOT);\n  const snapshot = readManifest(snapshotPath);\n  const integrityChanges = diffContracts(snapshot, manifest);\n  const integrityCurrent = snapshot?.hash === manifest.hash;\n  const pr = options.base\n    ? {\n        base: options.base,\n        changes: diffContracts(readBaseManifest(options.base, snapshotPath, options.root), snapshot ?? manifest),\n      }\n    : undefined;\n  const failed = !integrityCurrent || (pr ? shouldFail(options.policy, pr.changes) : false);\n  const report: ContractReport = {\n    command: \"check\",\n    status: failed ? \"fail\" : \"pass\",\n    manifest,\n    snapshotPath,\n    integrity: {\n      status: !snapshot ? \"missing\" : integrityCurrent ? \"current\" : \"stale\",\n      changes: integrityChanges,\n    },\n    ...(pr ? { pullRequest: pr } : {}),\n  };\n  await present(report, options);\n  return failed ? 1 : 0;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-KMAH2WU5.js

@@ -0,0 +1,333 @@
+// src/diff.ts
+var RISK = {
+  read: 0,
+  "local-state": 1,
+  navigation: 2,
+  "server-query": 3,
+  "server-mutation": 4,
+  "external-side-effect": 5,
+  destructive: 6
+};
+var CONFIRMATION = { never: 0, optional: 1, required: 2 };
+function key(entry) {
+  return `${entry.declarationId}\0${entry.capabilityId}`;
+}
+function equal(a, b) {
+  return JSON.stringify(a) === JSON.stringify(b);
+}
+function stringSet(value2) {
+  return new Set(Array.isArray(value2) ? value2.map((item) => JSON.stringify(item)) : []);
+}
+function setDirection(before, after) {
+  const a = stringSet(before);
+  const b = stringSet(after);
+  const added = [...b].some((item) => !a.has(item));
+  const removed = [...a].some((item) => !b.has(item));
+  if (added && removed) return "mixed";
+  if (added) return "added";
+  if (removed) return "removed";
+  return "same";
+}
+function classify(field, before, after) {
+  if (field === "targets") {
+    const direction = setDirection(before, after);
+    return direction === "added" ? "widening" : direction === "removed" ? "narrowing" : "neutral";
+  }
+  if (field === "policies") {
+    const direction = setDirection(before, after);
+    return direction === "removed" || direction === "mixed" ? "widening" : direction === "added" ? "narrowing" : "neutral";
+  }
+  if (field === "confirmation") {
+    const a = CONFIRMATION[String(before ?? "never")] ?? 0;
+    const b = CONFIRMATION[String(after ?? "never")] ?? 0;
+    return b < a ? "widening" : b > a ? "narrowing" : "neutral";
+  }
+  if (field === "effect") {
+    const a = RISK[String(before)] ?? 0;
+    const b = RISK[String(after)] ?? 0;
+    return b < a ? "widening" : b > a ? "narrowing" : "neutral";
+  }
+  return "neutral";
+}
+function diffContracts(before, after) {
+  if (!before) {
+    return after.capabilities.map((entry) => ({
+      declarationId: entry.declarationId,
+      capabilityId: entry.capabilityId,
+      kind: "added",
+      field: "capability",
+      classification: "widening",
+      after: entry
+    }));
+  }
+  const left = new Map(before.capabilities.map((entry) => [key(entry), entry]));
+  const right = new Map(after.capabilities.map((entry) => [key(entry), entry]));
+  const changes = [];
+  for (const entryKey of [.../* @__PURE__ */ new Set([...left.keys(), ...right.keys()])].sort()) {
+    const a = left.get(entryKey);
+    const b = right.get(entryKey);
+    if (!a && b) {
+      changes.push({
+        declarationId: b.declarationId,
+        capabilityId: b.capabilityId,
+        kind: "added",
+        field: "capability",
+        classification: "widening",
+        after: b
+      });
+      continue;
+    }
+    if (a && !b) {
+      changes.push({
+        declarationId: a.declarationId,
+        capabilityId: a.capabilityId,
+        kind: "removed",
+        field: "capability",
+        classification: "narrowing",
+        before: a
+      });
+      continue;
+    }
+    if (!a || !b) continue;
+    const fields = /* @__PURE__ */ new Set([...Object.keys(a), ...Object.keys(b)]);
+    fields.delete("declarationId");
+    fields.delete("capabilityId");
+    fields.delete("contractHash");
+    for (const field of [...fields].sort()) {
+      const beforeValue = a[field];
+      const afterValue = b[field];
+      if (equal(beforeValue, afterValue)) continue;
+      changes.push({
+        declarationId: b.declarationId,
+        capabilityId: b.capabilityId,
+        kind: "changed",
+        field,
+        classification: classify(field, beforeValue, afterValue),
+        before: beforeValue,
+        after: afterValue
+      });
+    }
+  }
+  return changes;
+}
+function changeCounts(changes) {
+  return {
+    widening: changes.filter((change) => change.classification === "widening").length,
+    narrowing: changes.filter((change) => change.classification === "narrowing").length,
+    neutral: changes.filter((change) => change.classification === "neutral").length
+  };
+}
+
+// src/report.ts
+import { relative } from "path";
+import { canonicalJson } from "@agent-surface/compiler";
+function value(value2) {
+  if (value2 === void 0) return "\u2014";
+  const text = typeof value2 === "string" ? value2 : JSON.stringify(value2);
+  return text.length > 100 ? `${text.slice(0, 97)}\u2026` : text;
+}
+function changeLine(change) {
+  const mark = change.kind === "added" ? "+" : change.kind === "removed" ? "-" : "~";
+  return `${mark} ${change.classification.padEnd(9)} ${change.capabilityId} \xB7 ${change.declarationId} \xB7 ${change.field}${change.kind === "changed" ? `: ${value(change.before)} \u2192 ${value(change.after)}` : ""}`;
+}
+function sectionTitle(title, changes) {
+  const counts = changeCounts(changes);
+  return `${title} (${changes.length}) \xB7 widening ${counts.widening} \xB7 narrowing ${counts.narrowing} \xB7 neutral ${counts.neutral}`;
+}
+function section(title, changes) {
+  return [sectionTitle(title, changes), ...changes.length > 0 ? changes.map(changeLine) : ["no changes"]];
+}
+var EFFECT_ORDER = [
+  "read",
+  "local-state",
+  "navigation",
+  "server-query",
+  "server-mutation",
+  "external-side-effect",
+  "destructive"
+];
+function effectRank(effect) {
+  const index = EFFECT_ORDER.indexOf(effect);
+  return index === -1 ? EFFECT_ORDER.length : index;
+}
+function groupByDeclaration(capabilities) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const entry of capabilities) {
+    const existing = groups.get(entry.declarationId);
+    if (existing) existing.push(entry);
+    else groups.set(entry.declarationId, [entry]);
+  }
+  return [...groups].map(([declarationId, entries]) => ({ declarationId, entries }));
+}
+function reachOf(effect) {
+  const rank = effectRank(effect);
+  if (rank <= 1) return "low";
+  if (rank <= 3) return "medium";
+  return "high";
+}
+var NONE = "\u2014";
+var CONTRACT_HEADERS = ["CAPABILITY", "KIND", "EFFECT", "REACH", "CONFIRM", "POLICIES"];
+function contractRow(entry) {
+  const policies = (entry.policies ?? []).map((policy) => `${policy.name}${policy.phase ? `@${policy.phase}` : ""}`);
+  const tags = (entry.tags ?? []).map((tag) => `#${tag}`).join(" ");
+  return {
+    capabilityId: entry.capabilityId,
+    kind: entry.kind,
+    effect: entry.effect,
+    reach: reachOf(entry.effect),
+    confirm: entry.confirmation ?? NONE,
+    policies: policies.length > 0 ? policies.join(", ") : NONE,
+    note: [entry.description, tags].filter(Boolean).join("  ")
+  };
+}
+function contractCells(row) {
+  return [row.capabilityId, row.kind, row.effect, row.reach, row.confirm, row.policies];
+}
+function tally(values) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const value2 of values) counts.set(value2, (counts.get(value2) ?? 0) + 1);
+  return [...counts].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).map(([name, count]) => `${count} ${name}`).join(" \xB7 ");
+}
+function plural(count, noun, suffix = "s") {
+  return `${count} ${noun}${count === 1 ? "" : suffix}`;
+}
+function contractHeading(manifest) {
+  const count = manifest.capabilities.length;
+  const groups = groupByDeclaration(manifest.capabilities).length;
+  return `REPOSITORY CONTRACT \xB7 ${count} ${count === 1 ? "capability" : "capabilities"} \xB7 ${plural(groups, "declaration")}`;
+}
+function headline(manifest) {
+  const capabilities = manifest.capabilities;
+  const count = capabilities.length;
+  const gated = capabilities.filter((entry) => entry.confirmation && entry.confirmation !== "never").length;
+  const policed = capabilities.filter((entry) => (entry.policies ?? []).length > 0).length;
+  const reach = ["low", "medium", "high"].map((grade) => [grade, capabilities.filter((entry) => reachOf(entry.effect) === grade).length]).filter(([, count2]) => count2 > 0).map(([grade, count2]) => `${count2} ${grade}`).join(" \xB7 ");
+  return [
+    `${count} ${count === 1 ? "capability" : "capabilities"} \xB7 ${plural(
+      groupByDeclaration(capabilities).length,
+      "declaration"
+    )}${count > 0 ? ` \xB7 ${tally(capabilities.map((entry) => entry.kind))}` : ""}`,
+    `reach ${reach || NONE} \xB7 declared gates: ${gated} confirmation \xB7 ${policed} policy`
+  ];
+}
+var CONTRACT_CAVEAT = [
+  "Declarations, compiled from the production graph \u2014 what this code can expose,",
+  "not what a mount exposed at runtime. CONFIRM and POLICIES are declared per",
+  "capability; whether a policy admits, denies or hides one depends on the actor,",
+  "input and context of a real invocation, which this command never performs."
+];
+function contractColumns(capabilities) {
+  const rows = capabilities.map((entry) => contractCells(contractRow(entry)));
+  return CONTRACT_HEADERS.map(
+    (header, index) => Math.max(header.length, ...rows.map((cells) => cells[index]?.length ?? 0))
+  );
+}
+function contractLine(cells, widths) {
+  return cells.map((cell, index) => index === cells.length - 1 ? cell : cell.padEnd(widths[index] ?? 0)).join("  ").trimEnd();
+}
+function displayPath(path, root) {
+  if (!root) return path;
+  const relativePath = relative(root, path);
+  return !relativePath || relativePath.startsWith("..") ? path : relativePath;
+}
+function showsContract(report, options = {}) {
+  return report.command === "inspect" || options.detail === true;
+}
+function summaryFields(report, options = {}) {
+  const { manifest } = report;
+  const fields = [
+    ["Contract", manifest.hash],
+    ["Compiler", manifest.compilerVersion],
+    ["Completeness", manifest.completeness.status],
+    ["Targets", manifest.targets.join(", ") || NONE],
+    ["Snapshot", displayPath(report.snapshotPath, options.root)]
+  ];
+  if (report.integrity) fields.push(["Integrity", report.integrity.status]);
+  return fields;
+}
+function humanReport(report, options = {}) {
+  const fields = summaryFields(report, options);
+  const label = Math.max(...fields.map(([name]) => name.length));
+  const lines = [
+    `AGENT SURFACE ${report.command.toUpperCase()} \xB7 ${report.status.toUpperCase()}`,
+    "",
+    ...headline(report.manifest),
+    "",
+    ...fields.map(([name, value2]) => `${name.padEnd(label)}  ${value2}`)
+  ];
+  if (report.integrity) lines.push("", ...section("SOURCE \u2194 SNAPSHOT", report.integrity.changes));
+  if (report.pullRequest) {
+    lines.push("", ...section(`PR DRIFT vs ${report.pullRequest.base}`, report.pullRequest.changes));
+  }
+  if (showsContract(report, options)) {
+    const widths = contractColumns(report.manifest.capabilities);
+    lines.push("", contractHeading(report.manifest), "", `  ${contractLine(CONTRACT_HEADERS, widths)}`);
+    for (const group of groupByDeclaration(report.manifest.capabilities)) {
+      lines.push("", `${group.declarationId} (${group.entries.length})`);
+      for (const entry of group.entries) {
+        const row = contractRow(entry);
+        lines.push(`  ${contractLine(contractCells(row), widths)}`);
+        if (options.detail && row.note) lines.push(`      ${row.note}`);
+      }
+    }
+    lines.push("", ...CONTRACT_CAVEAT);
+  }
+  return `${lines.join("\n")}
+`;
+}
+function markdownChanges(changes) {
+  if (changes.length === 0) return "No changes.\n";
+  return [
+    "| Class | Change | Capability | Declaration | Field |",
+    "|---|---|---|---|---|",
+    ...changes.map(
+      (change) => `| ${change.classification} | ${change.kind} | \`${change.capabilityId}\` | \`${change.declarationId}\` | \`${change.field}\` |`
+    )
+  ].join("\n");
+}
+function markdownReport(report, github = false) {
+  const lines = [
+    `## Agent Surface ${report.command} \u2014 ${report.status}`,
+    "",
+    `- Contract: \`${report.manifest.hash}\``,
+    `- Completeness: **${report.manifest.completeness.status}**`,
+    `- Capabilities: **${report.manifest.capabilities.length}**`,
+    `- Targets: ${report.manifest.targets.map((target) => `\`${target}\``).join(", ") || "\u2014"}`
+  ];
+  if (report.integrity) {
+    lines.push("", `### Source \u2194 snapshot \u2014 ${report.integrity.status}`, "", markdownChanges(report.integrity.changes));
+  }
+  if (report.pullRequest) {
+    lines.push("", `### PR drift vs \`${report.pullRequest.base}\``, "", markdownChanges(report.pullRequest.changes));
+  }
+  if (github && report.status === "fail") {
+    lines.unshift(`::error title=Agent Surface contract drift::${report.integrity?.changes.length ?? 0} integrity change(s)`);
+  }
+  return `${lines.join("\n")}
+`;
+}
+function renderReport(report, format, options = {}) {
+  if (format === "json") return canonicalJson(report, true);
+  if (format === "markdown") return markdownReport(report);
+  if (format === "github") return markdownReport(report, true);
+  return humanReport(report, options);
+}
+
+export {
+  diffContracts,
+  changeCounts,
+  sectionTitle,
+  groupByDeclaration,
+  CONTRACT_HEADERS,
+  contractRow,
+  contractCells,
+  contractHeading,
+  headline,
+  CONTRACT_CAVEAT,
+  contractColumns,
+  contractLine,
+  showsContract,
+  summaryFields,
+  renderReport
+};
+//# sourceMappingURL=chunk-KMAH2WU5.js.map

package/dist/chunk-KMAH2WU5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/diff.ts","../src/report.ts"],"sourcesContent":["import type { CapabilityContractEntry, CapabilityContractManifest } from \"@agent-surface/core\";\n\nexport type ChangeClassification = \"widening\" | \"narrowing\" | \"neutral\";\nexport type ChangeKind = \"added\" | \"removed\" | \"changed\";\n\nexport interface ContractChange {\n  declarationId: string;\n  capabilityId: string;\n  kind: ChangeKind;\n  field: string;\n  classification: ChangeClassification;\n  before?: unknown;\n  after?: unknown;\n}\n\nconst RISK: Record<string, number> = {\n  read: 0,\n  \"local-state\": 1,\n  navigation: 2,\n  \"server-query\": 3,\n  \"server-mutation\": 4,\n  \"external-side-effect\": 5,\n  destructive: 6,\n};\n\nconst CONFIRMATION: Record<string, number> = { never: 0, optional: 1, required: 2 };\n\nfunction key(entry: CapabilityContractEntry): string {\n  return `${entry.declarationId}\\0${entry.capabilityId}`;\n}\n\nfunction equal(a: unknown, b: unknown): boolean {\n  return JSON.stringify(a) === JSON.stringify(b);\n}\n\nfunction stringSet(value: unknown): Set<string> {\n  return new Set(Array.isArray(value) ? value.map((item) => JSON.stringify(item)) : []);\n}\n\nfunction setDirection(before: unknown, after: unknown): \"added\" | \"removed\" | \"mixed\" | \"same\" {\n  const a = stringSet(before);\n  const b = stringSet(after);\n  const added = [...b].some((item) => !a.has(item));\n  const removed = [...a].some((item) => !b.has(item));\n  if (added && removed) return \"mixed\";\n  if (added) return \"added\";\n  if (removed) return \"removed\";\n  return \"same\";\n}\n\nfunction classify(field: string, before: unknown, after: unknown): ChangeClassification {\n  if (field === \"targets\") {\n    const direction = setDirection(before, after);\n    return direction === \"added\" ? \"widening\" : direction === \"removed\" ? \"narrowing\" : \"neutral\";\n  }\n  if (field === \"policies\") {\n    const direction = setDirection(before, after);\n    return direction === \"removed\" || direction === \"mixed\"\n      ? \"widening\"\n      : direction === \"added\"\n        ? \"narrowing\"\n        : \"neutral\";\n  }\n  if (field === \"confirmation\") {\n    const a = CONFIRMATION[String(before ?? \"never\")] ?? 0;\n    const b = CONFIRMATION[String(after ?? \"never\")] ?? 0;\n    return b < a ? \"widening\" : b > a ? \"narrowing\" : \"neutral\";\n  }\n  if (field === \"effect\") {\n    const a = RISK[String(before)] ?? 0;\n    const b = RISK[String(after)] ?? 0;\n    // Lowering declared risk weakens review/approval posture.\n    return b < a ? \"widening\" : b > a ? \"narrowing\" : \"neutral\";\n  }\n  return \"neutral\";\n}\n\nexport function diffContracts(\n  before: CapabilityContractManifest | undefined,\n  after: CapabilityContractManifest,\n): ContractChange[] {\n  if (!before) {\n    return after.capabilities.map((entry) => ({\n      declarationId: entry.declarationId,\n      capabilityId: entry.capabilityId,\n      kind: \"added\",\n      field: \"capability\",\n      classification: \"widening\",\n      after: entry,\n    }));\n  }\n  const left = new Map(before.capabilities.map((entry) => [key(entry), entry]));\n  const right = new Map(after.capabilities.map((entry) => [key(entry), entry]));\n  const changes: ContractChange[] = [];\n  for (const entryKey of [...new Set([...left.keys(), ...right.keys()])].sort()) {\n    const a = left.get(entryKey);\n    const b = right.get(entryKey);\n    if (!a && b) {\n      changes.push({\n        declarationId: b.declarationId,\n        capabilityId: b.capabilityId,\n        kind: \"added\",\n        field: \"capability\",\n        classification: \"widening\",\n        after: b,\n      });\n      continue;\n    }\n    if (a && !b) {\n      changes.push({\n        declarationId: a.declarationId,\n        capabilityId: a.capabilityId,\n        kind: \"removed\",\n        field: \"capability\",\n        classification: \"narrowing\",\n        before: a,\n      });\n      continue;\n    }\n    if (!a || !b) continue;\n    const fields = new Set([...Object.keys(a), ...Object.keys(b)]);\n    fields.delete(\"declarationId\");\n    fields.delete(\"capabilityId\");\n    fields.delete(\"contractHash\");\n    for (const field of [...fields].sort()) {\n      const beforeValue = (a as unknown as Record<string, unknown>)[field];\n      const afterValue = (b as unknown as Record<string, unknown>)[field];\n      if (equal(beforeValue, afterValue)) continue;\n      changes.push({\n        declarationId: b.declarationId,\n        capabilityId: b.capabilityId,\n        kind: \"changed\",\n        field,\n        classification: classify(field, beforeValue, afterValue),\n        before: beforeValue,\n        after: afterValue,\n      });\n    }\n  }\n  return changes;\n}\n\nexport function changeCounts(changes: readonly ContractChange[]): Record<ChangeClassification, number> {\n  return {\n    widening: changes.filter((change) => change.classification === \"widening\").length,\n    narrowing: changes.filter((change) => change.classification === \"narrowing\").length,\n    neutral: changes.filter((change) => change.classification === \"neutral\").length,\n  };\n}\n","import { relative } from \"node:path\";\nimport type { CapabilityContractEntry, CapabilityContractManifest } from \"@agent-surface/core\";\nimport { canonicalJson } from \"@agent-surface/compiler\";\nimport type { ContractChange } from \"./diff.js\";\nimport { changeCounts } from \"./diff.js\";\n\nexport type OutputFormat = \"human\" | \"json\" | \"github\" | \"markdown\";\n\n/**\n * Presentation-only inputs. They never reach the report model, because `--json`\n * is canonical machine output and a checkout path would make it differ between\n * two machines that compiled the same source.\n */\nexport interface RenderOptions {\n  /** Application root, used to show the snapshot path as the user typed it. */\n  root?: string;\n  /** Include descriptions, confirmation, policies, and tags. */\n  detail?: boolean;\n}\n\nexport interface ContractReport {\n  command: \"inspect\" | \"check\" | \"snapshot\";\n  status: \"pass\" | \"fail\" | \"written\" | \"view\";\n  manifest: CapabilityContractManifest;\n  snapshotPath: string;\n  integrity?: {\n    status: \"current\" | \"missing\" | \"stale\";\n    changes: ContractChange[];\n  };\n  pullRequest?: {\n    base: string;\n    changes: ContractChange[];\n  };\n}\n\nfunction value(value: unknown): string {\n  if (value === undefined) return \"—\";\n  const text = typeof value === \"string\" ? value : JSON.stringify(value);\n  return text.length > 100 ? `${text.slice(0, 97)}…` : text;\n}\n\nfunction changeLine(change: ContractChange): string {\n  const mark = change.kind === \"added\" ? \"+\" : change.kind === \"removed\" ? \"-\" : \"~\";\n  return `${mark} ${change.classification.padEnd(9)} ${change.capabilityId} · ${change.declarationId} · ${change.field}${\n    change.kind === \"changed\" ? `: ${value(change.before)} → ${value(change.after)}` : \"\"\n  }`;\n}\n\nexport function sectionTitle(title: string, changes: readonly ContractChange[]): string {\n  const counts = changeCounts(changes);\n  return `${title} (${changes.length}) · widening ${counts.widening} · narrowing ${counts.narrowing} · neutral ${counts.neutral}`;\n}\n\nfunction section(title: string, changes: readonly ContractChange[]): string[] {\n  return [sectionTitle(title, changes), ...(changes.length > 0 ? changes.map(changeLine) : [\"no changes\"])];\n}\n\n/**\n * Effects in escalating order of reach, so a renderer can grade one without\n * restating the vocabulary. Anything unknown sorts last: a capability whose\n * effect this CLI does not recognize is the one worth looking at.\n */\nconst EFFECT_ORDER = [\n  \"read\",\n  \"local-state\",\n  \"navigation\",\n  \"server-query\",\n  \"server-mutation\",\n  \"external-side-effect\",\n  \"destructive\",\n] as const;\n\nexport function effectRank(effect: string): number {\n  const index = EFFECT_ORDER.indexOf(effect as (typeof EFFECT_ORDER)[number]);\n  return index === -1 ? EFFECT_ORDER.length : index;\n}\n\nexport interface ContractGroup {\n  declarationId: string;\n  entries: CapabilityContractEntry[];\n}\n\n/** Capabilities grouped by the declaration that owns them, input order kept. */\nexport function groupByDeclaration(capabilities: readonly CapabilityContractEntry[]): ContractGroup[] {\n  const groups = new Map<string, CapabilityContractEntry[]>();\n  for (const entry of capabilities) {\n    const existing = groups.get(entry.declarationId);\n    if (existing) existing.push(entry);\n    else groups.set(entry.declarationId, [entry]);\n  }\n  return [...groups].map(([declarationId, entries]) => ({ declarationId, entries }));\n}\n\nexport type Reach = \"low\" | \"medium\" | \"high\";\n\n/**\n * The effect ladder, graded. The effect is the fact; the grade is how it reads\n * to someone who has not memorised the ladder. It is printed as a word rather\n * than left to colour alone, because the streams that matter most — a pipe, a\n * CI log, `--plain` — have no colour to read.\n */\nexport function reachOf(effect: string): Reach {\n  const rank = effectRank(effect);\n  if (rank <= 1) return \"low\";\n  if (rank <= 3) return \"medium\";\n  return \"high\";\n}\n\n/** Nothing declared. A column still has to read as a column. */\nconst NONE = \"—\";\n\nexport const CONTRACT_HEADERS = [\"CAPABILITY\", \"KIND\", \"EFFECT\", \"REACH\", \"CONFIRM\", \"POLICIES\"] as const;\n\nexport interface ContractRow {\n  capabilityId: string;\n  kind: string;\n  effect: string;\n  reach: Reach;\n  confirm: string;\n  policies: string;\n  /** Description and tags, shown under --detail. */\n  note: string;\n}\n\nexport function contractRow(entry: CapabilityContractEntry): ContractRow {\n  const policies = (entry.policies ?? []).map((policy) => `${policy.name}${policy.phase ? `@${policy.phase}` : \"\"}`);\n  const tags = (entry.tags ?? []).map((tag) => `#${tag}`).join(\" \");\n  return {\n    capabilityId: entry.capabilityId,\n    kind: entry.kind,\n    effect: entry.effect,\n    reach: reachOf(entry.effect),\n    confirm: entry.confirmation ?? NONE,\n    policies: policies.length > 0 ? policies.join(\", \") : NONE,\n    note: [entry.description, tags].filter(Boolean).join(\"  \"),\n  };\n}\n\nexport function contractCells(row: ContractRow): string[] {\n  return [row.capabilityId, row.kind, row.effect, row.reach, row.confirm, row.policies];\n}\n\nfunction tally(values: readonly string[]): string {\n  const counts = new Map<string, number>();\n  for (const value of values) counts.set(value, (counts.get(value) ?? 0) + 1);\n  return [...counts]\n    .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))\n    .map(([name, count]) => `${count} ${name}`)\n    .join(\" · \");\n}\n\nfunction plural(count: number, noun: string, suffix = \"s\"): string {\n  return `${count} ${noun}${count === 1 ? \"\" : suffix}`;\n}\n\nexport function contractHeading(manifest: CapabilityContractManifest): string {\n  const count = manifest.capabilities.length;\n  const groups = groupByDeclaration(manifest.capabilities).length;\n  return `REPOSITORY CONTRACT · ${count} ${count === 1 ? \"capability\" : \"capabilities\"} · ${plural(groups, \"declaration\")}`;\n}\n\n/**\n * The answer, before the evidence for it. A reader who stops after this line\n * should still know how large the surface is and how much of it is gated.\n */\nexport function headline(manifest: CapabilityContractManifest): string[] {\n  const capabilities = manifest.capabilities;\n  const count = capabilities.length;\n  const gated = capabilities.filter((entry) => entry.confirmation && entry.confirmation !== \"never\").length;\n  const policed = capabilities.filter((entry) => (entry.policies ?? []).length > 0).length;\n  // Along the ladder, not by frequency: \"34 low · 1 high · 1 medium\" reads as\n  // a miscount rather than a distribution.\n  const reach = ([\"low\", \"medium\", \"high\"] as const)\n    .map((grade) => [grade, capabilities.filter((entry) => reachOf(entry.effect) === grade).length] as const)\n    .filter(([, count]) => count > 0)\n    .map(([grade, count]) => `${count} ${grade}`)\n    .join(\" · \");\n  return [\n    `${count} ${count === 1 ? \"capability\" : \"capabilities\"} · ${plural(\n      groupByDeclaration(capabilities).length,\n      \"declaration\",\n    )}${count > 0 ? ` · ${tally(capabilities.map((entry) => entry.kind))}` : \"\"}`,\n    `reach ${reach || NONE} · declared gates: ${gated} confirmation · ${policed} policy`,\n  ];\n}\n\n/**\n * What a compiled contract cannot tell you. The columns above are declarations\n * the graph proves are reachable — not a transcript of a run, and a policy's\n * verdict is not knowable until there is an actor and an input to judge.\n */\nexport const CONTRACT_CAVEAT = [\n  \"Declarations, compiled from the production graph — what this code can expose,\",\n  \"not what a mount exposed at runtime. CONFIRM and POLICIES are declared per\",\n  \"capability; whether a policy admits, denies or hides one depends on the actor,\",\n  \"input and context of a real invocation, which this command never performs.\",\n];\n\n/** Column widths shared by the plain and drawn renderers, so both align alike. */\nexport function contractColumns(capabilities: readonly CapabilityContractEntry[]): number[] {\n  const rows = capabilities.map((entry) => contractCells(contractRow(entry)));\n  return CONTRACT_HEADERS.map((header, index) =>\n    Math.max(header.length, ...rows.map((cells) => cells[index]?.length ?? 0)),\n  );\n}\n\n/** One table line, padded to the shared widths. The last cell is never padded. */\nexport function contractLine(cells: readonly string[], widths: readonly number[]): string {\n  return cells\n    .map((cell, index) => (index === cells.length - 1 ? cell : cell.padEnd(widths[index] ?? 0)))\n    .join(\"  \")\n    .trimEnd();\n}\n\n/** Show the snapshot where the user would type it, not as an absolute path. */\nexport function displayPath(path: string, root?: string): string {\n  if (!root) return path;\n  const relativePath = relative(root, path);\n  return !relativePath || relativePath.startsWith(\"..\") ? path : relativePath;\n}\n\n/**\n * `inspect` exists to show the inventory. The other commands lead with a\n * verdict and keep it out of the way — until `--detail` is asked for, because\n * the reason to ask a gate for detail is to read what it gated.\n */\nexport function showsContract(report: ContractReport, options: RenderOptions = {}): boolean {\n  return report.command === \"inspect\" || options.detail === true;\n}\n\n/** Provenance. True, needed, and not what the reader came for — so it sits below. */\nexport function summaryFields(report: ContractReport, options: RenderOptions = {}): [string, string][] {\n  const { manifest } = report;\n  const fields: [string, string][] = [\n    [\"Contract\", manifest.hash],\n    [\"Compiler\", manifest.compilerVersion],\n    [\"Completeness\", manifest.completeness.status],\n    [\"Targets\", manifest.targets.join(\", \") || NONE],\n    [\"Snapshot\", displayPath(report.snapshotPath, options.root)],\n  ];\n  if (report.integrity) fields.push([\"Integrity\", report.integrity.status]);\n  return fields;\n}\n\nexport function humanReport(report: ContractReport, options: RenderOptions = {}): string {\n  const fields = summaryFields(report, options);\n  const label = Math.max(...fields.map(([name]) => name.length));\n  const lines = [\n    `AGENT SURFACE ${report.command.toUpperCase()} · ${report.status.toUpperCase()}`,\n    \"\",\n    ...headline(report.manifest),\n    \"\",\n    ...fields.map(([name, value]) => `${name.padEnd(label)}  ${value}`),\n  ];\n  if (report.integrity) lines.push(\"\", ...section(\"SOURCE ↔ SNAPSHOT\", report.integrity.changes));\n  if (report.pullRequest) {\n    lines.push(\"\", ...section(`PR DRIFT vs ${report.pullRequest.base}`, report.pullRequest.changes));\n  }\n  if (showsContract(report, options)) {\n    const widths = contractColumns(report.manifest.capabilities);\n    lines.push(\"\", contractHeading(report.manifest), \"\", `  ${contractLine(CONTRACT_HEADERS, widths)}`);\n    for (const group of groupByDeclaration(report.manifest.capabilities)) {\n      lines.push(\"\", `${group.declarationId} (${group.entries.length})`);\n      for (const entry of group.entries) {\n        const row = contractRow(entry);\n        lines.push(`  ${contractLine(contractCells(row), widths)}`);\n        if (options.detail && row.note) lines.push(`      ${row.note}`);\n      }\n    }\n    lines.push(\"\", ...CONTRACT_CAVEAT);\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction markdownChanges(changes: readonly ContractChange[]): string {\n  if (changes.length === 0) return \"No changes.\\n\";\n  return [\n    \"| Class | Change | Capability | Declaration | Field |\",\n    \"|---|---|---|---|---|\",\n    ...changes.map(\n      (change) =>\n        `| ${change.classification} | ${change.kind} | \\`${change.capabilityId}\\` | \\`${change.declarationId}\\` | \\`${change.field}\\` |`,\n    ),\n  ].join(\"\\n\");\n}\n\nexport function markdownReport(report: ContractReport, github = false): string {\n  const lines = [\n    `## Agent Surface ${report.command} — ${report.status}`,\n    \"\",\n    `- Contract: \\`${report.manifest.hash}\\``,\n    `- Completeness: **${report.manifest.completeness.status}**`,\n    `- Capabilities: **${report.manifest.capabilities.length}**`,\n    `- Targets: ${report.manifest.targets.map((target) => `\\`${target}\\``).join(\", \") || \"—\"}`,\n  ];\n  if (report.integrity) {\n    lines.push(\"\", `### Source ↔ snapshot — ${report.integrity.status}`, \"\", markdownChanges(report.integrity.changes));\n  }\n  if (report.pullRequest) {\n    lines.push(\"\", `### PR drift vs \\`${report.pullRequest.base}\\``, \"\", markdownChanges(report.pullRequest.changes));\n  }\n  if (github && report.status === \"fail\") {\n    lines.unshift(`::error title=Agent Surface contract drift::${report.integrity?.changes.length ?? 0} integrity change(s)`);\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nexport function renderReport(report: ContractReport, format: OutputFormat, options: RenderOptions = {}): string {\n  if (format === \"json\") return canonicalJson(report, true);\n  if (format === \"markdown\") return markdownReport(report);\n  if (format === \"github\") return markdownReport(report, true);\n  return humanReport(report, options);\n}\n"],"mappings":";AAeA,IAAM,OAA+B;AAAA,EACnC,MAAM;AAAA,EACN,eAAe;AAAA,EACf,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,mBAAmB;AAAA,EACnB,wBAAwB;AAAA,EACxB,aAAa;AACf;AAEA,IAAM,eAAuC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,EAAE;AAElF,SAAS,IAAI,OAAwC;AACnD,SAAO,GAAG,MAAM,aAAa,KAAK,MAAM,YAAY;AACtD;AAEA,SAAS,MAAM,GAAY,GAAqB;AAC9C,SAAO,KAAK,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC;AAC/C;AAEA,SAAS,UAAUA,QAA6B;AAC9C,SAAO,IAAI,IAAI,MAAM,QAAQA,MAAK,IAAIA,OAAM,IAAI,CAAC,SAAS,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,CAAC;AACtF;AAEA,SAAS,aAAa,QAAiB,OAAwD;AAC7F,QAAM,IAAI,UAAU,MAAM;AAC1B,QAAM,IAAI,UAAU,KAAK;AACzB,QAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC;AAChD,QAAM,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC;AAClD,MAAI,SAAS,QAAS,QAAO;AAC7B,MAAI,MAAO,QAAO;AAClB,MAAI,QAAS,QAAO;AACpB,SAAO;AACT;AAEA,SAAS,SAAS,OAAe,QAAiB,OAAsC;AACtF,MAAI,UAAU,WAAW;AACvB,UAAM,YAAY,aAAa,QAAQ,KAAK;AAC5C,WAAO,cAAc,UAAU,aAAa,cAAc,YAAY,cAAc;AAAA,EACtF;AACA,MAAI,UAAU,YAAY;AACxB,UAAM,YAAY,aAAa,QAAQ,KAAK;AAC5C,WAAO,cAAc,aAAa,cAAc,UAC5C,aACA,cAAc,UACZ,cACA;AAAA,EACR;AACA,MAAI,UAAU,gBAAgB;AAC5B,UAAM,IAAI,aAAa,OAAO,UAAU,OAAO,CAAC,KAAK;AACrD,UAAM,IAAI,aAAa,OAAO,SAAS,OAAO,CAAC,KAAK;AACpD,WAAO,IAAI,IAAI,aAAa,IAAI,IAAI,cAAc;AAAA,EACpD;AACA,MAAI,UAAU,UAAU;AACtB,UAAM,IAAI,KAAK,OAAO,MAAM,CAAC,KAAK;AAClC,UAAM,IAAI,KAAK,OAAO,KAAK,CAAC,KAAK;AAEjC,WAAO,IAAI,IAAI,aAAa,IAAI,IAAI,cAAc;AAAA,EACpD;AACA,SAAO;AACT;AAEO,SAAS,cACd,QACA,OACkB;AAClB,MAAI,CAAC,QAAQ;AACX,WAAO,MAAM,aAAa,IAAI,CAAC,WAAW;AAAA,MACxC,eAAe,MAAM;AAAA,MACrB,cAAc,MAAM;AAAA,MACpB,MAAM;AAAA,MACN,OAAO;AAAA,MACP,gBAAgB;AAAA,MAChB,OAAO;AAAA,IACT,EAAE;AAAA,EACJ;AACA,QAAM,OAAO,IAAI,IAAI,OAAO,aAAa,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC;AAC5E,QAAM,QAAQ,IAAI,IAAI,MAAM,aAAa,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC;AAC5E,QAAM,UAA4B,CAAC;AACnC,aAAW,YAAY,CAAC,GAAG,oBAAI,IAAI,CAAC,GAAG,KAAK,KAAK,GAAG,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG;AAC7E,UAAM,IAAI,KAAK,IAAI,QAAQ;AAC3B,UAAM,IAAI,MAAM,IAAI,QAAQ;AAC5B,QAAI,CAAC,KAAK,GAAG;AACX,cAAQ,KAAK;AAAA,QACX,eAAe,EAAE;AAAA,QACjB,cAAc,EAAE;AAAA,QAChB,MAAM;AAAA,QACN,OAAO;AAAA,QACP,gBAAgB;AAAA,QAChB,OAAO;AAAA,MACT,CAAC;AACD;AAAA,IACF;AACA,QAAI,KAAK,CAAC,GAAG;AACX,cAAQ,KAAK;AAAA,QACX,eAAe,EAAE;AAAA,QACjB,cAAc,EAAE;AAAA,QAChB,MAAM;AAAA,QACN,OAAO;AAAA,QACP,gBAAgB;AAAA,QAChB,QAAQ;AAAA,MACV,CAAC;AACD;AAAA,IACF;AACA,QAAI,CAAC,KAAK,CAAC,EAAG;AACd,UAAM,SAAS,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC;AAC7D,WAAO,OAAO,eAAe;AAC7B,WAAO,OAAO,cAAc;AAC5B,WAAO,OAAO,cAAc;AAC5B,eAAW,SAAS,CAAC,GAAG,MAAM,EAAE,KAAK,GAAG;AACtC,YAAM,cAAe,EAAyC,KAAK;AACnE,YAAM,aAAc,EAAyC,KAAK;AAClE,UAAI,MAAM,aAAa,UAAU,EAAG;AACpC,cAAQ,KAAK;AAAA,QACX,eAAe,EAAE;AAAA,QACjB,cAAc,EAAE;AAAA,QAChB,MAAM;AAAA,QACN;AAAA,QACA,gBAAgB,SAAS,OAAO,aAAa,UAAU;AAAA,QACvD,QAAQ;AAAA,QACR,OAAO;AAAA,MACT,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,aAAa,SAA0E;AACrG,SAAO;AAAA,IACL,UAAU,QAAQ,OAAO,CAAC,WAAW,OAAO,mBAAmB,UAAU,EAAE;AAAA,IAC3E,WAAW,QAAQ,OAAO,CAAC,WAAW,OAAO,mBAAmB,WAAW,EAAE;AAAA,IAC7E,SAAS,QAAQ,OAAO,CAAC,WAAW,OAAO,mBAAmB,SAAS,EAAE;AAAA,EAC3E;AACF;;;ACpJA,SAAS,gBAAgB;AAEzB,SAAS,qBAAqB;AAiC9B,SAAS,MAAMC,QAAwB;AACrC,MAAIA,WAAU,OAAW,QAAO;AAChC,QAAM,OAAO,OAAOA,WAAU,WAAWA,SAAQ,KAAK,UAAUA,MAAK;AACrE,SAAO,KAAK,SAAS,MAAM,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC,WAAM;AACvD;AAEA,SAAS,WAAW,QAAgC;AAClD,QAAM,OAAO,OAAO,SAAS,UAAU,MAAM,OAAO,SAAS,YAAY,MAAM;AAC/E,SAAO,GAAG,IAAI,IAAI,OAAO,eAAe,OAAO,CAAC,CAAC,IAAI,OAAO,YAAY,SAAM,OAAO,aAAa,SAAM,OAAO,KAAK,GAClH,OAAO,SAAS,YAAY,KAAK,MAAM,OAAO,MAAM,CAAC,WAAM,MAAM,OAAO,KAAK,CAAC,KAAK,EACrF;AACF;AAEO,SAAS,aAAa,OAAe,SAA4C;AACtF,QAAM,SAAS,aAAa,OAAO;AACnC,SAAO,GAAG,KAAK,KAAK,QAAQ,MAAM,mBAAgB,OAAO,QAAQ,mBAAgB,OAAO,SAAS,iBAAc,OAAO,OAAO;AAC/H;AAEA,SAAS,QAAQ,OAAe,SAA8C;AAC5E,SAAO,CAAC,aAAa,OAAO,OAAO,GAAG,GAAI,QAAQ,SAAS,IAAI,QAAQ,IAAI,UAAU,IAAI,CAAC,YAAY,CAAE;AAC1G;AAOA,IAAM,eAAe;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,WAAW,QAAwB;AACjD,QAAM,QAAQ,aAAa,QAAQ,MAAuC;AAC1E,SAAO,UAAU,KAAK,aAAa,SAAS;AAC9C;AAQO,SAAS,mBAAmB,cAAmE;AACpG,QAAM,SAAS,oBAAI,IAAuC;AAC1D,aAAW,SAAS,cAAc;AAChC,UAAM,WAAW,OAAO,IAAI,MAAM,aAAa;AAC/C,QAAI,SAAU,UAAS,KAAK,KAAK;AAAA,QAC5B,QAAO,IAAI,MAAM,eAAe,CAAC,KAAK,CAAC;AAAA,EAC9C;AACA,SAAO,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,CAAC,eAAe,OAAO,OAAO,EAAE,eAAe,QAAQ,EAAE;AACnF;AAUO,SAAS,QAAQ,QAAuB;AAC7C,QAAM,OAAO,WAAW,MAAM;AAC9B,MAAI,QAAQ,EAAG,QAAO;AACtB,MAAI,QAAQ,EAAG,QAAO;AACtB,SAAO;AACT;AAGA,IAAM,OAAO;AAEN,IAAM,mBAAmB,CAAC,cAAc,QAAQ,UAAU,SAAS,WAAW,UAAU;AAaxF,SAAS,YAAY,OAA6C;AACvE,QAAM,YAAY,MAAM,YAAY,CAAC,GAAG,IAAI,CAAC,WAAW,GAAG,OAAO,IAAI,GAAG,OAAO,QAAQ,IAAI,OAAO,KAAK,KAAK,EAAE,EAAE;AACjH,QAAM,QAAQ,MAAM,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,GAAG,EAAE,EAAE,KAAK,GAAG;AAChE,SAAO;AAAA,IACL,cAAc,MAAM;AAAA,IACpB,MAAM,MAAM;AAAA,IACZ,QAAQ,MAAM;AAAA,IACd,OAAO,QAAQ,MAAM,MAAM;AAAA,IAC3B,SAAS,MAAM,gBAAgB;AAAA,IAC/B,UAAU,SAAS,SAAS,IAAI,SAAS,KAAK,IAAI,IAAI;AAAA,IACtD,MAAM,CAAC,MAAM,aAAa,IAAI,EAAE,OAAO,OAAO,EAAE,KAAK,IAAI;AAAA,EAC3D;AACF;AAEO,SAAS,cAAc,KAA4B;AACxD,SAAO,CAAC,IAAI,cAAc,IAAI,MAAM,IAAI,QAAQ,IAAI,OAAO,IAAI,SAAS,IAAI,QAAQ;AACtF;AAEA,SAAS,MAAM,QAAmC;AAChD,QAAM,SAAS,oBAAI,IAAoB;AACvC,aAAWA,UAAS,OAAQ,QAAO,IAAIA,SAAQ,OAAO,IAAIA,MAAK,KAAK,KAAK,CAAC;AAC1E,SAAO,CAAC,GAAG,MAAM,EACd,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EACtD,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,GAAG,KAAK,IAAI,IAAI,EAAE,EACzC,KAAK,QAAK;AACf;AAEA,SAAS,OAAO,OAAe,MAAc,SAAS,KAAa;AACjE,SAAO,GAAG,KAAK,IAAI,IAAI,GAAG,UAAU,IAAI,KAAK,MAAM;AACrD;AAEO,SAAS,gBAAgB,UAA8C;AAC5E,QAAM,QAAQ,SAAS,aAAa;AACpC,QAAM,SAAS,mBAAmB,SAAS,YAAY,EAAE;AACzD,SAAO,4BAAyB,KAAK,IAAI,UAAU,IAAI,eAAe,cAAc,SAAM,OAAO,QAAQ,aAAa,CAAC;AACzH;AAMO,SAAS,SAAS,UAAgD;AACvE,QAAM,eAAe,SAAS;AAC9B,QAAM,QAAQ,aAAa;AAC3B,QAAM,QAAQ,aAAa,OAAO,CAAC,UAAU,MAAM,gBAAgB,MAAM,iBAAiB,OAAO,EAAE;AACnG,QAAM,UAAU,aAAa,OAAO,CAAC,WAAW,MAAM,YAAY,CAAC,GAAG,SAAS,CAAC,EAAE;AAGlF,QAAM,QAAS,CAAC,OAAO,UAAU,MAAM,EACpC,IAAI,CAAC,UAAU,CAAC,OAAO,aAAa,OAAO,CAAC,UAAU,QAAQ,MAAM,MAAM,MAAM,KAAK,EAAE,MAAM,CAAU,EACvG,OAAO,CAAC,CAAC,EAAEC,MAAK,MAAMA,SAAQ,CAAC,EAC/B,IAAI,CAAC,CAAC,OAAOA,MAAK,MAAM,GAAGA,MAAK,IAAI,KAAK,EAAE,EAC3C,KAAK,QAAK;AACb,SAAO;AAAA,IACL,GAAG,KAAK,IAAI,UAAU,IAAI,eAAe,cAAc,SAAM;AAAA,MAC3D,mBAAmB,YAAY,EAAE;AAAA,MACjC;AAAA,IACF,CAAC,GAAG,QAAQ,IAAI,SAAM,MAAM,aAAa,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,CAAC,KAAK,EAAE;AAAA,IAC3E,SAAS,SAAS,IAAI,yBAAsB,KAAK,sBAAmB,OAAO;AAAA,EAC7E;AACF;AAOO,IAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,SAAS,gBAAgB,cAA4D;AAC1F,QAAM,OAAO,aAAa,IAAI,CAAC,UAAU,cAAc,YAAY,KAAK,CAAC,CAAC;AAC1E,SAAO,iBAAiB;AAAA,IAAI,CAAC,QAAQ,UACnC,KAAK,IAAI,OAAO,QAAQ,GAAG,KAAK,IAAI,CAAC,UAAU,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC;AAAA,EAC3E;AACF;AAGO,SAAS,aAAa,OAA0B,QAAmC;AACxF,SAAO,MACJ,IAAI,CAAC,MAAM,UAAW,UAAU,MAAM,SAAS,IAAI,OAAO,KAAK,OAAO,OAAO,KAAK,KAAK,CAAC,CAAE,EAC1F,KAAK,IAAI,EACT,QAAQ;AACb;AAGO,SAAS,YAAY,MAAc,MAAuB;AAC/D,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,eAAe,SAAS,MAAM,IAAI;AACxC,SAAO,CAAC,gBAAgB,aAAa,WAAW,IAAI,IAAI,OAAO;AACjE;AAOO,SAAS,cAAc,QAAwB,UAAyB,CAAC,GAAY;AAC1F,SAAO,OAAO,YAAY,aAAa,QAAQ,WAAW;AAC5D;AAGO,SAAS,cAAc,QAAwB,UAAyB,CAAC,GAAuB;AACrG,QAAM,EAAE,SAAS,IAAI;AACrB,QAAM,SAA6B;AAAA,IACjC,CAAC,YAAY,SAAS,IAAI;AAAA,IAC1B,CAAC,YAAY,SAAS,eAAe;AAAA,IACrC,CAAC,gBAAgB,SAAS,aAAa,MAAM;AAAA,IAC7C,CAAC,WAAW,SAAS,QAAQ,KAAK,IAAI,KAAK,IAAI;AAAA,IAC/C,CAAC,YAAY,YAAY,OAAO,cAAc,QAAQ,IAAI,CAAC;AAAA,EAC7D;AACA,MAAI,OAAO,UAAW,QAAO,KAAK,CAAC,aAAa,OAAO,UAAU,MAAM,CAAC;AACxE,SAAO;AACT;AAEO,SAAS,YAAY,QAAwB,UAAyB,CAAC,GAAW;AACvF,QAAM,SAAS,cAAc,QAAQ,OAAO;AAC5C,QAAM,QAAQ,KAAK,IAAI,GAAG,OAAO,IAAI,CAAC,CAAC,IAAI,MAAM,KAAK,MAAM,CAAC;AAC7D,QAAM,QAAQ;AAAA,IACZ,iBAAiB,OAAO,QAAQ,YAAY,CAAC,SAAM,OAAO,OAAO,YAAY,CAAC;AAAA,IAC9E;AAAA,IACA,GAAG,SAAS,OAAO,QAAQ;AAAA,IAC3B;AAAA,IACA,GAAG,OAAO,IAAI,CAAC,CAAC,MAAMD,MAAK,MAAM,GAAG,KAAK,OAAO,KAAK,CAAC,KAAKA,MAAK,EAAE;AAAA,EACpE;AACA,MAAI,OAAO,UAAW,OAAM,KAAK,IAAI,GAAG,QAAQ,0BAAqB,OAAO,UAAU,OAAO,CAAC;AAC9F,MAAI,OAAO,aAAa;AACtB,UAAM,KAAK,IAAI,GAAG,QAAQ,eAAe,OAAO,YAAY,IAAI,IAAI,OAAO,YAAY,OAAO,CAAC;AAAA,EACjG;AACA,MAAI,cAAc,QAAQ,OAAO,GAAG;AAClC,UAAM,SAAS,gBAAgB,OAAO,SAAS,YAAY;AAC3D,UAAM,KAAK,IAAI,gBAAgB,OAAO,QAAQ,GAAG,IAAI,KAAK,aAAa,kBAAkB,MAAM,CAAC,EAAE;AAClG,eAAW,SAAS,mBAAmB,OAAO,SAAS,YAAY,GAAG;AACpE,YAAM,KAAK,IAAI,GAAG,MAAM,aAAa,KAAK,MAAM,QAAQ,MAAM,GAAG;AACjE,iBAAW,SAAS,MAAM,SAAS;AACjC,cAAM,MAAM,YAAY,KAAK;AAC7B,cAAM,KAAK,KAAK,aAAa,cAAc,GAAG,GAAG,MAAM,CAAC,EAAE;AAC1D,YAAI,QAAQ,UAAU,IAAI,KAAM,OAAM,KAAK,SAAS,IAAI,IAAI,EAAE;AAAA,MAChE;AAAA,IACF;AACA,UAAM,KAAK,IAAI,GAAG,eAAe;AAAA,EACnC;AACA,SAAO,GAAG,MAAM,KAAK,IAAI,CAAC;AAAA;AAC5B;AAEA,SAAS,gBAAgB,SAA4C;AACnE,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,GAAG,QAAQ;AAAA,MACT,CAAC,WACC,KAAK,OAAO,cAAc,MAAM,OAAO,IAAI,QAAQ,OAAO,YAAY,UAAU,OAAO,aAAa,UAAU,OAAO,KAAK;AAAA,IAC9H;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEO,SAAS,eAAe,QAAwB,SAAS,OAAe;AAC7E,QAAM,QAAQ;AAAA,IACZ,oBAAoB,OAAO,OAAO,WAAM,OAAO,MAAM;AAAA,IACrD;AAAA,IACA,iBAAiB,OAAO,SAAS,IAAI;AAAA,IACrC,qBAAqB,OAAO,SAAS,aAAa,MAAM;AAAA,IACxD,qBAAqB,OAAO,SAAS,aAAa,MAAM;AAAA,IACxD,cAAc,OAAO,SAAS,QAAQ,IAAI,CAAC,WAAW,KAAK,MAAM,IAAI,EAAE,KAAK,IAAI,KAAK,QAAG;AAAA,EAC1F;AACA,MAAI,OAAO,WAAW;AACpB,UAAM,KAAK,IAAI,qCAA2B,OAAO,UAAU,MAAM,IAAI,IAAI,gBAAgB,OAAO,UAAU,OAAO,CAAC;AAAA,EACpH;AACA,MAAI,OAAO,aAAa;AACtB,UAAM,KAAK,IAAI,qBAAqB,OAAO,YAAY,IAAI,MAAM,IAAI,gBAAgB,OAAO,YAAY,OAAO,CAAC;AAAA,EAClH;AACA,MAAI,UAAU,OAAO,WAAW,QAAQ;AACtC,UAAM,QAAQ,+CAA+C,OAAO,WAAW,QAAQ,UAAU,CAAC,sBAAsB;AAAA,EAC1H;AACA,SAAO,GAAG,MAAM,KAAK,IAAI,CAAC;AAAA;AAC5B;AAEO,SAAS,aAAa,QAAwB,QAAsB,UAAyB,CAAC,GAAW;AAC9G,MAAI,WAAW,OAAQ,QAAO,cAAc,QAAQ,IAAI;AACxD,MAAI,WAAW,WAAY,QAAO,eAAe,MAAM;AACvD,MAAI,WAAW,SAAU,QAAO,eAAe,QAAQ,IAAI;AAC3D,SAAO,YAAY,QAAQ,OAAO;AACpC;","names":["value","value","count"]}

package/dist/chunk-XCQACLOT.js

@@ -0,0 +1,51 @@
+// src/files.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { dirname, isAbsolute, relative, resolve, sep } from "path";
+import { spawnSync } from "child_process";
+import { canonicalManifestJson, verifyManifest } from "@agent-surface/compiler";
+var DEFAULT_SNAPSHOT = ".agent-surface/contract.json";
+function readManifest(path) {
+  if (!existsSync(path)) return void 0;
+  try {
+    const manifest = JSON.parse(readFileSync(path, "utf8"));
+    verifyManifest(manifest);
+    return manifest;
+  } catch (error) {
+    throw new Error(`could not read contract ${path}: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+function writeManifest(path, manifest) {
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, canonicalManifestJson(manifest), "utf8");
+}
+function git(args, cwd) {
+  const result = spawnSync("git", args, { cwd, encoding: "utf8" });
+  if (result.status !== 0) {
+    throw new Error(result.stderr.trim() || `git ${args.join(" ")} failed`);
+  }
+  return result.stdout.trim();
+}
+function readBaseManifest(base, snapshotPath, cwd) {
+  const root = git(["rev-parse", "--show-toplevel"], cwd);
+  const absolute = isAbsolute(snapshotPath) ? snapshotPath : resolve(cwd, snapshotPath);
+  const path = relative(root, absolute);
+  if (path === ".." || path.startsWith(`..${sep}`) || isAbsolute(path)) {
+    throw new Error(`snapshot ${snapshotPath} is outside the Git worktree`);
+  }
+  const text = git(["show", `${base}:${path.split(sep).join("/")}`], root);
+  try {
+    const manifest = JSON.parse(text);
+    verifyManifest(manifest);
+    return manifest;
+  } catch (error) {
+    throw new Error(`could not read ${snapshotPath} at ${base}: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+
+export {
+  DEFAULT_SNAPSHOT,
+  readManifest,
+  writeManifest,
+  readBaseManifest
+};
+//# sourceMappingURL=chunk-XCQACLOT.js.map

package/dist/chunk-XCQACLOT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/files.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, relative, resolve, sep } from \"node:path\";\nimport { spawnSync } from \"node:child_process\";\nimport type { CapabilityContractManifest } from \"@agent-surface/core\";\nimport { canonicalManifestJson, verifyManifest } from \"@agent-surface/compiler\";\n\nexport const DEFAULT_SNAPSHOT = \".agent-surface/contract.json\";\n\nexport function readManifest(path: string): CapabilityContractManifest | undefined {\n  if (!existsSync(path)) return undefined;\n  try {\n    const manifest = JSON.parse(readFileSync(path, \"utf8\")) as CapabilityContractManifest;\n    verifyManifest(manifest);\n    return manifest;\n  } catch (error) {\n    throw new Error(`could not read contract ${path}: ${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n\nexport function writeManifest(path: string, manifest: CapabilityContractManifest): void {\n  mkdirSync(dirname(path), { recursive: true });\n  writeFileSync(path, canonicalManifestJson(manifest), \"utf8\");\n}\n\nfunction git(args: string[], cwd: string): string {\n  const result = spawnSync(\"git\", args, { cwd, encoding: \"utf8\" });\n  if (result.status !== 0) {\n    throw new Error(result.stderr.trim() || `git ${args.join(\" \")} failed`);\n  }\n  return result.stdout.trim();\n}\n\nexport function readBaseManifest(\n  base: string,\n  snapshotPath: string,\n  cwd: string,\n): CapabilityContractManifest {\n  const root = git([\"rev-parse\", \"--show-toplevel\"], cwd);\n  const absolute = isAbsolute(snapshotPath) ? snapshotPath : resolve(cwd, snapshotPath);\n  const path = relative(root, absolute);\n  if (path === \"..\" || path.startsWith(`..${sep}`) || isAbsolute(path)) {\n    throw new Error(`snapshot ${snapshotPath} is outside the Git worktree`);\n  }\n  const text = git([\"show\", `${base}:${path.split(sep).join(\"/\")}`], root);\n  try {\n    const manifest = JSON.parse(text) as CapabilityContractManifest;\n    verifyManifest(manifest);\n    return manifest;\n  } catch (error) {\n    throw new Error(`could not read ${snapshotPath} at ${base}: ${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n"],"mappings":";AAAA,SAAS,YAAY,WAAW,cAAc,qBAAqB;AACnE,SAAS,SAAS,YAAY,UAAU,SAAS,WAAW;AAC5D,SAAS,iBAAiB;AAE1B,SAAS,uBAAuB,sBAAsB;AAE/C,IAAM,mBAAmB;AAEzB,SAAS,aAAa,MAAsD;AACjF,MAAI,CAAC,WAAW,IAAI,EAAG,QAAO;AAC9B,MAAI;AACF,UAAM,WAAW,KAAK,MAAM,aAAa,MAAM,MAAM,CAAC;AACtD,mBAAe,QAAQ;AACvB,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,2BAA2B,IAAI,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,EAC9G;AACF;AAEO,SAAS,cAAc,MAAc,UAA4C;AACtF,YAAU,QAAQ,IAAI,GAAG,EAAE,WAAW,KAAK,CAAC;AAC5C,gBAAc,MAAM,sBAAsB,QAAQ,GAAG,MAAM;AAC7D;AAEA,SAAS,IAAI,MAAgB,KAAqB;AAChD,QAAM,SAAS,UAAU,OAAO,MAAM,EAAE,KAAK,UAAU,OAAO,CAAC;AAC/D,MAAI,OAAO,WAAW,GAAG;AACvB,UAAM,IAAI,MAAM,OAAO,OAAO,KAAK,KAAK,OAAO,KAAK,KAAK,GAAG,CAAC,SAAS;AAAA,EACxE;AACA,SAAO,OAAO,OAAO,KAAK;AAC5B;AAEO,SAAS,iBACd,MACA,cACA,KAC4B;AAC5B,QAAM,OAAO,IAAI,CAAC,aAAa,iBAAiB,GAAG,GAAG;AACtD,QAAM,WAAW,WAAW,YAAY,IAAI,eAAe,QAAQ,KAAK,YAAY;AACpF,QAAM,OAAO,SAAS,MAAM,QAAQ;AACpC,MAAI,SAAS,QAAQ,KAAK,WAAW,KAAK,GAAG,EAAE,KAAK,WAAW,IAAI,GAAG;AACpE,UAAM,IAAI,MAAM,YAAY,YAAY,8BAA8B;AAAA,EACxE;AACA,QAAM,OAAO,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,KAAK,MAAM,GAAG,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,IAAI;AACvE,MAAI;AACF,UAAM,WAAW,KAAK,MAAM,IAAI;AAChC,mBAAe,QAAQ;AACvB,WAAO;AAAA,EACT,SAAS,OAAO;AACd,UAAM,IAAI,MAAM,kBAAkB,YAAY,OAAO,IAAI,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,EACxH;AACF;","names":[]}

package/dist/index.d.ts

@@ -19,6 +19,17 @@ declare function readManifest(path: string): CapabilityContractManifest | undefi
 declare function writeManifest(path: string, manifest: CapabilityContractManifest): void;
 
 type OutputFormat = "human" | "json" | "github" | "markdown";
+/**
+ * Presentation-only inputs. They never reach the report model, because `--json`
+ * is canonical machine output and a checkout path would make it differ between
+ * two machines that compiled the same source.
+ */
+interface RenderOptions {
+    /** Application root, used to show the snapshot path as the user typed it. */
+    root?: string;
+    /** Include descriptions, confirmation, policies, and tags. */
+    detail?: boolean;
+}
 interface ContractReport {
     command: "inspect" | "check" | "snapshot";
     status: "pass" | "fail" | "written" | "view";
@@ -33,6 +44,6 @@ interface ContractReport {
         changes: ContractChange[];
     };
 }
-declare function renderReport(report: ContractReport, format: OutputFormat): string;
+declare function renderReport(report: ContractReport, format: OutputFormat, options?: RenderOptions): string;
 
 export { type ChangeClassification, type ChangeKind, type ContractChange, type ContractReport, DEFAULT_SNAPSHOT, type OutputFormat, changeCounts, diffContracts, readManifest, renderReport, writeManifest };

package/dist/index.js

@@ -1,13 +1,13 @@
 import {
   DEFAULT_SNAPSHOT,
   readManifest,
-  renderReport,
   writeManifest
-} from "./chunk-X6RGGBQ4.js";
+} from "./chunk-XCQACLOT.js";
 import {
   changeCounts,
-  diffContracts
-} from "./chunk-IA7FUP4R.js";
+  diffContracts,
+  renderReport
+} from "./chunk-KMAH2WU5.js";
 export {
   DEFAULT_SNAPSHOT,
   changeCounts,

package/dist/ink-4CUU77KD.js

@@ -0,0 +1,146 @@
+import {
+  CONTRACT_CAVEAT,
+  CONTRACT_HEADERS,
+  contractCells,
+  contractColumns,
+  contractHeading,
+  contractLine,
+  contractRow,
+  groupByDeclaration,
+  headline,
+  sectionTitle,
+  showsContract,
+  summaryFields
+} from "./chunk-KMAH2WU5.js";
+
+// src/ink.tsx
+import { Box, Text, render } from "ink";
+import { jsx, jsxs } from "react/jsx-runtime";
+var REACH_COLOR = { low: "green", medium: "yellow", high: "red" };
+function changeColor(change) {
+  if (change.classification === "widening") return "yellow";
+  if (change.classification === "narrowing") return "cyan";
+  return "gray";
+}
+function pad(text, width) {
+  return text.padEnd(width);
+}
+function Summary({ report, options }) {
+  const fields = summaryFields(report, options);
+  const label = Math.max(...fields.map(([name]) => name.length));
+  return /* @__PURE__ */ jsx(Box, { flexDirection: "column", children: fields.map(([name, value]) => /* @__PURE__ */ jsxs(Text, { children: [
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: pad(name, label) }),
+    "  ",
+    /* @__PURE__ */ jsx(Text, { color: name === "Integrity" && value !== "current" ? "yellow" : void 0, children: value })
+  ] }, name)) });
+}
+function Changes({ title, changes }) {
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsx(Text, { bold: true, children: sectionTitle(title, changes) }),
+    changes.length === 0 ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: "no changes" }) : changes.map((change, index) => /* @__PURE__ */ jsxs(
+      Text,
+      {
+        color: changeColor(change),
+        children: [
+          change.kind === "added" ? "+" : change.kind === "removed" ? "-" : "~",
+          " ",
+          change.classification.padEnd(9),
+          " ",
+          change.capabilityId,
+          " \xB7 ",
+          change.field
+        ]
+      },
+      `${change.capabilityId}\0${change.declarationId}\0${change.field}\0${index}`
+    ))
+  ] });
+}
+function Capability({
+  entry,
+  widths,
+  detail
+}) {
+  const row = contractRow(entry);
+  const [id, kind, effect, reach, confirm, policies] = contractCells(row);
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs(Text, { children: [
+      "  ",
+      pad(id ?? "", widths[0] ?? 0),
+      "  ",
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: pad(kind ?? "", widths[1] ?? 0) }),
+      "  ",
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: pad(effect ?? "", widths[2] ?? 0) }),
+      "  ",
+      /* @__PURE__ */ jsx(Text, { color: REACH_COLOR[row.reach], children: pad(reach ?? "", widths[3] ?? 0) }),
+      "  ",
+      /* @__PURE__ */ jsx(Text, { color: row.confirm === "required" ? "magenta" : void 0, dimColor: row.confirm === "\u2014", children: pad(confirm ?? "", widths[4] ?? 0) }),
+      "  ",
+      /* @__PURE__ */ jsx(Text, { color: "magenta", dimColor: row.policies === "\u2014", children: policies })
+    ] }),
+    detail && row.note ? /* @__PURE__ */ jsx(Box, { paddingLeft: 6, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: row.note }) }) : null
+  ] });
+}
+function App({ report, options }) {
+  const ok = report.status === "pass" || report.status === "written" || report.status === "view";
+  const widths = contractColumns(report.manifest.capabilities);
+  const [size, gates] = headline(report.manifest);
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs(Text, { bold: true, color: ok ? "green" : "red", children: [
+      "AGENT SURFACE ",
+      report.command.toUpperCase(),
+      " \xB7 ",
+      report.status.toUpperCase()
+    ] }),
+    /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+      /* @__PURE__ */ jsx(Text, { bold: true, color: "cyan", children: size }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: gates })
+    ] }),
+    /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Summary, { report, options }) }),
+    report.integrity ? /* @__PURE__ */ jsx(Changes, { title: "SOURCE \u2194 SNAPSHOT", changes: report.integrity.changes }) : null,
+    report.pullRequest ? /* @__PURE__ */ jsx(Changes, { title: `PR DRIFT vs ${report.pullRequest.base}`, changes: report.pullRequest.changes }) : null,
+    showsContract(report, options) ? /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+      /* @__PURE__ */ jsx(Text, { bold: true, children: contractHeading(report.manifest) }),
+      /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  ${contractLine(CONTRACT_HEADERS, widths)}` }) }),
+      groupByDeclaration(report.manifest.capabilities).map((group) => /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
+        /* @__PURE__ */ jsxs(Text, { children: [
+          /* @__PURE__ */ jsx(Text, { color: "blue", children: group.declarationId }),
+          " ",
+          /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
+            "(",
+            group.entries.length,
+            ")"
+          ] })
+        ] }),
+        group.entries.map((entry) => /* @__PURE__ */ jsx(
+          Capability,
+          {
+            entry,
+            widths,
+            detail: options.detail === true
+          },
+          entry.capabilityId
+        ))
+      ] }, group.declarationId)),
+      /* @__PURE__ */ jsx(
+        Box,
+        {
+          flexDirection: "column",
+          alignSelf: "flex-start",
+          marginTop: 1,
+          borderStyle: "round",
+          borderColor: "gray",
+          paddingX: 1,
+          children: CONTRACT_CAVEAT.map((line) => /* @__PURE__ */ jsx(Text, { dimColor: true, children: line }, line))
+        }
+      )
+    ] }) : null
+  ] });
+}
+async function renderInk(report, options = {}) {
+  const instance = render(/* @__PURE__ */ jsx(App, { report, options }));
+  await instance.waitUntilExit();
+}
+export {
+  renderInk
+};
+//# sourceMappingURL=ink-4CUU77KD.js.map

package/dist/ink-4CUU77KD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ink.tsx"],"sourcesContent":["import { Box, Text, render } from \"ink\";\nimport type { CapabilityContractEntry } from \"@agent-surface/core\";\nimport type { ContractChange } from \"./diff.js\";\nimport type { ContractReport, Reach, RenderOptions } from \"./report.js\";\nimport {\n  CONTRACT_CAVEAT,\n  CONTRACT_HEADERS,\n  contractCells,\n  contractColumns,\n  contractHeading,\n  contractLine,\n  contractRow,\n  groupByDeclaration,\n  headline,\n  sectionTitle,\n  showsContract,\n  summaryFields,\n} from \"./report.js\";\n\n/** Colour repeats the REACH word; it never carries the grade on its own. */\nconst REACH_COLOR: Record<Reach, string> = { low: \"green\", medium: \"yellow\", high: \"red\" };\n\nfunction changeColor(change: ContractChange): string {\n  if (change.classification === \"widening\") return \"yellow\";\n  if (change.classification === \"narrowing\") return \"cyan\";\n  return \"gray\";\n}\n\nfunction pad(text: string, width: number): string {\n  return text.padEnd(width);\n}\n\nfunction Summary({ report, options }: { report: ContractReport; options: RenderOptions }) {\n  const fields = summaryFields(report, options);\n  const label = Math.max(...fields.map(([name]) => name.length));\n  return (\n    <Box flexDirection=\"column\">\n      {fields.map(([name, value]) => (\n        <Text key={name}>\n          <Text dimColor>{pad(name, label)}</Text>\n          {\"  \"}\n          <Text color={name === \"Integrity\" && value !== \"current\" ? \"yellow\" : undefined}>{value}</Text>\n        </Text>\n      ))}\n    </Box>\n  );\n}\n\nfunction Changes({ title, changes }: { title: string; changes: ContractChange[] }) {\n  return (\n    <Box flexDirection=\"column\" marginTop={1}>\n      <Text bold>{sectionTitle(title, changes)}</Text>\n      {changes.length === 0 ? (\n        <Text dimColor>no changes</Text>\n      ) : (\n        changes.map((change, index) => (\n          <Text\n            key={`${change.capabilityId}\\0${change.declarationId}\\0${change.field}\\0${index}`}\n            color={changeColor(change)}\n          >\n            {change.kind === \"added\" ? \"+\" : change.kind === \"removed\" ? \"-\" : \"~\"} {change.classification.padEnd(9)}{\" \"}\n            {change.capabilityId} · {change.field}\n          </Text>\n        ))\n      )}\n    </Box>\n  );\n}\n\nfunction Capability({\n  entry,\n  widths,\n  detail,\n}: {\n  entry: CapabilityContractEntry;\n  widths: number[];\n  detail: boolean;\n}) {\n  const row = contractRow(entry);\n  const [id, kind, effect, reach, confirm, policies] = contractCells(row);\n  return (\n    <Box flexDirection=\"column\">\n      <Text>\n        {\"  \"}\n        {pad(id ?? \"\", widths[0] ?? 0)}\n        {\"  \"}\n        <Text dimColor>{pad(kind ?? \"\", widths[1] ?? 0)}</Text>\n        {\"  \"}\n        <Text dimColor>{pad(effect ?? \"\", widths[2] ?? 0)}</Text>\n        {\"  \"}\n        <Text color={REACH_COLOR[row.reach]}>{pad(reach ?? \"\", widths[3] ?? 0)}</Text>\n        {\"  \"}\n        <Text color={row.confirm === \"required\" ? \"magenta\" : undefined} dimColor={row.confirm === \"—\"}>\n          {pad(confirm ?? \"\", widths[4] ?? 0)}\n        </Text>\n        {\"  \"}\n        <Text color=\"magenta\" dimColor={row.policies === \"—\"}>\n          {policies}\n        </Text>\n      </Text>\n      {/* Padding rather than a prefix, so a wrapped description stays in its column. */}\n      {detail && row.note ? (\n        <Box paddingLeft={6}>\n          <Text dimColor>{row.note}</Text>\n        </Box>\n      ) : null}\n    </Box>\n  );\n}\n\nfunction App({ report, options }: { report: ContractReport; options: RenderOptions }) {\n  const ok = report.status === \"pass\" || report.status === \"written\" || report.status === \"view\";\n  const widths = contractColumns(report.manifest.capabilities);\n  const [size, gates] = headline(report.manifest);\n  return (\n    <Box flexDirection=\"column\">\n      <Text bold color={ok ? \"green\" : \"red\"}>\n        AGENT SURFACE {report.command.toUpperCase()} · {report.status.toUpperCase()}\n      </Text>\n      <Box flexDirection=\"column\" marginTop={1}>\n        <Text bold color=\"cyan\">\n          {size}\n        </Text>\n        <Text dimColor>{gates}</Text>\n      </Box>\n      <Box marginTop={1}>\n        <Summary report={report} options={options} />\n      </Box>\n      {report.integrity ? <Changes title=\"SOURCE ↔ SNAPSHOT\" changes={report.integrity.changes} /> : null}\n      {report.pullRequest ? (\n        <Changes title={`PR DRIFT vs ${report.pullRequest.base}`} changes={report.pullRequest.changes} />\n      ) : null}\n      {showsContract(report, options) ? (\n        <Box flexDirection=\"column\" marginTop={1}>\n          <Text bold>{contractHeading(report.manifest)}</Text>\n          <Box marginTop={1}>\n            <Text dimColor>{`  ${contractLine(CONTRACT_HEADERS, widths)}`}</Text>\n          </Box>\n          {groupByDeclaration(report.manifest.capabilities).map((group) => (\n            <Box key={group.declarationId} flexDirection=\"column\" marginTop={1}>\n              <Text>\n                <Text color=\"blue\">{group.declarationId}</Text> <Text dimColor>({group.entries.length})</Text>\n              </Text>\n              {group.entries.map((entry) => (\n                <Capability\n                  key={entry.capabilityId}\n                  entry={entry}\n                  widths={widths}\n                  detail={options.detail === true}\n                />\n              ))}\n            </Box>\n          ))}\n          {/* flex-start, or the border stretches to the width of the terminal. */}\n          <Box\n            flexDirection=\"column\"\n            alignSelf=\"flex-start\"\n            marginTop={1}\n            borderStyle=\"round\"\n            borderColor=\"gray\"\n            paddingX={1}\n          >\n            {CONTRACT_CAVEAT.map((line) => (\n              <Text key={line} dimColor>\n                {line}\n              </Text>\n            ))}\n          </Box>\n        </Box>\n      ) : null}\n    </Box>\n  );\n}\n\nexport async function renderInk(report: ContractReport, options: RenderOptions = {}): Promise<void> {\n  const instance = render(<App report={report} options={options} />);\n  await instance.waitUntilExit();\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-surface/cli",
-  "version": "0.19.1",
+  "version": "0.20.1",
   "description": "Inspect and check the agent surface your app exposes — in the terminal and in CI",
   "license": "MIT",
   "type": "module",
@@ -23,8 +23,8 @@
     "ink": "^6.3.1",
     "react": "^19.1.1",
     "vite": "^7.1.3",
-    "@agent-surface/compiler": "^0.19.1",
-    "@agent-surface/core": "^0.19.1"
+    "@agent-surface/compiler": "^0.20.1",
+    "@agent-surface/core": "^0.20.1"
   },
   "devDependencies": {
     "@types/node": "^20.19.0",
@@ -39,7 +39,7 @@
     "url": "git+https://github.com/Wiseair-srl/agent-surface.git",
     "directory": "packages/cli"
   },
-  "homepage": "https://agent-surface-docs.vercel.app",
+  "homepage": "https://agent-surface.dev",
   "bugs": {
     "url": "https://github.com/Wiseair-srl/agent-surface/issues"
   },

package/dist/chunk-IA7FUP4R.js

@@ -1,125 +0,0 @@
-// src/diff.ts
-var RISK = {
-  read: 0,
-  "local-state": 1,
-  navigation: 2,
-  "server-query": 3,
-  "server-mutation": 4,
-  "external-side-effect": 5,
-  destructive: 6
-};
-var CONFIRMATION = { never: 0, optional: 1, required: 2 };
-function key(entry) {
-  return `${entry.declarationId}\0${entry.capabilityId}`;
-}
-function equal(a, b) {
-  return JSON.stringify(a) === JSON.stringify(b);
-}
-function stringSet(value) {
-  return new Set(Array.isArray(value) ? value.map((item) => JSON.stringify(item)) : []);
-}
-function setDirection(before, after) {
-  const a = stringSet(before);
-  const b = stringSet(after);
-  const added = [...b].some((item) => !a.has(item));
-  const removed = [...a].some((item) => !b.has(item));
-  if (added && removed) return "mixed";
-  if (added) return "added";
-  if (removed) return "removed";
-  return "same";
-}
-function classify(field, before, after) {
-  if (field === "targets") {
-    const direction = setDirection(before, after);
-    return direction === "added" ? "widening" : direction === "removed" ? "narrowing" : "neutral";
-  }
-  if (field === "policies") {
-    const direction = setDirection(before, after);
-    return direction === "removed" || direction === "mixed" ? "widening" : direction === "added" ? "narrowing" : "neutral";
-  }
-  if (field === "confirmation") {
-    const a = CONFIRMATION[String(before ?? "never")] ?? 0;
-    const b = CONFIRMATION[String(after ?? "never")] ?? 0;
-    return b < a ? "widening" : b > a ? "narrowing" : "neutral";
-  }
-  if (field === "effect") {
-    const a = RISK[String(before)] ?? 0;
-    const b = RISK[String(after)] ?? 0;
-    return b < a ? "widening" : b > a ? "narrowing" : "neutral";
-  }
-  return "neutral";
-}
-function diffContracts(before, after) {
-  if (!before) {
-    return after.capabilities.map((entry) => ({
-      declarationId: entry.declarationId,
-      capabilityId: entry.capabilityId,
-      kind: "added",
-      field: "capability",
-      classification: "widening",
-      after: entry
-    }));
-  }
-  const left = new Map(before.capabilities.map((entry) => [key(entry), entry]));
-  const right = new Map(after.capabilities.map((entry) => [key(entry), entry]));
-  const changes = [];
-  for (const entryKey of [.../* @__PURE__ */ new Set([...left.keys(), ...right.keys()])].sort()) {
-    const a = left.get(entryKey);
-    const b = right.get(entryKey);
-    if (!a && b) {
-      changes.push({
-        declarationId: b.declarationId,
-        capabilityId: b.capabilityId,
-        kind: "added",
-        field: "capability",
-        classification: "widening",
-        after: b
-      });
-      continue;
-    }
-    if (a && !b) {
-      changes.push({
-        declarationId: a.declarationId,
-        capabilityId: a.capabilityId,
-        kind: "removed",
-        field: "capability",
-        classification: "narrowing",
-        before: a
-      });
-      continue;
-    }
-    if (!a || !b) continue;
-    const fields = /* @__PURE__ */ new Set([...Object.keys(a), ...Object.keys(b)]);
-    fields.delete("declarationId");
-    fields.delete("capabilityId");
-    fields.delete("contractHash");
-    for (const field of [...fields].sort()) {
-      const beforeValue = a[field];
-      const afterValue = b[field];
-      if (equal(beforeValue, afterValue)) continue;
-      changes.push({
-        declarationId: b.declarationId,
-        capabilityId: b.capabilityId,
-        kind: "changed",
-        field,
-        classification: classify(field, beforeValue, afterValue),
-        before: beforeValue,
-        after: afterValue
-      });
-    }
-  }
-  return changes;
-}
-function changeCounts(changes) {
-  return {
-    widening: changes.filter((change) => change.classification === "widening").length,
-    narrowing: changes.filter((change) => change.classification === "narrowing").length,
-    neutral: changes.filter((change) => change.classification === "neutral").length
-  };
-}
-
-export {
-  diffContracts,
-  changeCounts
-};
-//# sourceMappingURL=chunk-IA7FUP4R.js.map

package/dist/chunk-IA7FUP4R.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/diff.ts"],"sourcesContent":["import type { CapabilityContractEntry, CapabilityContractManifest } from \"@agent-surface/core\";\n\nexport type ChangeClassification = \"widening\" | \"narrowing\" | \"neutral\";\nexport type ChangeKind = \"added\" | \"removed\" | \"changed\";\n\nexport interface ContractChange {\n  declarationId: string;\n  capabilityId: string;\n  kind: ChangeKind;\n  field: string;\n  classification: ChangeClassification;\n  before?: unknown;\n  after?: unknown;\n}\n\nconst RISK: Record<string, number> = {\n  read: 0,\n  \"local-state\": 1,\n  navigation: 2,\n  \"server-query\": 3,\n  \"server-mutation\": 4,\n  \"external-side-effect\": 5,\n  destructive: 6,\n};\n\nconst CONFIRMATION: Record<string, number> = { never: 0, optional: 1, required: 2 };\n\nfunction key(entry: CapabilityContractEntry): string {\n  return `${entry.declarationId}\\0${entry.capabilityId}`;\n}\n\nfunction equal(a: unknown, b: unknown): boolean {\n  return JSON.stringify(a) === JSON.stringify(b);\n}\n\nfunction stringSet(value: unknown): Set<string> {\n  return new Set(Array.isArray(value) ? value.map((item) => JSON.stringify(item)) : []);\n}\n\nfunction setDirection(before: unknown, after: unknown): \"added\" | \"removed\" | \"mixed\" | \"same\" {\n  const a = stringSet(before);\n  const b = stringSet(after);\n  const added = [...b].some((item) => !a.has(item));\n  const removed = [...a].some((item) => !b.has(item));\n  if (added && removed) return \"mixed\";\n  if (added) return \"added\";\n  if (removed) return \"removed\";\n  return \"same\";\n}\n\nfunction classify(field: string, before: unknown, after: unknown): ChangeClassification {\n  if (field === \"targets\") {\n    const direction = setDirection(before, after);\n    return direction === \"added\" ? \"widening\" : direction === \"removed\" ? \"narrowing\" : \"neutral\";\n  }\n  if (field === \"policies\") {\n    const direction = setDirection(before, after);\n    return direction === \"removed\" || direction === \"mixed\"\n      ? \"widening\"\n      : direction === \"added\"\n        ? \"narrowing\"\n        : \"neutral\";\n  }\n  if (field === \"confirmation\") {\n    const a = CONFIRMATION[String(before ?? \"never\")] ?? 0;\n    const b = CONFIRMATION[String(after ?? \"never\")] ?? 0;\n    return b < a ? \"widening\" : b > a ? \"narrowing\" : \"neutral\";\n  }\n  if (field === \"effect\") {\n    const a = RISK[String(before)] ?? 0;\n    const b = RISK[String(after)] ?? 0;\n    // Lowering declared risk weakens review/approval posture.\n    return b < a ? \"widening\" : b > a ? \"narrowing\" : \"neutral\";\n  }\n  return \"neutral\";\n}\n\nexport function diffContracts(\n  before: CapabilityContractManifest | undefined,\n  after: CapabilityContractManifest,\n): ContractChange[] {\n  if (!before) {\n    return after.capabilities.map((entry) => ({\n      declarationId: entry.declarationId,\n      capabilityId: entry.capabilityId,\n      kind: \"added\",\n      field: \"capability\",\n      classification: \"widening\",\n      after: entry,\n    }));\n  }\n  const left = new Map(before.capabilities.map((entry) => [key(entry), entry]));\n  const right = new Map(after.capabilities.map((entry) => [key(entry), entry]));\n  const changes: ContractChange[] = [];\n  for (const entryKey of [...new Set([...left.keys(), ...right.keys()])].sort()) {\n    const a = left.get(entryKey);\n    const b = right.get(entryKey);\n    if (!a && b) {\n      changes.push({\n        declarationId: b.declarationId,\n        capabilityId: b.capabilityId,\n        kind: \"added\",\n        field: \"capability\",\n        classification: \"widening\",\n        after: b,\n      });\n      continue;\n    }\n    if (a && !b) {\n      changes.push({\n        declarationId: a.declarationId,\n        capabilityId: a.capabilityId,\n        kind: \"removed\",\n        field: \"capability\",\n        classification: \"narrowing\",\n        before: a,\n      });\n      continue;\n    }\n    if (!a || !b) continue;\n    const fields = new Set([...Object.keys(a), ...Object.keys(b)]);\n    fields.delete(\"declarationId\");\n    fields.delete(\"capabilityId\");\n    fields.delete(\"contractHash\");\n    for (const field of [...fields].sort()) {\n      const beforeValue = (a as unknown as Record<string, unknown>)[field];\n      const afterValue = (b as unknown as Record<string, unknown>)[field];\n      if (equal(beforeValue, afterValue)) continue;\n      changes.push({\n        declarationId: b.declarationId,\n        capabilityId: b.capabilityId,\n        kind: \"changed\",\n        field,\n        classification: classify(field, beforeValue, afterValue),\n        before: beforeValue,\n        after: afterValue,\n      });\n    }\n  }\n  return changes;\n}\n\nexport function changeCounts(changes: readonly ContractChange[]): Record<ChangeClassification, number> {\n  return {\n    widening: changes.filter((change) => change.classification === \"widening\").length,\n    narrowing: changes.filter((change) => change.classification === \"narrowing\").length,\n    neutral: changes.filter((change) => change.classification === \"neutral\").length,\n  };\n}\n"],"mappings":";AAeA,IAAM,OAA+B;AAAA,EACnC,MAAM;AAAA,EACN,eAAe;AAAA,EACf,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,mBAAmB;AAAA,EACnB,wBAAwB;AAAA,EACxB,aAAa;AACf;AAEA,IAAM,eAAuC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,EAAE;AAElF,SAAS,IAAI,OAAwC;AACnD,SAAO,GAAG,MAAM,aAAa,KAAK,MAAM,YAAY;AACtD;AAEA,SAAS,MAAM,GAAY,GAAqB;AAC9C,SAAO,KAAK,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC;AAC/C;AAEA,SAAS,UAAU,OAA6B;AAC9C,SAAO,IAAI,IAAI,MAAM,QAAQ,KAAK,IAAI,MAAM,IAAI,CAAC,SAAS,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,CAAC;AACtF;AAEA,SAAS,aAAa,QAAiB,OAAwD;AAC7F,QAAM,IAAI,UAAU,MAAM;AAC1B,QAAM,IAAI,UAAU,KAAK;AACzB,QAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC;AAChD,QAAM,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC;AAClD,MAAI,SAAS,QAAS,QAAO;AAC7B,MAAI,MAAO,QAAO;AAClB,MAAI,QAAS,QAAO;AACpB,SAAO;AACT;AAEA,SAAS,SAAS,OAAe,QAAiB,OAAsC;AACtF,MAAI,UAAU,WAAW;AACvB,UAAM,YAAY,aAAa,QAAQ,KAAK;AAC5C,WAAO,cAAc,UAAU,aAAa,cAAc,YAAY,cAAc;AAAA,EACtF;AACA,MAAI,UAAU,YAAY;AACxB,UAAM,YAAY,aAAa,QAAQ,KAAK;AAC5C,WAAO,cAAc,aAAa,cAAc,UAC5C,aACA,cAAc,UACZ,cACA;AAAA,EACR;AACA,MAAI,UAAU,gBAAgB;AAC5B,UAAM,IAAI,aAAa,OAAO,UAAU,OAAO,CAAC,KAAK;AACrD,UAAM,IAAI,aAAa,OAAO,SAAS,OAAO,CAAC,KAAK;AACpD,WAAO,IAAI,IAAI,aAAa,IAAI,IAAI,cAAc;AAAA,EACpD;AACA,MAAI,UAAU,UAAU;AACtB,UAAM,IAAI,KAAK,OAAO,MAAM,CAAC,KAAK;AAClC,UAAM,IAAI,KAAK,OAAO,KAAK,CAAC,KAAK;AAEjC,WAAO,IAAI,IAAI,aAAa,IAAI,IAAI,cAAc;AAAA,EACpD;AACA,SAAO;AACT;AAEO,SAAS,cACd,QACA,OACkB;AAClB,MAAI,CAAC,QAAQ;AACX,WAAO,MAAM,aAAa,IAAI,CAAC,WAAW;AAAA,MACxC,eAAe,MAAM;AAAA,MACrB,cAAc,MAAM;AAAA,MACpB,MAAM;AAAA,MACN,OAAO;AAAA,MACP,gBAAgB;AAAA,MAChB,OAAO;AAAA,IACT,EAAE;AAAA,EACJ;AACA,QAAM,OAAO,IAAI,IAAI,OAAO,aAAa,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC;AAC5E,QAAM,QAAQ,IAAI,IAAI,MAAM,aAAa,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC;AAC5E,QAAM,UAA4B,CAAC;AACnC,aAAW,YAAY,CAAC,GAAG,oBAAI,IAAI,CAAC,GAAG,KAAK,KAAK,GAAG,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG;AAC7E,UAAM,IAAI,KAAK,IAAI,QAAQ;AAC3B,UAAM,IAAI,MAAM,IAAI,QAAQ;AAC5B,QAAI,CAAC,KAAK,GAAG;AACX,cAAQ,KAAK;AAAA,QACX,eAAe,EAAE;AAAA,QACjB,cAAc,EAAE;AAAA,QAChB,MAAM;AAAA,QACN,OAAO;AAAA,QACP,gBAAgB;AAAA,QAChB,OAAO;AAAA,MACT,CAAC;AACD;AAAA,IACF;AACA,QAAI,KAAK,CAAC,GAAG;AACX,cAAQ,KAAK;AAAA,QACX,eAAe,EAAE;AAAA,QACjB,cAAc,EAAE;AAAA,QAChB,MAAM;AAAA,QACN,OAAO;AAAA,QACP,gBAAgB;AAAA,QAChB,QAAQ;AAAA,MACV,CAAC;AACD;AAAA,IACF;AACA,QAAI,CAAC,KAAK,CAAC,EAAG;AACd,UAAM,SAAS,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC;AAC7D,WAAO,OAAO,eAAe;AAC7B,WAAO,OAAO,cAAc;AAC5B,WAAO,OAAO,cAAc;AAC5B,eAAW,SAAS,CAAC,GAAG,MAAM,EAAE,KAAK,GAAG;AACtC,YAAM,cAAe,EAAyC,KAAK;AACnE,YAAM,aAAc,EAAyC,KAAK;AAClE,UAAI,MAAM,aAAa,UAAU,EAAG;AACpC,cAAQ,KAAK;AAAA,QACX,eAAe,EAAE;AAAA,QACjB,cAAc,EAAE;AAAA,QAChB,MAAM;AAAA,QACN;AAAA,QACA,gBAAgB,SAAS,OAAO,aAAa,UAAU;AAAA,QACvD,QAAQ;AAAA,QACR,OAAO;AAAA,MACT,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,aAAa,SAA0E;AACrG,SAAO;AAAA,IACL,UAAU,QAAQ,OAAO,CAAC,WAAW,OAAO,mBAAmB,UAAU,EAAE;AAAA,IAC3E,WAAW,QAAQ,OAAO,CAAC,WAAW,OAAO,mBAAmB,WAAW,EAAE;AAAA,IAC7E,SAAS,QAAQ,OAAO,CAAC,WAAW,OAAO,mBAAmB,SAAS,EAAE;AAAA,EAC3E;AACF;","names":[]}

package/dist/chunk-X6RGGBQ4.js

@@ -1,139 +0,0 @@
-import {
-  changeCounts
-} from "./chunk-IA7FUP4R.js";
-
-// src/files.ts
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname, isAbsolute, relative, resolve, sep } from "path";
-import { spawnSync } from "child_process";
-import { canonicalManifestJson, verifyManifest } from "@agent-surface/compiler";
-var DEFAULT_SNAPSHOT = ".agent-surface/contract.json";
-function readManifest(path) {
-  if (!existsSync(path)) return void 0;
-  try {
-    const manifest = JSON.parse(readFileSync(path, "utf8"));
-    verifyManifest(manifest);
-    return manifest;
-  } catch (error) {
-    throw new Error(`could not read contract ${path}: ${error instanceof Error ? error.message : String(error)}`);
-  }
-}
-function writeManifest(path, manifest) {
-  mkdirSync(dirname(path), { recursive: true });
-  writeFileSync(path, canonicalManifestJson(manifest), "utf8");
-}
-function git(args, cwd) {
-  const result = spawnSync("git", args, { cwd, encoding: "utf8" });
-  if (result.status !== 0) {
-    throw new Error(result.stderr.trim() || `git ${args.join(" ")} failed`);
-  }
-  return result.stdout.trim();
-}
-function readBaseManifest(base, snapshotPath, cwd) {
-  const root = git(["rev-parse", "--show-toplevel"], cwd);
-  const absolute = isAbsolute(snapshotPath) ? snapshotPath : resolve(cwd, snapshotPath);
-  const path = relative(root, absolute);
-  if (path === ".." || path.startsWith(`..${sep}`) || isAbsolute(path)) {
-    throw new Error(`snapshot ${snapshotPath} is outside the Git worktree`);
-  }
-  const text = git(["show", `${base}:${path.split(sep).join("/")}`], root);
-  try {
-    const manifest = JSON.parse(text);
-    verifyManifest(manifest);
-    return manifest;
-  } catch (error) {
-    throw new Error(`could not read ${snapshotPath} at ${base}: ${error instanceof Error ? error.message : String(error)}`);
-  }
-}
-
-// src/report.ts
-import { canonicalJson } from "@agent-surface/compiler";
-function value(value2) {
-  if (value2 === void 0) return "\u2014";
-  const text = typeof value2 === "string" ? value2 : JSON.stringify(value2);
-  return text.length > 100 ? `${text.slice(0, 97)}\u2026` : text;
-}
-function changeLine(change) {
-  const mark = change.kind === "added" ? "+" : change.kind === "removed" ? "-" : "~";
-  return `${mark} ${change.classification.padEnd(9)} ${change.capabilityId} \xB7 ${change.declarationId} \xB7 ${change.field}${change.kind === "changed" ? `: ${value(change.before)} \u2192 ${value(change.after)}` : ""}`;
-}
-function section(title, changes) {
-  const counts = changeCounts(changes);
-  return [
-    `${title} (${changes.length}) \xB7 widening ${counts.widening} \xB7 narrowing ${counts.narrowing} \xB7 neutral ${counts.neutral}`,
-    ...changes.length > 0 ? changes.map(changeLine) : ["no changes"]
-  ];
-}
-function humanReport(report) {
-  const lines = [
-    `AGENT SURFACE ${report.command.toUpperCase()} \xB7 ${report.status.toUpperCase()}`,
-    `Contract      ${report.manifest.hash}`,
-    `Completeness  ${report.manifest.completeness.status}`,
-    `Targets       ${report.manifest.targets.join(", ") || "\u2014"}`,
-    `Capabilities  ${report.manifest.capabilities.length}`,
-    `Snapshot      ${report.snapshotPath}`
-  ];
-  if (report.integrity) {
-    lines.push(`Integrity     ${report.integrity.status}`);
-    lines.push("", ...section("SOURCE \u2194 SNAPSHOT", report.integrity.changes));
-  }
-  if (report.pullRequest) {
-    lines.push("", ...section(`PR DRIFT vs ${report.pullRequest.base}`, report.pullRequest.changes));
-  }
-  if (report.command === "inspect") {
-    lines.push("", "REPOSITORY CONTRACT");
-    for (const entry of report.manifest.capabilities) {
-      lines.push(
-        `${entry.capabilityId} \xB7 ${entry.kind} \xB7 ${entry.effect} \xB7 ${entry.declarationId} \xB7 ${entry.targets.join(",")}`
-      );
-    }
-  }
-  return `${lines.join("\n")}
-`;
-}
-function markdownChanges(changes) {
-  if (changes.length === 0) return "No changes.\n";
-  return [
-    "| Class | Change | Capability | Declaration | Field |",
-    "|---|---|---|---|---|",
-    ...changes.map(
-      (change) => `| ${change.classification} | ${change.kind} | \`${change.capabilityId}\` | \`${change.declarationId}\` | \`${change.field}\` |`
-    )
-  ].join("\n");
-}
-function markdownReport(report, github = false) {
-  const lines = [
-    `## Agent Surface ${report.command} \u2014 ${report.status}`,
-    "",
-    `- Contract: \`${report.manifest.hash}\``,
-    `- Completeness: **${report.manifest.completeness.status}**`,
-    `- Capabilities: **${report.manifest.capabilities.length}**`,
-    `- Targets: ${report.manifest.targets.map((target) => `\`${target}\``).join(", ") || "\u2014"}`
-  ];
-  if (report.integrity) {
-    lines.push("", `### Source \u2194 snapshot \u2014 ${report.integrity.status}`, "", markdownChanges(report.integrity.changes));
-  }
-  if (report.pullRequest) {
-    lines.push("", `### PR drift vs \`${report.pullRequest.base}\``, "", markdownChanges(report.pullRequest.changes));
-  }
-  if (github && report.status === "fail") {
-    lines.unshift(`::error title=Agent Surface contract drift::${report.integrity?.changes.length ?? 0} integrity change(s)`);
-  }
-  return `${lines.join("\n")}
-`;
-}
-function renderReport(report, format) {
-  if (format === "json") return canonicalJson(report, true);
-  if (format === "markdown") return markdownReport(report);
-  if (format === "github") return markdownReport(report, true);
-  return humanReport(report);
-}
-
-export {
-  DEFAULT_SNAPSHOT,
-  readManifest,
-  writeManifest,
-  readBaseManifest,
-  renderReport
-};
-//# sourceMappingURL=chunk-X6RGGBQ4.js.map

package/dist/chunk-X6RGGBQ4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/files.ts","../src/report.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, isAbsolute, relative, resolve, sep } from \"node:path\";\nimport { spawnSync } from \"node:child_process\";\nimport type { CapabilityContractManifest } from \"@agent-surface/core\";\nimport { canonicalManifestJson, verifyManifest } from \"@agent-surface/compiler\";\n\nexport const DEFAULT_SNAPSHOT = \".agent-surface/contract.json\";\n\nexport function readManifest(path: string): CapabilityContractManifest | undefined {\n  if (!existsSync(path)) return undefined;\n  try {\n    const manifest = JSON.parse(readFileSync(path, \"utf8\")) as CapabilityContractManifest;\n    verifyManifest(manifest);\n    return manifest;\n  } catch (error) {\n    throw new Error(`could not read contract ${path}: ${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n\nexport function writeManifest(path: string, manifest: CapabilityContractManifest): void {\n  mkdirSync(dirname(path), { recursive: true });\n  writeFileSync(path, canonicalManifestJson(manifest), \"utf8\");\n}\n\nfunction git(args: string[], cwd: string): string {\n  const result = spawnSync(\"git\", args, { cwd, encoding: \"utf8\" });\n  if (result.status !== 0) {\n    throw new Error(result.stderr.trim() || `git ${args.join(\" \")} failed`);\n  }\n  return result.stdout.trim();\n}\n\nexport function readBaseManifest(\n  base: string,\n  snapshotPath: string,\n  cwd: string,\n): CapabilityContractManifest {\n  const root = git([\"rev-parse\", \"--show-toplevel\"], cwd);\n  const absolute = isAbsolute(snapshotPath) ? snapshotPath : resolve(cwd, snapshotPath);\n  const path = relative(root, absolute);\n  if (path === \"..\" || path.startsWith(`..${sep}`) || isAbsolute(path)) {\n    throw new Error(`snapshot ${snapshotPath} is outside the Git worktree`);\n  }\n  const text = git([\"show\", `${base}:${path.split(sep).join(\"/\")}`], root);\n  try {\n    const manifest = JSON.parse(text) as CapabilityContractManifest;\n    verifyManifest(manifest);\n    return manifest;\n  } catch (error) {\n    throw new Error(`could not read ${snapshotPath} at ${base}: ${error instanceof Error ? error.message : String(error)}`);\n  }\n}\n","import type { CapabilityContractManifest } from \"@agent-surface/core\";\nimport { canonicalJson } from \"@agent-surface/compiler\";\nimport type { ContractChange } from \"./diff.js\";\nimport { changeCounts } from \"./diff.js\";\n\nexport type OutputFormat = \"human\" | \"json\" | \"github\" | \"markdown\";\n\nexport interface ContractReport {\n  command: \"inspect\" | \"check\" | \"snapshot\";\n  status: \"pass\" | \"fail\" | \"written\" | \"view\";\n  manifest: CapabilityContractManifest;\n  snapshotPath: string;\n  integrity?: {\n    status: \"current\" | \"missing\" | \"stale\";\n    changes: ContractChange[];\n  };\n  pullRequest?: {\n    base: string;\n    changes: ContractChange[];\n  };\n}\n\nfunction value(value: unknown): string {\n  if (value === undefined) return \"—\";\n  const text = typeof value === \"string\" ? value : JSON.stringify(value);\n  return text.length > 100 ? `${text.slice(0, 97)}…` : text;\n}\n\nfunction changeLine(change: ContractChange): string {\n  const mark = change.kind === \"added\" ? \"+\" : change.kind === \"removed\" ? \"-\" : \"~\";\n  return `${mark} ${change.classification.padEnd(9)} ${change.capabilityId} · ${change.declarationId} · ${change.field}${\n    change.kind === \"changed\" ? `: ${value(change.before)} → ${value(change.after)}` : \"\"\n  }`;\n}\n\nfunction section(title: string, changes: readonly ContractChange[]): string[] {\n  const counts = changeCounts(changes);\n  return [\n    `${title} (${changes.length}) · widening ${counts.widening} · narrowing ${counts.narrowing} · neutral ${counts.neutral}`,\n    ...(changes.length > 0 ? changes.map(changeLine) : [\"no changes\"]),\n  ];\n}\n\nexport function humanReport(report: ContractReport): string {\n  const lines = [\n    `AGENT SURFACE ${report.command.toUpperCase()} · ${report.status.toUpperCase()}`,\n    `Contract      ${report.manifest.hash}`,\n    `Completeness  ${report.manifest.completeness.status}`,\n    `Targets       ${report.manifest.targets.join(\", \") || \"—\"}`,\n    `Capabilities  ${report.manifest.capabilities.length}`,\n    `Snapshot      ${report.snapshotPath}`,\n  ];\n  if (report.integrity) {\n    lines.push(`Integrity     ${report.integrity.status}`);\n    lines.push(\"\", ...section(\"SOURCE ↔ SNAPSHOT\", report.integrity.changes));\n  }\n  if (report.pullRequest) {\n    lines.push(\"\", ...section(`PR DRIFT vs ${report.pullRequest.base}`, report.pullRequest.changes));\n  }\n  if (report.command === \"inspect\") {\n    lines.push(\"\", \"REPOSITORY CONTRACT\");\n    for (const entry of report.manifest.capabilities) {\n      lines.push(\n        `${entry.capabilityId} · ${entry.kind} · ${entry.effect} · ${entry.declarationId} · ${entry.targets.join(\",\")}`,\n      );\n    }\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction markdownChanges(changes: readonly ContractChange[]): string {\n  if (changes.length === 0) return \"No changes.\\n\";\n  return [\n    \"| Class | Change | Capability | Declaration | Field |\",\n    \"|---|---|---|---|---|\",\n    ...changes.map(\n      (change) =>\n        `| ${change.classification} | ${change.kind} | \\`${change.capabilityId}\\` | \\`${change.declarationId}\\` | \\`${change.field}\\` |`,\n    ),\n  ].join(\"\\n\");\n}\n\nexport function markdownReport(report: ContractReport, github = false): string {\n  const lines = [\n    `## Agent Surface ${report.command} — ${report.status}`,\n    \"\",\n    `- Contract: \\`${report.manifest.hash}\\``,\n    `- Completeness: **${report.manifest.completeness.status}**`,\n    `- Capabilities: **${report.manifest.capabilities.length}**`,\n    `- Targets: ${report.manifest.targets.map((target) => `\\`${target}\\``).join(\", \") || \"—\"}`,\n  ];\n  if (report.integrity) {\n    lines.push(\"\", `### Source ↔ snapshot — ${report.integrity.status}`, \"\", markdownChanges(report.integrity.changes));\n  }\n  if (report.pullRequest) {\n    lines.push(\"\", `### PR drift vs \\`${report.pullRequest.base}\\``, \"\", markdownChanges(report.pullRequest.changes));\n  }\n  if (github && report.status === \"fail\") {\n    lines.unshift(`::error title=Agent Surface contract drift::${report.integrity?.changes.length ?? 0} integrity change(s)`);\n  }\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nexport function renderReport(report: ContractReport, format: OutputFormat): string {\n  if (format === \"json\") return canonicalJson(report, true);\n  if (format === \"markdown\") return markdownReport(report);\n  if (format === \"github\") return markdownReport(report, true);\n  return humanReport(report);\n}\n"],"mappings":"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","names":["value"]}

package/dist/ink-E6DATMUQ.js

@@ -1,51 +0,0 @@
-import {
-  changeCounts
-} from "./chunk-IA7FUP4R.js";
-
-// src/ink.tsx
-import { Box, Text, render } from "ink";
-import { jsx, jsxs } from "react/jsx-runtime";
-function App({ report }) {
-  const ok = report.status === "pass" || report.status === "written" || report.status === "view";
-  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsxs(Text, { bold: true, color: ok ? "green" : "red", children: [
-      "AGENT SURFACE ",
-      report.command.toUpperCase(),
-      " \xB7 ",
-      report.status.toUpperCase()
-    ] }),
-    /* @__PURE__ */ jsxs(Text, { children: [
-      "Contract      ",
-      report.manifest.hash
-    ] }),
-    /* @__PURE__ */ jsxs(Text, { children: [
-      "Completeness  ",
-      report.manifest.completeness.status
-    ] }),
-    /* @__PURE__ */ jsxs(Text, { children: [
-      "Capabilities  ",
-      report.manifest.capabilities.length
-    ] }),
-    report.integrity ? /* @__PURE__ */ jsxs(Text, { children: [
-      "Integrity     ",
-      report.integrity.status
-    ] }) : null,
-    report.pullRequest ? /* @__PURE__ */ jsxs(Text, { children: [
-      "PR drift      ",
-      report.pullRequest.changes.length,
-      " vs ",
-      report.pullRequest.base,
-      " (",
-      changeCounts(report.pullRequest.changes).widening,
-      " widening)"
-    ] }) : null
-  ] });
-}
-async function renderInk(report) {
-  const instance = render(/* @__PURE__ */ jsx(App, { report }));
-  await instance.waitUntilExit();
-}
-export {
-  renderInk
-};
-//# sourceMappingURL=ink-E6DATMUQ.js.map

package/dist/ink-E6DATMUQ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/ink.tsx"],"sourcesContent":["import { Box, Text, render } from \"ink\";\nimport type { ContractReport } from \"./report.js\";\nimport { changeCounts } from \"./diff.js\";\n\nfunction App({ report }: { report: ContractReport }) {\n  const ok = report.status === \"pass\" || report.status === \"written\" || report.status === \"view\";\n  return (\n    <Box flexDirection=\"column\">\n      <Text bold color={ok ? \"green\" : \"red\"}>\n        AGENT SURFACE {report.command.toUpperCase()} · {report.status.toUpperCase()}\n      </Text>\n      <Text>Contract      {report.manifest.hash}</Text>\n      <Text>Completeness  {report.manifest.completeness.status}</Text>\n      <Text>Capabilities  {report.manifest.capabilities.length}</Text>\n      {report.integrity ? <Text>Integrity     {report.integrity.status}</Text> : null}\n      {report.pullRequest ? (\n        <Text>\n          PR drift      {report.pullRequest.changes.length} vs {report.pullRequest.base} ({\n            changeCounts(report.pullRequest.changes).widening\n          } widening)\n        </Text>\n      ) : null}\n    </Box>\n  );\n}\n\nexport async function renderInk(report: ContractReport): Promise<void> {\n  const instance = render(<App report={report} />);\n  await instance.waitUntilExit();\n}\n"],"mappings":";;;;;AAAA,SAAS,KAAK,MAAM,cAAc;AAQ5B,SAmBoB,KAnBpB;AAJN,SAAS,IAAI,EAAE,OAAO,GAA+B;AACnD,QAAM,KAAK,OAAO,WAAW,UAAU,OAAO,WAAW,aAAa,OAAO,WAAW;AACxF,SACE,qBAAC,OAAI,eAAc,UACjB;AAAA,yBAAC,QAAK,MAAI,MAAC,OAAO,KAAK,UAAU,OAAO;AAAA;AAAA,MACvB,OAAO,QAAQ,YAAY;AAAA,MAAE;AAAA,MAAI,OAAO,OAAO,YAAY;AAAA,OAC5E;AAAA,IACA,qBAAC,QAAK;AAAA;AAAA,MAAe,OAAO,SAAS;AAAA,OAAK;AAAA,IAC1C,qBAAC,QAAK;AAAA;AAAA,MAAe,OAAO,SAAS,aAAa;AAAA,OAAO;AAAA,IACzD,qBAAC,QAAK;AAAA;AAAA,MAAe,OAAO,SAAS,aAAa;AAAA,OAAO;AAAA,IACxD,OAAO,YAAY,qBAAC,QAAK;AAAA;AAAA,MAAe,OAAO,UAAU;AAAA,OAAO,IAAU;AAAA,IAC1E,OAAO,cACN,qBAAC,QAAK;AAAA;AAAA,MACW,OAAO,YAAY,QAAQ;AAAA,MAAO;AAAA,MAAK,OAAO,YAAY;AAAA,MAAK;AAAA,MAC5E,aAAa,OAAO,YAAY,OAAO,EAAE;AAAA,MAC1C;AAAA,OACH,IACE;AAAA,KACN;AAEJ;AAEA,eAAsB,UAAU,QAAuC;AACrE,QAAM,WAAW,OAAO,oBAAC,OAAI,QAAgB,CAAE;AAC/C,QAAM,SAAS,cAAc;AAC/B;","names":[]}