synthesisui 0.16.10 → 0.16.11

package/dist/commands/hook.js

@@ -0,0 +1,76 @@
+import { readFile } from "node:fs/promises";
+import { relative, resolve } from "node:path";
+import { diagnose, scanSource } from "../doctor/scan.js";
+import { loadSystem } from "./doctor.js";
+const pass = () => ({ continue: true });
+const speak = (context) => ({
+    continue: true,
+    hookSpecificOutput: {
+        hookEventName: "PostToolUse",
+        additionalContext: context,
+    },
+});
+/** Files where a design value can even appear. A hook that parses a README on
+ *  every edit is paying for nothing. */
+const UI_FILE = /\.(tsx|jsx|ts|js|css|scss|vue|svelte)$/i;
+async function report(root, filePath) {
+    const { table } = await loadSystem(root);
+    if (table.byName.size === 0)
+        return null;
+    const src = await readFile(filePath, "utf8").catch(() => "");
+    if (!src)
+        return null;
+    const rel = relative(root, filePath);
+    const d = diagnose([scanSource(rel, src, table)]);
+    const named = d.findings.filter((f) => f.token);
+    const phantoms = d.files.flatMap((f) => f.phantoms ?? []);
+    // Unnamed drift alone is deliberately NOT worth interrupting for. There is
+    // no token to move to, so the only honest advice is "ask a person" - and
+    // saying that after every edit trains the reader to skip the block.
+    if (named.length === 0 && phantoms.length === 0)
+        return null;
+    const lines = [`${rel} - checked against ${table.name ?? table.slug}.`];
+    if (named.length > 0) {
+        lines.push("", "Values written by hand that this system already has a name for:", ...named
+            .slice(0, 20)
+            .map((f) => `  line ${f.line}  ${f.literal} → ${f.token}`), "", "Replace them now, while you still have this file in mind.");
+    }
+    if (phantoms.length > 0) {
+        lines.push("", "Names this system does not declare. These look tokenized and apply nothing at all:", ...phantoms.slice(0, 20).map((p) => `  line ${p.line}  ${p.name}`), "", "Use a name the system has, or say which value you need and what you would call it. Do NOT invent a token.");
+    }
+    return lines.join("\n");
+}
+export async function hook(opts) {
+    const root = resolve(opts.dir ?? process.cwd());
+    let raw = "";
+    for await (const chunk of process.stdin)
+        raw += chunk;
+    let input;
+    try {
+        input = JSON.parse(raw);
+    }
+    catch {
+        // Anything we cannot read must let the edit through untouched. A hook that
+        // fails loudly on a payload change is worse than no hook.
+        process.stdout.write(`${JSON.stringify(pass())}\n`);
+        return;
+    }
+    const writes = input.tool_name === "Write" ||
+        input.tool_name === "Edit" ||
+        input.tool_name === "MultiEdit";
+    const file = input.tool_input?.file_path;
+    if (input.hook_event_name !== "PostToolUse" || !writes || !file) {
+        process.stdout.write(`${JSON.stringify(pass())}\n`);
+        return;
+    }
+    const abs = resolve(root, file);
+    // Our own installed artifacts are the answer, not the problem - and a file
+    // outside the project is none of our business.
+    const inside = !relative(root, abs).startsWith("..");
+    if (!UI_FILE.test(abs) || !inside || abs.includes("_synthesisui")) {
+        process.stdout.write(`${JSON.stringify(pass())}\n`);
+        return;
+    }
+    const body = await report(root, abs).catch(() => null);
+    process.stdout.write(`${JSON.stringify(body ? speak(body) : pass())}\n`);
+}

package/dist/index.js

@@ -6,6 +6,7 @@ import { clean } from "./commands/clean.js";
 import { component } from "./commands/component.js";
 import { doctor } from "./commands/doctor.js";
 import { generate } from "./commands/generate.js";
+import { hook } from "./commands/hook.js";
 import { init } from "./commands/init.js";
 import { list } from "./commands/list.js";
 import { login } from "./commands/login.js";
@@ -134,6 +135,11 @@ async function main() {
                 slug: typeof flags.slug === "string" ? flags.slug : undefined,
             });
             break;
+        // Both of these read stdin and write a protocol frame to stdout, so
+        // nothing that prints may run near them.
+        case "hook":
+            await hook({ dir });
+            return;
         // Long-lived: it owns stdin/stdout until the client closes the pipe, so
         // it must not be reached by anything that prints.
         case "mcp":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "synthesisui",
-  "version": "0.16.10",
+  "version": "0.16.11",
   "description": "Bring SynthesisUI design systems into any project - tokens, typed components, whole pages and an agent-ready CLAUDE.md manifest.",
   "type": "module",
   "bin": {