@lotics/cli 0.39.0 → 0.41.0

package/dist/app_commands.js

@@ -92,10 +92,7 @@ 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,
     };
 }
 function writeAppMeta(projectDir, meta) {
@@ -345,10 +342,11 @@ 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):
+                // 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.
                 force_workflow_sync: args.forceWorkflowSync,
@@ -360,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;
@@ -378,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
@@ -155,8 +161,10 @@ export declare class LoticsClient {
         offset?: number;
         sort?: AppQuerySortKey[];
         filter?: AppQueryFilter;
+        count?: boolean;
     }): Promise<{
         rows: unknown[];
+        total?: number;
     }>;
     appMembers(app_id: string, group_id?: string): Promise<{
         members: Array<{
@@ -231,13 +239,14 @@ export declare class LoticsClient {
             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.
+         * Opt-in app capabilities from `package.json#lotics.capabilities`. The CLI
+         * sends this on every deploy (defaulting to `{}`): the manifest is
+         * authoritative, so an empty/absent block turns every capability off.
+         * `comments: true` enables the members-only `useComments` primitive.
          */
-        icon?: string;
-        theme?: Record<string, unknown>;
+        capabilities?: {
+            comments?: boolean;
+        };
         /**
          * Opt into destructive workflow removal. When false/absent, the server
          * rejects a deploy whose `workflows` map is missing aliases that exist

package/dist/client.js

@@ -220,15 +220,11 @@ 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.
+        if (args.capabilities !== undefined) {
+            formData.append("capabilities", JSON.stringify(args.capabilities));
         }
         // Only post the override flag when the user explicitly opts in. The
         // server defaults to "honor the guard" — opt-in is loud, opt-out

package/dist/dev/rpc_handler.js

@@ -32,6 +32,7 @@ export async function dispatchRpc(client, body) {
                 offset: p.offset,
                 sort: p.sort,
                 filter: p.filter,
+                count: p.count,
             });
         }
         case "workflow": {