youiyoux 0.1.7 → 0.1.8

package/dist/chunks/{chunk-N6RVMQCV.js → chunk-BARSW3JO.js}

@@ -53,7 +53,7 @@ import {
   vendoredPath,
   whereUsed,
   withFile
-} from "./chunk-O66KB7BU.js";
+} from "./chunk-3HON5Q5K.js";
 import {
   escapingLinks,
   within
@@ -67,7 +67,7 @@ import {
   libraryOfPackage,
   packageOf,
   playwrightCli
-} from "./chunk-7P4UXAIY.js";
+} from "./chunk-HDJ2TOWZ.js";
 import {
   MissingIndexError,
   buildGaps,
@@ -91,7 +91,7 @@ import {
   showFromCatalog,
   storeLocation,
   syncIndex
-} from "./chunk-3SQQNQDN.js";
+} from "./chunk-6GITMASZ.js";
 import {
   DL_EXT,
   buildTokens,
@@ -101,7 +101,7 @@ import {
   parseCssColor,
   parseDimension,
   readRules
-} from "./chunk-TV5UX3FE.js";
+} from "./chunk-FLBRX6Y3.js";
 import {
   Baseline,
   DESIGN_CONFIG_FILE,
@@ -115,6 +115,8 @@ import {
   PACKAGE_NAME,
   ProjectConfig,
   ScanReport,
+  WORKSPACE_FILE,
+  WorkspaceConfig,
   copyleft,
   executionLabel,
   findFiles,
@@ -136,7 +138,7 @@ import {
   shortHash,
   toPosix,
   writeFileAtomic
-} from "./chunk-YWBQO7PO.js";
+} from "./chunk-DWYDHVLZ.js";
 import {
   __toESM
 } from "./chunk-WNTS7ZO4.js";
@@ -146,7 +148,7 @@ var import_yaml4 = __toESM(require_dist(), 1);
 import { execFile as execFile5 } from "node:child_process";
 import { existsSync as existsSync5 } from "node:fs";
 import { appendFile as appendFile2, readFile as readFile10, rm as rm6, rmdir as rmdir3 } from "node:fs/promises";
-import { basename as basename5, dirname as dirname12, join as join24, relative as relative10, resolve as resolve14 } from "node:path";
+import { basename as basename5, dirname as dirname13, join as join25, relative as relative11, resolve as resolve15 } from "node:path";
 import { parseArgs, promisify as promisify5 } from "node:util";
 
 // ../cli/src/check.ts
@@ -164,7 +166,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", "adopt", "system", "sync", "link", "unlink", "scan", "watch", "hooks", "agents", "mcp", "ui", "library", "discover", "index", "report", "render", "screens", "requests", "detect", "build", "parity", "schema", "inventory", "gaps", "help"];
+var SUBCOMMANDS = ["show", "where", "bom", "check", "baseline", "rules", "plan", "migrate", "init", "adopt", "status", "system", "sync", "link", "unlink", "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);
@@ -1058,7 +1060,7 @@ async function runCheck(project2, options = {}) {
   const { report } = scan;
   const checked = new Set(scan.files);
   const unmatched = scope ? [...scope].filter((f) => !checked.has(f)) : [];
-  const failed = report.coverage.failed.filter((f) => !scope || scope.has(f.file) || !/\.(tsx?|css)$/.test(f.file));
+  const failed2 = report.coverage.failed.filter((f) => !scope || scope.has(f.file) || !/\.(tsx?|css)$/.test(f.file));
   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));
@@ -1069,7 +1071,7 @@ async function runCheck(project2, options = {}) {
   const failing = baseline ? [...baseline.comparison.new, ...baseline.comparison.regressed] : violations;
   const errors = failing.filter((v) => v.severity === "error").length + (lock ?? []).filter((i) => i.severity === "error").length;
   const drift = diff ? await analyseChange(project2, scan, diff, { violations }) : null;
-  return { identity: scan.identity, scan, scope, unmatched, failed, notRun, violations, lock, baseline, errors, incomplete: unmatched.length > 0 || failed.length > 0 || notRun.length > 0 || (drift?.incomplete.length ?? 0) > 0, diff: drift };
+  return { identity: scan.identity, scan, scope, unmatched, failed: failed2, notRun, violations, lock, baseline, errors, incomplete: unmatched.length > 0 || failed2.length > 0 || notRun.length > 0 || (drift?.incomplete.length ?? 0) > 0, diff: drift };
 }
 async function lockIssues(project2) {
   const lock = await verifyLock(project2);
@@ -1779,18 +1781,18 @@ async function runClaudeHook(input, target = {}) {
   try {
     const project2 = await load(target, dirname5(file));
     const real = (path) => realpath3(path).catch(() => path);
-    const relative11 = relPath(await real(project2.root), await real(file));
-    if (!isChecked(project2, relative11)) return SILENT;
-    const found = await changeFor(() => workingTreeChange(project2, void 0, [relative11]));
+    const relative12 = relPath(await real(project2.root), await real(file));
+    if (!isChecked(project2, relative12)) return SILENT;
+    const found = await changeFor(() => workingTreeChange(project2, void 0, [relative12]));
     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(relative11) ? `See it: youiyoux render ${quoted(relative11)} (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: ${relative11} passes the design-system check. ${see}`, project2.root) : SILENT;
+    const see = COMPONENT_FILE.test(relative12) ? `See it: youiyoux render ${quoted(relative12)} (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: ${relative12} 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 ${relative11}${known}:
+    return claudeContext(`youiyoux design-system check (advisory) on ${relative12}${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 ? `
@@ -2085,7 +2087,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-DYZIE4XZ.js");
+    const { discoverIndexPath: discoverIndexPath2, sharedStore: sharedStore2 } = await import("./src-DPFJ4S2N.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);
@@ -2096,7 +2098,7 @@ async function swapImpact(candidate, family) {
 }
 async function libraryLicence(id) {
   try {
-    const { discoverCacheDir: discoverCacheDir2, findListing } = await import("./src-DYZIE4XZ.js");
+    const { discoverCacheDir: discoverCacheDir2, findListing } = await import("./src-DPFJ4S2N.js");
     const { entry } = await findListing(discoverCacheDir2(void 0, process.env), id);
     return entry.id === id ? entry.license : null;
   } catch {
@@ -2104,7 +2106,7 @@ async function libraryLicence(id) {
   }
 }
 async function startRuleEditor(options) {
-  const { FileStore, RuleWorkflow, serveWorkflow } = await import("./src-4JGIPP5A.js");
+  const { FileStore, RuleWorkflow, serveWorkflow } = await import("./src-EUVBYTKY.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);
@@ -2145,7 +2147,7 @@ function builtHubPlan(toolRoot, options, out) {
   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"] : []];
+  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 || options.workspace ? ["--live"] : []];
   return { snapshot, server, watch: options.watch && snapshot ? [...snapshot, "--watch"] : null };
 }
 function run5(args, cwd, env, started) {
@@ -2170,6 +2172,7 @@ async function runBuiltHub(toolRoot, options) {
       const code = await run5(plan.snapshot, process.cwd(), {}, (child) => children.add(child));
       if (code !== 0) return code;
     }
+    options.workspace?.((project2) => run5(builtHubPlan(toolRoot, { ...options, project: project2 }, out).snapshot, process.cwd(), {}, (child) => children.add(child)));
     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 {
@@ -2189,6 +2192,7 @@ async function runHub(toolRoot, options) {
     const code = await run5(plan.snapshot, process.cwd(), {});
     if (code !== 0) return code;
   }
+  options.workspace?.((project2) => run5(hubPlan(toolRoot, { ...options, project: project2 }).snapshot, process.cwd(), {}));
   const watcher = plan.watch ? spawn(process.execPath, plan.watch, { cwd: process.cwd(), stdio: "inherit" }) : null;
   try {
     return await run5(plan.vite, plan.web, plan.env);
@@ -2630,15 +2634,193 @@ async function extractSystem(project2, dir, options = {}) {
   }
 }
 
+// ../cli/src/status.ts
+import { realpath as realpath5 } from "node:fs/promises";
+import { dirname as dirname9, join as join16, relative as relative8, resolve as resolve10 } from "node:path";
+var placeOf = (cwd, root) => {
+  const rel = relative8(cwd, root) || ".";
+  return rel.split(/[\\/]/).filter((part) => part === "..").length > 1 ? resolve10(root) : rel;
+};
+var WRITES = /* @__PURE__ */ new Set(["created", "updated", "merged", "adopted", "conflict", "removed"]);
+function sourceOf(project2) {
+  if (project2.linked) return `your checkout ${project2.linked}`;
+  const source = project2.config.source;
+  if ("package" in source) return `package ${source.package}`;
+  if ("git" in source) return `git ${source.git} at ${source.ref}`;
+  return resolve10(project2.root) === resolve10(project2.repo.root) ? "this repo" : `path ${source.path}`;
+}
+function nextStep(s) {
+  if (s.sync.state === "never") return "youiyoux sync: this product has never been synced with its System";
+  if (s.sync.state === "conflict") return "youiyoux sync: resolve the conflicts it reports, then youiyoux sync --adopt records them";
+  if (s.sync.state === "behind") return `youiyoux sync: ${plural(s.sync.changes.length, "file")} would change`;
+  if (s.check.incomplete) return "youiyoux check: some files or rules could not be checked, and it says which";
+  if (s.check.errors > 0) return `youiyoux check: fix ${plural(s.check.errors, "error")}`;
+  if (s.requests.open > 0) return `youiyoux requests: answer ${plural(s.requests.open, "open request")}`;
+  if (s.check.warnings > 0 && !s.check.baseline) return `youiyoux check: ${plural(s.check.warnings, "warning")} to fix, or youiyoux baseline records them as accepted debt`;
+  return "nothing to do";
+}
+async function projectStatus(project2, cwd = process.cwd()) {
+  const lock = await readLock(project2.root);
+  const { actions } = await syncProject(project2, { dryRun: true });
+  const changes = actions.filter((a) => WRITES.has(a.action)).map((a) => ({ file: a.file, action: a.action }));
+  const baselineFile2 = baselinePath(project2);
+  const check = await runCheck(project2, { baseline: await readTextOrNull(baselineFile2) === null ? null : baselineFile2 });
+  const comparison = check.baseline?.comparison;
+  const counted = comparison ? [...comparison.new, ...comparison.regressed] : check.violations;
+  const usages = check.scan.report.usages;
+  const { RequestStore } = await import("./src-EUVBYTKY.js");
+  const requests = await new RequestStore(project2.root, project2.config.id).list();
+  const status = {
+    id: project2.config.id,
+    root: placeOf(cwd, project2.root),
+    system: { id: project2.system.config.id, name: project2.system.config.name, version: project2.system.config.version, source: sourceOf(project2), linked: Boolean(project2.linked), commit: project2.designCommit ?? null },
+    lock: lock ? { systemVersion: lock.systemVersion, syncedAt: lock.syncedAt } : null,
+    sync: { state: lock === null ? "never" : actions.some((a) => a.action === "conflict") ? "conflict" : changes.length > 0 ? "behind" : "current", changes },
+    drift: (await verifyLock(project2) ?? []).map((i) => ({ file: i.file, severity: i.severity, message: i.message })),
+    check: {
+      errors: check.errors,
+      warnings: counted.filter((v) => v.severity === "warn").length,
+      baseline: comparison ? { known: comparison.known.length, new: comparison.new.length + comparison.regressed.length, fixed: comparison.fixed.reduce((n, f) => n + f.gone, 0) } : null,
+      incomplete: check.incomplete
+    },
+    components: { system: project2.system.components.length, used: new Set(usages.map((u) => u.element)).size, sites: usages.length },
+    requests: { open: requests.requests.filter((r) => r.status === "open").length, addressed: requests.requests.filter((r) => r.status === "addressed").length, unreadable: requests.unreadable.length }
+  };
+  return { ...status, next: nextStep(status) };
+}
+async function statusTargets(cwd, named2) {
+  if (named2) return { roots: [resolve10(named2)], workspace: null };
+  const product2 = findUp(cwd, PROJECT_FILE);
+  if (product2) return { roots: [product2], workspace: null };
+  const at = findUp(cwd, WORKSPACE_FILE);
+  if (at) {
+    const file = join16(at, WORKSPACE_FILE);
+    const workspace = await readDefinition(file, WorkspaceConfig);
+    return { roots: workspace.projects.map((p) => resolve10(at, p)), workspace: file };
+  }
+  const top = findUp(cwd, ".git") ?? null;
+  if (top === null) return { roots: [], workspace: null };
+  const configs = await findFiles(cwd, [`**/${PROJECT_FILE}`]);
+  const roots = [];
+  for (const config of configs) {
+    const dir = resolve10(cwd, dirname9(config));
+    if (await realpath5(findUp(dir, ".git") ?? dir) === await realpath5(top)) roots.push(dir);
+  }
+  return { roots, workspace: null };
+}
+async function workspaceStatus(cwd, named2) {
+  const { roots, workspace } = await statusTargets(cwd, named2);
+  const projects = [];
+  for (const root of roots) {
+    try {
+      projects.push(await projectStatus(await loadProject(root), cwd));
+    } catch (error) {
+      const label = placeOf(cwd, root);
+      projects.push({ root: label, error: error instanceof Error ? error.message : String(error), next: await readTextOrNull(join16(root, PROJECT_FILE)) === null ? `youiyoux adopt or youiyoux init --design <dir> in ${label}` : `fix ${join16(label, PROJECT_FILE)}` });
+    }
+  }
+  return { schema: "youi.status/v1", generatedAt: (/* @__PURE__ */ new Date()).toISOString(), workspace: workspace ? relative8(cwd, workspace) || WORKSPACE_FILE : null, projects };
+}
+var failed = (p) => "error" in p;
+function projectLines(s) {
+  const row = (label, text) => `  ${padEnd(label, 11)} ${text}`;
+  const synced = s.lock ? `synced ${s.lock.syncedAt.slice(0, 10)}${s.lock.systemVersion !== s.system.version ? ` at v${s.lock.systemVersion}` : ""}` : "never synced";
+  const sync = { current: style.ok("up to date"), behind: style.warn(`behind: ${plural(s.sync.changes.length, "file")} would change`), conflict: style.error(`conflict: ${plural(s.sync.changes.filter((c) => c.action === "conflict").length, "file")}`), never: style.warn("never synced") }[s.sync.state];
+  const edited = s.drift.filter((d) => d.severity === "warn");
+  const broken = s.drift.filter((d) => d.severity === "error");
+  const drift = s.drift.length === 0 ? style.ok("none") : [broken.length > 0 ? style.error(`${plural(broken.length, "file")} wrong (${broken.slice(0, 3).map((d) => d.file.split("/").at(-1)).join(", ")})`) : "", edited.length > 0 ? style.warn(`${plural(edited.length, "owned file")} edited locally, merged on sync (${edited.slice(0, 3).map((d) => d.file.split("/").at(-1)).join(", ")})`) : ""].filter(Boolean).join("; ");
+  const { check } = s;
+  const counts = `${check.errors > 0 ? style.error(plural(check.errors, "error")) : style.ok("0 errors")} \xB7 ${plural(check.warnings, "warning")}`;
+  const baseline = check.baseline ? style.dim(` beyond the baseline (${check.baseline.known} accepted${check.baseline.fixed > 0 ? `, ${check.baseline.fixed} fixed` : ""})`) : "";
+  return [
+    `${style.bold(s.id)}${s.root === s.id ? "" : ` ${style.dim(`\xB7 ${s.root}`)}`} \xB7 ${s.system.name} v${s.system.version} ${style.dim(`(${s.system.source}${s.system.linked ? ", linked" : ""}) \xB7 ${synced}`)}`,
+    row("sync", sync),
+    row("drift", drift),
+    row("check", `${counts}${baseline}${check.incomplete ? style.warn(" \xB7 incomplete: not a pass") : ""}`),
+    row("components", `${s.components.used} of ${s.components.system} System components used, at ${plural(s.components.sites, "site")}`),
+    row("requests", s.requests.open + s.requests.addressed + s.requests.unreadable === 0 ? style.dim("none") : [s.requests.open > 0 ? style.warn(`${s.requests.open} open`) : "0 open", `${s.requests.addressed} addressed`, ...s.requests.unreadable > 0 ? [style.error(`${s.requests.unreadable} unreadable`)] : []].join(" \xB7 ")),
+    `${style.bold("Next:")} ${s.next}`
+  ];
+}
+function renderStatus(report) {
+  if (report.projects.length === 0) return `${style.warn("!")} no product here: no ${PROJECT_FILE} upward, no ${WORKSPACE_FILE}, and none in this repository below here
+Next: youiyoux adopt makes this product's own UI its design system, or youiyoux init --design <dir> follows one`;
+  const blocks = report.projects.map((p) => failed(p) ? [`${style.bold(p.root)} ${style.error("\u2716")} ${p.error}`, `${style.bold("Next:")} ${p.next}`] : projectLines(p));
+  const head = report.projects.length > 1 ? [`${style.bold("workspace")} ${style.dim(`\xB7 ${plural(report.projects.length, "product")}${report.workspace ? ` from ${report.workspace}` : " in this repository"}`)}`, ""] : [];
+  return [...head, ...blocks.flatMap((b, i) => i === 0 ? b : ["", ...b])].join("\n");
+}
+var statusExitCode = (report) => report.projects.some((p) => failed(p) || p.check.incomplete || p.check.errors > 0 || p.sync.state === "conflict") ? 1 : 0;
+
+// ../cli/src/workspace-hub.ts
+import { randomBytes as randomBytes2 } from "node:crypto";
+import { createServer } from "node:http";
+var KEY_HEADER = "x-youi-session";
+function send(res, status, body) {
+  res.writeHead(status, { "Content-Type": "application/json", "Cache-Control": "no-store" });
+  res.end(JSON.stringify(body));
+}
+async function readBody(req) {
+  let text = "";
+  for await (const chunk2 of req) {
+    text += String(chunk2);
+    if (text.length > 4096) throw new Error("request too large");
+  }
+  return text ? JSON.parse(text) : {};
+}
+async function startWorkspaceHub(options) {
+  const key2 = randomBytes2(18).toString("base64url");
+  let report = await options.status();
+  let current = options.current;
+  let busy = false;
+  const server = createServer((req, res) => {
+    void (async () => {
+      const path = (req.url ?? "").split("?")[0];
+      if (req.method === "GET" && path === "/api/workspace") return send(res, 200, { report, current });
+      if (req.method !== "POST" || path !== "/api/workspace/open" && path !== "/api/workspace/refresh") {
+        return send(res, 404, { error: "Not in a workspace hub: Rules and Changes are read-only here; youiyoux ui --project <dir> opens the rule editor on one product" });
+      }
+      if (req.headers[KEY_HEADER] !== key2) return send(res, 401, { error: "this tab does not carry this run's key" });
+      if (busy) return send(res, 409, { error: "another product is opening; try again in a moment" });
+      busy = true;
+      try {
+        if (path === "/api/workspace/refresh") {
+          report = await options.status();
+          return send(res, 200, { report, current });
+        }
+        const { index } = await readBody(req);
+        const entry = typeof index === "number" && Number.isInteger(index) ? report.projects[index] : void 0;
+        if (entry === void 0 || options.roots[index] === void 0) return send(res, 400, { error: `no product ${JSON.stringify(index)} in this workspace` });
+        if ("error" in entry) return send(res, 400, { error: `${entry.root} cannot be opened: ${entry.error}`, problems: [entry.next] });
+        const code = await options.open(options.roots[index]);
+        if (code !== 0) return send(res, 500, { error: `the snapshot of ${entry.root} failed (exit ${code}); the hub still shows the product it showed` });
+        current = index;
+        return send(res, 200, { report, current });
+      } catch (error) {
+        return send(res, 400, { error: error instanceof Error ? error.message : String(error) });
+      } finally {
+        busy = false;
+      }
+    })();
+  });
+  await new Promise((done) => server.listen(0, "127.0.0.1", done));
+  const address = server.address();
+  const port = typeof address === "object" && address ? address.port : 0;
+  return {
+    url: `http://127.0.0.1:${port}`,
+    key: key2,
+    close: () => new Promise((done) => server.close(() => done()))
+  };
+}
+
 // ../cli/src/index-store.ts
 import { appendFile, mkdir as mkdir4, readFile as readFile6, stat as stat2, rename as rename2, mkdtemp as mkdtemp4, rm as rm5 } from "node:fs/promises";
-import { dirname as dirname9, join as join16, resolve as resolve10 } from "node:path";
+import { dirname as dirname10, join as join17, resolve as resolve11 } from "node:path";
 var SOURCES_FILE = "index-sources.json";
 var SCANS_LOG = "scans.jsonl";
 var EMPTY = { discover: null, inventories: [], projects: [] };
 async function readIndexSources(home) {
   try {
-    const raw = JSON.parse(await readFile6(join16(home, SOURCES_FILE), "utf8"));
+    const raw = JSON.parse(await readFile6(join17(home, SOURCES_FILE), "utf8"));
     return { discover: raw.discover ?? null, inventories: raw.inventories ?? [], projects: raw.projects ?? [] };
   } catch {
     return EMPTY;
@@ -2651,14 +2833,14 @@ async function noteSource(home, change) {
     inventories: change.inventory && !sources.inventories.includes(change.inventory) ? [...sources.inventories, change.inventory] : sources.inventories,
     projects: change.project ? [...sources.projects.filter((p) => p.root !== change.project.root), change.project] : sources.projects
   };
-  await writeFileAtomic(join16(home, SOURCES_FILE), `${JSON.stringify(next2, null, 2)}
+  await writeFileAtomic(join17(home, SOURCES_FILE), `${JSON.stringify(next2, null, 2)}
 `);
 }
 async function recordInventory(store, home, report, file) {
-  const run7 = inventoryRun(report, resolve10(file));
+  const run7 = inventoryRun(report, resolve11(file));
   const logged = { run: run7.run, source: run7.source, scannedAt: run7.scannedAt, projects: run7.projects, families: run7.families };
   await mkdir4(home, { recursive: true });
-  await appendFile(join16(home, SCANS_LOG), `${JSON.stringify({ schema: "youi.scan-log/v1", ...logged })}
+  await appendFile(join17(home, SCANS_LOG), `${JSON.stringify({ schema: "youi.scan-log/v1", ...logged })}
 `);
   await store.recordInventory(run7);
   await noteSource(home, { inventory: run7.source });
@@ -2669,7 +2851,7 @@ 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 readLog(home) {
-  const text = await readFile6(join16(home, SCANS_LOG), "utf8").catch(() => "");
+  const text = await readFile6(join17(home, SCANS_LOG), "utf8").catch(() => "");
   return text.split("\n").flatMap((line) => {
     if (!line.trim()) return [];
     try {
@@ -2684,9 +2866,9 @@ async function rebuildIndex(path, options = {}) {
   const started = performance.now();
   const env = options.env ?? process.env;
   const home = indexHome(path, env);
-  await mkdir4(dirname9(path), { recursive: true });
+  await mkdir4(dirname10(path), { recursive: true });
   const scratch = !env.DATABASE_URL ? await mkdtemp4(`${path}.rebuild-`) : null;
-  const target = scratch ? join16(scratch, "index.db") : path;
+  const target = scratch ? join17(scratch, "index.db") : path;
   const store = scratch ? await openSqlite(target) : await sharedStore(path, env);
   try {
     if (env.DATABASE_URL) await store.reset();
@@ -2694,7 +2876,7 @@ async function rebuildIndex(path, options = {}) {
     const sources = await readIndexSources(home);
     const cache = options.discoverCache ?? sources.discover;
     let discover = { cache, chosen: 0, all: 0 };
-    if (cache && await stat2(join16(cache, "index.json")).then(() => true, () => false)) {
+    if (cache && await stat2(join17(cache, "index.json")).then(() => true, () => false)) {
       const loaded = await ingestCatalog(store, cache);
       discover = { cache, chosen: loaded.chosen, all: loaded.all };
     }
@@ -2711,25 +2893,25 @@ async function rebuildIndex(path, options = {}) {
       await store.recordInventory(inventoryRun(parsed.data, file));
       replayed++;
     }
-    const failed = [];
+    const failed2 = [];
     let projects = 0;
     const gone = [];
     for (const source of sources.projects) {
       if (!await stat2(source.root).then((s) => s.isDirectory(), () => false)) {
         gone.push(source.root);
-        failed.push({ root: source.root, reason: "folder not found (moved or deleted), skipped" });
+        failed2.push({ root: source.root, reason: "folder not found (moved or deleted), skipped" });
         continue;
       }
       try {
         const project2 = await loadProject(source.root, source.options);
-        const usage = ScanReport.safeParse(await readJson(source.usage ?? join16(project2.root, ".youi/usage.json")));
+        const usage = ScanReport.safeParse(await readJson(source.usage ?? join17(project2.root, ".youi/usage.json")));
         await recordProject(store, project2, usage.success ? usage.data : null);
         projects++;
       } catch (error) {
-        failed.push({ root: source.root, reason: error instanceof Error ? error.message.split("\n")[0] : String(error) });
+        failed2.push({ root: source.root, reason: error instanceof Error ? error.message.split("\n")[0] : String(error) });
       }
     }
-    const broken = failed.filter((f) => !gone.includes(f.root));
+    const broken = failed2.filter((f) => !gone.includes(f.root));
     if (broken.length) throw new Error(`Index rebuild failed: ${broken.map((f) => `${f.root}: ${f.reason}`).join("; ")}`);
     await linkCandidates(store);
     const tables = (await store.stats()).tables;
@@ -2753,7 +2935,7 @@ async function rebuildIndex(path, options = {}) {
         throw error;
       }
     }
-    return { location: scratch ? path : store.location, discover, scans: log.length, inventories: { replayed, missing }, projects: { replayed: projects, failed }, tables, durationMs: Math.round(performance.now() - started) };
+    return { location: scratch ? path : store.location, discover, scans: log.length, inventories: { replayed, missing }, projects: { replayed: projects, failed: failed2 }, tables, durationMs: Math.round(performance.now() - started) };
   } finally {
     if (scratch) {
       await store.close();
@@ -2939,9 +3121,9 @@ function renderAdoptionRequest(request) {
 }
 
 // ../cli/src/report/run.ts
-import { randomBytes as randomBytes2 } from "node:crypto";
+import { randomBytes as randomBytes3 } from "node:crypto";
 import { mkdir as mkdir5, rename as rename3, stat as stat3, writeFile as writeFile2 } from "node:fs/promises";
-import { join as join23, relative as relative9, resolve as resolve13 } from "node:path";
+import { join as join24, relative as relative10, resolve as resolve14 } from "node:path";
 
 // ../cli/src/report/card.ts
 import { deflateSync } from "node:zlib";
@@ -3177,7 +3359,7 @@ function drawCard(input) {
 
 // ../cli/src/report/model.ts
 import { readFile as readFile8 } from "node:fs/promises";
-import { join as join20 } from "node:path";
+import { join as join21 } from "node:path";
 
 // ../cli/src/report/filters.ts
 var SHOWCASE_GLOBS = ["**/{__stories__,.storybook,storybook,storybook-static,example,examples,demo,demos,playground,showcase,showcases}/**", "**/*.stories.*", "**/*.story.*"];
@@ -3304,11 +3486,11 @@ function publicLook(caption) {
 
 // ../cli/src/report/groups.ts
 import { existsSync as existsSync3 } from "node:fs";
-import { join as join18 } from "node:path";
+import { join as join19 } from "node:path";
 
 // ../cli/src/report/imports.ts
 import { realpathSync } from "node:fs";
-import { dirname as dirname10, join as join17, relative as relative8, resolve as resolve11 } from "node:path";
+import { dirname as dirname11, join as join18, relative as relative9, resolve as resolve12 } from "node:path";
 import ts from "typescript";
 var resolvers = /* @__PURE__ */ new Map();
 function resolverOf(root) {
@@ -3316,7 +3498,7 @@ function resolverOf(root) {
   if (!found) {
     const config = ts.findConfigFile(root, ts.sys.fileExists, "tsconfig.json") ?? ts.findConfigFile(root, ts.sys.fileExists, "jsconfig.json");
     const read = config ? ts.readConfigFile(config, ts.sys.readFile) : null;
-    const options = config && read && !read.error ? ts.parseJsonConfigFileContent(read.config, ts.sys, dirname10(config)).options : {};
+    const options = config && read && !read.error ? ts.parseJsonConfigFileContent(read.config, ts.sys, dirname11(config)).options : {};
     found = { options, cache: ts.createModuleResolutionCache(root, (name) => name, options) };
     resolvers.set(root, found);
   }
@@ -3327,13 +3509,13 @@ function clearImportCache() {
 }
 async function verifiedImport(root, keeper, from, suggested) {
   const { options, cache } = resolverOf(root);
-  let local = relative8(dirname10(join17(root, from)), join17(root, keeper)).replaceAll("\\", "/").replace(/\.(tsx?|jsx?|mjs)$/, "");
+  let local = relative9(dirname11(join18(root, from)), join18(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, resolve11(root, from), options, ts.sys, cache).resolvedModule?.resolvedFileName;
+    const found = ts.resolveModuleName(specifier, resolve12(root, from), options, ts.sys, cache).resolvedModule?.resolvedFileName;
     if (found) {
       try {
-        if (realpathSync(found) === realpathSync(join17(root, keeper))) return specifier;
+        if (realpathSync(found) === realpathSync(join18(root, keeper))) return specifier;
       } catch {
       }
     }
@@ -3741,7 +3923,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) => existsSync3(join18(project2.root, dir, "package.json"))).sort((a, b) => b.length - a.length);
+  const roots = [...dirs].filter((dir) => existsSync3(join19(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 };
 }
@@ -3749,11 +3931,11 @@ function factsOf(project2, id, modules, eligible, workspaceNames, dependencies,
 // ../cli/src/report/projects.ts
 var import_yaml3 = __toESM(require_dist(), 1);
 import { readFile as readFile7 } from "node:fs/promises";
-import { basename as basename4, join as join19, resolve as resolve12 } from "node:path";
+import { basename as basename4, join as join20, resolve as resolve13 } from "node:path";
 var UI_FILES = ["**/*.{tsx,jsx,astro,vue,svelte}"];
 var strings = (value) => Array.isArray(value) ? value.filter((v) => typeof v === "string") : [];
 async function workspaceGlobs(root, pkg) {
-  const pnpm = await readFile7(join19(root, "pnpm-workspace.yaml"), "utf8").catch(() => null);
+  const pnpm = await readFile7(join20(root, "pnpm-workspace.yaml"), "utf8").catch(() => null);
   if (pnpm !== null) {
     try {
       const globs2 = strings((0, import_yaml3.parse)(pnpm)?.packages);
@@ -3767,8 +3949,8 @@ async function workspaceGlobs(root, pkg) {
 }
 var hasUi = async (dir) => (await findFiles(dir, UI_FILES, DEFAULT_EXCLUDE)).length > 0;
 async function findProjects(dir) {
-  const root = resolve12(dir);
-  const pkg = await readJson(join19(root, "package.json"));
+  const root = resolve13(dir);
+  const pkg = await readJson(join20(root, "package.json"));
   const name = typeof pkg?.name === "string" && pkg.name.trim() ? pkg.name.trim() : basename4(root);
   const single = { dir: ".", root, name: typeof pkg?.name === "string" ? pkg.name : null };
   const workspace = await workspaceGlobs(root, pkg);
@@ -3779,12 +3961,12 @@ async function findProjects(dir) {
   const projects = [];
   const skipped = [];
   for (const member of members) {
-    const memberRoot = join19(root, member);
+    const memberRoot = join20(root, member);
     if (!await hasUi(memberRoot)) {
       skipped.push(member);
       continue;
     }
-    const memberPkg = await readJson(join19(memberRoot, "package.json"));
+    const memberPkg = await readJson(join20(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 };
@@ -3811,7 +3993,7 @@ var Lines = class {
     if (!this.enabled) return { at };
     let lines = this.files.get(file);
     if (!lines) {
-      lines = (await readFile8(join20(this.root, file), "utf8").catch(() => "")).split("\n");
+      lines = (await readFile8(join21(this.root, file), "utf8").catch(() => "")).split("\n");
       this.files.set(file, lines);
     }
     const code = lines[line - 1]?.trim();
@@ -3826,15 +4008,15 @@ function hardcodedValue(finding3) {
   const value = bracket ?? (declaration ? `${declaration[2]} (${declaration[1]})` : finding3.text);
   return { word: word === "type" ? "text size" : word, value, tokens };
 }
-async function modulesOf(project2, target, failed) {
+async function modulesOf(project2, target, failed2) {
   const modules = [];
   for (const file of target.files) {
     if (isShowcase(file)) continue;
     try {
-      const module = await parseModule(file, await readFile8(join20(project2.root, file), "utf8"));
+      const module = await parseModule(file, await readFile8(join21(project2.root, file), "utf8"));
       if (module) modules.push(module);
     } catch (error) {
-      failed.push(`${repoPath(project2.dir, file)}: ${errorText(error)}`);
+      failed2.push(`${repoPath(project2.dir, file)}: ${errorText(error)}`);
     }
   }
   return modules;
@@ -3855,7 +4037,7 @@ async function grouped(project2, found, lines, describe) {
   return findings2.sort((a, b) => b.count - a.count || a.title.localeCompare(b.title));
 }
 async function analyseProject(project2, index, inventory, inventoryError, workspaceNames, lines) {
-  const failed = [];
+  const failed2 = [];
   const incomplete = [];
   const notes = [];
   const projectId = inventory?.projects[index]?.id;
@@ -3863,7 +4045,7 @@ async function analyseProject(project2, index, inventory, inventoryError, worksp
   let target = null;
   try {
     target = await loadInventoryTarget(project2.root);
-    modules = await modulesOf(project2, target, failed);
+    modules = await modulesOf(project2, target, failed2);
   } catch (error) {
     incomplete.push(`The code could not be read (${errorText(error)})`);
   }
@@ -3906,7 +4088,7 @@ async function analyseProject(project2, index, inventory, inventoryError, worksp
   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(`${repoPath(project2.dir, f.file)}: ${f.reason}`);
+  for (const f of inventoryProject?.failed ?? []) failed2.push(`${repoPath(project2.dir, f.file)}: ${f.reason}`);
   let hardcoded = [];
   let offLibrary = [];
   const everyLine = () => true;
@@ -3935,7 +4117,7 @@ async function analyseProject(project2, index, inventory, inventoryError, worksp
       incomplete.push(`Library choices were not compared (${errorText(error)}); run ${NPX} detect ${project2.dir} to see why`);
     }
   }
-  const pkg = await readFile8(join20(project2.root, "package.json"), "utf8").then((text) => JSON.parse(text), () => null);
+  const pkg = await readFile8(join21(project2.root, "package.json"), "utf8").then((text) => JSON.parse(text), () => null);
   const dependencies = new Set(["dependencies", "devDependencies", "peerDependencies"].flatMap((key2) => Object.keys(pkg?.[key2] ?? {})));
   const importer = changeProject ? await importOf(changeProject) : () => "";
   const facts = factsOf(project2, projectId ?? null, modules, eligible, workspaceNames, dependencies, target?.files ?? [], importer);
@@ -3943,7 +4125,7 @@ async function analyseProject(project2, index, inventory, inventoryError, worksp
     dir: project2.dir,
     name: project2.name,
     files: inventoryProject?.files ?? modules.length,
-    failed,
+    failed: failed2,
     libraries,
     unused,
     definitions: inventory ? inventory.definitions.filter((d) => d.project === projectId && !isShowcase(d.file)).length : 0,
@@ -4379,36 +4561,36 @@ ${model.projects.map((p) => projectSection(p, many, looks)).join("\n")}
 import { spawn as spawn2 } from "node:child_process";
 import { existsSync as existsSync4, readFileSync as readFileSync2 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
-import { dirname as dirname11, join as join21 } from "node:path";
+import { dirname as dirname12, join as join22 } 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 = () => dirname11(playwrightCli());
+var playwrightDir = () => dirname12(playwrightCli());
 function browsersPath(env) {
   const set = env.PLAYWRIGHT_BROWSERS_PATH;
-  if (set === "0") return join21(playwrightDir(), ".local-browsers");
+  if (set === "0") return join22(playwrightDir(), ".local-browsers");
   if (set) return set;
-  if (process.platform === "darwin") return join21(homedir2(), "Library/Caches/ms-playwright");
-  if (process.platform === "win32") return join21(env.LOCALAPPDATA ?? join21(homedir2(), "AppData/Local"), "ms-playwright");
-  return join21(env.XDG_CACHE_HOME ?? join21(homedir2(), ".cache"), "ms-playwright");
+  if (process.platform === "darwin") return join22(homedir2(), "Library/Caches/ms-playwright");
+  if (process.platform === "win32") return join22(env.LOCALAPPDATA ?? join22(homedir2(), "AppData/Local"), "ms-playwright");
+  return join22(env.XDG_CACHE_HOME ?? join22(homedir2(), ".cache"), "ms-playwright");
 }
 function chromiumStatus(env = process.env) {
   if (env.YOUI_CHROMIUM) return { available: existsSync4(env.YOUI_CHROMIUM), where: env.YOUI_CHROMIUM };
   try {
-    const browsers = JSON.parse(readFileSync2(join21(playwrightDir(), "browsers.json"), "utf8"));
+    const browsers = JSON.parse(readFileSync2(join22(playwrightDir(), "browsers.json"), "utf8"));
     const revision2 = browsers.browsers.find((b) => b.name === "chromium-headless-shell")?.revision;
-    const dir = join21(browsersPath(env), `chromium_headless_shell-${revision2}`);
-    return { available: revision2 !== void 0 && existsSync4(join21(dir, "INSTALLATION_COMPLETE")), where: dir };
+    const dir = join22(browsersPath(env), `chromium_headless_shell-${revision2}`);
+    return { available: revision2 !== void 0 && existsSync4(join22(dir, "INSTALLATION_COMPLETE")), where: dir };
   } catch {
     return { available: false, where: "playwright-core is not installed" };
   }
 }
 function downloadChromium() {
-  return new Promise((resolve15) => {
-    const child = spawn2(process.execPath, [join21(playwrightDir(), "cli.js"), "install", "chromium-headless-shell"], { stdio: ["ignore", 2, 2] });
-    child.on("error", () => resolve15(false));
-    child.on("close", (code) => resolve15(code === 0));
+  return new Promise((resolve16) => {
+    const child = spawn2(process.execPath, [join22(playwrightDir(), "cli.js"), "install", "chromium-headless-shell"], { stdio: ["ignore", 2, 2] });
+    child.on("error", () => resolve16(false));
+    child.on("close", (code) => resolve16(code === 0));
   });
 }
 var dataUri = (file) => file && existsSync4(file) ? `data:image/png;base64,${readFileSync2(file).toString("base64")}` : null;
@@ -4422,24 +4604,24 @@ async function addLooks(model, repoRoot, options = {}) {
     const where2 = section.dir === "." ? "this repo" : section.dir;
     try {
       const installed = (name) => {
-        let dir = join21(repoRoot, section.dir);
+        let dir = join22(repoRoot, section.dir);
         while (true) {
-          if (existsSync4(join21(dir, "node_modules", name, "package.json"))) return true;
-          if (dir === repoRoot || dirname11(dir) === dir) return false;
-          dir = dirname11(dir);
+          if (existsSync4(join22(dir, "node_modules", name, "package.json"))) return true;
+          if (dir === repoRoot || dirname12(dir) === dir) return false;
+          dir = dirname12(dir);
         }
       };
       if (!installed("react") || !installed("react-dom")) {
         missing.push(where2);
         continue;
       }
-      const projectRoot = join21(repoRoot, section.dir);
+      const projectRoot = join22(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(where2);
         continue;
       }
-      const report = await renderShots(join21(repoRoot, section.dir), names, { download: false, base: "HEAD", ...options.executablePath ? { executablePath: options.executablePath } : {}, ...options.cache ? { cache: options.cache } : {}, ...options.log ? { log: options.log } : {} });
+      const report = await renderShots(join22(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) => UNDRAWABLE.test(note));
       if (unavailable) {
         missing.push(where2);
@@ -4511,7 +4693,7 @@ function renderMarkdown(model, reportFile) {
 import { realpathSync as realpathSync2 } from "node:fs";
 import { readFile as readFile9 } from "node:fs/promises";
 import { homedir as homedir3, userInfo as userInfo2 } from "node:os";
-import { join as join22 } from "node:path";
+import { join as join23 } from "node:path";
 var REDACTED = "[redacted]";
 var OUTSIDE = "[path outside the repo]";
 var MIN_VALUE = 6;
@@ -4523,7 +4705,7 @@ async function dotenvValues(root) {
   const files = await findFiles(root, [".env", ".env.*", "**/.env", "**/.env.*"]).catch(() => []);
   const values = [];
   for (const file of files) {
-    const text = await readFile9(join22(root, file), "utf8").catch(() => "");
+    const text = await readFile9(join23(root, file), "utf8").catch(() => "");
     for (const line of text.split(/\r?\n/)) {
       const match = /^\s*(?:export\s+)?[A-Za-z_][A-Za-z0-9_.-]*\s*=\s*(.*)$/.exec(line);
       if (!match) continue;
@@ -4650,12 +4832,12 @@ async function askTerminal(question) {
   }
 }
 async function writeBinaryAtomic(file, bytes) {
-  const temp = `${file}.${process.pid}.${randomBytes2(6).toString("hex")}.tmp`;
+  const temp = `${file}.${process.pid}.${randomBytes3(6).toString("hex")}.tmp`;
   await writeFile2(temp, bytes);
   await rename3(temp, file);
 }
 var shown = (file) => {
-  const rel = relative9(process.cwd(), file);
+  const rel = relative10(process.cwd(), file);
   return rel && !rel.startsWith("..") ? rel : file;
 };
 async function runReport(options = {}, io = {}) {
@@ -4664,7 +4846,7 @@ async function runReport(options = {}, io = {}) {
   const error = io.error ?? ((text) => void process.stderr.write(`${text}
 `));
   const env = io.env ?? process.env;
-  const root = resolve13(options.path ?? process.cwd());
+  const root = resolve14(options.path ?? process.cwd());
   if (!(await stat3(root).catch(() => null))?.isDirectory()) {
     error(`\u2716 ${options.path ?? root} is not a directory: run ${NPX} in a repo, or pass its path (${NPX} path/to/repo)`);
     return { code: 2, files: null, model: null };
@@ -4694,9 +4876,9 @@ async function runReport(options = {}, io = {}) {
   model.durationMs += Math.round(performance.now() - started);
   const redactor = await Redactor.forRepo(root, { includeCode: options.includeCode === true, env });
   const clean = redactor.model(model);
-  const outDir = resolve13(options.out ?? root);
+  const outDir = resolve14(options.out ?? root);
   await mkdir5(outDir, { recursive: true });
-  const files = { report: join23(outDir, REPORT_FILE), card: join23(outDir, CARD_FILE), summary: join23(outDir, SUMMARY_FILE) };
+  const files = { report: join24(outDir, REPORT_FILE), card: join24(outDir, CARD_FILE), summary: join24(outDir, SUMMARY_FILE) };
   const t = clean.totals;
   const card = {
     repo: redactor.scrub(clean.repo),
@@ -4780,6 +4962,11 @@ ${style.bold("Anywhere")}  ${style.dim("no design system needed")}
                            an unchanged component comes from the cache (YOUI_SPECIMEN_CACHE)
 
 ${style.bold("In a product repo")}
+  status [--json]          where the product stands with its design system, in a few lines: the System
+                           and its source, what a sync would change (a dry run, offline), local drift,
+                           errors and warnings (beyond the baseline), components used, open requests,
+                           and the one thing to do next. In a workspace (youi.workspace.json, or a repo
+                           holding several products), one block per product
   adopt [--components dir] [--css file] [--system id] [--fork] [--dry-run]
                            make this product's own UI its design system, kept in this repo: a draft
                            contract per component in the components folder (the files stay where they
@@ -4883,7 +5070,8 @@ ${style.bold("Detect")}  ${style.dim("which UI libraries a repo or website uses
 
 ${style.bold("The hub")}
   ui [--design dir] [--project dir] [--config file] [--root dir] [--port n] [--watch] [--state dir] [--inventory file] [--detect file]
-                           open the web hub on a design system (default: the demo system);
+                           open the web hub on a design system (default: the demo system; beside a
+                           youi.workspace.json, its products, with Work > Workspace to switch);
                            --project adds that product's usage map (read-only scan) and the
                            rule editor (System > Rules, Work > Changes): drafts, impact preview,
                            approval, a review branch in the design repo (drafts kept in --state);
@@ -4992,10 +5180,10 @@ async function readJsonOrFile(value) {
 async function cmdScan(values) {
   const p = await project(values);
   const { report } = await scanProject(p);
-  const out = values.out ?? join24(p.root, ".youi/usage.json");
-  await writeFileAtomic(resolve14(out), `${JSON.stringify(report)}
+  const out = values.out ?? join25(p.root, ".youi/usage.json");
+  await writeFileAtomic(resolve15(out), `${JSON.stringify(report)}
 `);
-  const recorded = await recordUsage(values, p, report, resolve14(out));
+  const recorded = await recordUsage(values, p, report, resolve15(out));
   if (values.json) json3(report);
   else print([renderScan(report, out), ...recorded ? [recorded] : []].join("\n"));
   return 0;
@@ -5004,7 +5192,7 @@ async function recordUsage(values, p, report, usage) {
   const { path, home } = indexOf(values);
   try {
     await recordProject(await sharedStore(path), p, report);
-    await noteSource(home, { project: { root: resolve14(values.project ?? process.cwd()), options: Object.fromEntries(Object.entries(loadOptions(values)).map(([key2, value]) => [key2, resolve14(value)])), usage } });
+    await noteSource(home, { project: { root: resolve15(values.project ?? process.cwd()), options: Object.fromEntries(Object.entries(loadOptions(values)).map(([key2, value]) => [key2, resolve15(value)])), usage } });
     return null;
   } catch (error) {
     return notRecorded(error);
@@ -5019,17 +5207,17 @@ function indexOf(values) {
 }
 async function cmdGaps(values) {
   const dirs = inventoryDirs(values);
-  const inventory = values.inventory ? InventoryReport.parse(JSON.parse(await readFile10(resolve14(values.inventory), "utf8"))) : await scanInventory(values, dirs);
-  const cwd = values.inventory ? dirname12(resolve14(values.inventory)) : process.cwd();
-  const project2 = await loadProject(resolve14(dirs[0]), loadOptions(values)).catch(() => null);
+  const inventory = values.inventory ? InventoryReport.parse(JSON.parse(await readFile10(resolve15(values.inventory), "utf8"))) : await scanInventory(values, dirs);
+  const cwd = values.inventory ? dirname13(resolve15(values.inventory)) : process.cwd();
+  const project2 = await loadProject(resolve15(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(resolve14(discoverCacheDir(values.cache)), indexOf(values).path).catch((error) => {
+  const store = await readCatalog(resolve15(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, resolve14(cwd, p.root)]));
+  const roots = new Map(inventory.projects.map((p) => [p.id, resolve15(cwd, p.root)]));
   const report = await buildGaps({ inventory, system, dependencies: declaredPackages(roots) }, store);
-  if (values.out) await writeFileAtomic(resolve14(values.out), `${JSON.stringify(report, null, 2)}
+  if (values.out) await writeFileAtomic(resolve15(values.out), `${JSON.stringify(report, null, 2)}
 `);
   if (values.json) json3(report);
   else print(renderGaps(report));
@@ -5039,12 +5227,12 @@ async function cmdInventory(values) {
   if (values.history) return cmdHistory(values, []);
   const dirs = inventoryDirs(values);
   const report = await scanInventory(values, dirs);
-  const out = resolve14(values.out ?? join24(dirs[0], ".youi/inventory.json"));
+  const out = resolve15(values.out ?? join25(dirs[0], ".youi/inventory.json"));
   await writeFileAtomic(out, `${JSON.stringify(report, null, 2)}
 `);
   const recorded = await recordScan(values, report, out);
   if (values.json) json3(report);
-  else print([renderInventory(report, relative10(process.cwd(), out).startsWith("..") ? out : relative10(process.cwd(), out)), recorded].join("\n"));
+  else print([renderInventory(report, relative11(process.cwd(), out).startsWith("..") ? out : relative11(process.cwd(), out)), recorded].join("\n"));
   return 0;
 }
 async function recordScan(values, report, out) {
@@ -5069,7 +5257,7 @@ async function cmdIndex(values, positionals) {
   const [action, ...rest] = positionals;
   const { path, home } = indexOf(values);
   if (action === "path") {
-    if (values.json) json3({ store: storeLocation({ path }), sources: join24(home, SOURCES_FILE), scans: join24(home, SCANS_LOG) });
+    if (values.json) json3({ store: storeLocation({ path }), sources: join25(home, SOURCES_FILE), scans: join25(home, SCANS_LOG) });
     else print(storeLocation({ path }));
     return 0;
   }
@@ -5080,7 +5268,7 @@ async function cmdIndex(values, positionals) {
     return 0;
   }
   if (action === "rebuild") {
-    const summary = await rebuildIndex(path, values.cache ? { discoverCache: resolve14(values.cache) } : {});
+    const summary = await rebuildIndex(path, values.cache ? { discoverCache: resolve15(values.cache) } : {});
     if (values.json) json3(summary);
     else print(renderRebuild(summary));
     return 0;
@@ -5120,7 +5308,7 @@ async function cmdBom(values, positionals) {
   return 0;
 }
 function baselineFile(values, p) {
-  if (values["baseline-file"]) return resolve14(values["baseline-file"]);
+  if (values["baseline-file"]) return resolve15(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 });
@@ -5177,7 +5365,7 @@ async function cmdBaseline(values) {
   const { totals } = written.baseline;
   if (values.json) json3({ file: written.file, action: written.action, totals, notAdded: written.notAdded, identity: written.baseline.identity });
   else {
-    print(`${style.ok(written.action)} ${relative10(process.cwd(), file) || file}: ${plural(totals.errors, "error")} \xB7 ${plural(totals.warnings, "warning")} accepted`);
+    print(`${style.ok(written.action)} ${relative11(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`));
   }
@@ -5248,7 +5436,7 @@ async function cmdInit(values) {
   if (!values.design) throw new UsageError("youiyoux init --design <dir|package>   (a design repo checkout, the directory holding youi.config.json, or the npm package that holds it)");
   const root = values.project ?? process.cwd();
   const design = await designArg(values.design, root);
-  const result = await initProject({ root, ...design, schemaDir: join24(TOOL_ROOT, "schema"), ...values.system ? { system: values.system } : {}, ...values.components ? { componentsDir: values.components } : {}, force: values.force });
+  const result = await initProject({ root, ...design, schemaDir: join25(TOOL_ROOT, "schema"), ...values.system ? { system: values.system } : {}, ...values.components ? { componentsDir: values.components } : {}, force: values.force });
   if (!values.json) {
     print(`${style.ok("created")} ${result.file}`);
     for (const note of result.notes) print(style.dim(`  \xB7 ${note}`));
@@ -5258,28 +5446,28 @@ async function cmdInit(values) {
   return cmdSync({ ...design.package ? rest : values, project: root });
 }
 async function cmdAdopt(values) {
-  const root = resolve14(values.project ?? process.cwd());
-  if (await exists(join24(root, PROJECT_FILE))) throw new Error(`${root} already has ${PROJECT_FILE}: it follows a design system already (youiyoux sync updates it)`);
+  const root = resolve15(values.project ?? process.cwd());
+  if (await exists(join25(root, PROJECT_FILE))) throw new Error(`${root} already has ${PROJECT_FILE}: it follows a design system already (youiyoux sync updates it)`);
   const plan = await planAdoption({ root, ...values.components ? { componentsDir: values.components } : {}, ...values.css ? { css: values.css } : {}, ...values.system ? { system: values.system } : {}, fork: values.fork });
-  const taken = (await Promise.all(plan.files.map(async (f) => await exists(join24(root, f.path)) ? f.path : null))).filter((f) => f !== null);
+  const taken = (await Promise.all(plan.files.map(async (f) => await exists(join25(root, f.path)) ? f.path : null))).filter((f) => f !== null);
   if (taken.length > 0) throw new Error(`nothing was written: ${taken.slice(0, 5).join(", ")}${taken.length > 5 ? ` and ${taken.length - 5} more` : ""} already exist${taken.length === 1 ? "s" : ""}`);
   if (values["dry-run"]) {
     if (values.json) json3(plan);
     else print([...adoptLines(plan, true), "", style.dim(`dry run: nothing written; would write ${plan.files.map((f) => f.path).join(", ")}${plan.stylesheet ? ` and change ${plan.stylesheet.path}` : ""}`)].join("\n"));
     return 0;
   }
-  const stylesheet = plan.stylesheet ? await readFile10(join24(root, plan.stylesheet.path), "utf8") : null;
+  const stylesheet = plan.stylesheet ? await readFile10(join25(root, plan.stylesheet.path), "utf8") : null;
   try {
-    for (const file of plan.files) await writeFileAtomic(join24(root, file.path), file.content);
-    if (plan.stylesheet) await writeFileAtomic(join24(root, plan.stylesheet.path), plan.stylesheet.content);
-    await initProject({ root, design: root, schemaDir: join24(TOOL_ROOT, "schema"), system: plan.system.id, componentsDir: plan.componentsDir, outputs: { ...plan.outputs, targets: [...plan.outputs.targets], dark: [...plan.outputs.dark] }, tokenSources: plan.tokenSources });
+    for (const file of plan.files) await writeFileAtomic(join25(root, file.path), file.content);
+    if (plan.stylesheet) await writeFileAtomic(join25(root, plan.stylesheet.path), plan.stylesheet.content);
+    await initProject({ root, design: root, schemaDir: join25(TOOL_ROOT, "schema"), system: plan.system.id, componentsDir: plan.componentsDir, outputs: { ...plan.outputs, targets: [...plan.outputs.targets], dark: [...plan.outputs.dark] }, tokenSources: plan.tokenSources });
     await syncProject(await loadProject(root), { dryRun: true });
   } catch (error) {
-    for (const file of [...plan.files.map((f) => f.path), PROJECT_FILE]) await rm6(join24(root, file), { force: true });
-    for (const folder of [...new Set(plan.files.map((f) => dirname12(f.path)))].sort((a, b) => b.length - a.length)) await rmdir3(join24(root, folder)).catch(() => void 0);
-    await rmdir3(join24(root, "design/components")).catch(() => void 0);
-    await rmdir3(join24(root, "design")).catch(() => void 0);
-    if (plan.stylesheet && stylesheet !== null) await writeFileAtomic(join24(root, plan.stylesheet.path), stylesheet);
+    for (const file of [...plan.files.map((f) => f.path), PROJECT_FILE]) await rm6(join25(root, file), { force: true });
+    for (const folder of [...new Set(plan.files.map((f) => dirname13(f.path)))].sort((a, b) => b.length - a.length)) await rmdir3(join25(root, folder)).catch(() => void 0);
+    await rmdir3(join25(root, "design/components")).catch(() => void 0);
+    await rmdir3(join25(root, "design")).catch(() => void 0);
+    if (plan.stylesheet && stylesheet !== null) await writeFileAtomic(join25(root, plan.stylesheet.path), stylesheet);
     throw new Error(`adopt was undone, nothing kept: ${error instanceof Error ? error.message : String(error)}`);
   }
   if (!values.json) print([...adoptLines(plan), ""].join("\n"));
@@ -5305,6 +5493,12 @@ function adoptLines(plan, dryRun = false) {
     })
   ];
 }
+async function cmdStatus(values) {
+  const report = await workspaceStatus(process.cwd(), values.project);
+  if (values.json) json3(report);
+  else print(renderStatus(report));
+  return report.projects.length === 0 ? 1 : statusExitCode(report);
+}
 async function cmdSystem(values, positionals) {
   const [action, dir, ...extra] = positionals;
   if (action !== "extract" || dir === void 0 || extra.length > 0) throw new UsageError("youiyoux system extract <dir> [--package <name>] [--dry-run]   (move the System youiyoux adopt keeps in this product into a design repo of its own)");
@@ -5324,7 +5518,7 @@ async function cmdSystem(values, positionals) {
   print([...lines, ""].join("\n"));
   const synced = await cmdSync({ ...values, project: p.root, package: void 0 });
   const git3 = `push it and set source to { "git": "<its url>", "ref": "v${result.system.version}" }`;
-  print(`Next: make ${relative10(process.cwd(), result.target) || "."} a repository of its own and commit it. For each app to follow it, ${values.package ? `publish ${values.package}, add it as a dependency and set source to { "package": "${values.package}" }, or ${git3}` : `${git3}, or publish it as an npm package (--package names it)`}. Change components there from now on: youiyoux sync merges them into each product`);
+  print(`Next: make ${relative11(process.cwd(), result.target) || "."} a repository of its own and commit it. For each app to follow it, ${values.package ? `publish ${values.package}, add it as a dependency and set source to { "package": "${values.package}" }, or ${git3}` : `${git3}, or publish it as an npm package (--package names it)`}. Change components there from now on: youiyoux sync merges them into each product`);
   return synced;
 }
 async function cmdLink(values, positionals) {
@@ -5342,31 +5536,31 @@ async function cmdUnlink(values) {
   const root = values.project ?? process.cwd();
   const linked = await linkedDesign(root);
   if (linked !== null) await setLink(root, null);
-  print(linked ? `${style.ok("unlinked")} ${resolve14(root)} uses its config's source again` : `${resolve14(root)} was not linked`);
+  print(linked ? `${style.ok("unlinked")} ${resolve15(root)} uses its config's source again` : `${resolve15(root)} was not linked`);
   return 0;
 }
 async function designArg(value, root) {
-  if (existsSync5(resolve14(value)) || !PACKAGE_NAME.test(value)) return { design: value };
-  return { design: await designRootOf({ package: value }, join24(resolve14(root), PROJECT_FILE), root), package: value };
+  if (existsSync5(resolve15(value)) || !PACKAGE_NAME.test(value)) return { design: value };
+  return { design: await designRootOf({ package: value }, join25(resolve15(root), PROJECT_FILE), root), package: value };
 }
 async function cmdBuild(values) {
-  const root = resolve14(values.design ?? process.cwd());
+  const root = resolve15(values.design ?? process.cwd());
   const system = getSystem(await loadDesignRepo(root), values.system);
   if (safeId(system.config.id) === null) throw new Error(`Cannot build system ${JSON.stringify(system.config.id)}: the id must be a plain name without ".." or path separators.`);
   const output = OutputConfig.parse({ cssVarPrefix: values.prefix ?? "youi", targets: ["css-vars", "tailwind-v4", "ts", "react-native"] });
   const started = performance.now();
   const built = await buildTokens(root, system.config, output, { contracts: system.components.map((c) => c.contract) });
-  const out = resolve14(values.out ?? join24(root, "build", system.config.id));
-  const boundary = values.out ? out : join24(root, "build");
-  if (!within(boundary, out) || built.files.some((file) => !within(out, join24(out, file.path)))) throw new Error(`Cannot build system ${JSON.stringify(system.config.id)}: an output path leaves the output directory.`);
-  for (const file of built.files) await writeFileAtomic(join24(out, file.path), file.content);
+  const out = resolve15(values.out ?? join25(root, "build", system.config.id));
+  const boundary = values.out ? out : join25(root, "build");
+  if (!within(boundary, out) || built.files.some((file) => !within(out, join25(out, file.path)))) throw new Error(`Cannot build system ${JSON.stringify(system.config.id)}: an output path leaves the output directory.`);
+  for (const file of built.files) await writeFileAtomic(join25(out, file.path), file.content);
   if (values.json) json3({ out, files: built.files.map((f) => f.path), tokens: built.tokens.length });
   else print(`${style.ok("built")} ${plural(built.tokens.length, "token")} \u2192 ${built.files.map((f) => f.path).join(", ")} ${style.dim(`in ${out} (${ms(performance.now() - started)})`)}`);
   return 0;
 }
 async function cmdParity(values) {
   if (!values.css) throw new UsageError("youiyoux parity --css <file> [--prefix p]");
-  const root = resolve14(values.design ?? process.cwd());
+  const root = resolve15(values.design ?? process.cwd());
   const system = getSystem(await loadDesignRepo(root), values.system);
   const prefix = values.prefix ?? "youi";
   const dark = { selector: values.dark ?? ':root[data-theme="dark"]' };
@@ -5384,16 +5578,16 @@ async function cmdParity(values) {
 async function cmdSchema(values) {
   const schemas = renderJsonSchemas();
   if (values.check) {
-    const dir = join24(values.design ? resolve14(values.design) : TOOL_ROOT, "schema");
+    const dir = join25(values.design ? resolve15(values.design) : TOOL_ROOT, "schema");
     const stale = [];
-    for (const { file, content } of schemas) if (await readFile10(join24(dir, file), "utf8").catch(() => null) !== content) stale.push(file);
+    for (const { file, content } of schemas) if (await readFile10(join25(dir, file), "utf8").catch(() => null) !== content) stale.push(file);
     if (values.json) json3({ dir, stale });
     else print(stale.length === 0 ? `${style.ok("\u2713")} ${dir} matches this youi's schemas` : `${style.error("\u2716")} out of date in ${dir}: ${stale.join(", ")}; run youiyoux schema --write${values.design ? " --design <dir>" : ""}`);
     return stale.length === 0 ? 0 : 1;
   }
   if (values.write) {
-    const root = values.design ? resolve14(values.design) : TOOL_ROOT;
-    for (const { file, content } of schemas) await writeFileAtomic(join24(root, "schema", file), content);
+    const root = values.design ? resolve15(values.design) : TOOL_ROOT;
+    for (const { file, content } of schemas) await writeFileAtomic(join25(root, "schema", file), content);
     print(`${style.ok("wrote")} ${schemas.map((s) => s.file).join(", ")}`);
   } else json3(Object.fromEntries(schemas.map((s) => [s.file, JSON.parse(s.content)])));
   return 0;
@@ -5416,7 +5610,7 @@ async function cmdHooks(values, positionals) {
   if (action !== "install") throw new UsageError("youiyoux hooks install [--claude] [--git] [--ci [--diff]] [--strict]   or   youiyoux hooks run claude|pre-commit");
   const p = await loadCheckProject(values.project ?? process.cwd(), loadOptions(values), !values.project);
   if (values.ci && !configured(p)) throw new UsageError("Run youiyoux init --design <dir> before installing the pinned CI workflow; repo-mode CI can run youiyoux check --diff <base> --strict directly");
-  const target = { ...hookTarget(values), project: p.root, ...configured(p) && p.configFile && p.configFile !== join24(p.root, PROJECT_FILE) ? { config: p.configFile } : {}, ...values.root !== void 0 ? { root: p.root } : {} };
+  const target = { ...hookTarget(values), project: p.root, ...configured(p) && p.configFile && p.configFile !== join25(p.root, PROJECT_FILE) ? { config: p.configFile } : {}, ...values.root !== void 0 ? { root: p.root } : {} };
   const all = !values.claude && !values.git && !values.ci;
   const results = [];
   if (values.claude || all) results.push({ kind: "Claude Code", ...await installClaudeHook(await repoRootOf(p.root), hookCommand(TOOL_ROOT, "claude", target)) });
@@ -5431,11 +5625,11 @@ async function cmdHooks(values, positionals) {
 async function cmdAgents(values, positionals) {
   const [action] = positionals;
   if (action !== "install" && action !== "remove") throw new UsageError("youiyoux agents install|remove [--claude] [--codex] [--json]");
-  const projectRoot = resolve14(values.project ?? process.cwd());
+  const projectRoot = resolve15(values.project ?? process.cwd());
   const repoRoot = await repoRootOf(projectRoot);
-  const target = { project: projectRoot, ...values.config ? { config: resolve14(values.config) } : {}, ...values.design ? { design: resolve14(values.design) } : {}, ...values.root !== void 0 ? { root: resolve14(values.root || ".") } : {} };
+  const target = { project: projectRoot, ...values.config ? { config: resolve15(values.config) } : {}, ...values.design ? { design: resolve15(values.design) } : {}, ...values.root !== void 0 ? { root: resolve15(values.root || ".") } : {} };
   const server = mcpCommand(TOOL_ROOT, target);
-  const system = existsSync5(resolve14(values.config ?? join24(projectRoot, PROJECT_FILE))) ? await project(values) : null;
+  const system = existsSync5(resolve15(values.config ?? join25(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 = [];
@@ -5506,7 +5700,32 @@ async function startEditor(values, port) {
     return null;
   }
 }
+async function workspaceUi(values) {
+  if (values.design || values.project || values.config || values.root) return null;
+  const { roots, workspace } = await statusTargets(process.cwd());
+  if (workspace === null || roots.length === 0) return null;
+  print(style.dim(`reading the status of ${plural(roots.length, "product")}\u2026`));
+  const report = await workspaceStatus(process.cwd());
+  const first = report.projects.findIndex((p) => !("error" in p));
+  if (first < 0) {
+    print(renderStatus(report));
+    throw new Error("no product in this workspace could be read: see each one's Next above");
+  }
+  const port = values.port ?? DEFAULT_HUB_PORT;
+  let open = null;
+  const hub = await startWorkspaceHub({ roots, current: first, status: () => workspaceStatus(process.cwd()), open: (root) => open ? open(root) : Promise.resolve(1) });
+  print(`${style.ok("workspace hub")} http://localhost:${port}/workspace#key=${hub.key}`);
+  print(style.dim(`  ${plural(roots.length, "product")}; showing ${report.projects[first].root} first. Open the link: it carries this run's key, which switching needs`));
+  print(style.dim("  Rules and Changes are read-only here; youiyoux ui --project <dir> opens the rule editor on one product"));
+  try {
+    return await runHub(TOOL_ROOT, { project: roots[first], port, api: hub.url, workspace: (snapshot) => open = snapshot, ...values.inventory ? { inventory: values.inventory } : {}, ...values.detect ? { detect: values.detect } : {} });
+  } finally {
+    await hub.close();
+  }
+}
 async function cmdUi(values) {
+  const workspace = await workspaceUi(values);
+  if (workspace !== null) return workspace;
   const port = values.port ?? DEFAULT_HUB_PORT;
   const editor = await startEditor(values, port);
   try {
@@ -5518,20 +5737,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-J6GPLCVO.js");
-  const out = resolve14(values.out ?? ".youi/detect");
+  const { repoReport, siteReport, writeReport } = await import("./src-ZG7JU6YJ.js");
+  const out = resolve15(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) json3(report);
   else {
-    const shown2 = relative10(process.cwd(), file);
+    const shown2 = relative11(process.cwd(), file);
     print(renderDetect(report, shown2 && !shown2.startsWith("..") ? shown2 : file));
   }
   return 0;
 }
 async function cmdRender(values, positionals, io) {
-  const root = resolve14(values.root ?? values.project ?? process.cwd());
-  const targets = positionals.map((t) => existsSync5(resolve14(t)) ? resolve14(t) : t);
+  const root = resolve15(values.root ?? values.project ?? process.cwd());
+  const targets = positionals.map((t) => existsSync5(resolve15(t)) ? resolve15(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) json3({ ...report, next: shotsNext(report, (t) => `run youiyoux render${t ? ` ${t}` : ""} again`) });
@@ -5545,14 +5764,14 @@ async function cmdRender(values, positionals, io) {
   }
 }
 async function product(values) {
-  const project2 = await loadProject(resolve14(values.project ?? process.cwd()), loadOptions(values)).catch(() => null);
-  return { project: project2, root: project2?.root ?? resolve14(values.root ?? values.project ?? process.cwd()) };
+  const project2 = await loadProject(resolve15(values.project ?? process.cwd()), loadOptions(values)).catch(() => null);
+  return { project: project2, root: project2?.root ?? resolve15(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-4JGIPP5A.js");
+  const { RequestStore, requestBrief } = await import("./src-EUVBYTKY.js");
   const { project: project2, root } = await product(values);
   const store = new RequestStore(root, project2?.config.id ?? basename5(root));
   const agent = { kind: "agent", name: "youiyoux CLI" };
@@ -5584,17 +5803,17 @@ 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"] ? resolve14(values["storage-state"]) : sessionFile(root), io);
-  const dir = resolve14(values.out ?? join24(root, ".youi/screens"));
-  if (!existsSync5(join24(dir, "screens.json"))) {
+  if (positionals[0] === "login") return screensLogin(values.base, values["storage-state"] ? resolve15(values["storage-state"]) : sessionFile(root), io);
+  const dir = resolve15(values.out ?? join25(root, ".youi/screens"));
+  if (!existsSync5(join25(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 session = chosenSession(root, values["storage-state"] ? resolve14(values["storage-state"]) : void 0);
+  const session = chosenSession(root, values["storage-state"] ? resolve15(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-J6GPLCVO.js");
+  const { launchBrowser } = await import("./src-ZG7JU6YJ.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] } : {}, ...session ? { storageState: session.file } : {}, log: (line) => process.stderr.write(`${style.dim(line)}
@@ -5651,7 +5870,7 @@ async function cmdReport(values, positionals, io) {
   return result.code;
 }
 async function cmdMcp(values) {
-  const { startStdioServer } = await import("./src-NWPGCDGH.js");
+  const { startStdioServer } = await import("./src-YKPJ3PII.js");
   await startStdioServer({ projectRoot: values.project ?? process.cwd(), ...loadOptions(values), ...values.cache ? { discoverCache: values.cache } : {} });
   return -1;
 }
@@ -5662,7 +5881,7 @@ function positiveInt(value, flag) {
   return n;
 }
 async function cmdDiscover(values, positionals, io) {
-  const cacheDir = resolve14(discoverCacheDir(values.cache));
+  const cacheDir = resolve15(discoverCacheDir(values.cache));
   const { path, home } = indexOf(values);
   const catalog = () => readCatalog(cacheDir, path);
   const [action, ...rest] = positionals;
@@ -5714,6 +5933,7 @@ ${style.dim(`store \u2192 ${storeLocation({ path })} (${plural(loaded.chosen, "l
 }
 var COMMANDS = {
   adopt: cmdAdopt,
+  status: cmdStatus,
   system: cmdSystem,
   link: cmdLink,
   unlink: cmdUnlink,