youiyoux 0.1.3 → 0.1.5

package/dist/chunks/{chunk-RTOTNSOV.js → chunk-5QRDHWK5.js}

@@ -1,35 +1,4 @@
-import { createRequire as __youiRequire } from "node:module"; const require = __youiRequire(import.meta.url);
-import {
-  EXPORT_TYPES,
-  LIBRARY_BY_ID,
-  buildReport,
-  detectRepo,
-  elementTypes,
-  libraryOfPackage,
-  packageOf,
-  playwrightCli
-} from "./chunk-74KBRI2H.js";
-import {
-  candidateSource,
-  checkpointSqlite,
-  cleanData,
-  discoverCacheDir,
-  discoverIndexPath,
-  expandAll,
-  indexHome,
-  ingestCatalog,
-  inventoryRun,
-  linkCandidates,
-  openSqlite,
-  projectGraph,
-  readCatalog,
-  searchCatalog,
-  selectSources,
-  sharedStore,
-  showFromCatalog,
-  storeLocation,
-  syncIndex
-} from "./chunk-UEB6MJDX.js";
+import { createRequire as __youiRequire } from "node:module"; import { dirname as __youiDir } from "node:path"; import { fileURLToPath as __youiPath } from "node:url"; const require = __youiRequire(import.meta.url); const __youiDirname = __youiDir(__youiPath(import.meta.url));
 import {
   BASELINE_FILE,
   DEFAULT_EXCLUDE,
@@ -40,15 +9,13 @@ import {
   adoptionRequest,
   buildInventory,
   buildTheme,
-  buildTokens,
   captureScreens,
   captureText,
   checkCapabilities,
-  compareParity,
+  chosenSession,
   compareToBaseline,
   componentCard,
   createBaseline,
-  cssValue,
   describeIdentity,
   evaluateRule,
   failedChecks,
@@ -62,26 +29,68 @@ import {
   loadProject,
   nearDuplicates,
   offLibraryImports,
-  parseCssColor,
+  openLoginBrowser,
   parseModule,
   planChange,
   ratchetBaseline,
   readStylesheet,
+  recordSession,
   renderShots,
   ruleCapability,
   runMigration,
   scanProject,
   screenBom,
   searchLibrary,
+  sessionFile,
   shotsNext,
   shotsText,
   substituteVars,
   vendoredPath,
   whereUsed
-} from "./chunk-L5BV4PI7.js";
+} from "./chunk-VG3ZCSST.js";
 import {
   within
-} from "./chunk-S7UV34H5.js";
+} from "./chunk-42YJX3W5.js";
+import {
+  EXPORT_TYPES,
+  LIBRARY_BY_ID,
+  buildReport,
+  detectRepo,
+  elementTypes,
+  libraryOfPackage,
+  packageOf,
+  playwrightCli
+} from "./chunk-4BBYLTZX.js";
+import {
+  MissingIndexError,
+  buildGaps,
+  candidateSource,
+  checkpointSqlite,
+  cleanData,
+  declaredPackages,
+  discoverCacheDir,
+  discoverIndexPath,
+  expandAll,
+  indexHome,
+  ingestCatalog,
+  inventoryRun,
+  linkCandidates,
+  openSqlite,
+  projectGraph,
+  readCatalog,
+  searchCatalog,
+  selectSources,
+  sharedStore,
+  showFromCatalog,
+  storeLocation,
+  syncIndex
+} from "./chunk-M5XZWCPS.js";
+import {
+  buildTokens,
+  compareParity,
+  cssValue,
+  parseCssColor
+} from "./chunk-YJ7WMBTT.js";
 import {
   Baseline,
   DefinitionError,
@@ -106,48 +115,27 @@ import {
   relPath,
   renderJsonSchemas,
   require_dist,
+  ruleSlug,
   safeId,
   sha256,
   shortHash,
+  toPosix,
   writeFileAtomic
-} from "./chunk-C3TSTYP7.js";
+} from "./chunk-NYDJYMID.js";
 import {
   __toESM
-} from "./chunk-E4HNK7VF.js";
-
-// src/node20.js
-if (!Map.groupBy) {
-  Map.groupBy = (items, key2) => {
-    const groups = /* @__PURE__ */ new Map();
-    let i = 0;
-    for (const item of items) {
-      const k = key2(item, i++);
-      const list = groups.get(k);
-      if (list) list.push(item);
-      else groups.set(k, [item]);
-    }
-    return groups;
-  };
-}
-if (!Object.groupBy) Object.groupBy = (items, key2) => Object.fromEntries(Map.groupBy(items, key2));
-if (!Promise.withResolvers) {
-  Promise.withResolvers = () => {
-    let resolve13, reject;
-    const promise = new Promise((yes, no) => (resolve13 = yes, reject = no));
-    return { promise, resolve: resolve13, reject };
-  };
-}
+} from "./chunk-WNTS7ZO4.js";
 
 // ../cli/src/main.ts
 var import_yaml3 = __toESM(require_dist(), 1);
-import { execFile as execFile6 } from "node:child_process";
-import { existsSync as existsSync4 } from "node:fs";
+import { execFile as execFile5 } from "node:child_process";
+import { existsSync as existsSync5 } from "node:fs";
 import { appendFile as appendFile2, readFile as readFile8 } from "node:fs/promises";
-import { basename as basename3, join as join22, relative as relative9, resolve as resolve12 } from "node:path";
-import { parseArgs, promisify as promisify6 } from "node:util";
+import { basename as basename3, dirname as dirname11, join as join22, relative as relative8, resolve as resolve12 } from "node:path";
+import { parseArgs, promisify as promisify5 } from "node:util";
 
 // ../cli/src/check.ts
-import { dirname as dirname3, join as join7, relative as relative4, resolve as resolve2, sep as sep2 } from "node:path";
+import { dirname as dirname3, join as join7, resolve as resolve2 } from "node:path";
 
 // ../cli/src/check-diff.ts
 import { execFile } from "node:child_process";
@@ -161,7 +149,7 @@ import { join as join2, relative, resolve } from "node:path";
 
 // ../cli/src/command.ts
 var COMMAND = "youiyoux";
-var SUBCOMMANDS = ["show", "where", "bom", "check", "baseline", "rules", "plan", "migrate", "init", "sync", "scan", "watch", "hooks", "agents", "mcp", "ui", "library", "discover", "index", "report", "render", "screens", "requests", "detect", "build", "parity", "schema", "inventory", "help"];
+var SUBCOMMANDS = ["show", "where", "bom", "check", "baseline", "rules", "plan", "migrate", "init", "sync", "scan", "watch", "hooks", "agents", "mcp", "ui", "library", "discover", "index", "report", "render", "screens", "requests", "detect", "build", "parity", "schema", "inventory", "gaps", "help"];
 
 // ../cli/src/agents.ts
 var import_yaml = __toESM(require_dist(), 1);
@@ -191,10 +179,9 @@ function viaNpx(text, root) {
   return text.replace(BARE, `${portableYoui(root).run} `);
 }
 function diffInstruction(root) {
-  const { run: run8, setup } = portableYoui(root);
-  return `- ${setup} After UI edits, run \`${run8} check --diff\` (\`--json\` for data): it lists what your change adds that near-duplicates an existing component, hardcodes a value a token holds, or imports an element from a library other than the project's choice, each with its fix. Apply each fix.`;
+  const { run: run7, setup } = portableYoui(root);
+  return `- ${setup} After UI edits, run \`${run7} check --diff\` (\`--json\` for data): it lists what your change adds that near-duplicates an existing component, hardcodes a value a token holds, or imports an element from a library other than the project's choice, each with its fix. Apply each fix.`;
 }
-var DIFF_INSTRUCTION = diffInstruction();
 function repoAgentsBlock(root) {
   return viaNpx([BLOCK_BEGIN, REPO_BLOCK_HEADING, "", diffInstruction(root), "- Run `youiyoux init --design <dir>` to connect design-system rules; repository inference works without it.", BLOCK_END].join("\n"), root);
 }
@@ -234,7 +221,7 @@ function agentsBlock(project2) {
     `- Never edit files marked \`${GENERATED_MARK}\` (\`${config.outputs.dir}/*\`, ${config.agents.designMd}, the youiyoux skill). Change the design language and run \`youiyoux sync\`.`,
     `- Owned component files in \`${config.componentsDir}\` may be edited; \`youiyoux sync\` 3-way merges upstream changes into them and reports drift.`,
     "- After changing a component, call `ui_render` with its file (or run `youiyoux render <file>`) and look at the images: light and dark, desktop and phone, its accessibility issues and the diff against the base. Fix what it reports.",
-    "- People pin comments and change requests to components on captured screens. Before UI work, call `requests_list` (or run `youiyoux requests`); after making a requested change, capture its screen again (`youiyoux screens capture --base <app> --route <route>`) and call `request_addressed` with what you changed (file:line). Ask with `request_reply` when one is unclear. A person closes requests, never an agent.",
+    "- People pin comments and change requests to components on captured screens. Before UI work, call `requests_list` (or run `youiyoux requests`); after making a requested change, capture its screen again (`screens_capture` with its route, or `youiyoux screens capture --base <app> --route <route>`) and call `request_addressed` with what you changed (file:line). Ask with `request_reply` when one is unclear. A person closes requests, never an agent.",
     "- Before you finish, run `youiyoux check`; it must report 0 errors.",
     diffInstruction(project2.root),
     "- To change the System itself (a token, a prop, a rule), run `youiyoux plan` (or `system_plan`) and propose it. Agents never approve, publish or merge design changes.",
@@ -302,7 +289,7 @@ function frontmatter(project2, build) {
     colors,
     typography,
     rounded: dims("radius"),
-    spacing: Object.fromEntries(Object.entries(dims("space"))),
+    spacing: dims("space"),
     components
   };
 }
@@ -346,7 +333,7 @@ function skillMd(project2, uncontracted = []) {
   const from = importHint(config);
   const description = `Build and fix UI with the ${system.config.name} design language (YouIyouX): System components, tokens, rules, where-used lookups, change proposals and Library adoption requests. Use for any UI, styling, colour or component work in this project.`;
   const components = system.components.map(({ contract }) => `- **${contract.name}**: ${contract.summary}${enumSummary(contract) ? ` (${enumSummary(contract)})` : ""}`);
-  const fixes = enforced(system.rules).map((r) => `| \`${r.id.split("/rule/")[1]}\` | ${r.severity} | ${r.agent} |`);
+  const fixes = enforced(system.rules).map((r) => `| \`${ruleSlug(r.id)}\` | ${r.severity} | ${r.agent} |`);
   return viaNpx([
     "---",
     "name: youiyoux",
@@ -412,22 +399,15 @@ function astGrepRules(project2) {
 # Portable subset: youiyoux check also resolves imports; these run with plain \`ast-grep scan -r <file>\`.
 `;
   for (const rule2 of enforced(project2.system.rules)) {
-    if (rule2.check.engine === "ast-grep") {
-      out.push({ file: `${rule2.id.split("/rule/")[1]}.yml`, content: header + (0, import_yaml.stringify)({ id: rule2.id, language: rule2.check.language, severity: rule2.severity === "error" ? "error" : "warning", message: rule2.title, note: rule2.agent, rule: rule2.check.rule }) });
-    }
+    const entry = (language, rest) => ({ file: `${ruleSlug(rule2.id)}.yml`, content: header + (0, import_yaml.stringify)({ id: rule2.id, language, severity: rule2.severity === "error" ? "error" : "warning", message: rule2.title, note: rule2.agent, ...rest }) });
+    if (rule2.check.engine === "ast-grep") out.push(entry(rule2.check.language, { rule: rule2.check.rule }));
     if (rule2.check.engine === "youi" && rule2.check.id === "native-element") {
       const tags = Object.keys(rule2.check.options.elements ?? {});
       const regex = `^(${tags.join("|")})$`;
-      out.push({
-        file: `${rule2.id.split("/rule/")[1]}.yml`,
-        content: header + (0, import_yaml.stringify)({ id: rule2.id, language: "tsx", severity: rule2.severity === "error" ? "error" : "warning", message: rule2.title, note: rule2.agent, ignores: [`${project2.config.componentsDir}/**`], rule: { any: [{ kind: "jsx_opening_element", has: { field: "name", regex } }, { kind: "jsx_self_closing_element", has: { field: "name", regex } }] } })
-      });
+      out.push(entry("tsx", { ignores: [`${project2.config.componentsDir}/**`], rule: { any: [{ kind: "jsx_opening_element", has: { field: "name", regex } }, { kind: "jsx_self_closing_element", has: { field: "name", regex } }] } }));
     }
     if (rule2.check.engine === "youi" && rule2.check.id === "raw-color") {
-      out.push({
-        file: `${rule2.id.split("/rule/")[1]}.yml`,
-        content: header + (0, import_yaml.stringify)({ id: rule2.id, language: "tsx", severity: rule2.severity === "error" ? "error" : "warning", message: rule2.title, note: rule2.agent, rule: { kind: "string_fragment", regex: "(\\[#[0-9a-fA-F]{3,8}\\]|^#[0-9a-fA-F]{3,8}$|rgba?\\()", inside: { kind: "jsx_attribute", stopBy: "end" } } })
-      });
+      out.push(entry("tsx", { rule: { kind: "string_fragment", regex: "(\\[#[0-9a-fA-F]{3,8}\\]|^#[0-9a-fA-F]{3,8}$|rgba?\\()", inside: { kind: "jsx_attribute", stopBy: "end" } } }));
     }
   }
   return out;
@@ -478,8 +458,7 @@ async function initProject(options) {
     }
   }
   notes.push(`owned components: ${componentsDir}`);
-  const tsconfig = await exists(join2(root, "tsconfig.json")) ? "tsconfig.json" : "tsconfig.json";
-  const alias = await aliasRoot(root, tsconfig);
+  const alias = await aliasRoot(root);
   const importFrom = alias !== void 0 && componentsDir.startsWith(alias) ? `@/${componentsDir.slice(alias.length)}` : void 0;
   if (importFrom) notes.push(`imports use the @/ alias: ${importFrom}`);
   const include = (await Promise.all(
@@ -627,7 +606,6 @@ async function stagedChange(project2) {
   for (const file of added.keys()) sources[file] = await git(root, ["show", `:${prefix}${file}`]);
   return { base: "HEAD (staged changes)", commit: head, added, sources };
 }
-var slugOf = (rule2) => rule2.slice(rule2.indexOf("/rule/") + 6);
 var DRIFT_SEVERITY = { "near-duplicate": "warn", "hardcoded-value": "error", "off-library": "error" };
 async function importOf(project2) {
   const alias = await aliasRoot(project2.root, project2.config.tsconfig);
@@ -658,9 +636,9 @@ async function chosenLibraries(project2, added, notes) {
     notes.push(`imports were compared only with the System's components (${error instanceof Error ? error.message : String(error)})`);
     return chosen;
   }
-  const outside = hits.filter((hit) => (hit.where ?? []).some((where) => {
-    const at = where.lastIndexOf(":");
-    return !isAdded(added, where.slice(0, at), Number(where.slice(at + 1)));
+  const outside = hits.filter((hit) => (hit.where ?? []).some((where2) => {
+    const at = where2.lastIndexOf(":");
+    return !isAdded(added, where2.slice(0, at), Number(where2.slice(at + 1)));
   }));
   const byType = /* @__PURE__ */ new Map();
   for (const hit of outside) {
@@ -730,11 +708,11 @@ async function analyseChange(project2, scan, change, options) {
     const merged = findings2.findIndex((f, i) => f.kind !== "rule" && samePlace(f, violation) && sameText(drift[i]?.text ?? "", violation.text));
     if (merged >= 0) {
       const into = findings2[merged];
-      findings2[merged] = { ...into, rule: slugOf(violation.rule), severity: violation.severity === "error" ? "error" : into.severity };
+      findings2[merged] = { ...into, rule: ruleSlug(violation.rule), severity: violation.severity === "error" ? "error" : into.severity };
       continue;
     }
-    const fix = violation.suggestion ?? rules.get(violation.rule)?.agent ?? `see \`youiyoux rules\` for ${slugOf(violation.rule)}`;
-    findings2.push({ kind: "rule", file: violation.file, line: violation.line, column: violation.column, message: violation.message, fix, severity: violation.severity, rule: slugOf(violation.rule) });
+    const fix = violation.suggestion ?? rules.get(violation.rule)?.agent ?? `see \`youiyoux rules\` for ${ruleSlug(violation.rule)}`;
+    findings2.push({ kind: "rule", file: violation.file, line: violation.line, column: violation.column, message: violation.message, fix, severity: violation.severity, rule: ruleSlug(violation.rule) });
   }
   findings2.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.column - b.column);
   return { base: change.base, commit: change.commit, files, findings: findings2, notes, incomplete };
@@ -751,7 +729,6 @@ import { promisify as promisify2 } from "node:util";
 import { dirname, join as join4 } from "node:path";
 import { createRequire } from "node:module";
 var TOOL_ROOT = join4(dirname(createRequire(import.meta.url).resolve("youiyoux/package.json")), "dist");
-var CLI_BIN = join4(TOOL_ROOT, "packages/cli/bin/youi.js");
 
 // ../cli/src/tool-command.ts
 import { join as join5, relative as relative2, isAbsolute as isAbsolute2 } from "node:path";
@@ -1039,7 +1016,7 @@ async function verifyWiring(project2) {
 }
 
 // ../cli/src/check.ts
-var toProjectPath = (project2, file) => relative4(project2.root, resolve2(file)).split(sep2).join("/");
+var toProjectPath = (project2, file) => relPath(project2.root, resolve2(file));
 function baselinePath(project2, configPath) {
   return join7(dirname3(resolve2(configPath ?? project2.configFile ?? join7(project2.root, PROJECT_FILE))), BASELINE_FILE);
 }
@@ -1059,7 +1036,7 @@ async function runCheck(project2, options = {}) {
   const wantedRule = (id) => !options.rule || id.endsWith(`/rule/${options.rule}`);
   const violations = report.violations.filter((v) => wantedRule(v.rule) && (!options.quiet || v.severity === "error"));
   const notRun = failedChecks(report.checks).filter((c) => wantedRule(c.rule));
-  const lock = options.lock === false || diff && options.lock !== true ? null : await lockIssues(project2);
+  const lock = options.lock === false || diff ? null : await lockIssues(project2);
   const recorded = options.baseline ? await readBaseline(options.baseline) : null;
   if (options.baseline && !recorded) throw new Error(`no baseline at ${options.baseline}; record one with \`youiyoux baseline\``);
   const baseline = recorded && options.baseline ? { file: options.baseline, recorded: recorded.identity, comparison: compareToBaseline(recorded, violations, scope ?? void 0) } : null;
@@ -1077,7 +1054,7 @@ var diffExitCodeOf = (result, strict) => strict && ((result.diff?.findings.lengt
 async function writeBaseline(project2, file, options = {}) {
   const scan = await scanProject(project2, options.cache ? { cache: options.cache } : {});
   if (scan.report.status !== "complete" && !options.force) {
-    const gaps = [...scan.report.coverage.failed.map((f) => f.file), ...failedChecks(scan.report.checks).map((c) => `rule ${c.rule.split("/rule/")[1]}`)];
+    const gaps = [...scan.report.coverage.failed.map((f) => f.file), ...failedChecks(scan.report.checks).map((c) => `rule ${ruleSlug(c.rule)}`)];
     throw new Error(`the scan is partial (${gaps.join(", ")}): findings there would later look new. Fix what could not be analysed or run, or record anyway with --force`);
   }
   const existing = await readBaseline(file);
@@ -1091,23 +1068,208 @@ async function writeBaseline(project2, file, options = {}) {
 }
 
 // ../cli/src/check-repo.ts
+import { readFile as readFile3 } from "node:fs/promises";
+import { dirname as dirname5, join as join9, resolve as resolve4 } from "node:path";
+
+// ../cli/src/hooks-install.ts
 import { execFile as execFile3 } from "node:child_process";
-import { access as access2, readFile as readFile3 } from "node:fs/promises";
-import { dirname as dirname4, join as join8, resolve as resolve3 } from "node:path";
+import { chmod, mkdir as mkdir2, realpath as realpath2 } from "node:fs/promises";
+import { dirname as dirname4, join as join8, relative as relative4, resolve as resolve3 } from "node:path";
 import { promisify as promisify3 } from "node:util";
 var run3 = promisify3(execFile3);
-var exists2 = (file) => access2(file).then(() => true, () => false);
+var CLAUDE_MARKER = "hooks run claude";
+var BLOCK_START = "# >>> youi pre-commit >>>";
+var BLOCK_END2 = "# <<< youi pre-commit <<<";
+var WORKFLOW = ".github/workflows/youi-check.yml";
+var WORKFLOW_HEADER = "# Generated by `youiyoux hooks install --ci`.";
+var LEGACY_WORKFLOW_HEADER = WORKFLOW_HEADER.replace("youiyoux", "youi");
+var managedWorkflow = (text) => text.startsWith(WORKFLOW_HEADER) || text.startsWith(LEGACY_WORKFLOW_HEADER);
+var DIFF_STEP = "name: youiyoux check --diff";
+var CLAUDE_MATCHER = "Edit|Write|MultiEdit";
+var CLAUDE_TIMEOUT_S = 60;
+var shellQuote = (arg) => /^[\w@%+=:,./-]+$/.test(arg) ? arg : `'${arg.replace(/'/g, `'\\''`)}'`;
+async function gitOut(cwd, args) {
+  return (await run3("git", [...args], { cwd })).stdout.trim();
+}
+async function repoRootOf(dir) {
+  return gitOut(dir, ["rev-parse", "--show-toplevel"]).catch(() => dir);
+}
+function hookCommand(toolRoot, kind, target, extra = []) {
+  const server = toolCommand(toolRoot);
+  const args = [server.command, ...server.args, "hooks", "run", kind];
+  for (const key2 of ["project", "config", "design", "root"]) {
+    const value = target[key2];
+    if (value) args.push(`--${key2}`, resolve3(value));
+  }
+  return [...args, ...extra].map(shellQuote).join(" ");
+}
+async function write(file, content, before, guarantee, mode) {
+  if (before === content) return { file, action: "unchanged", guarantee };
+  await mkdir2(dirname4(file), { recursive: true });
+  await writeFileAtomic(file, content);
+  if (mode !== void 0) await chmod(file, mode);
+  return { file, action: before === null ? "created" : "updated", guarantee };
+}
+var isYouiEntry = (entry) => (entry.hooks ?? []).some((h) => typeof h.command === "string" && h.command.includes(CLAUDE_MARKER));
+async function installClaudeHook(repoRoot, command2) {
+  const file = join8(repoRoot, ".claude/settings.local.json");
+  const before = await readTextOrNull(file);
+  let settings;
+  try {
+    settings = before === null ? {} : JSON.parse(before);
+  } catch {
+    throw new Error(`${file} is not valid JSON; fix it first (youi will not overwrite it)`);
+  }
+  const hooks = settings.hooks ?? {};
+  const existing = hooks.PostToolUse ?? [];
+  const entry = { matcher: CLAUDE_MATCHER, hooks: [{ type: "command", command: command2, timeout: CLAUDE_TIMEOUT_S }] };
+  const postToolUse = existing.some(isYouiEntry) ? existing.map((e) => isYouiEntry(e) ? entry : e) : [...existing, entry];
+  const next2 = { ...settings, hooks: { ...hooks, PostToolUse: postToolUse } };
+  return write(file, `${JSON.stringify(next2, null, 2)}
+`, before, "advisory: after each Claude Code Edit/Write/MultiEdit, that file's new violations go back to Claude; never blocks; edits made any other way are not seen");
+}
+function withBlock(script, block) {
+  if (script === null) return `#!/bin/sh
+${block}
+`;
+  const start = script.indexOf(BLOCK_START);
+  const end = script.indexOf(BLOCK_END2);
+  if (start >= 0 && end > start) return `${script.slice(0, start)}${block}${script.slice(end + BLOCK_END2.length)}`;
+  return `${script.endsWith("\n") ? script : `${script}
+`}
+${block}
+`;
+}
+async function installPreCommit(projectRoot, command2, strict) {
+  const hooksDir = resolve3(projectRoot, await gitOut(projectRoot, ["rev-parse", "--git-path", "hooks"]));
+  const file = join8(hooksDir, "pre-commit");
+  const before = await readTextOrNull(file);
+  const shebang = before?.split("\n", 1)[0] ?? "";
+  if (before !== null && shebang.startsWith("#!") && !/\b(?:sh|bash|zsh|dash)\b/.test(shebang)) {
+    throw new Error(`${file} is not a shell script (${shebang}); add this line to it yourself: ${command2}`);
+  }
+  if (before !== null && /^\s*exec\s/m.test(before) && !before.includes(BLOCK_START)) {
+    throw new Error(`${file} hands off with exec, so an appended check would never run; add this line before the exec yourself: ${command2}`);
+  }
+  const what = strict ? "Blocks commits with new design-system errors" : "Advisory, never blocks";
+  const block = `${BLOCK_START}
+# ${what}: checks the staged content of staged files only; CI is authoritative.
+${command2} || exit $?
+${BLOCK_END2}`;
+  const guarantee = strict ? "blocks commits with new errors in staged files (any agent or person that commits; --no-verify skips it)" : "advisory at commit time, staged files only (any agent or person that commits; not every edit)";
+  return write(file, withBlock(before, block), before, guarantee, 493);
+}
+async function installRepoAgentInstructions(root) {
+  const file = join8(root, "AGENTS.md");
+  const before = await readTextOrNull(file);
+  const guarantee = "agents run youiyoux check --diff after UI edits; pre-commit also checks staged edits";
+  const ruled = before !== null && before.indexOf(RULE_END) > before.indexOf(RULE_BEGIN) && before.includes(RULE_BEGIN);
+  return write(file, ruled ? before : upsertBlock(before, repoAgentsBlock(root)), before, guarantee);
+}
+function codexFallback(projectRoot, agentsFile) {
+  return {
+    file: join8(projectRoot, agentsFile),
+    action: "skipped",
+    guarantee: "no post-edit hook installed (Codex documents none): Codex follows AGENTS.md, where `youiyoux sync` tells it to run `youiyoux check --diff` after UI edits, and the git pre-commit hook checks what it commits"
+  };
+}
+function githubSlug(url) {
+  const match = /github\.com[:/]([^/\s]+)\/([^/\s]+?)(?:\.git)?\/?$/.exec(url.trim());
+  return match ? `${match[1]}/${match[2]}` : null;
+}
+async function repoAt(root) {
+  const slug = githubSlug(await gitOut(root, ["remote", "get-url", "origin"]).catch(() => ""));
+  if (!slug) throw new Error(`${root} has no GitHub origin remote; the workflow needs one to check it out`);
+  return { slug, commit: await gitOut(root, ["rev-parse", "HEAD"]) };
+}
+var posix2 = (path) => toPosix(path) || ".";
+var inside = (root, path) => !relative4(root, path).startsWith("..");
+function workflowText(input) {
+  const dir = input.projectDir || ".";
+  const target = ["--project", dir, "--design", ".youi-ci/design", ...input.configPath ? ["--config", input.configPath, "--root", dir] : []];
+  const checkArgs = ["--baseline", "--format", "github", ...target].map(shellQuote).join(" ");
+  const diffArgs2 = ["--strict", "--format", "github", ...target].map(shellQuote).join(" ");
+  const diffStep = input.diff ? `      - ${DIFF_STEP} (drift this pull request adds)
+        if: \${{ !cancelled() && github.event_name == 'pull_request' }}
+        env:
+          YOUI_BASE: \${{ github.base_ref }}
+        run: node .youi-ci/tool/packages/cli/bin/youi.js check --diff "origin/$YOUI_BASE" ${diffArgs2}
+` : "";
+  return `${WORKFLOW_HEADER}
+# The authoritative design-system check: it fails on violations the baseline does not
+# accept, annotates them on the PR's lines, and states the rules version (design commit
+# and definitions digest) in the job summary. Raise the rules version by changing the
+# design ref below; YOUI_REPO_TOKEN must be able to read both repositories.
+name: youiyoux check
+on:
+  pull_request:
+  push:
+    branches: [main]
+permissions:
+  contents: read
+jobs:
+  youi-check:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4${input.diff ? "\n        with:\n          fetch-depth: 0" : ""}
+      - name: Check out youi
+        uses: actions/checkout@v4
+        with:
+          repository: ${input.tool.slug}
+          ref: ${input.tool.commit}
+          path: .youi-ci/tool
+          token: \${{ secrets.YOUI_REPO_TOKEN }}
+      - name: Check out the design rules (the rules version)
+        uses: actions/checkout@v4
+        with:
+          repository: ${input.design.slug}
+          ref: ${input.design.commit}
+          path: .youi-ci/design
+          token: \${{ secrets.YOUI_REPO_TOKEN }}
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10.13.1
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+      - run: pnpm install --frozen-lockfile --ignore-scripts
+        working-directory: .youi-ci/tool
+      - name: youiyoux check
+        run: node .youi-ci/tool/packages/cli/bin/youi.js check ${checkArgs}
+${diffStep}`;
+}
+async function installWorkflow(project2, toolRoot, target, force, options = {}) {
+  const top = await gitOut(project2.root, ["rev-parse", "--show-toplevel"]);
+  const published = ephemeralTool(toolRoot);
+  const [tool, design] = await Promise.all([published ? Promise.resolve({ slug: "npm/youiyoux", commit: "published" }) : repoAt(toolRoot), repoAt(project2.repo.root)]);
+  const configFile = resolve3(target.config ?? project2.configFile ?? join8(project2.root, PROJECT_FILE));
+  const configPath = !target.config ? null : inside(project2.repo.root, configFile) ? `.youi-ci/design/${posix2(relative4(project2.repo.root, configFile))}` : inside(top, configFile) ? posix2(relative4(top, configFile)) : null;
+  if (target.config && !configPath) throw new Error(`${configFile} is in neither this repo nor the design repo, so CI cannot read it`);
+  const file = join8(top, WORKFLOW);
+  const before = await readTextOrNull(file);
+  if (before !== null && !managedWorkflow(before) && !force) throw new Error(`${file} exists and was not written by youi; pass --force to replace it`);
+  const diff = options.diff === true || before !== null && managedWorkflow(before) && (before.includes(DIFF_STEP) || before.includes(DIFF_STEP.replace("youiyoux", "youi")));
+  const projectDir = posix2(relative4(top, await realpath2(project2.root).catch(() => project2.root)));
+  let text = workflowText({ tool, design, projectDir, configPath, diff });
+  if (published) {
+    text = text.replace(/      - name: Check out youi\n[\s\S]*?(?=      - name: Check out the design)/, "").replace(/      - run: pnpm install --frozen-lockfile --ignore-scripts\n        working-directory: .youi-ci\/tool\n/, "").replaceAll("node .youi-ci/tool/packages/cli/bin/youi.js", "npx -y youiyoux");
+  }
+  return write(file, text, before, `authoritative: ${published ? "runs the published youiyoux package; pinned to" : `pinned to ${tool.slug}@${tool.commit.slice(0, 7)} and`} rules ${design.slug}@${design.commit.slice(0, 7)}${diff ? "; pull requests also fail on drift they add (youiyoux check --diff --strict)" : ""}`);
+}
+
+// ../cli/src/check-repo.ts
 async function loadCheckProject(root, options = {}, inferTop = false) {
-  let dir = resolve3(root);
+  let dir = resolve4(root);
   if (options.configPath) return loadProject(dir, options);
   if (inferTop) {
-    for (let ancestor = dir; ; ancestor = dirname4(ancestor)) {
-      if (await exists2(join8(ancestor, PROJECT_FILE))) return loadProject(ancestor, options);
-      if (dirname4(ancestor) === ancestor) break;
+    for (let ancestor = dir; ; ancestor = dirname5(ancestor)) {
+      if (await exists(join9(ancestor, PROJECT_FILE))) return loadProject(ancestor, options);
+      if (dirname5(ancestor) === ancestor) break;
     }
-    dir = await run3("git", ["rev-parse", "--show-toplevel"], { cwd: dir }).then((r) => r.stdout.trim(), () => dir);
+    dir = await repoRootOf(dir);
   }
-  if (await exists2(join8(dir, PROJECT_FILE))) return loadProject(dir, options);
+  if (await exists(join9(dir, PROJECT_FILE))) return loadProject(dir, options);
   return inferProject(options.productRoot ?? dir);
 }
 async function inferProject(dir, loaded) {
@@ -1143,7 +1305,7 @@ async function runRepoCheck(project2, change) {
   const changedUi = (file) => change.added.has(file) && (/\.(tsx|jsx|astro|css)$/.test(file) || modules.some((m) => m.file === file && m.jsx.length > 0));
   for (const file of /* @__PURE__ */ new Set([...target.files, ...change.added.keys()])) {
     try {
-      const module = await parseModule(file, change.sources?.[file] ?? await readFile3(join8(project2.root, file), "utf8"));
+      const module = await parseModule(file, change.sources?.[file] ?? await readFile3(join9(project2.root, file), "utf8"));
       if (module) {
         modules.push(module);
         if (changedUi(file) && module.parseErrors > 0) incomplete.push(`${file}: fix the syntax errors, then run youiyoux check --diff again`);
@@ -1168,7 +1330,7 @@ async function runRepoCheck(project2, change) {
   } catch (error) {
     incomplete.push(`Components could not be compared (${String(error)}); run youiyoux inventory --project ${project2.root} to diagnose`);
   }
-  const findings2 = drift.map((d) => ({ ...d, severity: d.kind === "near-duplicate" ? "warn" : "error" }));
+  const findings2 = drift.map((d) => ({ ...d, severity: DRIFT_SEVERITY[d.kind] }));
   findings2.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.column - b.column);
   return { identity: null, unmatched: [], failed: [], notRun: [], incomplete: incomplete.length > 0, diff: { base: change.base, commit: change.commit, files: [...change.added.keys()].sort(), findings: findings2, notes, incomplete } };
 }
@@ -1247,25 +1409,26 @@ function renderScan(report, outFile) {
     coverageLine(report),
     ...report.coverage.failed.map((f) => style.warn(`  ! ${f.file}: ${f.reason}`)),
     ...ruleProblemLines(report),
-    ...outFile ? [style.dim(`usage map \u2192 ${outFile}`)] : []
+    style.dim(`usage map \u2192 ${outFile}`)
   ];
   return lines.join("\n");
 }
-function renderWhere(where, report, all) {
-  const max = Math.max(...where.byRoute.map((r) => r.sites), 1);
-  const routeWidth = Math.max(...where.byRoute.map((r) => r.route.length), 6);
-  const unknown = where.unknown.length > 0 ? style.warn(plural(where.unknown.length, "unknown")) : style.dim("0 unknown");
-  const lookalikes = where.lookalikes.reduce((n, l) => n + l.sites, 0);
+function renderWhere(where2, report) {
+  const all = where2.sites;
+  const max = Math.max(...where2.byRoute.map((r) => r.sites), 1);
+  const routeWidth = Math.max(...where2.byRoute.map((r) => r.route.length), 6);
+  const unknown = where2.unknown.length > 0 ? style.warn(plural(where2.unknown.length, "unknown")) : style.dim("0 unknown");
+  const lookalikes = where2.lookalikes.reduce((n, l) => n + l.sites, 0);
   const lines = [
-    `${style.accent(where.name)}  ${style.dim(`${where.element} \xB7 v${where.version} \xB7 ${where.status}`)}`,
-    style.dim(where.import),
+    `${style.accent(where2.name)}  ${style.dim(`${where2.element} \xB7 v${where2.version} \xB7 ${where2.status}`)}`,
+    style.dim(where2.import),
     "",
-    `${style.bold(plural(where.total, "site"))} in ${plural(where.files, "file")} across ${plural(where.screens, "screen")}   ${unknown}   ${lookalikes > 0 ? style.warn(`${plural(lookalikes, "lookalike")} not counted`) : style.dim("0 lookalikes")}`,
+    `${style.bold(plural(where2.total, "site"))} in ${plural(where2.files, "file")} across ${plural(where2.screens, "screen")}   ${unknown}   ${lookalikes > 0 ? style.warn(`${plural(lookalikes, "lookalike")} not counted`) : style.dim("0 lookalikes")}`,
     rule(),
-    ...where.byRoute.map((r) => `${padEnd(r.route, routeWidth)}  ${padStart(String(r.sites), 4)}  ${bar(r.sites, max)}${r.route === "*" ? `  ${SHELL_NOTE}` : ""}`),
-    ...where.unrouted > 0 ? [`${padEnd(style.warn("(unrouted)"), routeWidth)}  ${padStart(String(where.unrouted), 4)}  ${style.dim("no screen imports these files")}`] : [],
+    ...where2.byRoute.map((r) => `${padEnd(r.route, routeWidth)}  ${padStart(String(r.sites), 4)}  ${bar(r.sites, max)}${r.route === "*" ? `  ${SHELL_NOTE}` : ""}`),
+    ...where2.unrouted > 0 ? [`${padEnd(style.warn("(unrouted)"), routeWidth)}  ${padStart(String(where2.unrouted), 4)}  ${style.dim("no screen imports these files")}`] : [],
     "",
-    ...Object.entries(where.props).map(([prop, counts]) => `${style.dim(padEnd(prop, 9))}${Object.entries(counts).map(([value, n]) => `${value.startsWith("(") ? style.dim(value) : value} ${style.dim(String(n))}`).join(style.dim(" \xB7 "))}`),
+    ...Object.entries(where2.props).map(([prop, counts]) => `${style.dim(padEnd(prop, 9))}${Object.entries(counts).map(([value, n]) => `${value.startsWith("(") ? style.dim(value) : value} ${style.dim(String(n))}`).join(style.dim(" \xB7 "))}`),
     ""
   ];
   const byRoute = Map.groupBy(all, (s) => s.routes[0] ?? "(unrouted)");
@@ -1273,16 +1436,14 @@ function renderWhere(where, report, all) {
     lines.push(style.bold(route));
     for (const site of sites) lines.push(`  ${padEnd(style.dim(site.at), 46)} ${padEnd(site.use, 14)} ${site.props}`);
   }
-  if (where.nextOffset !== null) lines.push(style.dim(`  \u2026 ${where.total - all.length} more (--all, or --route <route>)`));
-  for (const l of where.lookalikes) lines.push("", style.warn(`lookalike: ${plural(l.sites, "site")} render ${l.resolved}, a different ${where.name}`), style.dim("  not counted above \xB7 youiyoux check --rule components.canonical-import lists them"));
-  for (const u of where.unknown) lines.push(style.warn(`unknown: ${u.at} <${u.name}> (${u.reason})`));
+  if (where2.nextOffset !== null) lines.push(style.dim(`  \u2026 ${where2.total - all.length} more (--all, or --route <route>)`));
+  for (const l of where2.lookalikes) lines.push("", style.warn(`lookalike: ${plural(l.sites, "site")} render ${l.resolved}, a different ${where2.name}`), style.dim("  not counted above \xB7 youiyoux check --rule components.canonical-import lists them"));
+  for (const u of where2.unknown) lines.push(style.warn(`unknown: ${u.at} <${u.name}> (${u.reason})`));
   lines.push("", coverageLine(report));
   return lines.join("\n");
 }
-function ruleSlug(id) {
-  return id.slice(id.indexOf("/rule/") + 6);
-}
-function renderCheck(violations, lockIssues2, report, suppressed) {
+function renderCheck(violations, lockIssues2, report) {
+  const { suppressed } = report;
   const lines = [];
   for (const [file, list] of Map.groupBy(violations, (v) => v.file)) {
     lines.push(style.bold(file));
@@ -1302,7 +1463,7 @@ function renderCheck(violations, lockIssues2, report, suppressed) {
   lines.push(
     "",
     errors > 0 ? style.error(`\u2716 ${plural(errors, "error")} \xB7 ${plural(warnings, "warning")} in ${plural(files, "file")}`) : warnings > 0 ? style.warn(`\u2713 0 errors \xB7 ${plural(warnings, "warning")} in ${plural(files, "file")}`) : style.ok("\u2713 0 errors \xB7 0 warnings"),
-    ...[...byRule].sort((a, b) => b[1].length - a[1].length).map(([slug2, list]) => style.dim(`  ${padStart(String(list.length), 4)}  ${slug2}`)),
+    ...[...byRule].sort((a, b) => b[1].length - a[1].length).map(([slug, list]) => style.dim(`  ${padStart(String(list.length), 4)}  ${slug}`)),
     ...suppressed > 0 ? [style.dim(`  ${padStart(String(suppressed), 4)}  suppressed by youi-ignore`)] : [],
     ...lockIssues2 === null ? [style.dim("  no youi.lock.json yet: generated-file and drift checks start after `youiyoux sync`")] : [],
     coverageLine(report),
@@ -1429,14 +1590,13 @@ function renderShots2(report) {
 }
 
 // ../cli/src/check-render.ts
-var slug = (rule2) => rule2.slice(rule2.indexOf("/rule/") + 6);
 function actionable(result) {
   if (!result.baseline) return result.violations;
   const { comparison } = result.baseline;
   return [...comparison.new, ...comparison.regressed].sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);
 }
 function renderCheckText(result) {
-  const lines = [renderCheck(actionable(result), result.lock, result.scan.report, result.scan.report.suppressed)];
+  const lines = [renderCheck(actionable(result), result.lock, result.scan.report)];
   if (result.baseline) {
     const { comparison, file, recorded } = result.baseline;
     const gone = comparison.fixed.reduce((n, f) => n + f.gone, 0);
@@ -1464,13 +1624,13 @@ function githubAnnotations(result, prefix) {
       file: `${prefix}${v.file}`,
       line: v.line,
       col: v.column,
-      title: `youi ${slug(v.rule)}`
+      title: `youi ${ruleSlug(v.rule)}`
     })
   );
   for (const issue of result.lock ?? []) lines.push(command(issue.severity === "error" ? "error" : "warning", issue.message, { file: `${prefix}${issue.file}`, title: "youi setup" }));
   for (const file of result.unmatched) lines.push(command("error", `${file} was not checked: not in this project's include globs`, { title: "youi incomplete" }));
   for (const failure of result.failed) lines.push(command("error", `could not be fully analysed (${failure.reason}); a clean result here is not a pass`, { file: `${prefix}${failure.file}`, title: "youi incomplete" }));
-  for (const run8 of result.notRun) lines.push(command("error", `rule ${slug(run8.rule)} did not run (${run8.reason ?? run8.state}); its findings are unknown`, { title: "youi incomplete" }));
+  for (const run7 of result.notRun) lines.push(command("error", `rule ${ruleSlug(run7.rule)} did not run (${run7.reason ?? run7.state}); its findings are unknown`, { title: "youi incomplete" }));
   return lines;
 }
 var revision = (state) => state.commit ? `\`${state.commit}\`${state.dirty ? " (dirty)" : ""}` : "not a git checkout";
@@ -1492,7 +1652,7 @@ function diffGaps(result) {
   return [
     ...result.unmatched.map((f) => `${f} was not checked: it is not in this project's include globs`),
     ...result.failed.map((f) => `${f.file} could not be fully analysed (${f.reason})`),
-    ...result.notRun.map((r) => `rule ${slug(r.rule)} did not run (${r.reason ?? r.state})`),
+    ...result.notRun.map((r) => `rule ${ruleSlug(r.rule)} did not run (${r.reason ?? r.state})`),
     ...result.diff?.incomplete ?? []
   ];
 }
@@ -1546,33 +1706,27 @@ function githubDiffSummary(result) {
 
 // ../cli/src/hooks.ts
 import { execFile as execFile4 } from "node:child_process";
-import { access as access3, realpath as realpath2 } from "node:fs/promises";
-import { dirname as dirname5, join as join9, resolve as resolve4 } from "node:path";
+import { realpath as realpath3 } from "node:fs/promises";
+import { dirname as dirname6, join as join10, resolve as resolve5 } from "node:path";
 import { promisify as promisify4 } from "node:util";
 var run4 = promisify4(execFile4);
 var MAX_LISTED = 20;
 var COMPONENT_FILE = /\.(?:tsx|jsx)$/;
 var quoted = (path) => /^[\w./-]+$/.test(path) ? path : `'${path.replace(/'/g, "'\\''")}'`;
 var SILENT = { stdout: "", exitCode: 0 };
-async function exists3(file) {
-  return access3(file).then(
-    () => true,
-    () => false
-  );
-}
 async function load(target, near) {
   return loadCheckProject(target.project ?? near, { ...target.config ? { configPath: target.config } : {}, ...target.design ? { designRoot: target.design } : {}, ...target.root ? { productRoot: target.root } : {} }, !target.project);
 }
 async function baselineFor(project2, target) {
   const file = baselinePath(project2, target.config);
-  return await exists3(file) ? file : null;
+  return await exists(file) ? file : null;
 }
 function findingLines(result, root) {
   const findings2 = result.diff?.findings ?? [];
   const lines = findings2.slice(0, MAX_LISTED).map((f) => `- ${diffFindingLine(f)}`);
   if (findings2.length > MAX_LISTED) {
-    const { run: run8, setup } = portableYoui(root);
-    lines.push(`- \u2026and ${findings2.length - MAX_LISTED} more. ${setup} Run \`${run8} check --diff\`.`);
+    const { run: run7, setup } = portableYoui(root);
+    lines.push(`- \u2026and ${findings2.length - MAX_LISTED} more. ${setup} Run \`${run7} check --diff\`.`);
   }
   for (const gap of diffGaps(result)) lines.push(`- incomplete: ${gap}; 0 findings there is not a pass`);
   return lines;
@@ -1597,21 +1751,22 @@ async function runClaudeHook(input, target = {}) {
   }
   const raw = payload.tool_input?.file_path;
   if (typeof raw !== "string" || raw.length === 0) return SILENT;
-  const file = resolve4(payload.cwd ?? process.cwd(), raw);
+  const file = resolve5(payload.cwd ?? process.cwd(), raw);
   try {
-    const project2 = await load(target, dirname5(file));
-    const real = (path) => realpath2(path).catch(() => path);
-    const relative10 = relPath(await real(project2.root), await real(file));
-    if (!isChecked(project2, relative10)) return SILENT;
-    const { change, problem } = await changeFor(() => workingTreeChange(project2, void 0, [relative10]));
-    if (problem) return claudeContext(problem, project2.root);
-    const result = configured(project2) ? await runCheck(project2, { files: [file], lock: false, baseline: await baselineFor(project2, target), ...change ? { diff: change } : {} }) : await runRepoCheck(project2, change);
+    const project2 = await load(target, dirname6(file));
+    const real = (path) => realpath3(path).catch(() => path);
+    const relative9 = relPath(await real(project2.root), await real(file));
+    if (!isChecked(project2, relative9)) return SILENT;
+    const found = await changeFor(() => workingTreeChange(project2, void 0, [relative9]));
+    if (found.problem !== void 0) return claudeContext(found.problem, project2.root);
+    const { change } = found;
+    const result = configured(project2) ? await runCheck(project2, { files: [file], lock: false, baseline: await baselineFor(project2, target), diff: change }) : await runRepoCheck(project2, change);
     const lines = findingLines(result, project2.root);
-    const see = COMPONENT_FILE.test(relative10) ? `See it: youiyoux render ${quoted(relative10)} (or the MCP tool ui_render), then open the images: light and dark, desktop and phone, accessibility issues and the diff against the base.` : null;
-    if (lines.length === 0) return see ? claudeContext(`youiyoux: ${relative10} passes the design-system check. ${see}`, project2.root) : SILENT;
-    const older = change && "violations" in result ? result.violations.filter((v) => !isAdded(change.added, v.file, v.line)).length : 0;
+    const see = COMPONENT_FILE.test(relative9) ? `See it: youiyoux render ${quoted(relative9)} (or the MCP tool ui_render), then open the images: light and dark, desktop and phone, accessibility issues and the diff against the base.` : null;
+    if (lines.length === 0) return see ? claudeContext(`youiyoux: ${relative9} passes the design-system check. ${see}`, project2.root) : SILENT;
+    const older = "violations" in result ? result.violations.filter((v) => !isAdded(change.added, v.file, v.line)).length : 0;
     const known = older > 0 ? ` (${older} older findings on unchanged lines omitted)` : "";
-    return claudeContext(`youiyoux design-system check (advisory) on ${relative10}${known}:
+    return claudeContext(`youiyoux design-system check (advisory) on ${relative9}${known}:
 ${lines.join("\n")}${!configured(project2) ? `
 ${result.diff?.notes.join("\n")}` : ""}
 Fix these before finishing (each "Fix:" says what to write); \`youiyoux show <component>\` and the youiyoux MCP tools give the legal values. CI runs the authoritative check.${see ? `
@@ -1639,10 +1794,11 @@ async function runPreCommitHook(target = {}, options = {}) {
     const staged = await stagedSources(project2);
     const files = Object.keys(staged);
     if (files.length === 0) return SILENT;
-    const { change, problem } = await changeFor(() => stagedChange(project2));
-    if (problem) return { stdout: `${viaNpx(problem, project2.root)}
+    const found = await changeFor(() => stagedChange(project2));
+    if (found.problem !== void 0) return { stdout: `${viaNpx(found.problem, project2.root)}
 `, exitCode: options.strict ? 1 : 0 };
-    const result = configured(project2) ? await runCheck(project2, { files: files.map((f) => join9(project2.root, f)), overrides: staged, lock: false, baseline: await baselineFor(project2, target), ...change ? { diff: change } : {} }) : await runRepoCheck(project2, change);
+    const { change } = found;
+    const result = configured(project2) ? await runCheck(project2, { files: files.map((f) => join10(project2.root, f)), overrides: staged, lock: false, baseline: await baselineFor(project2, target), diff: change }) : await runRepoCheck(project2, change);
     const lines = findingLines(result, project2.root);
     const failing = result.incomplete || (result.diff?.findings.length ?? 0) > 0;
     if (lines.length === 0) return { stdout: `${label}: ${files.length} staged file(s) clean, no drift
@@ -1657,195 +1813,9 @@ ${viaNpx(lines.join("\n"), project2.root)}
   }
 }
 
-// ../cli/src/hooks-install.ts
-import { execFile as execFile5 } from "node:child_process";
-import { chmod, mkdir as mkdir2, realpath as realpath3 } from "node:fs/promises";
-import { dirname as dirname6, join as join10, relative as relative5, resolve as resolve5, sep as sep3 } from "node:path";
-import { promisify as promisify5 } from "node:util";
-var run5 = promisify5(execFile5);
-var CLAUDE_MARKER = "hooks run claude";
-var BLOCK_START = "# >>> youi pre-commit >>>";
-var BLOCK_END2 = "# <<< youi pre-commit <<<";
-var WORKFLOW = ".github/workflows/youi-check.yml";
-var WORKFLOW_HEADER = "# Generated by `youiyoux hooks install --ci`.";
-var LEGACY_WORKFLOW_HEADER = WORKFLOW_HEADER.replace("youiyoux", "youi");
-var managedWorkflow = (text) => text.startsWith(WORKFLOW_HEADER) || text.startsWith(LEGACY_WORKFLOW_HEADER);
-var DIFF_STEP = "name: youiyoux check --diff";
-var CLAUDE_MATCHER = "Edit|Write|MultiEdit";
-var CLAUDE_TIMEOUT_S = 60;
-var shellQuote = (arg) => /^[\w@%+=:,./-]+$/.test(arg) ? arg : `'${arg.replace(/'/g, `'\\''`)}'`;
-async function gitOut(cwd, args) {
-  return (await run5("git", [...args], { cwd })).stdout.trim();
-}
-async function repoRootOf(dir) {
-  return gitOut(dir, ["rev-parse", "--show-toplevel"]).catch(() => dir);
-}
-function hookCommand(toolRoot, kind, target, extra = []) {
-  const server = toolCommand(toolRoot);
-  const args = [server.command, ...server.args, "hooks", "run", kind];
-  for (const key2 of ["project", "config", "design", "root"]) {
-    const value = target[key2];
-    if (value) args.push(`--${key2}`, resolve5(value));
-  }
-  return [...args, ...extra].map(shellQuote).join(" ");
-}
-async function write(file, content, before, guarantee, mode) {
-  if (before === content) return { file, action: "unchanged", guarantee };
-  await mkdir2(dirname6(file), { recursive: true });
-  await writeFileAtomic(file, content);
-  if (mode !== void 0) await chmod(file, mode);
-  return { file, action: before === null ? "created" : "updated", guarantee };
-}
-var isYouiEntry = (entry) => (entry.hooks ?? []).some((h) => typeof h.command === "string" && h.command.includes(CLAUDE_MARKER));
-async function installClaudeHook(repoRoot, command2) {
-  const file = join10(repoRoot, ".claude/settings.local.json");
-  const before = await readTextOrNull(file);
-  let settings;
-  try {
-    settings = before === null ? {} : JSON.parse(before);
-  } catch {
-    throw new Error(`${file} is not valid JSON; fix it first (youi will not overwrite it)`);
-  }
-  const hooks = settings.hooks ?? {};
-  const existing = hooks.PostToolUse ?? [];
-  const entry = { matcher: CLAUDE_MATCHER, hooks: [{ type: "command", command: command2, timeout: CLAUDE_TIMEOUT_S }] };
-  const postToolUse = existing.some(isYouiEntry) ? existing.map((e) => isYouiEntry(e) ? entry : e) : [...existing, entry];
-  const next2 = { ...settings, hooks: { ...hooks, PostToolUse: postToolUse } };
-  return write(file, `${JSON.stringify(next2, null, 2)}
-`, before, "advisory: after each Claude Code Edit/Write/MultiEdit, that file's new violations go back to Claude; never blocks; edits made any other way are not seen");
-}
-function withBlock(script, block) {
-  if (script === null) return `#!/bin/sh
-${block}
-`;
-  const start = script.indexOf(BLOCK_START);
-  const end = script.indexOf(BLOCK_END2);
-  if (start >= 0 && end > start) return `${script.slice(0, start)}${block}${script.slice(end + BLOCK_END2.length)}`;
-  return `${script.endsWith("\n") ? script : `${script}
-`}
-${block}
-`;
-}
-async function installPreCommit(projectRoot, command2, strict) {
-  const hooksDir = resolve5(projectRoot, await gitOut(projectRoot, ["rev-parse", "--git-path", "hooks"]));
-  const file = join10(hooksDir, "pre-commit");
-  const before = await readTextOrNull(file);
-  const shebang = before?.split("\n", 1)[0] ?? "";
-  if (before !== null && shebang.startsWith("#!") && !/\b(?:sh|bash|zsh|dash)\b/.test(shebang)) {
-    throw new Error(`${file} is not a shell script (${shebang}); add this line to it yourself: ${command2}`);
-  }
-  if (before !== null && /^\s*exec\s/m.test(before) && !before.includes(BLOCK_START)) {
-    throw new Error(`${file} hands off with exec, so an appended check would never run; add this line before the exec yourself: ${command2}`);
-  }
-  const what = strict ? "Blocks commits with new design-system errors" : "Advisory, never blocks";
-  const block = `${BLOCK_START}
-# ${what}: checks the staged content of staged files only; CI is authoritative.
-${command2} || exit $?
-${BLOCK_END2}`;
-  const guarantee = strict ? "blocks commits with new errors in staged files (any agent or person that commits; --no-verify skips it)" : "advisory at commit time, staged files only (any agent or person that commits; not every edit)";
-  return write(file, withBlock(before, block), before, guarantee, 493);
-}
-async function installRepoAgentInstructions(root) {
-  const file = join10(root, "AGENTS.md");
-  const before = await readTextOrNull(file);
-  const guarantee = "agents run youiyoux check --diff after UI edits; pre-commit also checks staged edits";
-  const ruled = before !== null && before.indexOf(RULE_END) > before.indexOf(RULE_BEGIN) && before.includes(RULE_BEGIN);
-  return write(file, ruled ? before : upsertBlock(before, repoAgentsBlock(root)), before, guarantee);
-}
-function codexFallback(projectRoot, agentsFile) {
-  return {
-    file: join10(projectRoot, agentsFile),
-    action: "skipped",
-    guarantee: "no post-edit hook installed (Codex documents none): Codex follows AGENTS.md, where `youiyoux sync` tells it to run `youiyoux check --diff` after UI edits, and the git pre-commit hook checks what it commits"
-  };
-}
-function githubSlug(url) {
-  const match = /github\.com[:/]([^/\s]+)\/([^/\s]+?)(?:\.git)?\/?$/.exec(url.trim());
-  return match ? `${match[1]}/${match[2]}` : null;
-}
-async function repoAt(root) {
-  const slug2 = githubSlug(await gitOut(root, ["remote", "get-url", "origin"]).catch(() => ""));
-  if (!slug2) throw new Error(`${root} has no GitHub origin remote; the workflow needs one to check it out`);
-  return { slug: slug2, commit: await gitOut(root, ["rev-parse", "HEAD"]) };
-}
-var posix2 = (path) => path.split(sep3).join("/") || ".";
-var inside = (root, path) => !relative5(root, path).startsWith("..");
-function workflowText(input) {
-  const dir = input.projectDir || ".";
-  const target = ["--project", dir, "--design", ".youi-ci/design", ...input.configPath ? ["--config", input.configPath, "--root", dir] : []];
-  const checkArgs = ["--baseline", "--format", "github", ...target].map(shellQuote).join(" ");
-  const diffArgs2 = ["--strict", "--format", "github", ...target].map(shellQuote).join(" ");
-  const diffStep = input.diff ? `      - ${DIFF_STEP} (drift this pull request adds)
-        if: \${{ !cancelled() && github.event_name == 'pull_request' }}
-        env:
-          YOUI_BASE: \${{ github.base_ref }}
-        run: node .youi-ci/tool/packages/cli/bin/youi.js check --diff "origin/$YOUI_BASE" ${diffArgs2}
-` : "";
-  return `${WORKFLOW_HEADER}
-# The authoritative design-system check: it fails on violations the baseline does not
-# accept, annotates them on the PR's lines, and states the rules version (design commit
-# and definitions digest) in the job summary. Raise the rules version by changing the
-# design ref below; YOUI_REPO_TOKEN must be able to read both repositories.
-name: youiyoux check
-on:
-  pull_request:
-  push:
-    branches: [main]
-permissions:
-  contents: read
-jobs:
-  youi-check:
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    steps:
-      - uses: actions/checkout@v4${input.diff ? "\n        with:\n          fetch-depth: 0" : ""}
-      - name: Check out youi
-        uses: actions/checkout@v4
-        with:
-          repository: ${input.tool.slug}
-          ref: ${input.tool.commit}
-          path: .youi-ci/tool
-          token: \${{ secrets.YOUI_REPO_TOKEN }}
-      - name: Check out the design rules (the rules version)
-        uses: actions/checkout@v4
-        with:
-          repository: ${input.design.slug}
-          ref: ${input.design.commit}
-          path: .youi-ci/design
-          token: \${{ secrets.YOUI_REPO_TOKEN }}
-      - uses: pnpm/action-setup@v4
-        with:
-          version: 10.13.1
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 24
-      - run: pnpm install --frozen-lockfile --ignore-scripts
-        working-directory: .youi-ci/tool
-      - name: youiyoux check
-        run: node .youi-ci/tool/packages/cli/bin/youi.js check ${checkArgs}
-${diffStep}`;
-}
-async function installWorkflow(project2, toolRoot, target, force, options = {}) {
-  const top = await gitOut(project2.root, ["rev-parse", "--show-toplevel"]);
-  const [tool, design] = await Promise.all([ephemeralTool(toolRoot) ? Promise.resolve({ slug: "npm/youiyoux", commit: "published" }) : repoAt(toolRoot), repoAt(project2.repo.root)]);
-  const configFile = resolve5(target.config ?? project2.configFile ?? join10(project2.root, PROJECT_FILE));
-  const configPath = !target.config ? null : inside(project2.repo.root, configFile) ? `.youi-ci/design/${posix2(relative5(project2.repo.root, configFile))}` : inside(top, configFile) ? posix2(relative5(top, configFile)) : null;
-  if (target.config && !configPath) throw new Error(`${configFile} is in neither this repo nor the design repo, so CI cannot read it`);
-  const file = join10(top, WORKFLOW);
-  const before = await readTextOrNull(file);
-  if (before !== null && !managedWorkflow(before) && !force) throw new Error(`${file} exists and was not written by youi; pass --force to replace it`);
-  const diff = options.diff === true || before !== null && managedWorkflow(before) && (before.includes(DIFF_STEP) || before.includes(DIFF_STEP.replace("youiyoux", "youi")));
-  const projectDir = posix2(relative5(top, await realpath3(project2.root).catch(() => project2.root)));
-  let text = workflowText({ tool, design, projectDir, configPath, diff });
-  if (ephemeralTool(toolRoot)) {
-    text = text.replace(/      - name: Check out youi\n[\s\S]*?(?=      - name: Check out the design)/, "").replace(/      - run: pnpm install --frozen-lockfile --ignore-scripts\n        working-directory: .youi-ci\/tool\n/, "").replaceAll("node .youi-ci/tool/packages/cli/bin/youi.js", "npx -y youiyoux");
-  }
-  return write(file, text, before, `authoritative: ${ephemeralTool(toolRoot) ? "runs the published youiyoux package; pinned to" : `pinned to ${tool.slug}@${tool.commit.slice(0, 7)} and`} rules ${design.slug}@${design.commit.slice(0, 7)}${diff ? "; pull requests also fail on drift they add (youiyoux check --diff --strict)" : ""}`);
-}
-
 // ../cli/src/agents-install.ts
 import { readdir as readdir2, rm as rm2, rmdir } from "node:fs/promises";
-import { dirname as dirname7, isAbsolute as isAbsolute4, join as join11, relative as relative6 } from "node:path";
+import { dirname as dirname7, isAbsolute as isAbsolute4, join as join11, relative as relative5 } from "node:path";
 var TOML_BEGIN = "# >>> youi mcp >>>";
 var TOML_END = "# <<< youi mcp <<<";
 var MCP_NAME = "youiyoux";
@@ -1862,7 +1832,7 @@ function mcpCommand(toolRoot, target) {
   return { command: server.command, args };
 }
 function relativeTo(repoRoot, server) {
-  return { command: server.command, args: server.args.map((arg) => isAbsolute4(arg) ? relative6(repoRoot, arg) || "." : arg) };
+  return { command: server.command, args: server.args.map((arg) => isAbsolute4(arg) ? relative5(repoRoot, arg) || "." : arg) };
 }
 var shellLine = ({ command: command2, args }) => [command2, ...args].map(shellQuote).join(" ");
 function withBlock2(text, block, begin, end) {
@@ -2091,7 +2061,7 @@ import { homedir, userInfo } from "node:os";
 import { join as join12, resolve as resolve6 } from "node:path";
 async function swapImpact(candidate, family) {
   try {
-    const { discoverIndexPath: discoverIndexPath2, sharedStore: sharedStore2 } = await import("./src-YUC5PIDK.js");
+    const { discoverIndexPath: discoverIndexPath2, sharedStore: sharedStore2 } = await import("./src-SFKFERZ2.js");
     const path = discoverIndexPath2();
     if (!process.env.DATABASE_URL && !existsSync(path)) return null;
     const impact = await (await sharedStore2(path, process.env, { readOnly: true })).swapImpact(candidate, family);
@@ -2102,7 +2072,7 @@ async function swapImpact(candidate, family) {
 }
 async function libraryLicence(id) {
   try {
-    const { discoverCacheDir: discoverCacheDir2, findListing } = await import("./src-YUC5PIDK.js");
+    const { discoverCacheDir: discoverCacheDir2, findListing } = await import("./src-SFKFERZ2.js");
     const { entry } = await findListing(discoverCacheDir2(void 0, process.env), id);
     return entry.id === id ? entry.license : null;
   } catch {
@@ -2110,7 +2080,7 @@ async function libraryLicence(id) {
   }
 }
 async function startRuleEditor(options) {
-  const { FileStore, RuleWorkflow, serveWorkflow } = await import("./src-U5NTDPUX.js");
+  const { FileStore, RuleWorkflow, serveWorkflow } = await import("./src-34R7QMJC.js");
   const projectRoot = resolve6(options.project);
   const load2 = { ...options.config ? { configPath: resolve6(options.config) } : {}, ...options.design ? { designRoot: resolve6(options.design) } : {}, ...options.root ? { productRoot: resolve6(options.root) } : {} };
   const project2 = await loadProject(projectRoot, load2);
@@ -2125,41 +2095,79 @@ async function startRuleEditor(options) {
 
 // ../cli/src/hub.ts
 import { spawn } from "node:child_process";
-import { access as access4 } from "node:fs/promises";
+import { existsSync as existsSync2 } from "node:fs";
+import { access as access2, mkdtemp as mkdtemp2, rm as rm3 } from "node:fs/promises";
+import { tmpdir as tmpdir2 } from "node:os";
 import { join as join13, resolve as resolve7 } from "node:path";
 var HUB_SNAPSHOT_DIR = ".hub";
 var DEFAULT_HUB_PORT = "5173";
+var named = (options) => ["design", "project", "config", "root", "inventory", "detect"].flatMap((key2) => options[key2] ? [`--${key2}`, resolve7(options[key2])] : []);
+var namesSystem = (options) => ["design", "project", "config", "root"].some((key2) => options[key2]);
 function hubPlan(toolRoot, options) {
   const web = join13(toolRoot, "apps/web");
   const vite = [join13(web, "node_modules/vite/bin/vite.js"), ...options.port ? ["--port", options.port, "--strictPort"] : []];
-  const named = ["design", "project", "config", "root", "inventory", "detect"].flatMap((key2) => options[key2] ? [`--${key2}`, resolve7(options[key2])] : []);
-  const watchesDemo = options.watch && !["design", "project", "config", "root"].some((key2) => options[key2]);
-  const flags = watchesDemo ? [...named, "--project", join13(toolRoot, "examples/demo-app")] : named;
+  const watchesDemo = options.watch && !namesSystem(options);
+  const flags = watchesDemo ? [...named(options), "--project", join13(toolRoot, "examples/demo-app")] : named(options);
   const api = options.api ? { YOUI_API: options.api } : {};
   if (flags.length === 0) return { web, snapshot: null, env: api, vite, watch: null };
   const out = join13(web, HUB_SNAPSHOT_DIR);
   const snapshot = [join13(web, "scripts/snapshot.ts"), "--out", out, ...flags];
   return { web, snapshot, env: { YOUI_HUB_SNAPSHOT: out, ...api }, vite, watch: options.watch ? [...snapshot, "--watch"] : null };
 }
-function run6(args, cwd, env) {
+var BUILT_HUB = "hub";
+var BUILT_DEMO = "hub-demo";
+function builtHubPlan(toolRoot, options, out) {
+  const flags = named(options);
+  if (options.watch && !namesSystem(options)) throw new Error("--watch keeps a system's snapshot live: name it with --design or --project (the demo system is not watched)");
+  const hub = join13(toolRoot, BUILT_HUB);
+  const snapshot = flags.length > 0 ? [join13(toolRoot, "hub-snapshot.js"), "--out", out, ...flags] : null;
+  const server = [join13(toolRoot, "hub-server.js"), "--dist", hub, "--kit", join13(hub, "kit"), "--snapshot", snapshot ? out : join13(toolRoot, BUILT_DEMO), ...snapshot ? ["--build-frame"] : [], ...options.port ? ["--port", options.port] : [], ...options.api ? ["--api", options.api] : [], ...options.watch ? ["--live"] : []];
+  return { snapshot, server, watch: options.watch && snapshot ? [...snapshot, "--watch"] : null };
+}
+function run5(args, cwd, env, started) {
   return new Promise((done, fail) => {
     const child = spawn(process.execPath, args, { cwd, env: { ...process.env, ...env }, stdio: "inherit" });
+    started?.(child);
     child.on("error", fail);
     child.on("exit", (code, signal) => done(code ?? (signal === "SIGINT" || signal === "SIGTERM" ? 0 : 1)));
   });
 }
+async function runBuiltHub(toolRoot, options) {
+  const out = await mkdtemp2(join13(tmpdir2(), "youiyoux-hub-"));
+  const children = /* @__PURE__ */ new Set();
+  const stop = () => {
+    for (const child of children) child.kill("SIGTERM");
+  };
+  process.on("SIGINT", stop);
+  process.on("SIGTERM", stop);
+  try {
+    const plan = builtHubPlan(toolRoot, options, out);
+    if (plan.snapshot) {
+      const code = await run5(plan.snapshot, process.cwd(), {}, (child) => children.add(child));
+      if (code !== 0) return code;
+    }
+    if (plan.watch) children.add(spawn(process.execPath, plan.watch, { cwd: process.cwd(), stdio: "inherit" }));
+    return await run5(plan.server, process.cwd(), {}, (child) => children.add(child));
+  } finally {
+    stop();
+    process.off("SIGINT", stop);
+    process.off("SIGTERM", stop);
+    await rm3(out, { recursive: true, force: true });
+  }
+}
 async function runHub(toolRoot, options) {
+  if (existsSync2(join13(toolRoot, BUILT_HUB, "index.html"))) return runBuiltHub(toolRoot, options);
   const plan = hubPlan(toolRoot, options);
-  await access4(plan.vite[0]).catch(() => {
+  await access2(plan.vite[0]).catch(() => {
     throw new Error(`the hub's dependencies are not installed: run \`pnpm install\` in ${toolRoot}`);
   });
   if (plan.snapshot) {
-    const code = await run6(plan.snapshot, process.cwd(), {});
+    const code = await run5(plan.snapshot, process.cwd(), {});
     if (code !== 0) return code;
   }
   const watcher = plan.watch ? spawn(process.execPath, plan.watch, { cwd: process.cwd(), stdio: "inherit" }) : null;
   try {
-    return await run6(plan.vite, plan.web, plan.env);
+    return await run5(plan.vite, plan.web, plan.env);
   } finally {
     watcher?.kill("SIGTERM");
   }
@@ -2176,10 +2184,11 @@ function previewsPlan(toolRoot, options) {
 }
 async function runPreviews(toolRoot, options) {
   const plan = previewsPlan(toolRoot, options);
-  await access4(join13(plan.web, "node_modules/playwright-core")).catch(() => {
+  if (existsSync2(join13(toolRoot, BUILT_HUB, "index.html"))) return run5([join13(toolRoot, "hub-previews.js"), ...plan.args.slice(1)], process.cwd(), {});
+  await access2(join13(plan.web, "node_modules/playwright-core")).catch(() => {
     throw new Error(`the hub's dependencies are not installed: run \`pnpm install\` in ${toolRoot}`);
   });
-  return run6(plan.args, plan.web, {});
+  return run5(plan.args, plan.web, {});
 }
 
 // ../cli/src/requests.ts
@@ -2204,7 +2213,7 @@ function renderRequests(briefs, status, unreadable) {
 }
 
 // ../cli/src/index-store.ts
-import { appendFile, mkdir as mkdir3, readFile as readFile4, stat, rename, mkdtemp as mkdtemp2, rm as rm3 } from "node:fs/promises";
+import { appendFile, mkdir as mkdir3, readFile as readFile4, stat, rename, mkdtemp as mkdtemp3, rm as rm4 } from "node:fs/promises";
 import { dirname as dirname8, join as join14, resolve as resolve8 } from "node:path";
 var SOURCES_FILE = "index-sources.json";
 var SCANS_LOG = "scans.jsonl";
@@ -2228,26 +2237,19 @@ async function noteSource(home, change) {
 `);
 }
 async function recordInventory(store, home, report, file) {
-  const run8 = inventoryRun(report, resolve8(file));
-  const logged = { run: run8.run, source: run8.source, scannedAt: run8.scannedAt, projects: run8.projects, families: run8.families };
+  const run7 = inventoryRun(report, resolve8(file));
+  const logged = { run: run7.run, source: run7.source, scannedAt: run7.scannedAt, projects: run7.projects, families: run7.families };
   await mkdir3(home, { recursive: true });
   await appendFile(join14(home, SCANS_LOG), `${JSON.stringify({ schema: "youi.scan-log/v1", ...logged })}
 `);
-  await store.recordInventory(run8);
-  await noteSource(home, { inventory: run8.source });
+  await store.recordInventory(run7);
+  await noteSource(home, { inventory: run7.source });
   await linkCandidates(store);
-  return run8;
+  return run7;
 }
 async function recordProject(store, project2, usage) {
   await store.replaceGraph(`project:${project2.root}`, projectGraph({ project: project2.config.id, rules: project2.system.rules, components: project2.system.components.map((c) => ({ id: c.contract.id, name: c.contract.name })), usage }));
 }
-async function readJsonFile(file) {
-  try {
-    return JSON.parse(await readFile4(file, "utf8"));
-  } catch {
-    return null;
-  }
-}
 async function readLog(home) {
   const text = await readFile4(join14(home, SCANS_LOG), "utf8").catch(() => "");
   return text.split("\n").flatMap((line) => {
@@ -2265,7 +2267,7 @@ async function rebuildIndex(path, options = {}) {
   const env = options.env ?? process.env;
   const home = indexHome(path, env);
   await mkdir3(dirname8(path), { recursive: true });
-  const scratch = !env.DATABASE_URL ? await mkdtemp2(`${path}.rebuild-`) : null;
+  const scratch = !env.DATABASE_URL ? await mkdtemp3(`${path}.rebuild-`) : null;
   const target = scratch ? join14(scratch, "index.db") : path;
   const store = scratch ? await openSqlite(target) : await sharedStore(path, env);
   try {
@@ -2283,7 +2285,7 @@ async function rebuildIndex(path, options = {}) {
     const missing = [];
     let replayed = 0;
     for (const file of sources.inventories) {
-      const parsed = InventoryReport.safeParse(await readJsonFile(file));
+      const parsed = InventoryReport.safeParse(await readJson(file));
       if (!parsed.success) {
         missing.push(file);
         continue;
@@ -2302,7 +2304,7 @@ async function rebuildIndex(path, options = {}) {
       }
       try {
         const project2 = await loadProject(source.root, source.options);
-        const usage = ScanReport.safeParse(await readJsonFile(source.usage ?? join14(project2.root, ".youi/usage.json")));
+        const usage = ScanReport.safeParse(await readJson(source.usage ?? join14(project2.root, ".youi/usage.json")));
         await recordProject(store, project2, usage.success ? usage.data : null);
         projects++;
       } catch (error) {
@@ -2337,7 +2339,7 @@ async function rebuildIndex(path, options = {}) {
   } finally {
     if (scratch) {
       await store.close();
-      await rm3(scratch, { recursive: true, force: true });
+      await rm4(scratch, { recursive: true, force: true });
     }
   }
 }
@@ -2369,6 +2371,40 @@ function renderHistory(scans) {
   return lines.join("\n");
 }
 
+// ../cli/src/gaps.ts
+var where = (c) => {
+  const first = c.definitions.map((d) => `${d.file}:${d.line}`).slice(0, 2).join(", ");
+  const parts = [c.count ? `${c.count} ${c.count === 1 ? "component" : "components"} named for it` : null, c.uses ? `${c.uses} ${c.uses === 1 ? "use" : "uses"}` : null, `in ${c.files} ${c.files === 1 ? "file" : "files"}`].filter(Boolean);
+  return `${parts.join(", ")}${first ? ` (${first}${c.definitions.length > 2 ? ", \u2026" : ""})` : ""}`;
+};
+var offered = (c) => c.candidates === null ? style.dim("no candidates: the Discover index is not synced") : c.candidates.length === 0 ? style.dim("no licensed candidate in the index") : c.candidates.map((x) => `${x.name} ${style.dim(`(${x.source}, ${x.licence}${x.copyleft ? ", copyleft" : ""})`)}`).join(" \xB7 ");
+function renderGaps(report) {
+  const lines = [];
+  for (const project2 of report.projects) {
+    const by = (status) => project2.concepts.filter((c) => c.status === status);
+    const hand = by("hand-built");
+    const missing = by("missing");
+    lines.push(`${style.bold(project2.id)}${project2.complete ? "" : style.warn(" (some files could not be read: counts are a lower bound)")}${project2.dependencies === "unread" ? style.dim(" (package.json not read: libraries only from imports)") : ""}`);
+    if (hand.length) {
+      lines.push("  Built by hand, with what could stand in for it:");
+      for (const c of hand) lines.push(`    ${c.name.padEnd(16)} ${where(c)}`, `    ${"".padEnd(16)} ${offered(c)}`);
+    }
+    if (missing.length) lines.push(`  Not in it, from the standard kit (${missing.length}): ${missing.map((c) => c.name).join(", ")}`);
+    const library = by("library");
+    if (library.length) lines.push(`  From libraries: ${library.map((c) => `${c.name} (${c.packages.join(", ")})`).join(", ")}`);
+    const system = by("system");
+    if (system.length) lines.push(`  In the System${report.system ? ` (${report.system})` : ""}: ${system.map((c) => c.name).join(", ")}`);
+    lines.push("");
+  }
+  if (report.across.length) {
+    lines.push("Built by hand in more than one project, worth adding to the System once:");
+    for (const a of report.across) lines.push(`  ${a.name}: ${a.projects.join(", ")} (${a.uses} uses)`);
+    lines.push("");
+  }
+  lines.push(report.discover === "synced" ? "Next: candidates for every gap are in youiyoux gaps --json and on the Gaps page of youiyoux ui; youiyoux discover show <id> for one. Nothing is installed." : "Next: youiyoux discover sync, then run youiyoux gaps again for candidates.");
+  return lines.join("\n");
+}
+
 // ../cli/src/inventory.ts
 var FAMILIES_PER_ROLE = 6;
 function shapeLabel(shape) {
@@ -2405,7 +2441,7 @@ function storyLines(report) {
 function storyNext(report, outFile) {
   const stories = report.projects.flatMap((p) => p.stories ? [p.stories] : []);
   if (stories.length === 0) return null;
-  const open = `youiyoux ui --inventory ${outFile ?? ".youi/inventory.json"}`;
+  const open = `youiyoux ui --inventory ${outFile}`;
   const skipped = stories.reduce((n, s) => n + s.skipped.length, 0);
   if (skipped > 0) return `Next: rewrite the skipped stories as CSF 3 args stories of a component in this project (or fix the file), run youiyoux inventory again, then see them beside their real uses with ${open}`;
   return `Next: see the stories beside their real uses with ${open}`;
@@ -2453,7 +2489,7 @@ function renderInventory(report, outFile) {
   }
   const stories = storyLines(report);
   if (stories.length > 0) lines.push("", ...stories);
-  if (outFile) lines.push(style.dim(`inventory \u2192 ${outFile}`));
+  lines.push(style.dim(`inventory \u2192 ${outFile}`));
   const next2 = storyNext(report, outFile);
   if (next2) lines.push(next2);
   return lines.join("\n");
@@ -2487,7 +2523,7 @@ function renderAdoptionRequest(request) {
 // ../cli/src/report/run.ts
 import { randomBytes as randomBytes2 } from "node:crypto";
 import { mkdir as mkdir4, rename as rename2, stat as stat2, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join21, relative as relative8, resolve as resolve11 } from "node:path";
+import { join as join21, relative as relative7, resolve as resolve11 } from "node:path";
 
 // ../cli/src/report/card.ts
 import { deflateSync } from "node:zlib";
@@ -2801,7 +2837,7 @@ function prefixOf(tokens) {
   const [best, n] = [...counts].sort((a, b) => b[1] - a[1])[0] ?? [null, 0];
   return best && n >= tokens.length / 4 ? best : null;
 }
-function scaleTokens(index, file, usage = { count: /* @__PURE__ */ new Map(), byFile: /* @__PURE__ */ new Map() }) {
+function scaleTokens(index, file, usage) {
   const value = (t) => `${t.id.split(".")[0]}\0${JSON.stringify(t.light)}`;
   const prefix = prefixOf(index.tokens);
   const rank = new Map(index.tokens.map((t) => [t, genericity(t, prefix)]));
@@ -2815,7 +2851,7 @@ function scaleTokens(index, file, usage = { count: /* @__PURE__ */ new Map(), by
     const component = componentOf(t);
     return component !== null && !general.has(value(t)) && new RegExp(`(?:^|[/._-])${component}s?(?:[/._-]|$)`).test(path);
   });
-  const score = (t) => [rank.get(t), Number(local.has(cssName(t))), Number(!usage.aliases?.has(cssName(t))), usage.count.get(cssName(t)) ?? 0, -t.cssName.length];
+  const score = (t) => [rank.get(t), Number(local.has(cssName(t))), Number(!usage.aliases.has(cssName(t))), usage.count.get(cssName(t)) ?? 0, -t.cssName.length];
   const higher = (a, b) => {
     for (let i = 0; i < a.length; i++) if (a[i] !== b[i]) return b[i] - a[i];
     return 0;
@@ -2826,21 +2862,20 @@ function scaleTokens(index, file, usage = { count: /* @__PURE__ */ new Map(), by
 var escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 async function reportTokens(module, tokens, usage) {
   if (isShowcase(module.file) || module.lang !== "css" && module.jsx.length === 0) return [];
-  const { parseModule: parseModule2 } = await import("./src-ZS76UD7E.js");
   let source = withoutVariables(module.source);
   if (module.lang !== "css") {
     source = maskFunctions(source, /(?:repeating-)?(?:linear|radial|conic)-gradient\s*\(/gi);
     source = source.replace(/(?<=[[,]\s*)(["'`])(?:#[0-9a-fA-F]{3,8}|(?:rgba?|hsla?)\([^)\n]*\))\1(?=\s*[,\]])/g, (literal) => " ".repeat(literal.length));
   }
-  const clean = source === module.source ? module : await parseModule2(module.file, source);
+  const clean = source === module.source ? module : await parseModule(module.file, source);
   if (!clean) return [];
   const index = scaleTokens(tokens, module.file, usage);
   return hardcodedValues(clean, index, { isTokenSource: module.lang === "css", added: () => true }).filter((f) => {
     if (/\bvar\(/.test(f.text)) return false;
     const kind = /^Hardcoded (colour|radius|spacing|type)\b/.exec(f.message)?.[1];
     const groups = kind === "colour" ? /^(color|colour)\./ : kind === "radius" ? /^(radius|radii|rounded)\./ : kind === "spacing" ? /^(space|spacing)\./ : /^(type|typography|fontSize)\./;
-    const named = index.tokens.filter((t) => new RegExp(`[\\s(]${escape(t.id)}(?=[\\s,)]|$)`).test(f.fix));
-    return named.length > 0 && named.every((t) => groups.test(t.id));
+    const named2 = index.tokens.filter((t) => new RegExp(`[\\s(]${escape(t.id)}(?=[\\s,)]|$)`).test(f.fix));
+    return named2.length > 0 && named2.every((t) => groups.test(t.id));
   });
 }
 function publicLook(caption) {
@@ -2850,12 +2885,12 @@ function publicLook(caption) {
 }
 
 // ../cli/src/report/groups.ts
-import { existsSync as existsSync2 } from "node:fs";
+import { existsSync as existsSync3 } from "node:fs";
 import { join as join16 } from "node:path";
 
 // ../cli/src/report/imports.ts
 import { realpathSync } from "node:fs";
-import { dirname as dirname9, join as join15, relative as relative7, resolve as resolve9 } from "node:path";
+import { dirname as dirname9, join as join15, relative as relative6, resolve as resolve9 } from "node:path";
 import ts from "typescript";
 var resolvers = /* @__PURE__ */ new Map();
 function resolverOf(root) {
@@ -2874,7 +2909,7 @@ function clearImportCache() {
 }
 async function verifiedImport(root, keeper, from, suggested) {
   const { options, cache } = resolverOf(root);
-  let local = relative7(dirname9(join15(root, from)), join15(root, keeper)).replaceAll("\\", "/").replace(/\.(tsx?|jsx?|mjs)$/, "");
+  let local = relative6(dirname9(join15(root, from)), join15(root, keeper)).replaceAll("\\", "/").replace(/\.(tsx?|jsx?|mjs)$/, "");
   if (!local.startsWith(".")) local = `./${local}`;
   for (const specifier of /* @__PURE__ */ new Set([suggested, local])) {
     const found = ts.resolveModuleName(specifier, resolve9(root, from), options, ts.sys, cache).resolvedModule?.resolvedFileName;
@@ -2992,7 +3027,6 @@ var SVG_TAGS = /* @__PURE__ */ new Set(["svg", "path", "g", "circle", "rect", "l
 var NEAR_IDENTICAL = 0.5;
 var MIN_STRUCTURE = 6;
 var GENERIC_IDENTICAL = 0.85;
-var plural2 = (count, word, many = `${word}s`) => `${count} ${count === 1 ? word : many}`;
 var repoPath = (dir, file) => dir === "." ? file : `${dir}/${file}`;
 var kebab = (name) => name.replace(/[a-z0-9](?=[A-Z])/g, "$&-").toLowerCase();
 function shapeWords(shape) {
@@ -3158,8 +3192,8 @@ async function nearDuplicateGroups(input) {
         actions.push(`replace the hand-styled ${tag}${at.length > 1 ? "s" : ""} at line${at.length > 1 ? "s" : ""} ${at.join(", ")} with ${keeperName}`);
       }
       for (const v of list.filter((c) => c.kind === "component")) {
-        const named = v.name === "default" ? "its default export" : v.name;
-        actions.push(v.name === keeperName ? `remove its own ${v.name} and use the kept one` : `build ${named} on ${keeperName} instead of restyling its own element`);
+        const named2 = v.name === "default" ? "its default export" : v.name;
+        actions.push(v.name === keeperName ? `remove its own ${v.name} and use the kept one` : `build ${named2} on ${keeperName} instead of restyling its own element`);
       }
       if (actions.length > 0) steps.push(`In ${file}, ${actions.join("; ")} (${use})`);
       for (const v of list.filter((c) => c.kind === "class")) steps.push(`In ${file}, ${v.name} copies ${keeperName}'s shape: use ${keeperName} where ${v.name} is used`);
@@ -3168,13 +3202,13 @@ async function nearDuplicateGroups(input) {
     const copyIds = new Set(copies.map((v) => v.id));
     const counted = members.filter((m) => copyIds.has(m.version.id));
     const home = [...counted.reduce((n, m) => n.set(m.version.facts, (n.get(m.version.facts) ?? 0) + 1), /* @__PURE__ */ new Map())].sort((a, b) => b[1] - a[1])[0]?.[0] ?? keeperFacts;
-    const where = keeperFacts.project.name && importedBy(keeperFacts) > 0 ? `${keeperFacts.project.name}, ${keeperFile}` : keeperFile;
-    const lead = kept ? `Keep ${keeperName} (${where})` : `Create ${keeperName} in ${keeperFile} (a new file in ${extract.where}) with this shape`;
+    const where2 = keeperFacts.project.name && importedBy(keeperFacts) > 0 ? `${keeperFacts.project.name}, ${keeperFile}` : keeperFile;
+    const lead = kept ? `Keep ${keeperName} (${where2})` : `Create ${keeperName} in ${keeperFile} (a new file in ${extract.where}) with this shape`;
     const [one, many] = KIND_WORDS[kind];
     const components = new Set([kept, ...copies].flatMap((v) => v?.kind === "component" ? [v.id] : [])).size;
     findings2.push(finding(
       home.project.dir,
-      `${plural2(members.length, one, many)} look the same (${shapeWords(family.shape)}) but are built ${sides.length} ways`,
+      `${plural(members.length, one, many)} look the same (${shapeWords(family.shape)}) but are built ${sides.length} ways`,
       counted.length,
       [...copies].sort((a, b) => path(a).localeCompare(path(b)) || a.line - b.line).slice(0, SITES_PER_FINDING).map((v) => ({ at: `${path(v)}:${v.line}`, file: path(v), line: v.line })),
       lead,
@@ -3187,7 +3221,7 @@ async function nearDuplicateGroups(input) {
 }
 function finding(project2, title, count, sites, lead, steps, exported) {
   const shown2 = steps.slice(0, STEPS_SHOWN);
-  const more = steps.length > shown2.length ? `; and ${plural2(steps.length - shown2.length, "more file")} (listed in the report)` : "";
+  const more = steps.length > shown2.length ? `; and ${plural(steps.length - shown2.length, "more file")} (listed in the report)` : "";
   return { kind: "near-duplicate", project: project2, title, detail: null, count, sites, lead, steps, next: `${lead}. ${shown2.join(". ")}${more}`, exported };
 }
 function commonDir(files) {
@@ -3289,7 +3323,7 @@ function factsOf(project2, id, modules, eligible, workspaceNames, dependencies,
     if (dirs.has(file.slice(0, at))) break;
     dirs.add(file.slice(0, at));
   }
-  const roots = [...dirs].filter((dir) => existsSync2(join16(project2.root, dir, "package.json"))).sort((a, b) => b.length - a.length);
+  const roots = [...dirs].filter((dir) => existsSync3(join16(project2.root, dir, "package.json"))).sort((a, b) => b.length - a.length);
   const nested = (file) => roots.find((dir) => file.startsWith(`${dir}/`)) ?? "";
   return { project: project2, id, dependencies, packageImports, jsxCounts, eligible, twins, dirs, importer, packageOf: nested };
 }
@@ -3299,13 +3333,6 @@ var import_yaml2 = __toESM(require_dist(), 1);
 import { readFile as readFile5 } from "node:fs/promises";
 import { basename as basename2, join as join17, resolve as resolve10 } from "node:path";
 var UI_FILES = ["**/*.{tsx,jsx,astro,vue,svelte}"];
-async function readJson3(file) {
-  try {
-    return JSON.parse(await readFile5(file, "utf8"));
-  } catch {
-    return null;
-  }
-}
 var strings = (value) => Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
 async function workspaceGlobs(root, pkg) {
   const pnpm = await readFile5(join17(root, "pnpm-workspace.yaml"), "utf8").catch(() => null);
@@ -3323,7 +3350,7 @@ async function workspaceGlobs(root, pkg) {
 var hasUi = async (dir) => (await findFiles(dir, UI_FILES, DEFAULT_EXCLUDE)).length > 0;
 async function findProjects(dir) {
   const root = resolve10(dir);
-  const pkg = await readJson3(join17(root, "package.json"));
+  const pkg = await readJson(join17(root, "package.json"));
   const name = typeof pkg?.name === "string" && pkg.name.trim() ? pkg.name.trim() : basename2(root);
   const single = { dir: ".", root, name: typeof pkg?.name === "string" ? pkg.name : null };
   const workspace = await workspaceGlobs(root, pkg);
@@ -3339,7 +3366,7 @@ async function findProjects(dir) {
       skipped.push(member);
       continue;
     }
-    const memberPkg = await readJson3(join17(memberRoot, "package.json"));
+    const memberPkg = await readJson(join17(memberRoot, "package.json"));
     projects.push({ dir: member, root: memberRoot, name: typeof memberPkg?.name === "string" ? memberPkg.name : null });
   }
   if (projects.length === 0) return { root, name, layout: `one project (${workspace.source} names no package with UI files)`, projects: [single], skipped };
@@ -3349,13 +3376,10 @@ async function findProjects(dir) {
 // ../cli/src/report/model.ts
 var REPORT_SCHEMA = "youiyoux.report/1";
 var NPX = `npx ${COMMAND}`;
-var SITES_PER_FINDING2 = 6;
 var TOP_COMPONENTS = 10;
 var TOP_FIXES = 5;
 var AGENT_LINE = `Set up youiyoux for your agent: run ${NPX} agents install, and your coding agent looks up these components before it writes a new one.`;
-var plural3 = (count, word, many = `${word}s`) => `${count} ${count === 1 ? word : many}`;
 var sentence = (text) => text.charAt(0).toUpperCase() + text.slice(1);
-var repoPath2 = (dir, file) => dir === "." ? file : `${dir}/${file}`;
 var errorText = (error) => error instanceof Error ? error.message : String(error);
 var Lines = class {
   files = /* @__PURE__ */ new Map();
@@ -3392,7 +3416,7 @@ async function modulesOf(project2, target, failed) {
       const module = await parseModule(file, await readFile6(join18(project2.root, file), "utf8"));
       if (module) modules.push(module);
     } catch (error) {
-      failed.push(`${repoPath2(project2.dir, file)}: ${errorText(error)}`);
+      failed.push(`${repoPath(project2.dir, file)}: ${errorText(error)}`);
     }
   }
   return modules;
@@ -3406,8 +3430,9 @@ async function grouped(project2, found, lines, describe) {
   const findings2 = [];
   for (const list of groups.values()) {
     const first = list[0];
-    const sites = await Promise.all(list.slice(0, SITES_PER_FINDING2).map((f) => lines.site(`${repoPath2(project2.dir, f.file)}:${f.line}`, repoPath2(project2.dir, f.file), f.line)));
-    findings2.push({ kind: first.kind, project: project2.dir, count: list.length, sites, ...describe(first, list.length) });
+    const sites = await Promise.all(list.slice(0, SITES_PER_FINDING).map((f) => lines.site(`${repoPath(project2.dir, f.file)}:${f.line}`, repoPath(project2.dir, f.file), f.line)));
+    const { title, next: next2 } = describe(first, list.length);
+    findings2.push({ kind: first.kind, project: project2.dir, count: list.length, sites, title, detail: null, next: next2 });
   }
   return findings2.sort((a, b) => b.count - a.count || a.title.localeCompare(b.title));
 }
@@ -3437,8 +3462,8 @@ async function analyseProject(project2, index, inventory, inventoryError, worksp
       if (isShowcase(at)) showcaseFiles.add(at.replace(/:\d+(?::\d+)?$/, ""));
     }
     const live = (items) => items.flatMap((item) => {
-      const where = item.where?.filter((at) => !isShowcase(at));
-      return item.where?.length && !where?.length ? [] : [{ ...item, ...where ? { where, count: Math.min(item.count, where.length) } : {} }];
+      const where2 = item.where?.filter((at) => !isShowcase(at));
+      return item.where?.length && !where2?.length ? [] : [{ ...item, ...where2 ? { where: where2, count: Math.min(item.count, where2.length) } : {} }];
     });
     const signals = live(scan.signals);
     const used = new Set(signals.filter((s) => s.kind !== "package" && s.kind !== "lockfile").map((s) => s.library));
@@ -3456,14 +3481,14 @@ async function analyseProject(project2, index, inventory, inventoryError, worksp
   for (const look of looks) {
     if (look.recipe?.kind !== "component") continue;
     const key2 = `${look.recipe.file}#${look.recipe.export}`;
-    const entry = byComponent.get(key2) ?? { name: look.recipe.export, file: repoPath2(project2.dir, look.recipe.file), roles: [] };
+    const entry = byComponent.get(key2) ?? { name: look.recipe.export, file: repoPath(project2.dir, look.recipe.file), roles: [] };
     entry.roles.push(look.role);
     byComponent.set(key2, entry);
   }
   const components = [...byComponent.values()].map((c) => ({ name: c.name, file: c.file, uses: c.roles.length, role: [...new Set(c.roles)].sort((a, b) => c.roles.filter((r) => r === b).length - c.roles.filter((r) => r === a).length)[0] })).sort((a, b) => b.uses - a.uses || a.name.localeCompare(b.name)).slice(0, TOP_COMPONENTS);
   const inventoryProject = inventory?.projects[index];
   if (inventoryError) incomplete.push(`The component inventory could not be built (${inventoryError}); run ${NPX} inventory --project ${project2.dir} to see why`);
-  for (const f of inventoryProject?.failed ?? []) failed.push(`${repoPath2(project2.dir, f.file)}: ${f.reason}`);
+  for (const f of inventoryProject?.failed ?? []) failed.push(`${repoPath(project2.dir, f.file)}: ${f.reason}`);
   let hardcoded = [];
   let offLibrary = [];
   const everyLine = () => true;
@@ -3475,7 +3500,7 @@ async function analyseProject(project2, index, inventory, inventoryError, worksp
       const found = (await Promise.all(modules.map((module) => reportTokens(module, tokens, usage)))).flat();
       hardcoded = await grouped(project2, found, lines, (first, count) => {
         const { word, value, tokens: names } = hardcodedValue(first);
-        return { title: `${sentence(word)} ${value} is hardcoded in ${plural3(count, "place")}; the theme already has it as ${names}`, detail: null, next: `${sentence(first.fix)} in each place` };
+        return { title: `${sentence(word)} ${value} is hardcoded in ${plural(count, "place")}; the theme already has it as ${names}`, next: `${sentence(first.fix)} in each place` };
       });
     } catch (error) {
       incomplete.push(`Hardcoded values were not checked (${errorText(error)}); run ${NPX} check --diff to see why`);
@@ -3487,7 +3512,7 @@ async function analyseProject(project2, index, inventory, inventoryError, worksp
       const kitDirs = [changeProject.config.componentsDir, ...inventory?.kits.filter((k) => k.project === projectId && k.kind === "cva-folder").map((k) => k.path) ?? []];
       const exempt = (file) => kitDirs.some((dir) => file === dir || file.startsWith(`${dir}/`));
       const found = modules.flatMap((module) => offLibraryImports(module, { added: everyLine, classify, chosen, exempt }));
-      offLibrary = await grouped(project2, found, lines, (first) => ({ title: first.message.replace(/^This imports/, "Imports"), detail: null, next: `${sentence(first.fix)}` }));
+      offLibrary = await grouped(project2, found, lines, (first) => ({ title: first.message.replace(/^This imports/, "Imports"), next: sentence(first.fix) }));
     } catch (error) {
       incomplete.push(`Library choices were not compared (${errorText(error)}); run ${NPX} detect ${project2.dir} to see why`);
     }
@@ -3504,7 +3529,7 @@ async function analyseProject(project2, index, inventory, inventoryError, worksp
     libraries,
     unused,
     definitions: inventory ? inventory.definitions.filter((d) => d.project === projectId && !isShowcase(d.file)).length : 0,
-    kits: inventory ? inventory.kits.filter((k) => k.project === projectId).map((k) => ({ path: repoPath2(project2.dir, k.path), kind: k.kind === "cva-folder" ? "CVA components" : "CSS classes", members: k.members.length })) : [],
+    kits: inventory ? inventory.kits.filter((k) => k.project === projectId).map((k) => ({ path: repoPath(project2.dir, k.path), kind: k.kind === "cva-folder" ? "CVA components" : "CSS classes", members: k.members.length })) : [],
     roles,
     uses: looks.length,
     components,
@@ -3517,7 +3542,7 @@ async function analyseProject(project2, index, inventory, inventoryError, worksp
   return { section, facts };
 }
 function topNext(f) {
-  const text = f.lead && f.steps ? `${f.lead}${f.steps.length > 1 ? `, then change ${plural3(f.steps.length, "file")} (each listed in the report)` : `; ${f.steps[0].charAt(0).toLowerCase()}${f.steps[0].slice(1)}`}` : f.next;
+  const text = f.lead && f.steps ? `${f.lead}${f.steps.length > 1 ? `, then change ${plural(f.steps.length, "file")} (each listed in the report)` : `; ${f.steps[0].charAt(0).toLowerCase()}${f.steps[0].slice(1)}`}` : f.next;
   return `${text.charAt(0).toLowerCase()}${text.slice(1).replace(/\.$/, "")}`;
 }
 var DUPLICATE_RULE = "Duplicated components: groups of 2+ exported components that look alike or share a name.";
@@ -3527,10 +3552,10 @@ function summaryLines(model) {
   const top = model.projects.flatMap((p) => p.components).sort((a, b) => b.uses - a.uses)[0];
   const first = model.topFixes[0];
   return [
-    `${model.repo}: ${plural3(t.projects, "project")}, ${plural3(t.files, "file")} scanned; UI libraries: ${t.libraries.length > 0 ? t.libraries.join(", ") : "none found"}.`,
-    `Components: ${t.definitions} defined, ${plural3(t.uses, "button, input, card or other UI element", "buttons, inputs, cards and other UI elements")} in use${top ? `; most used: ${top.name} (${plural3(top.uses, "use")})` : ""}.`,
-    `Near-duplicates: ${plural3(t.nearDuplicates, "group")} of UI that looks the same but is built more than once; ${t.componentDuplicates} of them between exported components.`,
-    `Hardcoded values: ${plural3(t.hardcoded, "colour, spacing or radius", "colours, spacings and radii")} a theme token already holds; off-library imports: ${t.offLibrary}.`,
+    `${model.repo}: ${plural(t.projects, "project")}, ${plural(t.files, "file")} scanned; UI libraries: ${t.libraries.length > 0 ? t.libraries.join(", ") : "none found"}.`,
+    `Components: ${t.definitions} defined, ${plural(t.uses, "button, input, card or other UI element", "buttons, inputs, cards and other UI elements")} in use${top ? `; most used: ${top.name} (${plural(top.uses, "use")})` : ""}.`,
+    `Near-duplicates: ${plural(t.nearDuplicates, "group")} of UI that looks the same but is built more than once; ${t.componentDuplicates} of them between exported components.`,
+    `Hardcoded values: ${plural(t.hardcoded, "colour, spacing or radius", "colours, spacings and radii")} a theme token already holds; off-library imports: ${t.offLibrary}.`,
     first ? `Top fix: ${first.title.replace(/\.$/, "")}; ${topNext(first)}.` : `Nothing to fix first; next: ${NPX} agents install, so your agent keeps it that way.`
   ];
 }
@@ -3565,7 +3590,7 @@ async function buildReportModel(dir, options = {}) {
     offLibrary: projects.reduce((n, p) => n + p.offLibrary.reduce((m, f) => m + f.count, 0), 0)
   };
   const topFixes = [...near, ...projects.flatMap((p) => [...p.hardcoded, ...p.offLibrary])].sort((a, b) => b.count - a.count || a.kind.localeCompare(b.kind) || a.title.localeCompare(b.title)).slice(0, TOP_FIXES);
-  const layout = repo.skipped.length > 0 ? `${repo.layout}; ${plural3(repo.skipped.length, "package")} without UI files left out (${repo.skipped.join(", ")})` : repo.layout;
+  const layout = repo.skipped.length > 0 ? `${repo.layout}; ${plural(repo.skipped.length, "package")} without UI files left out (${repo.skipped.join(", ")})` : repo.layout;
   const model = {
     schema: REPORT_SCHEMA,
     repo: repo.name,
@@ -3587,7 +3612,6 @@ async function buildReportModel(dir, options = {}) {
 
 // ../cli/src/report/html.ts
 var escape2 = (text) => String(text).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
-var plural4 = (count, word, many = `${word}s`) => `${count} ${count === 1 ? word : many}`;
 var anchor = (dir) => `p-${dir === "." ? "root" : dir.replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-|-$/g, "")}`;
 var CSS = `
 :root{color-scheme:light dark;--canvas:#f4f5f7;--surface:#fcfcfd;--raised:#f6f7f9;--sunken:#f8f9fa;--line:#e3e4e8;--line-strong:#d0d2d8;--ink:#16171a;--ink-2:#3d4049;--muted:#6b6f78;--faint:#9ea2ab;--accent:#5e6ad2;--accent-soft:#eceefa;--success:#4f7a69;--success-soft:#eaf1ee;--danger:#ad5a43;--danger-soft:#f7ece8;--neutral-soft:#eef0f3;--k-dup:var(--accent);--k-hard:color-mix(in oklch,var(--accent) 55%,var(--surface));--k-off:color-mix(in oklch,var(--accent) 25%,var(--surface));--shadow:0 1px 2px rgba(16,17,20,.04)}
@@ -3765,7 +3789,6 @@ var rich = (text) => escape2(text).replace(FACT, (fact) => `<span class="mono">$
 function next(text) {
   return `<p class="next"><strong>Next:</strong> ${rich(text.replace(/\.$/, ""))}.</p>`;
 }
-var STEPS_SHOWN2 = 5;
 var KIND = { "near-duplicate": "Duplicate", "hardcoded-value": "Hardcoded", "off-library": "Off-library" };
 function splitMeasures(title) {
   const m = /\s*\(([^()]*\d[^()]*)\)/.exec(title);
@@ -3789,18 +3812,18 @@ function shots(f, looks) {
 }
 function finding2(f, showProject, looks) {
   const { text, measures } = f.kind === "near-duplicate" ? splitMeasures(f.title) : { text: f.title, measures: [] };
-  const where = showProject && f.project !== "." ? `<p class="muted">in <span class="mono">${escape2(f.project)}</span></p>` : "";
-  const head = `<div class="head"><span class="count">${f.count}<small>${f.count === 1 ? "place" : "places"}</small></span><div class="what"><p class="title">${rich(text)}</p>${f.detail ? `<p class="muted">${escape2(f.detail)}</p>` : ""}${where}</div><span class="chip">${f.kind === "hardcoded-value" ? swatch(f.title) : ""}${KIND[f.kind]}</span></div>`;
+  const where2 = showProject && f.project !== "." ? `<p class="muted">in <span class="mono">${escape2(f.project)}</span></p>` : "";
+  const head = `<div class="head"><span class="count">${f.count}<small>${f.count === 1 ? "place" : "places"}</small></span><div class="what"><p class="title">${rich(text)}</p>${where2}</div><span class="chip">${f.kind === "hardcoded-value" ? swatch(f.title) : ""}${KIND[f.kind]}</span></div>`;
   const specs = measures.length > 0 ? `<ul class="specs">${measures.map((m) => `<li>${escape2(m)}</li>`).join("")}</ul>` : "";
   if (f.lead && f.steps && f.steps.length > 0) {
     const item = (step) => `<li>${rich(step.replace(/\.$/, ""))}</li>`;
-    const rest = f.steps.slice(STEPS_SHOWN2);
-    const more2 = rest.length > 0 ? `<details class="more"><summary>and ${plural4(rest.length, "more file")}</summary><ol class="steps" start="${STEPS_SHOWN2 + 1}">${rest.map(item).join("")}</ol></details>` : "";
-    return `<li class="finding" data-kind="${f.kind}">${head}${specs}<div class="compare">${next(f.lead)}<ol class="steps">${f.steps.slice(0, STEPS_SHOWN2).map(item).join("")}</ol>${more2}${shots(f, looks)}</div></li>`;
+    const rest = f.steps.slice(STEPS_SHOWN);
+    const more2 = rest.length > 0 ? `<details class="more"><summary>and ${plural(rest.length, "more file")}</summary><ol class="steps" start="${STEPS_SHOWN + 1}">${rest.map(item).join("")}</ol></details>` : "";
+    return `<li class="finding" data-kind="${f.kind}">${head}${specs}<div class="compare">${next(f.lead)}<ol class="steps">${f.steps.slice(0, STEPS_SHOWN).map(item).join("")}</ol>${more2}${shots(f, looks)}</div></li>`;
   }
   const code = f.sites.some((s) => s.code);
   const sites = f.sites.map((s) => `<li><code>${escape2(s.at)}</code>${s.code ? `<pre>${escape2(s.code)}</pre>` : ""}</li>`).join("");
-  const more = f.count > f.sites.length ? `<li>+ ${plural4(f.count - f.sites.length, "more place")}</li>` : "";
+  const more = f.count > f.sites.length ? `<li>+ ${plural(f.count - f.sites.length, "more place")}</li>` : "";
   return `<li class="finding" data-kind="${f.kind}">${head}${specs}<ul class="sites${code ? " code" : ""}">${sites}${more}</ul>${next(f.next)}</li>`;
 }
 function findings(list, none, after, looks) {
@@ -3812,29 +3835,29 @@ function panel(name, id, title, aside, body, level = "h3") {
 }
 function projectSection(p, many, looks) {
   const id = anchor(p.dir);
-  const where = p.dir === "." ? "" : ` --project ${p.dir}`;
+  const where2 = p.dir === "." ? "" : ` --project ${p.dir}`;
   const libraries = p.libraries.length === 0 ? `<div class="body"><p class="none">No UI library found.</p>${next(`if it uses one, run ${NPX} detect ${p.dir} to see what was read`)}</div>` : `<div class="body"><ul class="rows">${p.libraries.map((l) => `<li><span>${escape2(l.name)}${l.for.length > 0 ? ` <small>${escape2(l.for.join(", "))}</small>` : ""}</span><span>${escape2(l.confidence)} confidence</span></li>`).join("")}</ul>${p.unused.length > 0 ? `<p class="muted">Declared but never imported (not counted): ${escape2(p.unused.join(", "))}</p>` : ""}${next(`build new UI with these, not a new library: ${NPX} agents install tells your agent so`)}</div>`;
-  const kits = p.kits.length > 0 ? `<p class="muted">Kits: ${p.kits.map((k) => `<code>${escape2(k.path)}</code> (${escape2(k.kind)}, ${plural4(k.members, "member")})`).join(", ")}</p>` : "";
-  const components = p.components.length > 0 ? `<h4>Most used</h4><ul class="rows">${p.components.map((c) => `<li><span>${escape2(c.name)}<small>${escape2(c.file)}</small></span><span>${plural4(c.uses, "use")}</span></li>`).join("")}</ul>` : "";
-  const inventory = `<div class="body"><p>${plural4(p.definitions, "component")} defined in ${plural4(p.files, "file")}; ${plural4(p.uses, "UI element")} in use (buttons, links styled as buttons, inputs, cards, badges, dialogs, tabs).</p>${p.roles.length > 0 ? `<ul class="rows">${p.roles.map((r) => `<li><span class="mono">${escape2(r.role)}</span><span>${plural4(r.uses, "use")} \xB7 ${plural4(r.families, "shape")}</span></li>`).join("")}</ul>` : ""}${kits}${components}${next(`see every look grouped by shape with ${NPX} inventory${where}`)}</div>`;
-  const unread = p.failed.length > 0 ? `<details class="incomplete more"><summary>${plural4(p.failed.length, "file")} not fully read; what is in them is unknown</summary><ul class="unread">${p.failed.map((f) => `<li>${rich(f)}</li>`).join("")}</ul></details>` : "";
-  const count = (list) => list.length === 0 ? "None" : `${plural4(list.length, "finding")} \xB7 ${plural4(list.reduce((n, f) => n + f.count, 0), "place")}`;
+  const kits = p.kits.length > 0 ? `<p class="muted">Kits: ${p.kits.map((k) => `<code>${escape2(k.path)}</code> (${escape2(k.kind)}, ${plural(k.members, "member")})`).join(", ")}</p>` : "";
+  const components = p.components.length > 0 ? `<h4>Most used</h4><ul class="rows">${p.components.map((c) => `<li><span>${escape2(c.name)}<small>${escape2(c.file)}</small></span><span>${plural(c.uses, "use")}</span></li>`).join("")}</ul>` : "";
+  const inventory = `<div class="body"><p>${plural(p.definitions, "component")} defined in ${plural(p.files, "file")}; ${plural(p.uses, "UI element")} in use (buttons, links styled as buttons, inputs, cards, badges, dialogs, tabs).</p>${p.roles.length > 0 ? `<ul class="rows">${p.roles.map((r) => `<li><span class="mono">${escape2(r.role)}</span><span>${plural(r.uses, "use")} \xB7 ${plural(r.families, "shape")}</span></li>`).join("")}</ul>` : ""}${kits}${components}${next(`see every look grouped by shape with ${NPX} inventory${where2}`)}</div>`;
+  const unread = p.failed.length > 0 ? `<details class="incomplete more"><summary>${plural(p.failed.length, "file")} not fully read; what is in them is unknown</summary><ul class="unread">${p.failed.map((f) => `<li>${rich(f)}</li>`).join("")}</ul></details>` : "";
+  const count = (list) => list.length === 0 ? "None" : `${plural(list.length, "finding")} \xB7 ${plural(list.reduce((n, f) => n + f.count, 0), "place")}`;
   return `<section class="project" data-section="project" data-project="${escape2(p.dir)}" id="${id}">
 <h2>${escape2(many || p.dir !== "." ? p.dir : "This repo")}${p.name && p.name !== p.dir ? ` <small>${escape2(p.name)}</small>` : ""}</h2>
 ${p.incomplete.length > 0 || p.failed.length > 0 ? `<div class="unread-at" id="${id}-unread">${p.incomplete.map((i) => `<p class="incomplete">${escape2(i)}</p>`).join("")}${unread}</div>` : ""}
 ${panel("near-duplicates", `${id}-near`, "Near-duplicate groups", count(p.nearDuplicates), `<div class="body"><p class="muted">Components that look the same (height, padding, corners, text size and weight) but are built more than once.</p></div>${findings(p.nearDuplicates, "None found: each look is built once.", `keep it that way: ${NPX} agents install has your agent reuse these components`, looks)}`)}
 ${panel("hardcoded", `${id}-hardcoded`, "Hardcoded values that should be tokens", count(p.hardcoded), `<div class="body"><p class="muted">Colours, spacing and radii written as literals although a theme variable holds the same value.</p></div>${findings(p.hardcoded, "None found.", `run ${NPX} check --diff on each change to keep new literals out`, looks)}`)}
 ${panel("off-library", `${id}-off`, "Off-library imports", count(p.offLibrary), `<div class="body"><p class="muted">Imports of an element from a library other than the one the rest of the code uses for it.</p></div>${findings(p.offLibrary, "None found.", `run ${NPX} check --diff on each change to catch a second library early`, looks)}`)}
-${panel("inventory", `${id}-inventory`, "Component inventory", `${plural4(p.definitions, "component")} \xB7 ${plural4(p.uses, "use")}`, inventory)}
-${panel("libraries", `${id}-libraries`, "UI libraries", p.libraries.length > 0 ? plural4(p.libraries.length, "library", "libraries") : "", libraries)}
+${panel("inventory", `${id}-inventory`, "Component inventory", `${plural(p.definitions, "component")} \xB7 ${plural(p.uses, "use")}`, inventory)}
+${panel("libraries", `${id}-libraries`, "UI libraries", p.libraries.length > 0 ? plural(p.libraries.length, "library", "libraries") : "", libraries)}
 ${p.notes.map((n) => `<p class="muted">${escape2(n.replace(/\.?$/, "."))}</p>`).join("")}
 </section>`;
 }
 function looksSection(model) {
   const drawn = model.projects.flatMap((p) => p.rendered.map((r) => ({ ...r, project: p.dir })));
-  const body = drawn.length > 0 ? `<div class="looks">${drawn.map((r) => `<figure data-component="${escape2(r.component)}"><figcaption>${escape2(r.component)} <small>${escape2(r.file)}</small></figcaption><div class="pair">${r.light ? `<img alt="${escape2(r.component)}, light" src="${r.light}">` : ""}${r.dark ? `<img alt="${escape2(r.component)}, dark" src="${r.dark}">` : ""}</div>${r.looks.length > 0 ? `<p class="muted">${plural4(r.looks.length, "look")} drawn, light and dark</p>` : ""}</figure>`).join("")}</div>` : "";
+  const body = drawn.length > 0 ? `<div class="looks">${drawn.map((r) => `<figure data-component="${escape2(r.component)}"><figcaption>${escape2(r.component)} <small>${escape2(r.file)}</small></figcaption><div class="pair">${r.light ? `<img alt="${escape2(r.component)}, light" src="${r.light}">` : ""}${r.dark ? `<img alt="${escape2(r.component)}, dark" src="${r.dark}">` : ""}</div>${r.looks.length > 0 ? `<p class="muted">${plural(r.looks.length, "look")} drawn, light and dark</p>` : ""}</figure>`).join("")}</div>` : "";
   const after = model.render.next ? next(model.render.next) : drawn.length > 0 ? next(`see a component after you change it with ${NPX} render <file>`) : next(model.render.state === "off" ? `run ${NPX} --render to draw the most-used components (it asks before downloading the ~100 MB headless Chromium, once)` : `run ${NPX} render <file> to see why a component could not be drawn`);
-  return `<section class="panel" data-section="looks" data-render="${model.render.state}" id="looks"><header><h2>Rendered looks</h2><span class="aside">${drawn.length > 0 ? plural4(drawn.length, "component") : ""}</span></header><div class="body">${body}<p class="${drawn.length > 0 ? "muted" : ""}">${escape2(model.render.note)}</p>${after}</div></section>`;
+  return `<section class="panel" data-section="looks" data-render="${model.render.state}" id="looks"><header><h2>Rendered looks</h2><span class="aside">${drawn.length > 0 ? plural(drawn.length, "component") : ""}</span></header><div class="body">${body}<p class="${drawn.length > 0 ? "muted" : ""}">${escape2(model.render.note)}</p>${after}</div></section>`;
 }
 function placesByKind(model) {
   const places = (pick) => model.projects.reduce((n, p) => n + pick(p).reduce((m, f) => m + f.count, 0), 0);
@@ -3846,25 +3869,21 @@ function placesByKind(model) {
 }
 function headline(model) {
   const t = model.totals;
-  const [near, hard, off] = placesByKind(model);
-  const parts = [
-    { label: "Near-duplicates", places: near.places, href: model.projects.length > 1 ? "top-fixes" : `${anchor(model.projects[0]?.dir ?? ".")}-near` },
-    { label: "Hardcoded values", places: hard.places, href: model.projects.length > 1 ? "top-fixes" : `${anchor(model.projects[0]?.dir ?? ".")}-hardcoded` },
-    { label: "Off-library imports", places: off.places, href: model.projects.length > 1 ? "top-fixes" : `${anchor(model.projects[0]?.dir ?? ".")}-off` }
-  ];
+  const panels = ["near", "hardcoded", "off"];
+  const parts = placesByKind(model).map((part, i) => ({ ...part, href: model.projects.length > 1 ? "top-fixes" : `${anchor(model.projects[0]?.dir ?? ".")}-${panels[i]}` }));
   const total = parts.reduce((n2, part) => n2 + part.places, 0);
   const n = (value) => `<b class="${value > 0 ? "warn" : "ok"}">${value}</b>`;
   const unknown = model.projects.some((p) => p.incomplete.length > 0 || p.failed.length > 0);
   const analyses = model.projects.reduce((n2, p) => n2 + p.incomplete.length, 0);
   const unread = model.projects.reduce((n2, p) => n2 + p.failed.length, 0);
-  const caveat = [analyses > 0 ? `${plural4(analyses, "analysis", "analyses")} could not run` : "", unread > 0 ? `${plural4(unread, "file")} could not be fully read` : ""].filter(Boolean).join(" and ");
+  const caveat = [analyses > 0 ? `${plural(analyses, "analysis", "analyses")} could not run` : "", unread > 0 ? `${plural(unread, "file")} could not be fully read` : ""].filter(Boolean).join(" and ");
   const said = [];
   if (t.nearDuplicates > 0) said.push(`${n(t.nearDuplicates)} ${t.nearDuplicates === 1 ? "look is" : "looks are"} built more than once`);
   if (t.hardcoded > 0) said.push(`${n(t.hardcoded)} ${t.hardcoded === 1 ? "value skips" : "values skip"} the theme`);
   if (t.offLibrary > 0) said.push(`${n(t.offLibrary)} ${t.offLibrary === 1 ? "import comes" : "imports come"} from a second library`);
   const sentence2 = said.length === 0 ? `Every look is built once and every value comes from the theme${unknown ? ", in what could be read" : ""}.` : `${said.length > 1 ? `${said.slice(0, -1).join(", ")} and ${said.at(-1)}` : said[0]}: <b class="warn">${total}</b> ${total === 1 ? "place" : "places"} to fix.`;
   const bar2 = total > 0 ? `<div class="split" role="img" aria-label="${parts.map((part) => `${part.label} ${part.places}`).join(", ")}">${parts.map((part, i) => part.places > 0 ? `<span class="seg s${i}" style="width:${(part.places / total * 100).toFixed(2)}%"></span>` : "").join("")}</div>` : "";
-  const legend = `<ul class="legend">${parts.map((part, i) => `<li><a href="#${part.href}"><span class="key s${i}${part.places === 0 ? " zero" : ""}"></span>${escape2(part.label)} <b>${part.places}</b>${part.places === 0 ? ` <span class="clean">Clean</span>` : ""}</a></li>`).join("")}${unknown ? `<li class="alert"><a href="#${anchor(model.projects.find((p) => p.failed.length > 0 || p.incomplete.length > 0)?.dir ?? ".")}-unread" aria-describedby="unread-tip"><i aria-hidden="true">!</i>${analyses + unread} not read</a><span class="tip" id="unread-tip" role="tooltip">${escape2(caveat.charAt(0).toUpperCase() + caveat.slice(1))}: what is in them is unknown, not zero.</span></li>` : ""}<li class="of">${plural4(t.definitions, "component")} \xB7 ${plural4(t.uses, "UI element")} in use \xB7 ${plural4(t.files, "file")}</li></ul>`;
+  const legend = `<ul class="legend">${parts.map((part, i) => `<li><a href="#${part.href}"><span class="key s${i}${part.places === 0 ? " zero" : ""}"></span>${escape2(part.label)} <b>${part.places}</b>${part.places === 0 ? ` <span class="clean">Clean</span>` : ""}</a></li>`).join("")}${unknown ? `<li class="alert"><a href="#${anchor(model.projects.find((p) => p.failed.length > 0 || p.incomplete.length > 0)?.dir ?? ".")}-unread" aria-describedby="unread-tip"><i aria-hidden="true">!</i>${analyses + unread} not read</a><span class="tip" id="unread-tip" role="tooltip">${escape2(caveat.charAt(0).toUpperCase() + caveat.slice(1))}: what is in them is unknown, not zero.</span></li>` : ""}<li class="of">${plural(t.definitions, "component")} \xB7 ${plural(t.uses, "UI element")} in use \xB7 ${plural(t.files, "file")}</li></ul>`;
   return `<section class="headline" data-section="headline"><p class="say">${sentence2}</p>${bar2}${legend}</section>`;
 }
 var SQUARES = 40;
@@ -3878,7 +3897,7 @@ function shapeMap(model) {
   const rows = [...roles].map(([role, { uses, families }]) => {
     const shown2 = Math.min(families, SQUARES);
     const squares = families === 0 ? `<span class="unmeasured">shape not measured</span>` : `${Array.from({ length: shown2 }, (_, i) => `<i class="${i === 0 ? "one" : "more"}"></i>`).join("")}${families > shown2 ? `<span class="over">+${families - shown2}</span>` : ""}`;
-    return `<li class="${families > 1 ? "drift" : families === 1 ? "even" : ""}"><span class="role mono">${escape2(role)}</span><span class="sq">${squares}</span><span class="val"><b>${families}</b> ${families === 1 ? "shape" : "shapes"} \xB7 ${plural4(uses, "use")}</span></li>`;
+    return `<li class="${families > 1 ? "drift" : families === 1 ? "even" : ""}"><span class="role mono">${escape2(role)}</span><span class="sq">${squares}</span><span class="val"><b>${families}</b> ${families === 1 ? "shape" : "shapes"} \xB7 ${plural(uses, "use")}</span></li>`;
   }).join("");
   const many = model.projects.length > 1 ? ", summed over the projects" : "";
   return `<section class="panel" data-section="shapes" id="shapes"><header><h2>Shapes per element</h2><span class="aside"><i class="k one"></i>first shape <i class="k more"></i>each extra shape</span></header><div class="body"><p class="muted">One square per distinct look of each kind of element${many}. One square is consistent; every extra square is a copy someone built.</p><ul class="shapes">${rows}</ul></div></section>`;
@@ -3925,7 +3944,7 @@ ${shapeMap(model)}
 ${panel("top-fixes", "top-fixes", "Top fixes", "Ranked by how many places each one touches", top, "h2")}
 <aside class="agent" data-section="agent"><p><strong>${escape2(model.agent)}</strong></p>${next(`${NPX} agents install, then restart your agent`)}</aside>
 ${looksSection(model)}
-<section class="panel projects" data-section="projects" id="projects"><header><h2>Projects</h2><span class="aside">${plural4(model.projects.length, "project")}</span></header><div class="body"><p>${escape2(model.layout.charAt(0).toUpperCase() + model.layout.slice(1))}.</p>${many ? `<nav><ul>${model.projects.map((p) => `<li><a href="#${anchor(p.dir)}">${escape2(p.dir)}</a>${p.name && p.name !== p.dir ? ` <small>${escape2(p.name)}</small>` : ""}</li>`).join("")}</ul></nav>` : ""}${next(many ? "open each project below; each has its own fixes" : "read this repo's section below")}</div></section>
+<section class="panel projects" data-section="projects" id="projects"><header><h2>Projects</h2><span class="aside">${plural(model.projects.length, "project")}</span></header><div class="body"><p>${escape2(model.layout.charAt(0).toUpperCase() + model.layout.slice(1))}.</p>${many ? `<nav><ul>${model.projects.map((p) => `<li><a href="#${anchor(p.dir)}">${escape2(p.dir)}</a>${p.name && p.name !== p.dir ? ` <small>${escape2(p.name)}</small>` : ""}</li>`).join("")}</ul></nav>` : ""}${next(many ? "open each project below; each has its own fixes" : "read this repo's section below")}</div></section>
 ${model.projects.map((p) => projectSection(p, many, looks)).join("\n")}
 <footer>
 <p>Made with ${escape2(NPX)} on ${escape2(date)} in ${(model.durationMs / 1e3).toFixed(1)} s. This file is self-contained: it loads nothing from the network, and nothing was uploaded.</p>
@@ -3940,12 +3959,13 @@ ${model.projects.map((p) => projectSection(p, many, looks)).join("\n")}
 
 // ../cli/src/report/looks.ts
 import { spawn as spawn2 } from "node:child_process";
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync as existsSync4, readFileSync as readFileSync2 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { dirname as dirname10, join as join19 } from "node:path";
 var LOOKS_PER_PROJECT = 4;
 var DOWNLOAD_SIZE = "~100 MB";
 var DEPENDENCIES = "Install the repo's dependencies to see rendered looks";
+var UNDRAWABLE = /not installed|loads no stylesheet|drawn from (?:its|their) (?:tag and )?classes|did not render|bundle failed|unstyled|stub fallback/i;
 var playwrightDir = () => dirname10(playwrightCli());
 function browsersPath(env) {
   const set = env.PLAYWRIGHT_BROWSERS_PATH;
@@ -3956,12 +3976,12 @@ function browsersPath(env) {
   return join19(env.XDG_CACHE_HOME ?? join19(homedir2(), ".cache"), "ms-playwright");
 }
 function chromiumStatus(env = process.env) {
-  if (env.YOUI_CHROMIUM) return { available: existsSync3(env.YOUI_CHROMIUM), where: env.YOUI_CHROMIUM };
+  if (env.YOUI_CHROMIUM) return { available: existsSync4(env.YOUI_CHROMIUM), where: env.YOUI_CHROMIUM };
   try {
     const browsers = JSON.parse(readFileSync2(join19(playwrightDir(), "browsers.json"), "utf8"));
     const revision2 = browsers.browsers.find((b) => b.name === "chromium-headless-shell")?.revision;
     const dir = join19(browsersPath(env), `chromium_headless_shell-${revision2}`);
-    return { available: revision2 !== void 0 && existsSync3(join19(dir, "INSTALLATION_COMPLETE")), where: dir };
+    return { available: revision2 !== void 0 && existsSync4(join19(dir, "INSTALLATION_COMPLETE")), where: dir };
   } catch {
     return { available: false, where: "playwright-core is not installed" };
   }
@@ -3973,7 +3993,7 @@ function downloadChromium() {
     child.on("close", (code) => resolve13(code === 0));
   });
 }
-var dataUri = (file) => file && existsSync3(file) ? `data:image/png;base64,${readFileSync2(file).toString("base64")}` : null;
+var dataUri = (file) => file && existsSync4(file) ? `data:image/png;base64,${readFileSync2(file).toString("base64")}` : null;
 async function addLooks(model, repoRoot, options = {}) {
   const drawn = [];
   const problems = [];
@@ -3981,34 +4001,34 @@ async function addLooks(model, repoRoot, options = {}) {
   for (const section of model.projects) {
     const names = [...new Set(section.components.map((c) => c.name))].slice(0, LOOKS_PER_PROJECT);
     if (names.length === 0) continue;
-    const where = section.dir === "." ? "this repo" : section.dir;
+    const where2 = section.dir === "." ? "this repo" : section.dir;
     try {
       const installed = (name) => {
         let dir = join19(repoRoot, section.dir);
         while (true) {
-          if (existsSync3(join19(dir, "node_modules", name, "package.json"))) return true;
+          if (existsSync4(join19(dir, "node_modules", name, "package.json"))) return true;
           if (dir === repoRoot || dirname10(dir) === dir) return false;
           dir = dirname10(dir);
         }
       };
       if (!installed("react") || !installed("react-dom")) {
-        missing.push(where);
+        missing.push(where2);
         continue;
       }
       const projectRoot = join19(repoRoot, section.dir);
       const target = await loadInventoryTarget(projectRoot);
       if (findStylesheets(projectRoot, target.files, { tsconfig: target.tsconfig, override: target.specimenCss, templates: target.templates }).found.length === 0) {
-        missing.push(where);
+        missing.push(where2);
         continue;
       }
       const report = await renderShots(join19(repoRoot, section.dir), names, { download: false, base: "HEAD", ...options.executablePath ? { executablePath: options.executablePath } : {}, ...options.cache ? { cache: options.cache } : {}, ...options.log ? { log: options.log } : {} });
-      const unavailable = report.notes.some((note) => /not installed|loads no stylesheet|drawn from (?:its|their) (?:tag and )?classes|did not render|bundle failed|unstyled|stub fallback/i.test(note));
+      const unavailable = report.notes.some((note) => UNDRAWABLE.test(note));
       if (unavailable) {
-        missing.push(where);
+        missing.push(where2);
         continue;
       }
       for (const component of report.components) {
-        if (component.notes.some((note) => /not installed|loads no stylesheet|drawn from (?:its|their) (?:tag and )?classes|did not render|bundle failed|unstyled|stub fallback/i.test(note))) {
+        if (component.notes.some((note) => UNDRAWABLE.test(note))) {
           missing.push(component.component);
           continue;
         }
@@ -4024,7 +4044,7 @@ async function addLooks(model, repoRoot, options = {}) {
         drawn.push(component.component);
       }
     } catch (error) {
-      problems.push(`${where}: ${error instanceof Error ? error.message : String(error)}`);
+      problems.push(`${where2}: ${error instanceof Error ? error.message : String(error)}`);
       if (error instanceof RenderUnavailableError) break;
     }
   }
@@ -4038,7 +4058,6 @@ function looksOff(model) {
 }
 
 // ../cli/src/report/markdown.ts
-var STEPS_SHOWN3 = 5;
 var md = (text) => text.replace(/([\\`*_[\]<>|#])/g, "\\$1");
 function renderMarkdown(model, reportFile) {
   const t = model.totals;
@@ -4059,8 +4078,8 @@ function renderMarkdown(model, reportFile) {
     model.topFixes.forEach((fix, i) => {
       lines.push(`${i + 1}. ${md(fix.title)}${model.projects.length > 1 && fix.project !== "." ? ` (${md(fix.project)})` : ""}  `);
       if (fix.lead && fix.steps && fix.steps.length > 0) {
-        lines.push(`   Next: ${md(fix.lead)}.`, ...fix.steps.slice(0, STEPS_SHOWN3).map((step) => `   - ${md(step.replace(/\.$/, ""))}`));
-        if (fix.steps.length > STEPS_SHOWN3) lines.push(`   - and ${fix.steps.length - STEPS_SHOWN3} more ${fix.steps.length - STEPS_SHOWN3 === 1 ? "file" : "files"}, listed in the report`);
+        lines.push(`   Next: ${md(fix.lead)}.`, ...fix.steps.slice(0, STEPS_SHOWN).map((step) => `   - ${md(step.replace(/\.$/, ""))}`));
+        if (fix.steps.length > STEPS_SHOWN) lines.push(`   - and ${fix.steps.length - STEPS_SHOWN} more ${fix.steps.length - STEPS_SHOWN === 1 ? "file" : "files"}, listed in the report`);
       } else lines.push(`   Next: ${md(fix.next.replace(/\.$/, ""))}.`);
     });
     lines.push("");
@@ -4218,7 +4237,7 @@ async function writeBinaryAtomic(file, bytes) {
   await rename2(temp, file);
 }
 var shown = (file) => {
-  const rel = relative8(process.cwd(), file);
+  const rel = relative7(process.cwd(), file);
   return rel && !rel.startsWith("..") ? rel : file;
 };
 async function runReport(options = {}, io = {}) {
@@ -4275,8 +4294,8 @@ async function runReport(options = {}, io = {}) {
     print2(JSON.stringify({ ...clean, projects: clean.projects.map((p) => ({ ...p, rendered: p.rendered.map(({ light: _l, dark: _d, ...r }) => r) })), files }, null, 2));
     return { code: 0, files, model: clean };
   }
-  const width = Math.max(...["Report", "Card", "Summary"].map((w) => w.length)) + 2;
-  const looks = clean.render.state === "drawn" ? "" : clean.render.state === "off" && !renderNote ? `; to add rendered looks, run ${NPX} --render` : "";
+  const width = 9;
+  const looks = clean.render.state === "off" && !renderNote ? `; to add rendered looks, run ${NPX} --render` : "";
   print2([
     ...clean.summary,
     "",
@@ -4318,6 +4337,10 @@ ${style.bold("Anywhere")}  ${style.dim("no design system needed")}
                            <first project>/.youi/inventory.json unless --out, and records the scan
                            (project, commit, time, counts, families) in the local index for trends
   inventory --history      every recorded scan per project, newest first, with what changed
+  gaps [--project <dir>\u2026] [--inventory <file>] [--json] [--out <file>]
+                           per project, each kind of element: in the System, from a library, built
+                           by hand or missing from the standard kit, with licensed candidates from
+                           the Discover index, and what is built by hand in more than one project
   requests [--status open|addressed|closed|all] [--route r] [--json]
                            comments and change requests people pinned to components on captured
                            screens: what is asked, the file:line, the picture, and what to do next
@@ -4327,6 +4350,9 @@ ${style.bold("Anywhere")}  ${style.dim("no design system needed")}
                            photograph the routes in <project>/.youi/screens/screens.json, light and
                            dark, from the app running in development at <url>, and place each
                            component on them with the line that rendered it (for youiyoux ui)
+  screens login --base <url> [--project dir] [--storage-state file]
+                           open the app in a browser window to sign in once; capture then uses the
+                           session (kept outside the product, readable only by you)
   render [file|component\u2026] [--base ref] [--json]
                            see a component you changed: its looks drawn with the project's own code
                            and CSS in headless Chromium, light and dark at 1280 and 390 px, axe's
@@ -4508,7 +4534,7 @@ var OPTIONS = {
 var INVENTORY_OPTIONS = { ...OPTIONS, project: { type: "string", multiple: true }, include: { type: "string", multiple: true }, exclude: { type: "string", multiple: true } };
 var UsageError = class extends Error {
 };
-var run7 = promisify6(execFile6);
+var run6 = promisify5(execFile5);
 var print = (text) => void process.stdout.write(`${text}
 `);
 var json = (value) => print(JSON.stringify(value, null, 2));
@@ -4540,23 +4566,44 @@ async function recordUsage(values, p, report, usage) {
     await noteSource(home, { project: { root: resolve12(values.project ?? process.cwd()), options: Object.fromEntries(Object.entries(loadOptions(values)).map(([key2, value]) => [key2, resolve12(value)])), usage } });
     return null;
   } catch (error) {
-    return style.warn(`! not recorded in the local index: ${error instanceof Error ? error.message : String(error)}`);
+    return notRecorded(error);
   }
 }
+var notRecorded = (error) => style.warn(`! not recorded in the local index: ${error instanceof Error ? error.message : String(error)}`);
+var inventoryDirs = (values) => values.project?.length ? values.project : [process.cwd()];
+var scanInventory = (values, dirs) => buildInventory(dirs, { ...values.include ? { include: values.include } : {}, ...values.exclude ? { exclude: values.exclude } : {} });
 function indexOf(values) {
   const path = discoverIndexPath(values.cache);
   return { path, home: indexHome(path) };
 }
+async function cmdGaps(values) {
+  const dirs = inventoryDirs(values);
+  const inventory = values.inventory ? InventoryReport.parse(JSON.parse(await readFile8(resolve12(values.inventory), "utf8"))) : await scanInventory(values, dirs);
+  const cwd = values.inventory ? dirname11(resolve12(values.inventory)) : process.cwd();
+  const project2 = await loadProject(resolve12(dirs[0]), loadOptions(values)).catch(() => null);
+  const system = project2 ? { name: project2.system.config.name, components: project2.system.components.map((c) => c.contract.name) } : null;
+  const store = await readCatalog(resolve12(discoverCacheDir(values.cache)), indexOf(values).path).catch((error) => {
+    if (error instanceof MissingIndexError) return null;
+    throw error;
+  });
+  const roots = new Map(inventory.projects.map((p) => [p.id, resolve12(cwd, p.root)]));
+  const report = await buildGaps({ inventory, system, dependencies: declaredPackages(roots) }, store);
+  if (values.out) await writeFileAtomic(resolve12(values.out), `${JSON.stringify(report, null, 2)}
+`);
+  if (values.json) json(report);
+  else print(renderGaps(report));
+  return 0;
+}
 async function cmdInventory(values) {
   if (values.history) return cmdHistory(values, []);
-  const dirs = values.project?.length ? values.project : [process.cwd()];
-  const report = await buildInventory(dirs, { ...values.include ? { include: values.include } : {}, ...values.exclude ? { exclude: values.exclude } : {} });
+  const dirs = inventoryDirs(values);
+  const report = await scanInventory(values, dirs);
   const out = resolve12(values.out ?? join22(dirs[0], ".youi/inventory.json"));
   await writeFileAtomic(out, `${JSON.stringify(report, null, 2)}
 `);
   const recorded = await recordScan(values, report, out);
   if (values.json) json(report);
-  else print([renderInventory(report, relative9(process.cwd(), out).startsWith("..") ? out : relative9(process.cwd(), out)), recorded].join("\n"));
+  else print([renderInventory(report, relative8(process.cwd(), out).startsWith("..") ? out : relative8(process.cwd(), out)), recorded].join("\n"));
   return 0;
 }
 async function recordScan(values, report, out) {
@@ -4567,7 +4614,7 @@ async function recordScan(values, report, out) {
     const scans = (await store.history({ limit: 500 })).filter((s) => report.projects.some((p) => p.id === s.project)).length;
     return style.dim(`history \u2192 ${store.location} (${plural(scans, "scan")} of these projects; youiyoux inventory --history)`);
   } catch (error) {
-    return style.warn(`! not recorded in the local index: ${error instanceof Error ? error.message : String(error)}`);
+    return notRecorded(error);
   }
 }
 async function cmdHistory(values, positionals) {
@@ -4606,9 +4653,9 @@ async function cmdWhere(values, positionals) {
   const p = await project(values);
   const { report } = await scanProject(p);
   const limit = values.all ? Number.MAX_SAFE_INTEGER : Number(values.limit ?? (values.json ? 20 : 24));
-  const where = whereUsed(p, report, query, { ...values.route ? { route: values.route } : {}, limit });
-  if (values.json) json(where);
-  else print(renderWhere(where, report, where.sites));
+  const where2 = whereUsed(p, report, query, { ...values.route ? { route: values.route } : {}, limit });
+  if (values.json) json(where2);
+  else print(renderWhere(where2, report));
   return 0;
 }
 async function cmdShow(values, positionals) {
@@ -4635,9 +4682,10 @@ function baselineFile(values, p) {
   if (values["baseline-file"]) return resolve12(values["baseline-file"]);
   return values.baseline ? baselinePath(p, values.config) : null;
 }
+var checkScope = (values, positionals) => ({ ...positionals.length > 0 ? { files: positionals } : {}, ...values.rule ? { rule: values.rule } : {}, quiet: values.quiet });
 async function repoPrefix(root) {
   try {
-    return (await run7("git", ["rev-parse", "--show-prefix"], { cwd: root })).stdout.trim();
+    return (await run6("git", ["rev-parse", "--show-prefix"], { cwd: root })).stdout.trim();
   } catch {
     return "";
   }
@@ -4647,7 +4695,7 @@ async function cmdCheck(values, positionals) {
   if (!["text", "json", "github"].includes(format)) throw new UsageError("youiyoux check --format text|json|github");
   if (values.diff || values.base !== void 0) return cmdCheckDiff(values, positionals, await loadCheckProject(values.project ?? process.cwd(), loadOptions(values), !values.project), format);
   const p = await project(values);
-  const result = await runCheck(p, { ...positionals.length > 0 ? { files: positionals } : {}, ...values.rule ? { rule: values.rule } : {}, quiet: values.quiet, baseline: baselineFile(values, p) });
+  const result = await runCheck(p, { ...checkScope(values, positionals), baseline: baselineFile(values, p) });
   if (format === "json") {
     const { report } = result.scan;
     json({ errors: result.errors, incomplete: result.incomplete, identity: result.identity, unmatched: result.unmatched, notRun: result.notRun, violations: result.violations, baseline: result.baseline, lock: result.lock, suppressed: report.suppressed, coverage: report.coverage, status: report.status, checks: report.checks });
@@ -4661,7 +4709,7 @@ async function cmdCheck(values, positionals) {
 async function cmdCheckDiff(values, positionals, p, format) {
   if (values.baseline) throw new UsageError("youiyoux check --diff looks only at added lines, so a baseline does not apply; drop --baseline");
   const change = await workingTreeChange(p, values.base);
-  const result = configured(p) ? await runCheck(p, { ...positionals.length > 0 ? { files: positionals } : {}, ...values.rule ? { rule: values.rule } : {}, quiet: values.quiet, diff: change }) : await runRepoCheck(p, change);
+  const result = configured(p) ? await runCheck(p, { ...checkScope(values, positionals), diff: change }) : await runRepoCheck(p, change);
   if (format === "json") json(diffJson(result));
   else if (format === "github") {
     for (const line of githubDiffAnnotations(result, await repoPrefix(p.root))) print(line);
@@ -4688,7 +4736,7 @@ async function cmdBaseline(values) {
   const { totals } = written.baseline;
   if (values.json) json({ file: written.file, action: written.action, totals, notAdded: written.notAdded, identity: written.baseline.identity });
   else {
-    print(`${style.ok(written.action)} ${relative9(process.cwd(), file) || file}: ${plural(totals.errors, "error")} \xB7 ${plural(totals.warnings, "warning")} accepted`);
+    print(`${style.ok(written.action)} ${relative8(process.cwd(), file) || file}: ${plural(totals.errors, "error")} \xB7 ${plural(totals.warnings, "warning")} accepted`);
     print(style.dim(`  rules ${describeIdentity(written.baseline.identity)}`));
     if (written.notAdded > 0) print(style.warn(`  ${plural(written.notAdded, "current violation")} not added: fix them, or accept them deliberately with --force`));
   }
@@ -4852,7 +4900,7 @@ async function cmdAgents(values, positionals) {
   const repoRoot = await repoRootOf(projectRoot);
   const target = { project: projectRoot, ...values.config ? { config: resolve12(values.config) } : {}, ...values.design ? { design: resolve12(values.design) } : {}, ...values.root !== void 0 ? { root: resolve12(values.root || ".") } : {} };
   const server = mcpCommand(TOOL_ROOT, target);
-  const system = existsSync4(resolve12(values.config ?? join22(projectRoot, PROJECT_FILE))) ? await project(values) : null;
+  const system = existsSync5(resolve12(values.config ?? join22(projectRoot, PROJECT_FILE))) ? await project(values) : null;
   const claudeServer = system && system.root === repoRoot ? { command: "node", args: mcpArgs(system) } : relativeTo(repoRoot, server);
   const both = !values.claude && !values.codex;
   const results = [];
@@ -4910,10 +4958,10 @@ async function startEditor(values, port) {
   if (!values.project) return null;
   try {
     const editor = await startRuleEditor({ project: values.project, ...values.config ? { config: values.config } : {}, ...values.design ? { design: values.design } : {}, ...values.root ? { root: values.root } : {}, ...values.state ? { state: values.state } : {} });
-    const { design, project: product } = editor.info;
+    const { design, project: product2 } = editor.info;
     print(`${style.ok("rule editor")} http://localhost:${port}/#key=${editor.sessionKey}`);
     print(style.dim(`  design   ${design.root} (${design.branch} @ ${design.head.slice(0, 7)}${design.dirty ? ", working tree differs" : ""})`));
-    print(style.dim(`  project  ${product.id} at ${product.root}`));
+    print(style.dim(`  project  ${product2.id} at ${product2.root}`));
     print(style.dim(`  drafts   ${editor.stateDir}`));
     print(style.dim("  open the link above: it carries this run's key, which every change needs (nothing else can approve)"));
     print(style.dim("  approved changes become a local review branch; nothing is pushed"));
@@ -4935,20 +4983,20 @@ async function cmdUi(values) {
 async function cmdDetect(values, positionals) {
   const target = detectTarget(positionals);
   if (!target) throw new UsageError("youiyoux detect <repo-path>   or   youiyoux detect <url\u2026> [--expose]   (one repo, or one or more URLs; not both)");
-  const { repoReport, siteReport, writeReport } = await import("./src-DS43LCRA.js");
+  const { repoReport, siteReport, writeReport } = await import("./src-VL2ZYO6X.js");
   const out = resolve12(values.out ?? ".youi/detect");
   const report = target.kind === "repo" ? await repoReport(target.path) : await siteReport(target.urls, { out, expose: values.expose, ...process.env.YOUI_CHROMIUM ? { executablePath: process.env.YOUI_CHROMIUM } : {} });
   const file = await writeReport(report, out);
   if (values.json) json(report);
   else {
-    const shown2 = relative9(process.cwd(), file);
+    const shown2 = relative8(process.cwd(), file);
     print(renderDetect(report, shown2 && !shown2.startsWith("..") ? shown2 : file));
   }
   return 0;
 }
 async function cmdRender(values, positionals, io) {
   const root = resolve12(values.root ?? values.project ?? process.cwd());
-  const targets = positionals.map((t) => existsSync4(resolve12(t)) ? resolve12(t) : t);
+  const targets = positionals.map((t) => existsSync5(resolve12(t)) ? resolve12(t) : t);
   try {
     const report = await renderShots(root, targets, { ...values.base ? { base: values.base } : {}, ...process.env.YOUI_CHROMIUM ? { executablePath: process.env.YOUI_CHROMIUM } : {}, ...io.render });
     if (values.json) json({ ...report, next: shotsNext(report, (t) => `run youiyoux render${t ? ` ${t}` : ""} again`) });
@@ -4961,13 +5009,16 @@ async function cmdRender(values, positionals, io) {
     return 1;
   }
 }
+async function product(values) {
+  const project2 = await loadProject(resolve12(values.project ?? process.cwd()), loadOptions(values)).catch(() => null);
+  return { project: project2, root: project2?.root ?? resolve12(values.root ?? values.project ?? process.cwd()) };
+}
 async function cmdRequests(values, positionals) {
   const usage = "youiyoux requests [--status open|addressed|closed|all] [--route r]   or   youiyoux requests show <id> | reply <id> --message <text> | addressed <id> --message <what you changed>";
   const [action, id, ...rest] = positionals;
   if (rest.length > 0) throw new UsageError(usage);
-  const { RequestStore, requestBrief } = await import("./src-U5NTDPUX.js");
-  const project2 = await loadProject(resolve12(values.project ?? process.cwd()), loadOptions(values)).catch(() => null);
-  const root = project2?.root ?? resolve12(values.root ?? values.project ?? process.cwd());
+  const { RequestStore, requestBrief } = await import("./src-34R7QMJC.js");
+  const { project: project2, root } = await product(values);
   const store = new RequestStore(root, project2?.config.id ?? basename3(root));
   const agent = { kind: "agent", name: "youiyoux CLI" };
   const one = (request) => {
@@ -4994,20 +5045,24 @@ async function cmdRequests(values, positionals) {
   }
   throw new UsageError(usage);
 }
-async function cmdScreens(values, positionals) {
-  if (positionals[0] !== "capture" || positionals.length > 1 || !values.base) throw new UsageError("youiyoux screens capture --base <url of the app in development> [--route <one route>] [--project dir] [--out <screens dir>] [--storage-state <signed-in session>] [--json]");
-  const project2 = await loadProject(resolve12(values.project ?? process.cwd()), loadOptions(values)).catch(() => null);
-  const root = project2?.root ?? resolve12(values.root ?? values.project ?? process.cwd());
+async function cmdScreens(values, positionals, io) {
+  const usage = "youiyoux screens capture --base <url of the app in development> [--route <one route>] [--project dir] [--out <screens dir>] [--storage-state <signed-in session>] [--json]   or   youiyoux screens login --base <url> [--project dir] [--storage-state <file>]";
+  if (!["capture", "login"].includes(positionals[0] ?? "") || positionals.length > 1 || !values.base) throw new UsageError(usage);
+  const { root } = await product(values);
+  if (positionals[0] === "login") return screensLogin(values.base, values["storage-state"] ? resolve12(values["storage-state"]) : sessionFile(root), io);
   const dir = resolve12(values.out ?? join22(root, ".youi/screens"));
-  if (!existsSync4(join22(dir, "screens.json"))) {
+  if (!existsSync5(join22(dir, "screens.json"))) {
     process.stderr.write(`${style.error("\u2716")} no screens.json in ${dir}: list the routes to capture there, as {"schema":"youiyoux.screens/v1","project":"<name>","source":"<what the app is>","capturedAt":"","viewport":{"width":1440,"height":900},"screens":[{"route":"/","path":"/"}]}
 `);
     return 1;
   }
-  const { launchBrowser } = await import("./src-DS43LCRA.js");
+  const session = chosenSession(root, values["storage-state"] ? resolve12(values["storage-state"]) : void 0);
+  if (session?.saved) process.stderr.write(`${style.dim(`signed in with the session youiyoux screens login saved (${session.file}); delete it to capture signed out`)}
+`);
+  const { launchBrowser } = await import("./src-VL2ZYO6X.js");
   const browser = await launchBrowser(process.env.YOUI_CHROMIUM, { purpose: { what: "youiyoux screens capture", command: "youiyoux screens capture" } });
   try {
-    const report = await captureScreens(dir, { base: values.base, root, browser, ...values.route ? { routes: [values.route] } : {}, ...values["storage-state"] ? { storageState: resolve12(values["storage-state"]) } : {}, log: (line) => process.stderr.write(`${style.dim(line)}
+    const report = await captureScreens(dir, { base: values.base, root, browser, ...values.route ? { routes: [values.route] } : {}, ...session ? { storageState: session.file } : {}, log: (line) => process.stderr.write(`${style.dim(line)}
 `) });
     if (values.json) json(report);
     else print(captureText(report));
@@ -5016,13 +5071,52 @@ async function cmdScreens(values, positionals) {
     await browser.close();
   }
 }
+async function screensLogin(base, file, io) {
+  const login = io.login ?? {};
+  if (!login.browser && !process.stdin.isTTY) {
+    process.stderr.write(`${style.error("\u2716")} youiyoux screens login waits for you to sign in and press Enter: run it in a terminal
+`);
+    return 1;
+  }
+  let browser;
+  try {
+    browser = login.browser ?? await openLoginBrowser(process.env.YOUI_CHROMIUM);
+  } catch (error) {
+    process.stderr.write(`${style.error("\u2716")} youiyoux screens login opens a browser window to sign in with, and could not: ${(error instanceof Error ? error.message : String(error)).split("\n")[0]}. It needs Google Chrome installed, or YOUI_CHROMIUM set to a Chromium.
+`);
+    return 1;
+  }
+  try {
+    print(`Sign in to ${base} in the window that opened, then press Enter here (or type q and Enter to give up).`);
+    const signedIn = login.signedIn ?? (async (page) => {
+      const { createInterface } = await import("node:readline/promises");
+      const prompt = createInterface({ input: process.stdin, output: process.stdout });
+      const closed = new Promise((done) => page.once("close", () => done("closed")));
+      try {
+        return (await Promise.race([prompt.question(""), closed])).trim().toLowerCase() !== "q";
+      } finally {
+        prompt.close();
+      }
+    });
+    const result = await recordSession({ base, file, browser, signedIn });
+    if (!result.file) {
+      print("Nothing was saved: the window was closed, or you gave up. Run youiyoux screens login again to sign in.");
+      return 1;
+    }
+    print(`Saved the session (${result.cookies} cookies, storage for ${result.origins} sites) to ${result.file}, readable only by you: it holds your sign-in, so it is kept outside the product.`);
+    print("Next: youiyoux screens capture --base <url> uses it from now on; delete the file to capture signed out.");
+    return 0;
+  } finally {
+    if (!login.browser) await browser.close();
+  }
+}
 async function cmdReport(values, positionals, io) {
   if (positionals.length > 1) throw new UsageError("youiyoux report [path] [--out dir] [--render [--yes]] [--include-code] [--json]   (one repo)");
   const result = await runReport({ ...positionals[0] ? { path: positionals[0] } : {}, ...values.out ? { out: values.out } : {}, render: values.render, yes: values.yes, includeCode: values["include-code"], json: values.json }, io.report ?? {});
   return result.code;
 }
 async function cmdMcp(values) {
-  const { startStdioServer } = await import("./src-YGEZCUAO.js");
+  const { startStdioServer } = await import("./src-E25GHWWT.js");
   await startStdioServer({ projectRoot: values.project ?? process.cwd(), ...loadOptions(values), ...values.cache ? { discoverCache: values.cache } : {} });
   return -1;
 }
@@ -5112,13 +5206,13 @@ var COMMANDS = {
   parity: cmdParity,
   schema: cmdSchema
 };
-var COMMAND_NAMES = [...Object.keys(COMMANDS), "inventory", "help"];
+var COMMAND_NAMES = [...Object.keys(COMMANDS), "inventory", "gaps", "help"];
 async function main(argv, io = {}) {
   let parsed;
   try {
-    if (argv[0] === "inventory") {
+    if (argv[0] === "inventory" || argv[0] === "gaps") {
       const inventory = parseArgs({ args: argv, options: INVENTORY_OPTIONS, allowPositionals: true });
-      if (!inventory.values.help) return await guarded(() => cmdInventory(inventory.values));
+      if (!inventory.values.help) return await guarded(() => argv[0] === "gaps" ? cmdGaps(inventory.values) : cmdInventory(inventory.values));
     }
     parsed = parseArgs({ args: diffArgs(argv), options: OPTIONS, allowPositionals: true });
   } catch (error) {