@lotics/cli 0.63.0 → 0.64.0

package/dist/app_commands.d.ts

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

package/dist/app_commands.js

@@ -806,7 +806,11 @@ function readAppSourceText(projectDir) {
  * both archives in R2, creates an app_versions row, and atomically advances
  * the app's current_version pointer.
  */
-export async function appDeploy(client, args) {
+export async function appDeploy(client, 
+// `message` is required — each deploy is a version row read back by
+// `lotics app versions`; a blank message loses the audit trail. The CLI
+// enforces non-empty at the dispatch; the type enforces it for every caller.
+args) {
     const projectDir = path.resolve(args.projectDir ?? process.cwd());
     const meta = readAppMeta(projectDir);
     // Pre-flight (GAP-29): a capability the code calls but the manifest doesn't

package/dist/cli.js

@@ -71,7 +71,8 @@ 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>]     Build + upload current dir as a new version
+  lotics app deploy -m <message>       Build + upload current dir as a new version
+                                       (-m is required — it's the version's audit trail)
                                        (code + queries only — workflow bindings are
                                        managed by set_app_workflow / remove_app_workflow)
   lotics app versions [app_id]         Show deploy history newest-first (version,
@@ -598,7 +599,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>]     Build + upload the current directory");
+        console.error("  lotics app deploy -m <message>       Build + upload the current directory (-m required)");
         console.error("  lotics app versions [app_id]         Show deploy history (version, when, who, message)");
         console.error("  lotics app codegen [path]            Regenerate .lotics/* (types + field ids) — no deploy");
         console.error("  lotics app workflow run <alias> '<json>'  Execute a bound app workflow end-to-end");
@@ -729,7 +730,14 @@ async function main() {
         }
         if (subcommand === "deploy") {
             // The message is either `-m <message>` or a bare positional arg after `deploy`.
-            const message = flags.message ?? toolArgs;
+            // Required: every deploy is a version row, and `lotics app versions` reads
+            // the message back — a blank one makes the deploy history useless.
+            const message = (flags.message ?? toolArgs)?.trim();
+            if (!message) {
+                console.error('Usage: lotics app deploy -m "<what changed + why>"');
+                console.error("A deploy message is required — it's the version's audit trail (see `lotics app versions`).");
+                process.exit(1);
+            }
             await appDeploy(client, { message });
             return;
         }

package/dist/src/cli.js

@@ -49203,7 +49203,8 @@ 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>]     Build + upload current dir as a new version
+  lotics app deploy -m <message>       Build + upload current dir as a new version
+                                       (-m is required \u2014 it's the version's audit trail)
                                        (code + queries only \u2014 workflow bindings are
                                        managed by set_app_workflow / remove_app_workflow)
   lotics app versions [app_id]         Show deploy history newest-first (version,
@@ -49683,7 +49684,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>]     Build + upload the current directory");
+    console.error("  lotics app deploy -m <message>       Build + upload the current directory (-m required)");
     console.error("  lotics app versions [app_id]         Show deploy history (version, when, who, message)");
     console.error("  lotics app codegen [path]            Regenerate .lotics/* (types + field ids) \u2014 no deploy");
     console.error("  lotics app workflow run <alias> '<json>'  Execute a bound app workflow end-to-end");
@@ -49807,7 +49808,12 @@ Available workspaces:`);
       return;
     }
     if (subcommand === "deploy") {
-      const message = flags.message ?? toolArgs;
+      const message = (flags.message ?? toolArgs)?.trim();
+      if (!message) {
+        console.error('Usage: lotics app deploy -m "<what changed + why>"');
+        console.error("A deploy message is required \u2014 it's the version's audit trail (see `lotics app versions`).");
+        process.exit(1);
+      }
       await appDeploy(client, { message });
       return;
     }

package/package.json

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