@maz-ui/mcp 5.1.0-beta.1 → 5.1.0-beta.2

package/dist/cli.mjs

@@ -3,7 +3,7 @@ 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.DseFuKdl.mjs';
+export { H as HELP, m as main, i as runCli, k as runInit, n as runReview } from './shared/mcp.BFjMMLqy.mjs';
 import 'node:fs';
 import 'node:url';
 import 'zod';

package/dist/index.mjs

@@ -1,4 +1,4 @@
-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.DseFuKdl.mjs';
+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';
 import 'node:buffer';
 import 'node:path';

package/dist/shared/{mcp.DseFuKdl.mjs → mcp.BFjMMLqy.mjs}

@@ -1,5 +1,5 @@
 import { Buffer } from 'node:buffer';
-import { join, dirname, resolve, relative, isAbsolute } from 'node:path';
+import { join, dirname, resolve, isAbsolute, relative } from 'node:path';
 import { parseArgs } from 'node:util';
 import { findProjectPackage, readPackageVersion, AGENT_TARGETS, detectAgentTargets, setupAgents } from '@maz-ui/node';
 import { getErrorMessage } from '@maz-ui/utils/helpers/getErrorMessage';
@@ -454,7 +454,7 @@ const META_DOCS = /* @__PURE__ */ new Map([
   ["ecosystem/stylelint-config", /\b(?:stylelint|lint|linter|linting)\b/i],
   ["guide/migration-v5", /\b(?:migrat\w*|upgrad\w*|v4|v5|breaking)\b/i]
 ]);
-const META_DOC_FACTOR = 0.3;
+const META_DOC_FACTOR = 0.15;
 const LOW_VALUE_TERMS = new Set(["add", "show", "display", "delete", "remove", "update", "set", "open", "close", "user", "users", "page", "item", "data", "value", "list", "text", "click", "between", "before", "after"].map((term) => processTerm(term) ?? term));
 const LOW_VALUE_FACTOR = 0.4;
 const LOW_VALUE_ONLY_FACTOR = 0.25;
@@ -796,7 +796,7 @@ function reportBlackWhite(token, utility, color, background, position, context)
     rule: "theme-colors",
     severity: "warning",
     message: `\`${token}\` is a fixed color that does not follow the theme nor dark mode.`,
-    suggestion: color === "white" ? `Use \`${utility}-surface\` (backgrounds) or the \`-foreground\` of the color behind (\`text-primary-foreground\`). Keep it over a fixed dark background (\`bg-overlay\`, image, video).` : `Use \`${utility}-foreground\` (text) or \`${utility}-contrast\`.`
+    suggestion: color === "white" ? `Use \`${utility}-surface\` (backgrounds) or the \`-foreground\` of the color behind (\`text-primary-foreground\`). Over media (image, video) or a fixed dark background, keep it with \`<!-- maz-ui-review-ignore theme-colors -- over the video -->\` above the element.` : `Use \`${utility}-foreground\` (text) or \`${utility}-contrast\`.`
   }, position);
 }
 function checkClassList(value, offset, context, inherited) {
@@ -1639,7 +1639,8 @@ function ignoredRules(lines) {
   const byLine = /* @__PURE__ */ new Map();
   let file;
   const parseRules = (rest) => {
-    const rules = rest.replace(/-->|\*\/|\*\}|\}/g, "").split(/[\s,]+/).filter((rule) => /^[a-z][a-z\d-]+$/.test(rule));
+    const [directive] = rest.replace(/-->|\*\/|\*\}|\}/g, "").split(/\s--\s/);
+    const rules = directive.split(/[\s,]+/).filter((rule) => /^[a-z][a-z\d-]+$/.test(rule));
     return rules.length > 0 ? new Set(rules) : "all";
   };
   for (const [index, line] of lines.entries()) {
@@ -1767,12 +1768,16 @@ async function expandPaths(patterns, cwd) {
   }
   return [...files].filter((file) => REVIEWABLE_EXTENSIONS.includes(file.split(".").pop() ?? "")).sort();
 }
+function displayPath(cwd, file) {
+  const path = relative(cwd, file);
+  return path && !path.startsWith("..") && !isAbsolute(path) ? path : file;
+}
 async function reviewFiles(patterns, { knowledge, cwd, framework, minSeverity = "info" }) {
   const files = await expandPaths(patterns, cwd);
   return {
     truncated: files.length > MAX_REVIEWED_FILES,
     reviews: files.slice(0, MAX_REVIEWED_FILES).map((file) => ({
-      file: relative(cwd, file) || file,
+      file: displayPath(cwd, file),
       findings: filterBySeverity(
         reviewCode(readFileSync(file, "utf8"), { knowledge, filename: file, framework: framework ?? detectFramework(dirname(file)) }),
         minSeverity
@@ -2878,7 +2883,7 @@ async function runReview(values, positionals, cwd) {
       return 0;
     console.error(`${formatFindings(findings, reviews2[0].file)}
 
-Fix these maz-ui issues (see the maz-ui MCP tools), or add a \`maz-ui-review-ignore <rule>\` comment above the line when it is intended.`);
+Fix these maz-ui issues (see the maz-ui MCP tools), or add a \`maz-ui-review-ignore <rule> -- <reason>\` comment above the line when it is intended.`);
     return 2;
   }
   if (positionals.length === 0) {

package/docs/guide/ai-agents.md

@@ -141,6 +141,25 @@ The maz-ui plugin bundles the MCP server, a `maz-ui` skill (rules and workflow)
 
 The plugin works in every project, `init` configures one project for your whole team: use both or either.
 
+### Review hook without the plugin
+
+The review hook of the plugin is the `review --hook` mode of the CLI. To use it alone, add it to `.claude/settings.json` (shared with your team) or `.claude/settings.local.json` (your machine only):
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [{ "type": "command", "command": "npx -y @maz-ui/mcp@latest review --hook", "timeout": 90 }]
+      }
+    ]
+  }
+}
+```
+
+Each file Claude edits is reviewed; the errors and warnings are sent back to Claude, which fixes them.
+
 ## Code review in CI
 
 The checks of `review_code` are also available from the command line:
@@ -173,7 +192,7 @@ The command exits with an error code when it finds errors (or more warnings than
 | `root-import`, `internal-import` | error | Runtime imports from `maz-ui` (types only) or from `src`/`dist` |
 | `nuxt-auto-import` | info | Imports that `@maz-ui/nuxt` already auto-imports |
 
-When something is intended, ignore it with a comment on the line above (`<!-- maz-ui-review-ignore prefer-maz-component -->`, `// maz-ui-review-ignore theme-colors`), or `maz-ui-review-ignore-file` for a whole file.
+When something is intended, ignore it with a comment on the line above (`<!-- maz-ui-review-ignore prefer-maz-component -->`, `// maz-ui-review-ignore theme-colors`), or `maz-ui-review-ignore-file` for a whole file. Give the reason after `--`: `<!-- maz-ui-review-ignore theme-colors -- frame over the video -->`.
 
 ## llms.txt