@imfusion/web-ui 0.10.1-dev.41.g467e0e1a → 0.10.1-dev.46.g5fe8962a

package/dist/web-ui-cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { a as e, c as t, i as n, n as r, o as i, r as a, t as o } from "./paths-CZtwNknt.js";
-import { chmodSync as s, cpSync as c, existsSync as l, lstatSync as u, mkdirSync as d, readFileSync as f, readdirSync as p, readlinkSync as ee, realpathSync as m, rmSync as h, symlinkSync as te, writeFileSync as g } from "node:fs";
-import { dirname as ne, relative as _, resolve as v } from "node:path";
-import { Command as re, Option as ie } from "commander";
-import * as y from "@clack/prompts";
-var b = {
+import { n as e, r as t, t as n } from "./paths-B5Ht3ETc.js";
+import { chmodSync as r, cpSync as i, existsSync as a, lstatSync as o, mkdirSync as s, readFileSync as c, readdirSync as l, readlinkSync as u, realpathSync as d, rmSync as f, symlinkSync as p, writeFileSync as m } from "node:fs";
+import { dirname as h, relative as g, resolve as _ } from "node:path";
+import { Command as ee, Option as te } from "commander";
+import * as v from "@clack/prompts";
+var y = {
 	harnesses: {
 		claude: {
 			label: "Claude Code",
@@ -24,91 +24,91 @@ var b = {
 	skillsDir: ".agents/skills",
 	linkDir: ".claude/skills",
 	versionMarker: ".imf-web-ui-skill-version.json"
-}, ae = `<!-- ${b.namespace}:begin`, x = `<!-- ${b.namespace}:end -->`, oe = v(r, b.templatesDir, "AGENTS.md"), S = v(a, "AGENTS.md");
-function C(e) {
-	let t = e.indexOf(ae), n = e.indexOf(x);
-	return t === -1 || n === -1 ? null : e.slice(t, n + x.length);
+}, ne = `<!-- ${y.namespace}:begin`, b = `<!-- ${y.namespace}:end -->`, re = _(e, y.templatesDir, "AGENTS.md"), x = _(t, "AGENTS.md");
+function S(e) {
+	let t = e.indexOf(ne), n = e.indexOf(b);
+	return t === -1 || n === -1 ? null : e.slice(t, n + b.length);
 }
-function se() {
-	if (!l(S)) return "absent";
-	let e = C(f(oe, "utf-8"));
+function ie() {
+	if (!a(x)) return "absent";
+	let e = S(c(re, "utf-8"));
 	if (!e) return "absent";
-	let t = f(S, "utf-8"), n = C(t), r = n ? t.replace(n, e) : `${t.trimEnd()}\n\n${e}\n`;
-	return r === t ? "unchanged" : (g(S, r), n ? "updated" : "added");
+	let t = c(x, "utf-8"), n = S(t), r = n ? t.replace(n, e) : `${t.trimEnd()}\n\n${e}\n`;
+	return r === t ? "unchanged" : (m(x, r), n ? "updated" : "added");
 }
 //#endregion
 //#region src/cli/skills.ts
-var w = Object.keys(b.harnesses).filter((e) => e in b.harnesses), ce = [...w, "all"];
+var C = Object.keys(y.harnesses).filter((e) => e in y.harnesses), w = [...C, "all"];
 function T(e) {
-	return e === "all" ? w : [e];
+	return e === "all" ? C : [e];
 }
 function E(e) {
-	return `./${_(a, e)}`;
+	return `./${g(t, e)}`;
 }
-var D = b.namespace, O = b.versionMarker, k = v(r, b.skillsSource), A = v(a, b.skillsDir), j = v(a, b.linkDir), M = class extends Error {}, N = JSON.parse(f(v(r, "package.json"), "utf-8"));
-if (typeof N != "object" || !N || !("version" in N) || typeof N.version != "string") throw Error(`${v(r, "package.json")} has no string "version" field`);
+var D = y.namespace, O = y.versionMarker, k = _(e, y.skillsSource), A = _(t, y.skillsDir), j = _(t, y.linkDir), M = class extends Error {}, N = JSON.parse(c(_(e, "package.json"), "utf-8"));
+if (typeof N != "object" || !N || !("version" in N) || typeof N.version != "string") throw Error(`${_(e, "package.json")} has no string "version" field`);
 var P = N.version;
 function F(e) {
 	return e === D || e.startsWith(`${D}-`);
 }
 function I() {
-	return l(k) ? p(k, { withFileTypes: !0 }).filter((e) => e.isDirectory() && F(e.name)).map((e) => e.name).sort() : [];
+	return a(k) ? l(k, { withFileTypes: !0 }).filter((e) => e.isDirectory() && F(e.name)).map((e) => e.name).sort() : [];
 }
-function le(e) {
-	let t = v(A, e, O);
-	if (!l(t)) return null;
+function ae(e) {
+	let t = _(A, e, O);
+	if (!a(t)) return null;
 	try {
-		let e = JSON.parse(f(t, "utf-8"));
+		let e = JSON.parse(c(t, "utf-8"));
 		if (typeof e != "object" || !e) return null;
 		let n = "harnesses" in e && Array.isArray(e.harnesses) ? e.harnesses : null;
-		return n ? w.filter((e) => n.includes(e)) : null;
+		return n ? C.filter((e) => n.includes(e)) : null;
 	} catch {
 		return null;
 	}
 }
 function L(e) {
 	for (let t of e) {
-		let e = le(t);
+		let e = ae(t);
 		if (e && e.length > 0) return e;
 	}
 	return null;
 }
 function R(e, t, n) {
-	if (l(e)) for (let r of p(e).filter(F)) t.has(r) || (h(v(e, r), {
+	if (a(e)) for (let r of l(e).filter(F)) t.has(r) || (f(_(e, r), {
 		recursive: !0,
 		force: !0
-	}), y.log.info(`Removed skill: ${r} (${n})`));
+	}), v.log.info(`Removed skill: ${r} (${n})`));
 }
-function ue() {
-	return l(j) && l(A) && m(j) === m(A);
+function oe() {
+	return a(j) && a(A) && d(j) === d(A);
 }
-function de(e) {
-	let t = v(j, e), n = _(j, v(A, e)), r = u(t, { throwIfNoEntry: !1 });
-	r?.isSymbolicLink() && ee(t) === n || (r && h(t, {
+function z(e) {
+	let t = _(j, e), n = g(j, _(A, e)), r = o(t, { throwIfNoEntry: !1 });
+	r?.isSymbolicLink() && u(t) === n || (r && f(t, {
 		recursive: !0,
 		force: !0
-	}), d(j, { recursive: !0 }), te(n, t));
+	}), s(j, { recursive: !0 }), p(n, t));
 }
-function fe(e, t) {
+function se(e, t) {
 	try {
-		d(A, { recursive: !0 });
-		let n = [];
-		for (let r of e) {
-			let e = v(A, r);
-			h(e, {
+		s(A, { recursive: !0 });
+		let r = [];
+		for (let n of e) {
+			let e = _(A, n);
+			f(e, {
 				recursive: !0,
 				force: !0
-			}), c(v(k, r), e, { recursive: !0 });
-			let i = v(e, O);
-			g(i, JSON.stringify({
+			}), i(_(k, n), e, { recursive: !0 });
+			let a = _(e, O);
+			m(a, JSON.stringify({
 				version: P,
 				harnesses: t
-			}, null, 2) + "\n"), n.push(i);
+			}, null, 2) + "\n"), r.push(a);
 		}
-		if (o(n), R(A, new Set(e), "no longer in this bundle"), y.log.success(`Skills -> ${E(A)}/${D}*`), ue()) return;
+		if (n(r), R(A, new Set(e), "no longer in this bundle"), v.log.success(`Skills -> ${E(A)}/${D}*`), oe()) return;
 		if (t.includes("claude")) {
-			for (let t of e) de(t);
-			R(j, new Set(e), "no longer in this bundle"), y.log.success(`Claude Code -> ${E(j)}/${D}* (symlinks -> ${E(A)})`);
+			for (let t of e) z(t);
+			R(j, new Set(e), "no longer in this bundle"), v.log.success(`Claude Code -> ${E(j)}/${D}* (symlinks -> ${E(A)})`);
 		} else R(j, /* @__PURE__ */ new Set(), "claude not selected");
 	} catch (e) {
 		throw e instanceof Error ? new M(e.message) : e;
@@ -116,68 +116,68 @@ function fe(e, t) {
 }
 //#endregion
 //#region src/cli/hooks.ts
-var z = v(r, b.templatesDir), B = v(z, "hooks"), V = v(a, b.hooksDir), H = class extends Error {};
-function pe(e, t) {
-	if (typeof e != "object" || !e || Array.isArray(e)) throw new H(`${t} is not a JSON object.`);
+var B = _(e, y.templatesDir), V = _(B, "hooks"), H = _(t, y.hooksDir), U = class extends Error {};
+function ce(e, t) {
+	if (typeof e != "object" || !e || Array.isArray(e)) throw new U(`${t} is not a JSON object.`);
 	let n = { ...e };
 	if ("hooks" in n) {
-		if (typeof n.hooks != "object" || n.hooks === null || Array.isArray(n.hooks)) throw new H(`${t}: "hooks" is not a JSON object.`);
-		for (let [e, r] of Object.entries(n.hooks)) if (!Array.isArray(r)) throw new H(`${t}: "hooks.${e}" is not a JSON array.`);
+		if (typeof n.hooks != "object" || n.hooks === null || Array.isArray(n.hooks)) throw new U(`${t}: "hooks" is not a JSON object.`);
+		for (let [e, r] of Object.entries(n.hooks)) if (!Array.isArray(r)) throw new U(`${t}: "hooks.${e}" is not a JSON array.`);
 	}
 	return n;
 }
-function U(e) {
+function W(e) {
 	let t;
 	try {
-		t = JSON.parse(f(e, "utf-8"));
+		t = JSON.parse(c(e, "utf-8"));
 	} catch {
-		throw new H(`${e} is not valid JSON.`);
+		throw new U(`${e} is not valid JSON.`);
 	}
-	return pe(t, e);
+	return ce(t, e);
 }
-function me() {
-	let e = p(B).filter((e) => e.endsWith(".sh"));
-	d(V, { recursive: !0 });
+function le() {
+	let e = l(V).filter((e) => e.endsWith(".sh"));
+	s(H, { recursive: !0 });
 	for (let t of e) {
-		let e = v(V, t);
-		c(v(B, t), e, { force: !0 }), s(e, 493);
+		let e = _(H, t);
+		i(_(V, t), e, { force: !0 }), r(e, 493);
 	}
-	let t = p(V).filter((t) => t.endsWith(".sh") && !e.includes(t));
-	for (let e of t) h(v(V, e), { force: !0 });
+	let t = l(H).filter((t) => t.endsWith(".sh") && !e.includes(t));
+	for (let e of t) f(_(H, e), { force: !0 });
 	return {
 		installed: e,
 		removed: t
 	};
 }
-var W = `${b.hooksDir}/`;
-function G(e) {
+var G = `${y.hooksDir}/`;
+function K(e) {
 	if (typeof e != "string") return null;
-	let t = e.lastIndexOf(W);
+	let t = e.lastIndexOf(G);
 	if (t === -1) return null;
-	let n = /^([\w.-]+)["']?$/.exec(e.slice(t + W.length));
+	let n = /^([\w.-]+)["']?$/.exec(e.slice(t + G.length));
 	return n ? n[1] : null;
 }
-function K(e) {
-	return typeof e == "object" && !!e && "hooks" in e && Array.isArray(e.hooks);
-}
 function q(e) {
-	return K(e) ? e.hooks : null;
+	return typeof e == "object" && !!e && "hooks" in e && Array.isArray(e.hooks);
 }
 function J(e) {
-	return typeof e == "object" && e && "command" in e ? e.command : void 0;
+	return q(e) ? e.hooks : null;
 }
 function Y(e) {
-	let t = q(e);
-	return t ? t.map((e) => G(J(e))).filter((e) => e !== null) : [];
+	return typeof e == "object" && e && "command" in e ? e.command : void 0;
+}
+function X(e) {
+	let t = J(e);
+	return t ? t.map((e) => K(Y(e))).filter((e) => e !== null) : [];
 }
-function he(e, t, n) {
+function ue(e, t, n) {
 	e.hooks ??= {};
 	let r = 0, i = 0, a = [];
 	for (let [r, o] of Object.entries(e.hooks)) {
 		let s = 0, c = o.map((e) => {
-			if (!K(e)) return e;
+			if (!q(e)) return e;
 			let t = e.hooks, r = t.filter((e) => {
-				let t = G(J(e));
+				let t = K(Y(e));
 				return t === null || n.includes(t);
 			});
 			return s += t.length - r.length, r.length === t.length ? e : {
@@ -185,7 +185,7 @@ function he(e, t, n) {
 				hooks: r
 			};
 		}).filter((e) => {
-			let t = q(e);
+			let t = J(e);
 			return t === null || t.length > 0;
 		});
 		s !== 0 && (i += s, c.length === 0 && !(r in t) ? a.push(r) : e.hooks[r] = c);
@@ -194,8 +194,8 @@ function he(e, t, n) {
 	for (let [n, i] of Object.entries(t)) {
 		e.hooks[n] ??= [];
 		for (let t of i) {
-			let i = Y(t);
-			e.hooks[n].some((e) => Y(e).some((e) => i.includes(e))) || (e.hooks[n].push(t), r++);
+			let i = X(t);
+			e.hooks[n].some((e) => X(e).some((e) => i.includes(e))) || (e.hooks[n].push(t), r++);
 		}
 	}
 	return {
@@ -203,72 +203,72 @@ function he(e, t, n) {
 		removed: i
 	};
 }
-function ge(e) {
-	let t = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map();
-	for (let r of w) {
-		let i = v(a, b.harnesses[r].hookSettings);
-		if (l(i) && t.set(r, U(i)), e.includes(r)) {
-			let e = v(z, b.harnesses[r].hookTemplate);
-			n.set(r, U(e).hooks ?? {});
+function de(e) {
+	let r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map();
+	for (let n of C) {
+		let o = _(t, y.harnesses[n].hookSettings);
+		if (a(o) && r.set(n, W(o)), e.includes(n)) {
+			let e = _(B, y.harnesses[n].hookTemplate);
+			i.set(n, W(e).hooks ?? {});
 		}
 	}
-	let { installed: r, removed: i } = me();
-	y.log.success(`Agent hooks -> ${E(V)} (${String(r.length)} scripts)`), i.length > 0 && y.log.info(`Removed stale hook script(s): ${i.join(", ")} (no longer shipped)`);
-	for (let i of w) {
-		let s = e.includes(i);
-		if (!s && !t.has(i)) continue;
-		let c = v(a, b.harnesses[i].hookSettings), l = n.get(i) ?? {}, u = t.get(i) ?? {}, f = he(u, l, s ? r : []);
+	let { installed: o, removed: c } = le();
+	v.log.success(`Agent hooks -> ${E(H)} (${String(o.length)} scripts)`), c.length > 0 && v.log.info(`Removed stale hook script(s): ${c.join(", ")} (no longer shipped)`);
+	for (let a of C) {
+		let c = e.includes(a);
+		if (!c && !r.has(a)) continue;
+		let l = _(t, y.harnesses[a].hookSettings), u = i.get(a) ?? {}, d = r.get(a) ?? {}, f = ue(d, u, c ? o : []);
 		if (f.added === 0 && f.removed === 0) {
-			s && y.log.info(`Hook registrations already present in ${E(c)}`);
+			c && v.log.info(`Hook registrations already present in ${E(l)}`);
 			continue;
 		}
-		d(ne(c), { recursive: !0 }), g(c, JSON.stringify(u, null, 2) + "\n"), o([c]);
+		s(h(l), { recursive: !0 }), m(l, JSON.stringify(d, null, 2) + "\n"), n([l]);
 		let p = [f.added > 0 && `registered ${String(f.added)}`, f.removed > 0 && `removed ${String(f.removed)} stale`].filter(Boolean);
-		y.log.success(`${p.join(", ")} hook registration(s) in ${E(c)}`);
+		v.log.success(`${p.join(", ")} hook registration(s) in ${E(l)}`);
 	}
 }
 //#endregion
 //#region src/cli/index.ts
-function X() {
-	return new ie("--harness <harness>", "claude, codex, or all").choices(ce);
+function Z() {
+	return new te("--harness <harness>", "claude, codex, or all").choices(w);
 }
-async function Z(e, t, n) {
-	if (t) return y.log.info(`Harness from --harness flag: ${t.join(", ")}`), t;
+async function fe(e, t, n) {
+	if (t) return v.log.info(`Harness from --harness flag: ${t.join(", ")}`), t;
 	let r = L(e);
-	if (r && !n) return y.log.info(`Refreshing the existing install: ${r.join(", ")} — pass --reconfigure to choose differently.`), r;
+	if (r && !n) return v.log.info(`Refreshing the existing install: ${r.join(", ")} — pass --reconfigure to choose differently.`), r;
 	if (!process.stdin.isTTY) return console.error("Pass --harness=claude|codex|all — no terminal to prompt in."), process.exitCode = 1, null;
-	let i = await y.multiselect({
+	let i = await v.multiselect({
 		message: "Install into which harness (or harnesses)?",
-		options: w.map((e) => ({
+		options: C.map((e) => ({
 			value: e,
-			label: b.harnesses[e].label
+			label: y.harnesses[e].label
 		})),
 		required: !0
 	});
-	return y.isCancel(i) ? (y.cancel("Cancelled — nothing installed."), null) : i;
+	return v.isCancel(i) ? (v.cancel("Cancelled — nothing installed."), null) : i;
 }
-async function _e(e) {
+async function pe(e) {
 	let t = e.harness ? T(e.harness) : null, n = I();
-	if (y.intro(`@imfusion/web-ui install skills — ${String(n.length)} skills`), n.length === 0) {
-		y.log.error("No skills found. Reinstall @imfusion/web-ui and try again."), y.outro("Nothing installed."), process.exitCode = 1;
+	if (v.intro(`@imfusion/web-ui install skills — ${String(n.length)} skills`), n.length === 0) {
+		v.log.error("No skills found. Reinstall @imfusion/web-ui and try again."), v.outro("Nothing installed."), process.exitCode = 1;
 		return;
 	}
-	let r = await Z(n, t, e.reconfigure === !0);
+	let r = await fe(n, t, e.reconfigure === !0);
 	if (!r) return;
-	y.log.message(`Skills in this bundle:\n${n.map((e) => `  - ${e}`).join("\n")}`);
+	v.log.message(`Skills in this bundle:\n${n.map((e) => `  - ${e}`).join("\n")}`);
 	try {
-		fe(n, r);
+		se(n, r);
 	} catch (e) {
 		if (e instanceof M) {
-			y.log.error(e.message), y.outro("Install failed."), process.exitCode = 1;
+			v.log.error(e.message), v.outro("Install failed."), process.exitCode = 1;
 			return;
 		}
 		throw e;
 	}
-	let i = se();
-	(i === "updated" || i === "added") && y.log.success(`Refreshed the ${b.namespace} block in ./AGENTS.md`), y.outro(`Done — ${String(n.length)} skills installed.`);
+	let i = ie();
+	(i === "updated" || i === "added") && v.log.success(`Refreshed the ${y.namespace} block in ./AGENTS.md`), v.outro(`Done — ${String(n.length)} skills installed.`);
 }
-function ve(e) {
+function me(e) {
 	let t = e.harness ? T(e.harness) : null, n = L(I());
 	if (!t && !n) {
 		console.error("No harness recorded. Pass --harness=claude|codex|all."), process.exitCode = 1;
@@ -278,56 +278,24 @@ function ve(e) {
 	if (i.length > 0) {
 		for (let e of i) console.error(`No skills installed for ${e}. Run \`npx web-ui install skills --harness=${e}\` first.`);
 		process.exitCode = 1;
-		return;
-	}
-	y.intro("@imfusion/web-ui install hooks");
-	try {
-		ge(r);
-	} catch (e) {
-		if (e instanceof H) {
-			console.error(e.message), process.exitCode = 1;
-			return;
+	} else {
+		v.intro("@imfusion/web-ui install hooks");
+		try {
+			de(r);
+		} catch (e) {
+			if (e instanceof U) {
+				console.error(e.message), process.exitCode = 1;
+				return;
+			}
+			throw e;
 		}
-		throw e;
-	}
-	y.outro("Done — agent hooks installed.");
-}
-function ye(r) {
-	let i = r ?? process.env.WEB_UI_CHECKOUT;
-	if (!i) {
-		console.error("Pass the checkout path, or set WEB_UI_CHECKOUT."), process.exitCode = 1;
-		return;
-	}
-	let o = v(i);
-	try {
-		let t = e(a, o);
-		y.log.success(`Linked ${o} into ${E(t)}`);
-	} catch (e) {
-		if (e instanceof n) {
-			console.error(e.message), process.exitCode = 1;
-			return;
-		}
-		throw e;
-	}
-	y.log.info("Syncing on every rebuild of dist/. Ctrl+C stops syncing; the app keeps the last synced build."), t(a, o, (e) => {
-		y.log.info(e);
-	});
-}
-function be() {
-	try {
-		for (let e of i(a)) y.log.message(e);
-	} catch (e) {
-		if (e instanceof n) {
-			console.error(e.message), process.exitCode = 1;
-			return;
-		}
-		throw e;
+		v.outro("Done — agent hooks installed.");
 	}
 }
-var Q = new re();
+var Q = new ee();
 Q.name("web-ui").description("Command-line tools for @imfusion/web-ui").version(P);
 var $ = Q.command("install").description("Install @imfusion/web-ui agent skills or hooks into a project");
-$.command("skills").description("Install skills for the chosen harness").addOption(X()).option("--reconfigure", "Re-open the harness selection prompt on an existing install").action(_e), $.command("hooks").description("Install agent lifecycle hooks (requires skills already installed for the harness)").addOption(X()).action(ve), Q.command("link").description("Serve a local @imfusion/web-ui checkout from this project and sync it on every rebuild").argument("[path]", "checkout directory (default: WEB_UI_CHECKOUT)").action(ye), Q.command("unlink").description("Restore the published @imfusion/web-ui files in this project").action(be), $.action(() => {
+$.command("skills").description("Install skills for the chosen harness").addOption(Z()).option("--reconfigure", "Re-open the harness selection prompt on an existing install").action(pe), $.command("hooks").description("Install agent lifecycle hooks (requires skills already installed for the harness)").addOption(Z()).action(me), $.action(() => {
 	$.help();
 }), Q.action(() => {
 	Q.help();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imfusion/web-ui",
-  "version": "0.10.1-dev.41.g467e0e1a",
+  "version": "0.10.1-dev.46.g5fe8962a",
   "description": "The official Web UI component library for ImFusion web apps",
   "author": "ImFusion GmbH",
   "homepage": "https://imfusion.com",
@@ -138,7 +138,7 @@
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "@vitejs/plugin-react": "6.0.1",
-    "@vitest/browser-playwright": "5.0.3",
+    "@vitest/browser-playwright": "5.0.4",
     "concurrently": "9.2.1",
     "culori": "4.0.2",
     "fast-xml-parser": "5.11.2",
@@ -148,19 +148,21 @@
     "mermaid": "12.0.0",
     "playwright": "1.60.0",
     "prettier": "3.8.3",
+    "react": "19.2.5",
     "react-docgen-typescript": "2.4.0",
+    "react-dom": "19.2.5",
     "remark-gfm": "4.0.1",
     "storybook": "10.6.2",
     "tsx": "4.21.0",
     "typescript": "6.0.3",
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.1.0",
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.2.0",
     "vite-plugin-dts": "5.0.0",
-    "vite-plus": "1.1.0",
-    "vitest": "5.0.3"
+    "vite-plus": "1.2.0",
+    "vitest": "5.0.4"
   },
   "overrides": {
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.1.0",
-    "vitest": "5.0.3",
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.2.0",
+    "vitest": "5.0.4",
     "storybook": {
       ".": "$storybook",
       "vite-plus": "$vite-plus"

package/src/llms/install-templates/hooks/baseline-staleness.sh

@@ -4,6 +4,8 @@
 # and warns on drift. Always exits 0 — staleness never blocks a commit.
 PKG=node_modules/@imfusion/web-ui/package.json
 [ -f "$PKG" ] || exit 0
+# A symlinked checkout reports its own dev version.
+[ -L node_modules/@imfusion/web-ui ] && exit 0
 CURRENT=$(node -p "require('./$PKG').version" 2>/dev/null) || exit 0
 
 # .claude/skills may be a symlink to .agents/skills; skip markers already read.

package/src/llms/install-templates/hooks/stop.sh

@@ -10,9 +10,12 @@ git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0
 [ -n "$(git status --porcelain -- '*.ts' '*.tsx' '*.js' '*.jsx' '*.css' 2>/dev/null)" ] || exit 0
 # Gate only turns that actually edited files — a tree left dirty by an earlier
 # session must not block a question-answering turn. Edit evidence: Write/Edit
-# tool calls (Claude transcript) or apply_patch calls (Codex rollout).
+# tool calls (Claude transcript) or apply_patch calls (Codex rollout), searched
+# only after the turn's opening entry: the last real user prompt (not a tool
+# result or injected meta message) or the last Codex task_started event.
 TRANSCRIPT=$(printf '%s' "$PAYLOAD" | sed -n 's/.*"transcript_path"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -n 1)
 [ -f "$TRANSCRIPT" ] || exit 0
-grep -q '"name":"Write"\|"name":"Edit"\|"name":"MultiEdit"\|"name":"NotebookEdit"\|apply_patch' "$TRANSCRIPT" || exit 0
+TURN_START=$(grep -En '"type":"user"|"type":"task_started"' "$TRANSCRIPT" | grep -Ev '"type":"tool_result"|"isMeta":true' | tail -n 1 | cut -d: -f1)
+tail -n +$(( ${TURN_START:-0} + 1 )) "$TRANSCRIPT" | grep -Eq '"name":"Write"|"name":"Edit"|"name":"MultiEdit"|"name":"NotebookEdit"|"name":"apply_patch"' || exit 0
 printf '{"decision":"block","reason":"web-ui stop gate: this turn changed source files. Run the project verification (verify:typecheck, verify:lint, and verify:format at minimum), fix what it reports, then finish. If it already ran after the last change, say so and finish."}\n'
 exit 0

package/src/llms/skills/imf-web-ui/SKILL.md

@@ -3,8 +3,7 @@ name: imf-web-ui
 description:
   "Route UI work and library questions in a project that uses @imfusion/web-ui. Use this skill whenever a user adds, edits,
   styles, or reviews UI, or asks about library setup, brand assets, favicons, theming, or usage in a consumer project, even
-  if they do not mention the library. Also use it to link, unlink, or use a live local Web UI checkout. Open only the
-  matching packaged guide or companion skill."
+  if they do not mention the library. Open only the matching packaged guide or companion skill."
 ---
 
 # Route Web UI work
@@ -24,19 +23,18 @@ may not already have. Open a companion by invoking its skill; reading one of its
 
 ## 2. Route the task
 
-| Task                                                                 | Open                                     |
-| -------------------------------------------------------------------- | ---------------------------------------- |
-| Understand library setup, brand assets, theming, or usage            | Packaged user guides below               |
-| Look up a component, part, prop, default, or icon                    | `imf-web-ui-components`                  |
-| Choose components or shape a screen, form, or flow                   | `imf-web-ui-ux`                          |
-| Write or update documentation                                        | `imf-web-ui-conventions`                 |
-| Write a wrapper, custom UI, CSS, data layer, validation, or tests    | `imf-web-ui-conventions`                 |
-| Choose a routing, data, form, or validation library for the project  | `imf-web-ui-conventions`                 |
-| Install the library or bootstrap project tooling                     | `imf-web-ui-setup`                       |
-| Diagnose a broken install: unstyled output, missing tokens, no theme | `imf-web-ui-setup`                       |
-| Inspect an existing project without changing it                      | `imf-web-ui-audit`                       |
-| Update the package, skills, or hooks                                 | `imf-web-ui-update`                      |
-| Link, unlink, or use a live local Web UI checkout                    | `imf-web-ui-conventions` `tooling` topic |
+| Task                                                                 | Open                       |
+| -------------------------------------------------------------------- | -------------------------- |
+| Understand library setup, brand assets, theming, or usage            | Packaged user guides below |
+| Look up a component, part, prop, default, or icon                    | `imf-web-ui-components`    |
+| Choose components or shape a screen, form, or flow                   | `imf-web-ui-ux`            |
+| Write or update documentation                                        | `imf-web-ui-conventions`   |
+| Write a wrapper, custom UI, CSS, data layer, validation, or tests    | `imf-web-ui-conventions`   |
+| Choose a routing, data, form, or validation library for the project  | `imf-web-ui-conventions`   |
+| Install the library or bootstrap project tooling                     | `imf-web-ui-setup`         |
+| Diagnose a broken install: unstyled output, missing tokens, no theme | `imf-web-ui-setup`         |
+| Inspect an existing project without changing it                      | `imf-web-ui-audit`         |
+| Update the package, skills, or hooks                                 | `imf-web-ui-update`        |
 
 A new form opens `imf-web-ui-ux`, even when its fields and action are already specified. A screen often needs both
 `imf-web-ui-ux` and `imf-web-ui-components`, in that order. Setup and audit are for project-wide questions, not every

package/src/llms/skills/imf-web-ui-audit/SKILL.md

@@ -61,7 +61,10 @@ Classify every result as one of these:
 Use the report contract's severity, `path:line` evidence, concrete impact, and smallest next action. Unverified entries use
 that same structure: unavailable runtime evidence, the impact of the unknown, and the check that resolves it. Do not promote
 an optional tool or a working alternative to a missing finding. A `vite.config.ts` without `localWebUILink()` registered from
-`@imfusion/web-ui/vite` is Missing. Its next action is the one-line add from the `tooling` topic.
+`@imfusion/web-ui/vite` is Missing. A `tsconfig.json` without the `paths` block from the `tooling` topic is Missing too. Each
+next action is the add from that topic. A major or minor mismatch between the project and Web UI on a package listed under
+Aligned runtime packages in the `tooling` topic is a Deviation. Report both versions, with
+`npm install <package>@<Web UI's version>` as the fix.
 
 ## Topics