jui-tools-mcp-server 2.17.0 → 2.18.0

package/README.md

@@ -146,12 +146,12 @@ Claude Code のセッションを見るローカルのビューア（`jui viz`
 
 | Tool | Description | CLI |
 |------|-------------|-----|
-| `infra_validate` | モデルを読めるか（読めない時は理由）、使ったファイル・数・flow の数、problems を重さとコードで数え、最初の 20 件 | `jsonui-doc validate infra <project> --json` |
+| `infra_validate` | モデルを読めるか（読めない時は理由）、使ったファイル・数・flow の数、problems を重さとコードで数え、最初の 20 件。移管計画（`docs/infra/migrations/<名前>`）がある部屋では、計画ごとの problems（`migration.*` と、新の構成に今の検査を当てた分）・数・ステップの順も（`plan` で 1 つだけ、2.3.20 以降） | `jsonui-doc validate infra <project> --json [--migration <名前>]` |
 | `infra_load_validate` | 負荷のシナリオ（id・環境・月・時間・行・edge）と problems（node・hour・quantity つき） | `jsonui-doc validate infra-load <project> --json` |
 | `infra_prices_validate` | 部屋の単価のファイル・単価の数・problems | `jsonui-doc validate infra-prices <project> --json` |
 | `infra_seed` | IaC・設定ファイル・コードから下書き。数・node・読んだ物・置けなかった物（unmatched）・skipped・notes。既定では一時フォルダに書いて読み戻し、プロジェクトは変えない（`write: true` で `<infra.dir>/seed`） | `jsonui-doc seed infra <project> -o <dir> [--force]` |
 | `infra_check` | 宣言した `builtin:infra-iac` / `infra-code` / `infra-load` の結果（status・数・ok でない結果の最初の 20 件・レポートの道） | `jsonui-doc check infra -p <project> --json` |
-| `infra_cost` | 月の合計・provider（か node）ごとの合計・上位 node・一番高い日・単価なし／規則なし／負荷なし・容量を超えた時間・注意。`date` で 1 日（上位 node の meter ごとの額と単価の層、ピークの時刻）。負荷の problems と単価の警告も | `jsonui-doc cost infra <project> --json [--scenario] [--date] [--by]` |
+| `infra_cost` | 月の合計・provider（か node）ごとの合計・上位 node・一番高い日・単価なし／規則なし／負荷なし・容量を超えた時間・注意。`date` で 1 日（上位 node の meter ごとの額と単価の層、ピークの時刻）。負荷の problems と単価の警告も。`plan` で移管計画の月の旧・新・差（node ごとの増減の大きい順・provider ごと・ステップごと。ステップの差はそのステップでの月額全体の変化で、動いたノード・線は moved。旧か新で値が付かない変えたノードは unpricedChanged、`account: true` でアカウントの月（その環境をまとめて値付け）も、2.3.20 以降） | `jsonui-doc cost infra <project> --json [--scenario] [--date] [--by] [--migration <名前> [--account]]` |
 
 > 単価の取得（`jui viz cloud-prices fetch`）はネットへ出て viz のホームに書くので **MCP 非公開**（CLI で行う）。jsonui-doc が古くて `--json` の形が違うと、どのキーが無いかを名指しして失敗する。
 

package/dist/tools/infra/infra_cost.js

@@ -8,7 +8,54 @@ import { FIRST, failure, need, problems, runDocJson, text } from "./infra_common
  * hours over capacity, the notes, the load problems and the price-book warnings — and for a day, each top node's
  * charge by meter with the price layer it came from. Exit 0: simulated; 1: simulated, a load file has an error (left
  * out); 2: nothing simulated (reason).
+ *
+ * With `plan` (jsonui-cli 2.3.20+, `--migration <name>`): the same engine run on the old model and on the new one (old
+ * + changes − removals), and the difference — the totals, per node (what the plan added, replaced, removed or left),
+ * per provider, after each step of the plan, and with `account` the account's month (its environments priced
+ * together). Nothing is computed here.
+ * A plan with an error is not priced: the CLI refuses it (exit 2, reason bad_plan, the plan's problems), as it does a
+ * plan name with no folder (no_plan) — both answered by the refusal path below, problems counted.
  */
+function migrationSummary(data) {
+    need(data, ["migration", "scenario", "old", "new", "diff", "byNode", "byProvider", "steps", "account", "unpricedChanged"], "cost infra --migration");
+    for (const k of ["old", "new", "diff"])
+        need(data[k], ["usd"], `cost infra --migration ${k}`);
+    for (const k of ["old", "new"])
+        need(data[k], ["noPrice", "noRule", "loadUndefined"], `cost infra --migration ${k}`);
+    for (const n of data.byNode)
+        need(n, ["node", "change", "unpriced", "old", "new", "diff"], "cost infra --migration node");
+    for (const s of data.steps) {
+        need(s, ["index", "node", "usd", "diff", "moved"], "cost infra --migration step");
+        for (const m of s.moved)
+            need(m, ["node", "diff"], "cost infra --migration step moved");
+    }
+    if (data.account !== null)
+        need(data.account, ["on", "old", "new", "diff"], "cost infra --migration account");
+    const changed = data.byNode.filter((n) => n.change !== "same" || n.diff !== 0);
+    const byChange = {};
+    for (const n of data.byNode)
+        byChange[n.change] = (byChange[n.change] ?? 0) + 1;
+    return {
+        migration: data.migration,
+        scenario: data.scenario,
+        usd: { old: data.old.usd, new: data.new.usd, diff: data.diff.usd },
+        // what either model cannot price (no price, no rule, no load): its part is 0 there, so not in the difference
+        oldUnpriced: { noPrice: data.old.noPrice, noRule: data.old.noRule, loadUndefined: data.old.loadUndefined },
+        newUnpriced: { noPrice: data.new.noPrice, noRule: data.new.noRule, loadUndefined: data.new.loadUndefined },
+        // the nodes the plan changes whose month is not all priced: the difference leaves their part out — not a saving
+        unpricedChanged: data.unpricedChanged,
+        nodes: byChange,
+        // the biggest movements first, whichever way
+        topChanges: [...changed].sort((a, b) => Math.abs(b.diff) - Math.abs(a.diff)).slice(0, FIRST),
+        changedCount: changed.length,
+        byProvider: data.byProvider,
+        // a step's diff is the whole month's change at that step, not its node's own: a neighbour can move with it (a
+        // shared free amount); moved names what moved, biggest first (a node, or "a>b" for a line's transfer)
+        steps: data.steps.map((s) => ({ index: s.index, node: s.node, usd: s.usd, diff: s.diff,
+            moved: s.moved.slice(0, FIRST), movedCount: s.moved.length })),
+        account: data.account,
+    };
+}
 function monthSummary(m) {
     need(m, ["scenario", "month", "usd", "by", "keys", "days", "noPrice", "noRule", "loadUndefined", "overflowHours",
         "warnings", "warningCount"], "cost infra month");
@@ -65,15 +112,25 @@ function daySummary(day) {
     };
 }
 export function register(server, config) {
-    server.tool("infra_cost", "Simulate the server room's cost with `jsonui-doc cost infra --json` (the model, a load scenario under docs/infra/load, prices: the room's own, then fetched, then bundled — USD, on demand). Without date: the month's total, totals by provider (or by node), the top nodes, the dearest day, what has no price / no rule / no load, hours over capacity, notes. With date (YYYY-MM-DD in the scenario's month): that day's top nodes, each with its charge by meter, the price layer, and its peak hour. Also the scenarios there are, the load problems and the price-book warnings (prices.free_dropped: a room's price row dropping a bundled free amount). Needs jsonui-cli 2.3.15+.", {
+    server.tool("infra_cost", "Simulate the server room's cost with `jsonui-doc cost infra --json` (the model, a load scenario under docs/infra/load, prices: the room's own, then fetched, then bundled — USD, on demand). Without date: the month's total, totals by provider (or by node), the top nodes, the dearest day, what has no price / no rule / no load, hours over capacity, notes. With date (YYYY-MM-DD in the scenario's month): that day's top nodes, each with its charge by meter, the price layer, and its peak hour. Also the scenarios there are, the load problems and the price-book warnings (prices.free_dropped: a room's price row dropping a bundled free amount). With plan (a migration plan's name, docs/infra/migrations/<name>): the month's old, new and difference — per node (added / replaced / removed / same, the biggest changes first), per provider, after each step of the plan (a step's difference is the whole month's change at that step, not its node's own: moved names each node or line's transfer that moved), what is not priced in the old or the new (unpricedChanged: changed nodes whose part the difference leaves out — not a saving), and with account the account's month too (its environments priced together); date and by do not apply. Needs jsonui-cli 2.3.15+ (plan: 2.3.20+).", {
         project_dir: z.string().optional().describe("Project directory with jui.config.json (overrides JUI_PROJECT_DIR env)"),
         scenario: z.string().optional().describe("Load scenario id (default: the first)"),
         date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("One day of the scenario's month (YYYY-MM-DD)"),
         by: z.enum(["provider", "node"]).optional().describe("Group the month's totals by provider (default) or node"),
-    }, async ({ project_dir, scenario, date, by }) => {
+        plan: z.string().optional().describe("A migration plan's name: the month's old / new / difference instead"),
+        account: z.boolean().optional().describe("With plan: the account's month too — its environments priced together, old / new / difference"),
+    }, async ({ project_dir, scenario, date, by, plan, account }) => {
         try {
+            if (!plan && account)
+                return failure(new Error("account applies with plan only"));
+            if (plan && (date || by))
+                return failure(new Error("date and by do not apply with plan: it answers by node and by provider at once, for the month"));
             const projectDir = config.resolveProjectDir(project_dir);
             const args = ["cost", "infra", projectDir, "--json"];
+            if (plan)
+                args.push("--migration", plan);
+            if (account)
+                args.push("--account");
             if (scenario)
                 args.push("--scenario", scenario);
             if (date)
@@ -90,6 +147,12 @@ export function register(server, config) {
             need(data, ["dir", "scenario", "scenarios", "problems", "prices"], "cost infra");
             need(data.problems, ["count", "errors", "first"], "cost infra problems");
             need(data.prices, ["warnings", "warningCount"], "cost infra prices");
+            if (plan) {
+                // the load problems and price warnings are the old model's reading, as without plan
+                return text({ ok: exitCode === 0, exit: exitCode, dir: data.dir, scenarios: data.scenarios,
+                    ...migrationSummary(data), loadProblems: data.problems, priceWarnings: data.prices.warnings,
+                    priceWarningCount: data.prices.warningCount });
+            }
             const out = {
                 ok: exitCode === 0,
                 exit: exitCode,

package/dist/tools/infra/infra_validate.d.ts

@@ -1,8 +1,3 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ServerConfig } from "../../config.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).
- */
 export declare function register(server: McpServer, config: ServerConfig): void;

package/dist/tools/infra/infra_validate.js

@@ -1,17 +1,53 @@
 import { z } from "zod";
-import { failure, need, problems, runDocJson, text } from "./infra_common.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) {
+    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) => {
+            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, plan) {
+    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, config) {
-    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. Needs jsonui-cli 2.3.15+.", {
+    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)"),
-    }, async ({ project_dir }) => {
+        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 { exitCode, data } = await runDocJson(["validate", "infra", projectDir, "--json"], projectDir);
+            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");
@@ -28,6 +64,7 @@ export function register(server, config) {
                 counts: data.counts ?? null,
                 flows: Array.isArray(data.flows) ? data.flows.length : null,
                 problems: problems(data.problems, "validate infra"),
+                ...migrations(data, plan),
             });
         }
         catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jui-tools-mcp-server",
-  "version": "2.17.0",
+  "version": "2.18.0",
   "description": "MCP server for JsonUI project management - wraps jui and jsonui-doc CLIs plus component spec lookup",
   "main": "dist/index.js",
   "scripts": {

package/scripts/record-infra-fixtures.sh

@@ -65,6 +65,71 @@ doc "${WORK}/room" cost infra --date 2026-11-03 --json > "${OUT}/cost-infra.day.
 doc "${WORK}/room" cost infra --scenario nope --json > "${OUT}/cost-infra.refused.json"
 doc "${WORK}/room" check infra --json 2>/dev/null > "${OUT}/check-infra.json"
 
+# Migration plans (jsonui-cli 2.3.20+), in a copy of their own so the room above stays a room without plans: one plan
+# that holds (replace db-prod, add worker-prod and its edge, remove api-stg with its edges, in a written order), and one
+# plan per migration.* code with exactly that error.
+plan() {  # plan <room> <name> <changes json> <removals json>
+  mkdir -p "$1/docs/infra/migrations/$2"
+  printf '%s' "$3" > "$1/docs/infra/migrations/$2/changes.json"
+  printf '%s' "$4" > "$1/docs/infra/migrations/$2/removals.json"
+}
+cp -R "${FIX}/aws-three-tier" "${WORK}/plans"
+DB='{"id": "db-prod", "category": "database.relational", "service": "rds.postgres", "group": "private-prod", "ha": "multi-az", "environments": ["production"], "spec": [{"key": "instance_class", "value": "db.r6g.large"}, {"key": "storage_gb", "value": "200"}]}'
+WORKER='{"id": "worker-prod", "category": "compute.container", "service": "ecs.fargate", "group": "private-prod", "count": 1, "environments": ["production"], "spec": [{"key": "cpu", "value": "512"}, {"key": "memory", "value": "1024"}, {"key": "tasks", "value": "1"}]}'
+NONE='{"version": 0, "nodes": [], "groups": [], "edges": []}'
+plan "${WORK}/plans" move "{\"version\": 0, \"order\": [\"db-prod\", \"worker-prod\", \"api-stg\"], \"nodes\": [${DB}, ${WORKER}], \"edges\": [{\"from\": \"api-prod\", \"to\": \"worker-prod\", \"protocol\": \"https\", \"port\": 443}]}" \
+  '{"version": 0, "nodes": ["api-stg"], "groups": [], "edges": []}'
+# the account's month needs a load in two environments: staging gets one here (only in this copy)
+python3 - "${WORK}/plans/docs/infra/load" <<'EOF'
+import json, sys
+d = json.load(open(f"{sys.argv[1]}/ordinary.json", encoding="utf-8"))
+d.update(id="staging", label="staging", environment="staging",
+         loads=[{"node": "alb-stg", "quantities": {"lcu": 1}}, {"node": "api-stg", "quantities": {"vcpu": 0.25, "memory_gb": 0.5}},
+                {"node": "db-stg", "sku": "db.t4g.medium", "quantities": {"storage_gb": 20}}], edges=[])
+json.dump(d, open(f"{sys.argv[1]}/staging.json", "w", encoding="utf-8"), ensure_ascii=False)
+EOF
+cp -R "${FIX}/aws-three-tier" "${WORK}/badplans"
+plan "${WORK}/badplans" remove-missing "{\"version\": 0, \"nodes\": [${WORKER}]}" '{"version": 0, "nodes": ["nope"], "groups": [], "edges": []}'
+plan "${WORK}/badplans" duplicate "{\"version\": 0, \"nodes\": [${WORKER}, ${WORKER}]}" "${NONE}"
+plan "${WORK}/badplans" both "{\"version\": 0, \"nodes\": [${DB}]}" '{"version": 0, "nodes": ["db-prod"], "groups": [], "edges": []}'
+plan "${WORK}/badplans" order-unknown "{\"version\": 0, \"order\": [\"ghost\"], \"nodes\": [${WORKER}]}" "${NONE}"
+plan "${WORK}/badplans" edge-end "{\"version\": 0, \"nodes\": [${WORKER}], \"edges\": [{\"from\": \"worker-prod\", \"to\": \"ghost\", \"protocol\": \"https\", \"port\": 443}]}" "${NONE}"
+doc "${WORK}/plans" validate infra --json > "${OUT}/validate-infra.plans.json"
+doc "${WORK}/plans" validate infra --migration move --json > "${OUT}/validate-infra.plan-move.json"
+doc "${WORK}/plans" validate infra --migration nope --json > "${OUT}/validate-infra.plan-none.json"
+for code in remove-missing duplicate both order-unknown edge-end; do
+  doc "${WORK}/badplans" validate infra --migration "${code}" --json > "${OUT}/validate-infra.plan-${code}.json"
+done
+doc "${WORK}/plans" cost infra --migration move --json > "${OUT}/cost-infra.plan-move.json"
+doc "${WORK}/plans" cost infra --migration move --account --scenario sale --json > "${OUT}/cost-infra.plan-move-account.json"
+doc "${WORK}/badplans" cost infra --migration both --json > "${OUT}/cost-infra.plan-bad.json"
+doc "${WORK}/plans" cost infra --migration nope --json > "${OUT}/cost-infra.plan-none.json"
+
+# A plan whose biggest change is a fall, and an unchanged node that moves with it: batch-prod (a node of this copy
+# only) comes after api-prod and shares the account's 100 GB internet egress with it (the free amount goes to the
+# first nodes); the plan shrinks the database and removes api-prod, so batch-prod takes more of the free amount.
+cp -R "${FIX}/aws-three-tier" "${WORK}/shrink"
+python3 - "${WORK}/shrink/docs/infra" <<'EOF'
+import json, sys
+infra = sys.argv[1]
+m = json.load(open(f"{infra}/main.json", encoding="utf-8"))
+m["nodes"].append({"id": "batch-prod", "category": "compute.container", "service": "ecs.fargate", "group": "private-prod", "count": 1,
+                   "environments": ["production"], "spec": [{"key": "cpu", "value": "256"}, {"key": "memory", "value": "512"}, {"key": "tasks", "value": "1"}]})
+json.dump(m, open(f"{infra}/main.json", "w", encoding="utf-8"), ensure_ascii=False)
+d = json.load(open(f"{infra}/load/ordinary.json", encoding="utf-8"))
+for row in d["loads"]:
+    if row.get("node") == "api-prod":
+        row["quantities"]["egress_gb"] = {"amount": 2.7, "per": "day"}
+d["loads"].append({"node": "batch-prod", "quantities": {"vcpu": 0.25, "memory_gb": 0.5, "egress_gb": {"amount": 2.7, "per": "day"}}})
+json.dump(d, open(f"{infra}/load/ordinary.json", "w", encoding="utf-8"), ensure_ascii=False)
+EOF
+SMALL='{"id": "db-prod", "category": "database.relational", "service": "rds.mysql", "group": "private-prod", "environments": ["production"], "spec": [{"key": "instance_class", "value": "db.t4g.medium"}, {"key": "storage_gb", "value": "200"}]}'
+plan "${WORK}/shrink" shrink "{\"version\": 0, \"nodes\": [${SMALL}]}" '{"version": 0, "nodes": ["api-prod"], "groups": [], "edges": []}'
+doc "${WORK}/shrink" cost infra --migration shrink --json > "${OUT}/cost-infra.plan-shrink.json"
+# a plan folder with nothing in it yet: listed, not ok, its read problem said (an empty migrations folder lists none)
+mkdir -p "${WORK}/badplans/docs/infra/migrations/half"
+doc "${WORK}/badplans" validate infra --migration half --json > "${OUT}/validate-infra.plan-half.json"
+
 # The temp folder's path is not part of the contract
 for f in "${OUT}"/*.json; do
   python3 - "$f" "${WORK}" <<'EOF'

package/src/tools/infra/infra_cost.ts

@@ -11,8 +11,51 @@ import { FIRST, failure, need, problems, runDocJson, text } from "./infra_common
  * hours over capacity, the notes, the load problems and the price-book warnings — and for a day, each top node's
  * charge by meter with the price layer it came from. Exit 0: simulated; 1: simulated, a load file has an error (left
  * out); 2: nothing simulated (reason).
+ *
+ * With `plan` (jsonui-cli 2.3.20+, `--migration <name>`): the same engine run on the old model and on the new one (old
+ * + changes − removals), and the difference — the totals, per node (what the plan added, replaced, removed or left),
+ * per provider, after each step of the plan, and with `account` the account's month (its environments priced
+ * together). Nothing is computed here.
+ * A plan with an error is not priced: the CLI refuses it (exit 2, reason bad_plan, the plan's problems), as it does a
+ * plan name with no folder (no_plan) — both answered by the refusal path below, problems counted.
  */
 
+function migrationSummary(data: any) {
+  need(data, ["migration", "scenario", "old", "new", "diff", "byNode", "byProvider", "steps", "account", "unpricedChanged"],
+    "cost infra --migration");
+  for (const k of ["old", "new", "diff"]) need(data[k], ["usd"], `cost infra --migration ${k}`);
+  for (const k of ["old", "new"]) need(data[k], ["noPrice", "noRule", "loadUndefined"], `cost infra --migration ${k}`);
+  for (const n of data.byNode) need(n, ["node", "change", "unpriced", "old", "new", "diff"], "cost infra --migration node");
+  for (const s of data.steps) {
+    need(s, ["index", "node", "usd", "diff", "moved"], "cost infra --migration step");
+    for (const m of s.moved) need(m, ["node", "diff"], "cost infra --migration step moved");
+  }
+  if (data.account !== null) need(data.account, ["on", "old", "new", "diff"], "cost infra --migration account");
+  const changed = data.byNode.filter((n: any) => n.change !== "same" || n.diff !== 0);
+  const byChange: Record<string, number> = {};
+  for (const n of data.byNode) byChange[n.change] = (byChange[n.change] ?? 0) + 1;
+  return {
+    migration: data.migration,
+    scenario: data.scenario,
+    usd: { old: data.old.usd, new: data.new.usd, diff: data.diff.usd },
+    // what either model cannot price (no price, no rule, no load): its part is 0 there, so not in the difference
+    oldUnpriced: { noPrice: data.old.noPrice, noRule: data.old.noRule, loadUndefined: data.old.loadUndefined },
+    newUnpriced: { noPrice: data.new.noPrice, noRule: data.new.noRule, loadUndefined: data.new.loadUndefined },
+    // the nodes the plan changes whose month is not all priced: the difference leaves their part out — not a saving
+    unpricedChanged: data.unpricedChanged,
+    nodes: byChange,
+    // the biggest movements first, whichever way
+    topChanges: [...changed].sort((a: any, b: any) => Math.abs(b.diff) - Math.abs(a.diff)).slice(0, FIRST),
+    changedCount: changed.length,
+    byProvider: data.byProvider,
+    // a step's diff is the whole month's change at that step, not its node's own: a neighbour can move with it (a
+    // shared free amount); moved names what moved, biggest first (a node, or "a>b" for a line's transfer)
+    steps: data.steps.map((s: any) => ({ index: s.index, node: s.node, usd: s.usd, diff: s.diff,
+      moved: s.moved.slice(0, FIRST), movedCount: s.moved.length })),
+    account: data.account,
+  };
+}
+
 function monthSummary(m: any) {
   need(m, ["scenario", "month", "usd", "by", "keys", "days", "noPrice", "noRule", "loadUndefined", "overflowHours",
     "warnings", "warningCount"], "cost infra month");
@@ -71,17 +114,23 @@ function daySummary(day: any) {
 export function register(server: McpServer, config: ServerConfig) {
   server.tool(
     "infra_cost",
-    "Simulate the server room's cost with `jsonui-doc cost infra --json` (the model, a load scenario under docs/infra/load, prices: the room's own, then fetched, then bundled — USD, on demand). Without date: the month's total, totals by provider (or by node), the top nodes, the dearest day, what has no price / no rule / no load, hours over capacity, notes. With date (YYYY-MM-DD in the scenario's month): that day's top nodes, each with its charge by meter, the price layer, and its peak hour. Also the scenarios there are, the load problems and the price-book warnings (prices.free_dropped: a room's price row dropping a bundled free amount). Needs jsonui-cli 2.3.15+.",
+    "Simulate the server room's cost with `jsonui-doc cost infra --json` (the model, a load scenario under docs/infra/load, prices: the room's own, then fetched, then bundled — USD, on demand). Without date: the month's total, totals by provider (or by node), the top nodes, the dearest day, what has no price / no rule / no load, hours over capacity, notes. With date (YYYY-MM-DD in the scenario's month): that day's top nodes, each with its charge by meter, the price layer, and its peak hour. Also the scenarios there are, the load problems and the price-book warnings (prices.free_dropped: a room's price row dropping a bundled free amount). With plan (a migration plan's name, docs/infra/migrations/<name>): the month's old, new and difference — per node (added / replaced / removed / same, the biggest changes first), per provider, after each step of the plan (a step's difference is the whole month's change at that step, not its node's own: moved names each node or line's transfer that moved), what is not priced in the old or the new (unpricedChanged: changed nodes whose part the difference leaves out — not a saving), and with account the account's month too (its environments priced together); date and by do not apply. Needs jsonui-cli 2.3.15+ (plan: 2.3.20+).",
     {
       project_dir: z.string().optional().describe("Project directory with jui.config.json (overrides JUI_PROJECT_DIR env)"),
       scenario: z.string().optional().describe("Load scenario id (default: the first)"),
       date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("One day of the scenario's month (YYYY-MM-DD)"),
       by: z.enum(["provider", "node"]).optional().describe("Group the month's totals by provider (default) or node"),
+      plan: z.string().optional().describe("A migration plan's name: the month's old / new / difference instead"),
+      account: z.boolean().optional().describe("With plan: the account's month too — its environments priced together, old / new / difference"),
     },
-    async ({ project_dir, scenario, date, by }) => {
+    async ({ project_dir, scenario, date, by, plan, account }) => {
       try {
+        if (!plan && account) return failure(new Error("account applies with plan only"));
+        if (plan && (date || by)) return failure(new Error("date and by do not apply with plan: it answers by node and by provider at once, for the month"));
         const projectDir = config.resolveProjectDir(project_dir);
         const args = ["cost", "infra", projectDir, "--json"];
+        if (plan) args.push("--migration", plan);
+        if (account) args.push("--account");
         if (scenario) args.push("--scenario", scenario);
         if (date) args.push("--date", date);
         if (by) args.push("--by", by);
@@ -95,6 +144,12 @@ export function register(server: McpServer, config: ServerConfig) {
         need(data, ["dir", "scenario", "scenarios", "problems", "prices"], "cost infra");
         need(data.problems, ["count", "errors", "first"], "cost infra problems");
         need(data.prices, ["warnings", "warningCount"], "cost infra prices");
+        if (plan) {
+          // the load problems and price warnings are the old model's reading, as without plan
+          return text({ ok: exitCode === 0, exit: exitCode, dir: data.dir, scenarios: data.scenarios,
+            ...migrationSummary(data), loadProblems: data.problems, priceWarnings: data.prices.warnings,
+            priceWarningCount: data.prices.warningCount });
+        }
         const out: Record<string, unknown> = {
           ok: exitCode === 0,
           exit: exitCode,

package/src/tools/infra/infra_validate.ts

@@ -1,24 +1,58 @@
 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";
+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. Needs jsonui-cli 2.3.15+.",
+    "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 }) => {
+    async ({ project_dir, plan }) => {
       try {
         const projectDir = config.resolveProjectDir(project_dir);
-        const { exitCode, data } = await runDocJson(["validate", "infra", projectDir, "--json"], projectDir);
+        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");
@@ -35,6 +69,7 @@ export function register(server: McpServer, config: ServerConfig) {
           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

@@ -1 +1 @@
-7479faaf infra arms: a load with warnings alone is cost infra's 0 (still counted), and a price dropped by two rows warns once
+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

@@ -11,16 +11,17 @@
         "mismatch": 0,
         "missing_in_impl": 0,
         "missing_in_doc": 0,
-        "skipped": 6,
-        "warning": 2,
+        "skipped": 4,
+        "warning": 4,
         "unit": "node"
       },
       "results": [
         {
           "target": "load/ordinary/stripe",
-          "status": "skipped",
+          "status": "warning",
           "confidence": "metadata",
-          "message": "its kind reads no load"
+          "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",
@@ -36,9 +37,10 @@
         },
         {
           "target": "load/sale/stripe",
-          "status": "skipped",
+          "status": "warning",
           "confidence": "metadata",
-          "message": "its kind reads no load"
+          "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",

package/tests/fixtures/infra/cost-infra.day.json

@@ -8834,8 +8834,8 @@
         "node": "stripe",
         "label": "Stripe",
         "provider": "stripe",
-        "rule": null,
-        "note": "no rule",
+        "rule": "generic/external.saas",
+        "note": "load undefined",
         "usd": 0.0,
         "hours": [
           {

package/tests/fixtures/infra/cost-infra.month-by-node.json

@@ -441,10 +441,10 @@
       }
     ],
     "noRule": [
-      "stripe",
       "api-role"
     ],
     "loadUndefined": [
+      "stripe",
       "mailer",
       "assets"
     ],
@@ -456,9 +456,17 @@
       {
         "fn": "price_meter",
         "message": "no price for cloudwatch.alarm alarm (month) in no region",
+        "detail": {
+          "keyword": "cost.no_price",
+          "service": "cloudwatch.alarm",
+          "sku": "alarm",
+          "unit": "month",
+          "region": ""
+        },
         "node": "api-5xx",
         "hour": "2026-11-01T00",
-        "meter": "alarm"
+        "meter": "alarm",
+        "short": "cloudwatch.alarm alarm（month）の価格が、（region 無し） にありません"
       }
     ],
     "warningCount": 1