lavish-axi 0.1.75 → 0.1.77

package/README.md

@@ -181,6 +181,10 @@ pnpm link
   `Resolved` requires a newer successful artifact load plus a complete check at the same viewport that no longer detects it; it then leaves the count but keeps a bounded history.
   `Still present` (recurring) means a queued issue survived a newer revision, so it is selectable again with its earlier attempt retained. `Unverified` means a reload or check failed or was incomplete, so the prior issue was preserved rather than cleared. `Returned` means a resolved issue came back on a later revision.
   Dismissal applies only to the current artifact revision; a later revision surfaces the issue again if it is still detected. A check at one viewport never clears an issue found at another, and a viewport removed from the configured diagnostic set (`LAVISH_AXI_DIAGNOSTIC_VIEWPORTS`, default all) is marked obsolete with an explicit reason rather than reading as fixed.
+- **Revisions legend** - Opt-in. After a round of feedback the agent regenerates the whole file, and a one-sentence edit is invisible on a long artifact. The agent can declare what it changed in the artifact itself: one `<script type="application/json" data-lavish-revisions>` array of `{ id, label, timestamp, summary }` entries, plus `data-lavish-revision="<id>"` on each block it edited or added. Run `lavish-axi design` for the snippet.
+  A **Revisions** button then appears in the top bar with a legend listing each round - colour swatch, label, time, and the agent's summary - and **Reveal** steps through that round's changed blocks, flashing them one at a time.
+  Each revision's swatch carries a distinct border style and fill pattern as well as a colour, so the rounds stay distinguishable without colour. Artifacts with no registry show no button and are otherwise unaffected, a malformed registry is ignored rather than surfaced as an error, and at most 6 revisions are listed - one per distinguishable swatch.
+  Lavish never marks up the artifact for this: the legend lives in the browser chrome, so the served page stays identical to the saved file, and the registry and marks travel with the file through export.
 - **Local assets** - Copy local images, CSS, fonts, and scripts next to the HTML artifact and reference them with relative paths from that directory; root-prefixed paths such as `/assets/logo.png` will not resolve through Lavish's artifact route.
 - **Export and sharing** - `lavish-axi export` writes `<name>.export.html` by inlining local assets only, stripping the annotation SDK, and leaving remote CDN/font references as links that still need network access.
   `lavish-axi share` publishes the same local-inlined HTML to [ht-ml.app](https://ht-ml.app), a third-party hosting service not part of Lavish.

package/dist/chrome-client.js

@@ -178,6 +178,12 @@ const warningsSelectAll = /** @type {HTMLInputElement} */ (document.getElementBy
 const warningsSelected = /** @type {HTMLSpanElement} */ (document.getElementById("warningsSelected"));
 const warningsList = /** @type {HTMLDivElement} */ (document.getElementById("warningsList"));
 const warningsQueueButton = /** @type {HTMLButtonElement} */ (document.getElementById("warningsQueueButton"));
+const revisionsWrap = /** @type {HTMLDivElement} */ (document.getElementById("revisionsWrap"));
+const revisionsButton = /** @type {HTMLButtonElement} */ (document.getElementById("revisionsButton"));
+const revisionsCount = /** @type {HTMLSpanElement} */ (document.getElementById("revisionsCount"));
+const revisionsDrawer = /** @type {HTMLDivElement} */ (document.getElementById("revisionsDrawer"));
+const revisionsSummary = /** @type {HTMLParagraphElement} */ (document.getElementById("revisionsSummary"));
+const revisionsList = /** @type {HTMLDivElement} */ (document.getElementById("revisionsList"));
 const sendHint = /** @type {HTMLDivElement} */ (document.getElementById("sendHint"));
 const whiteboardOverlay = /** @type {HTMLDivElement} */ (document.getElementById("whiteboardOverlay"));
 const whiteboardFrame = /** @type {HTMLIFrameElement} */ (document.getElementById("whiteboardFrame"));
@@ -2431,6 +2437,265 @@ function revealWarning(warning) {
   postToFrame({ type: "lavish:revealElement", selector: warning.selector });
 }
 
+// ---------------------------------------------------------------------------
+// Revision legend
+//
+// The agent declares what it changed in the artifact HTML itself (a
+// `data-lavish-revisions` registry plus `data-lavish-revision` marks); the SDK
+// reads it and posts it here. The legend lives entirely in the chrome, so the
+// served artifact still matches the file on disk - Lavish never paints the
+// change indicator into the page. Reveal borrows the same transient marker the
+// layout-issues drawer uses, and only when the reader asks for it.
+
+// The payload crosses postMessage from a sandboxed frame rendering author
+// content, so it is untrusted here whatever built it. These bound what is
+// examined, not what is accepted: capping accepted rows alone would let a
+// registry of ten thousand records walk the whole array on the chrome's main
+// thread before yielding its handful of rows.
+// Server-owned, injected into the session JSON from src/artifact-revisions.js.
+// The swatch is presentation the chrome owes the reader, not something the
+// artifact gets a say in, so nothing about it is read from the message.
+const REVISION_PALETTE = (Array.isArray(sessionData.revisionPalette) ? sessionData.revisionPalette : []).filter(
+  (entry) => entry && /^#[0-9a-fA-F]{6}$/.test(String(entry.hex)),
+);
+const REVISION_LIMITS = {
+  // Derived from the server-injected palette (src/artifact-revisions.js) rather than a
+  // second hardcoded number, so the two can never drift; falls back to 6 only if the
+  // palette itself came through empty.
+  entries: REVISION_PALETTE.length > 0 ? REVISION_PALETTE.length : 6,
+  rawEntries: 256,
+  marks: 200,
+  rawMarks: 2000,
+  id: 60,
+  label: 80,
+  summary: 400,
+  timestamp: 40,
+  excerpt: 120,
+  selector: 400,
+};
+const REVISION_BORDER_STYLES = ["solid", "dashed", "dotted", "double"];
+
+/** @type {any[]} */
+let revisionEntries = [];
+/** @type {any[]} */
+let revisionMarks = [];
+/** @type {Map<string, number>} */
+const revisionRevealCursor = new Map();
+let revisionsDrawerOpen = false;
+
+// Display-only fields. Anything the legend merely shows can be shortened.
+function revisionText(value, max) {
+  if (typeof value !== "string" && typeof value !== "number") return "";
+  const text = String(value).trim();
+  return text.length > max ? text.slice(0, max) : text;
+}
+
+// Identity fields, mirroring `exactRevisionText` in src/artifact-revisions.js.
+// The message is untrusted here, so shortening an id or a selector is worse
+// than dropping it: two distinct overlong ids collapse into one legend row, and
+// the first 400 characters of a long selector are a different valid selector
+// that Reveal would resolve to some other block.
+function revisionExact(value, max) {
+  if (typeof value !== "string" && typeof value !== "number") return "";
+  const text = String(value).trim();
+  return text.length > 0 && text.length <= max ? text : "";
+}
+
+function revisionPatternFill(pattern) {
+  if (pattern === "diagonal") return "repeating-linear-gradient(45deg, currentColor 0 2px, transparent 2px 5px)";
+  if (pattern === "dots") return "radial-gradient(currentColor 1px, transparent 1px)";
+  return "";
+}
+
+// The swatch for a revision's position in the registry. Position is the only
+// thing the artifact influences, and it cannot repeat one: ids are deduplicated
+// before this runs, so each accepted revision gets a distinct index and
+// therefore a distinct swatch.
+function revisionPresentation(index) {
+  const entry = REVISION_PALETTE.length > 0 ? REVISION_PALETTE[index % REVISION_PALETTE.length] : null;
+  return {
+    color: entry ? String(entry.hex) : "#0072b2",
+    borderStyle: REVISION_BORDER_STYLES.includes(String(entry && entry.borderStyle))
+      ? String(entry.borderStyle)
+      : "solid",
+    pattern: revisionPatternFill(entry && entry.pattern),
+  };
+}
+
+// Only text crosses from the artifact into the legend, and it crosses as
+// textContent. Nothing the message carries reaches a style property.
+function normalizeRevisionMessage(msg) {
+  const rawRevisions = Array.isArray(msg && msg.revisions) ? msg.revisions : [];
+  const revisions = [];
+  const byId = new Map();
+  let examined = 0;
+  for (const raw of rawRevisions) {
+    if (examined >= REVISION_LIMITS.rawEntries || revisions.length >= REVISION_LIMITS.entries) break;
+    examined += 1;
+    if (!raw || typeof raw !== "object") continue;
+    const id = revisionExact(raw.id, REVISION_LIMITS.id);
+    if (!id || /\s/.test(id) || byId.has(id)) continue;
+    const entry = {
+      id,
+      label: revisionText(raw.label, REVISION_LIMITS.label) || id,
+      timestamp: revisionText(raw.timestamp, REVISION_LIMITS.timestamp),
+      summary: revisionText(raw.summary, REVISION_LIMITS.summary),
+      ...revisionPresentation(revisions.length),
+      marks: [],
+    };
+    byId.set(id, entry);
+    revisions.push(entry);
+  }
+
+  const rawMarks = Array.isArray(msg && msg.marks) ? msg.marks : [];
+  const marks = [];
+  examined = 0;
+  for (const raw of rawMarks) {
+    if (examined >= REVISION_LIMITS.rawMarks || marks.length >= REVISION_LIMITS.marks) break;
+    examined += 1;
+    if (!raw || typeof raw !== "object") continue;
+    const revisionId = revisionExact(raw.revision_id, REVISION_LIMITS.id);
+    const selector = revisionExact(raw.selector, REVISION_LIMITS.selector);
+    const owner = byId.get(revisionId);
+    if (!owner || !selector) continue;
+    const mark = {
+      revisionId,
+      selector,
+      tag: revisionText(raw.tag, 40).toLowerCase(),
+      excerpt: revisionText(raw.excerpt, REVISION_LIMITS.excerpt),
+    };
+    owner.marks.push(mark);
+    marks.push(mark);
+  }
+
+  return { revisions, marks };
+}
+
+function resetRevisionLegend() {
+  revisionEntries = [];
+  revisionMarks = [];
+  revisionRevealCursor.clear();
+  renderRevisionLegend();
+}
+
+function applyRevisionMessage(msg) {
+  const normalized = normalizeRevisionMessage(msg);
+  revisionEntries = normalized.revisions;
+  revisionMarks = normalized.marks;
+  for (const id of [...revisionRevealCursor.keys()]) {
+    if (!revisionEntries.some((entry) => entry.id === id)) revisionRevealCursor.delete(id);
+  }
+  renderRevisionLegend();
+}
+
+function revisionMarkSummary(entry) {
+  if (entry.marks.length === 0) return "no marked blocks";
+  return entry.marks.length === 1 ? "1 marked block" : entry.marks.length + " marked blocks";
+}
+
+function buildRevisionRow(entry) {
+  const row = document.createElement("div");
+  row.className = "revision-row";
+
+  const swatch = document.createElement("span");
+  swatch.className = "revision-swatch";
+  swatch.setAttribute("aria-hidden", "true");
+  swatch.style.color = entry.color;
+  swatch.style.borderColor = entry.color;
+  swatch.style.borderStyle = entry.borderStyle;
+  if (entry.pattern) swatch.style.backgroundImage = entry.pattern;
+  row.appendChild(swatch);
+
+  const body = document.createElement("div");
+  body.className = "revision-body";
+
+  const head = document.createElement("div");
+  head.className = "revision-head";
+  const label = document.createElement("span");
+  label.className = "revision-label";
+  label.textContent = entry.label;
+  head.appendChild(label);
+  if (entry.timestamp) {
+    const time = document.createElement("span");
+    time.className = "revision-time";
+    time.textContent = entry.timestamp;
+    head.appendChild(time);
+  }
+  body.appendChild(head);
+
+  if (entry.summary) {
+    const summary = document.createElement("p");
+    summary.className = "revision-summary";
+    summary.textContent = entry.summary;
+    body.appendChild(summary);
+  }
+
+  const foot = document.createElement("div");
+  foot.className = "revision-foot";
+  const count = document.createElement("span");
+  count.className = "revision-marks";
+  count.textContent = revisionMarkSummary(entry);
+  foot.appendChild(count);
+  if (entry.marks.length > 0) {
+    const reveal = document.createElement("button");
+    reveal.type = "button";
+    reveal.className = "revision-reveal";
+    const position = (revisionRevealCursor.get(entry.id) || 0) % entry.marks.length;
+    reveal.textContent = entry.marks.length === 1 ? "Reveal" : "Reveal " + (position + 1) + "/" + entry.marks.length;
+    reveal.setAttribute("aria-label", "Reveal the next block changed in " + entry.label);
+    // Bound per row rather than delegated from the list: the rows are rebuilt
+    // on every render anyway, so there is no listener to accumulate, and the
+    // button carries the revision it belongs to without a data attribute round
+    // trip through the DOM.
+    reveal.onclick = () => revealNextRevisionMark(entry.id);
+    foot.appendChild(reveal);
+  }
+  body.appendChild(foot);
+
+  row.appendChild(body);
+  return row;
+}
+
+function renderRevisionLegend() {
+  if (!revisionsWrap) return;
+  const count = revisionEntries.length;
+  revisionsWrap.hidden = count === 0 || ended;
+  if (revisionsWrap.hidden && revisionsDrawerOpen) setRevisionsDrawerOpen(false);
+  revisionsCount.textContent = String(count);
+  revisionsButton.setAttribute("aria-label", count === 1 ? "1 revision" : count + " revisions");
+  revisionsSummary.textContent =
+    (count === 1 ? "1 revision" : count + " revisions") +
+    " · " +
+    (revisionMarks.length === 1 ? "1 marked block" : revisionMarks.length + " marked blocks");
+
+  revisionsList.replaceChildren(...revisionEntries.map(buildRevisionRow));
+}
+
+function setRevisionsDrawerOpen(open) {
+  revisionsDrawerOpen = open && !ended;
+  revisionsDrawer.hidden = !revisionsDrawerOpen;
+  revisionsButton.setAttribute("aria-expanded", String(revisionsDrawerOpen));
+  if (revisionsDrawerOpen) closeMenus();
+}
+
+function closeRevisionsDrawer({ restoreFocus = false } = {}) {
+  if (!revisionsDrawerOpen) return;
+  setRevisionsDrawerOpen(false);
+  if (restoreFocus) revisionsButton.focus();
+}
+
+// Step through a revision's marked blocks one at a time. The existing reveal
+// path flashes one element and clears the previous marker, so a revision that
+// touched several blocks is walked rather than lit up all at once.
+function revealNextRevisionMark(id) {
+  const entry = revisionEntries.find((candidate) => candidate.id === id);
+  if (!entry || entry.marks.length === 0) return;
+  const position = (revisionRevealCursor.get(id) || 0) % entry.marks.length;
+  postToFrame({ type: "lavish:revealElement", selector: entry.marks[position].selector });
+  revisionRevealCursor.set(id, (position + 1) % entry.marks.length);
+  renderRevisionLegend();
+}
+
 async function dismissWarning(id) {
   try {
     const response = await fetch("/api/" + key + "/layout-warnings/dismiss", {
@@ -2530,6 +2795,8 @@ function markSessionEnded() {
   closeShareDialog();
   closeWarningsDrawer();
   renderWarnings();
+  closeRevisionsDrawer();
+  renderRevisionLegend();
   closeWhiteboard();
   annotationSwitch.disabled = true;
   moreButton.disabled = true;
@@ -2837,6 +3104,11 @@ async function replaceArtifactFrame({ recoveryRetry = false } = {}) {
   clearTimeout(artifactSilenceTimer);
   // The iframe is sandboxed, so reload by resetting the iframe URL from chrome.
   if (!artifactSrc) {
+    // The next document reports its own registry once it loads; until then the
+    // previous revision's legend would point at blocks that may no longer exist.
+    // Only clear it here, right before the frame is actually replaced - a preserved
+    // load (superseded/out-of-order/exhausted retries below) must leave it intact.
+    resetRevisionLegend();
     startLayoutGateCycle();
     const currentSrc = frame.src || "about:blank";
     frame.src = currentSrc + (currentSrc.includes("?") ? "&" : "?") + "lavish_reload=" + Date.now();
@@ -2953,6 +3225,9 @@ async function replaceArtifactFrame({ recoveryRetry = false } = {}) {
   inlineWhiteboardChannels.clear();
   setHandoffSuperseded(false);
   startLayoutGateCycle();
+  // The next document reports its own registry once it loads; until then the
+  // previous revision's legend would point at blocks that may no longer exist.
+  resetRevisionLegend();
   frame.src = artifactFrameSrcForLoad({ revision, token });
   return true;
 }
@@ -3688,6 +3963,7 @@ window.addEventListener("message", (event) => {
   // chrome cannot see every live reference, so reclamation is the sweeper's job.
   if (msg.type === "lavish:sendQueuedPrompts") sendQueued();
   if (msg.type === "lavish:endSession") endSession();
+  if (msg.type === "lavish:revisions") applyRevisionMessage(msg);
   if (msg.type === "lavish:toggleAnnotationMode") toggleAnnotationMode();
 });
 
@@ -3831,9 +4107,14 @@ sendButton.onclick = () => sendQueued(false);
 sendAndEndButton.onclick = () => sendQueued(true);
 moreButton.onclick = () => {
   closeWarningsDrawer();
+  closeRevisionsDrawer();
   toggleMenu(moreButton, moreMenu);
 };
 warningsButton.onclick = toggleWarningsDrawer;
+revisionsButton.onclick = () => {
+  closeWarningsDrawer();
+  setRevisionsDrawerOpen(revisionsDrawer.hidden);
+};
 warningsSelectAll.onchange = toggleSelectAllWarnings;
 warningsQueueButton.onclick = queueSelectedWarningFixes;
 chatAttachButton.onclick = () => chatAttachInput.click();
@@ -3963,6 +4244,7 @@ document.addEventListener("mousedown", (event) => {
   const target = /** @type {Node} */ (event.target);
   if (!moreMenu.hidden && !moreWrap.contains(target)) setMenuOpen(moreButton, moreMenu, false);
   if (warningsDrawerOpen && !warningsWrap.contains(target)) closeWarningsDrawer();
+  if (revisionsDrawerOpen && !revisionsWrap.contains(target)) closeRevisionsDrawer();
 });
 // A non-modal popover closes when focus leaves it, so keyboard users are never stranded inside a
 // panel they cannot see the end of.
@@ -3970,6 +4252,10 @@ warningsWrap.addEventListener("focusout", (event) => {
   const next = /** @type {Node | null} */ (event.relatedTarget);
   if (warningsDrawerOpen && next && !warningsWrap.contains(next)) closeWarningsDrawer();
 });
+revisionsWrap.addEventListener("focusout", (event) => {
+  const next = /** @type {Node | null} */ (event.relatedTarget);
+  if (revisionsDrawerOpen && next && !revisionsWrap.contains(next)) closeRevisionsDrawer();
+});
 whiteboardCloseButton.onclick = closeWhiteboard;
 document.addEventListener("keydown", (event) => {
   if (event.key === "Escape") {
@@ -3977,6 +4263,8 @@ document.addEventListener("keydown", (event) => {
       closeWhiteboard();
     } else if (!shareDialog.hidden) {
       closeShareDialog();
+    } else if (revisionsDrawerOpen) {
+      closeRevisionsDrawer({ restoreFocus: true });
     } else if (warningsDrawerOpen) {
       closeWarningsDrawer({ restoreFocus: true });
     } else if (!moreMenu.hidden) {

package/dist/chrome.css

@@ -635,6 +635,158 @@ body.lavish {
   opacity: 0.8;
   flex-shrink: 0;
 }
+.revisions-wrap {
+  position: relative;
+  display: flex;
+  align-items: center;
+}
+.revisions-wrap[hidden] {
+  display: none;
+}
+
+.revisions-button {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  height: 34px;
+  padding: 0 10px;
+  border-radius: var(--radius-md);
+  border: 1px solid var(--border);
+  background: var(--bg-panel);
+  color: var(--fg);
+  font: 600 12px/1 var(--font-sans);
+  cursor: pointer;
+}
+
+.revisions-button:hover {
+  background: var(--bg-elevated);
+}
+
+.revisions-count {
+  min-width: 18px;
+  padding: 0 5px;
+  border-radius: 9px;
+  background: var(--accent);
+  color: var(--brass-ink);
+  font: 700 11px/18px var(--font-sans);
+  text-align: center;
+}
+
+.revisions-drawer {
+  right: 0;
+  top: 42px;
+  width: min(360px, calc(100vw - 24px));
+  padding: 0;
+}
+
+.revisions-head {
+  padding: 12px 14px 8px;
+}
+
+.revisions-title {
+  margin: 0;
+  font-size: 13px;
+  font-weight: 700;
+}
+
+.revisions-summary {
+  margin: 4px 0 0;
+  font-size: 11px;
+  color: var(--fg-faint);
+}
+
+.revisions-list {
+  max-height: 320px;
+  overflow-y: auto;
+  padding: 0 14px;
+}
+
+.revision-row {
+  display: flex;
+  gap: 10px;
+  padding: 10px 0;
+  border-top: 1px solid var(--border);
+}
+
+/* Colour is never the only signal: the swatch also carries the revision's
+   border style and fill pattern, so the legend still separates revisions in
+   greyscale or with a colour vision deficiency. */
+.revision-swatch {
+  flex: 0 0 auto;
+  width: 16px;
+  height: 16px;
+  margin-top: 2px;
+  border-width: 2px;
+  border-radius: 4px;
+}
+
+.revision-body {
+  min-width: 0;
+  flex: 1 1 auto;
+}
+
+.revision-head {
+  display: flex;
+  align-items: baseline;
+  gap: 8px;
+}
+
+.revision-label {
+  font-size: 12px;
+  font-weight: 700;
+}
+
+.revision-time {
+  font-size: 11px;
+  color: var(--fg-faint);
+}
+
+.revision-summary {
+  margin: 4px 0 0;
+  font-size: 11px;
+  line-height: 1.45;
+  color: var(--fg-faint);
+}
+
+.revision-foot {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  margin-top: 6px;
+}
+
+.revision-marks {
+  font-size: 11px;
+  color: var(--fg-faint);
+}
+
+.revision-reveal {
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  background: var(--bg-elevated);
+  color: var(--fg);
+  padding: 4px 8px;
+  font: 700 11px/1 var(--font-sans);
+  cursor: pointer;
+}
+
+.revision-reveal:hover {
+  background: var(--steel-700);
+}
+
+.revisions-foot {
+  padding: 10px 14px 12px;
+  border-top: 1px solid var(--border);
+}
+
+.revisions-note {
+  margin: 0;
+  font-size: 11px;
+  line-height: 1.45;
+  color: var(--fg-faint);
+}
+
 .menu-item.danger {
   color: var(--danger);
 }

package/dist/cli.mjs

@@ -453,6 +453,10 @@ var LAYOUT_SAFETY_CSS_SNIPPET = `<style>
     height: auto;
   }
 </style>`;
+var REVISION_REGISTRY_SNIPPET = `<script type="application/json" data-lavish-revisions>
+[{ "id": "r1", "label": "Round 1", "timestamp": "2026-01-01T10:00:00Z", "summary": "Tightened the pricing copy" }]
+</script>
+<section data-lavish-revision="r1">...the block you changed...</section>`;
 var DESIGN_PRIORITY_RULE = "Decide the design direction in this strict priority order, and only move to the next step when the current one truly yields nothing: (1) if the user asked for a specific look or named design system, use that; (2) otherwise you must first inspect the project the artifact is about - the subject or product whose content or UI it represents, which may differ from your current working directory - and match that project's design system: Tailwind or theme config, shared CSS variables or design tokens, component library, brand assets, or existing styled pages. If the artifact previews, proposes, or mocks a specific app's UI, render it in that app's own design system so it faithfully shows the product, even when you are running in a different repo; (3) only when both steps come up empty, use the Lavish-recommended Tailwind CSS browser runtime v4 + DaisyUI v5, available via CDN, and prefer that CDN snippet over hand-writing styles unless explicitly instructed otherwise by the user.";
 var DESIGN_SYSTEM_HINT = "Lavish does not auto-inject any design system - artifacts stay portable so they render identically when opened directly without lavish-axi running. Before writing any HTML: " + DESIGN_PRIORITY_RULE + " Run `lavish-axi design` for a content-to-playbook router, a copy-pasteable CDN snippet, the whiteboard (Mermaid) opt-in snippet, and the DaisyUI component reference. When you deliver the artifact, state which of the three design sources you used and why.";
 var DAISYUI_THEMES = [
@@ -515,6 +519,11 @@ function createDesignOutput() {
       cdn_urls: { mermaid: MERMAID_CDN_URL },
       versions: { mermaid: MERMAID_VERSION }
     },
+    revision_marking: {
+      use_when: "Opt-in only: on a regeneration that answers the reviewer's feedback, declare what you changed so the browser can show a Revisions legend. Skip it on a first draft, and skip it when you rewrote the whole artifact - a legend that marks everything says nothing.",
+      registry_snippet: REVISION_REGISTRY_SNIPPET,
+      how: 'Append one entry per round to the `data-lavish-revisions` JSON (oldest first, stable `id`s), and put `data-lavish-revision="<id>"` on each block you actually edited or added. Lavish reads them and never restyles the page, so the saved file looks the same opened directly.'
+    },
     theme_usage: [
       'Default to `<html data-theme="luxury">` - it matches the Lavish look. Pick a different theme from the list below only when the user asked for one or the content clearly calls for it.',
       'Set a nested section theme with `<section data-theme="night">`.',
@@ -4703,6 +4712,182 @@ import { fileURLToPath as fileURLToPath3 } from "node:url";
 import chokidar from "chokidar";
 import express from "express";
 
+// src/artifact-revisions.js
+var artifact_revisions_exports = {};
+__export(artifact_revisions_exports, {
+  collectRevisionMarks: () => collectRevisionMarks,
+  exactRevisionText: () => exactRevisionText,
+  isAddressableRevisionId: () => isAddressableRevisionId,
+  isUniqueElementId: () => isUniqueElementId,
+  normalizeRevisionEntry: () => normalizeRevisionEntry,
+  parseRevisionRegistry: () => parseRevisionRegistry,
+  readArtifactRevisions: () => readArtifactRevisions,
+  revisionLimits: () => revisionLimits,
+  revisionPalette: () => revisionPalette,
+  revisionPresentationForIndex: () => revisionPresentationForIndex,
+  revisionSelectorFor: () => revisionSelectorFor,
+  truncateRevisionText: () => truncateRevisionText
+});
+function revisionPalette() {
+  return [
+    { hex: "#0072b2", borderStyle: "solid", pattern: "none" },
+    { hex: "#d55e00", borderStyle: "dashed", pattern: "diagonal" },
+    { hex: "#009e73", borderStyle: "dotted", pattern: "none" },
+    { hex: "#cc79a7", borderStyle: "double", pattern: "dots" },
+    { hex: "#56b4e9", borderStyle: "dashed", pattern: "none" },
+    { hex: "#e69f00", borderStyle: "solid", pattern: "diagonal" }
+  ];
+}
+function revisionPresentationForIndex(index) {
+  const palette = revisionPalette();
+  const position = Number.isInteger(index) && index >= 0 ? index % palette.length : 0;
+  return palette[position];
+}
+function revisionLimits() {
+  return {
+    // One row per palette entry, derived rather than written down: a cap larger
+    // than the palette would hand the seventh revision the first one's colour
+    // *and* its border and pattern, which is precisely the case the palette
+    // exists to prevent.
+    entries: revisionPalette().length,
+    rawEntries: 256,
+    marks: 200,
+    rawMarks: 2e3,
+    registryBytes: 64 * 1024,
+    id: 60,
+    label: 80,
+    summary: 400,
+    timestamp: 40,
+    excerpt: 120,
+    selector: 400,
+    selectorDepth: 32
+  };
+}
+function truncateRevisionText(value, max) {
+  if (typeof value !== "string" && typeof value !== "number") return "";
+  const text = String(value).trim();
+  const limit = Number.isInteger(max) && max > 0 ? max : 0;
+  if (!limit || text.length <= limit) return text;
+  return text.slice(0, limit);
+}
+function isAddressableRevisionId(id) {
+  const text = typeof id === "string" || typeof id === "number" ? String(id) : "";
+  return text.length > 0 && text === text.trim() && !/\s/.test(text);
+}
+function exactRevisionText(value, max) {
+  const text = typeof value === "string" || typeof value === "number" ? String(value).trim() : "";
+  return text.length > 0 && text.length <= max ? text : "";
+}
+function normalizeRevisionEntry(entry, index) {
+  if (!entry || typeof entry !== "object" || Array.isArray(entry)) return null;
+  const limits = revisionLimits();
+  const id = exactRevisionText(entry.id, limits.id);
+  if (!isAddressableRevisionId(id)) return null;
+  return {
+    id,
+    index: Number.isInteger(index) && index >= 0 ? index : 0,
+    label: truncateRevisionText(entry.label, limits.label) || id,
+    timestamp: truncateRevisionText(entry.timestamp, limits.timestamp),
+    summary: truncateRevisionText(entry.summary, limits.summary),
+    mark_count: 0
+  };
+}
+function parseRevisionRegistry(doc) {
+  const script = doc && doc.querySelector ? doc.querySelector("script[data-lavish-revisions]") : null;
+  if (!script) return [];
+  const limits = revisionLimits();
+  const text = String(script.textContent || "").trim();
+  if (!text || text.length > limits.registryBytes) return [];
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return [];
+  }
+  if (!Array.isArray(parsed)) return [];
+  const revisions = [];
+  const seen = /* @__PURE__ */ new Set();
+  let examined = 0;
+  for (const raw of parsed) {
+    if (examined >= limits.rawEntries || revisions.length >= limits.entries) break;
+    examined += 1;
+    const entry = normalizeRevisionEntry(raw, revisions.length);
+    if (!entry || seen.has(entry.id)) continue;
+    seen.add(entry.id);
+    revisions.push(entry);
+  }
+  return revisions;
+}
+function isUniqueElementId(doc, id) {
+  if (!doc || typeof doc.querySelectorAll !== "function") return false;
+  try {
+    const found = doc.querySelectorAll(`#${id}`);
+    return Boolean(found) && found.length === 1;
+  } catch {
+    return false;
+  }
+}
+function revisionSelectorFor(element, doc) {
+  const limits = revisionLimits();
+  const parts = [];
+  let node = element;
+  let depth = 0;
+  while (node && node.nodeType === 1) {
+    if (depth >= limits.selectorDepth) return "";
+    const tag = String(node.tagName || "").toLowerCase();
+    if (!tag) return "";
+    const id = node.getAttribute ? String(node.getAttribute("id") || "").trim() : "";
+    if (id && /^[A-Za-z][-\w]*$/.test(id) && isUniqueElementId(doc, id)) {
+      parts.unshift(`#${id}`);
+      return parts.join(" > ");
+    }
+    const parent2 = node.parentElement;
+    let part = tag;
+    if (parent2 && parent2.children) {
+      const siblings = [];
+      for (const child of parent2.children) {
+        if (String(child.tagName || "").toLowerCase() === tag) siblings.push(child);
+      }
+      if (siblings.length > 1) part += `:nth-of-type(${siblings.indexOf(node) + 1})`;
+    }
+    parts.unshift(part);
+    node = parent2;
+    depth += 1;
+  }
+  return parts[0] === "html" ? parts.join(" > ") : "";
+}
+function collectRevisionMarks(doc, revisions) {
+  const limits = revisionLimits();
+  const declared = /* @__PURE__ */ new Map();
+  for (const revision of Array.isArray(revisions) ? revisions : []) {
+    if (revision && isAddressableRevisionId(revision.id)) declared.set(revision.id, revision);
+  }
+  const marks = [];
+  const elements = doc && doc.querySelectorAll ? doc.querySelectorAll("[data-lavish-revision]") : [];
+  let examined = 0;
+  for (const element of elements) {
+    if (examined >= limits.rawMarks || marks.length >= limits.marks) break;
+    examined += 1;
+    const id = element.getAttribute ? exactRevisionText(element.getAttribute("data-lavish-revision"), limits.id) : "";
+    if (!declared.has(id)) continue;
+    const selector = exactRevisionText(revisionSelectorFor(element, doc), limits.selector);
+    if (!selector) continue;
+    declared.get(id).mark_count += 1;
+    marks.push({
+      revision_id: id,
+      selector,
+      tag: String(element.tagName || "").toLowerCase(),
+      excerpt: truncateRevisionText(String(element.textContent || "").replace(/\s+/g, " "), limits.excerpt)
+    });
+  }
+  return marks;
+}
+function readArtifactRevisions(doc) {
+  const revisions = parseRevisionRegistry(doc);
+  const marks = collectRevisionMarks(doc, revisions);
+  return { revisions, marks };
+}
+
 // src/mermaid-node.js
 var mermaid_node_exports = {};
 __export(mermaid_node_exports, {
@@ -6840,6 +7025,19 @@ function createArtifactSdk(deriveQueueKey, isNativeInteractive = isNativeInterac
   }
   const mermaidObserver = new MutationObserver(() => scheduleMermaidEnhance());
   mermaidObserver.observe(document.documentElement, { childList: true, subtree: true });
+  function reportArtifactRevisions() {
+    let payload = { revisions: [], marks: [] };
+    try {
+      payload = readArtifactRevisions(document);
+    } catch {
+    }
+    postArtifactMessage("lavish:revisions", payload);
+  }
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", reportArtifactRevisions, { once: true });
+  } else {
+    reportArtifactRevisions();
+  }
 }
 
 // src/layout-warnings.js
@@ -11492,7 +11690,12 @@ function createChromeHtml(session, {
     modeToggleHotkeyKey: MODE_TOGGLE_HOTKEY_KEY,
     attachmentMaxBytes,
     attachmentMaxCount,
-    attachmentAcceptedMime: acceptedMime
+    attachmentAcceptedMime: acceptedMime,
+    // The legend's swatches are server-owned, not artifact-owned. The chrome
+    // derives every swatch from this palette by registry position, so an
+    // artifact cannot hand all its revisions the same colour and pattern and
+    // collapse the one signal that tells the rounds apart.
+    revisionPalette: revisionPalette()
   });
   const { head: pathHead, tail: pathTail } = displayPathParts(session.file);
   const bodyClass = layoutGateEnabled ? "lavish layout-gate-active" : "lavish";
@@ -11509,7 +11712,7 @@ ${faviconTag}
 <link rel="stylesheet" href="/chrome.css">
 </head>
 <body class="${bodyClass}">
-<div class="bar"><div class="brand"><span class="brand-mark">Lavish</span><span class="brand-support">Editor</span></div><div class="spacer" aria-hidden="true"></div><div class="warnings-wrap" id="warningsWrap" hidden><button class="warnings-button" id="warningsButton" type="button" aria-haspopup="dialog" aria-expanded="false" aria-controls="warningsDrawer">${chromeIcons.warning}<span class="warnings-count" id="warningsCount">0</span></button><div class="menu warnings-drawer" id="warningsDrawer" role="dialog" aria-labelledby="warningsTitle" aria-describedby="warningsSummary" hidden><div class="warnings-head"><h2 class="warnings-title" id="warningsTitle">Layout issues</h2><p class="warnings-summary" id="warningsSummary"></p></div><div class="warnings-toolbar"><label class="warnings-selectall"><input type="checkbox" id="warningsSelectAll"><span>Select all</span></label><span class="warnings-selected" id="warningsSelected" role="status" aria-live="polite"></span></div><div class="warnings-list" id="warningsList"></div><div class="warnings-foot"><p class="warnings-note">Queueing sends a repair request with your next feedback. An issue is marked resolved only after a newer artifact load and a complete check at the same viewport no longer finds it.</p><button class="button" id="warningsQueueButton" type="button" disabled>Queue selected fixes</button></div></div></div><button class="annotate-switch" id="annotation" type="button" aria-pressed="true" title="${escapeHtml2(modeToggleHint)}"><span class="switch-track" aria-hidden="true"><span class="switch-knob"></span></span><span>Annotate</span></button><div class="more-wrap" id="moreWrap"><button class="more-button" id="moreButton" type="button" title="More" aria-haspopup="menu" aria-expanded="false">${chromeIcons.more}</button><div class="menu more-menu" id="moreMenu" hidden><div class="menu-head"><div class="menu-label">Editing</div><button class="menu-file" id="copyPath" type="button" title="Copy path \xB7 ${escapeHtml2(session.file)}">${chromeIcons.file}<span class="menu-file-text"><span class="path-head">${escapeHtml2(pathHead)}</span><span class="path-tail">${escapeHtml2(pathTail)}</span></span><span class="copy-hint" id="copyHint"><span class="icon-copy">${chromeIcons.copy}</span><span class="icon-check">${chromeIcons.check}</span><span id="copyHintText">Copy</span></span></button></div><div class="menu-rule"></div><button class="menu-item" id="reloadArtifact" type="button">${chromeIcons.refresh}<span>Reload artifact</span></button><button class="menu-item" id="copySnapshot" type="button">${chromeIcons.camera}<span>Copy DOM snapshot</span></button><button class="menu-item" id="exportArtifact" type="button">${chromeIcons.download}<span>Export standalone HTML</span></button><button class="menu-item" id="shareArtifact" type="button">${chromeIcons.globe}<span>Publish link</span></button><div class="menu-rule"></div><button class="menu-item danger" id="end" type="button">${chromeIcons.exit}<span>End session</span></button></div></div></div>
+<div class="bar"><div class="brand"><span class="brand-mark">Lavish</span><span class="brand-support">Editor</span></div><div class="spacer" aria-hidden="true"></div><div class="warnings-wrap" id="warningsWrap" hidden><button class="warnings-button" id="warningsButton" type="button" aria-haspopup="dialog" aria-expanded="false" aria-controls="warningsDrawer">${chromeIcons.warning}<span class="warnings-count" id="warningsCount">0</span></button><div class="menu warnings-drawer" id="warningsDrawer" role="dialog" aria-labelledby="warningsTitle" aria-describedby="warningsSummary" hidden><div class="warnings-head"><h2 class="warnings-title" id="warningsTitle">Layout issues</h2><p class="warnings-summary" id="warningsSummary"></p></div><div class="warnings-toolbar"><label class="warnings-selectall"><input type="checkbox" id="warningsSelectAll"><span>Select all</span></label><span class="warnings-selected" id="warningsSelected" role="status" aria-live="polite"></span></div><div class="warnings-list" id="warningsList"></div><div class="warnings-foot"><p class="warnings-note">Queueing sends a repair request with your next feedback. An issue is marked resolved only after a newer artifact load and a complete check at the same viewport no longer finds it.</p><button class="button" id="warningsQueueButton" type="button" disabled>Queue selected fixes</button></div></div></div><div class="revisions-wrap" id="revisionsWrap" hidden><button class="revisions-button" id="revisionsButton" type="button" aria-haspopup="dialog" aria-expanded="false" aria-controls="revisionsDrawer"><span class="revisions-button-text">Revisions</span><span class="revisions-count" id="revisionsCount">0</span></button><div class="menu revisions-drawer" id="revisionsDrawer" role="dialog" aria-labelledby="revisionsTitle" aria-describedby="revisionsSummary" hidden><div class="revisions-head"><h2 class="revisions-title" id="revisionsTitle">Revisions</h2><p class="revisions-summary" id="revisionsSummary"></p></div><div class="revisions-list" id="revisionsList"></div><div class="revisions-foot"><p class="revisions-note">The agent declares these in the artifact itself. Reveal flashes the next block it marked for that revision; nothing about the page is restyled, so the saved file still looks the way it does here.</p></div></div></div><button class="annotate-switch" id="annotation" type="button" aria-pressed="true" title="${escapeHtml2(modeToggleHint)}"><span class="switch-track" aria-hidden="true"><span class="switch-knob"></span></span><span>Annotate</span></button><div class="more-wrap" id="moreWrap"><button class="more-button" id="moreButton" type="button" title="More" aria-haspopup="menu" aria-expanded="false">${chromeIcons.more}</button><div class="menu more-menu" id="moreMenu" hidden><div class="menu-head"><div class="menu-label">Editing</div><button class="menu-file" id="copyPath" type="button" title="Copy path \xB7 ${escapeHtml2(session.file)}">${chromeIcons.file}<span class="menu-file-text"><span class="path-head">${escapeHtml2(pathHead)}</span><span class="path-tail">${escapeHtml2(pathTail)}</span></span><span class="copy-hint" id="copyHint"><span class="icon-copy">${chromeIcons.copy}</span><span class="icon-check">${chromeIcons.check}</span><span id="copyHintText">Copy</span></span></button></div><div class="menu-rule"></div><button class="menu-item" id="reloadArtifact" type="button">${chromeIcons.refresh}<span>Reload artifact</span></button><button class="menu-item" id="copySnapshot" type="button">${chromeIcons.camera}<span>Copy DOM snapshot</span></button><button class="menu-item" id="exportArtifact" type="button">${chromeIcons.download}<span>Export standalone HTML</span></button><button class="menu-item" id="shareArtifact" type="button">${chromeIcons.globe}<span>Publish link</span></button><div class="menu-rule"></div><button class="menu-item danger" id="end" type="button">${chromeIcons.exit}<span>End session</span></button></div></div></div>
 <div class="layout"><div class="frame"><iframe id="artifact" sandbox="allow-scripts allow-forms allow-popups allow-popups-to-escape-sandbox allow-downloads" data-artifact-src="/artifact/${session.key}/index.html"></iframe></div><div class="panel-scrim" id="panelScrim"></div><aside class="panel" id="panel"><div class="panel-head" id="panelHead"><span class="panel-handle" aria-hidden="true"></span><div class="panel-head-row"><h2>Conversation</h2><span class="panel-summary" id="panelSummary" role="status" aria-live="polite"></span><button class="panel-toggle" id="panelToggle" type="button" aria-expanded="false" aria-controls="panel" aria-label="Show conversation">${chromeIcons.chevronUp}</button></div></div><div class="panel-scroll" id="panelScroll"><div class="chat" id="chatLog"></div><div class="chat chat-queued" id="queuedLog"></div></div><div class="composer" id="chatComposer"><div class="presence-banner handoff-banner" id="handoffBanner" hidden><span>This review is open in another Lavish tab.</span><button class="handoff-takeover" id="handoffTakeover" type="button">Take over here</button></div><div class="presence-banner handoff-banner" id="outdatedBanner" hidden><span id="outdatedText">The Lavish server this page was connected to is no longer running. Reloading will work once it is running again.</span><span class="outdated-actions"><button class="handoff-takeover" id="outdatedReload" type="button">Check and reload</button><button class="handoff-takeover" id="outdatedDismiss" type="button">Dismiss</button></span></div><div class="presence-banner" id="presenceBanner" hidden>Your agent is not listening. If this persists, ask your agent to poll for updates from Lavish.</div><textarea id="chatInput" placeholder="Write a message for the agent..."></textarea><div class="chat-attachments" id="chatAttachments"></div><div class="chat-attachment-toolbar"><button class="chat-attach" id="chatAttach" type="button">Attach images</button><input id="chatAttachInput" type="file" accept="${escapeHtml2(acceptedMime.join(","))}" multiple hidden><span class="chat-attachment-notice" id="chatAttachmentNotice" role="status"></span></div><div class="send-hint" id="sendHint" hidden>Write a message or annotate an element first.</div><div class="actions" id="sendActions"><button class="button button-danger" id="sendAndEnd" type="button">${chromeIcons.exit}<span>Send &amp; End</span></button><button class="button" id="send">Send to Agent</button></div></div></aside></div>
 <div class="share-overlay" id="shareDialog" role="dialog" aria-modal="true" aria-labelledby="shareTitleText" hidden><form class="share-card" id="shareForm"><div class="share-head"><div><div class="share-kicker">Publish to <a class="share-link" href="https://ht-ml.app" target="_blank" rel="noopener noreferrer">ht-ml.app</a></div><h2 id="shareTitleText">Publish artifact</h2></div><button class="share-close" id="shareClose" type="button" aria-label="Close publish dialog"><svg width="14" height="14" viewBox="0 0 10 10" fill="none" aria-hidden="true" focusable="false"><path d="M1 1L9 9M9 1L1 9" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/></svg></button></div><p class="share-note">ht-ml.app is a separate, third-party hosting service, not part of Lavish. Publishing sends this artifact to its servers.</p><p class="share-copy">This uploads this artifact to ht-ml.app with local assets inlined. Without a password, the page is PUBLIC and anyone with the link can open it. With a password, the page is PRIVATE and viewers must supply the password to view.</p><p class="share-note">Do not publish secrets. The Lavish annotation SDK is not included.</p><div class="share-grid"><label class="share-check"><input id="shareGenerate" type="checkbox"><span>Generate a password (makes this page private)</span></label><label>Password (optional)<input id="sharePassword" name="password" type="password" autocomplete="new-password" placeholder="Leave blank for a public page"></label></div><div class="share-status" id="shareStatus" role="status"></div><div class="share-result" id="shareResult" hidden><label id="shareUrlResult">Share URL<div class="share-copy-row"><input id="shareUrl" readonly><button class="share-copy-btn" id="copyShareUrl" type="button">Copy URL</button></div></label><label id="sharePasswordResult" hidden>Password (shared secret)<div class="share-copy-row"><input id="sharePasswordOut" readonly><button class="share-copy-btn" id="copySharePassword" type="button">Copy password</button></div></label><label id="shareSiteIdResult" hidden>Site ID<div class="share-copy-row"><input id="shareSiteId" readonly><button class="share-copy-btn" id="copyShareSiteId" type="button">Copy site ID</button></div></label><label id="shareUpdateKeyResult">Update key (secret)<div class="share-copy-row"><input id="shareUpdateKey" readonly><button class="share-copy-btn" id="copyUpdateKey" type="button">Copy key</button></div></label><p class="share-note" id="shareUpdateKeyNote">Keep the update key private. ht-ml.app returns it once and it is the only way to update this page later; the service has no delete. Republish this page&#39;s HTML with <code>lavish-axi share &lt;file&gt; --site &lt;site id&gt; --update-key &lt;key&gt;</code>, and add <code>--private</code> to also lock it behind a new generated password.</p></div><div class="share-actions"><button class="share-cancel" id="shareCancel" type="button">Cancel</button><button class="button" id="sharePublish" type="submit">Publish</button></div></form></div>
 <div class="ended-overlay layout-gate-overlay" id="layoutGateOverlay"${layoutGateHidden}><div class="ended-card"><div class="ended-title" id="layoutGateTitle">Checking layout.<br>One moment.</div><p class="ended-copy" id="layoutGateCopy">Lavish is waiting for fonts and final geometry before revealing this artifact.</p><button class="button ended-action" id="layoutGateAction" type="button">Show anyway</button><button class="button ended-action layout-gate-bypass" id="layoutGateBypass" type="button" hidden>Show anyway</button></div></div>
@@ -11552,6 +11755,7 @@ function serializeModuleHelpers(module) {
 function createSdkJs(key, artifactRevision = 0, artifactLoadToken = "", { maxAttachmentCount, maxAttachmentBytes, acceptedImageMime = ACCEPTED_IMAGE_MIME } = {}) {
   const mermaidHelperSource = serializeModuleHelpers(mermaid_node_exports);
   const tableHelperSource = serializeModuleHelpers(table_cell_exports);
+  const revisionHelperSource = serializeModuleHelpers(artifact_revisions_exports);
   const revisionNumber = Number(artifactRevision);
   const revision = Number.isFinite(revisionNumber) && revisionNumber >= 0 ? Math.trunc(revisionNumber) : 0;
   const loadToken = String(artifactLoadToken || "").slice(0, 200);
@@ -11583,6 +11787,7 @@ const deriveAttachmentNoticeState=${deriveAttachmentNoticeState.toString()};
 ${mermaidHelperSource.declarations}
 const mermaidHelpers={ ${mermaidHelperSource.names.join(", ")} };
 ${tableHelperSource.declarations}
+${revisionHelperSource.declarations}
 (${createArtifactSdk.toString()})(deriveQueueKey, isNativeInteractiveControl, mermaidHelpers, artifactRevision, artifactLoadToken, key, ${JSON.stringify(sdkOptions)});
 })();`;
 }
@@ -11790,7 +11995,7 @@ var AGENT_REPLY_INPUT_LIMIT_BYTES = AGENT_REPLY_JSON_LIMIT_BYTES - AGENT_REPLY_J
 var AGENT_REPLY_LIMIT_LABEL = "2 MB JSON request limit";
 var POLL_STATE_HEADER = "lavish-poll-state";
 var CODEX_POLL_WAKE_PATH_GUIDANCE = "Codex detected: completed background tasks may not resume Codex automatically, so keep the poll attached to the active turn.";
-var VERSION = "0.1.75";
+var VERSION = "0.1.77";
 function detectInvokingAgent(env = process.env) {
   return ["CODEX_SANDBOX", "CODEX_THREAD_ID"].some((key) => Object.hasOwn(env, key)) ? "codex" : "generic";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lavish-axi",
-  "version": "0.1.75",
+  "version": "0.1.77",
   "packageManager": "pnpm@11.1.1",
   "description": "HTML is the new markdown. Lavish is the new editor for your HTML artifacts.",
   "type": "module",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "lavish-axi",
-  "version": "0.1.75",
+  "version": "0.1.77",
   "description": "HTML is the new markdown. Lavish is the new editor for your HTML artifacts.",
   "author": {
     "name": "Kun Chen",

package/skills/lavish/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: lavish
-description: Turn complex or visual agent responses into rich, reviewable HTML artifacts the user can annotate and send feedback on, using the lavish-axi CLI. Use when about to give a plan, comparison, diagram, table, code diff, report, or anything easier to grasp visually than as prose.
+description: Turn complex or visual agent responses into rich, reviewable HTML artifacts (HTML files) the user can annotate and send feedback on, using the lavish-axi CLI. Use when about to give a plan, comparison, diagram, table, code diff, report, or anything easier to grasp visually than as prose.
 license: MIT
 metadata:
   author: Kun Chen (kunchenguid)
@@ -29,5 +29,5 @@ If lavish-axi output shows a follow-up command starting with `lavish-axi`, run i
 
 $ARGUMENTS
 
-If the request above is non-empty, the user invoked `/lavish` explicitly - fetch the current CLI guidance, then build that artifact.
+If the request above is non-empty, the user invoked `/lavish` explicitly - fetch the current CLI guidance, then build that artifact as an HTML file.
 If it is empty, infer what to visualize from the conversation.