@stackable-labs/cli-app-extension 1.19.0 → 1.20.0

package/dist/index.js

@@ -775,7 +775,7 @@ var fetchApps = async (token) => {
     iconUrl
   }));
 };
-var createExtensionRemote = async (appId, payload, token) => {
+var createExtensionRemote = async (appId, token, payload) => {
   const baseUrl = getAdminApiBaseUrl();
   const res = await fetch(`${baseUrl}/app-extension/${appId}/extensions`, {
     method: "POST",
@@ -1726,17 +1726,25 @@ var App = ({ command, token, userId, orgId, initialName, initialExtensionId, opt
   };
   switch (step) {
     case "app": {
-      return /* @__PURE__ */ jsx13(AppSelect, { token, userId, orgId, onSubmit: handleAppSelect });
+      return /* @__PURE__ */ jsx13(
+        AppSelect,
+        {
+          token,
+          orgId,
+          userId,
+          onSubmit: handleAppSelect
+        }
+      );
     }
     case "extensionSelect": {
       return /* @__PURE__ */ jsx13(
         ExtensionSelect,
         {
           appId: selectedApp.id,
-          token,
           command,
-          onSubmit: handleExtensionSelect,
-          onBack: goBack
+          token,
+          onBack: goBack,
+          onSubmit: handleExtensionSelect
         }
       );
     }
@@ -1746,8 +1754,8 @@ var App = ({ command, token, userId, orgId, initialName, initialExtensionId, opt
         {
           availableTargets: selectedApp?.targets ?? [],
           preSelected: targets,
-          onSubmit: handleConfirmTargets,
-          onBack: goBack
+          onBack: goBack,
+          onSubmit: handleConfirmTargets
         }
       );
     }
@@ -1756,8 +1764,8 @@ var App = ({ command, token, userId, orgId, initialName, initialExtensionId, opt
         NamePrompt,
         {
           initialValue: name,
-          onSubmit: handleName,
-          onBack: goBack
+          onBack: goBack,
+          onSubmit: handleName
         }
       );
     }
@@ -1787,10 +1795,10 @@ var App = ({ command, token, userId, orgId, initialName, initialExtensionId, opt
         {
           command,
           name,
-          extensionPort,
-          previewPort,
           targets,
           outputDir,
+          previewPort,
+          extensionPort,
           extensionVersion: command !== "create" /* CREATE */ ? extensionVersion : void 0,
           bundleUrl: command === "update" /* UPDATE */ ? bundleUrl : void 0,
           enabled: command === "update" /* UPDATE */ ? enabled : void 0,
@@ -1811,9 +1819,9 @@ var App = ({ command, token, userId, orgId, initialName, initialExtensionId, opt
         {
           name,
           targets,
-          availableTargets: selectedApp?.targets ?? [],
-          bundleUrl,
           enabled,
+          bundleUrl,
+          availableTargets: selectedApp?.targets ?? [],
           onSubmit: (updated) => {
             setName(updated.name);
             setTargets(updated.targets);
@@ -1866,8 +1874,8 @@ var App = ({ command, token, userId, orgId, initialName, initialExtensionId, opt
 };
 
 // src/components/DevApp.tsx
-import { Box as Box16, Text as Text16, useInput as useInput9 } from "ink";
 import { useRef, useState as useState10, useEffect as useEffect6, useCallback as useCallback2 } from "react";
+import { useInput as useInput9, Box as Box16, Text as Text16 } from "ink";
 
 // src/lib/tunnel.ts
 import { Tunnel } from "cloudflared";
@@ -1926,7 +1934,13 @@ var DevSetup = ({ initialContext, token, onReady }) => {
   if (step === "app") {
     return /* @__PURE__ */ jsxs14(Box14, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx14(Box14, { marginBottom: 1, children: /* @__PURE__ */ jsx14(Text14, { children: "Select the App for your extension:" }) }),
-      /* @__PURE__ */ jsx14(AppSelect, { token, onSubmit: handleAppSelect })
+      /* @__PURE__ */ jsx14(
+        AppSelect,
+        {
+          token,
+          onSubmit: handleAppSelect
+        }
+      )
     ] });
   }
   return /* @__PURE__ */ jsxs14(Box14, { flexDirection: "column", children: [
@@ -1934,8 +1948,8 @@ var DevSetup = ({ initialContext, token, onReady }) => {
     /* @__PURE__ */ jsx14(
       ExtensionSelect,
       {
-        appId: selectedApp?.id || initialContext.appId,
         token,
+        appId: selectedApp?.id || initialContext.appId,
         onSubmit: handleExtensionSelect
       }
     )
@@ -1947,16 +1961,16 @@ import { Box as Box15, Text as Text15, useInput as useInput8 } from "ink";
 import { useEffect as useEffect5 } from "react";
 import { jsx as jsx15, jsxs as jsxs15 } from "react/jsx-runtime";
 var DevDashboard = ({
+  previewTunnelUrl,
+  tunnelUrl,
   userId,
   orgId,
-  extensionName,
-  extensionId,
   appId,
   appName,
-  tunnelUrl,
-  previewTunnelUrl,
-  previewPort,
+  extensionId,
+  extensionName,
   extensionPort,
+  previewPort,
   onQuit
 }) => {
   useEffect5(() => {
@@ -2149,8 +2163,8 @@ var DevApp = ({ token, userId, orgId, options = {} }) => {
       return /* @__PURE__ */ jsx16(
         DevSetup,
         {
-          initialContext: devContext,
           token,
+          initialContext: devContext,
           onReady: handleSetupReady
         }
       );
@@ -2161,16 +2175,16 @@ var DevApp = ({ token, userId, orgId, options = {} }) => {
     return /* @__PURE__ */ jsx16(
       DevDashboard,
       {
-        userId,
+        previewTunnelUrl,
+        tunnelUrl,
         orgId,
-        extensionName: devContext.extensionName,
-        extensionId: resolvedContext.extensionId,
+        userId,
         appId: resolvedContext.appId,
         appName: resolvedContext.appName,
+        extensionName: devContext.extensionName,
+        extensionId: resolvedContext.extensionId,
         extensionPort: options.extensionPort ? parseInt(options.extensionPort, 10) : devContext.extensionPort,
         previewPort: options.previewPort ? parseInt(options.previewPort, 10) : devContext.previewPort,
-        tunnelUrl,
-        previewTunnelUrl,
         onQuit: handleQuit
       }
     );
@@ -2181,19 +2195,138 @@ var DevApp = ({ token, userId, orgId, options = {} }) => {
   return /* @__PURE__ */ jsx16(Box16, { children: /* @__PURE__ */ jsx16(Text16, { children: "Loading..." }) });
 };
 
-// src/components/AuthLogin.tsx
-import { createServer } from "http";
+// src/components/AIScaffold.tsx
 import { Box as Box17, Text as Text17, useApp as useApp2 } from "ink";
 import Spinner4 from "ink-spinner";
-import open from "open";
 import { useState as useState11, useEffect as useEffect7 } from "react";
 
+// src/lib/aiDocs.ts
+import { existsSync, readFileSync } from "fs";
+import { join as join4, dirname } from "path";
+import { mkdir, writeFile as writeFile3 } from "fs/promises";
+import AdmZip from "adm-zip";
+var DEFAULT_STATIC_CDN_URL = "https://static.stackablelabs.io";
+var AI_DOCS_FILENAME = "extension-ai-docs.zip";
+var getStaticCdnBaseUrl = () => process.env.STATIC_CDN_BASE_URL ?? DEFAULT_STATIC_CDN_URL;
+var isValidManifest = (data) => {
+  if (!data || typeof data !== "object") return false;
+  const m = data;
+  return typeof m.name === "string" && m.name.length > 0 && typeof m.version === "string" && Array.isArray(m.targets) && Array.isArray(m.permissions) && Array.isArray(m.allowedDomains);
+};
+var isExtensionProject = (dir) => {
+  const manifestPath = join4(dir, "packages/extension/public/manifest.json");
+  if (!existsSync(manifestPath)) {
+    return { valid: false, reason: "No manifest.json found at packages/extension/public/manifest.json \u2014 is this an Extension project?" };
+  }
+  try {
+    const raw = readFileSync(manifestPath, "utf8");
+    const data = JSON.parse(raw);
+    if (!isValidManifest(data)) {
+      return { valid: false, reason: "Invalid manifest: missing required fields (name, version, targets, permissions, allowedDomains)" };
+    }
+  } catch {
+    return { valid: false, reason: "Failed to parse manifest.json" };
+  }
+  return { valid: true };
+};
+var downloadAndExtractAiDocs = async (targetDir, version2) => {
+  const baseUrl = getStaticCdnBaseUrl();
+  const zipUrl = `${baseUrl}/ai-docs/${version2}/${AI_DOCS_FILENAME}`;
+  const response = await fetch(zipUrl);
+  if (!response.ok) {
+    throw new Error(`Failed to download AI docs from ${zipUrl}: ${response.status} ${response.statusText}`);
+  }
+  const buffer = Buffer.from(await response.arrayBuffer());
+  const zip = new AdmZip(buffer);
+  const entries = zip.getEntries();
+  const extractedFiles = [];
+  for (const entry of entries) {
+    if (entry.isDirectory) continue;
+    const targetPath = join4(targetDir, entry.entryName);
+    await mkdir(dirname(targetPath), { recursive: true });
+    await writeFile3(targetPath, entry.getData());
+    extractedFiles.push(entry.entryName);
+  }
+  return { files: extractedFiles.sort() };
+};
+
+// src/components/AIScaffold.tsx
+import { jsx as jsx17, jsxs as jsxs16 } from "react/jsx-runtime";
+var AIScaffold = ({ version: version2 }) => {
+  const { exit } = useApp2();
+  const [state, setState] = useState11("validating");
+  const [files, setFiles] = useState11([]);
+  const [errorMessage, setErrorMessage] = useState11("");
+  useEffect7(() => {
+    const run = async () => {
+      const projectDir = process.cwd();
+      const check = isExtensionProject(projectDir);
+      if (!check.valid) {
+        setErrorMessage(check.reason);
+        setState("error");
+        exit();
+        return;
+      }
+      setState("downloading");
+      try {
+        const result = await downloadAndExtractAiDocs(projectDir, version2);
+        setFiles(result.files);
+        setState("done");
+      } catch (err) {
+        setErrorMessage(err instanceof Error ? err.message : String(err));
+        setState("error");
+      }
+      exit();
+    };
+    run();
+  }, []);
+  return /* @__PURE__ */ jsxs16(Box17, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx17(Banner, {}),
+    /* @__PURE__ */ jsxs16(StepShell, { title: "AI Editor Config", children: [
+      state === "validating" && /* @__PURE__ */ jsxs16(Box17, { gap: 1, children: [
+        /* @__PURE__ */ jsx17(Text17, { color: "cyan", children: /* @__PURE__ */ jsx17(Spinner4, { type: "dots" }) }),
+        /* @__PURE__ */ jsx17(Text17, { children: "Checking project..." })
+      ] }),
+      state === "downloading" && /* @__PURE__ */ jsxs16(Box17, { gap: 1, children: [
+        /* @__PURE__ */ jsx17(Text17, { color: "cyan", children: /* @__PURE__ */ jsx17(Spinner4, { type: "dots" }) }),
+        /* @__PURE__ */ jsxs16(Text17, { children: [
+          "Downloading AI editor configs (",
+          version2,
+          ")..."
+        ] })
+      ] }),
+      state === "done" && /* @__PURE__ */ jsxs16(Box17, { flexDirection: "column", gap: 1, children: [
+        /* @__PURE__ */ jsxs16(Box17, { gap: 1, children: [
+          /* @__PURE__ */ jsx17(Text17, { color: "green", bold: true, children: "\u2714" }),
+          /* @__PURE__ */ jsxs16(Text17, { bold: true, children: [
+            "AI editor configs installed (",
+            files.length,
+            " files)"
+          ] })
+        ] }),
+        /* @__PURE__ */ jsx17(Box17, { flexDirection: "column", marginLeft: 2, children: files.map((f) => /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: f }, f)) })
+      ] }),
+      state === "error" && /* @__PURE__ */ jsxs16(Box17, { gap: 1, children: [
+        /* @__PURE__ */ jsx17(Text17, { color: "red", children: "\u2716" }),
+        /* @__PURE__ */ jsx17(Text17, { children: errorMessage })
+      ] })
+    ] })
+  ] });
+};
+
+// src/components/AuthLogin.tsx
+import { createServer } from "http";
+import { Box as Box18, Text as Text18, useApp as useApp3 } from "ink";
+import Spinner5 from "ink-spinner";
+import open from "open";
+import { useState as useState12, useEffect as useEffect8 } from "react";
+
 // src/lib/auth.ts
-import { readFile as readFile3, writeFile as writeFile3, mkdir, unlink } from "fs/promises";
-import { join as join4 } from "path";
+import { readFile as readFile3, writeFile as writeFile4, mkdir as mkdir2, unlink } from "fs/promises";
+import { join as join5 } from "path";
 import { homedir } from "os";
-var AUTH_DIR = join4(homedir(), ".stackable");
-var AUTH_FILE = join4(AUTH_DIR, "auth.json");
+var AUTH_DIR = join5(homedir(), ".stackable");
+var AUTH_FILE = join5(AUTH_DIR, "auth.json");
 var readAuthState = async () => {
   try {
     const content = await readFile3(AUTH_FILE, "utf8");
@@ -2203,8 +2336,8 @@ var readAuthState = async () => {
   }
 };
 var writeAuthState = async (state) => {
-  await mkdir(AUTH_DIR, { recursive: true, mode: 448 });
-  await writeFile3(AUTH_FILE, JSON.stringify(state, null, 2), { mode: 384 });
+  await mkdir2(AUTH_DIR, { recursive: true, mode: 448 });
+  await writeFile4(AUTH_FILE, JSON.stringify(state, null, 2), { mode: 384 });
 };
 var clearAuthState = async () => {
   try {
@@ -2215,7 +2348,9 @@ var clearAuthState = async () => {
 var decodeJwtPayload = (token) => {
   try {
     const [, payload] = token.split(".");
-    if (!payload) return null;
+    if (!payload) {
+      return null;
+    }
     const json = Buffer.from(payload, "base64url").toString("utf8");
     return JSON.parse(json);
   } catch {
@@ -2237,7 +2372,7 @@ var getToken = async () => {
 };
 
 // src/components/AuthLogin.tsx
-import { jsx as jsx17, jsxs as jsxs16 } from "react/jsx-runtime";
+import { jsx as jsx18, jsxs as jsxs17 } from "react/jsx-runtime";
 var LOGIN_TIMEOUT_MS = 5 * 60 * 1e3;
 var callbackPage = (heading, sub, redirectUrl) => `<!DOCTYPE html>
 <html><head><meta charset="utf-8"><title>Stackable CLI</title>
@@ -2247,13 +2382,13 @@ var callbackPage = (heading, sub, redirectUrl) => `<!DOCTYPE html>
 ${redirectUrl ? `<script>(function(){var s=3,el=document.getElementById('h');function t(){if(s<=0){location.href='${redirectUrl}';return}el.textContent='Redirecting in '+s+'s\u2026';s--;setTimeout(t,1000)}t()})()</script>` : ""}
 </body></html>`;
 var AuthLogin = ({ dashboardUrl }) => {
-  const { exit } = useApp2();
-  const [state, setState] = useState11("waiting");
-  const [loginUrl, setLoginUrl] = useState11("");
-  const [userIdLabel, setUserIdLabel] = useState11("");
-  const [orgIdLabel, setOrgIdLabel] = useState11("");
-  const [errorMessage, setErrorMessage] = useState11("");
-  useEffect7(() => {
+  const { exit } = useApp3();
+  const [state, setState] = useState12("waiting");
+  const [loginUrl, setLoginUrl] = useState12("");
+  const [userIdLabel, setUserIdLabel] = useState12("");
+  const [orgIdLabel, setOrgIdLabel] = useState12("");
+  const [errorMessage, setErrorMessage] = useState12("");
+  useEffect8(() => {
     let server;
     let timeout;
     const run = async () => {
@@ -2328,109 +2463,109 @@ var AuthLogin = ({ dashboardUrl }) => {
       server?.close();
     };
   }, []);
-  return /* @__PURE__ */ jsxs16(Box17, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx17(Banner, {}),
-    /* @__PURE__ */ jsxs16(StepShell, { title: "Authenticate with Stackable", children: [
-      state === "waiting" && /* @__PURE__ */ jsxs16(Box17, { flexDirection: "column", gap: 1, children: [
-        /* @__PURE__ */ jsxs16(Box17, { gap: 1, children: [
-          /* @__PURE__ */ jsx17(Text17, { color: "cyan", children: /* @__PURE__ */ jsx17(Spinner4, { type: "dots" }) }),
-          /* @__PURE__ */ jsx17(Text17, { children: "Waiting for browser authentication..." })
+  return /* @__PURE__ */ jsxs17(Box18, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx18(Banner, {}),
+    /* @__PURE__ */ jsxs17(StepShell, { title: "Authenticate with Stackable", children: [
+      state === "waiting" && /* @__PURE__ */ jsxs17(Box18, { flexDirection: "column", gap: 1, children: [
+        /* @__PURE__ */ jsxs17(Box18, { gap: 1, children: [
+          /* @__PURE__ */ jsx18(Text18, { color: "cyan", children: /* @__PURE__ */ jsx18(Spinner5, { type: "dots" }) }),
+          /* @__PURE__ */ jsx18(Text18, { children: "Waiting for browser authentication..." })
         ] }),
-        loginUrl && /* @__PURE__ */ jsxs16(Text17, { dimColor: true, children: [
+        loginUrl && /* @__PURE__ */ jsxs17(Text18, { dimColor: true, children: [
           "  ",
           loginUrl
         ] })
       ] }),
-      state === "success" && /* @__PURE__ */ jsxs16(Box17, { flexDirection: "column", gap: 1, children: [
-        /* @__PURE__ */ jsxs16(Box17, { flexDirection: "column", children: [
-          /* @__PURE__ */ jsxs16(Box17, { gap: 2, children: [
-            /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: "User:" }),
-            /* @__PURE__ */ jsx17(Text17, { color: "cyan", children: userIdLabel })
+      state === "success" && /* @__PURE__ */ jsxs17(Box18, { flexDirection: "column", gap: 1, children: [
+        /* @__PURE__ */ jsxs17(Box18, { flexDirection: "column", children: [
+          /* @__PURE__ */ jsxs17(Box18, { gap: 2, children: [
+            /* @__PURE__ */ jsx18(Text18, { dimColor: true, children: "User:" }),
+            /* @__PURE__ */ jsx18(Text18, { color: "cyan", children: userIdLabel })
           ] }),
-          /* @__PURE__ */ jsxs16(Box17, { gap: 2, children: [
-            /* @__PURE__ */ jsx17(Text17, { dimColor: true, children: "Org: " }),
-            /* @__PURE__ */ jsx17(Text17, { color: "cyan", children: orgIdLabel })
+          /* @__PURE__ */ jsxs17(Box18, { gap: 2, children: [
+            /* @__PURE__ */ jsx18(Text18, { dimColor: true, children: "Org: " }),
+            /* @__PURE__ */ jsx18(Text18, { color: "cyan", children: orgIdLabel })
           ] })
         ] }),
-        /* @__PURE__ */ jsxs16(Box17, { gap: 1, children: [
-          /* @__PURE__ */ jsx17(Text17, { color: "green", bold: true, children: "\u2714" }),
-          /* @__PURE__ */ jsx17(Text17, { bold: true, children: "Authenticated" })
+        /* @__PURE__ */ jsxs17(Box18, { gap: 1, children: [
+          /* @__PURE__ */ jsx18(Text18, { color: "green", bold: true, children: "\u2714" }),
+          /* @__PURE__ */ jsx18(Text18, { bold: true, children: "Authenticated" })
         ] })
       ] }),
-      state === "error" && /* @__PURE__ */ jsxs16(Box17, { gap: 1, children: [
-        /* @__PURE__ */ jsx17(Text17, { color: "red", children: "\u2716" }),
-        /* @__PURE__ */ jsx17(Text17, { children: errorMessage })
+      state === "error" && /* @__PURE__ */ jsxs17(Box18, { gap: 1, children: [
+        /* @__PURE__ */ jsx18(Text18, { color: "red", children: "\u2716" }),
+        /* @__PURE__ */ jsx18(Text18, { children: errorMessage })
       ] })
     ] })
   ] });
 };
 
 // src/components/AuthLogout.tsx
-import { useEffect as useEffect8 } from "react";
-import { Box as Box18, Text as Text18, useApp as useApp3 } from "ink";
-import { jsx as jsx18, jsxs as jsxs17 } from "react/jsx-runtime";
+import { useEffect as useEffect9 } from "react";
+import { Box as Box19, Text as Text19, useApp as useApp4 } from "ink";
+import { jsx as jsx19, jsxs as jsxs18 } from "react/jsx-runtime";
 var AuthLogout = () => {
-  const { exit } = useApp3();
-  useEffect8(() => {
+  const { exit } = useApp4();
+  useEffect9(() => {
     exit();
   }, [exit]);
-  return /* @__PURE__ */ jsxs17(Box18, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx18(Banner, {}),
-    /* @__PURE__ */ jsx18(StepShell, { title: "Authenticate with Stackable", children: /* @__PURE__ */ jsxs17(Box18, { gap: 1, children: [
-      /* @__PURE__ */ jsx18(Text18, { color: "green", bold: true, children: "\u2714" }),
-      /* @__PURE__ */ jsx18(Text18, { bold: true, children: "Logged out" })
+  return /* @__PURE__ */ jsxs18(Box19, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx19(Banner, {}),
+    /* @__PURE__ */ jsx19(StepShell, { title: "Authenticate with Stackable", children: /* @__PURE__ */ jsxs18(Box19, { gap: 1, children: [
+      /* @__PURE__ */ jsx19(Text19, { color: "green", bold: true, children: "\u2714" }),
+      /* @__PURE__ */ jsx19(Text19, { bold: true, children: "Logged out" })
     ] }) })
   ] });
 };
 
 // src/components/AuthStatus.tsx
-import { useEffect as useEffect9 } from "react";
-import { Box as Box19, Text as Text19, useApp as useApp4 } from "ink";
-import { jsx as jsx19, jsxs as jsxs18 } from "react/jsx-runtime";
+import { useEffect as useEffect10 } from "react";
+import { useApp as useApp5, Box as Box20, Text as Text20 } from "ink";
+import { jsx as jsx20, jsxs as jsxs19 } from "react/jsx-runtime";
 var AuthStatus = ({ state, userId, orgId, expiry }) => {
-  const { exit } = useApp4();
-  useEffect9(() => {
+  const { exit } = useApp5();
+  useEffect10(() => {
     exit();
   }, [exit]);
-  return /* @__PURE__ */ jsxs18(Box19, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx19(Banner, {}),
-    /* @__PURE__ */ jsxs18(StepShell, { title: "Authenticate with Stackable", children: [
-      state === "authenticated" && /* @__PURE__ */ jsxs18(Box19, { flexDirection: "column", gap: 1, children: [
-        /* @__PURE__ */ jsxs18(Box19, { flexDirection: "column", children: [
-          /* @__PURE__ */ jsxs18(Box19, { gap: 2, children: [
-            /* @__PURE__ */ jsx19(Text19, { dimColor: true, children: "User:" }),
-            /* @__PURE__ */ jsx19(Text19, { color: "cyan", children: userId })
+  return /* @__PURE__ */ jsxs19(Box20, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx20(Banner, {}),
+    /* @__PURE__ */ jsxs19(StepShell, { title: "Authenticate with Stackable", children: [
+      state === "authenticated" && /* @__PURE__ */ jsxs19(Box20, { flexDirection: "column", gap: 1, children: [
+        /* @__PURE__ */ jsxs19(Box20, { flexDirection: "column", children: [
+          /* @__PURE__ */ jsxs19(Box20, { gap: 2, children: [
+            /* @__PURE__ */ jsx20(Text20, { dimColor: true, children: "User:" }),
+            /* @__PURE__ */ jsx20(Text20, { color: "cyan", children: userId })
           ] }),
-          /* @__PURE__ */ jsxs18(Box19, { gap: 2, children: [
-            /* @__PURE__ */ jsx19(Text19, { dimColor: true, children: "Org: " }),
-            /* @__PURE__ */ jsx19(Text19, { color: "cyan", children: orgId })
+          /* @__PURE__ */ jsxs19(Box20, { gap: 2, children: [
+            /* @__PURE__ */ jsx20(Text20, { dimColor: true, children: "Org: " }),
+            /* @__PURE__ */ jsx20(Text20, { color: "cyan", children: orgId })
           ] }),
-          expiry && /* @__PURE__ */ jsxs18(Box19, { gap: 2, children: [
-            /* @__PURE__ */ jsx19(Text19, { dimColor: true, children: "Exp: " }),
-            /* @__PURE__ */ jsx19(Text19, { color: "cyan", children: expiry.toLocaleDateString() })
+          expiry && /* @__PURE__ */ jsxs19(Box20, { gap: 2, children: [
+            /* @__PURE__ */ jsx20(Text20, { dimColor: true, children: "Exp: " }),
+            /* @__PURE__ */ jsx20(Text20, { color: "cyan", children: expiry.toLocaleDateString() })
           ] })
         ] }),
-        /* @__PURE__ */ jsxs18(Box19, { gap: 1, children: [
-          /* @__PURE__ */ jsx19(Text19, { color: "green", bold: true, children: "\u2714" }),
-          /* @__PURE__ */ jsx19(Text19, { bold: true, children: "Authenticated" })
+        /* @__PURE__ */ jsxs19(Box20, { gap: 1, children: [
+          /* @__PURE__ */ jsx20(Text20, { color: "green", bold: true, children: "\u2714" }),
+          /* @__PURE__ */ jsx20(Text20, { bold: true, children: "Authenticated" })
         ] })
       ] }),
-      state === "expired" && /* @__PURE__ */ jsxs18(Box19, { flexDirection: "column", gap: 1, children: [
-        /* @__PURE__ */ jsxs18(Box19, { gap: 1, children: [
-          /* @__PURE__ */ jsx19(Text19, { color: "red", children: "\u2716" }),
-          /* @__PURE__ */ jsxs18(Text19, { children: [
+      state === "expired" && /* @__PURE__ */ jsxs19(Box20, { flexDirection: "column", gap: 1, children: [
+        /* @__PURE__ */ jsxs19(Box20, { gap: 1, children: [
+          /* @__PURE__ */ jsx20(Text20, { color: "red", children: "\u2716" }),
+          /* @__PURE__ */ jsxs19(Text20, { children: [
             "Session expired",
             expiry ? ` (${expiry.toLocaleDateString()})` : ""
           ] })
         ] }),
-        /* @__PURE__ */ jsx19(Text19, { dimColor: true, children: "Run `stackable-app-extension auth login` to re-authenticate." })
+        /* @__PURE__ */ jsx20(Text20, { dimColor: true, children: "Run `stackable-app-extension auth login` to re-authenticate." })
       ] }),
-      state === "not-logged-in" && /* @__PURE__ */ jsxs18(Box19, { flexDirection: "column", gap: 1, children: [
-        /* @__PURE__ */ jsxs18(Box19, { gap: 1, children: [
-          /* @__PURE__ */ jsx19(Text19, { color: "red", children: "\u2716" }),
-          /* @__PURE__ */ jsx19(Text19, { children: "Not logged in" })
+      state === "not-logged-in" && /* @__PURE__ */ jsxs19(Box20, { flexDirection: "column", gap: 1, children: [
+        /* @__PURE__ */ jsxs19(Box20, { gap: 1, children: [
+          /* @__PURE__ */ jsx20(Text20, { color: "red", children: "\u2716" }),
+          /* @__PURE__ */ jsx20(Text20, { children: "Not logged in" })
         ] }),
-        /* @__PURE__ */ jsx19(Text19, { dimColor: true, children: "Run `stackable-app-extension auth login`" })
+        /* @__PURE__ */ jsx20(Text20, { dimColor: true, children: "Run `stackable-app-extension auth login`" })
       ] })
     ] })
   ] });
@@ -2484,7 +2619,7 @@ var checkForUpdate = (currentVersion) => {
 };
 
 // src/index.tsx
-import { jsx as jsx20 } from "react/jsx-runtime";
+import { jsx as jsx21 } from "react/jsx-runtime";
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
 checkForUpdate(version);
@@ -2496,7 +2631,9 @@ var ensureToken = async () => {
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     const isExpired = message.toLowerCase().includes("expired");
-    render(/* @__PURE__ */ jsx20(AuthStatus, { state: isExpired ? "expired" : "not-logged-in" }));
+    render(
+      /* @__PURE__ */ jsx21(AuthStatus, { state: isExpired ? "expired" : "not-logged-in" })
+    );
     return null;
   }
 };
@@ -2507,7 +2644,19 @@ program.command("create" /* CREATE */).description("Create a new Extension proje
     return;
   }
   const { token, userId, orgId } = auth2;
-  render(/* @__PURE__ */ jsx20(App, { command: "create" /* CREATE */, initialName: name, options, token, userId, orgId }));
+  render(
+    /* @__PURE__ */ jsx21(
+      App,
+      {
+        command: "create" /* CREATE */,
+        initialName: name,
+        options,
+        token,
+        orgId,
+        userId
+      }
+    )
+  );
 });
 program.command("scaffold" /* SCAFFOLD */).description("Scaffold a local project from an existing Extension").option("--extension-port <port>", "Extension dev server port (default: 6543)").option("--preview-port <port>", "Preview dev server port").option("--skip-install", "Skip package manager install").option("--skip-git", "Skip git initialization").action(async (options) => {
   const auth2 = await ensureToken();
@@ -2515,7 +2664,18 @@ program.command("scaffold" /* SCAFFOLD */).description("Scaffold a local project
     return;
   }
   const { token, userId, orgId } = auth2;
-  render(/* @__PURE__ */ jsx20(App, { command: "scaffold" /* SCAFFOLD */, options, token, userId, orgId }));
+  render(
+    /* @__PURE__ */ jsx21(
+      App,
+      {
+        command: "scaffold" /* SCAFFOLD */,
+        options,
+        token,
+        orgId,
+        userId
+      }
+    )
+  );
 });
 program.command("update" /* UPDATE */).description("Update an existing Extension").argument("[extensionId]", "Extension ID to update").option("--app-id <id>", "Skip App selection").option("--name <name>", "New Extension name").option("--targets <targets>", "Comma-separated target slots (validated against app)").option("--bundle-url <url>", "New bundle URL").option("--enabled <bool>", "Enable/disable Extension").option("--set-version <version>", "Explicit version (skips auto-compute)").action(async (extensionId, options) => {
   const auth2 = await ensureToken();
@@ -2523,7 +2683,19 @@ program.command("update" /* UPDATE */).description("Update an existing Extension
     return;
   }
   const { token, userId, orgId } = auth2;
-  render(/* @__PURE__ */ jsx20(App, { command: "update" /* UPDATE */, initialExtensionId: extensionId, options, token, userId, orgId }));
+  render(
+    /* @__PURE__ */ jsx21(
+      App,
+      {
+        command: "update" /* UPDATE */,
+        initialExtensionId: extensionId,
+        options,
+        token,
+        userId,
+        orgId
+      }
+    )
+  );
 });
 program.command("dev" /* DEV */).description("Start dev servers with a public tunnel").option("--dir <path>", "Project root (default: cwd)").option("--extension-port <port>", "Override Extension port").option("--preview-port <port>", "Override Preview port").option("--no-tunnel", "Skip tunnel, just run vite dev").action(async (options) => {
   const auth2 = await ensureToken();
@@ -2531,30 +2703,57 @@ program.command("dev" /* DEV */).description("Start dev servers with a public tu
     return;
   }
   const { token, userId, orgId } = auth2;
-  render(/* @__PURE__ */ jsx20(DevApp, { options, token, userId, orgId }), { exitOnCtrlC: false });
+  render(
+    /* @__PURE__ */ jsx21(
+      DevApp,
+      {
+        options,
+        token,
+        userId,
+        orgId
+      }
+    ),
+    { exitOnCtrlC: false }
+  );
 });
 var DASHBOARD_URL = process.env.ADMIN_DASHBOARD_URL ?? "https://admin.stackablelabs.io";
 var auth = program.command("auth").description("Manage CLI authentication");
 auth.command("login").description("Authenticate with Stackable via browser").action(async () => {
-  render(/* @__PURE__ */ jsx20(AuthLogin, { dashboardUrl: DASHBOARD_URL }));
+  render(/* @__PURE__ */ jsx21(AuthLogin, { dashboardUrl: DASHBOARD_URL }));
 });
 auth.command("logout").description("Clear stored CLI credentials").action(async () => {
   await clearAuthState();
-  render(/* @__PURE__ */ jsx20(AuthLogout, {}));
+  render(/* @__PURE__ */ jsx21(AuthLogout, {}));
 });
 auth.command("status").description("Show current authentication status").action(async () => {
   const state = await readAuthState();
   if (!state) {
-    render(/* @__PURE__ */ jsx20(AuthStatus, { state: "not-logged-in" }));
+    render(
+      /* @__PURE__ */ jsx21(AuthStatus, { state: "not-logged-in" })
+    );
     return;
   }
   const [, payloadB64] = state.token.split(".");
   const payload = JSON.parse(Buffer.from(payloadB64, "base64url").toString());
   const expiry = payload.exp ? new Date(payload.exp * 1e3) : null;
   if (expiry && Date.now() >= expiry.getTime()) {
-    render(/* @__PURE__ */ jsx20(AuthStatus, { state: "expired", expiry }));
+    render(/* @__PURE__ */ jsx21(AuthStatus, { state: "expired", expiry }));
     return;
   }
-  render(/* @__PURE__ */ jsx20(AuthStatus, { state: "authenticated", userId: state.userId, orgId: state.orgId, expiry }));
+  render(
+    /* @__PURE__ */ jsx21(
+      AuthStatus,
+      {
+        state: "authenticated",
+        userId: state.userId,
+        orgId: state.orgId,
+        expiry
+      }
+    )
+  );
+});
+var ai = program.command("ai").description("AI editor configuration tools");
+ai.command("scaffold").description("Download AI editor config files into your Extension project").option("--version <version>", 'AI docs version (semver or "latest")', "latest").action(async (options) => {
+  render(/* @__PURE__ */ jsx21(AIScaffold, { version: options.version }));
 });
 program.parse(process.argv.filter((arg) => arg !== "--"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackable-labs/cli-app-extension",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "type": "module",
   "private": false,
   "bin": {
@@ -12,6 +12,8 @@
     "LICENSE"
   ],
   "dependencies": {
+    "@stackable-labs/lib-contracts": "workspace:*",
+    "adm-zip": "0.x",
     "cloudflared": "0.x",
     "commander": "12.x",
     "giget": "3.x",