jui-tools-mcp-server 2.5.0

package/dist/tools/api/preview_api_model_sync.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { runCli } from "../../cli_runner.js";
+/**
+ * Discovery wrapper around `jui g api --dry-run --json`.
+ *
+ * Returns the schema filter result + the file list that *would* be written
+ * for each platform, without touching disk. Agents call this after a
+ * filter config change to confirm which schemas survive before running
+ * `jui build` (which would actually emit + orphan-prune).
+ */
+export function register(server, config) {
+    server.tool("preview_api_model_sync", "Preview swagger → DTO + Domain generation without writing files. Returns kept_schemas / filtered_out / skip_domain_matches and the per-platform file list that would be emitted.", {
+        platform: z.enum(["ios", "android", "web"]).optional()
+            .describe("Restrict to a single platform"),
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async ({ platform, project_dir }) => {
+        try {
+            const projectDir = config.resolveProjectDir(project_dir);
+            const args = ["g", "api", "--dry-run", "--json"];
+            if (platform) {
+                args.push("--platform", platform);
+            }
+            const result = await runCli("jui", args, { cwd: projectDir });
+            // Non-zero exit may indicate a swagger halt (oneOf, multi-file ref,
+            // etc.). The CLI still emits structured JSON on the error path, so
+            // pass stdout through when present.
+            const body = result.stdout.trim() || result.stderr.trim();
+            return { content: [{ type: "text", text: body || "preview returned no output" }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/context/get_project_config.d.ts

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

package/dist/tools/context/get_project_config.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export function register(server, config) {
+    server.tool("get_project_config", "Read jui.config.json and return project configuration (platforms, directories, project name)", {
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async ({ project_dir }) => {
+        try {
+            const projectDir = config.resolveProjectDir(project_dir);
+            const projectConfig = config.readProjectConfig(projectDir);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({ project_dir: projectDir, config: projectConfig }, null, 2),
+                    }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/context/list_component_specs.d.ts

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

package/dist/tools/context/list_component_specs.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { join } from "path";
+export function register(server, config) {
+    server.tool("list_component_specs", "List all component spec files (*.component.json) with metadata", {
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async ({ project_dir }) => {
+        try {
+            const projectDir = config.resolveProjectDir(project_dir);
+            const projectConfig = config.readProjectConfig(projectDir);
+            const compDir = config.resolveDir(projectConfig, "component_spec_directory", projectDir);
+            if (!existsSync(compDir)) {
+                return { content: [{ type: "text", text: `Component spec directory not found: ${compDir}` }] };
+            }
+            const files = readdirSync(compDir).filter((f) => f.endsWith(".component.json"));
+            const specs = files.map((file) => {
+                try {
+                    const data = JSON.parse(readFileSync(join(compDir, file), "utf-8"));
+                    return {
+                        file,
+                        name: data.metadata?.name || file.replace(".component.json", ""),
+                        category: data.metadata?.category || "",
+                    };
+                }
+                catch {
+                    return { file, name: file.replace(".component.json", ""), category: "unknown" };
+                }
+            });
+            return { content: [{ type: "text", text: JSON.stringify(specs, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/context/list_layouts.d.ts

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

package/dist/tools/context/list_layouts.js

@@ -0,0 +1,118 @@
+import { z } from "zod";
+import { readdirSync, existsSync } from "fs";
+import { join } from "path";
+import { runCli } from "../../cli_runner.js";
+/**
+ * Screen classification for the listed layouts, obtained from `jui screens
+ * --json` rather than reimplemented here.
+ *
+ * Classification depends on how OTHER layouts reference this one, and the
+ * rules live in shared/core/screen_identity.json with one Python reader and
+ * one Ruby reader already held to each other by a cross-language test. A
+ * third reader in TypeScript would be a third thing to keep in sync, so this
+ * asks the CLI. When the CLI is unavailable or predates `jui screens`, the
+ * listing simply comes back without classification instead of guessing.
+ */
+async function classifyScreens(projectDir) {
+    const result = await runCli("jui", ["screens", "--json"], { cwd: projectDir, timeout: 30_000 });
+    if (!result.stdout.trim())
+        return null;
+    try {
+        const payload = JSON.parse(result.stdout);
+        const byId = new Map();
+        for (const entry of payload.entries ?? []) {
+            byId.set(entry.screen, {
+                role: entry.role,
+                reason: entry.reason,
+                marker: entry.marker ?? null,
+            });
+        }
+        return byId;
+    }
+    catch {
+        return null;
+    }
+}
+export function register(server, config) {
+    server.tool("list_layouts", "List all Layout JSON files in the shared layouts directory", {
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async ({ project_dir }) => {
+        try {
+            const projectDir = config.resolveProjectDir(project_dir);
+            const projectConfig = config.readProjectConfig(projectDir);
+            const layoutsDir = config.resolveDir(projectConfig, "layouts_directory", projectDir);
+            if (!existsSync(layoutsDir)) {
+                return { content: [{ type: "text", text: `Layouts directory not found: ${layoutsDir}` }] };
+            }
+            const collectJsonFiles = (dir, prefix = "") => {
+                const entries = readdirSync(dir, { withFileTypes: true });
+                const files = [];
+                for (const entry of entries) {
+                    const relPath = prefix ? `${prefix}/${entry.name}` : entry.name;
+                    if (entry.isDirectory()) {
+                        files.push(...collectJsonFiles(join(dir, entry.name), relPath));
+                    }
+                    else if (entry.name.endsWith(".json")) {
+                        files.push(relPath);
+                    }
+                }
+                return files;
+            };
+            const files = collectJsonFiles(layoutsDir);
+            // Responsive variant files (home@regular.json) are attached to
+            // their base screen instead of listed as standalone layouts —
+            // they replace the base's whole tree per size-class tier and
+            // never have their own spec/VM/Data.
+            const isVariant = (relPath) => {
+                const basename = relPath.split("/").pop() ?? relPath;
+                return basename.includes("@");
+            };
+            const baseOf = (relPath) => {
+                const idx = relPath.lastIndexOf("@");
+                return idx > 0 ? `${relPath.slice(0, idx)}.json` : relPath;
+            };
+            const bases = files.filter((f) => !isVariant(f));
+            const variantsByBase = new Map();
+            for (const f of files) {
+                if (!isVariant(f))
+                    continue;
+                const base = baseOf(f.replace(/\.json$/, ""));
+                const list = variantsByBase.get(base) ?? [];
+                list.push(f);
+                variantsByBase.set(base, list);
+            }
+            // Screen id = layout basename (variant-normalized); the role tells
+            // callers which layouts may legitimately appear as a test's `screen`
+            // and which are cells/partials that render inside a host.
+            const classification = await classifyScreens(projectDir);
+            const screenIdOf = (relPath) => {
+                const basename = relPath.split("/").pop() ?? relPath;
+                return basename.replace(/\.json$/, "").split("@")[0];
+            };
+            const listing = bases.map((f) => {
+                const variants = variantsByBase.get(f);
+                const info = classification?.get(screenIdOf(f));
+                if (!info && !variants)
+                    return f;
+                return {
+                    layout: f,
+                    ...(variants ? { variants: variants.sort() } : {}),
+                    ...(info
+                        ? { screen: screenIdOf(f), role: info.role, roleReason: info.reason }
+                        : {}),
+                };
+            });
+            // Orphan variants (base missing) still surface — flagged so the
+            // caller can report them instead of silently dropping files.
+            for (const [base, variants] of variantsByBase) {
+                if (!bases.includes(base)) {
+                    listing.push({ layout: base, missingBase: true, variants: variants.sort() });
+                }
+            }
+            return { content: [{ type: "text", text: JSON.stringify(listing, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/context/list_screen_specs.d.ts

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

package/dist/tools/context/list_screen_specs.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { readFileSync, readdirSync, existsSync } from "fs";
+import { join } from "path";
+export function register(server, config) {
+    server.tool("list_screen_specs", "List all screen spec files (*.spec.json) with metadata (name, displayName, type)", {
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async ({ project_dir }) => {
+        try {
+            const projectDir = config.resolveProjectDir(project_dir);
+            const projectConfig = config.readProjectConfig(projectDir);
+            const specDir = config.resolveDir(projectConfig, "spec_directory", projectDir);
+            if (!existsSync(specDir)) {
+                return { content: [{ type: "text", text: `Spec directory not found: ${specDir}` }] };
+            }
+            const files = readdirSync(specDir).filter((f) => f.endsWith(".spec.json"));
+            const specs = files.map((file) => {
+                try {
+                    const data = JSON.parse(readFileSync(join(specDir, file), "utf-8"));
+                    return {
+                        file,
+                        name: data.metadata?.name || file.replace(".spec.json", ""),
+                        displayName: data.metadata?.displayName || "",
+                        type: data.type || "screen_spec",
+                        layoutFile: data.metadata?.layoutFile || null,
+                    };
+                }
+                catch {
+                    return { file, name: file.replace(".spec.json", ""), displayName: "", type: "unknown", layoutFile: null };
+                }
+            });
+            return { content: [{ type: "text", text: JSON.stringify(specs, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/context/read_layout_file.d.ts

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

package/dist/tools/context/read_layout_file.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+export function register(server, config) {
+    server.tool("read_layout_file", "Read the contents of a Layout JSON file from the shared layouts directory", {
+        file: z.string().describe("Filename (e.g., 'Login.json' or 'Styles/Common.json')"),
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async ({ file, project_dir }) => {
+        try {
+            const projectDir = config.resolveProjectDir(project_dir);
+            const projectConfig = config.readProjectConfig(projectDir);
+            const layoutsDir = config.resolveDir(projectConfig, "layouts_directory", projectDir);
+            const filePath = join(layoutsDir, file);
+            config.validatePathInProject(filePath, projectDir);
+            if (!existsSync(filePath)) {
+                return { content: [{ type: "text", text: `File not found: ${filePath}` }] };
+            }
+            const content = readFileSync(filePath, "utf-8");
+            return { content: [{ type: "text", text: content }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/context/read_spec_file.d.ts

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

package/dist/tools/context/read_spec_file.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+export function register(server, config) {
+    server.tool("read_spec_file", "Read the contents of a screen or component spec file", {
+        file: z.string().describe("Filename (e.g., 'login.spec.json' or 'my_card.component.json')"),
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async ({ file, project_dir }) => {
+        try {
+            const projectDir = config.resolveProjectDir(project_dir);
+            const projectConfig = config.readProjectConfig(projectDir);
+            const isComponent = file.endsWith(".component.json");
+            const dirField = isComponent ? "component_spec_directory" : "spec_directory";
+            const baseDir = config.resolveDir(projectConfig, dirField, projectDir);
+            const filePath = join(baseDir, file);
+            config.validatePathInProject(filePath, projectDir);
+            if (!existsSync(filePath)) {
+                return { content: [{ type: "text", text: `File not found: ${filePath}` }] };
+            }
+            const content = readFileSync(filePath, "utf-8");
+            return { content: [{ type: "text", text: content }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/doc/doc_generate_component.d.ts

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

package/dist/tools/doc/doc_generate_component.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { join } from "path";
+import { runCli, formatResult } from "../../cli_runner.js";
+export function register(server, config) {
+    server.tool("doc_generate_component", "Generate HTML or Markdown documentation from a component spec file (or batch from a directory)", {
+        file: z.string().describe("Component spec file or directory path"),
+        output: z.string().optional().describe("Output file or directory path"),
+        format: z.enum(["html", "markdown"]).optional().describe("Output format (default: html)"),
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async (params) => {
+        try {
+            const projectDir = config.resolveProjectDir(params.project_dir);
+            let filePath = params.file;
+            if (!filePath.startsWith("/") && !filePath.includes("/")) {
+                try {
+                    const projectConfig = config.readProjectConfig(projectDir);
+                    const compDir = config.resolveDir(projectConfig, "component_spec_directory", projectDir);
+                    filePath = join(compDir, filePath);
+                }
+                catch {
+                    filePath = join(projectDir, filePath);
+                }
+            }
+            const args = ["generate", "component", filePath];
+            if (params.output) {
+                args.push("-o", params.output);
+            }
+            if (params.format) {
+                args.push("--format", params.format);
+            }
+            const result = await runCli("jsonui-doc", args, { cwd: projectDir });
+            return { content: [{ type: "text", text: formatResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/doc/doc_generate_html.d.ts

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

package/dist/tools/doc/doc_generate_html.js

@@ -0,0 +1,46 @@
+import { z } from "zod";
+import { runCli, formatResult } from "../../cli_runner.js";
+export function register(server, config) {
+    server.tool("doc_generate_html", "Generate HTML documentation site with index from a directory of test files. Supports multi-app sites (apps) and extra markdown doc directories (docs_dirs), same as the jsonui-doc CLI", {
+        input_dir: z.string().describe("Directory containing .test.json files"),
+        output_dir: z.string().optional().describe("Output directory for HTML files"),
+        title: z.string().optional().describe("Documentation title"),
+        apps: z.array(z.string()).optional().describe("App sections as NAME:DIR entries (repeatable --app); for multi-app whole-site generation"),
+        docs_dirs: z.array(z.string()).optional().describe("Additional markdown doc directories (repeatable -d/--docs)"),
+        figma_dir: z.string().optional().describe("Figma assets directory (-fig)"),
+        layouts_dir: z.string().optional().describe("Layouts directory override (--layouts-dir)"),
+        with_checks: z.boolean().optional().describe("Run doc contract checks during generation (--with-checks)"),
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async (params) => {
+        try {
+            const projectDir = config.resolveProjectDir(params.project_dir);
+            const args = ["generate", "html", params.input_dir];
+            if (params.output_dir) {
+                args.push("-o", params.output_dir);
+            }
+            if (params.title) {
+                args.push("-t", params.title);
+            }
+            for (const app of params.apps ?? []) {
+                args.push("--app", app);
+            }
+            for (const dir of params.docs_dirs ?? []) {
+                args.push("-d", dir);
+            }
+            if (params.figma_dir) {
+                args.push("-fig", params.figma_dir);
+            }
+            if (params.layouts_dir) {
+                args.push("--layouts-dir", params.layouts_dir);
+            }
+            if (params.with_checks) {
+                args.push("--with-checks");
+            }
+            const result = await runCli("jsonui-doc", args, { cwd: projectDir });
+            return { content: [{ type: "text", text: formatResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/doc/doc_generate_spec.d.ts

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

package/dist/tools/doc/doc_generate_spec.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { join } from "path";
+import { runCli, formatResult } from "../../cli_runner.js";
+export function register(server, config) {
+    server.tool("doc_generate_spec", "Generate HTML or Markdown documentation from a screen spec file (or batch from a directory)", {
+        file: z.string().describe("Spec file or directory path (e.g., 'login.spec.json' or 'docs/screens/json')"),
+        output: z.string().optional().describe("Output file or directory path"),
+        format: z.enum(["html", "markdown"]).optional().describe("Output format (default: html)"),
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async (params) => {
+        try {
+            const projectDir = config.resolveProjectDir(params.project_dir);
+            let filePath = params.file;
+            if (!filePath.startsWith("/") && !filePath.includes("/")) {
+                try {
+                    const projectConfig = config.readProjectConfig(projectDir);
+                    const specDir = config.resolveDir(projectConfig, "spec_directory", projectDir);
+                    filePath = join(specDir, filePath);
+                }
+                catch {
+                    filePath = join(projectDir, filePath);
+                }
+            }
+            const args = ["generate", "spec", filePath];
+            if (params.output) {
+                args.push("-o", params.output);
+            }
+            if (params.format) {
+                args.push("--format", params.format);
+            }
+            const result = await runCli("jsonui-doc", args, { cwd: projectDir });
+            return { content: [{ type: "text", text: formatResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/doc/doc_init_component.d.ts

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

package/dist/tools/doc/doc_init_component.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { runCli, formatResult } from "../../cli_runner.js";
+export function register(server, config) {
+    server.tool("doc_init_component", "Create a new component specification template file (.component.json)", {
+        name: z.string().describe("Component name in PascalCase (e.g., 'CustomCard')"),
+        display_name: z.string().optional().describe("Display name for the component"),
+        category: z.enum(["card", "form", "list", "navigation", "input", "display", "layout", "feedback", "other"]).optional().describe("Component category"),
+        output_dir: z.string().optional().describe("Output directory"),
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async (params) => {
+        try {
+            const projectDir = config.resolveProjectDir(params.project_dir);
+            const args = ["init", "component", params.name];
+            if (params.display_name) {
+                args.push("-d", params.display_name);
+            }
+            if (params.category) {
+                args.push("-c", params.category);
+            }
+            if (params.output_dir) {
+                args.push("-o", params.output_dir);
+            }
+            const result = await runCli("jsonui-doc", args, { cwd: projectDir });
+            return { content: [{ type: "text", text: formatResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/doc/doc_init_spec.d.ts

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

package/dist/tools/doc/doc_init_spec.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { runCli, formatResult } from "../../cli_runner.js";
+export function register(server, config) {
+    server.tool("doc_init_spec", "Create a new screen specification template file (.spec.json)", {
+        name: z.string().describe("Screen name in PascalCase (e.g., 'LoginScreen')"),
+        display_name: z.string().optional().describe("Display name for the screen"),
+        output_dir: z.string().optional().describe("Output directory (defaults to spec_directory in config)"),
+        file_path: z.string().optional().describe("Explicit relative file path under output_dir " +
+            "(e.g., 'learn/hello-world.spec.json'). When omitted, the file name " +
+            "is derived from the PascalCase name via kebab-case " +
+            "(LearnHelloWorld -> learn-hello-world.spec.json)."),
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async (params) => {
+        try {
+            const projectDir = config.resolveProjectDir(params.project_dir);
+            const args = ["init", "spec", params.name];
+            if (params.display_name) {
+                args.push("-d", params.display_name);
+            }
+            if (params.output_dir) {
+                args.push("-o", params.output_dir);
+            }
+            if (params.file_path) {
+                args.push("-f", params.file_path);
+            }
+            const result = await runCli("jsonui-doc", args, { cwd: projectDir });
+            return { content: [{ type: "text", text: formatResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/doc/doc_rules_init.d.ts

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

package/dist/tools/doc/doc_rules_init.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { runCli, formatResult } from "../../cli_runner.js";
+export function register(server, config) {
+    server.tool("doc_rules_init", "Create a template .jsonui-doc-rules.json configuration file for custom validation rules", {
+        flutter: z.boolean().optional().describe("Include Flutter-specific rules"),
+        output_dir: z.string().optional().describe("Output directory for rules file"),
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async (params) => {
+        try {
+            const projectDir = config.resolveProjectDir(params.project_dir);
+            const args = ["rules", "init"];
+            if (params.flutter) {
+                args.push("--flutter");
+            }
+            if (params.output_dir) {
+                args.push("-o", params.output_dir);
+            }
+            const result = await runCli("jsonui-doc", args, { cwd: projectDir });
+            return { content: [{ type: "text", text: formatResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/doc/doc_rules_show.d.ts

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

package/dist/tools/doc/doc_rules_show.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { runCli, formatResult } from "../../cli_runner.js";
+export function register(server, config) {
+    server.tool("doc_rules_show", "Show current effective validation rules (base rules + custom overrides)", {
+        directory: z.string().optional().describe("Directory to search for .jsonui-doc-rules.json"),
+        project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
+    }, async (params) => {
+        try {
+            const projectDir = config.resolveProjectDir(params.project_dir);
+            const args = ["rules", "show"];
+            if (params.directory) {
+                args.push("-d", params.directory);
+            }
+            const result = await runCli("jsonui-doc", args, { cwd: projectDir });
+            return { content: [{ type: "text", text: formatResult(result) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+        }
+    });
+}

package/dist/tools/doc/doc_validate_component.d.ts

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