@estiva-app/ui 0.28.0 → 0.29.0

package/dist/registry/cli.js

@@ -5,7 +5,7 @@ import {
   findInRegistries,
   formatFindings,
   linkProblems
-} from "./chunk-6OH3TWGF.js";
+} from "./chunk-KMZIMB3G.js";
 import {
   CLASSES,
   validateRegistry
@@ -13,10 +13,134 @@ import {
 
 // src/registry/cli.ts
 import { spawnSync } from "node:child_process";
-import { existsSync, mkdtempSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync as existsSync3, mkdirSync, mkdtempSync, readFileSync as readFileSync3, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
-import { basename, join, resolve } from "node:path";
+import { basename as basename2, dirname as dirname3, join as join3, relative as relative2, resolve as resolve3 } from "node:path";
 import { fileURLToPath } from "node:url";
+
+// src/registry/siblings.ts
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+var PACKAGE_NAME = "@estiva-app/ui";
+function manifest(folder) {
+  const file = join(folder, "package.json");
+  if (!existsSync(file)) return null;
+  try {
+    return JSON.parse(readFileSync(file, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function appName(folder) {
+  const m = manifest(folder);
+  if (!m || m.name === PACKAGE_NAME) return null;
+  const uses = Boolean(m.dependencies?.[PACKAGE_NAME] ?? m.devDependencies?.[PACKAGE_NAME]);
+  return uses && existsSync(join(folder, "src")) ? m.name ?? basename(folder) : null;
+}
+var isDir = (path) => {
+  try {
+    return statSync(path).isDirectory();
+  } catch {
+    return false;
+  }
+};
+function workspaceOf(from) {
+  let at = resolve(from);
+  for (; ; ) {
+    if (existsSync(join(at, ".git"))) return dirname(at);
+    const up = dirname(at);
+    if (up === at) return resolve(from);
+    at = up;
+  }
+}
+function findSiblings(workspace, { skip = [] } = {}) {
+  let tops;
+  try {
+    tops = readdirSync(workspace).filter((name) => !name.startsWith(".") && name !== "node_modules" && isDir(join(workspace, name)));
+  } catch {
+    return [];
+  }
+  const found = [];
+  for (const top of tops) {
+    const folder = join(workspace, top);
+    const inside = readdirSync(folder).filter((name) => !name.startsWith(".") && name !== "node_modules" && isDir(join(folder, name)));
+    for (const candidate of [folder, ...inside.map((name) => join(folder, name))]) {
+      const packageName = appName(candidate);
+      if (packageName) found.push({ name: top, folder: candidate, packageName });
+    }
+  }
+  const byPackage = /* @__PURE__ */ new Map();
+  for (const sibling of found.sort((a, b) => a.name.length - b.name.length || a.name.localeCompare(b.name))) {
+    if (skip.includes(sibling.packageName) || byPackage.has(sibling.packageName)) continue;
+    byPackage.set(sibling.packageName, sibling);
+  }
+  return [...byPackage.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+
+// src/registry/skill.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import { dirname as dirname2, join as join2, relative, resolve as resolve2, sep } from "node:path";
+var SKILL_NAME = "estiva-ui";
+var SKILL_DESCRIPTION = `Use before building, adding or changing anything on screen in an app that uses @estiva-app/ui, or in @estiva-app/ui itself: a screen, panel, list, row, header, dialog, menu, empty state, a new component, or how something looks. Also when someone asks for a component in plain words ("I need a\u2026", "add a\u2026", "is there a\u2026"). It searches every catalogue at once, the package's and each app's Storybook, for a part that already does the job, and lists the mistakes this codebase keeps making.`;
+var SEARCH_RULES = ["Bash(npm run ui:find *)", "Bash(npm --prefix * run ui:find *)", "PowerShell(npm run ui:find *)", "PowerShell(npm --prefix * run ui:find *)"];
+var skillTextPath = (packageRoot2) => join2(packageRoot2, "skill", `${SKILL_NAME}.md`);
+var loaderPath = (folder) => join2(folder, ".claude", "skills", SKILL_NAME, "SKILL.md");
+var settingsPath = (folder) => join2(folder, ".claude", "settings.json");
+function loaderText(folder, packageRoot2) {
+  const fromTop = relative(folder, skillTextPath(packageRoot2)).split(sep).join("/");
+  return [
+    "---",
+    `name: ${SKILL_NAME}`,
+    `description: ${JSON.stringify(SKILL_DESCRIPTION)}`,
+    "---",
+    "",
+    "<!-- Written by `estiva-ui skill` from @estiva-app/ui; `estiva-ui check` fails when it differs. The text is the installed package\u2019s, read in below. -->",
+    "",
+    `!\`cat "\${CLAUDE_PROJECT_DIR}/${fromTop}"\``,
+    ""
+  ].join("\n");
+}
+var readSettings = (folder) => {
+  const path = settingsPath(folder);
+  if (!existsSync2(path)) return {};
+  try {
+    return JSON.parse(readFileSync2(path, "utf8"));
+  } catch {
+    return null;
+  }
+};
+function settingsWithSearch(folder) {
+  const settings = readSettings(folder);
+  if (!settings) return null;
+  const allow = settings.permissions?.allow ?? [];
+  const missing = SEARCH_RULES.filter((rule) => !allow.includes(rule));
+  if (!missing.length && existsSync2(settingsPath(folder))) return null;
+  settings.permissions = { ...settings.permissions, allow: [...allow, ...missing] };
+  return `${JSON.stringify(settings, null, 2)}
+`;
+}
+function repositoryOf(from) {
+  let at = resolve2(from);
+  for (; ; ) {
+    if (existsSync2(join2(at, ".git"))) return at;
+    const up = dirname2(at);
+    if (up === at) return resolve2(from);
+    at = up;
+  }
+}
+function loaderProblem(folder, packageRoot2) {
+  const path = loaderPath(folder);
+  const shown = relative(process.cwd(), path).split(sep).join("/") || path;
+  if (!existsSync2(path)) return `${shown} is missing: run "estiva-ui skill" and commit it`;
+  if (readFileSync2(path, "utf8").replace(/\r\n/g, "\n") !== loaderText(folder, packageRoot2)) return `${shown} is not what the package writes: run "estiva-ui skill" and commit it`;
+  if (!existsSync2(skillTextPath(packageRoot2))) return `${shown} reads ${skillTextPath(packageRoot2)}, which is not there`;
+  const allow = readSettings(folder)?.permissions?.allow ?? [];
+  const missing = SEARCH_RULES.filter((rule) => !allow.includes(rule));
+  if (missing.length) return `.claude/settings.json does not allow the search (${missing.join(", ")}): run "estiva-ui skill" and commit it`;
+  return null;
+}
+
+// src/registry/cli.ts
 var packageBuilder = () => import("./build-LGFCCOLR.js");
 var appBuilder = () => import("./app-FXN4EI34.js");
 var gatedScan = () => import("./gated-5CPIUQAW.js");
@@ -39,24 +163,35 @@ var plain = () => {
   }
   return out;
 };
-var root = resolve(value("root") ?? ".");
-var manifestAt = (folder) => JSON.parse(readFileSync(resolve(folder, "package.json"), "utf8"));
-var isPackage = existsSync(resolve(root, "package.json")) && manifestAt(root).name === "@estiva-app/ui";
+var root = resolve3(value("root") ?? ".");
+var manifestAt = (folder) => JSON.parse(readFileSync3(resolve3(folder, "package.json"), "utf8"));
+var isPackage = existsSync3(resolve3(root, "package.json")) && manifestAt(root).name === "@estiva-app/ui";
 function packageRegistryPath() {
   const named = value("file");
-  if (named) return resolve(named);
-  if (isPackage) return resolve(root, "registry.json");
+  if (named) return resolve3(named);
+  if (isPackage) return resolve3(root, "registry.json");
   return fileURLToPath(new URL("../../registry.json", import.meta.url));
 }
 function readPackageRegistry() {
   const path = packageRegistryPath();
-  if (!existsSync(path)) throw new Error(`no registry.json at ${path} \u2014 run "estiva-ui build" in the package first`);
-  const registry = JSON.parse(readFileSync(path, "utf8"));
+  if (!existsSync3(path)) throw new Error(`no registry.json at ${path} \u2014 run "estiva-ui build" in the package first`);
+  const registry = JSON.parse(readFileSync3(path, "utf8"));
   const problems = validateRegistry(registry);
   if (problems.length) throw new Error(`${path} does not match the schema:
   ${problems.join("\n  ")}`);
   return registry;
 }
+var packageRoot = () => isPackage ? root : resolve3(root, "node_modules", "@estiva-app", "ui");
+function checkLoader() {
+  const problem = loaderProblem(repositoryOf(root), packageRoot());
+  if (problem) {
+    process.stderr.write(`claude skill: ${problem}
+`);
+    return false;
+  }
+  process.stdout.write("claude skill: the loader reads the package\u2019s text\n");
+  return true;
+}
 async function buildApp(folder, repo) {
   const { buildAppRegistry } = await appBuilder();
   const registry = buildAppRegistry({ root: folder, repo });
@@ -66,20 +201,20 @@ async function buildApp(folder, repo) {
   return registry;
 }
 function checkLinks(registry, folder) {
-  const bin = resolve(folder, "node_modules", ".bin", process.platform === "win32" ? "storybook.cmd" : "storybook");
-  if (!existsSync(resolve(folder, ".storybook")) || !existsSync(bin)) {
+  const bin = resolve3(folder, "node_modules", ".bin", process.platform === "win32" ? "storybook.cmd" : "storybook");
+  if (!existsSync3(resolve3(folder, ".storybook")) || !existsSync3(bin)) {
     process.stdout.write("story links: no Storybook here, nothing to check\n");
     return true;
   }
-  const out = join(mkdtempSync(join(tmpdir(), "estiva-ui-index-")), "index.json");
+  const out = join3(mkdtempSync(join3(tmpdir(), "estiva-ui-index-")), "index.json");
   const run = process.platform === "win32" ? spawnSync(`"${bin}" index -o "${out}" --quiet`, { cwd: folder, encoding: "utf8", shell: true }) : spawnSync(bin, ["index", "-o", out, "--quiet"], { cwd: folder, encoding: "utf8" });
-  if (run.status !== 0 || !existsSync(out)) {
+  if (run.status !== 0 || !existsSync3(out)) {
     process.stderr.write(`story links: Storybook could not index its stories, so no link can be trusted:
 ${(run.stderr || run.stdout || "").trim()}
 `);
     return false;
   }
-  const ids = new Set(Object.keys(JSON.parse(readFileSync(out, "utf8")).entries));
+  const ids = new Set(Object.keys(JSON.parse(readFileSync3(out, "utf8")).entries));
   const dead = linkProblems(registry, ids);
   const count = registry.entries.reduce((n, entry) => n + (entry.storyId ? 1 : 0) + (entry.docsId ? 1 : 0), 0);
   if (dead.length) {
@@ -131,12 +266,16 @@ ${more.slice(0, 3).join("\n")}${more.length > 3 ? `
 `);
         }
       };
-      if (!isPackage) await add(root, value("repo"));
+      const here = !isPackage && existsSync3(resolve3(root, "package.json")) ? manifestAt(root).name ?? basename2(root) : null;
+      if (here) await add(root, value("repo"));
+      if (!values("also").length && !flag("here")) {
+        for (const sibling of findSiblings(workspaceOf(root), { skip: here ? [here] : [] })) await add(sibling.folder, sibling.name);
+      }
       for (const also of values("also")) {
         const [name, folder] = also.includes("=") ? [also.slice(0, also.indexOf("=")), also.slice(also.indexOf("=") + 1)] : [void 0, also];
-        const at = resolve(root, folder);
-        if (!existsSync(resolve(at, "package.json"))) {
-          process.stderr.write(`not searched: ${name ?? basename(at)} \u2014 nothing at ${at}
+        const at = resolve3(root, folder);
+        if (!existsSync3(resolve3(at, "package.json"))) {
+          process.stderr.write(`not searched: ${name ?? basename2(at)} \u2014 nothing at ${at}
 `);
           continue;
         }
@@ -154,7 +293,7 @@ ${more.slice(0, 3).join("\n")}${more.length > 3 ? `
       return 0;
     }
     case "build": {
-      const out = resolve(root, value("out") ?? "registry.json");
+      const out = resolve3(root, value("out") ?? "registry.json");
       if (isPackage) {
         const { buildRegistry, serializeRegistry: serializeRegistry2 } = await packageBuilder();
         const registry2 = buildRegistry({ root });
@@ -194,7 +333,8 @@ ${more.slice(0, 3).join("\n")}${more.length > 3 ? `
         }
         const linked2 = checkLinks(registry, root);
         const shown2 = await checkGated(registry, root);
-        return broken.length || !linked2 || !shown2 ? 1 : 0;
+        const loaded2 = checkLoader();
+        return broken.length || !linked2 || !shown2 || !loaded2 ? 1 : 0;
       }
       const { buildRegistry, serializeRegistry } = await packageBuilder();
       const path = packageRegistryPath();
@@ -206,12 +346,12 @@ ${more.slice(0, 3).join("\n")}${more.length > 3 ? `
 `);
         return 1;
       }
-      if (!existsSync(path)) {
+      if (!existsSync3(path)) {
         process.stderr.write(`${path} is missing \u2014 run "npm run registry"
 `);
         return 1;
       }
-      if (readFileSync(path, "utf8").replace(/\r\n/g, "\n") !== serializeRegistry(built)) {
+      if (readFileSync3(path, "utf8").replace(/\r\n/g, "\n") !== serializeRegistry(built)) {
         process.stderr.write(`${path} is not what the code produces \u2014 run "npm run registry" and commit the result
 `);
         return 1;
@@ -220,10 +360,32 @@ ${more.slice(0, 3).join("\n")}${more.length > 3 ? `
 `);
       const linked = checkLinks(built, root);
       const shown = await checkGated(built, root, ["component"]);
-      return linked && shown ? 0 : 1;
+      const loaded = checkLoader();
+      return linked && shown && loaded ? 0 : 1;
+    }
+    case "skill": {
+      const out = value("out");
+      const folder = out ? resolve3(out) : repositoryOf(root);
+      if (relative2(folder, packageRoot()).startsWith("..")) {
+        process.stderr.write(`${folder} does not hold ${packageRoot()}: a loader there could not reach the skill's text
+`);
+        return 1;
+      }
+      const path = loaderPath(folder);
+      mkdirSync(dirname3(path), { recursive: true });
+      writeFileSync(path, loaderText(folder, packageRoot()), "utf8");
+      process.stdout.write(`${path}: the Claude skill, read from ${packageRoot()}
+`);
+      const settings = settingsWithSearch(folder);
+      if (settings) {
+        writeFileSync(settingsPath(folder), settings, "utf8");
+        process.stdout.write(`${settingsPath(folder)}: the search allowed without a prompt
+`);
+      }
+      return 0;
     }
     default:
-      process.stderr.write("estiva-ui <find | build | check>\n");
+      process.stderr.write("estiva-ui <find | build | check | skill>\n");
       return 1;
   }
 }

package/dist/registry/cli.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../src/registry/cli.ts"],
-  "sourcesContent": ["/// <reference types=\"node\" />\n/**\n * `estiva-ui` \u2014 the catalogue as a command (UIG-12, UIG-13; docs/GATES.md \u00A723\n * for why it ships in the package rather than as a script pasted into each repo).\n *\n *   estiva-ui find <words\u2026> [--also [name=]<folder>]\u2026 [--json] [--limit n]\n *   estiva-ui build [--out <path>]\n *   estiva-ui check\n *\n * Every command takes `--root <folder>` (the library it reads; default: here)\n * and `--repo <name>` (what an app's entries are called; default: its package name).\n *\n * **In the package** (`@estiva-app/ui` itself): `build` writes the committed\n * `registry.json`, and `check` rebuilds it and fails on a single byte of drift.\n *\n * **In an app**: nothing is committed (Katerina, 18 September 2026 \u2014 the\n * package is public, the apps are private). `check` builds the app's catalogue\n * and fails when a part has no one-line description or cannot be sorted, or\n * when a reusable part breaks the usage-page contract (UIG-19, `./contract`);\n * CI's `gate` job runs it. `build` writes the catalogue to a file only when asked.\n *\n * `find` searches the package's catalogue \u2014 the one shipped inside the installed\n * package, or this repo's own in the package \u2014 plus, in an app, the app's own,\n * built fresh, plus each `--also` app that sits beside it.\n */\nimport { spawnSync } from 'node:child_process'\nimport { existsSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { basename, join, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { CONTRACT_KINDS, contractProblems, linkProblems } from './contract'\nimport { findInRegistries, formatFindings } from './find'\nimport { CLASSES, validateRegistry, type Registry } from './schema'\n\n/**\n * The builders, loaded only when they are used.\n *\n * They read TypeScript with TypeScript, and `typescript` is a dev dependency of\n * the app that installs this package \u2014 a real one in Peek, Ship and this repo,\n * and possibly absent elsewhere. A static import made the bundler put the whole\n * builder in the same chunk as `find`, so `npx estiva-ui find \u2026` died with\n * ERR_MODULE_NOT_FOUND before opening the file it needed.\n */\nconst packageBuilder = () => import('./build')\nconst appBuilder = () => import('./app')\nconst gatedScan = () => import('./gated')\n\nconst [command, ...rest] = process.argv.slice(2)\nconst VALUED = ['--limit', '--out', '--file', '--root', '--repo', '--also']\nconst flag = (name: string) => rest.includes(`--${name}`)\nconst value = (name: string) => {\n  const at = rest.indexOf(`--${name}`)\n  return at === -1 ? undefined : rest[at + 1]\n}\nconst values = (name: string) => rest.flatMap((word, i) => (word === `--${name}` && rest[i + 1] !== undefined ? [rest[i + 1]] : []))\n/** Everything that is not a flag or a flag's value: the words of the question. */\nconst plain = () => {\n  const out: string[] = []\n  for (let i = 0; i < rest.length; i++) {\n    if (rest[i].startsWith('--')) {\n      if (VALUED.includes(rest[i])) i += 1\n      continue\n    }\n    out.push(rest[i])\n  }\n  return out\n}\n\nconst root = resolve(value('root') ?? '.')\nconst manifestAt = (folder: string) => JSON.parse(readFileSync(resolve(folder, 'package.json'), 'utf8')) as { name?: string }\n/** The package itself, or an app that installs it. */\nconst isPackage = existsSync(resolve(root, 'package.json')) && manifestAt(root).name === '@estiva-app/ui'\n\n/** The package's committed catalogue: `--file`, this repo's own in the package, else the copy inside the installed package. */\nfunction packageRegistryPath(): string {\n  const named = value('file')\n  if (named) return resolve(named)\n  if (isPackage) return resolve(root, 'registry.json')\n  // dist/registry/cli.js \u2192 the package's own root. Never an app's own folder:\n  // a registry.json there is the app's, written by `estiva-ui build`.\n  return fileURLToPath(new URL('../../registry.json', import.meta.url))\n}\n\nfunction readPackageRegistry(): Registry {\n  const path = packageRegistryPath()\n  if (!existsSync(path)) throw new Error(`no registry.json at ${path} \u2014 run \"estiva-ui build\" in the package first`)\n  const registry = JSON.parse(readFileSync(path, 'utf8')) as Registry\n  const problems = validateRegistry(registry)\n  // A malformed catalogue is worse than none: it would answer, wrongly.\n  if (problems.length) throw new Error(`${path} does not match the schema:\\n  ${problems.join('\\n  ')}`)\n  return registry\n}\n\nasync function buildApp(folder: string, repo: string | undefined): Promise<Registry> {\n  const { buildAppRegistry } = await appBuilder()\n  const registry = buildAppRegistry({ root: folder, repo })\n  const problems = validateRegistry(registry)\n  if (problems.length) throw new Error(`the catalogue of ${registry.builtFrom.repo} does not match its own schema:\\n  ${problems.join('\\n  ')}`)\n  return registry\n}\n\n/**\n * Every story and docs link in a catalogue, against the Storybook beside it\n * (UIG-19). `storybook index` writes the ids Storybook itself would serve \u2014 no\n * server, no browser, seconds \u2014 so a renamed story, or a page that no longer\n * compiles, fails here rather than as a dead link somebody finds later.\n * Reports, and says whether it passed. A folder with no Storybook has nothing\n * to check.\n */\nfunction checkLinks(registry: Registry, folder: string): boolean {\n  const bin = resolve(folder, 'node_modules', '.bin', process.platform === 'win32' ? 'storybook.cmd' : 'storybook')\n  if (!existsSync(resolve(folder, '.storybook')) || !existsSync(bin)) {\n    process.stdout.write('story links: no Storybook here, nothing to check\\n')\n    return true\n  }\n  const out = join(mkdtempSync(join(tmpdir(), 'estiva-ui-index-')), 'index.json')\n  // A `.cmd` needs a shell on Windows, and Node wants that as one quoted line\n  // rather than an argument list. Both paths are ours: the app's folder and a temp file.\n  const run =\n    process.platform === 'win32'\n      ? spawnSync(`\"${bin}\" index -o \"${out}\" --quiet`, { cwd: folder, encoding: 'utf8', shell: true })\n      : spawnSync(bin, ['index', '-o', out, '--quiet'], { cwd: folder, encoding: 'utf8' })\n  if (run.status !== 0 || !existsSync(out)) {\n    process.stderr.write(`story links: Storybook could not index its stories, so no link can be trusted:\\n${(run.stderr || run.stdout || '').trim()}\\n`)\n    return false\n  }\n  const ids = new Set(Object.keys((JSON.parse(readFileSync(out, 'utf8')) as { entries: Record<string, unknown> }).entries))\n  const dead = linkProblems(registry, ids)\n  const count = registry.entries.reduce((n, entry) => n + (entry.storyId ? 1 : 0) + (entry.docsId ? 1 : 0), 0)\n  if (dead.length) {\n    process.stderr.write(`story links: ${dead.length} of ${count} lead nowhere:\\n  ${dead.join('\\n  ')}\\n`)\n    return false\n  }\n  process.stdout.write(`story links: all ${count} open a story or docs page Storybook has\\n`)\n  return true\n}\n\n/**\n * What a part draws only when a prop is passed, where no story passes it\n * (UIG-19, `./gated`). Strict, by Katerina's ruling: a part's own stories show\n * everything it can draw. In an app it reads the reusable parts; in the package,\n * every component (`kinds` is the package's one class, `component`).\n */\nasync function checkGated(registry: Registry, folder: string, kinds?: string[]): Promise<boolean> {\n  const { gatedFindings } = await gatedScan()\n  const found = gatedFindings(registry, folder, { ...(kinds ? { kinds } : {}), pictured: 'own' })\n  if (found.length) {\n    const lines = found.map((f) => `${f.part} (${f.file}) draws something only when given \\`${f.prop}\\`, and no story that draws it passes \\`${f.prop}\\`: pass it in a story`)\n    process.stderr.write(`stories: ${found.length === 1 ? 'one thing a part draws is' : `${found.length} things parts draw are`} never shown:\\n  ${lines.join('\\n  ')}\\n`)\n    return false\n  }\n  process.stdout.write('stories: everything a part draws behind a prop is shown by a story\\n')\n  return true\n}\n\n/** One line per kind, in a fixed order, so two runs read the same. */\nfunction summary(registry: Registry): string {\n  const count = (cls: string) => registry.entries.filter((entry) => entry.app?.class === cls).length\n  const kinds = CLASSES.map((cls) => `${count(cls)} ${cls}`).join(', ')\n  const files = registry.builtFrom.files ?? 0\n  return `${registry.builtFrom.repo}: ${registry.entries.length} parts in ${files - registry.filesWithoutParts.length} files (${registry.filesWithoutParts.length} more hold none) \u2014 ${kinds}. Every part is described and sorted.`\n}\n\nasync function main(): Promise<number> {\n  switch (command) {\n    case 'find': {\n      const query = plain().join(' ')\n      if (!query.trim()) {\n        process.stderr.write('estiva-ui find <words\u2026> \u2014 what the thing you need does, in words\\n')\n        return 1\n      }\n      const registries: Registry[] = [readPackageRegistry()]\n      // An app that cannot be read is said out loud, and the rest still answer.\n      const add = async (folder: string, repo: string | undefined) => {\n        try {\n          registries.push(await buildApp(folder, repo))\n        } catch (error) {\n          const [first, ...more] = String(error instanceof Error ? error.message : error).split('\\n')\n          process.stderr.write(`not searched: ${first}${more.length ? `\\n${more.slice(0, 3).join('\\n')}${more.length > 3 ? `\\n  \u2026and ${more.length - 3} more \u2014 run \"estiva-ui check\" there` : ''}` : ''}\\n`)\n        }\n      }\n      if (!isPackage) await add(root, value('repo'))\n      for (const also of values('also')) {\n        const [name, folder] = also.includes('=') ? [also.slice(0, also.indexOf('=')), also.slice(also.indexOf('=') + 1)] : [undefined, also]\n        const at = resolve(root, folder)\n        if (!existsSync(resolve(at, 'package.json'))) {\n          process.stderr.write(`not searched: ${name ?? basename(at)} \u2014 nothing at ${at}\\n`)\n          continue\n        }\n        await add(at, name)\n      }\n      const limit = Number(value('limit') ?? 5)\n      const findings = findInRegistries(registries, query, { limit: Number.isFinite(limit) && limit > 0 ? limit : 5 })\n      if (flag('json')) {\n        process.stdout.write(`${JSON.stringify(findings.map((finding) => finding.entry), null, 2)}\\n`)\n        return 0\n      }\n      process.stdout.write(`${formatFindings(registries, findings, query)}\\n`)\n      // Nothing found is not a failure \u2014 it is the answer that sends a session\n      // to ask rather than to invent.\n      return 0\n    }\n\n    case 'build': {\n      const out = resolve(root, value('out') ?? 'registry.json')\n      if (isPackage) {\n        const { buildRegistry, serializeRegistry } = await packageBuilder()\n        const registry = buildRegistry({ root })\n        const problems = validateRegistry(registry)\n        if (problems.length) {\n          process.stderr.write(`the registry this build produced does not match its own schema:\\n  ${problems.join('\\n  ')}\\n`)\n          return 1\n        }\n        writeFileSync(out, serializeRegistry(registry), 'utf8')\n        process.stdout.write(`${out}: ${registry.entries.length} entries from ${registry.builtFrom.exports} exports\\n`)\n        return 0\n      }\n      const { serializeRegistry } = await packageBuilder()\n      const registry = await buildApp(root, value('repo'))\n      writeFileSync(out, serializeRegistry(registry), 'utf8')\n      process.stdout.write(`${out}: ${summary(registry)}\\n`)\n      return 0\n    }\n\n    case 'check': {\n      if (!isPackage) {\n        const registry = await buildApp(root, value('repo'))\n        process.stdout.write(`${summary(registry)}\\n`)\n        // The usage-page contract and the story links (UIG-19): the one copy, run by every app's `gate` job.\n        const broken = contractProblems(registry, root)\n        if (broken.length) {\n          process.stderr.write(`${broken.length === 1 ? 'a part breaks' : `${broken.length} parts break`} the usage-page contract:\\n  ${broken.join('\\n  ')}\\n`)\n        } else {\n          const owed = registry.entries.filter((entry) => (CONTRACT_KINDS as readonly string[]).includes(entry.app?.class ?? '')).length\n          process.stdout.write(`usage pages: all ${owed} reusable parts keep the contract and are drawn somewhere\\n`)\n        }\n        const linked = checkLinks(registry, root)\n        const shown = await checkGated(registry, root)\n        return broken.length || !linked || !shown ? 1 : 0\n      }\n      const { buildRegistry, serializeRegistry } = await packageBuilder()\n      const path = packageRegistryPath()\n      const built = buildRegistry({ root })\n      const problems = validateRegistry(built)\n      if (problems.length) {\n        process.stderr.write(`the registry does not match its own schema:\\n  ${problems.join('\\n  ')}\\n`)\n        return 1\n      }\n      if (!existsSync(path)) {\n        process.stderr.write(`${path} is missing \u2014 run \"npm run registry\"\\n`)\n        return 1\n      }\n      // Byte for byte. The point of the check is that the committed file cannot\n      // drift from the code; \"near enough\" is drift.\n      if (readFileSync(path, 'utf8').replace(/\\r\\n/g, '\\n') !== serializeRegistry(built)) {\n        process.stderr.write(`${path} is not what the code produces \u2014 run \"npm run registry\" and commit the result\\n`)\n        return 1\n      }\n      process.stdout.write(`${path}: current, ${built.entries.length} entries from ${built.builtFrom.exports} exports\\n`)\n      const linked = checkLinks(built, root)\n      const shown = await checkGated(built, root, ['component'])\n      return linked && shown ? 0 : 1\n    }\n\n    default:\n      process.stderr.write('estiva-ui <find | build | check>\\n')\n      return 1\n  }\n}\n\ntry {\n  process.exitCode = await main()\n} catch (error) {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exitCode = 1\n}\n"],
-  "mappings": "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",
-  "names": ["serializeRegistry", "registry", "linked", "shown"]
+  "sources": ["../../src/registry/cli.ts", "../../src/registry/siblings.ts", "../../src/registry/skill.ts"],
+  "sourcesContent": ["/// <reference types=\"node\" />\n/**\n * `estiva-ui` \u2014 the catalogue as a command (UIG-12, UIG-13; docs/GATES.md \u00A723\n * for why it ships in the package rather than as a script pasted into each repo).\n *\n *   estiva-ui find <words\u2026> [--here | --also [name=]<folder>\u2026] [--json] [--limit n]\n *   estiva-ui build [--out <path>]\n *   estiva-ui check\n *   estiva-ui skill [--out <folder>]\n *\n * Every command takes `--root <folder>` (the library it reads; default: here)\n * and `--repo <name>` (what an app's entries are called; default: its package name).\n *\n * **In the package** (`@estiva-app/ui` itself): `build` writes the committed\n * `registry.json`, and `check` rebuilds it and fails on a single byte of drift.\n *\n * **In an app**: nothing is committed (Katerina, 18 September 2026 \u2014 the\n * package is public, the apps are private). `check` builds the app's catalogue\n * and fails when a part has no one-line description or cannot be sorted, or\n * when a reusable part breaks the usage-page contract (UIG-19, `./contract`);\n * CI's `gate` job runs it. `build` writes the catalogue to a file only when asked.\n *\n * `find` searches the package's catalogue \u2014 the one shipped inside the installed\n * package, or this repo's own in the package \u2014 plus, in an app, the app's own,\n * built fresh, plus every app beside it (UIG-20, `./siblings`): found, not\n * named, so one command answers the same from any repository, or from the\n * folder that holds them. `--here` searches no neighbour; `--also` names them.\n *\n * `skill` writes the repository's Claude skill loader (UIG-20, `./skill`), or\n * the one for `--out <folder>`; `check` fails when the repository's is missing\n * or differs.\n */\nimport { spawnSync } from 'node:child_process'\nimport { existsSync, mkdirSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs'\nimport { tmpdir } from 'node:os'\nimport { basename, dirname, join, relative, resolve } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport { CONTRACT_KINDS, contractProblems, linkProblems } from './contract'\nimport { findInRegistries, formatFindings } from './find'\nimport { findSiblings, workspaceOf } from './siblings'\nimport { loaderPath, loaderProblem, loaderText, repositoryOf, settingsPath, settingsWithSearch } from './skill'\nimport { CLASSES, validateRegistry, type Registry } from './schema'\n\n/**\n * The builders, loaded only when they are used.\n *\n * They read TypeScript with TypeScript, and `typescript` is a dev dependency of\n * the app that installs this package \u2014 a real one in Peek, Ship and this repo,\n * and possibly absent elsewhere. A static import made the bundler put the whole\n * builder in the same chunk as `find`, so `npx estiva-ui find \u2026` died with\n * ERR_MODULE_NOT_FOUND before opening the file it needed.\n */\nconst packageBuilder = () => import('./build')\nconst appBuilder = () => import('./app')\nconst gatedScan = () => import('./gated')\n\nconst [command, ...rest] = process.argv.slice(2)\nconst VALUED = ['--limit', '--out', '--file', '--root', '--repo', '--also']\nconst flag = (name: string) => rest.includes(`--${name}`)\nconst value = (name: string) => {\n  const at = rest.indexOf(`--${name}`)\n  return at === -1 ? undefined : rest[at + 1]\n}\nconst values = (name: string) => rest.flatMap((word, i) => (word === `--${name}` && rest[i + 1] !== undefined ? [rest[i + 1]] : []))\n/** Everything that is not a flag or a flag's value: the words of the question. */\nconst plain = () => {\n  const out: string[] = []\n  for (let i = 0; i < rest.length; i++) {\n    if (rest[i].startsWith('--')) {\n      if (VALUED.includes(rest[i])) i += 1\n      continue\n    }\n    out.push(rest[i])\n  }\n  return out\n}\n\nconst root = resolve(value('root') ?? '.')\nconst manifestAt = (folder: string) => JSON.parse(readFileSync(resolve(folder, 'package.json'), 'utf8')) as { name?: string }\n/** The package itself, or an app that installs it. */\nconst isPackage = existsSync(resolve(root, 'package.json')) && manifestAt(root).name === '@estiva-app/ui'\n\n/** The package's committed catalogue: `--file`, this repo's own in the package, else the copy inside the installed package. */\nfunction packageRegistryPath(): string {\n  const named = value('file')\n  if (named) return resolve(named)\n  if (isPackage) return resolve(root, 'registry.json')\n  // dist/registry/cli.js \u2192 the package's own root. Never an app's own folder:\n  // a registry.json there is the app's, written by `estiva-ui build`.\n  return fileURLToPath(new URL('../../registry.json', import.meta.url))\n}\n\nfunction readPackageRegistry(): Registry {\n  const path = packageRegistryPath()\n  if (!existsSync(path)) throw new Error(`no registry.json at ${path} \u2014 run \"estiva-ui build\" in the package first`)\n  const registry = JSON.parse(readFileSync(path, 'utf8')) as Registry\n  const problems = validateRegistry(registry)\n  // A malformed catalogue is worse than none: it would answer, wrongly.\n  if (problems.length) throw new Error(`${path} does not match the schema:\\n  ${problems.join('\\n  ')}`)\n  return registry\n}\n\n/** The installed package whose skill text a loader reads: this repo in the package, else the app's install. */\nconst packageRoot = () => (isPackage ? root : resolve(root, 'node_modules', '@estiva-app', 'ui'))\n\n/** The Claude skill loader (UIG-20): reports, and says whether it passed. */\nfunction checkLoader(): boolean {\n  const problem = loaderProblem(repositoryOf(root), packageRoot())\n  if (problem) {\n    process.stderr.write(`claude skill: ${problem}\\n`)\n    return false\n  }\n  process.stdout.write('claude skill: the loader reads the package\u2019s text\\n')\n  return true\n}\n\nasync function buildApp(folder: string, repo: string | undefined): Promise<Registry> {\n  const { buildAppRegistry } = await appBuilder()\n  const registry = buildAppRegistry({ root: folder, repo })\n  const problems = validateRegistry(registry)\n  if (problems.length) throw new Error(`the catalogue of ${registry.builtFrom.repo} does not match its own schema:\\n  ${problems.join('\\n  ')}`)\n  return registry\n}\n\n/**\n * Every story and docs link in a catalogue, against the Storybook beside it\n * (UIG-19). `storybook index` writes the ids Storybook itself would serve \u2014 no\n * server, no browser, seconds \u2014 so a renamed story, or a page that no longer\n * compiles, fails here rather than as a dead link somebody finds later.\n * Reports, and says whether it passed. A folder with no Storybook has nothing\n * to check.\n */\nfunction checkLinks(registry: Registry, folder: string): boolean {\n  const bin = resolve(folder, 'node_modules', '.bin', process.platform === 'win32' ? 'storybook.cmd' : 'storybook')\n  if (!existsSync(resolve(folder, '.storybook')) || !existsSync(bin)) {\n    process.stdout.write('story links: no Storybook here, nothing to check\\n')\n    return true\n  }\n  const out = join(mkdtempSync(join(tmpdir(), 'estiva-ui-index-')), 'index.json')\n  // A `.cmd` needs a shell on Windows, and Node wants that as one quoted line\n  // rather than an argument list. Both paths are ours: the app's folder and a temp file.\n  const run =\n    process.platform === 'win32'\n      ? spawnSync(`\"${bin}\" index -o \"${out}\" --quiet`, { cwd: folder, encoding: 'utf8', shell: true })\n      : spawnSync(bin, ['index', '-o', out, '--quiet'], { cwd: folder, encoding: 'utf8' })\n  if (run.status !== 0 || !existsSync(out)) {\n    process.stderr.write(`story links: Storybook could not index its stories, so no link can be trusted:\\n${(run.stderr || run.stdout || '').trim()}\\n`)\n    return false\n  }\n  const ids = new Set(Object.keys((JSON.parse(readFileSync(out, 'utf8')) as { entries: Record<string, unknown> }).entries))\n  const dead = linkProblems(registry, ids)\n  const count = registry.entries.reduce((n, entry) => n + (entry.storyId ? 1 : 0) + (entry.docsId ? 1 : 0), 0)\n  if (dead.length) {\n    process.stderr.write(`story links: ${dead.length} of ${count} lead nowhere:\\n  ${dead.join('\\n  ')}\\n`)\n    return false\n  }\n  process.stdout.write(`story links: all ${count} open a story or docs page Storybook has\\n`)\n  return true\n}\n\n/**\n * What a part draws only when a prop is passed, where no story passes it\n * (UIG-19, `./gated`). Strict, by Katerina's ruling: a part's own stories show\n * everything it can draw. In an app it reads the reusable parts; in the package,\n * every component (`kinds` is the package's one class, `component`).\n */\nasync function checkGated(registry: Registry, folder: string, kinds?: string[]): Promise<boolean> {\n  const { gatedFindings } = await gatedScan()\n  const found = gatedFindings(registry, folder, { ...(kinds ? { kinds } : {}), pictured: 'own' })\n  if (found.length) {\n    const lines = found.map((f) => `${f.part} (${f.file}) draws something only when given \\`${f.prop}\\`, and no story that draws it passes \\`${f.prop}\\`: pass it in a story`)\n    process.stderr.write(`stories: ${found.length === 1 ? 'one thing a part draws is' : `${found.length} things parts draw are`} never shown:\\n  ${lines.join('\\n  ')}\\n`)\n    return false\n  }\n  process.stdout.write('stories: everything a part draws behind a prop is shown by a story\\n')\n  return true\n}\n\n/** One line per kind, in a fixed order, so two runs read the same. */\nfunction summary(registry: Registry): string {\n  const count = (cls: string) => registry.entries.filter((entry) => entry.app?.class === cls).length\n  const kinds = CLASSES.map((cls) => `${count(cls)} ${cls}`).join(', ')\n  const files = registry.builtFrom.files ?? 0\n  return `${registry.builtFrom.repo}: ${registry.entries.length} parts in ${files - registry.filesWithoutParts.length} files (${registry.filesWithoutParts.length} more hold none) \u2014 ${kinds}. Every part is described and sorted.`\n}\n\nasync function main(): Promise<number> {\n  switch (command) {\n    case 'find': {\n      const query = plain().join(' ')\n      if (!query.trim()) {\n        process.stderr.write('estiva-ui find <words\u2026> \u2014 what the thing you need does, in words\\n')\n        return 1\n      }\n      const registries: Registry[] = [readPackageRegistry()]\n      // An app that cannot be read is said out loud, and the rest still answer.\n      const add = async (folder: string, repo: string | undefined) => {\n        try {\n          registries.push(await buildApp(folder, repo))\n        } catch (error) {\n          const [first, ...more] = String(error instanceof Error ? error.message : error).split('\\n')\n          process.stderr.write(`not searched: ${first}${more.length ? `\\n${more.slice(0, 3).join('\\n')}${more.length > 3 ? `\\n  \u2026and ${more.length - 3} more \u2014 run \"estiva-ui check\" there` : ''}` : ''}\\n`)\n        }\n      }\n      // The folder it runs in is searched when it is an app; the folder that\n      // holds the repositories is not one, and only its neighbours answer.\n      const here = !isPackage && existsSync(resolve(root, 'package.json')) ? (manifestAt(root).name ?? basename(root)) : null\n      if (here) await add(root, value('repo'))\n      if (!values('also').length && !flag('here')) {\n        for (const sibling of findSiblings(workspaceOf(root), { skip: here ? [here] : [] })) await add(sibling.folder, sibling.name)\n      }\n      for (const also of values('also')) {\n        const [name, folder] = also.includes('=') ? [also.slice(0, also.indexOf('=')), also.slice(also.indexOf('=') + 1)] : [undefined, also]\n        const at = resolve(root, folder)\n        if (!existsSync(resolve(at, 'package.json'))) {\n          process.stderr.write(`not searched: ${name ?? basename(at)} \u2014 nothing at ${at}\\n`)\n          continue\n        }\n        await add(at, name)\n      }\n      const limit = Number(value('limit') ?? 5)\n      const findings = findInRegistries(registries, query, { limit: Number.isFinite(limit) && limit > 0 ? limit : 5 })\n      if (flag('json')) {\n        process.stdout.write(`${JSON.stringify(findings.map((finding) => finding.entry), null, 2)}\\n`)\n        return 0\n      }\n      process.stdout.write(`${formatFindings(registries, findings, query)}\\n`)\n      // Nothing found is not a failure \u2014 it is the answer that sends a session\n      // to ask rather than to invent.\n      return 0\n    }\n\n    case 'build': {\n      const out = resolve(root, value('out') ?? 'registry.json')\n      if (isPackage) {\n        const { buildRegistry, serializeRegistry } = await packageBuilder()\n        const registry = buildRegistry({ root })\n        const problems = validateRegistry(registry)\n        if (problems.length) {\n          process.stderr.write(`the registry this build produced does not match its own schema:\\n  ${problems.join('\\n  ')}\\n`)\n          return 1\n        }\n        writeFileSync(out, serializeRegistry(registry), 'utf8')\n        process.stdout.write(`${out}: ${registry.entries.length} entries from ${registry.builtFrom.exports} exports\\n`)\n        return 0\n      }\n      const { serializeRegistry } = await packageBuilder()\n      const registry = await buildApp(root, value('repo'))\n      writeFileSync(out, serializeRegistry(registry), 'utf8')\n      process.stdout.write(`${out}: ${summary(registry)}\\n`)\n      return 0\n    }\n\n    case 'check': {\n      if (!isPackage) {\n        const registry = await buildApp(root, value('repo'))\n        process.stdout.write(`${summary(registry)}\\n`)\n        // The usage-page contract and the story links (UIG-19): the one copy, run by every app's `gate` job.\n        const broken = contractProblems(registry, root)\n        if (broken.length) {\n          process.stderr.write(`${broken.length === 1 ? 'a part breaks' : `${broken.length} parts break`} the usage-page contract:\\n  ${broken.join('\\n  ')}\\n`)\n        } else {\n          const owed = registry.entries.filter((entry) => (CONTRACT_KINDS as readonly string[]).includes(entry.app?.class ?? '')).length\n          process.stdout.write(`usage pages: all ${owed} reusable parts keep the contract and are drawn somewhere\\n`)\n        }\n        const linked = checkLinks(registry, root)\n        const shown = await checkGated(registry, root)\n        const loaded = checkLoader()\n        return broken.length || !linked || !shown || !loaded ? 1 : 0\n      }\n      const { buildRegistry, serializeRegistry } = await packageBuilder()\n      const path = packageRegistryPath()\n      const built = buildRegistry({ root })\n      const problems = validateRegistry(built)\n      if (problems.length) {\n        process.stderr.write(`the registry does not match its own schema:\\n  ${problems.join('\\n  ')}\\n`)\n        return 1\n      }\n      if (!existsSync(path)) {\n        process.stderr.write(`${path} is missing \u2014 run \"npm run registry\"\\n`)\n        return 1\n      }\n      // Byte for byte. The point of the check is that the committed file cannot\n      // drift from the code; \"near enough\" is drift.\n      if (readFileSync(path, 'utf8').replace(/\\r\\n/g, '\\n') !== serializeRegistry(built)) {\n        process.stderr.write(`${path} is not what the code produces \u2014 run \"npm run registry\" and commit the result\\n`)\n        return 1\n      }\n      process.stdout.write(`${path}: current, ${built.entries.length} entries from ${built.builtFrom.exports} exports\\n`)\n      const linked = checkLinks(built, root)\n      const shown = await checkGated(built, root, ['component'])\n      const loaded = checkLoader()\n      return linked && shown && loaded ? 0 : 1\n    }\n\n    case 'skill': {\n      const out = value('out')\n      const folder = out ? resolve(out) : repositoryOf(root)\n      // The loader's path starts where the session does and cannot climb out:\n      // Claude Code refuses a `..` in it.\n      if (relative(folder, packageRoot()).startsWith('..')) {\n        process.stderr.write(`${folder} does not hold ${packageRoot()}: a loader there could not reach the skill's text\\n`)\n        return 1\n      }\n      const path = loaderPath(folder)\n      mkdirSync(dirname(path), { recursive: true })\n      writeFileSync(path, loaderText(folder, packageRoot()), 'utf8')\n      process.stdout.write(`${path}: the Claude skill, read from ${packageRoot()}\\n`)\n      const settings = settingsWithSearch(folder)\n      if (settings) {\n        writeFileSync(settingsPath(folder), settings, 'utf8')\n        process.stdout.write(`${settingsPath(folder)}: the search allowed without a prompt\\n`)\n      }\n      return 0\n    }\n\n    default:\n      process.stderr.write('estiva-ui <find | build | check | skill>\\n')\n      return 1\n  }\n}\n\ntry {\n  process.exitCode = await main()\n} catch (error) {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exitCode = 1\n}\n", "/// <reference types=\"node\" />\n/**\n * The apps beside this one, found rather than named (UIG-20).\n *\n * `estiva-ui find` with nothing else typed searches the package, the app it is\n * run in, and every app that sits beside it. Katerina's condition for having no\n * shared Storybook is that one search, run unasked from any repository, covers\n * every catalogue; a list of names written into each repository's script would\n * be the drifting copy the gates exist to remove, and would miss the next app.\n *\n * An app is a folder, or one folder inside it, whose `package.json` depends on\n * `@estiva-app/ui` and which has a `src` to read. A service that does not\n * install the package is not an app of this catalogue until it does.\n *\n * Each app is searched once. A second checkout of the same app (a worktree, or\n * somebody's copy) carries the same package name; the app the search runs in\n * wins, then the one whose top folder has the shortest name.\n */\nimport { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'\nimport { basename, dirname, join, resolve } from 'node:path'\n\nexport const PACKAGE_NAME = '@estiva-app/ui'\n\nexport interface Sibling {\n  /** What its entries are called: its top folder's name. */\n  name: string\n  /** The folder the catalogue is built from. */\n  folder: string\n  /** Its `package.json` name, which says two checkouts are one app. */\n  packageName: string\n}\n\nfunction manifest(folder: string): { name?: string; dependencies?: Record<string, string>; devDependencies?: Record<string, string> } | null {\n  const file = join(folder, 'package.json')\n  if (!existsSync(file)) return null\n  try {\n    return JSON.parse(readFileSync(file, 'utf8'))\n  } catch {\n    return null\n  }\n}\n\n/** The name of the app in `folder`, or null when the folder is not one. */\nexport function appName(folder: string): string | null {\n  const m = manifest(folder)\n  if (!m || m.name === PACKAGE_NAME) return null\n  const uses = Boolean(m.dependencies?.[PACKAGE_NAME] ?? m.devDependencies?.[PACKAGE_NAME])\n  return uses && existsSync(join(folder, 'src')) ? (m.name ?? basename(folder)) : null\n}\n\nconst isDir = (path: string) => {\n  try {\n    return statSync(path).isDirectory()\n  } catch {\n    return false\n  }\n}\n\n/**\n * The folder that holds the repositories: the parent of the repository `from`\n * is in, or `from` itself when it is in none (a folder that only holds them).\n */\nexport function workspaceOf(from: string): string {\n  let at = resolve(from)\n  for (;;) {\n    if (existsSync(join(at, '.git'))) return dirname(at)\n    const up = dirname(at)\n    if (up === at) return resolve(from)\n    at = up\n  }\n}\n\n/** Every app in `workspace`, one per package name, except those named in `skip`. */\nexport function findSiblings(workspace: string, { skip = [] }: { skip?: string[] } = {}): Sibling[] {\n  let tops: string[]\n  try {\n    tops = readdirSync(workspace).filter((name) => !name.startsWith('.') && name !== 'node_modules' && isDir(join(workspace, name)))\n  } catch {\n    return []\n  }\n  const found: Sibling[] = []\n  for (const top of tops) {\n    const folder = join(workspace, top)\n    const inside = readdirSync(folder).filter((name) => !name.startsWith('.') && name !== 'node_modules' && isDir(join(folder, name)))\n    for (const candidate of [folder, ...inside.map((name) => join(folder, name))]) {\n      const packageName = appName(candidate)\n      if (packageName) found.push({ name: top, folder: candidate, packageName })\n    }\n  }\n  const byPackage = new Map<string, Sibling>()\n  for (const sibling of found.sort((a, b) => a.name.length - b.name.length || a.name.localeCompare(b.name))) {\n    if (skip.includes(sibling.packageName) || byPackage.has(sibling.packageName)) continue\n    byPackage.set(sibling.packageName, sibling)\n  }\n  return [...byPackage.values()].sort((a, b) => a.name.localeCompare(b.name))\n}\n", "/// <reference types=\"node\" />\n/**\n * The Claude skill (UIG-20): search the catalogue before building anything.\n *\n * Its text lives once, in this package, as `skill/estiva-ui.md` (Katerina,\n * 17 September 2026: the same gate text pasted into two repositories is a\n * defect). Claude Code only loads a skill from a `SKILL.md` under a folder's\n * `.claude/skills/`, and no plugin source can point into `node_modules`, so each\n * repository commits a loader: the trigger below, and one line that reads the\n * installed package's text into the skill when it opens (`` !`\u2026` `` runs before\n * Claude sees the skill). `estiva-ui skill` writes it; `estiva-ui check` fails\n * when a repository's loader is missing or is not what this writes.\n *\n * Measured with fresh sessions of Claude Code 2.1.215 (UIG-20), three things\n * shape that line and the settings beside it:\n *\n * - An injected command runs without a prompt only when Claude Code can read it\n *   statically as read-only: a plain `cat` of a plain path. A path with `..`\n *   (\"may follow a symlink outside the working directory\"), a `$(\u2026)`, or a\n *   `node -e` are all refused, and a refused command stops the skill opening.\n *   So the path starts at `${CLAUDE_PROJECT_DIR}`, the folder the session\n *   started in, as the editor gate's hook does: a session started above or\n *   below the repository gets neither.\n * - An `allowed-tools` line makes opening the skill itself ask for permission\n *   (\"Execute skill\"). So the search is allowed in the repository's committed\n *   `.claude/settings.json` instead, and the skill carries no `allowed-tools`.\n * - Claude reads a skill's description before it opens the skill, so the\n *   trigger is written into the loader; it is the one part that cannot be\n *   pulled in later.\n */\nimport { existsSync, readFileSync } from 'node:fs'\nimport { dirname, join, relative, resolve, sep } from 'node:path'\n\nexport const SKILL_NAME = 'estiva-ui'\n\n/** When Claude opens the skill by itself. Kept under Claude Code's 1,536 characters. */\nexport const SKILL_DESCRIPTION =\n  'Use before building, adding or changing anything on screen in an app that uses @estiva-app/ui, or in @estiva-app/ui itself: ' +\n  'a screen, panel, list, row, header, dialog, menu, empty state, a new component, or how something looks. ' +\n  'Also when someone asks for a component in plain words (\"I need a\u2026\", \"add a\u2026\", \"is there a\u2026\"). ' +\n  \"It searches every catalogue at once, the package's and each app's Storybook, for a part that already does the job, \" +\n  'and lists the mistakes this codebase keeps making.'\n\n/** The search, allowed without a prompt in the folder's committed `.claude/settings.json`. */\nexport const SEARCH_RULES = ['Bash(npm run ui:find *)', 'Bash(npm --prefix * run ui:find *)', 'PowerShell(npm run ui:find *)', 'PowerShell(npm --prefix * run ui:find *)']\n\n/** The skill's text, inside a package folder. */\nexport const skillTextPath = (packageRoot: string) => join(packageRoot, 'skill', `${SKILL_NAME}.md`)\n\n/** Where a folder keeps its loader. */\nexport const loaderPath = (folder: string) => join(folder, '.claude', 'skills', SKILL_NAME, 'SKILL.md')\n\n/** Where a folder keeps the settings that allow the search. */\nexport const settingsPath = (folder: string) => join(folder, '.claude', 'settings.json')\n\n/** The loader for `folder`, reading the text from `packageRoot`, from where a session in `folder` starts. */\nexport function loaderText(folder: string, packageRoot: string): string {\n  const fromTop = relative(folder, skillTextPath(packageRoot)).split(sep).join('/')\n  return [\n    '---',\n    `name: ${SKILL_NAME}`,\n    `description: ${JSON.stringify(SKILL_DESCRIPTION)}`,\n    '---',\n    '',\n    '<!-- Written by `estiva-ui skill` from @estiva-app/ui; `estiva-ui check` fails when it differs. The text is the installed package\u2019s, read in below. -->',\n    '',\n    `!\\`cat \"\\${CLAUDE_PROJECT_DIR}/${fromTop}\"\\``,\n    '',\n  ].join('\\n')\n}\n\ntype Settings = { permissions?: { allow?: string[] } & Record<string, unknown> } & Record<string, unknown>\n\nconst readSettings = (folder: string): Settings | null => {\n  const path = settingsPath(folder)\n  if (!existsSync(path)) return {}\n  try {\n    return JSON.parse(readFileSync(path, 'utf8')) as Settings\n  } catch {\n    return null\n  }\n}\n\n/** `folder`'s settings with the search allowed, everything else as it was; null when they cannot be read. */\nexport function settingsWithSearch(folder: string): string | null {\n  const settings = readSettings(folder)\n  if (!settings) return null\n  const allow = settings.permissions?.allow ?? []\n  const missing = SEARCH_RULES.filter((rule) => !allow.includes(rule))\n  if (!missing.length && existsSync(settingsPath(folder))) return null\n  settings.permissions = { ...settings.permissions, allow: [...allow, ...missing] }\n  return `${JSON.stringify(settings, null, 2)}\\n`\n}\n\n/** The repository `from` is in: the nearest folder with `.git`, or `from` when there is none. */\nexport function repositoryOf(from: string): string {\n  let at = resolve(from)\n  for (;;) {\n    if (existsSync(join(at, '.git'))) return at\n    const up = dirname(at)\n    if (up === at) return resolve(from)\n    at = up\n  }\n}\n\n/** What is wrong with `folder`'s loader, or null when it is what `loaderText` writes. */\nexport function loaderProblem(folder: string, packageRoot: string): string | null {\n  const path = loaderPath(folder)\n  const shown = relative(process.cwd(), path).split(sep).join('/') || path\n  if (!existsSync(path)) return `${shown} is missing: run \"estiva-ui skill\" and commit it`\n  if (readFileSync(path, 'utf8').replace(/\\r\\n/g, '\\n') !== loaderText(folder, packageRoot)) return `${shown} is not what the package writes: run \"estiva-ui skill\" and commit it`\n  if (!existsSync(skillTextPath(packageRoot))) return `${shown} reads ${skillTextPath(packageRoot)}, which is not there`\n  const allow = readSettings(folder)?.permissions?.allow ?? []\n  const missing = SEARCH_RULES.filter((rule) => !allow.includes(rule))\n  if (missing.length) return `.claude/settings.json does not allow the search (${missing.join(', ')}): run \"estiva-ui skill\" and commit it`\n  return null\n}\n"],
+  "mappings": "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",
+  "names": ["existsSync", "readFileSync", "basename", "dirname", "join", "relative", "resolve", "existsSync", "readFileSync", "dirname", "join", "resolve", "packageRoot", "resolve", "readFileSync", "existsSync", "join", "basename", "serializeRegistry", "registry", "linked", "shown", "loaded", "relative", "dirname"]
 }

package/dist/registry/find.d.ts

@@ -43,6 +43,11 @@ export declare function findInRegistry(registry: Registry, query: string, { limi
  * An app's pass-on is not a result of its own — it is the package's part, and
  * the package's entry answers for it, saying which apps hand it on. At the
  * same strength the package's part comes first: it is the one to reach for.
+ * And a package part whose name carries one of the words comes before an app's
+ * part answering as many words, whatever each scored: "panel header" put an
+ * app's own `Header`, whose whole name is one of the words, above the package's
+ * `ContainerHeader` (UIG-20). Only by name: a package part the words reach
+ * through its notes alone would bury the app part that is the answer.
  */
 export declare function findInRegistries(registries: Registry[], query: string, { limit }?: {
     limit?: number;

package/dist/registry/find.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/registry/find.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAEvD,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,aAAa,CAAA;IACpB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,KAAK,EAAE,MAAM,EAAE,CAAA;IACf;;;;;OAKG;IACH,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAoDD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAS,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,EAAE,CAEnH;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAS,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,EAAE,CAmEzH;AAED,yGAAyG;AACzG,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAGhF;AAUD,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgD1G"}
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/registry/find.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAEvD,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,aAAa,CAAA;IACpB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,KAAK,EAAE,MAAM,EAAE,CAAA;IACf;;;;;OAKG;IACH,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAoDD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAS,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,EAAE,CAEnH;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAS,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,EAAE,CAuEzH;AAED,yGAAyG;AACzG,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAGhF;AAUD,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAgD1G"}

package/dist/registry/index.js

@@ -10,7 +10,7 @@ import {
   hasSeenIn,
   linkProblems,
   pageProblem
-} from "./chunk-6OH3TWGF.js";
+} from "./chunk-KMZIMB3G.js";
 import {
   buildAppRegistry
 } from "./chunk-XCBN2EKW.js";

package/dist/registry/siblings.d.ts

@@ -0,0 +1,21 @@
+export declare const PACKAGE_NAME = "@estiva-app/ui";
+export interface Sibling {
+    /** What its entries are called: its top folder's name. */
+    name: string;
+    /** The folder the catalogue is built from. */
+    folder: string;
+    /** Its `package.json` name, which says two checkouts are one app. */
+    packageName: string;
+}
+/** The name of the app in `folder`, or null when the folder is not one. */
+export declare function appName(folder: string): string | null;
+/**
+ * The folder that holds the repositories: the parent of the repository `from`
+ * is in, or `from` itself when it is in none (a folder that only holds them).
+ */
+export declare function workspaceOf(from: string): string;
+/** Every app in `workspace`, one per package name, except those named in `skip`. */
+export declare function findSiblings(workspace: string, { skip }?: {
+    skip?: string[];
+}): Sibling[];
+//# sourceMappingURL=siblings.d.ts.map

package/dist/registry/siblings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"siblings.d.ts","sourceRoot":"","sources":["../../src/registry/siblings.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,YAAY,mBAAmB,CAAA;AAE5C,MAAM,WAAW,OAAO;IACtB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAA;CACpB;AAYD,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKrD;AAUD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,IAAS,EAAE,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GAAG,OAAO,EAAE,CAsBlG"}

package/dist/registry/skill.d.ts

@@ -0,0 +1,20 @@
+export declare const SKILL_NAME = "estiva-ui";
+/** When Claude opens the skill by itself. Kept under Claude Code's 1,536 characters. */
+export declare const SKILL_DESCRIPTION: string;
+/** The search, allowed without a prompt in the folder's committed `.claude/settings.json`. */
+export declare const SEARCH_RULES: string[];
+/** The skill's text, inside a package folder. */
+export declare const skillTextPath: (packageRoot: string) => string;
+/** Where a folder keeps its loader. */
+export declare const loaderPath: (folder: string) => string;
+/** Where a folder keeps the settings that allow the search. */
+export declare const settingsPath: (folder: string) => string;
+/** The loader for `folder`, reading the text from `packageRoot`, from where a session in `folder` starts. */
+export declare function loaderText(folder: string, packageRoot: string): string;
+/** `folder`'s settings with the search allowed, everything else as it was; null when they cannot be read. */
+export declare function settingsWithSearch(folder: string): string | null;
+/** The repository `from` is in: the nearest folder with `.git`, or `from` when there is none. */
+export declare function repositoryOf(from: string): string;
+/** What is wrong with `folder`'s loader, or null when it is what `loaderText` writes. */
+export declare function loaderProblem(folder: string, packageRoot: string): string | null;
+//# sourceMappingURL=skill.d.ts.map

package/dist/registry/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/registry/skill.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,UAAU,cAAc,CAAA;AAErC,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,QAKwB,CAAA;AAEtD,8FAA8F;AAC9F,eAAO,MAAM,YAAY,UAAiJ,CAAA;AAE1K,iDAAiD;AACjD,eAAO,MAAM,aAAa,GAAI,aAAa,MAAM,WAAmD,CAAA;AAEpG,uCAAuC;AACvC,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,WAA8D,CAAA;AAEvG,+DAA+D;AAC/D,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,WAA6C,CAAA;AAExF,6GAA6G;AAC7G,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAatE;AAcD,6GAA6G;AAC7G,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQhE;AAED,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUhF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@estiva-app/ui",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Estiva's design tokens (the contract) and a small set of primitives (a convenience) for every Estiva app.",
   "type": "module",
   "license": "MIT",
@@ -9,6 +9,7 @@
     "src",
     "stories",
     "registry.json",
+    "skill",
     "tailwind-preset.js",
     "tokens.css",
     "base.css",
@@ -65,8 +66,9 @@
     "registry": "node dist/registry/cli.js build",
     "preregistry:check": "node build.mjs",
     "registry:check": "node dist/registry/cli.js check",
+    "skill:check": "vitest run --project unit src/registry/skill.test.ts",
     "preui:find": "node build.mjs",
-    "ui:find": "node dist/registry/cli.js find --also peek=../peek --also ship=../ship/web",
+    "ui:find": "node dist/registry/cli.js find",
     "prepublishOnly": "npm run build"
   },
   "peerDependencies": {

package/registry.json

@@ -4,7 +4,7 @@
     "kind": "package",
     "repo": "estiva-ui",
     "package": "@estiva-app/ui",
-    "packageVersion": "0.28.0",
+    "packageVersion": "0.29.0",
     "exports": 87,
     "typeExports": 96,
     "files": null