youiyoux 0.1.0 → 0.1.3

package/README.md

@@ -1,26 +1,36 @@
 # youiyoux
 
-A shareable report on any repo's UI, with no setup:
+**Your agent rebuilds components you already have. youiyoux catches it.**
+
+UI context and verification for coding agents: it tells the agent what your repo already has before
+it writes UI, then checks what it wrote.
 
 ```sh
-npx youiyoux            # in a repo: scan it, write the report
-npx youiyoux path/to/repo
+npx youiyoux              # scan this repo
+npx youiyoux path/to/repo # or another one; --out <dir> writes elsewhere
 ```
 
-It prints five plain-English lines and writes three files to the repo (or `--out <dir>`), and nothing else:
+No config, no account. You get:
+
+- `youiyoux-report.html`: near-duplicate components and which to keep, hardcoded values your theme already has, off-library imports, and the top fixes with their next steps. One offline page.
+- `youiyoux-card.png`: a 1200×630 card with the headline numbers.
+- `youiyoux-summary.md`: paste it into a PR or issue.
+
+## For your agent
 
-| File | What |
-| --- | --- |
-| `youiyoux-report.html` | One self-contained page (no network requests, light and dark, readable on a phone): projects (one section per workspace package with UI files), UI libraries, the component inventory, near-duplicate groups, hardcoded values a theme token already holds, off-library imports and the top fixes, each with a concrete next step |
-| `youiyoux-card.png` | A 1200×630 share card with the repo's name and the headline numbers |
-| `youiyoux-summary.md` | A short summary for a README or pull request |
+```sh
+npx youiyoux agents install   # rule in AGENTS.md + CLAUDE.md, MCP server for Claude Code + Codex
+npx youiyoux hooks install    # check after each Claude Code edit, and at git commit
+```
 
-**Rendered looks.** When a Chromium is installed (the Playwright headless shell, or `YOUI_CHROMIUM`), the most-used components are drawn with the project's own code and CSS and embedded. Otherwise the report says how: `npx youiyoux --render` asks before downloading the headless shell (~100 MB, once); `--yes` allows it without asking. Everything else works without a browser.
+- `ui_find_component` (MCP): before writing a component, the existing one with its import, props and a real usage.
+- `npx youiyoux check --diff`: after UI edits, what the change adds, each with its fix.
+- `ui_render` (MCP) or `npx youiyoux render <file>`: screenshots light and dark, accessibility issues, a diff against base.
 
-**Safe to share by default.** Paths are relative to the repo. Includes relative paths, component names, class lists, counts and rendered images when available. Captions and fixes omit literal prop values and text content; source lines require `--include-code`. Home paths, usernames, environment or `.env` values, and credentials in URLs are removed. `--include-code` adds source lines and full look captions (keys and tokens in it still removed).
+## Privacy
 
-**Set up youiyoux for your agent:** `npx youiyoux agents install` tells Claude Code and Codex to look up the project's existing components before writing new ones. Every other `youiyoux` command runs the same way (`npx youiyoux check --diff`), The `youi` bin remains a silent compatibility alias.
+Runs locally; nothing is uploaded, no telemetry. The report includes relative paths, component names, class lists, counts and rendered images when available. No source lines unless `--include-code`; home paths, usernames, env values and credentials are stripped. Rendered looks need a headless Chromium (`--render` offers to download it, ~100 MB, once); specimen images are cached in `~/.cache/youiyoux/specimens`.
 
-Node 20 or later. Nothing is uploaded, there is no telemetry and no account.
+Node 20 or later. The `youi` bin is a silent alias.
 
-Specimen images are cached outside the repo in `~/.cache/youiyoux/specimens` (`XDG_CACHE_HOME` overrides `~/.cache`; `YOUI_SPECIMEN_CACHE` overrides the specimen directory). Rendered images show the component as rendered, including visible labels.
+Docs, agent reference and source: [github.com/ap9000/youiyoux](https://github.com/ap9000/youiyoux)

package/dist/chunks/{chunk-FUB7B3VK.js → chunk-74KBRI2H.js}

@@ -4,7 +4,7 @@ import {
   findFiles,
   require_dist,
   writeFileAtomic
-} from "./chunk-ZLRFD5JI.js";
+} from "./chunk-C3TSTYP7.js";
 import {
   __toESM
 } from "./chunk-E4HNK7VF.js";

package/dist/chunks/{chunk-ZLRFD5JI.js → chunk-C3TSTYP7.js}

@@ -27331,7 +27331,7 @@ var STAGE_MOVES = [
 function canMove(from, to, actor) {
   return STAGE_MOVES.some((move) => move.from === from && move.to === to && move.by.includes(actor));
 }
-var MCP_TOOLS = ["system_search", "system_get_component", "system_get_tokens", "system_get_rules", "system_where_used", "system_screen_bom", "system_check", "system_plan", "library_search", "library_request", "discover_search", "discover_show", "index_where_used", "index_swap_impact", "index_rule_covers", "ui_find_component", "ui_render"];
+var MCP_TOOLS = ["system_search", "system_get_component", "system_get_tokens", "system_get_rules", "system_where_used", "system_screen_bom", "system_check", "system_plan", "library_search", "library_request", "discover_search", "discover_show", "index_where_used", "index_swap_impact", "index_rule_covers", "ui_find_component", "ui_render", "requests_list", "request_reply", "request_addressed"];
 var LIBRARY_KINDS = ["component", "token", "pattern"];
 var LIBRARY_ID_PATTERN = /^lib:([a-z][a-z0-9-]*)\/(component|token|pattern)\/([a-z0-9][a-z0-9.\-]*)$/;
 var LibraryId = external_exports.string().regex(LIBRARY_ID_PATTERN, "expected lib:<source>/<kind>/<name>");
@@ -27406,6 +27406,55 @@ async function loadLibrary(root) {
   return { entries };
 }
 
+// ../core/src/requests.ts
+var IsoTime2 = external_exports.string().datetime({ offset: true });
+var REQUEST_ID = /^r-[0-9a-f]{10}$/;
+var REQUEST_STATUSES = ["open", "addressed", "closed"];
+var RequestAuthor = external_exports.object({ kind: external_exports.enum(["person", "agent"]), name: external_exports.string().min(1).max(100) });
+var Box = external_exports.object({ x: external_exports.number(), y: external_exports.number(), width: external_exports.number().nonnegative(), height: external_exports.number().nonnegative() });
+var Size = external_exports.object({ width: external_exports.number().positive(), height: external_exports.number().positive() });
+var RequestTarget = external_exports.object({
+  /** The route as the usage map names it (`/settings`, `*` for the app shell). */
+  route: external_exports.string().min(1).max(300),
+  /** here: this one, on this screen; element: every place the element is used. */
+  scope: external_exports.enum(["here", "element"]),
+  /** The component's name as it rendered (`Button`). */
+  name: external_exports.string().min(1).max(200),
+  /** The System element it is, or the one a lookalike stands in for. */
+  element: ElementId.optional(),
+  lookalike: external_exports.boolean().optional(),
+  /** Project-relative, and the line that rendered it, when the capture found them. */
+  file: external_exports.string().min(1).max(500).optional(),
+  line: external_exports.number().int().positive().optional(),
+  box: Box.optional(),
+  page: Size.optional()
+});
+var RequestEntry = external_exports.object({
+  author: RequestAuthor,
+  at: IsoTime2,
+  body: external_exports.string().max(4e3),
+  /** A status change this entry made, if any. */
+  status: external_exports.enum(REQUEST_STATUSES).optional()
+});
+var RequestDoc = external_exports.object({
+  $schema: external_exports.string().optional(),
+  schema: external_exports.literal("youi.request/v1"),
+  id: external_exports.string().regex(REQUEST_ID, "expected r-<10 hex>"),
+  /** The project id from youi.project.json. */
+  project: external_exports.string().min(1).max(200),
+  /** comment: a note; change: something to do. */
+  kind: external_exports.enum(["comment", "change"]),
+  status: external_exports.enum(REQUEST_STATUSES),
+  body: external_exports.string().min(1).max(4e3),
+  author: RequestAuthor,
+  createdAt: IsoTime2,
+  updatedAt: IsoTime2,
+  target: RequestTarget,
+  /** The screen as it was when this was filed (`<id>.before.webp` beside it), to compare with after a change. */
+  before: external_exports.string().regex(/^r-[0-9a-f]{10}\.before\.webp$/).optional(),
+  thread: external_exports.array(RequestEntry).max(500)
+});
+
 // ../core/src/tokens.ts
 var TOKEN_ALIAS = /^\{([^{}]+)\}$/;
 var ALIAS_MESSAGE = "expected an alias like {color.brand}";
@@ -27617,7 +27666,7 @@ function normalizeRelPath(path) {
   return posix2.normalize(path.replace(/\\/g, "/")).replace(/^\.\//, "").replace(/\/+$/, "") || ".";
 }
 var RelPath = external_exports.string().min(1).refine((p) => !p.startsWith("/") && !normalizeRelPath(p).split("/").includes(".."), "expected a path relative to its root, without ..");
-var IsoTime2 = external_exports.string().datetime({ offset: true });
+var IsoTime3 = external_exports.string().datetime({ offset: true });
 var SystemConfig = external_exports.object({
   id: external_exports.string().regex(/^[a-z][a-z0-9-]*$/, { error: ({ input: input2 }) => safeId(input2) === null ? `Invalid system id ${JSON.stringify(input2)}: use a plain name without ".." or path separators` : `Invalid system id ${JSON.stringify(input2)}: use lowercase letters, digits and hyphens, starting with a letter` }),
   name: external_exports.string().min(1),
@@ -27875,7 +27924,7 @@ var ScanReport = external_exports.object({
     /** Files checked from supplied text (unsaved edits, candidate code) rather than disk. */
     overrides: external_exports.array(external_exports.string())
   }).optional(),
-  generatedAt: IsoTime2,
+  generatedAt: IsoTime3,
   durationMs: external_exports.number(),
   status: external_exports.enum(["complete", "partial"]),
   coverage: external_exports.object({
@@ -27918,7 +27967,7 @@ var Baseline = external_exports.object({
   $schema: external_exports.string().optional(),
   schema: external_exports.literal("youi.baseline/v1"),
   project: external_exports.string(),
-  recordedAt: IsoTime2,
+  recordedAt: IsoTime3,
   identity: CheckIdentity,
   totals: external_exports.object({ errors: external_exports.number().int(), warnings: external_exports.number().int() }),
   entries: external_exports.array(BaselineEntry)
@@ -27940,7 +27989,7 @@ var LockFile = external_exports.object({
   system: external_exports.string(),
   systemVersion: SemVer,
   sourceCommit: external_exports.string().nullable(),
-  syncedAt: IsoTime2,
+  syncedAt: IsoTime3,
   files: external_exports.record(external_exports.string(), LockEntry)
 });
 var INVENTORY_ROLES = ["button", "link-as-button", "input", "card", "badge", "dialog", "tabs"];
@@ -28092,7 +28141,7 @@ var InventoryReport = external_exports.object({
   $schema: external_exports.string().optional(),
   schema: external_exports.literal("youi.inventory/v1"),
   scanner: external_exports.string(),
-  generatedAt: IsoTime2,
+  generatedAt: IsoTime3,
   durationMs: external_exports.number(),
   /** Two looks share a family only when every dimension is within these (px; weight in units) of every other look's. */
   tolerance: external_exports.object({ height: external_exports.number(), padding: external_exports.number(), radius: external_exports.number(), fontSize: external_exports.number(), fontWeight: external_exports.number() }),
@@ -28126,7 +28175,8 @@ var PUBLISHED_SCHEMAS = {
   "youi.baseline.schema.json": Baseline,
   "youi.inventory.schema.json": InventoryReport,
   "youi.detect.schema.json": DetectReport,
-  "youi.tokens.schema.json": TokenDocument
+  "youi.tokens.schema.json": TokenDocument,
+  "youi.request.schema.json": RequestDoc
 };
 function normalizeProjectConfig(config2) {
   const n = normalizeRelPath;
@@ -28263,6 +28313,12 @@ function executionLabel(execution) {
   }
 }
 
+// ../core/src/licence.ts
+function copyleft(spdx) {
+  const strong = (part) => part.split(/\s+(?:AND|WITH)\s+/).some((id) => /^A?GPL-/.test(id.replace(/[()]/g, "").trim()));
+  return spdx.split(/\s+OR\s+/).every(strong);
+}
+
 export {
   require_dist,
   clone,
@@ -28323,6 +28379,11 @@ export {
   LibraryEntry,
   LIBRARY_DIR,
   loadLibrary,
+  copyleft,
+  REQUEST_ID,
+  REQUEST_STATUSES,
+  RequestTarget,
+  RequestDoc,
   TOKEN_ALIAS,
   CSS_SAFE_NAME,
   aliasesIn,