@tryvitris/website-harness 0.0.0-stage → 0.1.0-beta.5

package/bin/vitris-art.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+import {
+  artDirectionPolicy,
+  byteHash,
+  findActivePreparation,
+  inspectProducedAsset,
+  invalidatePreparation,
+  loadSiteGraph,
+  loadState,
+  registerProducedAsset,
+  releaseDurableLease,
+  retireProducedAsset,
+  validateAssetProduction,
+  withMutationLock
+} from "./chunks/chunk-3CTBXY5K.js";
+import "./chunks/chunk-DSS2U2OM.js";
+import "./chunks/chunk-M4LNHYYR.js";
+import "./chunks/chunk-DRJQ4OOU.js";
+import "./chunks/chunk-PRLL7B63.js";
+import "./chunks/chunk-5OOPJNGN.js";
+import {
+  invalidate
+} from "./chunks/chunk-BBV7PMFC.js";
+import {
+  readStockCatalog,
+  searchStock
+} from "./chunks/chunk-TY33XMHW.js";
+import "./chunks/chunk-R7YELY3C.js";
+import "./chunks/chunk-BIEDSEL2.js";
+import "./chunks/chunk-T7DGRVTP.js";
+import "./chunks/chunk-AUO5I56E.js";
+import "./chunks/chunk-6H3T46F5.js";
+import "./chunks/chunk-M2ETYSVJ.js";
+import "./chunks/chunk-FOXUQXTV.js";
+import "./chunks/chunk-IKNMBGGD.js";
+import "./chunks/chunk-WEFDVXFX.js";
+import "./chunks/chunk-E5Y46VBX.js";
+import "./chunks/chunk-4GZCAWWK.js";
+import "./chunks/chunk-ANMJRJQ5.js";
+import {
+  findHarnessRoot
+} from "./chunks/chunk-HNORQ74T.js";
+import "./chunks/chunk-YCVGD2CG.js";
+import "./chunks/chunk-LKN75JGA.js";
+import "./chunks/chunk-YYPYYOEV.js";
+import "./chunks/chunk-GZDLXYZV.js";
+import {
+  mediaDimensions
+} from "./chunks/chunk-G7MNMULR.js";
+import {
+  json,
+  save,
+  within
+} from "./chunks/chunk-T6PE4KN4.js";
+import "./chunks/chunk-7FS67SRF.js";
+
+// scripts/art-direction.ts
+import { resolve, join as join3 } from "node:path";
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "node:fs";
+
+// src/agent/media-revision.ts
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+function reviseMedia(root2, request) {
+  if (!artDirectionPolicy(root2) || !/^[a-z0-9-]{3,80}$/.test(request.operationId) || !request.request.trim()) throw new Error("Media revision needs opted-in policy, durable ID and exact request");
+  return withMutationLock(root2, () => {
+    const path = join(root2, `agent/media-revisions/${request.operationId}.json`);
+    if (existsSync(path)) {
+      const old = json(path);
+      if (JSON.stringify(old.request) !== JSON.stringify(request)) throw new Error("Revision operation identity changed");
+      return old;
+    }
+    const graph = loadSiteGraph(root2), state = loadState(root2, graph);
+    const owner = request.kind === "placement" ? "storyboard" : ["derivative", "illustration"].includes(request.kind) ? "asset-production" : ["unknown", "inspection"].includes(request.kind) ? "media" : "business";
+    for (const node of graph.nodes) {
+      const prep = findActivePreparation(root2, node.id);
+      if (!prep) continue;
+      invalidatePreparation(root2, prep.id, "Media revision routed to " + owner);
+      releaseDurableLease(root2, `stage-${node.id}`, prep.ownerToken);
+    }
+    invalidate(graph, state, owner);
+    if (["customer-evidence", "factual"].includes(request.kind)) invalidate(graph, state, "media");
+    save(join(root2, "agent/STATE.json"), state);
+    const receipt = { version: 1, request, owner, at: (/* @__PURE__ */ new Date()).toISOString(), affected: graph.nodes.filter((n) => state.nodes[n.id]?.status === "pending").map((n) => n.id) };
+    save(path, receipt);
+    save(join(root2, `agent/requests/${owner}.json`), { originalRequest: request.request, proposedChanges: request.request, preserve: request.preserve, evidencePath: `agent/media-revisions/${request.operationId}.json`, routes: request.routes });
+    return receipt;
+  });
+}
+
+// src/stock/site-acquisition.ts
+import { existsSync as existsSync2, mkdirSync, writeFileSync } from "node:fs";
+import { join as join2 } from "node:path";
+async function acquireSiteStock(opts) {
+  if (!/^[a-z0-9-]{3,80}$/.test(opts.operationId) || !opts.fallback.trim() || !Number.isInteger(opts.maxCandidates) || opts.maxCandidates < 1 || opts.maxCandidates > 4 || !Number.isSafeInteger(opts.maxBytes) || opts.maxBytes < 1 || opts.maxBytes > 2e7) throw new Error("Acquisition needs an operation ID, fallback and bounded candidate/byte limits");
+  const path = join2(opts.root, `artwork/acquisition-${opts.operationId}/receipt.json`);
+  const signature = byteHash(JSON.stringify({ query: opts.query, catalog: opts.catalog.map((i) => [i.id, i.sha256]), fallback: opts.fallback, maxCandidates: opts.maxCandidates, maxBytes: opts.maxBytes }));
+  if (existsSync2(path)) {
+    const old = json(path);
+    if (old.signature !== signature) throw new Error("Acquisition operation inputs changed");
+    if (old.status === "dispatched") {
+      old.status = "interrupted";
+      old.error = "Dispatch outcome unknown; inspect saved response before explicit new attempt";
+      save(path, old);
+    }
+    return old;
+  }
+  const matches = searchStock(opts.catalog.filter((i) => i.status === "accepted"), opts.query);
+  const result = { version: 1, signature, operationId: opts.operationId, status: matches.length ? "catalog-match" : !opts.key ? "unavailable" : "dispatched", query: opts.query, catalogIds: matches.map((i) => i.id), items: [], fallback: opts.fallback, calls: 0, bytes: 0, measuredCost: null, published: false };
+  save(path, result);
+  if (result.status !== "dispatched") return result;
+  const get = opts.transport || fetch;
+  try {
+    result.calls++;
+    save(path, result);
+    const query = [opts.query.text, opts.query.subject, opts.query.context, opts.query.detail, opts.query.metaphor, opts.query.setting].filter(Boolean).join(" ");
+    const url = new URL("https://api.pexels.com/v1/search");
+    url.searchParams.set("query", query);
+    url.searchParams.set("per_page", String(opts.maxCandidates));
+    if (opts.query.orientation) url.searchParams.set("orientation", opts.query.orientation);
+    const response = await get(url, { headers: { Authorization: opts.key }, signal: AbortSignal.timeout(3e4) });
+    if (!response.ok) throw new Error(`Pexels search status ${response.status}`);
+    const data = await response.json();
+    save(join2(opts.root, `artwork/acquisition-${opts.operationId}/response.json`), data);
+    for (const hit of (data.photos || []).slice(0, opts.maxCandidates)) {
+      const downloadUrl = hit.src.large2x || hit.src.large;
+      if (new URL(downloadUrl).protocol !== "https:" || new URL(downloadUrl).hostname !== "images.pexels.com") throw new Error("Unexpected provider download host");
+      result.calls++;
+      save(path, result);
+      const r = await get(downloadUrl, { signal: AbortSignal.timeout(3e4) });
+      if (!r.ok) throw new Error(`Download status ${r.status}`);
+      const chunks = [];
+      let size = 0;
+      for await (const chunk of r.body) {
+        size += chunk.length;
+        if (result.bytes + size > opts.maxBytes) {
+          await r.body?.cancel().catch(() => {
+          });
+          throw new Error("Acquisition byte budget reached");
+        }
+        chunks.push(chunk);
+      }
+      const bytes = Buffer.concat(chunks), sha256 = byteHash(bytes);
+      result.bytes += bytes.length;
+      const src = `/stock/images/${sha256}.jpg`, dest = within(opts.root, `artwork/acquisition-${opts.operationId}${src}`);
+      mkdirSync(join2(opts.root, `artwork/acquisition-${opts.operationId}/stock/images`), { recursive: true });
+      writeFileSync(dest, bytes, { flag: "wx" });
+      const thumb = src.replace("images", "thumbs");
+      mkdirSync(join2(opts.root, `artwork/acquisition-${opts.operationId}/stock/thumbs`), { recursive: true });
+      writeFileSync(within(opts.root, `artwork/acquisition-${opts.operationId}${thumb}`), bytes, { flag: "wx" });
+      result.items.push({ id: `pexels-image-${hit.id}`, kind: "image", src, thumb, thumbSha256: sha256, thumbBytes: bytes.length, alt: hit.alt || query, tags: [], categories: [], credit: `${hit.photographer} / Pexels`, pexelsId: hit.id, sha256, sourceUrl: hit.url, downloadUrl, thumbnailUrl: downloadUrl, acquiredAt: (/* @__PURE__ */ new Date()).toISOString(), termsUrl: "https://www.pexels.com/license/", ...mediaDimensions(bytes, "jpg"), bytes: bytes.length, status: "staged" });
+      save(path, result);
+      save(join2(opts.root, `artwork/acquisition-${opts.operationId}/catalog.json`), { version: 2, items: result.items });
+    }
+    result.status = result.items.length ? "staged" : "no-match";
+  } catch (e) {
+    result.status = "interrupted";
+    result.error = e instanceof Error ? e.message : String(e);
+  }
+  save(path, result);
+  return result;
+}
+
+// scripts/art-direction.ts
+var arg = (name) => {
+  const at = process.argv.indexOf(name);
+  return at < 0 ? void 0 : process.argv[at + 1];
+};
+var root = resolve(arg("--site") || ".");
+var command = process.argv[2];
+if (command === "retire") {
+  console.log(JSON.stringify(retireProducedAsset(root, json(resolve(arg("--record")))), null, 2));
+} else if (command === "inspect") {
+  console.log(JSON.stringify(inspectProducedAsset(root, json(resolve(arg("--record")))), null, 2));
+} else if (command === "register") {
+  if (!arg("--record")) throw new Error("register needs --record JSON with preparationId, operationId, requestId, input, sourcePath, method, tool, rights and forbiddenImplications");
+  console.log(JSON.stringify(registerProducedAsset(root, json(resolve(arg("--record")))), null, 2));
+} else if (command === "verify") {
+  const failures = validateAssetProduction(root);
+  console.log(JSON.stringify({ ok: !failures.length, failures }));
+  if (failures.length) process.exitCode = 1;
+} else if (command === "revise") {
+  console.log(JSON.stringify(reviseMedia(root, json(resolve(arg("--record")))), null, 2));
+} else if (command === "acquire") {
+  const prep = findActivePreparation(root, "asset-production");
+  if (!prep) throw new Error("Acquisition needs the active asset-production preparation");
+  const kernel = findHarnessRoot();
+  let key = process.env.PEXELS_API_KEY;
+  if (!key && existsSync3(join3(kernel, ".dev.vars"))) key = readFileSync2(join3(kernel, ".dev.vars"), "utf8").match(/^PEXELS_API_KEY\s*=\s*["']?([^\s"']+)/m)?.[1];
+  const record = json(resolve(arg("--record")));
+  console.log(JSON.stringify(await acquireSiteStock({ ...record, root, catalog: readStockCatalog(join3(kernel, "src/stock/catalog.json")).items, key }), null, 2));
+} else console.log("vitris-art register|inspect|retire|verify|revise|acquire --site SITE [--record JSON]. Kickoff/resume: vitris-go --site SITE --no-preview-server. Register only during the asset-production preparation; inspection and acceptance follow registration.");

package/bin/vitris-blocks.js

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+import {
+  blockPreviewRendererHash,
+  blockSourceHash,
+  loadBlockLibrary,
+  loadProfiledBlockLibrary
+} from "./chunks/chunk-FOXUQXTV.js";
+import "./chunks/chunk-HNORQ74T.js";
+import {
+  baseCss,
+  flattenBody,
+  primitivesCss,
+  siteIslands
+} from "./chunks/chunk-YCVGD2CG.js";
+import {
+  themeCss
+} from "./chunks/chunk-LKN75JGA.js";
+import {
+  defaultTheme
+} from "./chunks/chunk-YYPYYOEV.js";
+import "./chunks/chunk-GZDLXYZV.js";
+import "./chunks/chunk-7FS67SRF.js";
+
+// scripts/blocks-preview.ts
+import { mkdirSync, readdirSync, readFileSync, writeFileSync, existsSync, statSync, unlinkSync } from "node:fs";
+import { join, dirname, normalize, extname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createServer } from "node:http";
+import { createHash } from "node:crypto";
+var kernelRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
+var blocksRoot = join(kernelRoot, "blocks");
+var argv = process.argv.slice(2);
+var outIndex = argv.indexOf("--out");
+var siteIndex = argv.indexOf("--site");
+var siteRoot = siteIndex >= 0 && argv[siteIndex + 1] ? resolve(argv[siteIndex + 1]) : void 0;
+var installed = /(^|[/\\])node_modules([/\\]|$)/.test(kernelRoot);
+var outRoot = outIndex >= 0 && argv[outIndex + 1] ? resolve(argv[outIndex + 1]) : join(siteRoot || (installed ? process.cwd() : kernelRoot), "dist", "blocks");
+var profiled = siteRoot ? loadProfiledBlockLibrary(kernelRoot, siteRoot) : void 0;
+var library = new Map((profiled?.library || loadBlockLibrary(kernelRoot)).blocks.map((block) => [block.id, block]));
+var sha = (bytes) => createHash("sha256").update(bytes).digest("hex");
+var esc = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+function imageStatus(id, dir, previewHtml) {
+  const block = library.get(id);
+  const rel = block?.meta?.evidence.previewManifest;
+  if (!rel) return { status: "unavailable" };
+  const file = join(dir, rel);
+  if (!existsSync(file)) return { status: "unavailable" };
+  try {
+    const manifest = JSON.parse(readFileSync(file, "utf8"));
+    const valid = manifest.blockId === id && manifest.sourceHash === blockSourceHash(dir) && manifest.previewHtmlHash === sha(previewHtml) && manifest.rendererHash === blockPreviewRendererHash(kernelRoot) && ["mobile", "desktop"].every((kind) => {
+      const image = manifest.images?.[kind];
+      return image?.file && existsSync(join(dirname(file), image.file)) && sha(readFileSync(join(dirname(file), image.file))) === image.hash;
+    });
+    return { status: valid ? "current" : "stale", manifest: rel };
+  } catch {
+    return { status: "stale", manifest: rel };
+  }
+}
+function placeholder(w, h, label) {
+  const fs = Math.max(12, Math.round(Math.min(w, h) / 9));
+  const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}"><defs><linearGradient id="g" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#cbbba9"/><stop offset="1" stop-color="#7a6756"/></linearGradient></defs><rect width="${w}" height="${h}" fill="url(#g)"/><text x="50%" y="50%" dominant-baseline="middle" text-anchor="middle" font-family="system-ui,sans-serif" font-size="${fs}" fill="#fff" opacity="0.7">${label}</text></svg>`;
+  return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
+}
+function placeholderMedia(html) {
+  return html.replace(/<img\b[^>]*>/g, (tag) => {
+    const src = tag.match(/\bsrc="([^"]*)"/)?.[1] ?? "";
+    if (!/^\/(media|stock)\//.test(src)) return tag;
+    const w = Number(tag.match(/\bwidth="(\d+)"/)?.[1] ?? 1200);
+    const h = Number(tag.match(/\bheight="(\d+)"/)?.[1] ?? 900);
+    const isLogo = /logo/i.test(src) || w <= 240 && h <= 80;
+    const isAvatar = /avatar|review|portrait-sm/i.test(src) || w === h && w <= 160;
+    const label = isLogo ? "logo" : isAvatar ? "" : `${w}\xD7${h}`;
+    const fill = isLogo ? placeholderLogo(w, h) : placeholder(w, h, label);
+    return tag.replace(/\bsrc="[^"]*"/, `src="${fill}"`);
+  });
+}
+function placeholderLogo(w, h) {
+  const svg = `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}"><rect x="2" y="${h / 4}" width="${h / 2}" height="${h / 2}" rx="4" fill="#555"/><rect x="${h / 2 + 10}" y="${h / 2 - 5}" width="${w - h / 2 - 14}" height="10" rx="5" fill="#555"/></svg>`;
+  return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
+}
+function readmeExample(readme) {
+  const m = readme.match(/## Example\s*```html\s*([\s\S]*?)```/);
+  return m ? m[1].trim() : null;
+}
+function readmeVariants(readme) {
+  const line = readme.match(/\*\*Variants:\*\*\s*(.+)/)?.[1]?.trim() ?? "";
+  if (!line || line.startsWith("(none)")) return [];
+  return line.split(",").map((v) => v.trim()).filter(Boolean);
+}
+function readmeLook(readme) {
+  return readme.split("\n").map((l) => l.trim()).find((l) => l && !l.startsWith("#") && !l.startsWith("-") && !l.startsWith("```")) ?? "";
+}
+function withVariant(example, name, variant) {
+  return example.replace(new RegExp(`^<${name}(\\s|>)`), `<${name} variant="${variant}"$1`);
+}
+var sharedCss = [themeCss(defaultTheme), baseCss, primitivesCss].join("\n");
+var indexByCat = /* @__PURE__ */ new Map();
+var total = 0;
+var written = /* @__PURE__ */ new Set();
+mkdirSync(outRoot, { recursive: true });
+var cats = readdirSync(blocksRoot, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name).sort();
+for (const cat of cats) {
+  const names = readdirSync(join(blocksRoot, cat), { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name).sort();
+  for (const name of names) {
+    const dir = join(blocksRoot, cat, name);
+    if (!existsSync(join(dir, "template.html"))) continue;
+    if (!library.has(`${cat}/${name}`)) continue;
+    const catalog = {
+      [name]: {
+        html: readFileSync(join(dir, "template.html"), "utf8"),
+        css: readFileSync(join(dir, "styles.css"), "utf8"),
+        island: existsSync(join(dir, "island.js")) ? readFileSync(join(dir, "island.js"), "utf8") : null
+      }
+    };
+    const readme = existsSync(join(dir, "README.md")) ? readFileSync(join(dir, "README.md"), "utf8") : "";
+    const example = readmeExample(readme) ?? `<${name}><h2 slot="heading">${name}</h2><p>No example in README yet.</p></${name}>`;
+    const variants = readmeVariants(readme);
+    const look = readmeLook(readme);
+    const id = `${cat}/${name}`;
+    const record = library.get(id);
+    const renders = [{ file: `${name}.html`, label: name, body: example }];
+    for (const v of variants) renders.push({ file: `${name}--${v}.html`, label: `${name} \xB7 ${v}`, body: withVariant(example, name, v) });
+    const destDir = join(outRoot, cat);
+    mkdirSync(destDir, { recursive: true });
+    let baseHtml = "";
+    for (const r of renders) {
+      const flat = flattenBody(placeholderMedia(r.body), catalog, { name: "Blocks Preview", motion: { strength: "off" } });
+      const page = {
+        path: `/${cat}/${r.file}`,
+        title: r.label,
+        bodyHtml: flat.html,
+        used: [name],
+        usesMotion: false,
+        usesLeadForm: /data-lead-form/.test(flat.html)
+      };
+      const js = siteIslands([page], catalog);
+      const html = `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${cat}/${r.label}</title>
+  <style>${sharedCss}
+${catalog[name].css}</style>
+  <style>.bp-bar{position:fixed;inset-inline:0;bottom:0;z-index:999;display:flex;gap:1rem;align-items:center;padding:.4rem .9rem;font:12px/1.4 system-ui,sans-serif;color:#eee;background:#1d1a17;opacity:.9}.bp-bar a{color:#fff}.bp-bar span{color:#bbb}</style>
+</head>
+<body>
+  ${flat.html}
+  <div class="bp-bar"><a href="../index.html">\u2190 All blocks</a><strong>${cat}/${r.label}</strong><span>${look}</span></div>
+  ${js.trim() ? `<script type="module">${js}</script>` : ""}
+</body>
+</html>`;
+      const output = join(destDir, r.file);
+      writeFileSync(output, html);
+      if (r.file === `${name}.html`) baseHtml = html;
+      written.add(output);
+    }
+    if (!indexByCat.has(cat)) indexByCat.set(cat, []);
+    const variantLinks = variants.map((v) => `<a href="${cat}/${name}--${v}.html" class="badge badge--outline">${v}</a>`).join(" ");
+    const image = imageStatus(id, dir, baseHtml);
+    const roles = record?.meta?.fit.pageRoles.join("|") || cat;
+    const jobs = record?.meta?.fit.visitorJobs.join("|") || look;
+    const geometry = record?.geometry.join("|") || "";
+    const mediaFit = record?.meta ? record.meta.media.min > 0 ? "required" : "optional" : record?.mediaRequired ? "required" : "optional";
+    indexByCat.get(cat).push(
+      `<li class="bp-item" data-role="${esc(roles)}" data-job="${esc(jobs)}" data-geometry="${esc(geometry)}" data-media="${mediaFit}"><div><a class="bp-item__name" href="${cat}/${name}.html">${esc(name)}</a><label class="bp-compare-label"><input type="checkbox" class="bp-compare" value="${cat}/${name}.html"> compare</label></div><span class="bp-item__look">${esc(look)}<small>Image evidence: ${image.status}; metadata: ${record?.metadataSource || "legacy-readme"}</small></span>${variantLinks ? `<span class="bp-item__variants">${variantLinks}</span>` : ""}</li>`
+    );
+    total++;
+  }
+}
+for (const cat of readdirSync(outRoot, { withFileTypes: true }).filter((d) => d.isDirectory())) {
+  const dir = join(outRoot, cat.name);
+  for (const name of readdirSync(dir)) {
+    const file = join(dir, name);
+    if (name.endsWith(".html") && !written.has(file) && statSync(file).isFile()) unlinkSync(file);
+  }
+}
+var groups = [...indexByCat.entries()].map(
+  ([cat, items]) => `<section class="bp-group" id="${cat}"><h2>${cat} <span class="bp-count">${items.length}</span></h2><ul class="bp-list">${items.join("\n")}</ul></section>`
+).join("\n");
+var toc = [...indexByCat.keys()].map((cat) => `<a class="badge" href="#${cat}">${cat}</a>`).join(" ");
+var geometryOptions = [...new Set([...library.values()].flatMap((b) => b.geometry))].sort().map((value) => `<option value="${esc(value)}">${esc(value)}</option>`).join("");
+var roleOptions = [...new Set([...library.values()].flatMap((b) => b.meta?.fit.pageRoles || [b.category]))].sort().map((value) => `<option value="${esc(value)}">${esc(value)}</option>`).join("");
+writeFileSync(
+  join(outRoot, "index.html"),
+  `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>Vitris blocks</title>
+  <style>${sharedCss}
+  .bp-head{padding-block:var(--space-8) var(--space-6);display:grid;gap:var(--space-4)}
+  .bp-toc{display:flex;flex-wrap:wrap;gap:var(--space-2)}
+  .bp-toc .badge{text-decoration:none}
+  .bp-group{padding-block:var(--space-6);border-top:1px solid var(--color-border)}
+  .bp-group h2{font-size:var(--step-2);margin-bottom:var(--space-4);display:flex;gap:.5rem;align-items:baseline}
+  .bp-count{font-family:var(--font-body);font-size:var(--step-0);color:var(--color-muted);font-weight:500}
+  .bp-list{list-style:none;margin:0;padding:0;display:grid;gap:var(--space-2)}
+  .bp-item{display:grid;grid-template-columns:14rem 1fr auto;gap:var(--space-4);align-items:center;padding:var(--space-2) 0;border-bottom:1px dashed var(--color-border)}
+  .bp-item__name{font-weight:600}
+  .bp-item__look{color:var(--color-muted);font-size:var(--step-0)}
+  .bp-item__variants{display:flex;gap:var(--space-1)}
+  .bp-item__variants .badge{text-decoration:none;min-height:1.5rem;padding:0 .5rem;font-size:.75rem}
+  .bp-item__look small{display:block;color:var(--color-muted);font-size:.75rem}
+  .bp-compare-label{display:block;font:12px system-ui;color:var(--color-muted);margin-top:.3rem}
+  .bp-filters{display:flex;flex-wrap:wrap;gap:var(--space-2);align-items:end}
+  .bp-filters label{display:grid;gap:.2rem;font:12px system-ui}
+  .bp-filters input,.bp-filters select{min-height:2.5rem;padding:.3rem .5rem}
+  .bp-compare-view{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:var(--space-3);margin-top:var(--space-4)}
+  .bp-compare-view iframe{width:100%;height:650px;border:1px solid var(--color-border)}
+  [hidden]{display:none!important}
+  @media(max-width:719px){.bp-item{grid-template-columns:1fr}}
+  </style></head>
+  <body><main class="wrap"><header class="bp-head"><p class="eyebrow">Kernel block library</p><h1>Vitris blocks</h1><p class="lede">${total} blocks across ${indexByCat.size} categories, rendered from each block's README example with the default theme and placeholder media. Variant chips render the same example with <code>variant="\u2026"</code>. Image evidence is marked unavailable or stale when no verified capture exists.</p><div class="bp-filters"><label>Find by job or name<input id="bp-search" type="search" placeholder="e.g. hours, credentials"></label><label>Page role<select id="bp-role"><option value="">Any role</option>${roleOptions}</select></label><label>Media<select id="bp-media"><option value="">Any</option><option value="optional">Works without essential media</option><option value="required">Requires media</option></select></label><label>Geometry<select id="bp-geometry"><option value="">Any</option>${geometryOptions}</select></label></div><div class="bp-toc">${toc}</div><div class="bp-compare-view" id="bp-compare-view" hidden></div></header>${groups}</main><script>
+  const items=[...document.querySelectorAll('.bp-item')];
+  const fields=['search','role','media','geometry'].map(id=>document.getElementById('bp-'+id));
+  function filter(){const [search,role,media,geometry]=fields.map(x=>x.value.toLowerCase().trim());for(const item of items){const text=item.textContent.toLowerCase()+' '+item.dataset.job.toLowerCase();item.hidden=!!(search&&!text.includes(search)||role&&!item.dataset.role.toLowerCase().split('|').includes(role)||media&&item.dataset.media!==media||geometry&&!item.dataset.geometry.toLowerCase().split('|').includes(geometry));}for(const group of document.querySelectorAll('.bp-group'))group.hidden=![...group.querySelectorAll('.bp-item')].some(x=>!x.hidden);}
+  fields.forEach(x=>x.addEventListener('input',filter));
+  document.querySelectorAll('.bp-compare').forEach(box=>box.addEventListener('change',()=>{const selected=[...document.querySelectorAll('.bp-compare:checked')];if(selected.length>2){selected[0].checked=false;selected.shift();}const view=document.getElementById('bp-compare-view');view.hidden=!selected.length;view.innerHTML='';for(const item of selected){const frame=document.createElement('iframe');frame.title='Comparison: '+item.value;frame.src=item.value;view.append(frame);}}));
+  </script></body></html>`
+);
+console.log(`Wrote ${total} block previews to ${outRoot}`);
+if (argv.includes("--serve")) {
+  const portIdx = argv.indexOf("--port");
+  const port = portIdx >= 0 ? Number(argv[portIdx + 1]) || 4173 : 4173;
+  const types = { ".html": "text/html; charset=utf-8", ".css": "text/css", ".js": "text/javascript", ".svg": "image/svg+xml" };
+  const server = createServer((req, res) => {
+    const urlPath = decodeURIComponent((req.url ?? "/").split("?")[0]);
+    let rel = normalize(urlPath).replace(/^(\.\.[/\\])+/, "");
+    if (rel.endsWith("/") || rel === "\\" || rel === "") rel = join(rel, "index.html");
+    const file = join(outRoot, rel);
+    if (!file.startsWith(outRoot) || !existsSync(file) || !statSync(file).isFile()) {
+      res.writeHead(404, { "content-type": "text/plain" }).end("Not found");
+      return;
+    }
+    res.writeHead(200, { "content-type": types[extname(file)] ?? "application/octet-stream" });
+    res.end(readFileSync(file));
+  });
+  server.listen(port, "127.0.0.1", () => {
+    console.log(`Serving block previews at http://127.0.0.1:${port}/ (Ctrl+C to stop)`);
+  });
+}

package/bin/vitris-build.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import {
+  buildVerified
+} from "./chunks/chunk-E5Y46VBX.js";
+import "./chunks/chunk-4GZCAWWK.js";
+import "./chunks/chunk-ANMJRJQ5.js";
+import "./chunks/chunk-HNORQ74T.js";
+import "./chunks/chunk-YCVGD2CG.js";
+import "./chunks/chunk-LKN75JGA.js";
+import "./chunks/chunk-YYPYYOEV.js";
+import "./chunks/chunk-GZDLXYZV.js";
+import "./chunks/chunk-T6PE4KN4.js";
+import "./chunks/chunk-7FS67SRF.js";
+
+// src/build/cli.ts
+import { join, resolve } from "node:path";
+var arg = (flag) => {
+  const i = process.argv.indexOf(flag);
+  return i < 0 ? void 0 : process.argv[i + 1];
+};
+var root = resolve(arg("--site") || ".");
+var out = resolve(arg("--out") || join(root, "dist"));
+await buildVerified(root, out, arg("--backend-origin") || arg("--kernel-origin"), arg("--slug"));
+console.log(`Built and verified local assets in ${out}`);

package/bin/vitris-catalog.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+// scripts/catalog.ts
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { stripTypeScriptTypes } from "node:module";
+if (process.argv.includes("--help")) {
+  console.log("Usage: vitris-catalog");
+  process.exit(0);
+}
+var root = join(dirname(fileURLToPath(import.meta.url)), "..");
+var outFile = join(root, "src", "gen", "catalog.ts");
+await mkdir(dirname(outFile), { recursive: true });
+await writeFile(
+  outFile,
+  [
+    'import type { Catalog } from "../types.ts";',
+    "",
+    "/** Empty kernel catalog. Tenant sites supply components/ at build time. */",
+    "export const catalog: Catalog = {};",
+    ""
+  ].join("\n"),
+  "utf8"
+);
+console.log("Wrote empty src/gen/catalog.ts");
+var stockDir = join(root, "src", "stock");
+var { readFile } = await import("node:fs/promises");
+function jsString(value) {
+  return JSON.stringify(value);
+}
+var searchJs = stripTypeScriptTypes(await readFile(join(stockDir, "search.ts"), "utf8")).replace(/export\s+/g, "");
+var pickerJs = `(() => { ${searchJs}
+window.VitrisStockSearch = searchStock; })();
+` + await readFile(join(stockDir, "picker.js"), "utf8");
+var pickerCss = await readFile(join(stockDir, "picker.css"), "utf8");
+var catalogRaw = await readFile(join(stockDir, "catalog.json"), "utf8");
+JSON.parse(catalogRaw);
+await writeFile(
+  join(root, "src", "gen", "stock.ts"),
+  [
+    `export const stockPickerJs = ${jsString(pickerJs)};`,
+    `export const stockPickerCss = ${jsString(pickerCss)};`,
+    `export const stockCatalogJson = ${jsString(catalogRaw.trim())};`,
+    ""
+  ].join("\n"),
+  "utf8"
+);
+console.log("Wrote src/gen/stock.ts");

package/bin/vitris-content-coverage.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import {
+  coverageAudit
+} from "./chunks/chunk-M2ETYSVJ.js";
+import {
+  save
+} from "./chunks/chunk-T6PE4KN4.js";
+
+// scripts/content-coverage.ts
+import { resolve, join } from "node:path";
+if (process.argv.includes("--help")) {
+  console.log("vitris-content-coverage --site SITE; compute current source-to-rendered coverage evidence during content-review");
+  process.exit(0);
+}
+var at = process.argv.indexOf("--site");
+if (at < 0 || !process.argv[at + 1]) throw new Error("Pass --site SITE");
+var root = resolve(process.argv[at + 1]);
+var audit = coverageAudit(root);
+save(join(root, "agent/reviews/content-coverage.json"), audit);
+console.log(JSON.stringify(audit, null, 2));
+if (!audit.passed) process.exitCode = 1;

package/bin/vitris-create-site.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import {
+  createSite
+} from "./chunks/chunk-4DM5TTLG.js";
+import "./chunks/chunk-34H54KEY.js";
+import "./chunks/chunk-JCRGE6AL.js";
+import {
+  promptSourceUrl
+} from "./chunks/chunk-Z2UNY47A.js";
+import "./chunks/chunk-XGTHGWPW.js";
+import {
+  siteInputsFromArgv
+} from "./chunks/chunk-3CTBXY5K.js";
+import "./chunks/chunk-DSS2U2OM.js";
+import "./chunks/chunk-M4LNHYYR.js";
+import "./chunks/chunk-DRJQ4OOU.js";
+import "./chunks/chunk-PRLL7B63.js";
+import "./chunks/chunk-5OOPJNGN.js";
+import "./chunks/chunk-BBV7PMFC.js";
+import "./chunks/chunk-TY33XMHW.js";
+import "./chunks/chunk-R7YELY3C.js";
+import "./chunks/chunk-BIEDSEL2.js";
+import "./chunks/chunk-T7DGRVTP.js";
+import "./chunks/chunk-AUO5I56E.js";
+import "./chunks/chunk-6H3T46F5.js";
+import "./chunks/chunk-M2ETYSVJ.js";
+import "./chunks/chunk-FOXUQXTV.js";
+import "./chunks/chunk-IKNMBGGD.js";
+import "./chunks/chunk-WEFDVXFX.js";
+import "./chunks/chunk-E5Y46VBX.js";
+import "./chunks/chunk-4GZCAWWK.js";
+import "./chunks/chunk-ANMJRJQ5.js";
+import "./chunks/chunk-HNORQ74T.js";
+import "./chunks/chunk-YCVGD2CG.js";
+import "./chunks/chunk-LKN75JGA.js";
+import "./chunks/chunk-YYPYYOEV.js";
+import "./chunks/chunk-GZDLXYZV.js";
+import "./chunks/chunk-G7MNMULR.js";
+import "./chunks/chunk-T6PE4KN4.js";
+import "./chunks/chunk-7FS67SRF.js";
+
+// scripts/create-site.ts
+var arg = (flag) => {
+  const i = process.argv.indexOf(flag);
+  return i < 0 ? void 0 : process.argv[i + 1];
+};
+var usage = `Usage: vitris-create-site --dir ../acme --slug acme [--name "Acme Shop"] [--from URL | --blank]
+  --owner EMAIL         Owner login email
+  --template ID         Catalog ID, name, or hosted template URL; continue automatically
+  --template-release R  Optional catalog revision
+  --content TEXT        Additional business content or instructions
+  --content-file FILE   UTF-8 content file (instead of --content)
+  --mode MODE           redesign (default) or preserve (legacy Vitris duplicate)
+  --backend-origin URL  Backend origin (default http://127.0.0.1:8787)
+  --harness SPEC        Dependency version, tarball, or file: path (default: this package version)
+  --no-prompt           Do not ask for a source URL
+Legacy --kernel and --kernel-origin flags remain accepted.`;
+async function main() {
+  if (process.argv.includes("--help")) {
+    console.log(usage);
+    return;
+  }
+  if (!arg("--dir") || !arg("--slug")) throw new Error(usage);
+  const blank = process.argv.includes("--blank");
+  if (blank && arg("--from")) throw new Error("Use either --from or --blank, not both.");
+  const from = await promptSourceUrl({ noPrompt: process.argv.includes("--no-prompt"), from: arg("--from"), blank });
+  const result = await createSite({
+    dir: arg("--dir"),
+    slug: arg("--slug"),
+    name: arg("--name"),
+    from: from || void 0,
+    blank,
+    ...siteInputsFromArgv(process.argv),
+    mode: arg("--mode"),
+    owner: arg("--owner"),
+    backendOrigin: arg("--backend-origin") || arg("--kernel-origin"),
+    harnessSpec: arg("--harness") || arg("--kernel")
+  });
+  if (!result.ok) throw new Error(result.error);
+  console.log(`${result.summary}
+Open that site directory in your coding agent, run npm install and npx playwright install chromium, then npm run go. The workflow stops at a local preview; launch is separate.`);
+}
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});