lavish-axi 0.1.12 → 0.1.14

package/README.md

@@ -96,6 +96,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">`.
 - **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.
@@ -104,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/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";
@@ -1389,7 +1389,7 @@ async function serve({ port, stateFile: stateFile2, version = "", debug = false,
         res.status(403).send("Forbidden");
         return;
       }
-      res.sendFile(file);
+      res.sendFile(file, { dotfiles: "allow" });
     } catch (error) {
       next(error);
     }
@@ -1820,9 +1820,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.12";
+var VERSION = "0.1.14";
 async function run(argv) {
   await ensureStateDir();
   const normalizedArgv = normalizeArgv(argv);
@@ -1841,7 +1841,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 +1852,7 @@ async function run(argv) {
         end: endCommand,
         playbook: playbookCommand,
         design: designCommand,
+        setup: setupCommand,
         server: serverCommand
       },
       getCommandHelp
@@ -1912,6 +1912,7 @@ function createHomeOutput({ bin, sessions, includeSessions = true }) {
     help: [
       "Run `lavish-axi <html-file>` to open or resume a Lavish Editor session",
       "Unless the user specifies another location, create HTML artifacts in the current working directory under `.lavish/`",
+      "Lavish serves the html file through a local express.js server. If your html needs to reference other filesystem assets such as images, CSS, fonts, and local scripts, copy them into the same directory as the HTML file, then reference them with relative paths from that directory. Never prepend `/` to those asset paths - root paths won't work",
       "Run `lavish-axi poll <html-file>` to wait for user feedback",
       "Run `lavish-axi end <html-file>` to end a session",
       "Run `lavish-axi playbook <playbook_id>` for focused artifact guidance",
@@ -2021,6 +2022,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";
@@ -2238,6 +2262,7 @@ Usage:
   lavish-axi end <html-file>
   lavish-axi playbook [playbook_id]
   lavish-axi design
+  lavish-axi setup hooks
 
 ${DESIGN_SYSTEM_HINT}
 
@@ -2269,6 +2294,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.12",
+  "version": "0.1.14",
   "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",