@maz-ui/node 5.1.0-beta.0 → 5.1.0

package/dist/index.d.mts

@@ -234,6 +234,14 @@ interface AgentDocs {
  */
 declare function findInstalledPackage(fromDir: string, name: string): string | undefined;
 /** Reads the agent files shipped in `maz-ui/docs/agents` */
+/** Version of an installed package, read from its `package.json` */
+declare function readPackageVersion(packageDir: string): string | undefined;
+/**
+ * Finds a package installed in a project: in the `node_modules` of the
+ * project root and of its workspace folders (`apps/*`, `packages/*`, for
+ * monorepos without hoisting), then in the parent folders.
+ */
+declare function findProjectPackage(rootDir: string, name: string): string | undefined;
 declare function readAgentDocs(rootDir: string, docsDir?: string): AgentDocs;
 /**
  * Configures the AI coding agents of a project to use maz-ui: rules (version
@@ -243,5 +251,5 @@ declare function readAgentDocs(rootDir: string, docsDir?: string): AgentDocs;
  */
 declare function setupAgents(options: SetupAgentsOptions): SetupAgentsResult;
 
-export { AGENTS_MD_BEGIN, AGENTS_MD_END, AGENT_TARGETS, DEFAULT_MCP_SERVER, MANAGED_MARKER, MCP_SERVER_NAME, createLogger, detectAgentTargets, execPromise, findInstalledPackage, logger, printBanner, readAgentDocs, redactError, redactSecrets, setupAgents };
+export { AGENTS_MD_BEGIN, AGENTS_MD_END, AGENT_TARGETS, DEFAULT_MCP_SERVER, MANAGED_MARKER, MCP_SERVER_NAME, createLogger, detectAgentTargets, execPromise, findInstalledPackage, findProjectPackage, logger, printBanner, readAgentDocs, readPackageVersion, redactError, redactSecrets, setupAgents };
 export type { AgentDocs, AgentTarget, ExecPromiseOptions, LogLevel, Logger, LoggerOptions, SetupAgentsAction, SetupAgentsChange, SetupAgentsOptions, SetupAgentsResult };

package/dist/index.d.ts

@@ -234,6 +234,14 @@ interface AgentDocs {
  */
 declare function findInstalledPackage(fromDir: string, name: string): string | undefined;
 /** Reads the agent files shipped in `maz-ui/docs/agents` */
+/** Version of an installed package, read from its `package.json` */
+declare function readPackageVersion(packageDir: string): string | undefined;
+/**
+ * Finds a package installed in a project: in the `node_modules` of the
+ * project root and of its workspace folders (`apps/*`, `packages/*`, for
+ * monorepos without hoisting), then in the parent folders.
+ */
+declare function findProjectPackage(rootDir: string, name: string): string | undefined;
 declare function readAgentDocs(rootDir: string, docsDir?: string): AgentDocs;
 /**
  * Configures the AI coding agents of a project to use maz-ui: rules (version
@@ -243,5 +251,5 @@ declare function readAgentDocs(rootDir: string, docsDir?: string): AgentDocs;
  */
 declare function setupAgents(options: SetupAgentsOptions): SetupAgentsResult;
 
-export { AGENTS_MD_BEGIN, AGENTS_MD_END, AGENT_TARGETS, DEFAULT_MCP_SERVER, MANAGED_MARKER, MCP_SERVER_NAME, createLogger, detectAgentTargets, execPromise, findInstalledPackage, logger, printBanner, readAgentDocs, redactError, redactSecrets, setupAgents };
+export { AGENTS_MD_BEGIN, AGENTS_MD_END, AGENT_TARGETS, DEFAULT_MCP_SERVER, MANAGED_MARKER, MCP_SERVER_NAME, createLogger, detectAgentTargets, execPromise, findInstalledPackage, findProjectPackage, logger, printBanner, readAgentDocs, readPackageVersion, redactError, redactSecrets, setupAgents };
 export type { AgentDocs, AgentTarget, ExecPromiseOptions, LogLevel, Logger, LoggerOptions, SetupAgentsAction, SetupAgentsChange, SetupAgentsOptions, SetupAgentsResult };

package/dist/index.mjs

@@ -3,7 +3,7 @@ import process$1 from 'node:process';
 import { blueBright } from 'colorette';
 import { createConsola } from 'consola';
 import figlet from 'figlet';
-import { existsSync, readFileSync, mkdirSync, writeFileSync, rmSync } from 'node:fs';
+import { existsSync, readdirSync, readFileSync, mkdirSync, writeFileSync, rmSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { parse, applyEdits, modify } from 'jsonc-parser';
 
@@ -191,6 +191,12 @@ const MCP_SERVER_NAME = "maz-ui";
 const DEFAULT_MCP_SERVER = { command: "npx", args: ["-y", "@maz-ui/mcp@latest"] };
 const CLAUDE_RULE_FILE = ".claude/rules/maz-ui.md";
 const CLAUDE_MEMORY_FILES = ["CLAUDE.md", ".claude/CLAUDE.md", "CLAUDE.local.md"];
+function withVersion(content, version) {
+  return content.replace(/^(#{1,2} .+)\n/, `$1
+
+> maz-ui ${version} is installed: these rules and the docs in \`node_modules/maz-ui/docs\` match this version.
+`);
+}
 function managedHeader(version) {
   return `<!-- ${MANAGED_MARKER} ${version}: generated by \`npx @maz-ui/mcp init\` (or the \`mazUi.agents\` Nuxt option). Do not edit, your changes would be overwritten: write your own rules elsewhere. -->`;
 }
@@ -219,10 +225,27 @@ function findInstalledPackage(fromDir, name) {
     directory = parent;
   }
 }
+function readPackageVersion(packageDir) {
+  const file = join(packageDir, "package.json");
+  return existsSync(file) ? JSON.parse(readFileSync(file, "utf8")).version : void 0;
+}
+function findProjectPackage(rootDir, name) {
+  const bases = [rootDir];
+  for (const folder of ["apps", "packages"]) {
+    const root = join(rootDir, folder);
+    if (existsSync(root)) {
+      for (const entry of readdirSync(root, { withFileTypes: true })) {
+        if (entry.isDirectory())
+          bases.push(join(root, entry.name));
+      }
+    }
+  }
+  return bases.map((base) => join(base, "node_modules", name)).find((candidate) => existsSync(join(candidate, "package.json"))) ?? findInstalledPackage(rootDir, name);
+}
 function readAgentDocs(rootDir, docsDir) {
   let directory = docsDir;
   if (!directory) {
-    const packageDir = findInstalledPackage(rootDir, "maz-ui");
+    const packageDir = findProjectPackage(rootDir, "maz-ui");
     if (!packageDir)
       throw new Error(`maz-ui is not installed in ${rootDir}: install it first (\`npm install maz-ui\`).`);
     directory = join(packageDir, "docs");
@@ -233,9 +256,10 @@ function readAgentDocs(rootDir, docsDir) {
   if (!existsSync(manifestFile) || !existsSync(claudeRuleFile) || !existsSync(agentsMdFile)) {
     throw new Error(`The installed maz-ui does not ship the agent docs (${directory}): upgrade maz-ui to the latest version.`);
   }
+  const packageVersion = readPackageVersion(dirname(directory));
   return {
     directory,
-    version: JSON.parse(readFileSync(manifestFile, "utf8")).version,
+    version: packageVersion ?? JSON.parse(readFileSync(manifestFile, "utf8")).version,
     claudeRule: readFileSync(claudeRuleFile, "utf8").trim(),
     agentsMdSection: readFileSync(agentsMdFile, "utf8").trim()
   };
@@ -386,14 +410,14 @@ function syncRules(changes, rootDir, targets, docs) {
   if (targets.includes("claude")) {
     const rule = docs && !claudeReadsAgentsMd ? `${managedHeader(version)}
 
-${docs.claudeRule}
+${withVersion(docs.claudeRule, version)}
 ` : void 0;
     syncOwnedFile(changes, CLAUDE_RULE_FILE, rule);
   }
   if (targets.includes("agents-md"))
     syncAgentsMd(changes, docs ? `${managedHeader(version)}
 
-${docs.agentsMdSection}` : void 0);
+${withVersion(docs.agentsMdSection, version)}` : void 0);
 }
 function setupAgents(options) {
   const { rootDir, rules = true, mcp = true, dryRun = false, remove = false } = options;
@@ -413,4 +437,4 @@ function setupAgents(options) {
   return { targets, version, changes: changes.changes };
 }
 
-export { AGENTS_MD_BEGIN, AGENTS_MD_END, AGENT_TARGETS, DEFAULT_MCP_SERVER, MANAGED_MARKER, MCP_SERVER_NAME, createLogger, detectAgentTargets, execPromise, findInstalledPackage, logger, printBanner, readAgentDocs, redactError, redactSecrets, setupAgents };
+export { AGENTS_MD_BEGIN, AGENTS_MD_END, AGENT_TARGETS, DEFAULT_MCP_SERVER, MANAGED_MARKER, MCP_SERVER_NAME, createLogger, detectAgentTargets, execPromise, findInstalledPackage, findProjectPackage, logger, printBanner, readAgentDocs, readPackageVersion, redactError, redactSecrets, setupAgents };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@maz-ui/node",
   "type": "module",
-  "version": "5.1.0-beta.0",
+  "version": "5.1.0",
   "description": "Node utilities for Maz-UI library",
   "author": "Louis Mazel <me@loicmazuel.com>",
   "license": "MIT",