@lotics/cli 0.46.0 → 0.48.0

package/dist/app_commands.d.ts

@@ -119,7 +119,6 @@ export declare function undeclaredCapabilities(sourceText: string, declared: Rec
 export declare function appDeploy(client: LoticsClient, args: {
     projectDir?: string;
     message?: string;
-    forceWorkflowSync?: boolean;
 }): Promise<void>;
 /**
  * `lotics app dev [path] [--port=5174] [--vite-port=5173]`

package/dist/app_commands.js

@@ -388,20 +388,17 @@ export async function appDeploy(client, args) {
                 dist_archive: fs.readFileSync(tmpDist),
                 prev_version_id: meta.current_version_id,
                 message: args.message,
-                // Sync apps.workflows from the manifest. Server validates each
-                // workflow_id exists in the workspace before committing.
-                workflows: meta.workflows ?? {},
                 // Sync apps.queries from the manifest. Server validates each query
                 // template (parseQueryNode, table access, param coverage).
                 queries: meta.queries ?? {},
-                // 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 are manifest-authoritative (like 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,
+                // Workflow bindings are NOT a deploy concern — set_app_workflow /
+                // remove_app_workflow own apps.workflows. The manifest's `workflows`
+                // map is a pulled reflection used only for the .d.ts codegen above.
             });
             writeAppMeta(projectDir, {
                 ...meta,

package/dist/args.d.ts

@@ -4,8 +4,8 @@
  * Splits `process.argv.slice(2)` into a command / subcommand / positional
  * (`toolArgs`) / remaining-positionals (`restArgs`) shape plus typed `flags`.
  * Value-taking flags (`-m`, `--api-key`, …) consume the next token; boolean
- * flags (`--force-workflow-sync`, `--json`, …) toggle. Anything not matching a
- * known flag is positional.
+ * flags (`--json`, `--local`, …) toggle. Anything not matching a known flag is
+ * positional.
  *
  * Lives apart from `cli.ts` so it can be unit-tested — `cli.ts` runs `main()`
  * on import, so importing the parser from there would execute the CLI.
@@ -26,7 +26,6 @@ export declare function parseArgs(argv: string[]): {
         name?: string;
         timezone?: string;
         message?: string;
-        forceWorkflowSync: boolean;
         local: boolean;
         all: boolean;
         version: boolean;

package/dist/args.js

@@ -4,8 +4,8 @@
  * Splits `process.argv.slice(2)` into a command / subcommand / positional
  * (`toolArgs`) / remaining-positionals (`restArgs`) shape plus typed `flags`.
  * Value-taking flags (`-m`, `--api-key`, …) consume the next token; boolean
- * flags (`--force-workflow-sync`, `--json`, …) toggle. Anything not matching a
- * known flag is positional.
+ * flags (`--json`, `--local`, …) toggle. Anything not matching a known flag is
+ * positional.
  *
  * Lives apart from `cli.ts` so it can be unit-tested — `cli.ts` runs `main()`
  * on import, so importing the parser from there would execute the CLI.
@@ -22,7 +22,6 @@ export function parseArgs(argv) {
         name: undefined,
         timezone: undefined,
         message: undefined,
-        forceWorkflowSync: false,
         local: false,
         all: false,
         version: false,
@@ -69,9 +68,6 @@ export function parseArgs(argv) {
             case "--message":
                 flags.message = argv[++i];
                 break;
-            case "--force-workflow-sync":
-                flags.forceWorkflowSync = true;
-                break;
             case "--local":
                 flags.local = true;
                 break;

package/dist/args.test.js

@@ -8,8 +8,8 @@ describe("parseArgs", () => {
         expect(r.toolArgs).toBe("my message");
         expect(r.restArgs).toEqual([]);
     });
-    // `app deploy` regression: `-m` and `--force-workflow-sync` must be parsed
-    // as flags, not silently consumed as the positional message.
+    // `app deploy` regression: `-m` must be parsed as a flag, not silently
+    // consumed as the positional message.
     it("parses -m as the message flag", () => {
         const r = parseArgs(["app", "deploy", "-m", "a message"]);
         expect(r.flags.message).toBe("a message");
@@ -19,19 +19,8 @@ describe("parseArgs", () => {
         const r = parseArgs(["app", "deploy", "--message", "a message"]);
         expect(r.flags.message).toBe("a message");
     });
-    it("parses --force-workflow-sync as a boolean flag", () => {
-        const r = parseArgs(["app", "deploy", "msg", "--force-workflow-sync"]);
-        expect(r.flags.forceWorkflowSync).toBe(true);
-        expect(r.toolArgs).toBe("msg");
-    });
-    it("parses --force-workflow-sync before -m without eating the message", () => {
-        const r = parseArgs(["app", "deploy", "--force-workflow-sync", "-m", "msg"]);
-        expect(r.flags.forceWorkflowSync).toBe(true);
-        expect(r.flags.message).toBe("msg");
-    });
-    it("defaults forceWorkflowSync to false and message to undefined", () => {
+    it("defaults message to undefined for a bare deploy", () => {
         const r = parseArgs(["app", "deploy"]);
-        expect(r.flags.forceWorkflowSync).toBe(false);
         expect(r.flags.message).toBeUndefined();
     });
     it("parses --workspace as a value flag", () => {

package/dist/cli.js

@@ -60,10 +60,9 @@ COMMANDS
                                        Download all files on a record file field
   lotics app create <name> [path]      Create a new custom-code app + scaffold locally
   lotics app pull <app_id> [path]      Bootstrap full local env (source + npm install + types)
-  lotics app deploy [-m <message>] [--force-workflow-sync]
-                                       Build + upload current dir as a new version
-                                       (--force-workflow-sync wipes server-only
-                                       workflow aliases; default refuses)
+  lotics app deploy [-m <message>]     Build + upload current dir as a new version
+                                       (code + queries only — workflow bindings are
+                                       managed by set_app_workflow / remove_app_workflow)
   lotics app subdomain <new-subdomain> Rename the app's public <slug>.lotics.app address
   lotics app rename "<new name>"       Rename the app's display name (launcher title)
   lotics app dev [path]                Run the app locally with HMR (RPC forwarded to prod)
@@ -527,8 +526,7 @@ async function main() {
         console.error("Usage:");
         console.error("  lotics app create <name> [path]      Scaffold a new app locally");
         console.error("  lotics app pull <app_id> [path]      Pull an existing app for local editing");
-        console.error("  lotics app deploy [-m <message>] [--force-workflow-sync]");
-        console.error("                                       Build + upload the current directory");
+        console.error("  lotics app deploy [-m <message>]     Build + upload the current directory");
         console.error("  lotics app subdomain <new-subdomain> Rename the app's public <slug>.lotics.app address");
         console.error("  lotics app rename \"<new name>\"        Rename the app's display name (launcher title)");
         console.error("  lotics app dev [path]                Run the app locally with HMR + RPC forwarding");
@@ -650,11 +648,9 @@ async function main() {
             return;
         }
         if (subcommand === "deploy") {
-            // The message is either `-m <message>` or a bare positional arg after
-            // `deploy`. `--force-workflow-sync` is a parsed boolean flag, valid in
-            // any position.
+            // The message is either `-m <message>` or a bare positional arg after `deploy`.
             const message = flags.message ?? toolArgs;
-            await appDeploy(client, { message, forceWorkflowSync: flags.forceWorkflowSync });
+            await appDeploy(client, { message });
             return;
         }
         if (subcommand === "subdomain") {

package/dist/client.d.ts

@@ -183,6 +183,21 @@ export declare class LoticsClient {
             image: string | null;
         }>;
     }>;
+    /**
+     * Resolve the full option set (key, label, color) of a named query's select
+     * columns — the picker companion to `appQuery`. Mirrors
+     * POST /v1/apps/{app_id}/field-options.
+     */
+    appFieldOptions(app_id: string, alias: string): Promise<{
+        fields: Record<string, {
+            label: string;
+            options: Array<{
+                key: string;
+                label: string;
+                color: string;
+            }>;
+        }>;
+    }>;
     /**
      * Execute a workflow by alias declared in package.json#lotics.workflows.
      * Mirrors POST /v1/apps/{app_id}/workflows/{alias}/execute.
@@ -235,19 +250,6 @@ export declare class LoticsClient {
         dist_archive: Buffer;
         prev_version_id?: string | null;
         message?: string | null;
-        /**
-         * Alias → workflow declaration map from the app's `package.json#lotics.workflows`.
-         * Each value is a `{ workflow_id, inputs? }` object — inputs declares a typed
-         * schema or is omitted when the workflow accepts no typed inputs. Always sent
-         * (empty object when none declared) so the server can overwrite apps.workflows
-         * authoritatively. Deleting an alias from the manifest removes it from the DB
-         * on next deploy — gated by the destructive-removal guard unless
-         * `force_workflow_sync` is true.
-         */
-        workflows?: Record<string, {
-            workflow_id: string;
-            inputs?: Record<string, unknown>;
-        }>;
         /**
          * Alias → query declaration map from `package.json#lotics.queries`. Each
          * value is `{ ast, params? }` — a fixed query AST template and an optional
@@ -267,14 +269,6 @@ export declare class LoticsClient {
         capabilities?: {
             comments?: boolean;
         };
-        /**
-         * Opt into destructive workflow removal. When false/absent, the server
-         * rejects a deploy whose `workflows` map is missing aliases that exist
-         * on the App row. Set true to deploy anyway and wipe the missing aliases —
-         * the user is asserting they know what they're doing. Wired to CLI flag
-         * `--force-workflow-sync`.
-         */
-        force_workflow_sync?: boolean;
     }): Promise<{
         version_id: string;
         version_number: number;

package/dist/client.js

@@ -187,6 +187,14 @@ export class LoticsClient {
         const qs = group_id ? `?group_id=${encodeURIComponent(group_id)}` : "";
         return this.request("GET", `/v1/apps/${encodeURIComponent(app_id)}/members${qs}`);
     }
+    /**
+     * Resolve the full option set (key, label, color) of a named query's select
+     * columns — the picker companion to `appQuery`. Mirrors
+     * POST /v1/apps/{app_id}/field-options.
+     */
+    async appFieldOptions(app_id, alias) {
+        return this.request("POST", `/v1/apps/${encodeURIComponent(app_id)}/field-options`, { alias });
+    }
     /**
      * Execute a workflow by alias declared in package.json#lotics.workflows.
      * Mirrors POST /v1/apps/{app_id}/workflows/{alias}/execute.
@@ -239,11 +247,9 @@ export class LoticsClient {
         if (args.message) {
             formData.append("message", args.message);
         }
-        // Always send workflows — empty object is meaningful (clears any
-        // previously-declared aliases). Server validates each entry.
-        formData.append("workflows", JSON.stringify(args.workflows ?? {}));
         // Always send queries — empty object clears any previously-declared
-        // named queries. Server validates each template.
+        // named queries. Server validates each template. (Workflow bindings are
+        // not sent: set_app_workflow / remove_app_workflow own apps.workflows.)
         formData.append("queries", JSON.stringify(args.queries ?? {}));
         // capabilities is manifest-authoritative — the caller always passes it
         // (`{}` when none declared), so a deploy turns off any capability the
@@ -251,12 +257,6 @@ export class LoticsClient {
         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
-        // requires intent.
-        if (args.force_workflow_sync) {
-            formData.append("force_workflow_sync", "true");
-        }
         const url = `${this.baseUrl}/v1/apps/${encodeURIComponent(args.app_id)}/versions`;
         const response = await fetch(url, {
             method: "POST",

package/dist/dev/rpc_handler.d.ts

@@ -6,7 +6,7 @@
  * { message }. Same shape as the production iframe-host's error path.
  */
 import { LoticsClient } from "../client.js";
-export type RpcOp = "query" | "workflow" | "members" | "context" | "upload_url" | "upload_complete" | "comments.list" | "comments.create" | "comments.update" | "comments.delete" | "comments.counts";
+export type RpcOp = "query" | "field_options" | "workflow" | "members" | "context" | "upload_url" | "upload_complete" | "comments.list" | "comments.create" | "comments.update" | "comments.delete" | "comments.counts";
 export interface RpcRequest {
     app_id: string;
     op: RpcOp;

package/dist/dev/rpc_handler.js

@@ -7,6 +7,7 @@
  */
 const SUPPORTED_OPS = new Set([
     "query",
+    "field_options",
     "workflow",
     "members",
     "context",
@@ -52,6 +53,13 @@ export async function dispatchRpc(client, body, opts) {
                 count: p.count,
             });
         }
+        case "field_options": {
+            const p = body.payload;
+            if (!p || typeof p.alias !== "string") {
+                throw new Error("field_options payload must include `alias`");
+            }
+            return client.appFieldOptions(body.app_id, p.alias);
+        }
         case "workflow": {
             const p = body.payload;
             if (!p || typeof p.alias !== "string") {

package/dist/dev/rpc_handler.test.js

@@ -27,6 +27,27 @@ describe("dispatchRpc — context op", () => {
         await expect(dispatchRpc(client, { app_id: "app_x", op: "bogus", payload: {} })).rejects.toThrow(/Unknown RPC op/);
     });
 });
+describe("dispatchRpc — field_options op", () => {
+    it("forwards the alias to appFieldOptions and returns its { fields } shape", async () => {
+        const fields = {
+            status: {
+                label: "Status",
+                options: [{ key: "opt_open", label: "Open", color: "blue" }],
+            },
+        };
+        const client = mockClient({ appFieldOptions: async () => ({ fields }) });
+        const result = await dispatchRpc(client, {
+            app_id: "app_x",
+            op: "field_options",
+            payload: { alias: "records" },
+        });
+        expect(result).toEqual({ fields });
+    });
+    it("requires an alias in the payload", async () => {
+        const client = mockClient({ appFieldOptions: async () => ({ fields: {} }) });
+        await expect(dispatchRpc(client, { app_id: "app_x", op: "field_options", payload: {} })).rejects.toThrow(/alias/);
+    });
+});
 describe("dispatchRpc — comment ops", () => {
     it("comments.list forwards to appGetRecordComments, wrapped as { comments }", async () => {
         const comments = [{ id: "cmt_1", content: "hi" }];

package/dist/src/cli.js

@@ -29772,6 +29772,14 @@ var LoticsClient = class {
     const qs = group_id ? `?group_id=${encodeURIComponent(group_id)}` : "";
     return this.request("GET", `/v1/apps/${encodeURIComponent(app_id)}/members${qs}`);
   }
+  /**
+   * Resolve the full option set (key, label, color) of a named query's select
+   * columns — the picker companion to `appQuery`. Mirrors
+   * POST /v1/apps/{app_id}/field-options.
+   */
+  async appFieldOptions(app_id, alias) {
+    return this.request("POST", `/v1/apps/${encodeURIComponent(app_id)}/field-options`, { alias });
+  }
   /**
    * Execute a workflow by alias declared in package.json#lotics.workflows.
    * Mirrors POST /v1/apps/{app_id}/workflows/{alias}/execute.
@@ -29858,14 +29866,10 @@ var LoticsClient = class {
     if (args.message) {
       formData.append("message", args.message);
     }
-    formData.append("workflows", JSON.stringify(args.workflows ?? {}));
     formData.append("queries", JSON.stringify(args.queries ?? {}));
     if (args.capabilities !== void 0) {
       formData.append("capabilities", JSON.stringify(args.capabilities));
     }
-    if (args.force_workflow_sync) {
-      formData.append("force_workflow_sync", "true");
-    }
     const url = `${this.baseUrl}/v1/apps/${encodeURIComponent(args.app_id)}/versions`;
     const response = await fetch(url, {
       method: "POST",
@@ -30724,6 +30728,7 @@ import { spawn } from "node:child_process";
 // src/dev/rpc_handler.ts
 var SUPPORTED_OPS = /* @__PURE__ */ new Set([
   "query",
+  "field_options",
   "workflow",
   "members",
   "context",
@@ -30765,6 +30770,13 @@ async function dispatchRpc(client, body, opts) {
         count: p.count
       });
     }
+    case "field_options": {
+      const p = body.payload;
+      if (!p || typeof p.alias !== "string") {
+        throw new Error("field_options payload must include `alias`");
+      }
+      return client.appFieldOptions(body.app_id, p.alias);
+    }
     case "workflow": {
       const p = body.payload;
       if (!p || typeof p.alias !== "string") {
@@ -31643,20 +31655,17 @@ async function appDeploy(client, args) {
         dist_archive: fs3.readFileSync(tmpDist),
         prev_version_id: meta.current_version_id,
         message: args.message,
-        // Sync apps.workflows from the manifest. Server validates each
-        // workflow_id exists in the workspace before committing.
-        workflows: meta.workflows ?? {},
         // Sync apps.queries from the manifest. Server validates each query
         // template (parseQueryNode, table access, param coverage).
         queries: meta.queries ?? {},
-        // 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
+        // Capabilities are manifest-authoritative (like 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 ?? {}
+        // Workflow bindings are NOT a deploy concern — set_app_workflow /
+        // remove_app_workflow own apps.workflows. The manifest's `workflows`
+        // map is a pulled reflection used only for the .d.ts codegen above.
       });
       writeAppMeta(projectDir, {
         ...meta,
@@ -31756,7 +31765,6 @@ function parseArgs(argv) {
     name: void 0,
     timezone: void 0,
     message: void 0,
-    forceWorkflowSync: false,
     local: false,
     all: false,
     version: false,
@@ -31803,9 +31811,6 @@ function parseArgs(argv) {
       case "--message":
         flags.message = argv[++i2];
         break;
-      case "--force-workflow-sync":
-        flags.forceWorkflowSync = true;
-        break;
       case "--local":
         flags.local = true;
         break;
@@ -47595,10 +47600,9 @@ COMMANDS
                                        Download all files on a record file field
   lotics app create <name> [path]      Create a new custom-code app + scaffold locally
   lotics app pull <app_id> [path]      Bootstrap full local env (source + npm install + types)
-  lotics app deploy [-m <message>] [--force-workflow-sync]
-                                       Build + upload current dir as a new version
-                                       (--force-workflow-sync wipes server-only
-                                       workflow aliases; default refuses)
+  lotics app deploy [-m <message>]     Build + upload current dir as a new version
+                                       (code + queries only \u2014 workflow bindings are
+                                       managed by set_app_workflow / remove_app_workflow)
   lotics app subdomain <new-subdomain> Rename the app's public <slug>.lotics.app address
   lotics app rename "<new name>"       Rename the app's display name (launcher title)
   lotics app dev [path]                Run the app locally with HMR (RPC forwarded to prod)
@@ -48027,8 +48031,7 @@ async function main() {
     console.error("Usage:");
     console.error("  lotics app create <name> [path]      Scaffold a new app locally");
     console.error("  lotics app pull <app_id> [path]      Pull an existing app for local editing");
-    console.error("  lotics app deploy [-m <message>] [--force-workflow-sync]");
-    console.error("                                       Build + upload the current directory");
+    console.error("  lotics app deploy [-m <message>]     Build + upload the current directory");
     console.error("  lotics app subdomain <new-subdomain> Rename the app's public <slug>.lotics.app address");
     console.error(`  lotics app rename "<new name>"        Rename the app's display name (launcher title)`);
     console.error("  lotics app dev [path]                Run the app locally with HMR + RPC forwarding");
@@ -48145,7 +48148,7 @@ Available workspaces:`);
     }
     if (subcommand === "deploy") {
       const message = flags.message ?? toolArgs;
-      await appDeploy(client, { message, forceWorkflowSync: flags.forceWorkflowSync });
+      await appDeploy(client, { message });
       return;
     }
     if (subcommand === "subdomain") {

package/package.json

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