lavish-axi 0.1.13 → 0.1.14

package/README.md

@@ -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/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";
@@ -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.13";
+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
@@ -2022,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";
@@ -2239,6 +2262,7 @@ Usage:
   lavish-axi end <html-file>
   lavish-axi playbook [playbook_id]
   lavish-axi design
+  lavish-axi setup hooks
 
 ${DESIGN_SYSTEM_HINT}
 
@@ -2270,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.13",
+  "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",