@lotics/cli 0.172.0 → 0.174.0

package/dist/src/cli.js

@@ -45696,7 +45696,7 @@ function resultSideEffects(result) {
 }
 
 // src/version.ts
-var VERSION = "0.172.0";
+var VERSION = "0.174.0";
 
 // src/timezone.ts
 function machineTimezone() {
@@ -48393,7 +48393,7 @@ function walk(node, visit) {
   }
 }
 
-// src/generate_app_fields.ts
+// ../shared/src/generate_app_fields.ts
 var HEADER = `// Auto-generated by 'lotics app codegen' and 'lotics app pull'.
 // DO NOT EDIT \u2014 regenerated from the workspace schema.
 //
@@ -48511,6 +48511,17 @@ export type AppFields = typeof F;
 export type AppOptions = typeof OPT;
 `;
 }
+function codegenTableIds(queries, allowlist) {
+  const ids = new Set(allowlist);
+  for (const declaration of Object.values(queries)) {
+    for (const id of collectQueryTableIds(declaration.ast)) ids.add(id);
+  }
+  return [...ids];
+}
+function readCodegenTablesAllowlist(pkg) {
+  const tables = pkg?.lotics?.codegen?.tables;
+  return Array.isArray(tables) ? tables.filter((t) => typeof t === "string") : [];
+}
 
 // src/app_workflow_check.ts
 import fs7 from "node:fs";
@@ -71970,18 +71981,13 @@ function writeAppDts(projectDir, manifest) {
   ensureAppVitestSetup(projectDir);
   return written.map(([file2]) => file2);
 }
-function readCodegenTablesAllowlist(projectDir) {
-  const pkg = JSON.parse(fs8.readFileSync(path9.join(projectDir, "package.json"), "utf-8"));
-  const tables = pkg.lotics?.codegen?.tables;
-  return Array.isArray(tables) ? tables.filter((t) => typeof t === "string") : [];
-}
 function resolveCodegenTableIds(projectDir, queries) {
-  const ids = /* @__PURE__ */ new Set();
-  for (const decl of Object.values(queries)) {
-    for (const id of collectQueryTableIds(decl.ast)) ids.add(id);
+  let manifest = null;
+  try {
+    manifest = JSON.parse(fs8.readFileSync(path9.join(projectDir, "package.json"), "utf-8"));
+  } catch {
   }
-  for (const id of readCodegenTablesAllowlist(projectDir)) ids.add(id);
-  return [...ids];
+  return codegenTableIds(queries, readCodegenTablesAllowlist(manifest));
 }
 function writeAppFields(projectDir, tables) {
   const dotLotics = path9.join(projectDir, ".lotics");
@@ -74023,15 +74029,19 @@ function reportKnowledgeWarnings(warnings) {
   answering from nowhere. Create them with those names, or edit the agent.`
   );
 }
+function instantiateBody(args) {
+  return {
+    ...args.noSampleData === true ? { no_sample_data: true } : {},
+    ...args.adopt === true ? { adopt: true } : {},
+    build_on_server: true
+  };
+}
 async function starterInit(client, args) {
   const starter = await client.getPackage(args.starter_id);
   note(
     `Copying ${starter.name}${starter.is_official ? " (official)" : ""} into this workspace\u2026`
   );
-  const result = await client.instantiateStarter(args.starter_id, {
-    ...args.noSampleData === true ? { no_sample_data: true } : {},
-    ...args.adopt === true ? { adopt: true } : {}
-  });
+  const result = await client.instantiateStarter(args.starter_id, instantiateBody(args));
   const tables = Object.keys(result.binding.entities ?? {}).sort();
   const knowledgeDocs = Object.keys(result.binding.knowledge ?? {}).sort();
   const templates = Object.keys(result.binding.templates ?? {}).sort();
@@ -74094,19 +74104,42 @@ Done \u2014 these are yours now, with no link back to the starter.`);
     stamp: { id: null, number: null },
     kept
   });
+  const serverDeployed = result.deployed ?? null;
   if (starter.owned_by_caller !== true) {
     warn(
-      `
+      serverDeployed !== null ? `
+Built ${starter.name} on Lotics \u2014 its package scripts and vite config are the
+  publisher's code, run in an isolated container rather than on your machine.${starter.is_official ? " Lotics reviewed this starter." : ""}` : `
 Building ${starter.name} \u2014 this runs its build on your machine (its package scripts
   and vite config are the publisher's code, executed as you).${starter.is_official ? " Lotics reviewed this starter." : ""}`
     );
-  } else {
+  } else if (serverDeployed === null) {
     note(`Building and deploying\u2026`);
   }
-  await appDeploy(client, {
-    projectDir: targetPath,
-    message: `Copied from starter ${starter.name}`
-  });
+  const resumeDir = path10.relative(process.cwd(), targetPath) || ".";
+  try {
+    if (serverDeployed !== null) {
+      note(`Deployed v${serverDeployed.version_number} \u2014 built on Lotics, no Node needed here.`);
+    } else {
+      await appDeploy(client, {
+        projectDir: targetPath,
+        message: `Copied from starter ${starter.name}`
+      });
+    }
+  } catch (error52) {
+    const reason = error52 instanceof Error ? error52.message : String(error52);
+    throw new Error(
+      `${reason}
+
+The copy itself is DONE and nothing needs repeating: the tables, the sample
+records and the project all landed. Only the deploy is left.
+
+  Finish it:  cd ${resumeDir} && lotics app deploy -m "Copied from starter ${starter.name}"
+
+Do NOT re-run the copy \u2014 it would adopt the tables this one just created and
+insert the sample records again.`
+    );
+  }
   let signInUrl = null;
   try {
     const link = await client.login({

package/dist/src/client.d.ts

@@ -403,11 +403,25 @@ export declare class LoticsClient {
         version?: number;
         no_sample_data?: boolean;
         adopt?: boolean;
+        /** Ask the server to build and deploy the copy, so this machine needs no Node. */
+        build_on_server?: boolean;
     }): Promise<{
         app_id: string | null;
         starter_id: string;
         version: number;
         bundle_url: string | null;
+        /**
+         * The version the SERVER deployed, when it did.
+         *
+         * Optional in this type on purpose: a server that predates the field omits
+         * it entirely, and it is absent rather than null. Callers must treat "not
+         * there" and "null" alike and build locally — assuming the request was
+         * honoured would report success over an app nobody built.
+         */
+        deployed?: {
+            version_id: string;
+            version_number: number;
+        } | null;
         binding: Record<string, Record<string, string>>;
         sample_record_ids: Record<string, string[]>;
         knowledge_warnings: {

package/docs/building_an_app.md

@@ -206,6 +206,17 @@ lotics app check                     # every pre-flight a deploy runs, without b
 lotics app deploy -m "<what changed + why>"
 ```
 
+**A green suite says nothing about how the screen LOOKS**, and that half has its own pass:
+`lotics docs reviewing` — render it, look at it, then measure what the look is telling you. Run it
+before the deploy, not as an audit someone schedules after a complaint.
+
+Every check above reads the SOURCE; none of them renders it. So the entire class of defect that
+lives in the pixels — wrong form for the subject, a treatment that contradicts what an element
+means, a surface that measures clean and still tells the reader nothing — passes all of them
+silently, and arrives later as "it looks bad", which is a report about a cause the reporter cannot
+name. That is what the review is for, and why it belongs here rather than in whoever remembers to
+ask for it.
+
 `-m` is optional; the deploy derives a message from what it pushed. Write one when the *why* is
 worth keeping.
 

package/package.json

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