jui-tools-mcp-server 2.15.11 → 2.17.0

package/dist/tools/viz/viz_common.d.ts

@@ -0,0 +1,13 @@
+import { CliResult } from "../../cli_runner.js";
+/**
+ * Shared by the viz_* tools (`jui viz`, the local viewer of Claude Code
+ * sessions). jui viz reads ~/.claude and ~/.jsonui-cli/viz, not a project, so
+ * every call runs in the home folder — never JUI_PROJECT_DIR.
+ */
+/** Said in every viz_* description: other agents' sessions (Codex, …) are not shown. */
+export declare const CLAUDE_CODE_ONLY = "jui viz shows Claude Code sessions only (Claude Code \u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3060\u3051\u3092\u898B\u305B\u308B).";
+export declare const UPDATE_JUI = "curl -fsSL https://raw.githubusercontent.com/Tai-Kimura/jsonui-cli/main/installer/bootstrap.sh | bash";
+export declare function outdatedJui(result: CliResult): string | undefined;
+export declare function runViz(args: string[], timeout?: number): Promise<CliResult>;
+/** The tool's text: the CLI's JSON (when it printed one) inside the usual envelope. */
+export declare function vizResult(result: CliResult): string;

package/dist/tools/viz/viz_common.js

@@ -0,0 +1,50 @@
+import { homedir } from "os";
+import { runCli } from "../../cli_runner.js";
+/**
+ * Shared by the viz_* tools (`jui viz`, the local viewer of Claude Code
+ * sessions). jui viz reads ~/.claude and ~/.jsonui-cli/viz, not a project, so
+ * every call runs in the home folder — never JUI_PROJECT_DIR.
+ */
+/** Said in every viz_* description: other agents' sessions (Codex, …) are not shown. */
+export const CLAUDE_CODE_ONLY = "jui viz shows Claude Code sessions only (Claude Code のセッションだけを見せる).";
+export const UPDATE_JUI = "curl -fsSL https://raw.githubusercontent.com/Tai-Kimura/jsonui-cli/main/installer/bootstrap.sh | bash";
+/**
+ * The installed jui predates what the tool asks for. Matched on argparse's
+ * own words, as printed by the jui versions that lack each piece (measured
+ * 2026-10-18: jui 1.9.37 has no `viz`; feature/jui-viz before `start` has
+ * neither `start` nor `status --with-relay`).
+ */
+const OUTDATED = [
+    { pattern: /invalid choice: 'viz'/, missing: "`jui viz`" },
+    { pattern: /invalid choice: 'start'/, missing: "`jui viz start`" },
+    { pattern: /unrecognized arguments: .*--with-relay/, missing: "`jui viz status --with-relay`" },
+];
+export function outdatedJui(result) {
+    const hit = OUTDATED.find((o) => o.pattern.test(result.stderr));
+    if (!hit)
+        return undefined;
+    return `The installed jui has no ${hit.missing}. Update jui, then call this tool again: ${UPDATE_JUI}`;
+}
+export async function runViz(args, timeout) {
+    return runCli("jui", ["viz", ...args], { cwd: homedir(), timeout });
+}
+/** The tool's text: the CLI's JSON (when it printed one) inside the usual envelope. */
+export function vizResult(result) {
+    let parsed = undefined;
+    try {
+        parsed = JSON.parse(result.stdout);
+    }
+    catch {
+        // not JSON (stop / open print a line)
+    }
+    const notInstalled = result.exitCode === "ENOENT";
+    return JSON.stringify({
+        success: result.exitCode === 0,
+        result: parsed,
+        output: parsed === undefined ? result.stdout || undefined : undefined,
+        errors: result.stderr || undefined,
+        update_jui: notInstalled
+            ? `jui is not installed (not found on PATH). Install it: ${UPDATE_JUI}`
+            : outdatedJui(result),
+    }, null, 2);
+}

package/dist/tools/viz/viz_doctor.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/dist/tools/viz/viz_doctor.js

@@ -0,0 +1,14 @@
+import { CLAUDE_CODE_ONLY, runViz, vizResult } from "./viz_common.js";
+export function register(server) {
+    server.tool("viz_doctor", "Check the environment for jui viz (the local viewer of Claude Code sessions): Python packages, the hooks and " +
+        "the Python they run, the port, the claude CLI. Each check has name, ok and detail. " +
+        CLAUDE_CODE_ONLY, {}, async () => {
+        try {
+            const result = await runViz(["doctor", "--json"], 30_000);
+            return { content: [{ type: "text", text: vizResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/viz/viz_open.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/dist/tools/viz/viz_open.js

@@ -0,0 +1,14 @@
+import { CLAUDE_CODE_ONLY, runViz, vizResult } from "./viz_common.js";
+export function register(server) {
+    server.tool("viz_open", "Open the running jui viz page (the local viewer of Claude Code sessions) in the user's browser. " +
+        "Fails when no server runs: call viz_start first. " +
+        CLAUDE_CODE_ONLY, {}, async () => {
+        try {
+            const result = await runViz(["open"], 30_000);
+            return { content: [{ type: "text", text: vizResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/viz/viz_start.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/dist/tools/viz/viz_start.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { CLAUDE_CODE_ONLY, runViz, vizResult } from "./viz_common.js";
+export function register(server) {
+    server.tool("viz_start", "Start the jui viz server (the local viewer of Claude Code sessions) in the background and return its URL " +
+        "on 127.0.0.1. A server already running is reported (alreadyRunning), not started again. Hooks and the " +
+        "relay are installed with the jui CLI, not here. " +
+        CLAUDE_CODE_ONLY, {
+        port: z.number().int().min(1).max(65535).optional().describe("Port on 127.0.0.1 (default: the viz config, 7788)"),
+    }, async (params) => {
+        try {
+            const args = ["start", "--json"];
+            if (params.port !== undefined) {
+                args.push("--port", String(params.port));
+            }
+            // jui waits up to 15 s for the server to answer.
+            const result = await runViz(args, 45_000);
+            return { content: [{ type: "text", text: vizResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/viz/viz_status.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/dist/tools/viz/viz_status.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { CLAUDE_CODE_ONLY, runViz, vizResult } from "./viz_common.js";
+export function register(server) {
+    server.tool("viz_status", "Report jui viz (the local viewer of Claude Code sessions): whether its server runs (pid, URL), the hooks in " +
+        "~/.claude/settings.json (installed of 18), and whether the permission relay is registered. " +
+        CLAUDE_CODE_ONLY, {
+        relay: z.boolean().optional().describe("Also ask claude whether the permission relay is registered (default true; runs `claude mcp get`, a few seconds)"),
+    }, async (params) => {
+        try {
+            const args = ["status", "--json"];
+            if (params.relay !== false) {
+                args.push("--with-relay");
+            }
+            const result = await runViz(args, 30_000);
+            return { content: [{ type: "text", text: vizResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/viz/viz_stop.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/dist/tools/viz/viz_stop.js

@@ -0,0 +1,13 @@
+import { CLAUDE_CODE_ONLY, runViz, vizResult } from "./viz_common.js";
+export function register(server) {
+    server.tool("viz_stop", "Stop the jui viz server (the local viewer of Claude Code sessions). Only the server jui recorded is stopped. " +
+        CLAUDE_CODE_ONLY, {}, async () => {
+        try {
+            const result = await runViz(["stop"], 30_000);
+            return { content: [{ type: "text", text: vizResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jui-tools-mcp-server",
-  "version": "2.15.11",
+  "version": "2.17.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

@@ -0,0 +1,78 @@
+#!/bin/bash
+# Record what the jsonui-doc infra commands print with --json, as the infra tools' test fixtures
+# (tests/fixtures/infra/*.json). The tools summarise those outputs, so the fixtures are the CLI's contract: when the
+# CLI's JSON changes, record again and the tools' tests say what no longer holds.
+#
+#   scripts/record-infra-fixtures.sh <jsonui-cli checkout>     # e.g. a worktree of integrate/2.3.15
+#
+# Rooms: jsonui-cli's own document_tools/tests/fixtures/infra (aws-three-tier: a model, two load scenarios, a price
+# file; compose-and-cloud: what seed reads), copied to a temp folder; one copy is broken on purpose (a load file that
+# is not JSON, a model file with a schema error) so the error shapes are recorded too. The fetched-price cache is kept
+# out (JUI_VIZ_HOME points nowhere), so the bundled table prices them.
+set -euo pipefail
+CLI_ROOT="$(cd "${1:?usage: $0 <jsonui-cli checkout>}" && pwd)"
+HERE="$(cd "$(dirname "$0")/.." && pwd)"
+OUT="${HERE}/tests/fixtures/infra"
+FIX="${CLI_ROOT}/document_tools/tests/fixtures/infra"
+WORK="$(mktemp -d)"
+trap 'rm -rf "${WORK}"' EXIT
+
+export PYTHONPATH="${CLI_ROOT}/document_tools:${CLI_ROOT}/jui_tools:${CLI_ROOT}/test_tools"
+export JUI_VIZ_HOME=/nonexistent
+doc() { (cd "$1" && shift && python3 -m jsonui_doc_cli.cli "$@") || true; }
+
+cp -R "${FIX}/aws-three-tier" "${WORK}/room"
+cp -R "${FIX}/aws-three-tier" "${WORK}/broken"
+printf '{' > "${WORK}/broken/docs/infra/load/broken.json"
+printf '{"version": 0, "nodes": [{"id": "x", "category": "nope"}]}' > "${WORK}/broken/docs/infra/bad.json"
+mkdir -p "${WORK}/seed/app"
+cat > "${WORK}/seed/docker-compose.yml" <<'EOF'
+services:
+  web:
+    image: example/web
+    depends_on: [db, cache]
+  db:
+    image: postgres:16
+  cache:
+    image: redis:7
+EOF
+cat > "${WORK}/seed/main.tf" <<'EOF'
+provider "aws" { region = "ap-northeast-1" }
+resource "aws_db_instance" "main" { engine = "postgres" }
+resource "aws_lb" "web" { load_balancer_type = "application" }
+resource "aws_s3_bucket" "assets" {}
+resource "aws_glue_job" "etl" {}
+EOF
+printf 'import boto3\nimport stripe\nQUEUE_URL = "SQS_QUEUE_URL"\n' > "${WORK}/seed/app/main.py"
+cat > "${WORK}/room/jui.config.json" <<'EOF'
+{"checks": [{"name": "infra-load", "type": "builtin:infra-load"}, {"name": "infra-code", "type": "builtin:infra-code"}]}
+EOF
+
+mkdir -p "${OUT}" "${WORK}/empty"
+doc "${WORK}/empty" validate infra --json > "${OUT}/validate-infra.unreadable.json"
+doc "${WORK}/empty" validate infra-load --json > "${OUT}/validate-infra-load.unreadable.json"
+doc "${WORK}/room" validate infra --json > "${OUT}/validate-infra.ok.json"
+doc "${WORK}/broken" validate infra --json > "${OUT}/validate-infra.errors.json"
+doc "${WORK}/room" validate infra-load --json > "${OUT}/validate-infra-load.ok.json"
+doc "${WORK}/broken" validate infra-load --json > "${OUT}/validate-infra-load.errors.json"
+doc "${WORK}/room" validate infra-prices --json > "${OUT}/validate-infra-prices.ok.json"
+doc "${WORK}/seed" seed infra -o "${WORK}/seed-out" > /dev/null
+cp "${WORK}/seed-out/draft.json" "${OUT}/seed-infra.draft.json"
+cp "${WORK}/seed-out/seed-report.json" "${OUT}/seed-infra.report.json"
+doc "${WORK}/room" cost infra --json > "${OUT}/cost-infra.month.json"
+doc "${WORK}/room" cost infra --by node --scenario sale --json > "${OUT}/cost-infra.month-by-node.json"
+doc "${WORK}/room" cost infra --date 2026-11-03 --json > "${OUT}/cost-infra.day.json"
+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"
+
+# The temp folder's path is not part of the contract
+for f in "${OUT}"/*.json; do
+  python3 - "$f" "${WORK}" <<'EOF'
+import sys
+p, work = sys.argv[1:]
+s = open(p, encoding="utf-8").read().replace(work, "<ROOT>")
+open(p, "w", encoding="utf-8").write(s)
+EOF
+done
+git -C "${CLI_ROOT}" log -1 --format='%h %s' > "${OUT}/RECORDED_FROM"
+ls -1 "${OUT}"

package/src/index.ts

@@ -53,6 +53,19 @@ import { register as registerDocGenerateHtml } from "./tools/doc/doc_generate_ht
 import { register as registerDocRulesInit } from "./tools/doc/doc_rules_init.js";
 import { register as registerDocRulesShow } from "./tools/doc/doc_rules_show.js";
 
+// --- Group G: jui viz (Claude Code sessions viewer) ---
+import { register as registerVizStatus } from "./tools/viz/viz_status.js";
+import { register as registerVizDoctor } from "./tools/viz/viz_doctor.js";
+import { register as registerVizStart } from "./tools/viz/viz_start.js";
+import { register as registerVizStop } from "./tools/viz/viz_stop.js";
+import { register as registerVizOpen } from "./tools/viz/viz_open.js";
+import { register as registerInfraValidate } from "./tools/infra/infra_validate.js";
+import { register as registerInfraLoadValidate } from "./tools/infra/infra_load_validate.js";
+import { register as registerInfraPricesValidate } from "./tools/infra/infra_prices_validate.js";
+import { register as registerInfraSeed } from "./tools/infra/infra_seed.js";
+import { register as registerInfraCheck } from "./tools/infra/infra_check.js";
+import { register as registerInfraCost } from "./tools/infra/infra_cost.js";
+
 // --- Group F: jsonui-test CLI ---
 import { register as registerTestValidate } from "./tools/test/test_validate.js";
 import { register as registerTestGenerateScreen } from "./tools/test/test_generate_screen.js";
@@ -144,7 +157,7 @@ registerListApiSpecs(server, config);
 registerListApiModels(server, config);
 registerPreviewApiModelSync(server, config);
 
-// Register Group F: jsonui-test CLI (8 tools)
+// Register Group F: jsonui-test CLI (10 tools)
 // mock serve is intentionally NOT exposed (long-running local HTTP server that
 // executes run-targets — kept to direct CLI use only). test_mock_generate
 // covers both scaffold (default) and drift-check (check=true) modes.
@@ -159,7 +172,25 @@ registerTestArtifactsPull(server, config);
 registerTestArtifactsStatus(server, config);
 registerTestContractsCoverage(server, config);
 
-log(`Registered 41 tools (7 spec + 6 context + 8 jui + 9 doc + 3 api + 8 test)`);
+// Register Group G: jui viz (5 tools). Hooks / relay install stay with the
+// jui CLI (they write ~/.claude/settings.json and the user's MCP config).
+registerVizStatus(server);
+registerVizDoctor(server);
+registerVizStart(server);
+registerVizStop(server);
+registerVizOpen(server);
+
+// Register Group H: the server room's infra (6 tools) — jsonui-doc's validate / seed / check / cost infra, each
+// summarised from its --json (jsonui-cli 2.3.15+). `jui viz cloud-prices fetch` stays with the CLI (it goes to the
+// network and writes the viz home).
+registerInfraValidate(server, config);
+registerInfraLoadValidate(server, config);
+registerInfraPricesValidate(server, config);
+registerInfraSeed(server, config);
+registerInfraCheck(server, config);
+registerInfraCost(server, config);
+
+log(`Registered 57 tools (9 spec + 7 context + 8 jui + 9 doc + 3 api + 10 test + 5 viz + 6 infra)`);
 
 async function main() {
   const transport = new StdioServerTransport();

package/src/tools/infra/infra_check.ts

@@ -0,0 +1,49 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ServerConfig } from "../../config.js";
+import { FIRST, failure, need, runDocJson, text } from "./infra_common.js";
+
+/**
+ * `jsonui-doc check infra -p <project> --json`: the declared infra checks (jui.config.json → checks:
+ * builtin:infra-iac, builtin:infra-code, builtin:infra-load) — the model against the IaC, the code, and the load
+ * definitions. This is the one jsonui-doc command that runs project-declared checks; the infra ones read files only.
+ * Exit 0: clean (warnings alone are 0); 1: a mismatch (a finding of a check declared with gate: true); 2: an
+ * execution error, or no infra check is declared.
+ */
+export function register(server: McpServer, config: ServerConfig) {
+  server.tool(
+    "infra_check",
+    "Run the project's declared infra checks with `jsonui-doc check infra --json` (jui.config.json → checks: builtin:infra-iac = the model against Terraform/Compose/CloudFormation/k8s/wrangler, builtin:infra-code = against the code's evidence, SDK imports and env names, builtin:infra-load = against the load definitions). Returns each check's status (ok / mismatch / error), counts, the first 20 results that are not ok (target, status, expected, actual, message), warnings, and its report file. Findings are warnings unless the check sets gate: true. 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, stderr } = await runDocJson(["check", "infra", "-p", projectDir, "--json"], projectDir, 180_000);
+        need(data, ["ok", "exit", "checks"], "check infra");
+        if (!data.checks.length) {
+          return text({ ok: false, exit: exitCode, checks: [],
+            message: stderr.trim() || "no builtin:infra-* check is declared in jui.config.json → checks",
+            declared: data.declared ?? [] });
+        }
+        return text({
+          ok: data.ok,
+          exit: exitCode,
+          checks: data.checks.map((c: any) => {
+            need(c, ["name", "type", "status"], "check infra check");
+            if (c.status === "error") return { name: c.name, type: c.type, status: "error", error: c.error };
+            need(c, ["summary", "results", "warnings", "report"], "check infra check");
+            return {
+              name: c.name, type: c.type, status: c.status, summary: c.summary,
+              results: c.results.slice(0, FIRST), resultCount: c.results.length,
+              warnings: c.warnings.slice(0, FIRST), report: c.report,
+            };
+          }),
+        });
+      } catch (e: any) {
+        return failure(e);
+      }
+    }
+  );
+}

package/src/tools/infra/infra_common.ts

@@ -0,0 +1,69 @@
+import { runCli } from "../../cli_runner.js";
+
+/**
+ * Shared by the Group H tools: run a `jsonui-doc … --json` infra command and read its one JSON object.
+ *
+ * The tools summarise that object for an agent (counts, the first problems, the totals), so the keys they read are
+ * the CLI's contract. `need` names a key the object lacks instead of summarising nothing — a jsonui-doc older or
+ * newer than these tools says so rather than reading as an empty room. The tests feed the CLI's own recorded output
+ * (tests/fixtures/infra, scripts/record-infra-fixtures.sh).
+ */
+
+export interface JsonRun {
+  exitCode: number;
+  data: any;
+  stderr: string;
+}
+
+export class ContractError extends Error {}
+
+export const FIRST = 20;
+
+export async function runDocJson(args: string[], cwd: string, timeout?: number): Promise<JsonRun> {
+  const result = await runCli("jsonui-doc", args, { cwd, timeout });
+  let data: any;
+  try {
+    data = JSON.parse(result.stdout);
+  } catch {
+    throw new ContractError(
+      `jsonui-doc ${args.slice(0, 2).join(" ")} printed no JSON (exit ${result.exitCode})` +
+        (result.stderr ? `: ${result.stderr.trim().split("\n").slice(-3).join(" / ")}` : "") +
+        " — it needs jsonui-cli 2.3.15 or later for --json here"
+    );
+  }
+  return { exitCode: result.exitCode, data, stderr: result.stderr };
+}
+
+export function need(obj: any, keys: string[], what: string): void {
+  const missing = keys.filter((k) => obj == null || !(k in obj));
+  if (missing.length) {
+    throw new ContractError(
+      `${what}: the JSON has no ${missing.map((k) => `"${k}"`).join(", ")} — a jsonui-doc these tools do not know; ` +
+        "update jsonui-cli or this server"
+    );
+  }
+}
+
+/** A problem list as counts (by severity, by code) and the first FIRST, each as written. */
+export function problems(list: any[], what: string, keep: string[] = ["severity", "code", "file", "path", "message"]) {
+  if (!Array.isArray(list)) throw new ContractError(`${what}: "problems" is not a list`);
+  const bySeverity: Record<string, number> = {};
+  const byCode: Record<string, number> = {};
+  for (const p of list) {
+    need(p, ["severity", "code"], `${what} problem`);
+    bySeverity[p.severity] = (bySeverity[p.severity] ?? 0) + 1;
+    byCode[p.code] = (byCode[p.code] ?? 0) + 1;
+  }
+  const first = list.slice(0, FIRST).map((p) =>
+    Object.fromEntries(keep.filter((k) => p[k] !== undefined && p[k] !== null).map((k) => [k, p[k]]))
+  );
+  return { count: list.length, errors: bySeverity.error ?? 0, warnings: bySeverity.warning ?? 0, byCode, first };
+}
+
+export function text(value: unknown) {
+  return { content: [{ type: "text" as const, text: JSON.stringify(value, null, 2) }] };
+}
+
+export function failure(e: any) {
+  return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+}

package/src/tools/infra/infra_cost.ts

@@ -0,0 +1,122 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ServerConfig } from "../../config.js";
+import { FIRST, failure, need, problems, runDocJson, text } from "./infra_common.js";
+
+/**
+ * `jsonui-doc cost infra <project> --json`: the cost simulator's month (or one day) for a load scenario, the same
+ * simulation and shapes as jui viz's コスト. The month's whole reply (every day's stack) and above all a day's (every
+ * node's 24 hours with each meter's price trace, ~300 KB) are too long for an agent; this keeps what answers "what
+ * does it cost and why": the total, the totals per stack key, the top nodes, what has no price / rule / load, the
+ * 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).
+ */
+
+function monthSummary(m: any) {
+  need(m, ["scenario", "month", "usd", "by", "keys", "days", "noPrice", "noRule", "loadUndefined", "overflowHours",
+    "warnings", "warningCount"], "cost infra month");
+  const totals: Record<string, number> = {};
+  for (const d of m.days) {
+    need(d, ["date", "usd", "stack"], "cost infra day of the month");
+    for (const [k, v] of Object.entries(d.stack)) totals[k] = (totals[k] ?? 0) + (v as number);
+  }
+  const label = Object.fromEntries(m.keys.map((k: any) => [k.key, k.label]));
+  return {
+    scenario: m.scenario,
+    month: m.month,
+    usd: m.usd,
+    by: m.by,
+    totals: Object.entries(totals).sort((a, b) => b[1] - a[1])
+      .map(([key, usd]) => ({ key: key === "__others__" ? "others" : key, label: label[key] ?? key, usd })),
+    days: m.days.length,
+    dearestDay: m.days.reduce((a: any, b: any) => (b.usd > a.usd ? b : a), m.days[0])?.date ?? null,
+    noPrice: m.noPrice,
+    noRule: m.noRule,
+    loadUndefined: m.loadUndefined,
+    overflowHours: m.overflowHours,
+    notes: m.warnings.slice(0, FIRST).map((w: any) => (typeof w === "string" ? w : w.message)),
+    noteCount: m.warningCount,
+  };
+}
+
+function daySummary(day: any) {
+  need(day, ["scenario", "date", "usd", "nodes", "others"], "cost infra day");
+  return {
+    scenario: day.scenario,
+    date: day.date,
+    usd: day.usd,
+    nodes: day.nodes.map((n: any) => {
+      need(n, ["node", "usd", "hours"], "cost infra day node");
+      const meters: Record<string, { usd: number; amount: number; unit: string; sku: string; layer: string | null }> = {};
+      let peak = { hour: 0, usd: -1 };
+      n.hours.forEach((h: any, i: number) => {
+        if (h.usd > peak.usd) peak = { hour: day.hours?.[i] ?? i, usd: h.usd };
+        for (const s of h.segments ?? []) {
+          const m = (meters[s.meter] ??= { usd: 0, amount: 0, unit: s.unit, sku: s.sku, layer: s.price?.layer ?? null });
+          m.usd += s.usd ?? 0;
+          m.amount += s.amount ?? 0;
+        }
+      });
+      const overflowHours = n.hours.filter((h: any) => h.load && h.load.overflow > 0).length;
+      return {
+        node: n.node, label: n.label, provider: n.provider, rule: n.rule, note: n.note || undefined, usd: n.usd,
+        peakHour: peak.usd >= 0 ? peak.hour : null, meters, overflowHours: overflowHours || undefined,
+      };
+    }),
+    others: { count: day.others.count, usd: (day.others.usd as number[]).reduce((a, b) => a + b, 0) },
+  };
+}
+
+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+.",
+    {
+      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 }) => {
+      try {
+        const projectDir = config.resolveProjectDir(project_dir);
+        const args = ["cost", "infra", projectDir, "--json"];
+        if (scenario) args.push("--scenario", scenario);
+        if (date) args.push("--date", date);
+        if (by) args.push("--by", by);
+        const { exitCode, data } = await runDocJson(args, projectDir, 180_000);
+        need(data, ["ok"], "cost infra");
+        if (!data.ok) {
+          need(data, ["reason", "message"], "cost infra");
+          return text({ ok: false, exit: exitCode, reason: data.reason, message: data.message,
+            ...(data.problems ? { problems: problems(data.problems, "cost infra") } : {}) });
+        }
+        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");
+        const out: Record<string, unknown> = {
+          ok: exitCode === 0,
+          exit: exitCode,
+          dir: data.dir,
+          scenario: data.scenario,
+          scenarios: data.scenarios,
+          loadProblems: data.problems,
+          priceWarnings: data.prices.warnings,
+          priceWarningCount: data.prices.warningCount,
+        };
+        if (date) {
+          need(data, ["day"], "cost infra");
+          out.day = daySummary(data.day);
+        } else {
+          need(data, ["month", "topNodes"], "cost infra");
+          out.month = monthSummary(data.month);
+          out.topNodes = data.topNodes;
+        }
+        return text(out);
+      } catch (e: any) {
+        return failure(e);
+      }
+    }
+  );
+}

package/src/tools/infra/infra_load_validate.ts

@@ -0,0 +1,46 @@
+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-load <project> --json`: the load scenarios the cost simulator reads (<infra.dir>/load,
+ * or infra.load_dir) against their schema and against the model. Exit 0: no error; 1: errors; 2: the model or the
+ * folder cannot be read (reason).
+ */
+export function register(server: McpServer, config: ServerConfig) {
+  server.tool(
+    "infra_load_validate",
+    "Validate the server room's load scenarios (docs/infra/load/*.json) with `jsonui-doc validate infra-load --json`. Returns each scenario (id, environment, month, hours, loads, edges) and the problems by severity and code with the first 20 (file, path, code, message, node, hour, quantity). load.overlap means a node has two rows and only one counts. 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-load", projectDir, "--json"], projectDir);
+        need(data, ["ok"], "validate infra-load");
+        if (!data.ok) {
+          need(data, ["reason", "message"], "validate infra-load");
+          return text({ ok: false, exit: exitCode, readable: false, reason: data.reason, message: data.message });
+        }
+        need(data, ["dir", "files", "problems", "scenarios"], "validate infra-load");
+        for (const s of data.scenarios) need(s, ["id", "environment", "month", "hours", "loads", "edges"], "validate infra-load scenario");
+        return text({
+          ok: exitCode === 0,
+          exit: exitCode,
+          readable: true,
+          dir: data.dir,
+          files: data.files,
+          scenarios: data.scenarios.map((s: any) => ({
+            id: s.id, file: s.file, environment: s.environment, month: s.month, hours: s.hours, loads: s.loads, edges: s.edges,
+          })),
+          problems: problems(data.problems, "validate infra-load",
+            ["severity", "code", "file", "path", "message", "node", "hour", "quantity"]),
+        });
+      } catch (e: any) {
+        return failure(e);
+      }
+    }
+  );
+}