@maz-ui/mcp 5.1.0 → 5.2.0-beta.0

package/dist/cli.mjs

@@ -1,16 +1,14 @@
 import 'node:buffer';
 import 'node:path';
 import 'node:util';
-import '@maz-ui/node';
-import '@maz-ui/utils/helpers/getErrorMessage';
-export { H as HELP, m as main, i as runCli, k as runInit, n as runReview } from './shared/mcp.BFjMMLqy.mjs';
+export { H as HELP, m as main, r as runCli, j as runInit, k as runReview } from './shared/mcp.D3_Fk0U3.mjs';
+import 'node:child_process';
+import 'node:process';
+import 'tty';
+import 'node:tty';
+import 'fs';
+import 'path';
+import 'url';
+import 'node:crypto';
 import 'node:fs';
 import 'node:url';
-import 'zod';
-import 'minisearch';
-import '@vue/compiler-dom';
-import 'tinyglobby';
-import '@modelcontextprotocol/sdk/server/mcp.js';
-import '@modelcontextprotocol/sdk/server/stdio.js';
-import 'node:child_process';
-import '@babel/parser';

package/dist/index.d.mts

@@ -1,7 +1,6 @@
 export { main, runCli } from './cli.mjs';
 import { z, ZodRawShape } from 'zod';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export { AgentTarget, SetupAgentsOptions, SetupAgentsResult, setupAgents } from '@maz-ui/node';
 
 declare const docCategories: readonly ["guide", "component", "composable", "directive", "plugin", "ecosystem", "util", "node", "reference"];
 type DocCategory = typeof docCategories[number];
@@ -273,7 +272,8 @@ declare function searchIcons(names: Iterable<string>, query: string, limit?: num
 
 interface ServerContext {
     knowledge: Knowledge;
-    search: DocSearch;
+    /** Search index, built on the first search: the server answers `initialize` without reading the docs */
+    readonly search: DocSearch;
     /** Directory used to resolve relative file paths (review_code) */
     cwd: string;
 }
@@ -285,7 +285,7 @@ declare function createContext(options?: CreateContextOptions): ServerContext;
 declare function buildInstructions(context: ServerContext): string;
 
 type Severity = 'error' | 'warning' | 'info';
-type RuleId = 'unknown-component' | 'unknown-prop' | 'invalid-prop-value' | 'boolean-prop-string' | 'unknown-model' | 'unknown-event' | 'unknown-slot' | 'unknown-icon' | 'prefer-maz-component' | 'inline-svg' | 'internal-prefix' | 'theme-colors' | 'hardcoded-color' | 'tailwind-v3' | 'root-import' | 'internal-import' | 'prefer-ecosystem' | 'manual-dark-mode' | 'prefer-utils' | 'nuxt-auto-import' | 'missing-reference';
+type RuleId = 'unknown-component' | 'unknown-prop' | 'invalid-prop-value' | 'boolean-prop-string' | 'unknown-model' | 'unknown-event' | 'unknown-slot' | 'unknown-icon' | 'prefer-maz-component' | 'inline-svg' | 'icon-button-label' | 'internal-prefix' | 'theme-colors' | 'hardcoded-color' | 'tailwind-v3' | 'root-import' | 'internal-import' | 'prefer-ecosystem' | 'manual-dark-mode' | 'prefer-utils' | 'nuxt-auto-import' | 'missing-reference';
 interface Finding {
     rule: RuleId;
     severity: Severity;
@@ -341,5 +341,90 @@ declare function createMazUiMcpServer(options?: CreateContextOptions): {
 };
 declare function startStdioServer(options?: CreateContextOptions): Promise<McpServer>;
 
-export { DocSearch, Knowledge, TOOLS, buildInstructions, countBySeverity, createContext, createMazUiMcpServer, filterBySeverity, findProjectMazUi, formatFindings, loadKnowledge, reviewCode, reviewFiles, searchIcons, startStdioServer };
-export type { ComponentApi, CreateContextOptions, DocCategory, DocEntry, Finding, Framework, KnowledgeSource, LoadKnowledgeOptions, Manifest, ReviewOptions, RuleId, ServerContext, Severity };
+/**
+ * AI coding agents supported by `setupAgents`.
+ *
+ * - `claude`: Claude Code rule (`.claude/rules/<tool>.md`) and MCP server (`.mcp.json`)
+ * - `agents-md`: section in `AGENTS.md` (Codex, Cursor, Copilot, Windsurf, Zed, Gemini...)
+ * - `cursor`: MCP server in `.cursor/mcp.json` (rules come from `AGENTS.md`)
+ * - `vscode`: MCP server in `.vscode/mcp.json` for GitHub Copilot (rules come from `AGENTS.md`)
+ */
+type AgentTarget = 'claude' | 'agents-md' | 'cursor' | 'vscode';
+interface SetupAgentsOptions {
+    /** Root of the project (where `AGENTS.md`, `.claude/`, `.mcp.json` live) */
+    rootDir: string;
+    /** Agents to configure. Default: the agents detected in the project */
+    targets?: AgentTarget[];
+    /** Write the rules of the tool (Claude Code rule, `AGENTS.md` section). Default `true` */
+    rules?: boolean;
+    /** Register the MCP server of the tool. Default `true` */
+    mcp?: boolean;
+    /** Compute the changes without writing anything */
+    dryRun?: boolean;
+    /** Remove everything `setupAgents` added */
+    remove?: boolean;
+    /** Folder of the maz-ui agent docs. Default: `docs/` of the maz-ui package installed in `rootDir` */
+    docsDir?: string;
+    /** Command used to start the MCP server. Default: `mcpServerCommand(rootDir, mcpVersion, tool)` */
+    mcpServer?: McpServerCommand;
+    /** Version of the MCP package pinned in the `npx -y` command, when the project does not install it. Default `latest` */
+    mcpVersion?: string;
+    /** Tool whose agents are configured. Default: maz-ui (`MAZ_UI_AGENTS_TOOL`) */
+    tool?: AgentsTool;
+    /** Rules of the tool, required with another `tool` than maz-ui. Default: the maz-ui agent docs of `docsDir` */
+    agentDocs?: AgentDocs;
+}
+interface McpServerCommand {
+    command: string;
+    args: string[];
+}
+type SetupAgentsAction = 'create' | 'update' | 'remove' | 'unchanged' | 'skip';
+interface SetupAgentsChange {
+    /** Path relative to `rootDir` */
+    file: string;
+    action: SetupAgentsAction;
+    reason?: string;
+}
+interface SetupAgentsResult {
+    targets: AgentTarget[];
+    version: string;
+    changes: SetupAgentsChange[];
+    /** Command registered in the MCP config files */
+    mcpServer: McpServerCommand;
+    /** `false` when the server runs through `npx -y` because the project does not install the MCP package */
+    localMcpServer: boolean;
+}
+/**
+ * A tool whose AI agents are configured by `setupAgents`: maz-ui by default,
+ * or another package that ships its own MCP server and rules.
+ */
+interface AgentsTool {
+    /** Name of the tool: key of its MCP server, `.claude/rules/<name>.md` and markers of the generated content */
+    name: string;
+    /** Package that ships the MCP server */
+    mcpPackage: string;
+    /** Bin of `mcpPackage` that starts the MCP server */
+    mcpBin: string;
+    /** Arguments of `mcpBin` that start the MCP server (e.g. `['mcp']`). Default `[]` */
+    mcpArgs?: string[];
+    /** What generates the rules, written in their header (markdown, e.g. `` `npx relizy mcp init` ``) */
+    generatedBy: string;
+    /** Line written under the title of the rules. Default: `> <name> <version> is installed: these rules match this version.` */
+    versionNote?: (version: string) => string;
+}
+interface AgentDocs {
+    directory: string;
+    version: string;
+    claudeRule: string;
+    agentsMdSection: string;
+}
+/**
+ * Configures the AI coding agents of a project to use a tool, maz-ui by
+ * default: rules (version matched with the installed tool) and its MCP server.
+ * Idempotent and conservative: it only writes files it owns, a delimited
+ * section of `AGENTS.md` and its own entry of the MCP config files.
+ */
+declare function setupAgents(options: SetupAgentsOptions): SetupAgentsResult;
+
+export { DocSearch, Knowledge, TOOLS, buildInstructions, countBySeverity, createContext, createMazUiMcpServer, filterBySeverity, findProjectMazUi, formatFindings, loadKnowledge, reviewCode, reviewFiles, searchIcons, setupAgents, startStdioServer };
+export type { AgentTarget, ComponentApi, CreateContextOptions, DocCategory, DocEntry, Finding, Framework, KnowledgeSource, LoadKnowledgeOptions, Manifest, ReviewOptions, RuleId, ServerContext, SetupAgentsOptions, SetupAgentsResult, Severity };

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 export { main, runCli } from './cli.js';
 import { z, ZodRawShape } from 'zod';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export { AgentTarget, SetupAgentsOptions, SetupAgentsResult, setupAgents } from '@maz-ui/node';
 
 declare const docCategories: readonly ["guide", "component", "composable", "directive", "plugin", "ecosystem", "util", "node", "reference"];
 type DocCategory = typeof docCategories[number];
@@ -273,7 +272,8 @@ declare function searchIcons(names: Iterable<string>, query: string, limit?: num
 
 interface ServerContext {
     knowledge: Knowledge;
-    search: DocSearch;
+    /** Search index, built on the first search: the server answers `initialize` without reading the docs */
+    readonly search: DocSearch;
     /** Directory used to resolve relative file paths (review_code) */
     cwd: string;
 }
@@ -285,7 +285,7 @@ declare function createContext(options?: CreateContextOptions): ServerContext;
 declare function buildInstructions(context: ServerContext): string;
 
 type Severity = 'error' | 'warning' | 'info';
-type RuleId = 'unknown-component' | 'unknown-prop' | 'invalid-prop-value' | 'boolean-prop-string' | 'unknown-model' | 'unknown-event' | 'unknown-slot' | 'unknown-icon' | 'prefer-maz-component' | 'inline-svg' | 'internal-prefix' | 'theme-colors' | 'hardcoded-color' | 'tailwind-v3' | 'root-import' | 'internal-import' | 'prefer-ecosystem' | 'manual-dark-mode' | 'prefer-utils' | 'nuxt-auto-import' | 'missing-reference';
+type RuleId = 'unknown-component' | 'unknown-prop' | 'invalid-prop-value' | 'boolean-prop-string' | 'unknown-model' | 'unknown-event' | 'unknown-slot' | 'unknown-icon' | 'prefer-maz-component' | 'inline-svg' | 'icon-button-label' | 'internal-prefix' | 'theme-colors' | 'hardcoded-color' | 'tailwind-v3' | 'root-import' | 'internal-import' | 'prefer-ecosystem' | 'manual-dark-mode' | 'prefer-utils' | 'nuxt-auto-import' | 'missing-reference';
 interface Finding {
     rule: RuleId;
     severity: Severity;
@@ -341,5 +341,90 @@ declare function createMazUiMcpServer(options?: CreateContextOptions): {
 };
 declare function startStdioServer(options?: CreateContextOptions): Promise<McpServer>;
 
-export { DocSearch, Knowledge, TOOLS, buildInstructions, countBySeverity, createContext, createMazUiMcpServer, filterBySeverity, findProjectMazUi, formatFindings, loadKnowledge, reviewCode, reviewFiles, searchIcons, startStdioServer };
-export type { ComponentApi, CreateContextOptions, DocCategory, DocEntry, Finding, Framework, KnowledgeSource, LoadKnowledgeOptions, Manifest, ReviewOptions, RuleId, ServerContext, Severity };
+/**
+ * AI coding agents supported by `setupAgents`.
+ *
+ * - `claude`: Claude Code rule (`.claude/rules/<tool>.md`) and MCP server (`.mcp.json`)
+ * - `agents-md`: section in `AGENTS.md` (Codex, Cursor, Copilot, Windsurf, Zed, Gemini...)
+ * - `cursor`: MCP server in `.cursor/mcp.json` (rules come from `AGENTS.md`)
+ * - `vscode`: MCP server in `.vscode/mcp.json` for GitHub Copilot (rules come from `AGENTS.md`)
+ */
+type AgentTarget = 'claude' | 'agents-md' | 'cursor' | 'vscode';
+interface SetupAgentsOptions {
+    /** Root of the project (where `AGENTS.md`, `.claude/`, `.mcp.json` live) */
+    rootDir: string;
+    /** Agents to configure. Default: the agents detected in the project */
+    targets?: AgentTarget[];
+    /** Write the rules of the tool (Claude Code rule, `AGENTS.md` section). Default `true` */
+    rules?: boolean;
+    /** Register the MCP server of the tool. Default `true` */
+    mcp?: boolean;
+    /** Compute the changes without writing anything */
+    dryRun?: boolean;
+    /** Remove everything `setupAgents` added */
+    remove?: boolean;
+    /** Folder of the maz-ui agent docs. Default: `docs/` of the maz-ui package installed in `rootDir` */
+    docsDir?: string;
+    /** Command used to start the MCP server. Default: `mcpServerCommand(rootDir, mcpVersion, tool)` */
+    mcpServer?: McpServerCommand;
+    /** Version of the MCP package pinned in the `npx -y` command, when the project does not install it. Default `latest` */
+    mcpVersion?: string;
+    /** Tool whose agents are configured. Default: maz-ui (`MAZ_UI_AGENTS_TOOL`) */
+    tool?: AgentsTool;
+    /** Rules of the tool, required with another `tool` than maz-ui. Default: the maz-ui agent docs of `docsDir` */
+    agentDocs?: AgentDocs;
+}
+interface McpServerCommand {
+    command: string;
+    args: string[];
+}
+type SetupAgentsAction = 'create' | 'update' | 'remove' | 'unchanged' | 'skip';
+interface SetupAgentsChange {
+    /** Path relative to `rootDir` */
+    file: string;
+    action: SetupAgentsAction;
+    reason?: string;
+}
+interface SetupAgentsResult {
+    targets: AgentTarget[];
+    version: string;
+    changes: SetupAgentsChange[];
+    /** Command registered in the MCP config files */
+    mcpServer: McpServerCommand;
+    /** `false` when the server runs through `npx -y` because the project does not install the MCP package */
+    localMcpServer: boolean;
+}
+/**
+ * A tool whose AI agents are configured by `setupAgents`: maz-ui by default,
+ * or another package that ships its own MCP server and rules.
+ */
+interface AgentsTool {
+    /** Name of the tool: key of its MCP server, `.claude/rules/<name>.md` and markers of the generated content */
+    name: string;
+    /** Package that ships the MCP server */
+    mcpPackage: string;
+    /** Bin of `mcpPackage` that starts the MCP server */
+    mcpBin: string;
+    /** Arguments of `mcpBin` that start the MCP server (e.g. `['mcp']`). Default `[]` */
+    mcpArgs?: string[];
+    /** What generates the rules, written in their header (markdown, e.g. `` `npx relizy mcp init` ``) */
+    generatedBy: string;
+    /** Line written under the title of the rules. Default: `> <name> <version> is installed: these rules match this version.` */
+    versionNote?: (version: string) => string;
+}
+interface AgentDocs {
+    directory: string;
+    version: string;
+    claudeRule: string;
+    agentsMdSection: string;
+}
+/**
+ * Configures the AI coding agents of a project to use a tool, maz-ui by
+ * default: rules (version matched with the installed tool) and its MCP server.
+ * Idempotent and conservative: it only writes files it owns, a delimited
+ * section of `AGENTS.md` and its own entry of the MCP config files.
+ */
+declare function setupAgents(options: SetupAgentsOptions): SetupAgentsResult;
+
+export { DocSearch, Knowledge, TOOLS, buildInstructions, countBySeverity, createContext, createMazUiMcpServer, filterBySeverity, findProjectMazUi, formatFindings, loadKnowledge, reviewCode, reviewFiles, searchIcons, setupAgents, startStdioServer };
+export type { AgentTarget, ComponentApi, CreateContextOptions, DocCategory, DocEntry, Finding, Framework, KnowledgeSource, LoadKnowledgeOptions, Manifest, ReviewOptions, RuleId, ServerContext, SetupAgentsOptions, SetupAgentsResult, Severity };

package/dist/index.mjs

@@ -1,16 +1,18 @@
-export { D as DocSearch, K as Knowledge, T as TOOLS, b as buildInstructions, c as countBySeverity, a as createContext, d as createMazUiMcpServer, f as filterBySeverity, e as findProjectMazUi, g as formatFindings, l as loadKnowledge, m as main, r as reviewCode, h as reviewFiles, i as runCli, s as searchIcons, j as startStdioServer } from './shared/mcp.BFjMMLqy.mjs';
-export { setupAgents } from '@maz-ui/node';
+export { D as DocSearch, K as Knowledge, T as TOOLS, b as buildInstructions, c as createContext, a as createMazUiMcpServer, f as findProjectMazUi, l as loadKnowledge, m as main, r as runCli, s as searchIcons, d as setupAgents, e as startStdioServer } from './shared/mcp.D3_Fk0U3.mjs';
+export { countBySeverity, filterBySeverity, formatFindings, reviewCode } from './chunks/index.mjs';
+export { reviewFiles } from './chunks/files.mjs';
 import 'node:buffer';
 import 'node:path';
 import 'node:util';
-import '@maz-ui/utils/helpers/getErrorMessage';
+import 'node:child_process';
+import 'node:process';
+import 'tty';
+import 'node:tty';
+import 'fs';
+import 'path';
+import 'url';
+import 'node:crypto';
 import 'node:fs';
 import 'node:url';
-import 'zod';
-import 'minisearch';
-import '@vue/compiler-dom';
-import 'tinyglobby';
-import '@modelcontextprotocol/sdk/server/mcp.js';
-import '@modelcontextprotocol/sdk/server/stdio.js';
-import 'node:child_process';
-import '@babel/parser';
+import './shared/mcp.Ccxm-Aoc.mjs';
+import 'module';