jui-tools-mcp-server 2.16.0 → 2.18.0

package/src/tools/infra/infra_prices_validate.ts

@@ -0,0 +1,41 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ServerConfig } from "../../config.js";
+import { failure, need, problems, runDocJson, text } from "./infra_common.js";
+
+/**
+ * `jsonui-doc validate infra-prices <project> --json`: the room's own price files (<infra.dir>/prices, or
+ * infra.prices_dir). Exit 0: no error; 1: errors; 2: the folder cannot be read (reason).
+ */
+export function register(server: McpServer, config: ServerConfig) {
+  server.tool(
+    "infra_prices_validate",
+    "Validate the server room's own price files (docs/infra/prices/*.json — only for what the bundled prices lack) with `jsonui-doc validate infra-prices --json`. Returns the files used, how many prices, and the problems by severity and code with the first 20. Needs jsonui-cli 2.3.15+.",
+    {
+      project_dir: z.string().optional().describe("Project directory with jui.config.json (overrides JUI_PROJECT_DIR env)"),
+    },
+    async ({ project_dir }) => {
+      try {
+        const projectDir = config.resolveProjectDir(project_dir);
+        const { exitCode, data } = await runDocJson(["validate", "infra-prices", projectDir, "--json"], projectDir);
+        need(data, ["ok"], "validate infra-prices");
+        if (!data.ok) {
+          need(data, ["reason", "message"], "validate infra-prices");
+          return text({ ok: false, exit: exitCode, readable: false, reason: data.reason, message: data.message });
+        }
+        need(data, ["dir", "files", "problems", "count"], "validate infra-prices");
+        return text({
+          ok: exitCode === 0,
+          exit: exitCode,
+          readable: true,
+          dir: data.dir,
+          files: data.files,
+          count: data.count,
+          problems: problems(data.problems, "validate infra-prices"),
+        });
+      } catch (e: any) {
+        return failure(e);
+      }
+    }
+  );
+}

package/src/tools/infra/infra_seed.ts

@@ -0,0 +1,88 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { existsSync, mkdtempSync, readFileSync, rmSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+import { ServerConfig } from "../../config.js";
+import { ContractError, FIRST, failure, need, text } from "./infra_common.js";
+import { runCli } from "../../cli_runner.js";
+
+/**
+ * `jsonui-doc seed infra <project> -o <dir>`: a draft model from what the project already says (Compose, Terraform /
+ * OpenTofu, Kubernetes, CloudFormation / SAM / CDK, wrangler, PaaS files, SDK imports and env names; never state,
+ * tfvars or .env values), and its report (what it read, what it could not place). By default the draft is written to
+ * a temp folder and read back — nothing in the project changes; write: true writes <infra.dir>/seed (the draft is a
+ * starting point, never read as the model). Exit 0: drafted; 2: refused (bad config, the draft fails its own check,
+ * or a draft is already there without force).
+ */
+
+function infraDir(projectDir: string): string {
+  try {
+    const cfg = JSON.parse(readFileSync(join(projectDir, "jui.config.json"), "utf-8"));
+    if (typeof cfg?.infra?.dir === "string") return cfg.infra.dir;
+  } catch {
+    // no config, or not JSON: the CLI says so itself
+  }
+  return "docs/infra";
+}
+
+function readJson(path: string, what: string): any {
+  try {
+    return JSON.parse(readFileSync(path, "utf-8"));
+  } catch {
+    throw new ContractError(`seed infra wrote no readable ${what} at ${path}`);
+  }
+}
+
+export function summarize(draft: any, report: any) {
+  need(draft, ["nodes", "groups", "edges"], "seed infra draft");
+  need(report, ["inputs", "unmatched", "skipped", "skippedCount", "notes", "withheld"], "seed infra report");
+  return {
+    counts: { nodes: draft.nodes.length, groups: draft.groups.length, edges: draft.edges.length,
+      flows: Array.isArray(draft.flows) ? draft.flows.length : 0 },
+    environments: (draft.environments ?? []).map((e: any) => e.id),
+    nodes: draft.nodes.slice(0, 50).map((n: any) => ({
+      id: n.id, category: n.category, provider: n.provider, service: n.service, iac: n.iac, environments: n.environments,
+    })),
+    inputs: report.inputs,
+    unmatched: Object.fromEntries(Object.entries(report.unmatched).map(([provider, u]: [string, any]) =>
+      [provider, { count: u.count, items: (u.items ?? []).slice(0, FIRST) }])),
+    notDrawn: report.notDrawn ?? {},
+    skipped: { count: report.skippedCount, first: report.skipped.slice(0, FIRST) },
+    notes: report.notes.slice(0, FIRST),
+    withheld: report.withheld,
+  };
+}
+
+export function register(server: McpServer, config: ServerConfig) {
+  server.tool(
+    "infra_seed",
+    "Draft the server room's model from the project's IaC, config files and code with `jsonui-doc seed infra` (Compose, Terraform/OpenTofu, Kubernetes, CloudFormation/SAM/CDK, wrangler, Firebase/PaaS files, SDK imports and env var names — never Terraform state, tfvars or .env values). Returns the draft's counts and nodes (id, category, provider, service, iac), what was read, what could not be placed (unmatched, by provider) or was skipped, and notes. By default nothing in the project is written; write: true writes <infra.dir>/seed/draft.json and seed-report.json (a starting point to copy from — the model is docs/infra/*.json).",
+    {
+      project_dir: z.string().optional().describe("Project directory with jui.config.json (overrides JUI_PROJECT_DIR env)"),
+      write: z.boolean().optional().describe("Write the draft to <infra.dir>/seed in the project (default false: read only)"),
+      force: z.boolean().optional().describe("With write: replace a draft already there"),
+    },
+    async ({ project_dir, write, force }) => {
+      const temp = write ? null : mkdtempSync(join(tmpdir(), "jui-mcp-seed-"));
+      try {
+        const projectDir = config.resolveProjectDir(project_dir);
+        const out = temp ?? join(projectDir, infraDir(projectDir), "seed");
+        const args = ["seed", "infra", projectDir, "-o", out];
+        if (write && force) args.push("--force");
+        const result = await runCli("jsonui-doc", args, { cwd: projectDir, timeout: 180_000 });
+        if (result.exitCode !== 0 || !existsSync(join(out, "draft.json"))) {
+          return text({ ok: false, exit: result.exitCode,
+            message: (result.stderr || result.stdout).trim().split("\n").slice(-5).join("\n") });
+        }
+        const summary = summarize(readJson(join(out, "draft.json"), "draft.json"),
+          readJson(join(out, "seed-report.json"), "seed-report.json"));
+        return text({ ok: true, exit: 0, written: write ? out : null, ...summary });
+      } catch (e: any) {
+        return failure(e);
+      } finally {
+        if (temp) rmSync(temp, { recursive: true, force: true });
+      }
+    }
+  );
+}

package/src/tools/infra/infra_validate.ts

@@ -0,0 +1,79 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ServerConfig } from "../../config.js";
+import { ContractError, FIRST, failure, need, problems, runDocJson, text } from "./infra_common.js";
+
+/**
+ * `jsonui-doc validate infra <project> --json`: the room's model (docs/infra/*.json, or jui.config.json's infra.dir)
+ * read as jui viz reads it — each file against the schema and the shapes of secrets, then merged, and its flows
+ * walked. Exit 0: no error (warnings alone are 0); 1: errors; 2: nothing could be read (reason).
+ *
+ * Migration plans (jsonui-cli 2.3.20+, docs/infra/migrations/<name>/changes.json + removals.json): the CLI checks every
+ * plan with the model, or one with `--migration <name>`, and lists them under "migrations". A plan's error makes the
+ * exit 1 while the model's own problems are empty, so a room that has plans gets their summary here — without it the
+ * exit would name an error the answer does not show. A room with none answers exactly as before.
+ */
+
+function migrationSummary(m: any) {
+  need(m, ["name", "dir", "ok", "problems", "steps", "counts"], "validate infra migration");
+  return {
+    name: m.name,
+    dir: m.dir,
+    ok: m.ok,
+    counts: m.counts,
+    problems: problems(m.problems, "validate infra migration"),
+    steps: m.steps.length,
+    firstSteps: m.steps.slice(0, FIRST).map((s: any) => {
+      need(s, ["index", "kind", "node"], "validate infra migration step");
+      return { index: s.index, kind: s.kind, node: s.node,
+        ...(s.edgesRemoved?.length ? { edgesRemoved: s.edgesRemoved } : {}),
+        ...(s.edgesAdded?.length ? { edgesAdded: s.edgesAdded } : {}) };
+    }),
+  };
+}
+function migrations(data: any, plan: string | undefined) {
+  if (plan) need(data, ["migrations"], "validate infra --migration");
+  const list = data.migrations;
+  if (list === undefined) return {};   // a room with no plan: the CLI prints no key, and nor does this
+  if (!Array.isArray(list)) throw new ContractError('validate infra: "migrations" is not a list');
+  return { migrations: list.map(migrationSummary) };
+}
+
+export function register(server: McpServer, config: ServerConfig) {
+  server.tool(
+    "infra_validate",
+    "Validate the server room's infra model (docs/infra/*.json: environments, groups, nodes, edges, flows) with `jsonui-doc validate infra --json`. Returns whether it could be read (and why not), the files used, the counts, and the problems by severity and code with the first 20 (file, path, code, message). Flow problems (flow.*) name the rule a step most likely missed. When the room has migration plans (docs/infra/migrations/<name>/changes.json + removals.json), each plan's check too: its problems (migration.remove_missing / duplicate / both / order_unknown / edge_end, and the infra checks on the merged new model), its counts (added, replaced, removed, edges added / removed) and its steps in order; `plan` checks that one plan only. Needs jsonui-cli 2.3.15+ (plans: 2.3.20+).",
+    {
+      project_dir: z.string().optional().describe("Project directory with jui.config.json (overrides JUI_PROJECT_DIR env)"),
+      plan: z.string().optional().describe("One migration plan's name (its folder under docs/infra/migrations); default: every plan"),
+    },
+    async ({ project_dir, plan }) => {
+      try {
+        const projectDir = config.resolveProjectDir(project_dir);
+        const args = ["validate", "infra", projectDir, "--json"];
+        if (plan) args.push("--migration", plan);
+        const { exitCode, data } = await runDocJson(args, projectDir);
+        need(data, ["ok"], "validate infra");
+        if (!data.ok && data.reason !== "invalid") {
+          need(data, ["reason", "message"], "validate infra");
+          return text({ ok: false, exit: exitCode, readable: false, reason: data.reason, message: data.message });
+        }
+        need(data, ["dir", "files", "problems"], "validate infra");
+        return text({
+          ok: exitCode === 0,
+          exit: exitCode,
+          readable: data.ok,
+          dir: data.dir,
+          files: data.files,
+          environments: (data.environments ?? []).map((e: any) => e.id),
+          counts: data.counts ?? null,
+          flows: Array.isArray(data.flows) ? data.flows.length : null,
+          problems: problems(data.problems, "validate infra"),
+          ...migrations(data, plan),
+        });
+      } catch (e: any) {
+        return failure(e);
+      }
+    }
+  );
+}

package/tests/fixtures/infra/RECORDED_FROM

@@ -0,0 +1 @@
+290ce9df migration plans test: an edge whose two ends go at different steps goes at the first of them

package/tests/fixtures/infra/answers-without-plan.json

@@ -0,0 +1,9 @@
+{
+  "validate ok": "{\n  \"ok\": true,\n  \"exit\": 0,\n  \"readable\": true,\n  \"dir\": \"docs/infra\",\n  \"files\": [\n    \"external.json\",\n    \"main.json\"\n  ],\n  \"environments\": [\n    \"production\",\n    \"staging\"\n  ],\n  \"counts\": {\n    \"groups\": 8,\n    \"nodes\": 12,\n    \"edges\": 10\n  },\n  \"flows\": 0,\n  \"problems\": {\n    \"count\": 0,\n    \"errors\": 0,\n    \"warnings\": 0,\n    \"byCode\": {},\n    \"first\": []\n  }\n}",
+  "validate errors": "{\n  \"ok\": false,\n  \"exit\": 1,\n  \"readable\": true,\n  \"dir\": \"docs/infra\",\n  \"files\": [\n    \"external.json\",\n    \"main.json\"\n  ],\n  \"environments\": [\n    \"production\",\n    \"staging\"\n  ],\n  \"counts\": {\n    \"groups\": 8,\n    \"nodes\": 12,\n    \"edges\": 10\n  },\n  \"flows\": 0,\n  \"problems\": {\n    \"count\": 1,\n    \"errors\": 1,\n    \"warnings\": 0,\n    \"byCode\": {\n      \"schema\": 1\n    },\n    \"first\": [\n      {\n        \"severity\": \"error\",\n        \"code\": \"schema\",\n        \"file\": \"bad.json\",\n        \"path\": \"/nodes/0/category\",\n        \"message\": \"must be one of client, compute.vm, compute.container, compute.function, compute.k8s, compute.paas, edge.cdn, edge.dns, edge.waf, load_balancer, gateway.api, gateway.nat, network.ip, database.relational, database.document, database.kv, database.search, cache, storage.object, storage.file, storage.block, queue, stream, scheduler, mail, auth, secrets, monitoring, ci, external.saas, security.iam, security.policy, monitoring.alarm\"\n      }\n    ]\n  }\n}",
+  "validate unreadable": "{\n  \"ok\": false,\n  \"exit\": 2,\n  \"readable\": false,\n  \"reason\": \"no_infra\",\n  \"message\": \"no model files in docs/infra (*.json)\"\n}",
+  "cost month": "{\n  \"ok\": true,\n  \"exit\": 0,\n  \"dir\": \"docs/infra/load\",\n  \"scenario\": \"ordinary\",\n  \"scenarios\": [\n    {\n      \"id\": \"ordinary\",\n      \"label\": \"ふだんの月\",\n      \"file\": \"ordinary.json\",\n      \"month\": \"2026-11\",\n      \"environment\": \"production\"\n    },\n    {\n      \"id\": \"sale\",\n      \"label\": \"セールの月\",\n      \"file\": \"sale.json\",\n      \"month\": \"2026-11\",\n      \"environment\": \"production\"\n    }\n  ],\n  \"loadProblems\": {\n    \"count\": 0,\n    \"errors\": 0,\n    \"first\": []\n  },\n  \"priceWarnings\": [],\n  \"priceWarningCount\": 0,\n  \"month\": {\n    \"scenario\": \"ordinary\",\n    \"month\": \"2026-11\",\n    \"usd\": 1018.5974779999989,\n    \"by\": \"provider\",\n    \"totals\": [\n      {\n        \"key\": \"aws\",\n        \"label\": \"aws\",\n        \"usd\": 1018.5974779999997\n      }\n    ],\n    \"days\": 30,\n    \"dearestDay\": \"2026-11-30\",\n    \"noPrice\": [\n      {\n        \"node\": \"mailer\",\n        \"meter\": \"emails\",\n        \"sku\": \"emails\",\n        \"unit\": \"email\"\n      },\n      {\n        \"node\": \"api-5xx\",\n        \"meter\": \"alarm\",\n        \"sku\": \"alarm\",\n        \"unit\": \"month\"\n      }\n    ],\n    \"noRule\": [\n      \"api-role\"\n    ],\n    \"loadUndefined\": [\n      \"stripe\"\n    ],\n    \"overflowHours\": {},\n    \"notes\": [\n      \"no price for (no service) emails (email) in ap-northeast-1\",\n      \"no price for cloudwatch.alarm alarm (month) in no region\"\n    ],\n    \"noteCount\": 2\n  },\n  \"topNodes\": [\n    {\n      \"node\": \"cdn\",\n      \"usd\": 455.4774000000002\n    },\n    {\n      \"node\": \"db-prod\",\n      \"usd\": 422.3999999999987\n    },\n    {\n      \"node\": \"api-prod\",\n      \"usd\": 64.80000000000005\n    },\n    {\n      \"node\": \"assets\",\n      \"usd\": 44.55927800000017\n    },\n    {\n      \"node\": \"alb-prod\",\n      \"usd\": 29.015999999999977\n    },\n    {\n      \"node\": \"api-prod>db-prod\",\n      \"usd\": 2.3447999999999984\n    }\n  ]\n}",
+  "cost month by node": "{\n  \"ok\": true,\n  \"exit\": 0,\n  \"dir\": \"docs/infra/load\",\n  \"scenario\": \"sale\",\n  \"scenarios\": [\n    {\n      \"id\": \"ordinary\",\n      \"label\": \"ふだんの月\",\n      \"file\": \"ordinary.json\",\n      \"month\": \"2026-11\",\n      \"environment\": \"production\"\n    },\n    {\n      \"id\": \"sale\",\n      \"label\": \"セールの月\",\n      \"file\": \"sale.json\",\n      \"month\": \"2026-11\",\n      \"environment\": \"production\"\n    }\n  ],\n  \"loadProblems\": {\n    \"count\": 0,\n    \"errors\": 0,\n    \"first\": []\n  },\n  \"priceWarnings\": [],\n  \"priceWarningCount\": 0,\n  \"month\": {\n    \"scenario\": \"sale\",\n    \"month\": \"2026-11\",\n    \"usd\": 2679.3521999999975,\n    \"by\": \"node\",\n    \"totals\": [\n      {\n        \"key\": \"cdn\",\n        \"label\": \"CloudFront\",\n        \"usd\": 1975.4412000000011\n      },\n      {\n        \"key\": \"db-prod\",\n        \"label\": \"db-prod\",\n        \"usd\": 598.2749999999992\n      },\n      {\n        \"key\": \"api-prod\",\n        \"label\": \"api-prod\",\n        \"usd\": 88.13999999999997\n      },\n      {\n        \"key\": \"alb-prod\",\n        \"label\": \"alb-prod\",\n        \"usd\": 17.496\n      }\n    ],\n    \"days\": 30,\n    \"dearestDay\": \"2026-11-27\",\n    \"noPrice\": [\n      {\n        \"node\": \"api-5xx\",\n        \"meter\": \"alarm\",\n        \"sku\": \"alarm\",\n        \"unit\": \"month\"\n      }\n    ],\n    \"noRule\": [\n      \"api-role\"\n    ],\n    \"loadUndefined\": [\n      \"stripe\",\n      \"mailer\",\n      \"assets\"\n    ],\n    \"overflowHours\": {\n      \"api-prod\": 17,\n      \"db-prod\": 3\n    },\n    \"notes\": [\n      \"no price for cloudwatch.alarm alarm (month) in no region\"\n    ],\n    \"noteCount\": 1\n  },\n  \"topNodes\": [\n    {\n      \"node\": \"cdn\",\n      \"usd\": 1975.4412000000011\n    },\n    {\n      \"node\": \"db-prod\",\n      \"usd\": 598.2749999999991\n    },\n    {\n      \"node\": \"api-prod\",\n      \"usd\": 88.13999999999996\n    },\n    {\n      \"node\": \"alb-prod\",\n      \"usd\": 17.496\n    }\n  ]\n}",
+  "cost day": "{\n  \"ok\": true,\n  \"exit\": 0,\n  \"dir\": \"docs/infra/load\",\n  \"scenario\": \"ordinary\",\n  \"scenarios\": [\n    {\n      \"id\": \"ordinary\",\n      \"label\": \"ふだんの月\",\n      \"file\": \"ordinary.json\",\n      \"month\": \"2026-11\",\n      \"environment\": \"production\"\n    },\n    {\n      \"id\": \"sale\",\n      \"label\": \"セールの月\",\n      \"file\": \"sale.json\",\n      \"month\": \"2026-11\",\n      \"environment\": \"production\"\n    }\n  ],\n  \"loadProblems\": {\n    \"count\": 0,\n    \"errors\": 0,\n    \"first\": []\n  },\n  \"priceWarnings\": [],\n  \"priceWarningCount\": 0,\n  \"day\": {\n    \"scenario\": \"ordinary\",\n    \"date\": \"2026-11-03\",\n    \"usd\": 34.254097666666674,\n    \"nodes\": [\n      {\n        \"node\": \"cdn\",\n        \"label\": \"CloudFront\",\n        \"provider\": \"aws\",\n        \"rule\": \"aws/cloudfront\",\n        \"usd\": 15.4623,\n        \"peakHour\": 19,\n        \"meters\": {\n          \"egress-asia\": {\n            \"usd\": 1.1940000000000008,\n            \"amount\": 9.95,\n            \"unit\": \"GB\",\n            \"sku\": \"egress-asia\",\n            \"layer\": \"bundled\"\n          },\n          \"egress-japan\": {\n            \"usd\": 5.6715,\n            \"amount\": 49.75,\n            \"unit\": \"GB\",\n            \"sku\": \"egress-japan\",\n            \"layer\": \"bundled\"\n          },\n          \"requests-asia\": {\n            \"usd\": 1.4328,\n            \"amount\": 1194000,\n            \"unit\": \"request\",\n            \"sku\": \"requests-asia\",\n            \"layer\": \"bundled\"\n          },\n          \"requests-japan\": {\n            \"usd\": 7.164,\n            \"amount\": 5970000,\n            \"unit\": \"request\",\n            \"sku\": \"requests-japan\",\n            \"layer\": \"bundled\"\n          }\n        }\n      },\n      {\n        \"node\": \"db-prod\",\n        \"label\": \"db-prod\",\n        \"provider\": \"aws\",\n        \"rule\": \"aws/rds\",\n        \"usd\": 14.080000000000005,\n        \"peakHour\": 0,\n        \"meters\": {\n          \"instance\": {\n            \"usd\": 12.239999999999997,\n            \"amount\": 24,\n            \"unit\": \"instance-hour\",\n            \"sku\": \"db.r6g.large:multi-az\",\n            \"layer\": \"bundled\"\n          },\n          \"storage\": {\n            \"usd\": 1.8400000000000054,\n            \"amount\": 6.666666666666665,\n            \"unit\": \"GB-month\",\n            \"sku\": \"storage:multi-az\",\n            \"layer\": \"bundled\"\n          }\n        }\n      },\n      {\n        \"node\": \"api-prod\",\n        \"label\": \"api-prod\",\n        \"provider\": \"aws\",\n        \"rule\": \"aws/fargate\",\n        \"usd\": 2.16,\n        \"peakHour\": 0,\n        \"meters\": {\n          \"vcpu\": {\n            \"usd\": 1.7999999999999994,\n            \"amount\": 36,\n            \"unit\": \"vCPU-hour\",\n            \"sku\": \"vcpu\",\n            \"layer\": \"user\"\n          },\n          \"memory\": {\n            \"usd\": 0.3600000000000002,\n            \"amount\": 72,\n            \"unit\": \"GB-hour\",\n            \"sku\": \"memory\",\n            \"layer\": \"user\"\n          }\n        }\n      },\n      {\n        \"node\": \"assets\",\n        \"label\": \"アセットのバケツ\",\n        \"provider\": \"aws\",\n        \"rule\": \"aws/s3\",\n        \"usd\": 1.5049976666666658,\n        \"peakHour\": 19,\n        \"meters\": {\n          \"storage\": {\n            \"usd\": 0.4166666666666656,\n            \"amount\": 16.666666666666668,\n            \"unit\": \"GB-month\",\n            \"sku\": \"storage\",\n            \"layer\": \"bundled\"\n          },\n          \"get\": {\n            \"usd\": 1.060272,\n            \"amount\": 2865600,\n            \"unit\": \"request\",\n            \"sku\": \"get\",\n            \"layer\": \"user\"\n          },\n          \"put\": {\n            \"usd\": 0.028059,\n            \"amount\": 5970,\n            \"unit\": \"request\",\n            \"sku\": \"put\",\n            \"layer\": \"bundled\"\n          }\n        }\n      },\n      {\n        \"node\": \"alb-prod\",\n        \"label\": \"alb-prod\",\n        \"provider\": \"aws\",\n        \"rule\": \"aws/alb\",\n        \"usd\": 0.9672000000000001,\n        \"peakHour\": 0,\n        \"meters\": {\n          \"hour\": {\n            \"usd\": 0.5831999999999998,\n            \"amount\": 24,\n            \"unit\": \"instance-hour\",\n            \"sku\": \"hour\",\n            \"layer\": \"bundled\"\n          },\n          \"lcu\": {\n            \"usd\": 0.38400000000000023,\n            \"amount\": 48,\n            \"unit\": \"LCU-hour\",\n            \"sku\": \"lcu\",\n            \"layer\": \"bundled\"\n          }\n        }\n      },\n      {\n        \"node\": \"api-prod>db-prod\",\n        \"label\": \"api-prod>db-prod\",\n        \"provider\": \"aws\",\n        \"rule\": \"transfer\",\n        \"usd\": 0.07959999999999993,\n        \"peakHour\": 19,\n        \"meters\": {\n          \"transfer-regional\": {\n            \"usd\": 0.07959999999999996,\n            \"amount\": 3.9800000000000004,\n            \"unit\": \"GB\",\n            \"sku\": \"transfer-regional\",\n            \"layer\": \"bundled\"\n          }\n        }\n      },\n      {\n        \"node\": \"stripe\",\n        \"label\": \"Stripe\",\n        \"provider\": \"stripe\",\n        \"rule\": \"generic/external.saas\",\n        \"note\": \"load undefined\",\n        \"usd\": 0,\n        \"peakHour\": 0,\n        \"meters\": {}\n      },\n      {\n        \"node\": \"mailer\",\n        \"label\": \"メール配信\",\n        \"provider\": \"sendgrid\",\n        \"rule\": \"generic/mail\",\n        \"usd\": 0,\n        \"peakHour\": 0,\n        \"meters\": {\n          \"emails\": {\n            \"usd\": 0,\n            \"amount\": 1658.3333333333335,\n            \"unit\": \"email\",\n            \"sku\": \"emails\",\n            \"layer\": null\n          }\n        }\n      },\n      {\n        \"node\": \"api-role\",\n        \"label\": \"API の実行ロール\",\n        \"provider\": \"aws\",\n        \"rule\": null,\n        \"note\": \"no rule\",\n        \"usd\": 0,\n        \"peakHour\": 0,\n        \"meters\": {}\n      },\n      {\n        \"node\": \"api-5xx\",\n        \"label\": \"API の 5xx\",\n        \"provider\": \"aws\",\n        \"rule\": \"aws/cloudwatch-alarm\",\n        \"usd\": 0,\n        \"peakHour\": 0,\n        \"meters\": {\n          \"alarm\": {\n            \"usd\": 0,\n            \"amount\": 0.03333333333333332,\n            \"unit\": \"month\",\n            \"sku\": \"alarm\",\n            \"layer\": null\n          }\n        }\n      }\n    ],\n    \"others\": {\n      \"count\": 0,\n      \"usd\": 0\n    }\n  }\n}",
+  "cost refused": "{\n  \"ok\": false,\n  \"exit\": 2,\n  \"reason\": \"no_scenario\",\n  \"message\": \"no scenario 'nope'; there are: ordinary, sale\"\n}"
+}

package/tests/fixtures/infra/check-infra.json

@@ -0,0 +1,103 @@
+{
+  "ok": true,
+  "exit": 0,
+  "checks": [
+    {
+      "name": "infra-load",
+      "type": "builtin:infra-load",
+      "status": "ok",
+      "summary": {
+        "ok": 10,
+        "mismatch": 0,
+        "missing_in_impl": 0,
+        "missing_in_doc": 0,
+        "skipped": 4,
+        "warning": 4,
+        "unit": "node"
+      },
+      "results": [
+        {
+          "target": "load/ordinary/stripe",
+          "status": "warning",
+          "confidence": "metadata",
+          "expected": "requests, input_tokens, output_tokens",
+          "message": "billed by use, but this load definition gives it no load (undefined, not 0)"
+        },
+        {
+          "target": "load/ordinary/api-role",
+          "status": "skipped",
+          "confidence": "metadata",
+          "message": "its kind reads no load"
+        },
+        {
+          "target": "load/ordinary/api-5xx",
+          "status": "skipped",
+          "confidence": "metadata",
+          "message": "its kind reads no load"
+        },
+        {
+          "target": "load/sale/stripe",
+          "status": "warning",
+          "confidence": "metadata",
+          "expected": "requests, input_tokens, output_tokens",
+          "message": "billed by use, but this load definition gives it no load (undefined, not 0)"
+        },
+        {
+          "target": "load/sale/mailer",
+          "status": "warning",
+          "confidence": "metadata",
+          "expected": "emails",
+          "message": "billed by use, but this load definition gives it no load (undefined, not 0)"
+        },
+        {
+          "target": "load/sale/assets",
+          "status": "warning",
+          "confidence": "metadata",
+          "expected": "get_requests, put_requests, storage_gb, egress_gb",
+          "message": "billed by use, but this load definition gives it no load (undefined, not 0)"
+        },
+        {
+          "target": "load/sale/api-role",
+          "status": "skipped",
+          "confidence": "metadata",
+          "message": "its kind reads no load"
+        },
+        {
+          "target": "load/sale/api-5xx",
+          "status": "skipped",
+          "confidence": "metadata",
+          "message": "its kind reads no load"
+        }
+      ],
+      "warnings": [],
+      "report": "/private<ROOT>/room/docs/infra/load/.check-report.infra-load.json"
+    },
+    {
+      "name": "infra-code",
+      "type": "builtin:infra-code",
+      "status": "ok",
+      "summary": {
+        "ok": 0,
+        "mismatch": 0,
+        "missing_in_impl": 0,
+        "missing_in_doc": 0,
+        "skipped": 0,
+        "warning": 1,
+        "unit": "reference"
+      },
+      "results": [
+        {
+          "target": "stripe/stripe#evidence/0",
+          "status": "warning",
+          "confidence": "proof",
+          "expected": "backend/app/config.py",
+          "message": "the evidence file is not there"
+        }
+      ],
+      "warnings": [
+        "[unverified] *: only Python and JavaScript / TypeScript imports, AWS SDK clients and environment variable names are read (not values, not calls): a service reached another way is not seen"
+      ],
+      "report": "/private<ROOT>/room/docs/infra/.check-report.infra-code.json"
+    }
+  ]
+}