@lotics/cli 0.40.0 → 0.41.0

package/dist/app_commands.js

@@ -92,10 +92,6 @@ function readAppMeta(projectDir) {
         version_number: pkg.lotics.version_number ?? null,
         workflows: pkg.lotics.workflows ?? {},
         queries: pkg.lotics.queries ?? {},
-        // Left as `undefined` when absent so the deploy omits them and the
-        // App row's icon/theme is preserved.
-        icon: pkg.lotics.icon,
-        theme: pkg.lotics.theme,
         capabilities: pkg.lotics.capabilities,
     };
 }
@@ -346,15 +342,10 @@ export async function appDeploy(client, args) {
                 // Sync apps.queries from the manifest. Server validates each query
                 // template (parseQueryNode, table access, param coverage).
                 queries: meta.queries ?? {},
-                // Optional icon/theme overrides — only sent when the manifest
-                // declares them (undefined ⇒ omitted ⇒ App row left untouched).
-                icon: meta.icon,
-                theme: meta.theme,
-                // Capabilities are manifest-authoritative (like workflows/queries, not
-                // like icon/theme): always send, defaulting to `{}` when the manifest
-                // declares none — so deleting the `capabilities` block turns every
-                // capability OFF on the next deploy (fail-safe; the declaration is the
-                // grant). The manifest is the only writer of capabilities.
+                // Capabilities are manifest-authoritative (like workflows/queries):
+                // always send, defaulting to `{}` when the manifest declares none — so
+                // deleting the `capabilities` block turns every capability OFF on the
+                // next deploy (fail-safe; the declaration is the grant).
                 capabilities: meta.capabilities ?? {},
                 // Opt into destructive workflow removal. Default false — the server
                 // rejects deploys whose manifest is missing aliases the App row has.
@@ -367,6 +358,7 @@ export async function appDeploy(client, args) {
             });
             console.error(`Deployed v${result.version_number} (${result.version_id})`);
             console.error(`Bundle size: ${(result.bundle_size_bytes / 1024).toFixed(1)} KB`);
+            await warnIfUnbranded(client, meta.app_id);
         }
         catch (err) {
             const e = err;
@@ -385,6 +377,30 @@ export async function appDeploy(client, args) {
             fs.unlinkSync(tmpDist);
     }
 }
+/**
+ * Non-blocking nudge after a successful deploy: an app with no icon/color shows a
+ * generic tile in the launcher. Branding is set via `update_app` (the single
+ * setter) — this only reminds; it never fails the deploy.
+ */
+async function warnIfUnbranded(client, appId) {
+    try {
+        const app = await client.getApp(appId);
+        const missing = [];
+        if (!app.icon)
+            missing.push("icon");
+        if (!app.theme?.color)
+            missing.push("color");
+        if (missing.length === 0)
+            return;
+        console.error(`\n⚠ This app has no ${missing.join(" or ")} set — it shows a generic tile in the launcher.\n` +
+            `  Set it:  lotics run update_app '{"app_id":"${appId}","icon":"<lucide-name>","theme":{"color":"blue"}}'\n` +
+            `  Find an icon:  lotics run search_app_icons '{"query":"<word>"}'`);
+    }
+    catch (err) {
+        // Deploy already succeeded; a failed branding check must not mask that.
+        console.error(`(skipped branding check: ${err.message})`);
+    }
+}
 /**
  * `lotics app dev [path] [--port=5174] [--vite-port=5173]`
  *

package/dist/client.d.ts

@@ -96,6 +96,12 @@ export declare class LoticsClient {
         name: string;
         workspace_id: string;
         current_version_id: string | null;
+        /** Launcher icon — a Lucide name, or an image ref. Null when unset. */
+        icon?: string | null;
+        /** Launcher theme — `{ color }` is a palette token. Null when unset. */
+        theme?: {
+            color?: string | null;
+        } | null;
         /**
          * Live alias → workflow declaration map from `apps.workflows`. Source of
          * truth for `lotics app pull` — supersedes the manifest embedded in the
@@ -232,14 +238,6 @@ export declare class LoticsClient {
             ast: unknown;
             params?: Record<string, unknown>;
         }>;
-        /**
-         * App icon (Lucide name) + theme `{ color }` from `package.json#lotics`.
-         * `undefined` ⇒ not sent ⇒ the deploy leaves the App row's icon/theme
-         * as-is. A present value is applied authoritatively. `icon` rides as a
-         * raw form field; `theme` is an object, so it's JSON-encoded.
-         */
-        icon?: string;
-        theme?: Record<string, unknown>;
         /**
          * Opt-in app capabilities from `package.json#lotics.capabilities`. The CLI
          * sends this on every deploy (defaulting to `{}`): the manifest is

package/dist/client.js

@@ -220,16 +220,6 @@ export class LoticsClient {
         // Always send queries — empty object clears any previously-declared
         // named queries. Server validates each template.
         formData.append("queries", JSON.stringify(args.queries ?? {}));
-        // icon/theme are optional overrides — only sent when the manifest
-        // declares them, so a deploy never clobbers a value set in the UI.
-        // `icon` is a plain string → raw field, like `message`. `theme` is an
-        // object → JSON-encoded, like `workflows`/`queries`.
-        if (args.icon !== undefined) {
-            formData.append("icon", args.icon);
-        }
-        if (args.theme !== undefined) {
-            formData.append("theme", JSON.stringify(args.theme));
-        }
         // capabilities is manifest-authoritative — the caller always passes it
         // (`{}` when none declared), so a deploy turns off any capability the
         // manifest no longer declares. JSON-encoded.

package/dist/src/cli.js

@@ -29814,12 +29814,6 @@ var LoticsClient = class {
     }
     formData.append("workflows", JSON.stringify(args.workflows ?? {}));
     formData.append("queries", JSON.stringify(args.queries ?? {}));
-    if (args.icon !== void 0) {
-      formData.append("icon", args.icon);
-    }
-    if (args.theme !== void 0) {
-      formData.append("theme", JSON.stringify(args.theme));
-    }
     if (args.capabilities !== void 0) {
       formData.append("capabilities", JSON.stringify(args.capabilities));
     }
@@ -31239,10 +31233,6 @@ function readAppMeta(projectDir) {
     version_number: pkg2.lotics.version_number ?? null,
     workflows: pkg2.lotics.workflows ?? {},
     queries: pkg2.lotics.queries ?? {},
-    // Left as `undefined` when absent so the deploy omits them and the
-    // App row's icon/theme is preserved.
-    icon: pkg2.lotics.icon,
-    theme: pkg2.lotics.theme,
     capabilities: pkg2.lotics.capabilities
   };
 }
@@ -31417,15 +31407,10 @@ async function appDeploy(client, args) {
         // Sync apps.queries from the manifest. Server validates each query
         // template (parseQueryNode, table access, param coverage).
         queries: meta.queries ?? {},
-        // Optional icon/theme overrides — only sent when the manifest
-        // declares them (undefined ⇒ omitted ⇒ App row left untouched).
-        icon: meta.icon,
-        theme: meta.theme,
-        // Capabilities are manifest-authoritative (like workflows/queries, not
-        // like icon/theme): always send, defaulting to `{}` when the manifest
-        // declares none — so deleting the `capabilities` block turns every
-        // capability OFF on the next deploy (fail-safe; the declaration is the
-        // grant). The manifest is the only writer of capabilities.
+        // Capabilities are manifest-authoritative (like workflows/queries):
+        // always send, defaulting to `{}` when the manifest declares none — so
+        // deleting the `capabilities` block turns every capability OFF on the
+        // next deploy (fail-safe; the declaration is the grant).
         capabilities: meta.capabilities ?? {},
         // Opt into destructive workflow removal. Default false — the server
         // rejects deploys whose manifest is missing aliases the App row has.
@@ -31438,6 +31423,7 @@ async function appDeploy(client, args) {
       });
       console.error(`Deployed v${result.version_number} (${result.version_id})`);
       console.error(`Bundle size: ${(result.bundle_size_bytes / 1024).toFixed(1)} KB`);
+      await warnIfUnbranded(client, meta.app_id);
     } catch (err2) {
       const e = err2;
       if (e.code === "VERSION_CONFLICT") {
@@ -31453,6 +31439,23 @@ async function appDeploy(client, args) {
     if (fs3.existsSync(tmpDist)) fs3.unlinkSync(tmpDist);
   }
 }
+async function warnIfUnbranded(client, appId) {
+  try {
+    const app = await client.getApp(appId);
+    const missing = [];
+    if (!app.icon) missing.push("icon");
+    if (!app.theme?.color) missing.push("color");
+    if (missing.length === 0) return;
+    console.error(
+      `
+\u26A0 This app has no ${missing.join(" or ")} set \u2014 it shows a generic tile in the launcher.
+  Set it:  lotics run update_app '{"app_id":"${appId}","icon":"<lucide-name>","theme":{"color":"blue"}}'
+  Find an icon:  lotics run search_app_icons '{"query":"<word>"}'`
+    );
+  } catch (err2) {
+    console.error(`(skipped branding check: ${err2.message})`);
+  }
+}
 async function appDev(client, args) {
   const projectDir = path4.resolve(args.projectDir ?? process.cwd());
   const meta = readAppMeta(projectDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.40.0",
+  "version": "0.41.0",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {