youiyoux 0.1.2 → 0.1.3

package/dist/chunks/{src-WQWYJ6IQ.js → src-YGEZCUAO.js}

@@ -2,7 +2,7 @@ import { createRequire as __youiRequire } from "node:module"; const require = __
 import {
   SHADCN_SLOTS,
   libraryOfPackage
-} from "./chunk-FUB7B3VK.js";
+} from "./chunk-74KBRI2H.js";
 import {
   DISCOVER_RULE,
   DiscoverConstraints,
@@ -18,7 +18,11 @@ import {
   sharedStore,
   showFromCatalog,
   storeLocation
-} from "./chunk-UHPK62Q5.js";
+} from "./chunk-UEB6MJDX.js";
+import {
+  RequestStore,
+  requestBrief
+} from "./chunk-OIHNEGWH.js";
 import {
   PROJECT_FILE,
   ScanCache,
@@ -42,7 +46,7 @@ import {
   shotsText,
   tokenRows,
   whereUsed
-} from "./chunk-3ZHGONNA.js";
+} from "./chunk-L5BV4PI7.js";
 import "./chunk-S7UV34H5.js";
 import {
   $ZodObject,
@@ -82,7 +86,7 @@ import {
   toJSONSchema,
   union,
   unknown
-} from "./chunk-ZLRFD5JI.js";
+} from "./chunk-C3TSTYP7.js";
 import {
   __commonJS,
   __toESM
@@ -16866,7 +16870,7 @@ var StdioServerTransport = class {
 
 // ../mcp/src/server.ts
 import { existsSync, realpathSync } from "node:fs";
-import { isAbsolute, join, resolve, sep } from "node:path";
+import { basename, isAbsolute, join, resolve, sep } from "node:path";
 
 // ../mcp/src/find-component.ts
 import { posix } from "node:path";
@@ -17152,6 +17156,8 @@ function renderText(report) {
 var VERSION = "0.1.0";
 var DEFAULT_TTL = 5e3;
 var READ_ONLY = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+var WRITES_REQUEST = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
+var AGENT = { kind: "agent", name: "agent (MCP)" };
 var ok = (value) => ({ content: [{ type: "text", text: JSON.stringify(value) }] });
 var text = (value) => ({ content: [{ type: "text", text: value }] });
 var fail = (error) => ({ content: [{ type: "text", text: JSON.stringify({ error: error instanceof Error ? error.message : String(error) }) }], isError: true });
@@ -17244,7 +17250,7 @@ function createServer(options) {
   const server = new McpServer(
     { name: "youiyoux", version: VERSION },
     {
-      instructions: "YouIyouX: the UI context and verification layer for this project. Before creating any UI component, call ui_find_component with the need in words: reuse the existing component it names, or start where it says when nothing fits. Build only with System elements: call system_get_component before using a component's props, system_get_tokens instead of writing colours or sizes, and system_check on code before finishing. system_plan shows the impact of a change to the System. The Library (library_* tools, lib: ids) holds ingested references that are not approved: browse them with library_search, never import, copy or build with them, and use library_request to draft an adoption request for a person to approve. discover_search and discover_show find outside candidates by need (shadcn registries, npm) with licence, signals and install command: they are references, never install or copy one; propose one with library_request. index_where_used, index_swap_impact and index_rule_covers answer from the local index in a few lines: where an inventory family (button-2) is used, what swapping a candidate in for it would touch, and what a rule covers. After changing a component, call ui_render with its file and look at the images it names: light and dark at desktop and phone width, accessibility issues, and a diff against the base commit. There are no tools to publish, approve or install anything."
+      instructions: "YouIyouX: the UI context and verification layer for this project. Before creating any UI component, call ui_find_component with the need in words: reuse the existing component it names, or start where it says when nothing fits. Build only with System elements: call system_get_component before using a component's props, system_get_tokens instead of writing colours or sizes, and system_check on code before finishing. system_plan shows the impact of a change to the System. The Library (library_* tools, lib: ids) holds ingested references that are not approved: browse them with library_search, never import, copy or build with them, and use library_request to draft an adoption request for a person to approve. discover_search and discover_show find outside candidates by need (shadcn registries, npm) with licence, signals and install command: they are references, never install or copy one; propose one with library_request. index_where_used, index_swap_impact and index_rule_covers answer from the local index in a few lines: where an inventory family (button-2) is used, what swapping a candidate in for it would touch, and what a rule covers. After changing a component, call ui_render with its file and look at the images it names: light and dark at desktop and phone width, accessibility issues, and a diff against the base commit. People pin comments and change requests to components on captured screens: call requests_list before UI work, ask with request_reply when one is unclear, and after making a change call request_addressed with what you changed; a person closes it. There are no tools to publish, approve, close or install anything."
     }
   );
   server.registerTool(
@@ -17478,6 +17484,42 @@ function createServer(options) {
       }
     })
   );
+  async function requests() {
+    const project = await state.loadProject().catch(() => null);
+    const root = project?.root ?? resolve(options.productRoot ?? options.projectRoot);
+    return { store: new RequestStore(root, project?.config.id ?? basename(root)), root };
+  }
+  server.registerTool(
+    "requests_list",
+    {
+      title: "Requests on the screens",
+      description: "Comments and change requests people pinned to components on captured screens (the hub's Screens page). Each says what is asked, the route and component, the file:line that rendered it, whether it means this one or every use of the element, the screenshot (an absolute path: open it) with the component's box on it in that picture's pixels, the thread, and what to do next. Call it before UI work. Default: open requests.",
+      inputSchema: { status: external_exports.enum(["open", "addressed", "closed", "all"]).optional(), route: external_exports.string().min(1).optional().describe("Only this route, e.g. /settings") },
+      annotations: READ_ONLY
+    },
+    guard(async ({ status, route }) => {
+      const { store, root } = await requests();
+      const { requests: all, unreadable } = await store.list();
+      const wanted = all.filter((r) => (status === "all" || r.status === (status ?? "open")) && (!route || r.target.route === route));
+      return { requests: wanted.map((r) => requestBrief(r, root)), ...unreadable.length ? { unreadable } : {}, ...wanted.length === 0 ? { next: `No ${status && status !== "all" ? status : "open"} requests${route ? ` on ${route}` : ""}.` } : {} };
+    })
+  );
+  server.registerTool(
+    "request_reply",
+    { title: "Reply on a request", description: "Add a reply to a request's thread: a question when the ask is unclear, or an answer to a comment. Writes only that request's file in .youi/requests.", inputSchema: { id: external_exports.string().regex(/^r-[0-9a-f]{10}$/).describe("The request id, r-<10 hex>"), message: external_exports.string().min(1).max(4e3) }, annotations: WRITES_REQUEST },
+    guard(async ({ id, message }) => {
+      const { store, root } = await requests();
+      return requestBrief(await store.reply(AGENT, id, message), root);
+    })
+  );
+  server.registerTool(
+    "request_addressed",
+    { title: "Mark a request addressed", description: "Say a change request is done, with what you changed (file:line). A person checks it on the screen and closes it, or reopens it; an agent never closes one. Writes only that request's file in .youi/requests.", inputSchema: { id: external_exports.string().regex(/^r-[0-9a-f]{10}$/).describe("The request id, r-<10 hex>"), message: external_exports.string().min(1).max(4e3).describe("What you changed, with file:line") }, annotations: WRITES_REQUEST },
+    guard(async ({ id, message }) => {
+      const { store, root } = await requests();
+      return requestBrief(await store.setStatus(AGENT, id, "addressed", message), root);
+    })
+  );
   return server;
 }
 async function startStdioServer(options) {

package/dist/chunks/{src-4KFNL3MY.js → src-YUC5PIDK.js}

@@ -58,6 +58,7 @@ import {
   keyPackage,
   licenceOf,
   linkCandidates,
+  linkedRepos,
   loadIndex,
   looksLikeRegistry,
   mergeCategories,
@@ -94,6 +95,7 @@ import {
   rolesOf,
   safeRelative,
   sameHomepage,
+  sameSite,
   searchCatalog,
   searchIndex,
   searchTextOf,
@@ -112,8 +114,8 @@ import {
   writeHttpCache,
   writeJson,
   writeSources
-} from "./chunk-UHPK62Q5.js";
-import "./chunk-ZLRFD5JI.js";
+} from "./chunk-UEB6MJDX.js";
+import "./chunk-C3TSTYP7.js";
 import "./chunk-E4HNK7VF.js";
 export {
   ALL_INDEX_FILE,
@@ -174,6 +176,7 @@ export {
   keyPackage,
   licenceOf,
   linkCandidates,
+  linkedRepos,
   loadIndex,
   looksLikeRegistry,
   mergeCategories,
@@ -210,6 +213,7 @@ export {
   rolesOf,
   safeRelative,
   sameHomepage,
+  sameSite,
   searchCatalog,
   searchIndex,
   searchTextOf,

package/dist/chunks/{src-B742AYFC.js → src-ZS76UD7E.js}

@@ -14,10 +14,13 @@ import {
   HEX,
   LIBRARY_RULE,
   MAX_LOOKS,
+  MAX_PLACES,
   MAX_SIBLINGS,
   ModuleGraph,
   ModuleResolver,
+  PICTURE_SCALE,
   PIXEL_THRESHOLD,
+  PLACES_SCHEMA,
   PROJECT_FILE,
   ProjectRootError,
   ProjectWatcher,
@@ -26,6 +29,7 @@ import {
   RouteIndex,
   SCANNER_VERSION,
   SCHEMES,
+  SCREENS_SCHEMA,
   SHOTS_FORMAT,
   SHOT_WIDTHS,
   SPACING_UTILITY,
@@ -53,6 +57,8 @@ import {
   bundleForBrowser,
   bundlePreview,
   canonicalKey,
+  captureScreens,
+  captureText,
   changedFiles,
   checkCapabilities,
   checkIdentity,
@@ -71,6 +77,7 @@ import {
   countParseErrors,
   coverageOf,
   createBaseline,
+  decodeMap,
   defaultCacheDir,
   definitionsDigest,
   describeIdentity,
@@ -101,6 +108,7 @@ import {
   literalOf,
   loadInventoryTarget,
   loadProject,
+  locateInPage,
   markupOf,
   nearDuplicates,
   newShotStats,
@@ -109,10 +117,12 @@ import {
   numericValue,
   offLibraryImports,
   offsetToPosition,
+  originalPosition,
   pageStylesheets,
   parseModule,
   planChange,
   planImports,
+  projectPath,
   projectSpecimens,
   projectTailwind,
   projectTheme,
@@ -123,8 +133,10 @@ import {
   rawColorsInScript,
   readCsf,
   readDecorator,
+  readScreensSpec,
   readStylesheet,
   renderShots,
+  resolvePlaces,
   resolveTag,
   reuseOf,
   ruleCapability,
@@ -133,11 +145,13 @@ import {
   runMigration,
   scanProject,
   screenBom,
+  screenSlug,
   searchElements,
   searchLibrary,
   shapeDistance,
   shotsNext,
   shotsText,
+  sourceMapOf,
   specifierFor,
   staticBase,
   storyConfig,
@@ -159,14 +173,14 @@ import {
   vendoredPath,
   verifyRewrite,
   whereUsed
-} from "./chunk-3ZHGONNA.js";
+} from "./chunk-L5BV4PI7.js";
 import {
   escapingLinks,
   isBarePackageUnderRoot,
   relativeInside,
   within
 } from "./chunk-S7UV34H5.js";
-import "./chunk-ZLRFD5JI.js";
+import "./chunk-C3TSTYP7.js";
 import "./chunk-E4HNK7VF.js";
 export {
   ARBITRARY,
@@ -183,10 +197,13 @@ export {
   HEX,
   LIBRARY_RULE,
   MAX_LOOKS,
+  MAX_PLACES,
   MAX_SIBLINGS,
   ModuleGraph,
   ModuleResolver,
+  PICTURE_SCALE,
   PIXEL_THRESHOLD,
+  PLACES_SCHEMA,
   PROJECT_FILE,
   ProjectRootError,
   ProjectWatcher,
@@ -195,6 +212,7 @@ export {
   RouteIndex,
   SCANNER_VERSION,
   SCHEMES,
+  SCREENS_SCHEMA,
   SHOTS_FORMAT,
   SHOT_WIDTHS,
   SPACING_UTILITY,
@@ -222,6 +240,8 @@ export {
   bundleForBrowser,
   bundlePreview,
   canonicalKey,
+  captureScreens,
+  captureText,
   changedFiles,
   checkCapabilities,
   checkIdentity,
@@ -240,6 +260,7 @@ export {
   countParseErrors,
   coverageOf,
   createBaseline,
+  decodeMap,
   defaultCacheDir,
   definitionsDigest,
   describeIdentity,
@@ -272,6 +293,7 @@ export {
   literalOf,
   loadInventoryTarget,
   loadProject,
+  locateInPage,
   markupOf,
   nearDuplicates,
   newShotStats,
@@ -280,10 +302,12 @@ export {
   numericValue,
   offLibraryImports,
   offsetToPosition,
+  originalPosition,
   pageStylesheets,
   parseModule,
   planChange,
   planImports,
+  projectPath,
   projectSpecimens,
   projectTailwind,
   projectTheme,
@@ -294,9 +318,11 @@ export {
   rawColorsInScript,
   readCsf,
   readDecorator,
+  readScreensSpec,
   readStylesheet,
   relativeInside,
   renderShots,
+  resolvePlaces,
   resolveTag,
   reuseOf,
   ruleCapability,
@@ -305,11 +331,13 @@ export {
   runMigration,
   scanProject,
   screenBom,
+  screenSlug,
   searchElements,
   searchLibrary,
   shapeDistance,
   shotsNext,
   shotsText,
+  sourceMapOf,
   specifierFor,
   staticBase,
   storyConfig,

package/dist/schema/youi.request.schema.json

@@ -0,0 +1,229 @@
+{
+  "$id": "https://design-language.local/schema/youi.request.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "schema": {
+      "type": "string",
+      "const": "youi.request/v1"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^r-[0-9a-f]{10}$"
+    },
+    "project": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 200
+    },
+    "kind": {
+      "type": "string",
+      "enum": [
+        "comment",
+        "change"
+      ]
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "open",
+        "addressed",
+        "closed"
+      ]
+    },
+    "body": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4000
+    },
+    "author": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": [
+            "person",
+            "agent"
+          ]
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        }
+      },
+      "required": [
+        "kind",
+        "name"
+      ]
+    },
+    "createdAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+    },
+    "updatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+    },
+    "target": {
+      "type": "object",
+      "properties": {
+        "route": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 300
+        },
+        "scope": {
+          "type": "string",
+          "enum": [
+            "here",
+            "element"
+          ]
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "element": {
+          "type": "string",
+          "pattern": "^youi:([a-z][a-z0-9-]*)\\/(token|component|rule|migration)\\/([a-z0-9][a-z0-9.\\-]*)$"
+        },
+        "lookalike": {
+          "type": "boolean"
+        },
+        "file": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 500
+        },
+        "line": {
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 9007199254740991
+        },
+        "box": {
+          "type": "object",
+          "properties": {
+            "x": {
+              "type": "number"
+            },
+            "y": {
+              "type": "number"
+            },
+            "width": {
+              "type": "number",
+              "minimum": 0
+            },
+            "height": {
+              "type": "number",
+              "minimum": 0
+            }
+          },
+          "required": [
+            "x",
+            "y",
+            "width",
+            "height"
+          ]
+        },
+        "page": {
+          "type": "object",
+          "properties": {
+            "width": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            },
+            "height": {
+              "type": "number",
+              "exclusiveMinimum": 0
+            }
+          },
+          "required": [
+            "width",
+            "height"
+          ]
+        }
+      },
+      "required": [
+        "route",
+        "scope",
+        "name"
+      ]
+    },
+    "before": {
+      "type": "string",
+      "pattern": "^r-[0-9a-f]{10}\\.before\\.webp$"
+    },
+    "thread": {
+      "maxItems": 500,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "author": {
+            "type": "object",
+            "properties": {
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "person",
+                  "agent"
+                ]
+              },
+              "name": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 100
+              }
+            },
+            "required": [
+              "kind",
+              "name"
+            ]
+          },
+          "at": {
+            "type": "string",
+            "format": "date-time",
+            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
+          },
+          "body": {
+            "type": "string",
+            "maxLength": 4000
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "open",
+              "addressed",
+              "closed"
+            ]
+          }
+        },
+        "required": [
+          "author",
+          "at",
+          "body"
+        ]
+      }
+    }
+  },
+  "required": [
+    "schema",
+    "id",
+    "project",
+    "kind",
+    "status",
+    "body",
+    "author",
+    "createdAt",
+    "updatedAt",
+    "target",
+    "thread"
+  ]
+}

package/dist/youi.js

@@ -2,12 +2,12 @@
 import { createRequire as __youiRequire } from "node:module"; const require = __youiRequire(import.meta.url);
 import {
   main
-} from "./chunks/chunk-CLNMVQZJ.js";
-import "./chunks/chunk-FUB7B3VK.js";
-import "./chunks/chunk-UHPK62Q5.js";
-import "./chunks/chunk-3ZHGONNA.js";
+} from "./chunks/chunk-RTOTNSOV.js";
+import "./chunks/chunk-74KBRI2H.js";
+import "./chunks/chunk-UEB6MJDX.js";
+import "./chunks/chunk-L5BV4PI7.js";
 import "./chunks/chunk-S7UV34H5.js";
-import "./chunks/chunk-ZLRFD5JI.js";
+import "./chunks/chunk-C3TSTYP7.js";
 import "./chunks/chunk-E4HNK7VF.js";
 
 // src/youi.js

package/dist/youiyoux.js

@@ -3,12 +3,12 @@ import { createRequire as __youiRequire } from "node:module"; const require = __
 import {
   COMMAND_NAMES,
   main
-} from "./chunks/chunk-CLNMVQZJ.js";
-import "./chunks/chunk-FUB7B3VK.js";
-import "./chunks/chunk-UHPK62Q5.js";
-import "./chunks/chunk-3ZHGONNA.js";
+} from "./chunks/chunk-RTOTNSOV.js";
+import "./chunks/chunk-74KBRI2H.js";
+import "./chunks/chunk-UEB6MJDX.js";
+import "./chunks/chunk-L5BV4PI7.js";
 import "./chunks/chunk-S7UV34H5.js";
-import "./chunks/chunk-ZLRFD5JI.js";
+import "./chunks/chunk-C3TSTYP7.js";
 import "./chunks/chunk-E4HNK7VF.js";
 
 // src/youiyoux.js

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "youiyoux",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Your agent rebuilds components you already have. youiyoux catches it: npx youiyoux turns any repo into a shareable report of near-duplicate components, hardcoded token values and off-library imports, with the fixes.",
   "license": "MIT",
   "repository": {
@@ -46,9 +46,9 @@
     "typescript": "6.0.3"
   },
   "devDependencies": {
-    "@youiyoux/cli": "0.1.2",
-    "@youiyoux/core": "0.1.2",
-    "@youiyoux/scanner": "0.1.2"
+    "@youiyoux/cli": "0.1.3",
+    "@youiyoux/core": "0.1.3",
+    "@youiyoux/scanner": "0.1.3"
   },
   "exports": {
     "./package.json": "./package.json"