lavish-axi 0.1.13 → 0.1.15

package/README.md

@@ -97,7 +97,7 @@ pnpm link
 - **File-path identity** - Sessions are keyed by the canonical HTML file path, so agents do not need opaque IDs.
 - **Portable artifacts** - The artifact runs in an iframe while Lavish injects a small SDK for annotations, snapshots, and feedback controls. Lavish does not inject any design system, so the saved HTML file renders identically whether you open it through `lavish-axi` or directly in a browser. Run `lavish-axi design` for a copy-pasteable CDN snippet to opt in to Tailwind CSS v4 + DaisyUI v5, or use any other design system (or none).
 - **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.
-- **Live reload** - Lavish watches the HTML artifact file by default. To also reload on sibling asset changes, add `data-lavish-live-reload-root` to the root element or `<meta name="lavish-live-reload" content="root">`.
+- **Live reload** - Lavish watches the HTML artifact file by default and preserves the artifact iframe scroll position across reloads. To also reload on sibling asset changes, add `data-lavish-live-reload-root` to the root element or `<meta name="lavish-live-reload" content="root">`.
 - **Feedback controls** - Mark buttons, choices, and other interactive elements with `data-lavish-action` so Lavish does not annotate them, then call `window.lavish.queuePrompt()` or `window.lavish.sendQueuedPrompts()` from the control handler.
 - **Agent presence** - The browser shows when no agent is listening, keeps queued feedback for the next successful `lavish-axi poll` send even across reloads, and only blocks sending while the agent is working on delivered feedback.
 - **Precise targets** - Text annotations include selected text plus range anchors, so agents are not limited to whole-element selectors.
@@ -105,15 +105,16 @@ pnpm link
 
 ## CLI Reference
 
-| Command                       | Description                                                  |
-| ----------------------------- | ------------------------------------------------------------ |
-| `lavish-axi`                  | Show current sessions and usage guidance.                    |
-| `lavish-axi <html-file>`      | Open or resume a Lavish Editor session.                      |
-| `lavish-axi poll <html-file>` | Long-poll until the user sends feedback or ends the session. |
-| `lavish-axi end <html-file>`  | End a session.                                               |
-| `lavish-axi playbook [id]`    | List focused artifact guidance or show one playbook.         |
-| `lavish-axi design`           | Show CDN snippet + DaisyUI component reference (opt-in).     |
-| `lavish-axi server`           | Run the local Lavish Editor server.                          |
+| Command                       | Description                                                                                                              |
+| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `lavish-axi`                  | Show current sessions and usage guidance.                                                                                |
+| `lavish-axi <html-file>`      | Open or resume a Lavish Editor session.                                                                                  |
+| `lavish-axi poll <html-file>` | Long-poll until the user sends feedback or ends the session.                                                             |
+| `lavish-axi end <html-file>`  | End a session.                                                                                                           |
+| `lavish-axi playbook [id]`    | List focused artifact guidance or show one playbook.                                                                     |
+| `lavish-axi design`           | Show CDN snippet + DaisyUI component reference (opt-in).                                                                 |
+| `lavish-axi setup hooks`      | Install or repair optional SessionStart hooks for Claude Code, Codex, and OpenCode; restart the agent session afterward. |
+| `lavish-axi server`           | Run the local Lavish Editor server.                                                                                      |
 
 Known playbook IDs: `diagram`, `table`, `comparison`, `plan`, `diff`, `input`, `slides`.
 

package/dist/chrome-client.js

@@ -24,6 +24,7 @@ let pendingSnapshot = "";
 let workingBubble = null;
 let submitQueuedPromise = null;
 let submitQueuedAgain = false;
+let lastScroll = { x: 0, y: 0 };
 
 function escapeHtml(value) {
   return String(value).replace(
@@ -244,6 +245,9 @@ window.addEventListener("message", (event) => {
     pendingSnapshot = msg.snapshot || "";
     submitQueued();
   }
+  if (msg.type === "lavish:scroll") {
+    lastScroll = { x: Number(msg.x) || 0, y: Number(msg.y) || 0 };
+  }
   if (msg.type === "lavish:sendQueuedPrompts") sendQueued();
   if (msg.type === "lavish:endSession") endSession();
 });
@@ -258,7 +262,11 @@ annotationButton.onclick = () => {
 sendButton.onclick = sendQueued;
 copyPathButton.onclick = copyFilePath;
 endButton.onclick = endSession;
-frame.addEventListener("load", () => postToFrame({ type: "lavish:setAnnotationMode", enabled: annotation }));
+frame.addEventListener("load", () => {
+  postToFrame({ type: "lavish:setAnnotationMode", enabled: annotation });
+  // Replay the pre-reload scroll position so hot reloads don't jump the artifact to the top.
+  postToFrame({ type: "lavish:restoreScroll", x: lastScroll.x, y: lastScroll.y });
+});
 
 const events = new EventSource("/events/" + key);
 events.addEventListener("reload", () => {

package/dist/cli.mjs

@@ -7,7 +7,7 @@ import { access } from "node:fs/promises";
 import os2 from "node:os";
 import path4 from "node:path";
 import { fileURLToPath } from "node:url";
-import { AxiError, runAxiCli } from "axi-sdk-js";
+import { AxiError, installSessionStartHooks, runAxiCli } from "axi-sdk-js";
 
 // src/design-reference.js
 var TAILWIND_BROWSER_VERSION = "4.2.4";
@@ -955,7 +955,22 @@ function createArtifactSdk() {
     if (msg.type === "lavish:requestSnapshot") {
       parent.postMessage({ type: "lavish:snapshot", snapshot: snapshot() }, "*");
     }
+    if (msg.type === "lavish:restoreScroll") {
+      window.scrollTo(Number(msg.x) || 0, Number(msg.y) || 0);
+    }
   });
+  let scrollFrame = 0;
+  window.addEventListener(
+    "scroll",
+    () => {
+      if (scrollFrame) return;
+      scrollFrame = window.requestAnimationFrame(() => {
+        scrollFrame = 0;
+        parent.postMessage({ type: "lavish:scroll", x: window.scrollX, y: window.scrollY }, "*");
+      });
+    },
+    { passive: true }
+  );
   document.addEventListener(
     "mouseover",
     (event) => {
@@ -1747,7 +1762,7 @@ var HttpTelemetryClient = class {
     await Promise.race([
       drained,
       new Promise((resolve) => {
-        setTimeout(resolve, timeoutMs).unref?.();
+        setTimeout(resolve, timeoutMs);
       })
     ]);
   }
@@ -1820,9 +1835,9 @@ function normalizePagePath(path5) {
 }
 
 // src/cli.js
-var COMMANDS = /* @__PURE__ */ new Set(["open", "poll", "end", "server", "playbook", "design"]);
+var COMMANDS = /* @__PURE__ */ new Set(["open", "poll", "end", "server", "playbook", "design", "setup"]);
 var DESCRIPTION = "Lavish Editor helps agents turn rich HTML artifacts into collaborative human review surfaces. Whenever you are about to give user a complex response that will be easier to understand via a rich / interactive page, consider using Lavish Editor. First generate an interactive HTML artifact according to user request, then run `lavish-axi <html-file>` so the user can visually review it, annotate elements or selected text, queue prompts, and send feedback back through `lavish-axi poll`.";
-var VERSION = "0.1.13";
+var VERSION = "0.1.15";
 async function run(argv) {
   await ensureStateDir();
   const normalizedArgv = normalizeArgv(argv);
@@ -1841,7 +1856,6 @@ async function run(argv) {
       version: VERSION,
       argv: isTopLevelHelp ? [] : normalizedArgv,
       topLevelHelp: TOP_LEVEL_HELP,
-      hooks: { binaryNames: ["lavish-axi"] },
       home: async () => createHomeOutput({
         bin: process.argv[1] || "lavish-axi",
         sessions: isTopLevelHelp ? [] : await visibleSessions(),
@@ -1853,6 +1867,7 @@ async function run(argv) {
         end: endCommand,
         playbook: playbookCommand,
         design: designCommand,
+        setup: setupCommand,
         server: serverCommand
       },
       getCommandHelp
@@ -2022,6 +2037,29 @@ async function playbookCommand(args) {
 async function designCommand() {
   return createDesignOutput();
 }
+async function setupCommand(args) {
+  if (args.length !== 1 || args[0] !== "hooks") {
+    throw new AxiError("Unknown setup action", "VALIDATION_ERROR", ["Run `lavish-axi setup hooks`"]);
+  }
+  const errors = [];
+  installSessionStartHooks({
+    marker: "lavish-axi",
+    binaryNames: ["lavish-axi"],
+    distEntrypoints: ["dist/cli.mjs", "bin/lavish-axi.js"],
+    homeDir: resolveHookHomeDir(),
+    onError: (message) => errors.push(message)
+  });
+  if (errors.length > 0) {
+    throw new AxiError("Failed to install lavish-axi agent hooks", "SERVER_ERROR", errors);
+  }
+  return {
+    hooks: { status: "installed", integrations: "Claude Code, Codex, OpenCode" },
+    help: ["Restart your agent session to receive lavish-axi ambient context"]
+  };
+}
+function resolveHookHomeDir(env = process.env, fallback = os2.homedir()) {
+  return env.HOME || fallback;
+}
 async function serverCommand(args) {
   const port = Number(flagValue(args, "--port") || defaultPort());
   const debug = args.includes("--verbose") || process.env.LAVISH_AXI_DEBUG === "1";
@@ -2239,6 +2277,7 @@ Usage:
   lavish-axi end <html-file>
   lavish-axi playbook [playbook_id]
   lavish-axi design
+  lavish-axi setup hooks
 
 ${DESIGN_SYSTEM_HINT}
 
@@ -2270,6 +2309,10 @@ Examples:
   design: `Usage: lavish-axi design
 
 Show a copy-pasteable CDN snippet for Tailwind CSS browser runtime v4 + DaisyUI v5 + themes, plus technical reference for DaisyUI components. Lavish artifacts stay portable HTML. Prefer the CDN snippet over hand-writing styles unless explicitly instructed otherwise by the user. If the user asks for another design system or plain HTML, follow that request.
+`,
+  setup: `Usage: lavish-axi setup hooks
+
+Install or repair agent SessionStart hooks for lavish-axi ambient context in Claude Code, Codex, and OpenCode. Restart your agent session afterward to receive the context.
 `,
   server: `Usage: lavish-axi server [--port 4387] [--verbose]
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lavish-axi",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "packageManager": "pnpm@11.1.1",
   "description": "HTML is the new markdown. Lavish is the new editor for your HTML artifacts.",
   "type": "module",
@@ -26,7 +26,7 @@
   },
   "dependencies": {
     "@tailwindcss/browser": "4.2.4",
-    "axi-sdk-js": "^0.1.6",
+    "axi-sdk-js": "^0.1.7",
     "chokidar": "^4.0.3",
     "daisyui": "^5.5.19",
     "express": "^5.2.1",