@lotics/cli 0.165.0 → 0.172.0

package/dist/src/cli.js

@@ -26822,12 +26822,12 @@ var require_tokens = __commonJS({
       });
     }
     exports2.assignCategoriesMapProp = assignCategoriesMapProp;
-    function singleAssignCategoriesToksMap(path14, nextNode) {
-      utils_1.forEach(path14, function(pathNode) {
+    function singleAssignCategoriesToksMap(path13, nextNode) {
+      utils_1.forEach(path13, function(pathNode) {
         nextNode.categoryMatchesMap[pathNode.tokenTypeIdx] = true;
       });
       utils_1.forEach(nextNode.CATEGORIES, function(nextCategory) {
-        var newPath = path14.concat(nextNode);
+        var newPath = path13.concat(nextNode);
         if (!utils_1.contains(newPath, nextCategory)) {
           singleAssignCategoriesToksMap(newPath, nextCategory);
         }
@@ -28590,10 +28590,10 @@ var require_interpreter = __commonJS({
       /** @class */
       (function(_super) {
         __extends(AbstractNextPossibleTokensWalker2, _super);
-        function AbstractNextPossibleTokensWalker2(topProd, path14) {
+        function AbstractNextPossibleTokensWalker2(topProd, path13) {
           var _this = _super.call(this) || this;
           _this.topProd = topProd;
-          _this.path = path14;
+          _this.path = path13;
           _this.possibleTokTypes = [];
           _this.nextProductionName = "";
           _this.nextProductionOccurrence = 0;
@@ -28647,9 +28647,9 @@ var require_interpreter = __commonJS({
       /** @class */
       (function(_super) {
         __extends(NextAfterTokenWalker2, _super);
-        function NextAfterTokenWalker2(topProd, path14) {
-          var _this = _super.call(this, topProd, path14) || this;
-          _this.path = path14;
+        function NextAfterTokenWalker2(topProd, path13) {
+          var _this = _super.call(this, topProd, path13) || this;
+          _this.path = path13;
           _this.nextTerminalName = "";
           _this.nextTerminalOccurrence = 0;
           _this.nextTerminalName = _this.path.lastTok.name;
@@ -29346,10 +29346,10 @@ var require_lookahead = __commonJS({
       }
       return result;
     }
-    function pathToHashKeys(path14) {
+    function pathToHashKeys(path13) {
       var keys3 = [""];
-      for (var i2 = 0; i2 < path14.length; i2++) {
-        var tokType = path14[i2];
+      for (var i2 = 0; i2 < path13.length; i2++) {
+        var tokType = path13[i2];
         var longerKeys = [];
         for (var j = 0; j < keys3.length; j++) {
           var currShorterKey = keys3[j];
@@ -29661,9 +29661,9 @@ var require_checks = __commonJS({
       return errors2;
     }
     exports2.validateRuleIsOverridden = validateRuleIsOverridden;
-    function validateNoLeftRecursion(topRule, currRule, errMsgProvider, path14) {
-      if (path14 === void 0) {
-        path14 = [];
+    function validateNoLeftRecursion(topRule, currRule, errMsgProvider, path13) {
+      if (path13 === void 0) {
+        path13 = [];
       }
       var errors2 = [];
       var nextNonTerminals = getFirstNoneTerminal(currRule.definition);
@@ -29676,15 +29676,15 @@ var require_checks = __commonJS({
           errors2.push({
             message: errMsgProvider.buildLeftRecursionError({
               topLevelRule: topRule,
-              leftRecursionPath: path14
+              leftRecursionPath: path13
             }),
             type: parser_1.ParserDefinitionErrorType.LEFT_RECURSION,
             ruleName
           });
         }
-        var validNextSteps = utils2.difference(nextNonTerminals, path14.concat([topRule]));
+        var validNextSteps = utils2.difference(nextNonTerminals, path13.concat([topRule]));
         var errorsFromNextSteps = utils2.map(validNextSteps, function(currRefRule) {
-          var newPath = utils2.cloneArr(path14);
+          var newPath = utils2.cloneArr(path13);
           newPath.push(currRefRule);
           return validateNoLeftRecursion(topRule, currRefRule, errMsgProvider, newPath);
         });
@@ -37293,8 +37293,8 @@ var require_utils4 = __commonJS({
       var result = transform2[inputType][outputType](input);
       return result;
     };
-    exports2.resolve = function(path14) {
-      var parts = path14.split("/");
+    exports2.resolve = function(path13) {
+      var parts = path13.split("/");
       var result = [];
       for (var index = 0; index < parts.length; index++) {
         var part = parts[index];
@@ -43147,18 +43147,18 @@ var require_object = __commonJS({
       var object2 = new ZipObject(name2, zipObjectContent, o);
       this.files[name2] = object2;
     };
-    var parentFolder = function(path14) {
-      if (path14.slice(-1) === "/") {
-        path14 = path14.substring(0, path14.length - 1);
+    var parentFolder = function(path13) {
+      if (path13.slice(-1) === "/") {
+        path13 = path13.substring(0, path13.length - 1);
       }
-      var lastSlash = path14.lastIndexOf("/");
-      return lastSlash > 0 ? path14.substring(0, lastSlash) : "";
+      var lastSlash = path13.lastIndexOf("/");
+      return lastSlash > 0 ? path13.substring(0, lastSlash) : "";
     };
-    var forceTrailingSlash = function(path14) {
-      if (path14.slice(-1) !== "/") {
-        path14 += "/";
+    var forceTrailingSlash = function(path13) {
+      if (path13.slice(-1) !== "/") {
+        path13 += "/";
       }
-      return path14;
+      return path13;
     };
     var folderAdd = function(name2, createFolders) {
       createFolders = typeof createFolders !== "undefined" ? createFolders : defaults2.createFolders;
@@ -44162,7 +44162,7 @@ import dns from "node:dns";
 import net2 from "node:net";
 import fs14 from "node:fs";
 import os4 from "node:os";
-import path13 from "node:path";
+import path12 from "node:path";
 import readline from "node:readline";
 
 // ../shared/src/transport_error.ts
@@ -44301,6 +44301,26 @@ function getMimeType(filename) {
   return MIME_MAP[ext] ?? "application/octet-stream";
 }
 var API_BASE_URL = process.env.LOTICS_API_URL ?? "https://api.lotics.ai";
+var WEB_APP_URL = "https://lotics.ai";
+async function fetchOfficialStarters() {
+  let response;
+  try {
+    response = await fetch(`${API_BASE_URL}/v1/starters/official`, {
+      signal: AbortSignal.timeout(SHELF_FETCH_TIMEOUT_MS)
+    });
+  } catch (error52) {
+    throw new Error(
+      `Could not reach Lotics to list the starters (${error52 instanceof Error ? error52.message : String(error52)}). Check your connection, or browse ${WEB_APP_URL}/docs/cli.`
+    );
+  }
+  if (!response.ok) {
+    throw new Error(
+      `Lotics answered ${response.status} listing the starters. If this keeps happening, browse ${WEB_APP_URL}/docs/cli.`
+    );
+  }
+  return await response.json();
+}
+var SHELF_FETCH_TIMEOUT_MS = 1e4;
 var LoticsClient = class {
   apiKey;
   workspaceId;
@@ -44358,8 +44378,8 @@ var LoticsClient = class {
     }
     return headers;
   }
-  async request(method, path14, body) {
-    const url2 = `${this.baseUrl}${path14}`;
+  async request(method, path13, body) {
+    const url2 = `${this.baseUrl}${path13}`;
     const headers = this.buildHeaders();
     const init = { method, headers };
     if (body !== void 0) {
@@ -45605,11 +45625,15 @@ function isNewerVersion(latest, current) {
   if (lMin !== cMin) return lMin > cMin;
   return lPat > cPat;
 }
+function updateCommand() {
+  if (process.versions.bun === void 0) return "npm i -g @lotics/cli";
+  return process.platform === "win32" ? "irm https://lotics.ai/install.ps1 | iex" : "curl -fsSL https://lotics.ai/install.sh | bash";
+}
 function printUpdateWarning(current, latest) {
   if (!isNewerVersion(latest, current)) return;
   console.error(`
 Update available: ${current} \u2192 ${latest}`);
-  console.error(`Run: npm i -g @lotics/cli
+  console.error(`Run: ${updateCommand()}
 `);
 }
 
@@ -45672,17 +45696,22 @@ function resultSideEffects(result) {
 }
 
 // src/version.ts
-import { readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import path5 from "node:path";
-var pkgPath = path5.resolve(path5.dirname(fileURLToPath(import.meta.url)), "../../package.json");
-var pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-var VERSION = pkg.version;
+var VERSION = "0.172.0";
+
+// src/timezone.ts
+function machineTimezone() {
+  try {
+    const zone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    return zone !== void 0 && zone !== "" ? zone : void 0;
+  } catch {
+    return void 0;
+  }
+}
 
 // src/docs_command.ts
 import fs5 from "node:fs";
-import path6 from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import path5 from "node:path";
+import { fileURLToPath } from "node:url";
 var READING_ORDER = ["@lotics/app-sdk", "@lotics/ui", "@lotics/cli"];
 function firstHeading(file2) {
   let text;
@@ -45699,35 +45728,35 @@ function firstHeading(file2) {
 }
 function readVersion(pkgDir) {
   try {
-    const raw = fs5.readFileSync(path6.join(pkgDir, "package.json"), "utf-8");
+    const raw = fs5.readFileSync(path5.join(pkgDir, "package.json"), "utf-8");
     return JSON.parse(raw).version ?? "?";
   } catch {
     return "?";
   }
 }
 function ownPackageDir() {
-  return path6.resolve(path6.dirname(fileURLToPath2(import.meta.url)), "../..");
+  return path5.resolve(path5.dirname(fileURLToPath(import.meta.url)), "../..");
 }
 function referencePackageDirs(projectDir) {
   const found = /* @__PURE__ */ new Map();
   for (let dir = projectDir; ; ) {
-    const scope = path6.join(dir, "node_modules", "@lotics");
+    const scope = path5.join(dir, "node_modules", "@lotics");
     if (fs5.existsSync(scope)) {
       for (const name2 of fs5.readdirSync(scope)) {
-        const pkgDir = path6.join(scope, name2);
-        const carries = fs5.existsSync(path6.join(pkgDir, "AGENTS.md")) || fs5.existsSync(path6.join(pkgDir, "docs"));
+        const pkgDir = path5.join(scope, name2);
+        const carries = fs5.existsSync(path5.join(pkgDir, "AGENTS.md")) || fs5.existsSync(path5.join(pkgDir, "docs"));
         if (carries && !found.has(`@lotics/${name2}`)) found.set(`@lotics/${name2}`, pkgDir);
       }
     }
-    const parent = path6.dirname(dir);
+    const parent = path5.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
   const own = ownPackageDir();
-  if (!found.has("@lotics/cli") && fs5.existsSync(path6.join(own, "AGENTS.md"))) {
+  if (!found.has("@lotics/cli") && fs5.existsSync(path5.join(own, "AGENTS.md"))) {
     found.set("@lotics/cli", own);
   }
-  return [...found.entries()].map(([pkg2, dir]) => ({ pkg: pkg2, dir })).sort((a, b) => {
+  return [...found.entries()].map(([pkg, dir]) => ({ pkg, dir })).sort((a, b) => {
     const ia = READING_ORDER.indexOf(a.pkg);
     const ib = READING_ORDER.indexOf(b.pkg);
     if (ia !== ib) return (ia < 0 ? READING_ORDER.length : ia) - (ib < 0 ? READING_ORDER.length : ib);
@@ -45736,26 +45765,26 @@ function referencePackageDirs(projectDir) {
 }
 function collectDocAreas(projectDir) {
   const found = [];
-  for (const { pkg: pkg2, dir } of referencePackageDirs(projectDir)) {
+  for (const { pkg, dir } of referencePackageDirs(projectDir)) {
     const version2 = readVersion(dir);
-    const index = path6.join(dir, "AGENTS.md");
+    const index = path5.join(dir, "AGENTS.md");
     if (fs5.existsSync(index)) {
       found.push({
-        area: pkg2.replace("@lotics/", ""),
-        pkg: pkg2,
+        area: pkg.replace("@lotics/", ""),
+        pkg,
         version: version2,
         absPath: index,
         title: firstHeading(index)
       });
     }
-    const docsDir = path6.join(dir, "docs");
+    const docsDir = path5.join(dir, "docs");
     if (!fs5.existsSync(docsDir)) continue;
     for (const file2 of fs5.readdirSync(docsDir).sort()) {
       if (!file2.endsWith(".md")) continue;
-      const abs2 = path6.join(docsDir, file2);
+      const abs2 = path5.join(docsDir, file2);
       found.push({
         area: file2.replace(/\.md$/, ""),
-        pkg: pkg2,
+        pkg,
         version: version2,
         absPath: abs2,
         title: firstHeading(abs2)
@@ -45802,7 +45831,7 @@ ${a.pkg}  ${a.version}`);
   return lines.join("\n");
 }
 function docsCommand(args) {
-  const projectDir = path6.resolve(args.projectDir ?? process.cwd());
+  const projectDir = path5.resolve(args.projectDir ?? process.cwd());
   const areas = collectDocAreas(projectDir);
   if (args.area === void 0 || args.area === "") {
     console.log(renderDocIndex(areas));
@@ -45824,13 +45853,26 @@ function docsCommand(args) {
     process.exit(1);
   }
   const hit = hits[0];
-  console.error(`${hit.pkg} ${hit.version} \xB7 ${path6.relative(projectDir, hit.absPath)}
+  console.error(`${hit.pkg} ${hit.version} \xB7 ${path5.relative(projectDir, hit.absPath)}
 `);
   process.stdout.write(fs5.readFileSync(hit.absPath, "utf-8"));
 }
 
 // src/commands.ts
 var COMMANDS = [
+  {
+    verbs: ["start"],
+    help: [
+      "  lotics start <starter_id> [path] --email <you@co.com>",
+      "                                       First run, one command: create an account if this",
+      "                                       machine has none, then copy the starter into its",
+      "                                       workspace \u2014 schema, templates, knowledge docs,",
+      "                                       sample records, a deployed app \u2014 and print a",
+      "                                       one-time sign-in link. Drop --email to copy into",
+      "                                       the account you already have. --json prints one",
+      "                                       object and nothing else"
+    ]
+  },
   {
     verbs: ["org"],
     help: [
@@ -45859,7 +45901,9 @@ var COMMANDS = [
   {
     verbs: ["starter"],
     help: [
-      "  lotics starter list                  Starters you can copy into this workspace",
+      "  lotics starter list                  Starters you can copy into this workspace. Works with",
+      "                                       NO account \u2014 it then lists the published shelf, so you",
+      "                                       can decide whether to copy one or build before signing up",
       "  lotics starter show <starter_id>     What one carries: tables, docs, templates, sample data",
       "  lotics starter init <starter_id> [path]",
       "                                       Copy it in \u2014 schema, templates, knowledge docs,",
@@ -46046,7 +46090,7 @@ function matchesKnownFlag(known, arg) {
 
 // src/report_command.ts
 import fs6 from "node:fs";
-import path7 from "node:path";
+import path6 from "node:path";
 var LIMITS = { goal: 2e3, expected: 2e3, actual: 4e3, tried: 4e3, wanted: 2e3 };
 var REPORT_USAGE = `Usage: lotics report '<json>'      lotics report @report.json      \u2026 | lotics report -
 
@@ -46107,9 +46151,9 @@ function parseReport(raw) {
 }
 function appIdOf(projectDir) {
   try {
-    const raw = fs6.readFileSync(path7.join(projectDir, "package.json"), "utf-8");
-    const pkg2 = JSON.parse(raw);
-    const appId = pkg2.lotics?.app_id;
+    const raw = fs6.readFileSync(path6.join(projectDir, "package.json"), "utf-8");
+    const pkg = JSON.parse(raw);
+    const appId = pkg.lotics?.app_id;
     return typeof appId === "string" && appId !== "" ? appId : void 0;
   } catch {
     return void 0;
@@ -46147,7 +46191,7 @@ async function reportCommand(client, options) {
 
 // src/app_commands.ts
 import fs8 from "node:fs";
-import path10 from "node:path";
+import path9 from "node:path";
 import { spawn as spawn2 } from "node:child_process";
 import { createHash as createHash3 } from "node:crypto";
 import { tmpdir } from "node:os";
@@ -46914,7 +46958,7 @@ function escapeHtml(s) {
 import http from "node:http";
 import net from "node:net";
 import { existsSync } from "node:fs";
-import path8 from "node:path";
+import path7 from "node:path";
 import { spawn } from "node:child_process";
 
 // src/child_env.ts
@@ -47498,6 +47542,9 @@ var STOP_DEADLINE_MS = 2e3;
 function serializeRpcResult(result) {
   return JSON.stringify(result ?? null);
 }
+function nodeForChildProcess() {
+  return process.versions.bun === void 0 ? process.execPath : "node";
+}
 async function startDevServer(args) {
   const wrapperPort = await pickPort(args.port ?? DEFAULT_PORT);
   const vitePort = await pickPort(args.vitePort ?? DEFAULT_VITE_PORT, wrapperPort);
@@ -47509,14 +47556,14 @@ async function startDevServer(args) {
     vite_url: viteUrl,
     api_url: args.api_url
   });
-  const viteEntry = path8.join(args.projectDir, "node_modules", "vite", "bin", "vite.js");
+  const viteEntry = path7.join(args.projectDir, "node_modules", "vite", "bin", "vite.js");
   if (!existsSync(viteEntry)) {
     throw new Error(
       `Vite is not installed in ${args.projectDir} \u2014 run \`npm install\` there first.`
     );
   }
   const viteChild = spawn(
-    process.execPath,
+    nodeForChildProcess(),
     [viteEntry, "--port", String(vitePort), "--strictPort"],
     {
       cwd: args.projectDir,
@@ -47871,6 +47918,36 @@ function openBrowser(url2) {
   child.unref();
 }
 
+// src/output.ts
+var machineMode = false;
+var collectedWarnings = [];
+function setMachineOutput(on) {
+  machineMode = on;
+}
+function isMachineOutput() {
+  return machineMode;
+}
+function note(text) {
+  if (machineMode) return;
+  console.error(text);
+}
+function warn(text) {
+  if (machineMode) {
+    collectedWarnings.push(text);
+    return;
+  }
+  console.error(text);
+}
+function emitJson(value2) {
+  const payload = collectedWarnings.length > 0 ? { ...value2, warnings: [...collectedWarnings] } : value2;
+  collectedWarnings.length = 0;
+  console.log(JSON.stringify(payload, null, 2));
+}
+function flushPendingWarnings() {
+  for (const text of collectedWarnings) console.error(text);
+  collectedWarnings.length = 0;
+}
+
 // ../shared/src/app_dts.ts
 var IDENTIFIER_REGEX = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
 function isValidIdentifier(name2) {
@@ -48437,7 +48514,7 @@ export type AppOptions = typeof OPT;
 
 // src/app_workflow_check.ts
 import fs7 from "node:fs";
-import path9 from "node:path";
+import path8 from "node:path";
 import { createRequire } from "node:module";
 
 // ../shared/src/parse_workflow_js.ts
@@ -49209,10 +49286,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path14) {
-  if (!path14)
+function getElementAtPath(obj, path13) {
+  if (!path13)
     return obj;
-  return path14.reduce((acc, key) => acc?.[key], obj);
+  return path13.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys3 = Object.keys(promisesObj);
@@ -49621,11 +49698,11 @@ function explicitlyAborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path14, issues) {
+function prefixIssues(path13, issues) {
   return issues.map((iss) => {
     var _a4;
     (_a4 = iss).path ?? (_a4.path = []);
-    iss.path.unshift(path14);
+    iss.path.unshift(path13);
     return iss;
   });
 }
@@ -49772,16 +49849,16 @@ function flattenError(error52, mapper = (issue2) => issue2.message) {
 }
 function formatError(error52, mapper = (issue2) => issue2.message) {
   const fieldErrors = { _errors: [] };
-  const processError = (error53, path14 = []) => {
+  const processError = (error53, path13 = []) => {
     for (const issue2 of error53.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path14, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path13, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path14, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path13, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path14, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path13, ...issue2.path]);
       } else {
-        const fullpath = [...path14, ...issue2.path];
+        const fullpath = [...path13, ...issue2.path];
         if (fullpath.length === 0) {
           fieldErrors._errors.push(mapper(issue2));
         } else {
@@ -49808,17 +49885,17 @@ function formatError(error52, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error52, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error53, path14 = []) => {
+  const processError = (error53, path13 = []) => {
     var _a4, _b2;
     for (const issue2 of error53.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
-        issue2.errors.map((issues) => processError({ issues }, [...path14, ...issue2.path]));
+        issue2.errors.map((issues) => processError({ issues }, [...path13, ...issue2.path]));
       } else if (issue2.code === "invalid_key") {
-        processError({ issues: issue2.issues }, [...path14, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path13, ...issue2.path]);
       } else if (issue2.code === "invalid_element") {
-        processError({ issues: issue2.issues }, [...path14, ...issue2.path]);
+        processError({ issues: issue2.issues }, [...path13, ...issue2.path]);
       } else {
-        const fullpath = [...path14, ...issue2.path];
+        const fullpath = [...path13, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -49850,8 +49927,8 @@ function treeifyError(error52, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path14 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path14) {
+  const path13 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path13) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -62543,13 +62620,13 @@ function resolveRef(ref2, ctx) {
   if (!ref2.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path14 = ref2.slice(1).split("/").filter(Boolean);
-  if (path14.length === 0) {
+  const path13 = ref2.slice(1).split("/").filter(Boolean);
+  if (path13.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path14[0] === defsKey) {
-    const key = path14[1];
+  if (path13[0] === defsKey) {
+    const key = path13[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref2}`);
     }
@@ -67305,9 +67382,9 @@ __export(expression_object_exports, {
   pick: () => pick3,
   values: () => values2
 });
-function getNestedValue(obj, path14) {
+function getNestedValue(obj, path13) {
   if (obj == null) return void 0;
-  const parts = path14.split(".");
+  const parts = path13.split(".");
   let value2 = obj;
   for (const part of parts) {
     if (value2 == null) return void 0;
@@ -67346,11 +67423,11 @@ function entries(obj) {
   }
   return Object.entries(obj);
 }
-function get(obj, path14, defaultValue) {
-  if (typeof path14 !== "string") {
+function get(obj, path13, defaultValue) {
+  if (typeof path13 !== "string") {
     throw new Error("get: path must be a string");
   }
-  const value2 = getNestedValue(obj, path14);
+  const value2 = getNestedValue(obj, path13);
   return value2 !== void 0 ? value2 : defaultValue;
 }
 function pick3(obj, fields) {
@@ -69246,17 +69323,17 @@ function readFromChanges(chain2) {
     if (first3.kind === "bracket-number" || first3.kind === "bracket-expr") {
       fail(first3.node, "changes is keyed by field name, not numeric index.");
     }
-    const path14 = [{ at: "key", key: first3.key }];
+    const path13 = [{ at: "key", key: first3.key }];
     for (const seg of segments.slice(1)) {
       if (seg.kind === "bracket-number") {
-        path14.push({ at: "index", index: seg.index });
+        path13.push({ at: "index", index: seg.index });
       } else if (seg.kind === "bracket-expr") {
-        path14.push({ at: "index", index: seg.expr });
+        path13.push({ at: "index", index: seg.expr });
       } else {
-        path14.push({ at: "key", key: seg.key });
+        path13.push({ at: "key", key: seg.key });
       }
     }
-    return { kind: "read", source: { from: "trigger_changes" }, path: path14 };
+    return { kind: "read", source: { from: "trigger_changes" }, path: path13 };
   });
 }
 var TRIGGER_RECORD_VIEWS = /* @__PURE__ */ new Map([
@@ -69274,17 +69351,17 @@ function readFromTrigger(chain2) {
     return view === "trigger_changes" ? readFromChanges(lowered) : readFromRecord(view, lowered);
   }
   return wrapOptionalGuards(chain2, (segments) => {
-    const path14 = [];
+    const path13 = [];
     for (const seg of segments) {
       if (seg.kind === "bracket-number") {
-        path14.push({ at: "index", index: seg.index });
+        path13.push({ at: "index", index: seg.index });
       } else if (seg.kind === "bracket-expr") {
-        path14.push({ at: "index", index: seg.expr });
+        path13.push({ at: "index", index: seg.expr });
       } else {
-        path14.push({ at: "key", key: seg.key });
+        path13.push({ at: "key", key: seg.key });
       }
     }
-    return { kind: "read", source: { from: "trigger" }, path: path14 };
+    return { kind: "read", source: { from: "trigger" }, path: path13 };
   });
 }
 function readFromRuntime(chain2) {
@@ -69306,17 +69383,17 @@ function readFromRuntime(chain2) {
     const parked = PARKED_RUNTIME_KEYS.get(key);
     if (parked) fail(first3.node, parked, parkedRuntimeKeyConstruct(key));
     const source = { from: "runtime", key };
-    const path14 = [];
+    const path13 = [];
     for (const seg of segments.slice(1)) {
       if (seg.kind === "bracket-number") {
-        path14.push({ at: "index", index: seg.index });
+        path13.push({ at: "index", index: seg.index });
       } else if (seg.kind === "bracket-expr") {
-        path14.push({ at: "index", index: seg.expr });
+        path13.push({ at: "index", index: seg.expr });
       } else {
-        path14.push({ at: "key", key: seg.key });
+        path13.push({ at: "key", key: seg.key });
       }
     }
-    return { kind: "read", source, path: path14 };
+    return { kind: "read", source, path: path13 };
   });
 }
 function readFromForeachItem(name2, chain2) {
@@ -69355,17 +69432,17 @@ function readFromLexical(name2, chain2) {
 }
 function readFromStepOutput(stepId, chain2) {
   return wrapOptionalGuards(chain2, (segments) => {
-    const path14 = [];
+    const path13 = [];
     for (const seg of segments) {
       if (seg.kind === "bracket-number") {
-        path14.push({ at: "index", index: seg.index });
+        path13.push({ at: "index", index: seg.index });
       } else if (seg.kind === "bracket-expr") {
-        path14.push({ at: "index", index: seg.expr });
+        path13.push({ at: "index", index: seg.expr });
       } else {
-        path14.push({ at: "key", key: seg.key });
+        path13.push({ at: "key", key: seg.key });
       }
     }
-    return { kind: "read", source: { from: "step_output", step_id: stepId }, path: path14 };
+    return { kind: "read", source: { from: "step_output", step_id: stepId }, path: path13 };
   });
 }
 function classifyRecordPath(segs) {
@@ -71038,7 +71115,7 @@ function subsetIssues(bodySource, offset) {
   ];
 }
 async function loadProjectTypescript(projectDir) {
-  const requireFromProject = createRequire(path9.join(projectDir, "package.json"));
+  const requireFromProject = createRequire(path8.join(projectDir, "package.json"));
   let resolved;
   try {
     resolved = requireFromProject.resolve("typescript");
@@ -71051,9 +71128,9 @@ async function loadProjectTypescript(projectDir) {
   return mod2.default ?? mod2;
 }
 function pathToImportUrl(p) {
-  const resolved = path9.resolve(p);
+  const resolved = path8.resolve(p);
   const prefixed = resolved.startsWith("/") ? resolved : `/${resolved}`;
-  return `file://${prefixed.split(path9.sep).join("/")}`;
+  return `file://${prefixed.split(path8.sep).join("/")}`;
 }
 function checkOneWorkflowBody(tsApi, input) {
   const wrapped = fs7.readFileSync(input.bodyPath, "utf-8");
@@ -71103,7 +71180,7 @@ function checkOneWorkflowBody(tsApi, input) {
 }
 function createCheckedSourceHost(tsApi, options, bodyPath, bodyText) {
   const base = tsApi.createCompilerHost(options, false);
-  const key = (fileName) => base.getCanonicalFileName(path9.resolve(fileName).replace(/\\/g, "/"));
+  const key = (fileName) => base.getCanonicalFileName(path8.resolve(fileName).replace(/\\/g, "/"));
   const bodyKey = key(bodyPath);
   return {
     ...base,
@@ -71229,10 +71306,10 @@ function syncedEntry(entry) {
 }
 function readSynced(projectDir) {
   try {
-    const pkg2 = JSON.parse(
-      fs8.readFileSync(path10.join(projectDir, "package.json"), "utf-8")
+    const pkg = JSON.parse(
+      fs8.readFileSync(path9.join(projectDir, "package.json"), "utf-8")
     );
-    const raw = pkg2.lotics?.synced ?? {};
+    const raw = pkg.lotics?.synced ?? {};
     return {
       workflows: normalizeSyncedMap(raw.workflows),
       agents: normalizeSyncedMap(raw.agents),
@@ -71251,19 +71328,19 @@ function normalizeSyncedMap(map3) {
   );
 }
 function writeSynced(projectDir, kind, alias, entry) {
-  const pkgPath2 = path10.join(projectDir, "package.json");
-  const pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
-  if (!pkg2.lotics) return;
-  pkg2.lotics.synced ??= {};
-  pkg2.lotics.synced[kind] = { ...pkg2.lotics.synced[kind], [alias]: entry };
-  fs8.writeFileSync(pkgPath2, JSON.stringify(pkg2, null, 2) + "\n");
+  const pkgPath = path9.join(projectDir, "package.json");
+  const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf-8"));
+  if (!pkg.lotics) return;
+  pkg.lotics.synced ??= {};
+  pkg.lotics.synced[kind] = { ...pkg.lotics.synced[kind], [alias]: entry };
+  fs8.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
 }
 function readManifestEntry(projectDir, kind, alias) {
-  const pkg2 = readManifest(projectDir);
-  if (!pkg2.lotics) return { found: false };
+  const pkg = readManifest(projectDir);
+  if (!pkg.lotics) return { found: false };
   const entry = { found: true };
   let found = false;
-  const declarations = pkg2.lotics[kind];
+  const declarations = pkg.lotics[kind];
   if (declarations && typeof declarations === "object" && !Array.isArray(declarations)) {
     const map3 = declarations;
     if (alias in map3) {
@@ -71271,7 +71348,7 @@ function readManifestEntry(projectDir, kind, alias) {
       found = true;
     }
   }
-  const baselines = pkg2.lotics.synced?.[kind];
+  const baselines = pkg.lotics.synced?.[kind];
   if (baselines && alias in baselines) {
     entry.synced = baselines[alias];
     found = true;
@@ -71279,31 +71356,31 @@ function readManifestEntry(projectDir, kind, alias) {
   return found ? entry : { found: false };
 }
 function readManifest(projectDir) {
-  const pkgPath2 = path10.join(projectDir, "package.json");
-  return JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
+  const pkgPath = path9.join(projectDir, "package.json");
+  return JSON.parse(fs8.readFileSync(pkgPath, "utf-8"));
 }
 function removeFromManifest(projectDir, kind, alias) {
-  const pkgPath2 = path10.join(projectDir, "package.json");
-  const pkg2 = readManifest(projectDir);
-  if (!pkg2.lotics) return;
-  const declarations = pkg2.lotics[kind];
+  const pkgPath = path9.join(projectDir, "package.json");
+  const pkg = readManifest(projectDir);
+  if (!pkg.lotics) return;
+  const declarations = pkg.lotics[kind];
   if (declarations && typeof declarations === "object" && !Array.isArray(declarations)) {
     delete declarations[alias];
   }
-  const baselines = pkg2.lotics.synced?.[kind];
+  const baselines = pkg.lotics.synced?.[kind];
   if (baselines) delete baselines[alias];
-  fs8.writeFileSync(pkgPath2, JSON.stringify(pkg2, null, 2) + "\n");
+  fs8.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
 }
 function parkPrunedDeclaration(projectDir, kind, alias, removed) {
-  const dir = path10.join(projectDir, ".lotics", "pruned", kind);
+  const dir = path9.join(projectDir, ".lotics", "pruned", kind);
   fs8.mkdirSync(dir, { recursive: true });
-  const file2 = path10.join(dir, `${alias}.json`);
+  const file2 = path9.join(dir, `${alias}.json`);
   fs8.writeFileSync(file2, JSON.stringify(removed, null, 2) + "\n");
-  return path10.relative(projectDir, file2);
+  return path9.relative(projectDir, file2);
 }
-var WORKFLOWS_DIR = path10.join("src", "workflows");
-var WORKFLOW_GLOBALS_DIR = path10.join(".lotics", "workflows");
-var AGENTS_DIR = path10.join("src", "agents");
+var WORKFLOWS_DIR = path9.join("src", "workflows");
+var WORKFLOW_GLOBALS_DIR = path9.join(".lotics", "workflows");
+var AGENTS_DIR = path9.join("src", "agents");
 var WORKFLOW_TSCONFIG_EXCLUDES = ["src/workflows", ".lotics/workflows"];
 var LOTICS_INCLUDE_GLOB = ".lotics/**/*";
 var STALE_LOTICS_INCLUDES = /* @__PURE__ */ new Set([".lotics", "./.lotics", ".lotics/"]);
@@ -71314,7 +71391,7 @@ function isMissingWorkflowBodyError(error52) {
   return /has no step source|cannot be rendered|unsupported step/i.test(error52);
 }
 function workflowFileHeader(alias) {
-  const refPath = path10.join("..", "..", WORKFLOW_GLOBALS_DIR, `${alias}.globals.d.ts`).split(path10.sep).join("/");
+  const refPath = path9.join("..", "..", WORKFLOW_GLOBALS_DIR, `${alias}.globals.d.ts`).split(path9.sep).join("/");
   return (
     // The scaffold ships oxlint, whose `triple-slash-reference` rule flags the
     // line below — so every pulled body arrived with a warning its author could
@@ -71337,27 +71414,27 @@ export {};
   );
 }
 function workflowFilePath(projectDir, alias) {
-  return path10.join(projectDir, WORKFLOWS_DIR, `${alias}.ts`);
+  return path9.join(projectDir, WORKFLOWS_DIR, `${alias}.ts`);
 }
 var GLOBALS_SUFFIX = ".globals.d.ts";
 function workflowGlobalsPath(projectDir, alias) {
-  return path10.join(projectDir, WORKFLOW_GLOBALS_DIR, `${alias}${GLOBALS_SUFFIX}`);
+  return path9.join(projectDir, WORKFLOW_GLOBALS_DIR, `${alias}${GLOBALS_SUFFIX}`);
 }
 function pruneOrphanWorkflowGlobals(projectDir, declared) {
-  const dir = path10.join(projectDir, WORKFLOW_GLOBALS_DIR);
+  const dir = path9.join(projectDir, WORKFLOW_GLOBALS_DIR);
   if (!fs8.existsSync(dir)) return [];
   const removed = [];
   for (const entry of fs8.readdirSync(dir)) {
     if (!entry.endsWith(GLOBALS_SUFFIX)) continue;
     const alias = entry.slice(0, -GLOBALS_SUFFIX.length);
     if (declared.has(alias)) continue;
-    fs8.unlinkSync(path10.join(dir, entry));
+    fs8.unlinkSync(path9.join(dir, entry));
     removed.push(alias);
   }
   return removed.sort();
 }
 function orphanWorkflowBodies(projectDir, declared) {
-  const dir = path10.join(projectDir, WORKFLOWS_DIR);
+  const dir = path9.join(projectDir, WORKFLOWS_DIR);
   if (!fs8.existsSync(dir)) return [];
   return fs8.readdirSync(dir).filter((e) => e.endsWith(".ts") && !e.endsWith(".d.ts") && !e.endsWith(".test.ts")).map((e) => e.slice(0, -".ts".length)).filter((alias) => !declared.has(alias)).sort();
 }
@@ -71395,7 +71472,7 @@ function staleWorkflowGlobals(projectDir, workflows) {
   return out;
 }
 function writeWorkflowGlobals(projectDir, alias, dts, declaration) {
-  const dir = path10.join(projectDir, WORKFLOW_GLOBALS_DIR);
+  const dir = path9.join(projectDir, WORKFLOW_GLOBALS_DIR);
   fs8.mkdirSync(dir, { recursive: true });
   const file2 = workflowGlobalsPath(projectDir, alias);
   const stamp = `${GLOBALS_STAMP_PREFIX}${workflowDeclarationStamp(declaration)}`;
@@ -71408,7 +71485,7 @@ function normalizeWorkflowBody(source) {
   return source.replace(/\s+$/, "");
 }
 function writeWorkflowFile(projectDir, alias, source, envelope2 = { prefix: WORKFLOW_ENVELOPE_PREFIX, suffix: WORKFLOW_ENVELOPE_SUFFIX }) {
-  const dir = path10.join(projectDir, WORKFLOWS_DIR);
+  const dir = path9.join(projectDir, WORKFLOWS_DIR);
   fs8.mkdirSync(dir, { recursive: true });
   const file2 = workflowFilePath(projectDir, alias);
   const body = normalizeWorkflowBody(source);
@@ -71418,14 +71495,14 @@ ${envelope2.prefix}${body}${envelope2.suffix}
   return file2;
 }
 function agentFilePath2(projectDir, alias) {
-  return path10.join(projectDir, ...agentFilePath(alias).split("/"));
+  return path9.join(projectDir, ...agentFilePath(alias).split("/"));
 }
 var CLI_AGENT_NOTES = [
   "Pulled from the LIVE app row; edit here, then: lotics app agent set <alias>",
   "The typed fields (inputs/outputs/tool_names/model_tier) live in package.json#lotics.agents"
 ];
 function writeAgentFile(projectDir, alias, instructions) {
-  fs8.mkdirSync(path10.join(projectDir, AGENTS_DIR), { recursive: true });
+  fs8.mkdirSync(path9.join(projectDir, AGENTS_DIR), { recursive: true });
   const file2 = agentFilePath2(projectDir, alias);
   fs8.writeFileSync(
     file2,
@@ -71451,15 +71528,15 @@ function writeAgentFiles(projectDir, agents, opts) {
   return written;
 }
 function parkLiveAgentProse(projectDir, alias, instructions) {
-  const dir = path10.join(projectDir, ".lotics", "agents");
-  const file2 = path10.join(dir, `${alias}.live.md`);
+  const dir = path9.join(projectDir, ".lotics", "agents");
+  const file2 = path9.join(dir, `${alias}.live.md`);
   try {
     fs8.mkdirSync(dir, { recursive: true });
     fs8.writeFileSync(file2, normalizeAgentInstructions(instructions) + "\n");
-    return path10.relative(projectDir, file2);
+    return path9.relative(projectDir, file2);
   } catch (err2) {
     console.error(
-      `\u26A0 Could not write the live prose for ${alias} to ${path10.relative(projectDir, file2)}: ${err2 instanceof Error ? err2.message : String(err2)}`
+      `\u26A0 Could not write the live prose for ${alias} to ${path9.relative(projectDir, file2)}: ${err2 instanceof Error ? err2.message : String(err2)}`
     );
     return null;
   }
@@ -71475,15 +71552,15 @@ function reportUnseenLive(kind, unseen, appId) {
   );
 }
 function parkLiveWorkflowBody(projectDir, alias, source) {
-  const dir = path10.join(projectDir, WORKFLOW_GLOBALS_DIR);
-  const file2 = path10.join(dir, `${alias}.live.ts`);
+  const dir = path9.join(projectDir, WORKFLOW_GLOBALS_DIR);
+  const file2 = path9.join(dir, `${alias}.live.ts`);
   try {
     fs8.mkdirSync(dir, { recursive: true });
     fs8.writeFileSync(file2, normalizeWorkflowBody(source) + "\n");
-    return path10.relative(projectDir, file2);
+    return path9.relative(projectDir, file2);
   } catch (err2) {
     console.error(
-      `\u26A0 Could not write the live body for ${alias} to ${path10.relative(projectDir, file2)}: ${err2 instanceof Error ? err2.message : String(err2)}`
+      `\u26A0 Could not write the live body for ${alias} to ${path9.relative(projectDir, file2)}: ${err2 instanceof Error ? err2.message : String(err2)}`
     );
     return null;
   }
@@ -71573,12 +71650,12 @@ async function writeWorkflowFiles(client, projectDir, app_id, appName, workflows
   return { written, kept, unseenLive };
 }
 function writeWorkflowDescription(projectDir, alias, description) {
-  const pkgPath2 = path10.join(projectDir, "package.json");
-  const pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
-  const declaration = pkg2.lotics?.workflows?.[alias];
+  const pkgPath = path9.join(projectDir, "package.json");
+  const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf-8"));
+  const declaration = pkg.lotics?.workflows?.[alias];
   if (!declaration) return;
   declaration.description = description;
-  fs8.writeFileSync(pkgPath2, JSON.stringify(pkg2, null, 2) + "\n");
+  fs8.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
 }
 async function fetchWorkflowGlobals(client, projectDir, app_id, alias, declaration) {
   try {
@@ -71616,63 +71693,128 @@ function runTar(args, cwd) {
     });
   });
 }
+function npmIsInstalled() {
+  return new Promise((resolve2) => {
+    const probe = spawn2("npm", ["--version"], {
+      shell: process.platform === "win32",
+      stdio: "ignore",
+      env: ipv4ChildEnv(process.env)
+    });
+    probe.on("error", () => resolve2(false));
+    probe.on("exit", (code) => resolve2(code === 0));
+  });
+}
 function runNpm(args, cwd) {
+  const quiet = isMachineOutput();
   return new Promise((resolve2, reject2) => {
-    const proc = spawn2("npm", args, { cwd, stdio: "inherit", env: ipv4ChildEnv(process.env) });
-    proc.on("error", reject2);
+    const proc = spawn2("npm", args, {
+      cwd,
+      // On Windows `npm` is `npm.cmd`, a batch file Node will not execute
+      // without a shell — bare `spawn("npm")` dies at ENOENT, which took every
+      // command that installs or builds with it. A shell is safe here because
+      // the arguments are literals this file writes (`run build`, `ci
+      // --ignore-scripts`); nothing a caller supplies reaches the command line.
+      //
+      // The alternative — run npm's own JS entry with `process.execPath`, as
+      // `dev/server.ts` does for vite — works there because vite sits at a known
+      // path inside the project. npm does not: nvm-windows, volta, corepack and
+      // the installer each put it somewhere different, and letting the platform
+      // resolve its own shim is the one approach that finds all of them.
+      shell: process.platform === "win32",
+      stdio: quiet ? ["ignore", "pipe", "pipe"] : "inherit",
+      env: ipv4ChildEnv(process.env)
+    });
+    let captured = "";
+    if (quiet) {
+      const collect = (chunk) => {
+        captured += chunk.toString();
+        if (captured.length > NPM_LOG_TAIL_BYTES * 2) {
+          captured = captured.slice(-NPM_LOG_TAIL_BYTES);
+        }
+      };
+      proc.stdout?.on("data", collect);
+      proc.stderr?.on("data", collect);
+    }
+    proc.on("error", (error52) => void failed(error52, null));
     proc.on("exit", (code) => {
-      if (code === 0) resolve2();
-      else reject2(new Error(`npm ${args.join(" ")} exited with code ${code}`));
+      if (code === 0) {
+        resolve2();
+        return;
+      }
+      void failed(void 0, code);
     });
+    async function failed(error52, code) {
+      if (!await npmIsInstalled()) {
+        reject2(
+          new Error(
+            "npm was not found, and building an app needs it.\n  Install Node.js 18 or newer (npm comes with it), then run this again:\n    https://nodejs.org/en/download\n  The Lotics CLI itself needs no Node \u2014 only this build step does."
+          )
+        );
+        return;
+      }
+      if (error52 !== void 0) {
+        reject2(error52);
+        return;
+      }
+      const tail = captured.slice(-NPM_LOG_TAIL_BYTES).trim();
+      reject2(
+        new Error(
+          `npm ${args.join(" ")} exited with code ${code}` + (tail === "" ? "" : `
+--- npm output ---
+${tail}`)
+        )
+      );
+    }
   });
 }
+var NPM_LOG_TAIL_BYTES = 8e3;
 function npmInstallArgs(hasLockfile) {
   return [hasLockfile ? "ci" : "install", "--ignore-scripts"];
 }
 function runNpmInstall(cwd) {
-  const hasLockfile = fs8.existsSync(path10.join(cwd, "package-lock.json"));
-  console.error(
+  const hasLockfile = fs8.existsSync(path9.join(cwd, "package-lock.json"));
+  note(
     hasLockfile ? "Installing npm dependencies (npm ci \u2014 the lockfile's exact tree, no install scripts)..." : "Installing npm dependencies (no lockfile yet \u2014 resolving ranges, no install scripts)..."
   );
   return runNpm(npmInstallArgs(hasLockfile), cwd);
 }
 function readAppWorkspaceId(projectDir) {
   try {
-    const pkgPath2 = path10.join(projectDir, "package.json");
-    if (!fs8.existsSync(pkgPath2)) return null;
-    const pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
-    return pkg2.lotics?.workspace_id ?? null;
+    const pkgPath = path9.join(projectDir, "package.json");
+    if (!fs8.existsSync(pkgPath)) return null;
+    const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf-8"));
+    return pkg.lotics?.workspace_id ?? null;
   } catch {
     return null;
   }
 }
 function readAppMeta(projectDir) {
-  const pkgPath2 = path10.join(projectDir, "package.json");
-  if (!fs8.existsSync(pkgPath2)) {
+  const pkgPath = path9.join(projectDir, "package.json");
+  if (!fs8.existsSync(pkgPath)) {
     throw new Error(`No package.json found at ${projectDir}. Run 'lotics app create' first.`);
   }
-  const pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
-  if (!pkg2.lotics?.app_id || !pkg2.lotics.workspace_id) {
+  const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf-8"));
+  if (!pkg.lotics?.app_id || !pkg.lotics.workspace_id) {
     throw new Error(
       `package.json is missing the 'lotics' field with app_id and workspace_id. Was this folder created with 'lotics app create'?`
     );
   }
-  noteScope({ app_id: pkg2.lotics.app_id });
+  noteScope({ app_id: pkg.lotics.app_id });
   return {
-    app_id: pkg2.lotics.app_id,
-    workspace_id: pkg2.lotics.workspace_id,
-    current_version_id: pkg2.lotics.current_version_id ?? null,
-    version_number: pkg2.lotics.version_number ?? null,
-    workflows: pkg2.lotics.workflows ?? {},
-    queries: pkg2.lotics.queries ?? {},
-    agents: pkg2.lotics.agents ?? {},
-    capabilities: pkg2.lotics.capabilities
+    app_id: pkg.lotics.app_id,
+    workspace_id: pkg.lotics.workspace_id,
+    current_version_id: pkg.lotics.current_version_id ?? null,
+    version_number: pkg.lotics.version_number ?? null,
+    workflows: pkg.lotics.workflows ?? {},
+    queries: pkg.lotics.queries ?? {},
+    agents: pkg.lotics.agents ?? {},
+    capabilities: pkg.lotics.capabilities
   };
 }
 function writeAppMeta(projectDir, meta3) {
-  const pkgPath2 = path10.join(projectDir, "package.json");
-  const pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
-  const existing = pkg2.lotics && typeof pkg2.lotics === "object" ? pkg2.lotics : {};
+  const pkgPath = path9.join(projectDir, "package.json");
+  const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf-8"));
+  const existing = pkg.lotics && typeof pkg.lotics === "object" ? pkg.lotics : {};
   const supplied = new Set(
     Object.entries(meta3).filter(([, value2]) => value2 !== void 0).map(([key]) => key)
   );
@@ -71680,20 +71822,20 @@ function writeAppMeta(projectDir, meta3) {
   for (const [key, value2] of Object.entries(existing)) {
     if (!supplied.has(key)) preserved[key] = value2;
   }
-  pkg2.lotics = { ...meta3, ...preserved };
-  fs8.writeFileSync(pkgPath2, JSON.stringify(pkg2, null, 2) + "\n");
+  pkg.lotics = { ...meta3, ...preserved };
+  fs8.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
 }
 function writeWorkflowOutputs(projectDir, alias, outputs) {
-  const pkgPath2 = path10.join(projectDir, "package.json");
-  const pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
-  const declaration = pkg2.lotics?.workflows?.[alias];
+  const pkgPath = path9.join(projectDir, "package.json");
+  const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf-8"));
+  const declaration = pkg.lotics?.workflows?.[alias];
   if (!declaration) {
     throw new Error(
       `package.json#lotics.workflows.${alias} disappeared before the derived-outputs write-back.`
     );
   }
   declaration.outputs = outputs;
-  fs8.writeFileSync(pkgPath2, JSON.stringify(pkg2, null, 2) + "\n");
+  fs8.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
 }
 function workflowBodyDrift(projectDir, workflows, synced = {}) {
   const drifted = [];
@@ -71709,7 +71851,7 @@ function workflowBodyDrift(projectDir, workflows, synced = {}) {
   return drifted;
 }
 function ensureAppTsconfig(projectDir) {
-  const tsconfigPath = path10.join(projectDir, "tsconfig.json");
+  const tsconfigPath = path9.join(projectDir, "tsconfig.json");
   if (!fs8.existsSync(tsconfigPath)) {
     console.error(
       `\u26A0 No tsconfig.json at ${projectDir} \u2014 could not ensure "include" has "${LOTICS_INCLUDE_GLOB}" (a bare .lotics loads none of the generated types) or "exclude" has ${WORKFLOW_TSCONFIG_EXCLUDES.join(", ")}.`
@@ -71761,15 +71903,15 @@ function writeDevLinkTsconfig(projectDir) {
   if (uiSrc) {
     paths["@lotics/ui/*"] = [`${uiSrc}/*`];
     for (const peer of readKitPeerNames(projectDir)) {
-      const typesDir = path10.join(projectDir, "node_modules", typesPackageFor(peer));
-      const runtimeDir = path10.join(projectDir, "node_modules", peer);
+      const typesDir = path9.join(projectDir, "node_modules", typesPackageFor(peer));
+      const runtimeDir = path9.join(projectDir, "node_modules", peer);
       const target = fs8.existsSync(typesDir) ? `../node_modules/${typesPackageFor(peer)}` : fs8.existsSync(runtimeDir) ? `../node_modules/${peer}` : null;
       if (!target) continue;
       paths[peer] = [target];
       paths[`${peer}/*`] = [`${target}/*`];
     }
   }
-  const file2 = path10.join(projectDir, ".lotics", "tsconfig.link.json");
+  const file2 = path9.join(projectDir, ".lotics", "tsconfig.link.json");
   const header = uiSrc ? `// GENERATED by \`lotics app codegen\` \u2014 do not edit.
 // LOTICS_UI_SRC is set, so @lotics/ui resolves to your working copy for tsc,
 // vitest, eslint and your editor \u2014 the same copy Vite is bundling. The peer
@@ -71786,8 +71928,8 @@ function writeDevLinkTsconfig(projectDir) {
 }
 function writeKitTypeAugmentation(projectDir) {
   const uiSrc = process.env.LOTICS_UI_SRC;
-  const source = uiSrc ? path10.join(uiSrc, "react_native.d.ts") : path10.join(projectDir, "node_modules", "@lotics", "ui", "src", "react_native.d.ts");
-  const target = path10.join(projectDir, ".lotics", "react_native.d.ts");
+  const source = uiSrc ? path9.join(uiSrc, "react_native.d.ts") : path9.join(projectDir, "node_modules", "@lotics", "ui", "src", "react_native.d.ts");
+  const target = path9.join(projectDir, ".lotics", "react_native.d.ts");
   if (!fs8.existsSync(source)) {
     if (fs8.existsSync(target)) fs8.rmSync(target);
     return;
@@ -71804,7 +71946,7 @@ function typesPackageFor(peer) {
   return peer.startsWith("@") ? `@types/${peer.slice(1).replace("/", "__")}` : `@types/${peer}`;
 }
 function readKitPeerNames(projectDir) {
-  const kitPkg = path10.join(projectDir, "node_modules", "@lotics", "ui", "package.json");
+  const kitPkg = path9.join(projectDir, "node_modules", "@lotics", "ui", "package.json");
   if (!fs8.existsSync(kitPkg)) return [];
   const parsed = JSON.parse(fs8.readFileSync(kitPkg, "utf-8"));
   const peers = parsed.peerDependencies;
@@ -71815,12 +71957,12 @@ function writeAppDtsKitLinks(projectDir) {
   writeKitTypeAugmentation(projectDir);
 }
 function writeAppDts(projectDir, manifest) {
-  const dotLotics = path10.join(projectDir, ".lotics");
+  const dotLotics = path9.join(projectDir, ".lotics");
   fs8.mkdirSync(dotLotics, { recursive: true });
   const written = [
-    [path10.join(dotLotics, "app_workflows.d.ts"), generateAppWorkflowsDts(manifest.workflows)],
-    [path10.join(dotLotics, "app_queries.d.ts"), generateAppQueriesDts(manifest.queries)],
-    [path10.join(dotLotics, "app_agents.d.ts"), generateAppAgentsDts(manifest.agents)]
+    [path9.join(dotLotics, "app_workflows.d.ts"), generateAppWorkflowsDts(manifest.workflows)],
+    [path9.join(dotLotics, "app_queries.d.ts"), generateAppQueriesDts(manifest.queries)],
+    [path9.join(dotLotics, "app_agents.d.ts"), generateAppAgentsDts(manifest.agents)]
   ];
   for (const [file2, content] of written) fs8.writeFileSync(file2, content);
   writeAppDtsKitLinks(projectDir);
@@ -71829,8 +71971,8 @@ function writeAppDts(projectDir, manifest) {
   return written.map(([file2]) => file2);
 }
 function readCodegenTablesAllowlist(projectDir) {
-  const pkg2 = JSON.parse(fs8.readFileSync(path10.join(projectDir, "package.json"), "utf-8"));
-  const tables = pkg2.lotics?.codegen?.tables;
+  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) {
@@ -71842,9 +71984,9 @@ function resolveCodegenTableIds(projectDir, queries) {
   return [...ids];
 }
 function writeAppFields(projectDir, tables) {
-  const dotLotics = path10.join(projectDir, ".lotics");
+  const dotLotics = path9.join(projectDir, ".lotics");
   fs8.mkdirSync(dotLotics, { recursive: true });
-  const file2 = path10.join(dotLotics, "app_fields.ts");
+  const file2 = path9.join(dotLotics, "app_fields.ts");
   fs8.writeFileSync(file2, generateAppFields(tables));
   return file2;
 }
@@ -71869,7 +72011,7 @@ async function writeGeneratedAppFields(client, projectDir, app, queries) {
         return;
       }
       const fieldsPath = writeAppFields(projectDir, tables);
-      console.error(
+      note(
         `Wrote ${fieldsPath} (baked form \u2014 bespoke; ${tables.length} table${tables.length === 1 ? "" : "s"})`
       );
     }
@@ -71879,7 +72021,7 @@ async function writeGeneratedAppFields(client, projectDir, app, queries) {
 }
 function warnAppFieldsUnwritten(projectDir, err2) {
   const reason = err2 instanceof Error ? err2.message : String(err2);
-  if (fs8.existsSync(path10.join(projectDir, ".lotics", "app_fields.ts"))) {
+  if (fs8.existsSync(path9.join(projectDir, ".lotics", "app_fields.ts"))) {
     console.error(`\u26A0 Could not regenerate .lotics/app_fields.ts (${reason}). Kept the existing file.`);
     return;
   }
@@ -71890,7 +72032,7 @@ function warnAppFieldsUnwritten(projectDir, err2) {
 function warnAboutDevLink(projectDir, command) {
   const uiSrc = process.env.LOTICS_UI_SRC;
   if (!uiSrc) return;
-  const viteConfigPath = path10.join(projectDir, "vite.config.ts");
+  const viteConfigPath = path9.join(projectDir, "vite.config.ts");
   const config2 = fs8.existsSync(viteConfigPath) ? fs8.readFileSync(viteConfigPath, "utf-8") : "";
   const linked = config2.includes("loticsResolve") || config2.includes("LOTICS_UI_SRC");
   if (!linked) {
@@ -71909,9 +72051,9 @@ function warnAboutDevLink(projectDir, command) {
   }
 }
 var KIT_PACKAGES = ["@lotics/ui", "@lotics/app-sdk"];
-function installedKitVersion(projectDir, pkg2) {
+function installedKitVersion(projectDir, pkg) {
   try {
-    const manifest = path10.join(projectDir, "node_modules", ...pkg2.split("/"), "package.json");
+    const manifest = path9.join(projectDir, "node_modules", ...pkg.split("/"), "package.json");
     const parsed = JSON.parse(fs8.readFileSync(manifest, "utf-8"));
     const version2 = parsed.version;
     return typeof version2 === "string" ? version2 : null;
@@ -71919,12 +72061,12 @@ function installedKitVersion(projectDir, pkg2) {
     return null;
   }
 }
-async function publishedKitVersion(pkg2) {
+async function publishedKitVersion(pkg) {
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), 3e3);
   timeout.unref();
   try {
-    const response = await fetch(`https://registry.npmjs.org/${pkg2}/latest`, {
+    const response = await fetch(`https://registry.npmjs.org/${pkg}/latest`, {
       signal: controller.signal
     });
     if (!response.ok) return null;
@@ -71938,13 +72080,13 @@ async function publishedKitVersion(pkg2) {
 }
 async function warnIfKitBehind(projectDir) {
   const checks = await Promise.all(
-    KIT_PACKAGES.map(async (pkg2) => {
-      const installed = installedKitVersion(projectDir, pkg2);
+    KIT_PACKAGES.map(async (pkg) => {
+      const installed = installedKitVersion(projectDir, pkg);
       if (!installed) return null;
-      const latest = await publishedKitVersion(pkg2);
+      const latest = await publishedKitVersion(pkg);
       if (!latest || !isNewerVersion(latest, installed)) return null;
       const behindMajor = (Number.parseInt(latest, 10) || 0) > (Number.parseInt(installed, 10) || 0);
-      return { pkg: pkg2, installed, latest, behindMajor };
+      return { pkg, installed, latest, behindMajor };
     })
   );
   const findings = checks.filter((c) => c !== null);
@@ -71959,7 +72101,7 @@ async function warnIfKitBehind(projectDir) {
 
   Breaking changes are listed newest-first in
   node_modules/@lotics/ui/MIGRATION.md.` : "";
-    console.error(
+    warn(
       `
 \u26A0 This app builds against a kit a major release behind:
 ` + lines.join("\n") + migration + `
@@ -71975,12 +72117,12 @@ A newer kit is published \u2014 \`npm update ${findings.map((f) => f.pkg).join("
   );
 }
 function ensureAppVitestSetup(projectDir) {
-  const setupPath = path10.join(projectDir, VITEST_SETUP_FILENAME);
+  const setupPath = path9.join(projectDir, VITEST_SETUP_FILENAME);
   if (!fs8.existsSync(setupPath)) {
     fs8.writeFileSync(setupPath, VITEST_SETUP_CONTENT);
     console.error(`Wrote ${VITEST_SETUP_FILENAME} (wired by vite.config.ts; empty until you fill it).`);
   }
-  const viteConfigPath = path10.join(projectDir, "vite.config.ts");
+  const viteConfigPath = path9.join(projectDir, "vite.config.ts");
   if (!fs8.existsSync(viteConfigPath)) return;
   const viteConfig = fs8.readFileSync(viteConfigPath, "utf-8");
   if (/setupFiles\s*:/.test(viteConfig) && viteConfig.includes(VITEST_SETUP_FILENAME)) return;
@@ -71990,7 +72132,7 @@ function ensureAppVitestSetup(projectDir) {
   );
 }
 async function appCodegen(args) {
-  const projectDir = path10.resolve(args.projectDir ?? process.cwd());
+  const projectDir = path9.resolve(args.projectDir ?? process.cwd());
   const meta3 = readAppMeta(projectDir);
   const dtsPaths = writeAppDts(projectDir, {
     workflows: meta3.workflows,
@@ -72004,7 +72146,7 @@ async function appCodegen(args) {
   }
   for (const alias of orphanWorkflowBodies(projectDir, declared)) {
     console.error(
-      `\u26A0 ${path10.join(WORKFLOWS_DIR, `${alias}.ts`)} is not declared in package.json#lotics.workflows \u2014 'workflow check' and 'workflow set' both skip it. Declare the alias or delete the file.`
+      `\u26A0 ${path9.join(WORKFLOWS_DIR, `${alias}.ts`)} is not declared in package.json#lotics.workflows \u2014 'workflow check' and 'workflow set' both skip it. Declare the alias or delete the file.`
     );
   }
   if (!args.client) {
@@ -72063,15 +72205,15 @@ async function refreshWorkflowTypes(client, projectDir, app_id, alias, declarati
   return true;
 }
 function readPriorStamp(projectDir) {
-  const pkgPath2 = path10.join(projectDir, "package.json");
-  if (!fs8.existsSync(pkgPath2)) return null;
-  let pkg2;
+  const pkgPath = path9.join(projectDir, "package.json");
+  if (!fs8.existsSync(pkgPath)) return null;
+  let pkg;
   try {
-    pkg2 = JSON.parse(fs8.readFileSync(pkgPath2, "utf-8"));
+    pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf-8"));
   } catch {
     return null;
   }
-  const lotics = pkg2.lotics && typeof pkg2.lotics === "object" ? pkg2.lotics : null;
+  const lotics = pkg.lotics && typeof pkg.lotics === "object" ? pkg.lotics : null;
   if (!lotics) return null;
   const id = lotics.current_version_id;
   const number4 = lotics.version_number;
@@ -72132,8 +72274,8 @@ function appDirName(name2) {
 }
 async function materializeScaffold(targetPath, files) {
   for (const file2 of files) {
-    const fullPath = path10.join(targetPath, file2.path);
-    fs8.mkdirSync(path10.dirname(fullPath), { recursive: true });
+    const fullPath = path9.join(targetPath, file2.path);
+    fs8.mkdirSync(path9.dirname(fullPath), { recursive: true });
     fs8.writeFileSync(fullPath, file2.content);
   }
   console.error(`Scaffolded ${files.length} files into ${targetPath}`);
@@ -72142,7 +72284,7 @@ async function materializeScaffold(targetPath, files) {
   writeAppDtsKitLinks(targetPath);
 }
 async function appCreate(client, args) {
-  const targetPath = path10.resolve(args.targetPath ?? appDirName(args.name));
+  const targetPath = path9.resolve(args.targetPath ?? appDirName(args.name));
   if (fs8.existsSync(targetPath)) {
     const entries2 = fs8.readdirSync(targetPath);
     if (entries2.length > 0) {
@@ -72171,7 +72313,7 @@ async function appCreate(client, args) {
   });
   console.error(`
 Ready. Next steps:`);
-  console.error(`  cd ${path10.relative(process.cwd(), targetPath) || "."}`);
+  console.error(`  cd ${path9.relative(process.cwd(), targetPath) || "."}`);
   console.error(`  lotics docs                # the contracts, at the versions installed here`);
   console.error(`  # edit src/App.tsx, then:`);
   console.error(`  lotics app check           # every pre-flight a deploy runs`);
@@ -72230,17 +72372,17 @@ async function appVersions(client, args) {
   }
 }
 function defaultPullTarget(appId, appName) {
-  const cwdPkgPath = path10.join(process.cwd(), "package.json");
+  const cwdPkgPath = path9.join(process.cwd(), "package.json");
   if (fs8.existsSync(cwdPkgPath)) {
-    let pkg2 = null;
+    let pkg = null;
     try {
-      pkg2 = JSON.parse(fs8.readFileSync(cwdPkgPath, "utf-8"));
+      pkg = JSON.parse(fs8.readFileSync(cwdPkgPath, "utf-8"));
     } catch (err2) {
       console.error(
         `\u26A0 Could not parse ${cwdPkgPath} (${err2 instanceof Error ? err2.message : String(err2)}) \u2014 pulling into a fresh ${appDirName(appName)}/ subdir.`
       );
     }
-    if (pkg2?.lotics?.app_id === appId) return process.cwd();
+    if (pkg?.lotics?.app_id === appId) return process.cwd();
   }
   return appDirName(appName);
 }
@@ -72280,7 +72422,7 @@ async function hydrateAppProject(client, targetPath, app, opts) {
     );
     opts.kept.push(...kept);
     if (written.length > 0) {
-      console.error(
+      note(
         `Wrote ${written.length} workflow ${written.length === 1 ? "body" : "bodies"} to ${WORKFLOWS_DIR}/ (${written.join(", ")})`
       );
     }
@@ -72312,7 +72454,7 @@ async function hydrateAppProject(client, targetPath, app, opts) {
       unseenLiveProse.push({ alias, parked: parkLiveAgentProse(targetPath, alias, instructions) });
     }
     if (written.length > 0) {
-      console.error(
+      note(
         `Wrote ${written.length} agent instruction ${written.length === 1 ? "file" : "files"} to ${AGENTS_DIR}/ (${written.join(", ")})`
       );
     }
@@ -72332,21 +72474,21 @@ async function appPull(client, args) {
   if (!versionId) throw new Error(`App ${app.id} has no version to pull.`);
   const version2 = await client.getAppVersion(app.id, versionId);
   const sourceUrl = await client.getAppVersionSourceUrl(app.id, version2.id);
-  const targetPath = path10.resolve(args.targetPath ?? defaultPullTarget(app.id, app.name));
+  const targetPath = path9.resolve(args.targetPath ?? defaultPullTarget(app.id, app.name));
   fs8.mkdirSync(targetPath, { recursive: true });
   const prior = readPriorStamp(targetPath);
-  const tmpFile = path10.join(tmpdir(), `lotics-app-${app.id}-${Date.now()}.tar.gz`);
+  const tmpFile = path9.join(tmpdir(), `lotics-app-${app.id}-${Date.now()}.tar.gz`);
   console.error(`Downloading source archive...`);
   await downloadToFile(sourceUrl, tmpFile);
   const keptLocal = [];
   const restoredFromArchive = [];
-  const stagingDir = fs8.mkdtempSync(path10.join(tmpdir(), `lotics-pull-${app.id}-`));
+  const stagingDir = fs8.mkdtempSync(path9.join(tmpdir(), `lotics-pull-${app.id}-`));
   try {
     await runTar(["-xzf", tmpFile, "-C", stagingDir], stagingDir);
     console.error(`Extracting to ${targetPath}...`);
     const copied = copyTree(stagingDir, targetPath, {
       overwrite: args.force === true,
-      skip: [WORKFLOWS_DIR, AGENTS_DIR].map((d) => d.split(path10.sep).join("/"))
+      skip: [WORKFLOWS_DIR, AGENTS_DIR].map((d) => d.split(path9.sep).join("/"))
     });
     keptLocal.push(...copied.kept);
     restoredFromArchive.push(...copied.created);
@@ -72375,20 +72517,20 @@ async function appPull(client, args) {
   });
   console.error(`
 Ready. Next steps:`);
-  console.error(`  cd ${path10.relative(process.cwd(), targetPath) || "."}`);
+  console.error(`  cd ${path9.relative(process.cwd(), targetPath) || "."}`);
   console.error(`  lotics docs                # the contracts, at the versions installed here`);
   console.error(`  # edit src/App.tsx, then:`);
   console.error(`  lotics app deploy`);
 }
 function readAppSourceText(projectDir) {
-  const srcDir = path10.join(projectDir, "src");
+  const srcDir = path9.join(projectDir, "src");
   if (!fs8.existsSync(srcDir)) return "";
   const parts = [];
   const walk2 = (dir) => {
     for (const entry of fs8.readdirSync(dir, { withFileTypes: true })) {
-      const full = path10.join(dir, entry.name);
+      const full = path9.join(dir, entry.name);
       if (entry.isDirectory()) walk2(full);
-      else if (isAppSourcePath(path10.relative(projectDir, full))) {
+      else if (isAppSourcePath(path9.relative(projectDir, full))) {
         parts.push(fs8.readFileSync(full, "utf8"));
       }
     }
@@ -72397,7 +72539,7 @@ function readAppSourceText(projectDir) {
   return parts.join("\n");
 }
 async function appDeploy(client, args) {
-  const projectDir = path10.resolve(args.projectDir ?? process.cwd());
+  const projectDir = path9.resolve(args.projectDir ?? process.cwd());
   const meta3 = readAppMeta(projectDir);
   warnAboutDevLink(projectDir, "deploy");
   const liveApp = await client.getApp(meta3.app_id);
@@ -72426,23 +72568,23 @@ async function appDeploy(client, args) {
       meta3.queries ?? {}
     );
   } catch (err2) {
-    console.error(
+    warn(
       `\u26A0 Could not regenerate .lotics/app_fields.ts (${err2.message}).
   The build will use whatever is on disk \u2014 run 'lotics app codegen' if this app is published.`
     );
   }
-  console.error("Building...");
+  note("Building...");
   await runNpm(["run", "build"], projectDir);
-  const distDir = path10.join(projectDir, "dist");
+  const distDir = path9.join(projectDir, "dist");
   if (!fs8.existsSync(distDir)) {
     throw new Error(
       `Build did not produce a dist/ directory in ${projectDir}. Check that 'npm run build' is configured correctly (Vite/etc. defaults to dist/).`
     );
   }
-  const tmpSource = path10.join(tmpdir(), `lotics-source-${Date.now()}.tar.gz`);
-  const tmpDist = path10.join(tmpdir(), `lotics-dist-${Date.now()}.tar.gz`);
+  const tmpSource = path9.join(tmpdir(), `lotics-source-${Date.now()}.tar.gz`);
+  const tmpDist = path9.join(tmpdir(), `lotics-dist-${Date.now()}.tar.gz`);
   try {
-    console.error("Packaging source...");
+    note("Packaging source...");
     await runTar(
       [
         "-czf",
@@ -72456,10 +72598,10 @@ async function appDeploy(client, args) {
       ],
       projectDir
     );
-    console.error("Packaging dist...");
+    note("Packaging dist...");
     await runTar(["-czf", tmpDist, "-C", distDir, "."], projectDir);
     const liveQueries = await readLiveQueries(client, meta3.app_id);
-    console.error("Uploading...");
+    note("Uploading...");
     try {
       const result = await client.deployAppVersion({
         queries: liveQueries,
@@ -72498,23 +72640,23 @@ async function appDeploy(client, args) {
         current_version_id: result.version_id,
         version_number: result.version_number
       });
-      console.error(`Deployed v${result.version_number} (${result.version_id})`);
-      console.error(`Bundle size: ${(result.bundle_size_bytes / 1024).toFixed(1)} KB`);
+      note(`Deployed v${result.version_number} (${result.version_id})`);
+      note(`Bundle size: ${(result.bundle_size_bytes / 1024).toFixed(1)} KB`);
       try {
         const drifted = staleWorkflowGlobals(projectDir, meta3.workflows ?? {});
         for (const { alias, declaration } of drifted) {
           if (await refreshWorkflowTypes(client, projectDir, meta3.app_id, alias, declaration)) {
-            console.error(`Refreshed workflow types for ${alias} \u2014 this deploy moved its declaration.`);
+            note(`Refreshed workflow types for ${alias} \u2014 this deploy moved its declaration.`);
           }
         }
       } catch (err2) {
-        console.error(`(types not refreshed: ${err2.message})`);
+        warn(`(types not refreshed: ${err2.message})`);
       }
       let liveAfter;
       try {
         liveAfter = await client.getApp(meta3.app_id);
       } catch (err2) {
-        console.error(`(skipped post-deploy checks: ${err2.message})`);
+        warn(`(skipped post-deploy checks: ${err2.message})`);
       }
       if (liveAfter) {
         warnIfUnbranded(liveAfter);
@@ -72555,7 +72697,7 @@ function warnIfUnbranded(app) {
   if (!app.icon) missing.push("icon");
   if (!app.theme?.color) missing.push("color");
   if (missing.length === 0) return;
-  console.error(
+  warn(
     `
 \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":"${app.id}","icon":"<lucide-name>","theme":{"color":"blue"}}'
@@ -72584,7 +72726,7 @@ async function readLiveQueries(client, appId) {
   }
 }
 async function appCheck(client, args = {}) {
-  const projectDir = path10.resolve(args.projectDir ?? process.cwd());
+  const projectDir = path9.resolve(args.projectDir ?? process.cwd());
   const meta3 = readAppMeta(projectDir);
   const app = await client.getApp(meta3.app_id);
   assertProjectIsCurrent(meta3, app);
@@ -72859,10 +73001,10 @@ function copyTree(from, to, opts, relative = "") {
   const kept = [];
   const created = [];
   for (const entry of fs8.readdirSync(from, { withFileTypes: true })) {
-    const src = path10.join(from, entry.name);
-    const dest = path10.join(to, entry.name);
-    const rel = path10.join(relative, entry.name);
-    if (opts.skip?.includes(rel.split(path10.sep).join("/"))) continue;
+    const src = path9.join(from, entry.name);
+    const dest = path9.join(to, entry.name);
+    const rel = path9.join(relative, entry.name);
+    if (opts.skip?.includes(rel.split(path9.sep).join("/"))) continue;
     if (entry.isDirectory()) {
       fs8.mkdirSync(dest, { recursive: true });
       const child = copyTree(src, dest, opts, rel);
@@ -73035,9 +73177,9 @@ function warnIfProjectFootguns(projectDir, sourceText) {
       ].join("\n")
     );
   }
-  const configName = VITE_CONFIG_NAMES.find((name2) => fs8.existsSync(path10.join(projectDir, name2)));
+  const configName = VITE_CONFIG_NAMES.find((name2) => fs8.existsSync(path9.join(projectDir, name2)));
   if (configName !== void 0) {
-    const config2 = fs8.readFileSync(path10.join(projectDir, configName), "utf-8");
+    const config2 = fs8.readFileSync(path9.join(projectDir, configName), "utf-8");
     const defined = defineBlockKeys(config2);
     const missing = ["global", "__DEV__"].filter((name2) => !defined.has(name2));
     if (missing.length > 0) {
@@ -73133,7 +73275,7 @@ function warnIfUnboundAliases(app, called) {
   console.error(lines.join("\n"));
 }
 async function appDev(client, args) {
-  const projectDir = path10.resolve(args.projectDir ?? process.cwd());
+  const projectDir = path9.resolve(args.projectDir ?? process.cwd());
   const meta3 = readAppMeta(projectDir);
   warnAboutDevLink(projectDir, "dev");
   writeAppDts(projectDir, { workflows: meta3.workflows, queries: meta3.queries, agents: meta3.agents });
@@ -73267,7 +73409,7 @@ async function appAgentSet(client, args) {
     }
     if (!hasDeclaration) {
       console.error(
-        `No instructions at ${path10.relative(projectDir, file2)}, and nothing declared in package.json#lotics.agents.${args.alias} to push instead.
+        `No instructions at ${path9.relative(projectDir, file2)}, and nothing declared in package.json#lotics.agents.${args.alias} to push instead.
   Run 'lotics app pull ${meta3.app_id}' to write ${AGENTS_DIR}/${args.alias}.md, then edit it.`
       );
       process.exit(1);
@@ -73276,7 +73418,7 @@ async function appAgentSet(client, args) {
   const instructions = hasProse ? stripAgentHeader(fs8.readFileSync(file2, "utf-8")) : void 0;
   if (instructions === "") {
     console.error(
-      `${path10.relative(projectDir, file2)} is empty after stripping the header \u2014 refusing to push an empty prompt.`
+      `${path9.relative(projectDir, file2)} is empty after stripping the header \u2014 refusing to push an empty prompt.`
     );
     process.exit(1);
   }
@@ -73343,7 +73485,7 @@ async function appWorkflowSet(client, args) {
   const file2 = workflowFilePath(projectDir, args.alias);
   if (!fs8.existsSync(file2)) {
     console.error(
-      `No workflow body at ${path10.relative(projectDir, file2)}.
+      `No workflow body at ${path9.relative(projectDir, file2)}.
   If "${args.alias}" is already bound:  lotics app pull ${meta3.app_id}   (writes the body)
   If it is a NEW alias you declared:    create that file yourself, then re-run this.`
     );
@@ -73352,7 +73494,7 @@ async function appWorkflowSet(client, args) {
   noteScope({ alias: args.alias });
   const source = stripWorkflowHeader(fs8.readFileSync(file2, "utf-8"));
   if (source.trim() === "") {
-    console.error(`Workflow body ${path10.relative(projectDir, file2)} is empty after stripping the header.`);
+    console.error(`Workflow body ${path9.relative(projectDir, file2)} is empty after stripping the header.`);
     process.exit(1);
   }
   const res = await client.setAppWorkflow(meta3.app_id, args.alias, {
@@ -73491,13 +73633,13 @@ async function appWorkflowCheck(args) {
     const globalsPath = workflowGlobalsPath(projectDir, alias);
     if (!fs8.existsSync(bodyPath)) {
       console.error(
-        `\u26A0 Skipped "${alias}" \u2014 no body at ${path10.relative(projectDir, bodyPath)}. Run 'lotics app workflow pull' to write it.`
+        `\u26A0 Skipped "${alias}" \u2014 no body at ${path9.relative(projectDir, bodyPath)}. Run 'lotics app workflow pull' to write it.`
       );
       continue;
     }
     if (!fs8.existsSync(globalsPath)) {
       console.error(
-        `Cannot check "${alias}" \u2014 missing types at ${path10.relative(projectDir, globalsPath)}. Run 'lotics app codegen' to fetch them (it refreshes types WITHOUT touching your body; a pull would overwrite it).`
+        `Cannot check "${alias}" \u2014 missing types at ${path9.relative(projectDir, globalsPath)}. Run 'lotics app codegen' to fetch them (it refreshes types WITHOUT touching your body; a pull would overwrite it).`
       );
       process.exit(1);
     }
@@ -73533,7 +73675,7 @@ async function appWorkflowCheck(args) {
 function printWorkflowCheckResults(projectDir, results) {
   let totalErrors = 0;
   for (const r of results) {
-    const rel = path10.relative(projectDir, r.bodyPath);
+    const rel = path9.relative(projectDir, r.bodyPath);
     if (r.issues.length === 0) {
       console.error(`\u2713 ${r.alias} (${rel}) \u2014 clean`);
       continue;
@@ -73585,6 +73727,7 @@ function parseArgs(argv) {
     remove: void 0,
     includeHidden: false,
     timezone: void 0,
+    email: void 0,
     message: void 0,
     session: void 0,
     port: void 0,
@@ -73669,6 +73812,9 @@ function parseArgs(argv) {
       case "--name":
         flags.name = argv[++i2];
         break;
+      case "--email":
+        flags.email = argv[++i2];
+        break;
       case "--description":
         flags.description = argv[++i2];
         break;
@@ -73779,8 +73925,53 @@ function parseArgs(argv) {
 
 // src/starter_commands.ts
 import fs9 from "node:fs";
-import path11 from "node:path";
+import path10 from "node:path";
 import { tmpdir as tmpdir2 } from "node:os";
+function printStarterRows(rows) {
+  const width = Math.max(...rows.map((row) => row.id.length));
+  for (const row of rows) {
+    const tags = row.tags ?? [];
+    console.log(
+      `  ${row.id.padEnd(width)}  ${row.name}${tags.length > 0 ? `  [${tags.join(", ")}]` : ""}`
+    );
+    if (row.description) console.log(`  ${" ".repeat(width)}  ${row.description}`);
+  }
+}
+function noteCopiedContent(templates, knowledgeDocs) {
+  if (templates.length > 0) {
+    note(
+      `
+  ${templates.length} document template${templates.length === 1 ? "" : "s"}: ${templates.join(", ")}
+  These carry the publisher's wording and details, not yours \u2014 decide which should
+  become your own documents.  Editing them:  lotics docs document_templates`
+    );
+  }
+  if (knowledgeDocs.length > 0) {
+    note(
+      `
+  ${knowledgeDocs.length} knowledge doc${knowledgeDocs.length === 1 ? "" : "s"}: ${knowledgeDocs.join(", ")}
+  These describe how the publisher works, and the app's agents read them.
+  Rewrite what differs:  lotics docs knowledge_docs`
+    );
+  }
+}
+async function starterListPublic() {
+  const starters = await fetchOfficialStarters();
+  if (starters.length === 0) {
+    console.error("No starters are published yet \u2014 build one with `lotics docs building_an_app`.");
+    return;
+  }
+  console.error(`${starters.length} starter${starters.length === 1 ? "" : "s"} published by Lotics:
+`);
+  printStarterRows(starters);
+  console.error(
+    `
+  lotics start <starter_id> --email you@company.com   Copy one \u2014 creates your account too
+
+  This machine has no Lotics account yet, so this is the published shelf.
+  Signed in, the same command also lists what your own organization published.`
+  );
+}
 async function starterList(client) {
   const starters = await client.listStarters();
   if (starters.length === 0) {
@@ -73789,19 +73980,19 @@ async function starterList(client) {
     );
     return;
   }
-  const width = Math.max(...starters.map((s) => s.id.length));
   console.error(`${starters.length} starter${starters.length === 1 ? "" : "s"}:
 `);
-  for (const s of starters) {
-    const tags = [
-      s.is_official ? "official" : null,
-      s.owned_by_caller === true ? "yours" : null
-    ].filter((t) => t !== null);
-    console.log(
-      `  ${s.id.padEnd(width)}  ${s.name}${tags.length > 0 ? `  [${tags.join(", ")}]` : ""}`
-    );
-    if (s.description) console.log(`  ${" ".repeat(width)}  ${s.description}`);
-  }
+  printStarterRows(
+    starters.map((s) => ({
+      id: s.id,
+      name: s.name,
+      description: s.description,
+      tags: [
+        s.is_official ? "official" : null,
+        s.owned_by_caller === true ? "yours" : null
+      ].filter((t) => t !== null)
+    }))
+  );
   console.error(`
   lotics starter init <starter_id>   Copy one into this workspace`);
 }
@@ -73814,6 +74005,9 @@ async function starterShow(client, starter_id) {
 version   ${starter.latest_version}
 trust     ${starter.is_official ? "official \u2014 reviewed by Lotics" : starter.owned_by_caller === true ? "your organization's own" : "not copyable from this organization"}`
   );
+  if (starter.icon !== void 0) {
+    console.log(`icon      ${starter.icon ?? "none \u2014 copies show a generic tile"}`);
+  }
   if (starter.retired_at !== null) {
     console.log(`retired   ${starter.retired_at} \u2014 can no longer be copied`);
   }
@@ -73821,7 +74015,7 @@ trust     ${starter.is_official ? "official \u2014 reviewed by Lotics" : starter
 function reportKnowledgeWarnings(warnings) {
   const missing = warnings.missing_expected_docs;
   if (missing.length === 0) return;
-  console.error(
+  warn(
     `
 \u26A0 ${missing.length} knowledge doc(s) this starter's agents expect are missing here:
 ` + missing.map((name2) => `  \u2022 ${name2}`).join("\n") + `
@@ -73831,40 +74025,55 @@ function reportKnowledgeWarnings(warnings) {
 }
 async function starterInit(client, args) {
   const starter = await client.getPackage(args.starter_id);
-  console.error(
+  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 entities = Object.keys(result.binding.entities ?? {}).length;
-  const docs = Object.keys(result.binding.knowledge ?? {}).length;
-  const templates = Object.keys(result.binding.templates ?? {}).length;
+  const tables = Object.keys(result.binding.entities ?? {}).sort();
+  const knowledgeDocs = Object.keys(result.binding.knowledge ?? {}).sort();
+  const templates = Object.keys(result.binding.templates ?? {}).sort();
   const records = Object.values(result.sample_record_ids).reduce((n, ids) => n + ids.length, 0);
-  console.error(
-    `  Created ${entities} table${entities === 1 ? "" : "s"}, ${templates} template${templates === 1 ? "" : "s"}, ${docs} knowledge doc${docs === 1 ? "" : "s"}, ${records} sample record${records === 1 ? "" : "s"}.`
+  const created = {
+    tables,
+    templates,
+    knowledge_docs: knowledgeDocs,
+    sample_records: records
+  };
+  note(
+    `  Created ${tables.length} table${tables.length === 1 ? "" : "s"}, ${templates.length} template${templates.length === 1 ? "" : "s"}, ${knowledgeDocs.length} knowledge doc${knowledgeDocs.length === 1 ? "" : "s"}, ${records} sample record${records === 1 ? "" : "s"}.`
   );
   reportKnowledgeWarnings(result.knowledge_warnings);
   if (result.app_id === null || result.bundle_url === null) {
-    console.error(`
-Done. The documents and knowledge are yours to edit \u2014 nothing links back.`);
-    return;
+    note(`
+Done \u2014 these are yours now, with no link back to the starter.`);
+    noteCopiedContent(templates, knowledgeDocs);
+    return {
+      starter_id: args.starter_id,
+      starter_name: starter.name,
+      version: result.version,
+      app_id: null,
+      project_dir: null,
+      created,
+      signin_url: null
+    };
   }
-  const targetPath = path11.resolve(args.targetPath ?? appDirName(starter.name));
+  const targetPath = path10.resolve(args.targetPath ?? appDirName(starter.name));
   if (fs9.existsSync(targetPath) && fs9.readdirSync(targetPath).length > 0) {
     throw new Error(
       `Target directory ${targetPath} is not empty. The app (${result.app_id}) was created \u2014 pass an empty path and re-run, or finish it with "lotics app pull ${result.app_id}".`
     );
   }
   fs9.mkdirSync(targetPath, { recursive: true });
-  console.error(`Downloading source\u2026`);
-  const bundleFile = path11.join(tmpdir2(), `lotics-starter-${args.starter_id}-${process.pid}.tar.gz`);
-  const wrapperDir = fs9.mkdtempSync(path11.join(tmpdir2(), `lotics-starter-`));
+  note(`Downloading source\u2026`);
+  const bundleFile = path10.join(tmpdir2(), `lotics-starter-${args.starter_id}-${process.pid}.tar.gz`);
+  const wrapperDir = fs9.mkdtempSync(path10.join(tmpdir2(), `lotics-starter-`));
   try {
     await downloadToFile(result.bundle_url, bundleFile);
     await runTar(["-xzf", bundleFile, "-C", wrapperDir], wrapperDir);
-    const sourceArchive = path11.join(wrapperDir, "source.tar.gz");
+    const sourceArchive = path10.join(wrapperDir, "source.tar.gz");
     if (!fs9.existsSync(sourceArchive)) {
       throw new Error(
         `Starter bundle carried no source.tar.gz \u2014 the app (${result.app_id}) exists but has no code. Report this to the starter's publisher.`
@@ -73876,7 +74085,7 @@ Done. The documents and knowledge are yours to edit \u2014 nothing links back.`)
     fs9.rmSync(wrapperDir, { recursive: true, force: true });
   }
   for (const dir of ["knowledge", "fixtures"]) {
-    fs9.rmSync(path11.join(targetPath, dir), { recursive: true, force: true });
+    fs9.rmSync(path10.join(targetPath, dir), { recursive: true, force: true });
   }
   const app = await client.getApp(result.app_id);
   const kept = [];
@@ -73886,15 +74095,14 @@ Done. The documents and knowledge are yours to edit \u2014 nothing links back.`)
     kept
   });
   if (starter.owned_by_caller !== true) {
-    console.error(
+    warn(
       `
 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 {
-    console.error(`Building and deploying\u2026`);
+    note(`Building and deploying\u2026`);
   }
-  await runNpm(["run", "build"], targetPath);
   await appDeploy(client, {
     projectDir: targetPath,
     message: `Copied from starter ${starter.name}`
@@ -73907,14 +74115,14 @@ Building ${starter.name} \u2014 this runs its build on your machine (its package
     });
     signInUrl = link.url ?? null;
   } catch (error52) {
-    console.error(
+    warn(
       `
   (no sign-in link: ${error52 instanceof Error ? error52.message : String(error52)})
   The copy is complete either way \u2014 open it with "lotics auth web".`
     );
     signInUrl = null;
   }
-  console.error(
+  note(
     `
 Done \u2014 ${starter.name} is live and yours.
   App:     ${result.app_id}
@@ -73922,42 +74130,55 @@ Done \u2014 ${starter.name} is live and yours.
 
   Edit anything: the tables, the app source, the templates, the docs. There is no
   link back to the starter and nothing to upgrade \u2014 this is your app now.
-  Ship a change:  cd ${path11.relative(process.cwd(), targetPath) || "."} && lotics app deploy -m "<what changed>"`
+  Ship a change:  cd ${path10.relative(process.cwd(), targetPath) || "."} && lotics app deploy -m "<what changed>"
+
+  How to change it:  lotics docs building_an_app   (then \`lotics docs\` for the rest \u2014
+  the SDK and UI references are installed in this project, so they match its versions)`
   );
   if (records > 0) {
-    console.error(
+    note(
       `
   ${records} sample record${records === 1 ? "" : "s"} came with it. They are ordinary records \u2014
   delete them whenever you like, or re-run with --no-sample-data next time.`
     );
   }
+  noteCopiedContent(templates, knowledgeDocs);
   if (signInUrl !== null) {
-    console.error(
+    note(
       `
   Open it \u2014 one-time sign-in link, expires in 15 minutes:
     ${signInUrl}`
     );
   }
+  return {
+    starter_id: args.starter_id,
+    starter_name: starter.name,
+    version: result.version,
+    app_id: result.app_id,
+    project_dir: targetPath,
+    created,
+    signin_url: signInUrl
+  };
 }
 async function starterFixturesCapture(client, args) {
-  const projectDir = path11.resolve(args.projectDir ?? process.cwd());
+  const projectDir = path10.resolve(args.projectDir ?? process.cwd());
   const meta3 = readAppMeta(projectDir);
   const result = await client.captureStarterFixtures(meta3.app_id, {
     entities: args.entities,
     ...args.limit !== void 0 ? { limit: args.limit } : {}
   });
-  const fixturesDir = path11.join(projectDir, "fixtures");
+  const fixturesDir = path10.join(projectDir, "fixtures");
   fs9.mkdirSync(fixturesDir, { recursive: true });
   let totalRows = 0;
   for (const entry of result.captured) {
-    const file2 = path11.join(projectDir, entry.content_ref);
+    const file2 = path10.join(projectDir, entry.content_ref);
     fs9.writeFileSync(file2, `${JSON.stringify(entry.file, null, 2)}
 `, "utf-8");
     totalRows += entry.file.rows.length;
     console.error(
       `  ${entry.content_ref}  \u2014  ${entry.file.rows.length} row${entry.file.rows.length === 1 ? "" : "s"}`
     );
-    for (const note of entry.notes) console.error(`      \u26A0 ${note}`);
+    for (const line of entry.notes) console.error(`      \u26A0 ${line}`);
   }
   if (result.captured.length === 0) {
     console.error(
@@ -74041,7 +74262,7 @@ import fs11 from "node:fs";
 
 // src/file_command_io.ts
 import fs10 from "node:fs";
-import path12 from "node:path";
+import path11 from "node:path";
 var CliError = class extends Error {
   constructor(message2) {
     super(message2);
@@ -74064,8 +74285,8 @@ function rejectExtraArgs(rest2, arity, usage) {
   fail2(`${usage} takes ${arity} argument${arity === 1 ? "" : "s"} after <file>, got ${rest2.length}. Unused: ${rest2.slice(arity).join(" ")}`);
 }
 function writeFileAtomic(filePath, bytes) {
-  const dir = path12.dirname(path12.resolve(filePath));
-  const tmp = path12.join(dir, `.${path12.basename(filePath)}.${process.pid}.${Date.now()}.tmp`);
+  const dir = path11.dirname(path11.resolve(filePath));
+  const tmp = path11.join(dir, `.${path11.basename(filePath)}.${process.pid}.${Date.now()}.tmp`);
   fs10.writeFileSync(tmp, bytes);
   try {
     fs10.renameSync(tmp, filePath);
@@ -76868,16 +77089,16 @@ var MatcherView = class {
    * @returns {string|undefined}
    */
   getCurrentTag() {
-    const path14 = this._matcher.path;
-    return path14.length > 0 ? path14[path14.length - 1].tag : void 0;
+    const path13 = this._matcher.path;
+    return path13.length > 0 ? path13[path13.length - 1].tag : void 0;
   }
   /**
    * Get current namespace.
    * @returns {string|undefined}
    */
   getCurrentNamespace() {
-    const path14 = this._matcher.path;
-    return path14.length > 0 ? path14[path14.length - 1].namespace : void 0;
+    const path13 = this._matcher.path;
+    return path13.length > 0 ? path13[path13.length - 1].namespace : void 0;
   }
   /**
    * Get current node's attribute value.
@@ -76885,9 +77106,9 @@ var MatcherView = class {
    * @returns {*}
    */
   getAttrValue(attrName) {
-    const path14 = this._matcher.path;
-    if (path14.length === 0) return void 0;
-    return path14[path14.length - 1].values?.[attrName];
+    const path13 = this._matcher.path;
+    if (path13.length === 0) return void 0;
+    return path13[path13.length - 1].values?.[attrName];
   }
   /**
    * Check if current node has an attribute.
@@ -76895,9 +77116,9 @@ var MatcherView = class {
    * @returns {boolean}
    */
   hasAttr(attrName) {
-    const path14 = this._matcher.path;
-    if (path14.length === 0) return false;
-    const current = path14[path14.length - 1];
+    const path13 = this._matcher.path;
+    if (path13.length === 0) return false;
+    const current = path13[path13.length - 1];
     return current.values !== void 0 && attrName in current.values;
   }
   /**
@@ -76923,18 +77144,18 @@ var MatcherView = class {
    * @returns {number}
    */
   getPosition() {
-    const path14 = this._matcher.path;
-    if (path14.length === 0) return -1;
-    return path14[path14.length - 1].position ?? 0;
+    const path13 = this._matcher.path;
+    if (path13.length === 0) return -1;
+    return path13[path13.length - 1].position ?? 0;
   }
   /**
    * Get current node's repeat counter (occurrence count of this tag name).
    * @returns {number}
    */
   getCounter() {
-    const path14 = this._matcher.path;
-    if (path14.length === 0) return -1;
-    return path14[path14.length - 1].counter ?? 0;
+    const path13 = this._matcher.path;
+    if (path13.length === 0) return -1;
+    return path13[path13.length - 1].counter ?? 0;
   }
   /**
    * Get current node's sibling index (alias for getPosition).
@@ -82592,10 +82813,10 @@ function resolveRelativePath(basePath, relativePath) {
   }
   return resolved.join("/");
 }
-function findZipEntry(zipEntries, path14) {
-  if (zipEntries[path14]) return zipEntries[path14];
-  if (zipEntries[`xl/${path14}`]) return zipEntries[`xl/${path14}`];
-  const noSlash = path14.replace(/^\//, "");
+function findZipEntry(zipEntries, path13) {
+  if (zipEntries[path13]) return zipEntries[path13];
+  if (zipEntries[`xl/${path13}`]) return zipEntries[`xl/${path13}`];
+  const noSlash = path13.replace(/^\//, "");
   if (zipEntries[noSlash]) return zipEntries[noSlash];
   return void 0;
 }
@@ -84496,9 +84717,9 @@ function parseExcelFromZip(zip, options) {
   }
   return result;
 }
-function findEntry(zip, path14) {
-  if (zip[path14]) return zip[path14];
-  const lower2 = path14.toLowerCase();
+function findEntry(zip, path13) {
+  if (zip[path13]) return zip[path13];
+  const lower2 = path13.toLowerCase();
   for (const key of Object.keys(zip)) {
     if (key.toLowerCase() === lower2) return zip[key];
   }
@@ -85135,12 +85356,12 @@ function extractPivotRoundTripInfo(originalZip) {
     if (paths.length > 0) pivotTablesBySheetIndex.set(i2, paths);
   }
   const pivotXmlPaths = [];
-  for (const path14 of Object.keys(originalZip)) {
-    if (path14.startsWith("xl/pivotTables/") && path14.endsWith(".xml")) {
-      pivotXmlPaths.push(path14);
+  for (const path13 of Object.keys(originalZip)) {
+    if (path13.startsWith("xl/pivotTables/") && path13.endsWith(".xml")) {
+      pivotXmlPaths.push(path13);
     }
-    if (path14.startsWith("xl/pivotCache/") && path14.endsWith(".xml")) {
-      pivotXmlPaths.push(path14);
+    if (path13.startsWith("xl/pivotCache/") && path13.endsWith(".xml")) {
+      pivotXmlPaths.push(path13);
     }
   }
   return { cachesByWorkbook, pivotTablesBySheetIndex, pivotXmlPaths };
@@ -85148,15 +85369,15 @@ function extractPivotRoundTripInfo(originalZip) {
 function decode3(bytes) {
   return new TextDecoder().decode(bytes);
 }
-function pivotContentTypeFor(path14) {
-  if (path14.startsWith("xl/pivotTables/") && path14.endsWith(".xml")) {
-    return `<Override PartName="/${path14}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotTable+xml"/>`;
+function pivotContentTypeFor(path13) {
+  if (path13.startsWith("xl/pivotTables/") && path13.endsWith(".xml")) {
+    return `<Override PartName="/${path13}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotTable+xml"/>`;
   }
-  if (path14.includes("/pivotCacheDefinition") && path14.endsWith(".xml")) {
-    return `<Override PartName="/${path14}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheDefinition+xml"/>`;
+  if (path13.includes("/pivotCacheDefinition") && path13.endsWith(".xml")) {
+    return `<Override PartName="/${path13}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheDefinition+xml"/>`;
   }
-  if (path14.includes("/pivotCacheRecords") && path14.endsWith(".xml")) {
-    return `<Override PartName="/${path14}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheRecords+xml"/>`;
+  if (path13.includes("/pivotCacheRecords") && path13.endsWith(".xml")) {
+    return `<Override PartName="/${path13}" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.pivotCacheRecords+xml"/>`;
   }
   return void 0;
 }
@@ -85229,16 +85450,16 @@ function exportWorkbook(workbook, originalZip) {
       regeneratedPaths.add(`xl/worksheets/sheet${i2 + 1}.xml`);
       regeneratedPaths.add(`xl/worksheets/_rels/sheet${i2 + 1}.xml.rels`);
     }
-    for (const path14 of Object.keys(originalZip)) {
-      if (path14.startsWith("xl/drawings/") || path14.startsWith("xl/charts/") || path14.startsWith("xl/tables/") || path14.startsWith("xl/media/")) {
-        regeneratedPaths.add(path14);
+    for (const path13 of Object.keys(originalZip)) {
+      if (path13.startsWith("xl/drawings/") || path13.startsWith("xl/charts/") || path13.startsWith("xl/tables/") || path13.startsWith("xl/media/")) {
+        regeneratedPaths.add(path13);
       }
     }
-    for (const [path14, data2] of Object.entries(originalZip)) {
-      if (regeneratedPaths.has(path14)) continue;
-      const ext = path14.slice(path14.lastIndexOf(".") + 1).toLowerCase();
+    for (const [path13, data2] of Object.entries(originalZip)) {
+      if (regeneratedPaths.has(path13)) continue;
+      const ext = path13.slice(path13.lastIndexOf(".") + 1).toLowerCase();
       if (!DECLARED_EXTENSIONS.includes(ext)) continue;
-      entries2[path14] = data2;
+      entries2[path13] = data2;
     }
   }
   const sharedStrings = buildSharedStrings(workbook);
@@ -85254,8 +85475,8 @@ function exportWorkbook(workbook, originalZip) {
     buildWorkbookRels(workbook, pivotInfo)
   );
   const extraContentTypes = [];
-  for (const path14 of pivotInfo.pivotXmlPaths) {
-    const ct = pivotContentTypeFor(path14);
+  for (const path13 of pivotInfo.pivotXmlPaths) {
+    const ct = pivotContentTypeFor(path13);
     if (ct) extraContentTypes.push(ct);
   }
   let globalChartIndex = 1;
@@ -94441,14 +94662,14 @@ var DependencyGraph = class {
       stack.push({ cell: p, path: [cell, p] });
     }
     while (stack.length > 0) {
-      const { cell: current, path: path14 } = stack.pop();
-      if (current === cell || originCoarse.has(current)) return path14;
+      const { cell: current, path: path13 } = stack.pop();
+      if (current === cell || originCoarse.has(current)) return path13;
       if (visited.has(current)) continue;
       visited.add(current);
       const nextPrec = this.precedents.get(current);
       if (!nextPrec) continue;
       for (const p of nextPrec) {
-        stack.push({ cell: p, path: [...path14, p] });
+        stack.push({ cell: p, path: [...path13, p] });
       }
     }
     return null;
@@ -98510,15 +98731,15 @@ function finalizeParagraph(ctx, parts, startCp, markCp, isCellMark, numbering) {
   };
 }
 function readPictureAt(ctx, raw, cp) {
-  const note = (detail) => {
+  const note2 = (detail) => {
     ctx.diagnostics.push({ kind: "image", location: { cp }, detail });
     return null;
   };
-  if (raw.picLocation === void 0) return note("Picture anchor carries no Data-stream location; dropped");
-  if (!ctx.data) return note("Picture anchor found but the document has no Data stream; dropped");
+  if (raw.picLocation === void 0) return note2("Picture anchor carries no Data-stream location; dropped");
+  if (!ctx.data) return note2("Picture anchor found but the document has no Data stream; dropped");
   const picture = readInlinePicture(ctx.data, raw.picLocation);
   if (!picture) {
-    return note(`Picture at Data+${raw.picLocation} is not a readable inline image; dropped`);
+    return note2(`Picture at Data+${raw.picLocation} is not a readable inline image; dropped`);
   }
   return picture;
 }
@@ -101208,9 +101429,9 @@ function buildFootnotesXml(footnotes, ctx) {
     boilerplateNote("separator", "-1", "w:separator"),
     boilerplateNote("continuationSeparator", "0", "w:continuationSeparator")
   ];
-  for (const note of footnotes) {
-    const content = note.content.length > 0 ? note.content.map((b) => buildBlockElement(b, ctx)) : [{ "w:p": [] }];
-    notes.push({ "w:footnote": content, ":@": { "@_w:id": String(note.index) } });
+  for (const note2 of footnotes) {
+    const content = note2.content.length > 0 ? note2.content.map((b) => buildBlockElement(b, ctx)) : [{ "w:p": [] }];
+    notes.push({ "w:footnote": content, ":@": { "@_w:id": String(note2.index) } });
   }
   const root = { "w:footnotes": notes, ":@": { "@_xmlns:w": W_NS3 } };
   return buildXml([root]);
@@ -101247,7 +101468,7 @@ function collectFonts(fonts, acc) {
 function walkModel(model) {
   const acc = { referencedStyleIstds: /* @__PURE__ */ new Set(), fontNames: /* @__PURE__ */ new Set() };
   walkBlocks(model.body, acc);
-  for (const note of model.footnotes) walkBlocks(note.content, acc);
+  for (const note2 of model.footnotes) walkBlocks(note2.content, acc);
   for (const style of model.styles) {
     if (style.chp) collectFonts(style.chp.fonts, acc);
   }
@@ -101402,8 +101623,8 @@ async function docModelToDocx(model) {
 // ../ooxml/src/opc.ts
 var import_jszip = __toESM(require_lib4(), 1);
 function dropFolderEntries(zip) {
-  for (const [path14, entry] of Object.entries(zip.files)) {
-    if (entry.dir) delete zip.files[path14];
+  for (const [path13, entry] of Object.entries(zip.files)) {
+    if (entry.dir) delete zip.files[path13];
   }
 }
 
@@ -101658,11 +101879,11 @@ async function parseDocx(buffer) {
   const zip = await import_jszip3.default.loadAsync(buffer);
   const parts = /* @__PURE__ */ new Map();
   const filePromises = [];
-  zip.forEach((path14, file2) => {
+  zip.forEach((path13, file2) => {
     if (file2.dir) return;
     filePromises.push(
       file2.async("uint8array").then((bytes) => {
-        parts.set(path14, bytes);
+        parts.set(path13, bytes);
       })
     );
   });
@@ -101894,9 +102115,9 @@ var DEFAULT_PARTS = [
   ["word/theme/theme1.xml", () => encoder.encode(THEME_XML)]
 ];
 function fillDefaultParts(parts) {
-  for (const [path14, makeBytes] of DEFAULT_PARTS) {
-    if (!parts.has(path14)) {
-      parts.set(path14, makeBytes());
+  for (const [path13, makeBytes] of DEFAULT_PARTS) {
+    if (!parts.has(path13)) {
+      parts.set(path13, makeBytes());
     }
   }
   return parts;
@@ -101906,9 +102127,9 @@ function fillDefaultParts(parts) {
 async function serializeDocx(doc) {
   const zip = new import_jszip4.default();
   const parts = fillDefaultParts(new Map(doc.parts));
-  for (const [path14, bytes] of parts) {
-    if (path14 === "word/document.xml") continue;
-    zip.file(path14, bytes);
+  for (const [path13, bytes] of parts) {
+    if (path13 === "word/document.xml") continue;
+    zip.file(path13, bytes);
   }
   const documentXml = serializeDocumentXml(doc);
   zip.file("word/document.xml", documentXml);
@@ -102697,12 +102918,12 @@ async function runKnowledgeCommand(client, subcommand, toolArgs, flags, restArgs
 // src/preview.ts
 import { spawn as spawn3 } from "node:child_process";
 import { createServer } from "node:http";
-import { readFileSync as readFileSync2, writeFileSync, existsSync as existsSync2, mkdtempSync, rmSync, readdirSync } from "node:fs";
+import { readFileSync, writeFileSync, existsSync as existsSync2, mkdtempSync, rmSync, readdirSync } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
 import { join as join2, dirname, resolve, extname, basename } from "node:path";
-import { fileURLToPath as fileURLToPath3 } from "node:url";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { setTimeout as sleep } from "node:timers/promises";
-var HERE = dirname(fileURLToPath3(import.meta.url));
+var HERE = dirname(fileURLToPath2(import.meta.url));
 function fail3(msg) {
   console.error(msg);
   process.exit(1);
@@ -102783,8 +103004,8 @@ async function runPreviewCommand(filePath, flags) {
       "No Chrome/Chromium found. Set CHROME_PATH to a Chrome binary, or install one:\n  npx playwright install chromium   (then it's auto-detected)\n  or install Google Chrome / Chromium via your package manager."
     );
   }
-  const b64 = readFileSync2(abs2).toString("base64");
-  const bundle = readFileSync2(bundlePath, "utf8");
+  const b64 = readFileSync(abs2).toString("base64");
+  const bundle = readFileSync(bundlePath, "utf8");
   const html = `<!doctype html><html><head><meta charset="utf-8"><style>body{margin:0;background:#fff;font-family:sans-serif}#root{padding:20px;max-width:1240px;margin:0 auto}</style></head><body><div id="root"></div><script>window.__LOTICS_RENDER=${JSON.stringify({ type, b64 })}</script><script src="/render_page.js"></script></body></html>`;
   const server = createServer((req, res) => {
     if (req.url === "/render_page.js") {
@@ -102830,7 +103051,7 @@ async function runPreviewCommand(filePath, flags) {
     const portFile = join2(udd, "DevToolsActivePort");
     for (let i2 = 0; i2 < 100 && !cdpPort; i2++) {
       if (existsSync2(portFile)) {
-        const p = parseInt(readFileSync2(portFile, "utf8").split("\n")[0], 10);
+        const p = parseInt(readFileSync(portFile, "utf8").split("\n")[0], 10);
         if (p) cdpPort = p;
       }
       if (!cdpPort) await sleep(100);
@@ -102886,7 +103107,7 @@ async function runPreviewCommand(filePath, flags) {
     const outPath = flags.output ? resolve(flags.output) : join2(dirname(abs2), basename(abs2, ext) + ".png");
     writeFileSync(outPath, Buffer.from(shot.data, "base64"));
     console.log(`Rendered ${basename(abs2)} \u2192 ${outPath}  (${Math.min(w, MAX_CAPTURE)}\xD7${Math.min(h, MAX_CAPTURE)}, via ${basename(chrome)})`);
-    for (const warn of warnings) console.error(`  \u26A0 ${warn}`);
+    for (const warn2 of warnings) console.error(`  \u26A0 ${warn2}`);
   } finally {
     cleanup();
   }
@@ -103007,7 +103228,7 @@ Auth flags:
                          signup/api-key write a self-contained ./.lotics/config.json
                          (inline key) \u2014 for a hermetic worktree or CI.
   --name <name>          (signup) Display name (defaults to email prefix)
-  --timezone <timezone>  (signup) Workspace timezone (defaults to UTC, e.g. Asia/Ho_Chi_Minh)
+  --timezone <timezone>  (signup) Workspace timezone (defaults to this machine's, e.g. Asia/Ho_Chi_Minh)
 
 API keys are stored once per org as named profiles in ~/.lotics/config.json.
 Registering a second key adds a profile \u2014 it does not overwrite the first.
@@ -103037,8 +103258,8 @@ function prompt(question) {
     });
   });
 }
-async function publicPost(path14, body) {
-  const response = await fetch(`${API_BASE_URL}${path14}`, {
+async function publicPost(path13, body) {
+  const response = await fetch(`${API_BASE_URL}${path13}`, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify(body)
@@ -103046,35 +103267,74 @@ async function publicPost(path14, body) {
   const data2 = await response.json();
   return { ok: response.ok, status: response.status, data: data2 };
 }
-async function handleSignup(positionalEmail, flags) {
-  const email3 = positionalEmail ?? (process.stdin.isTTY ? await prompt("Email: ") : "");
-  if (!email3) {
-    console.error("Email is required. Usage: lotics auth signup <email>");
-    process.exit(1);
-  }
-  const name2 = flags.name ?? (process.stdin.isTTY ? await prompt("Name (enter to use email): ") : void 0);
-  const body = { email: email3 };
-  if (name2) body.name = name2;
-  if (flags.timezone) body.timezone = flags.timezone;
+async function signupAccount(args) {
+  const body = { email: args.email };
+  if (args.name) body.name = args.name;
+  const timezone = args.timezone ?? machineTimezone();
+  if (timezone) body.timezone = timezone;
   const { ok, status, data: data2 } = await publicPost("/v1/cli/signup", body);
   if (!ok) {
     if (status === 409) {
-      console.error("An account with this email already exists. Use: lotics auth api-key");
-    } else if (status === 429) {
-      console.error("Too many signup attempts. Try again later.");
-    } else {
-      console.error(`Signup failed: ${data2.message ?? JSON.stringify(data2)}`);
+      throw new Error(
+        `An account with ${args.email} already exists.
+  If this machine is already signed in:  lotics auth whoami
+  Otherwise take an API key from Settings \u2192 API keys at ${WEB_APP_URL}, then:
+    lotics auth api-key <key>`
+      );
     }
-    process.exit(1);
+    if (status === 429) {
+      throw new Error("Too many signup attempts. Try again later.");
+    }
+    throw new Error(`Signup failed: ${data2.message ?? JSON.stringify(data2)}`);
   }
   const apiKey = data2.api_key;
   const orgId = data2.organization_id;
   const workspaceId = data2.workspace_id;
-  const orgName = name2 || email3.split("@")[0];
+  const orgName = args.name || args.email.split("@")[0];
   upsertProfile(orgId, { api_key: apiKey, org_name: orgName, workspace_id: workspaceId });
   const existing = loadGlobalConfig() ?? {};
-  saveGlobalConfig({ ...existing, email: email3 });
-  setActiveOrg(orgId, flags.local ? "local" : "global");
+  saveGlobalConfig({ ...existing, email: args.email });
+  setActiveOrg(orgId, args.local ? "local" : "global");
+  return { email: args.email, apiKey, orgId, orgName, workspaceId };
+}
+function alreadySetUp(email3) {
+  const config2 = loadGlobalConfig();
+  if (config2?.email !== email3) return false;
+  return Object.keys(config2.profiles ?? {}).length > 0;
+}
+async function handleSignup(positionalEmail, flags) {
+  const email3 = positionalEmail ?? (process.stdin.isTTY ? await prompt("Email: ") : "");
+  if (!email3) {
+    console.error("Email is required. Usage: lotics auth signup <email>");
+    process.exit(1);
+  }
+  if (alreadySetUp(email3)) {
+    console.error(
+      `This machine is already signed in as ${email3} \u2014 no new account needed.
+  Carry on:          lotics starter list
+  Which account:     lotics auth whoami` + // `--local` asked for a pin, and returning early gives none. Saying
+      // nothing would leave a flag silently ignored, which is worse than the
+      // 409 this replaced.
+      (flags.local === true ? `
+  --local pins a directory to an org, which signup does not do for an
+  account that exists \u2014 use:  lotics org use <name|id> --local` : "")
+    );
+    return;
+  }
+  const name2 = flags.name ?? (process.stdin.isTTY ? await prompt("Name (enter to use email): ") : void 0);
+  let account;
+  try {
+    account = await signupAccount({
+      email: email3,
+      ...name2 ? { name: name2 } : {},
+      ...flags.timezone ? { timezone: flags.timezone } : {},
+      ...flags.local === true ? { local: true } : {}
+    });
+  } catch (error52) {
+    console.error(error52 instanceof Error ? error52.message : String(error52));
+    process.exit(1);
+  }
+  const { orgId, orgName } = account;
   console.error(`Account created. You can now use the CLI.`);
   console.error(`  Email:  ${email3}`);
   console.error(`  Org:    ${orgName} (${orgId})`);
@@ -103206,13 +103466,13 @@ async function resolveWorkspace(client, ctx) {
 function resolveUploadPaths(rawPaths) {
   const result = [];
   for (const p of rawPaths) {
-    const resolved = path13.resolve(p);
+    const resolved = path12.resolve(p);
     const stat = fs14.statSync(resolved);
     if (stat.isDirectory()) {
       const entries2 = fs14.readdirSync(resolved, { withFileTypes: true });
       for (const entry of entries2) {
         if (entry.isFile()) {
-          result.push(path13.join(resolved, entry.name));
+          result.push(path12.join(resolved, entry.name));
         }
       }
     } else {
@@ -103261,8 +103521,65 @@ async function main() {
     console.log(VERSION);
     return;
   }
+  if (command === "start") {
+    const starterId = subcommand;
+    if (!starterId) {
+      console.error("Usage: lotics start <starter_id> [path] [--email <you@co.com>] [--json]");
+      console.error("       Creates an account if this machine has none, then copies the starter");
+      console.error("       into its workspace: schema, templates, knowledge docs, sample records");
+      console.error("       and a deployed app. Ends with a one-time sign-in link.");
+      console.error("       --json prints one object and nothing else.");
+      process.exit(1);
+    }
+    if (flags.json) setMachineOutput(true);
+    const existing = resolveContext(flags);
+    if (existing === null) {
+      const email3 = flags.email ?? (process.stdin.isTTY ? await prompt("Email: ") : "");
+      if (!email3) {
+        console.error(
+          "This machine has no Lotics credential yet, so `start` needs an email to create one:\n  lotics start " + starterId + " --email you@company.com"
+        );
+        process.exit(1);
+      }
+      try {
+        const account = await signupAccount({
+          email: email3,
+          ...flags.name ? { name: flags.name } : {},
+          ...flags.timezone ? { timezone: flags.timezone } : {},
+          ...flags.local === true ? { local: true } : {}
+        });
+        note(`Account created for ${account.email} \u2014 org ${account.orgName} (${account.orgId}).`);
+      } catch (error52) {
+        console.error(error52 instanceof Error ? error52.message : String(error52));
+        process.exit(1);
+      }
+    } else if (flags.email !== void 0) {
+      console.error(
+        `Already authenticated (${SOURCE_LABELS[existing.source]}), so --email would create a SECOND account and copy into it.
+  Copy into the account you have:  lotics start ${starterId}
+  Or create another one first:     lotics auth signup ${flags.email}`
+      );
+      process.exit(1);
+    }
+    const { client: client2, ctx: ctx2 } = requireClient(flags);
+    await resolveWorkspace(client2, ctx2);
+    const result = await starterInit(client2, {
+      starter_id: starterId,
+      ...toolArgs !== void 0 ? { targetPath: toolArgs } : {},
+      ...flags.noSampleData === true ? { noSampleData: true } : {},
+      ...flags.adopt === true ? { adopt: true } : {}
+    });
+    if (flags.json) {
+      emitJson({ organization_id: ctx2.orgId, workspace_id: ctx2.workspaceId, ...result });
+    }
+    return;
+  }
   if (command === "starter") {
     if (subcommand === "list") {
+      if (resolveContext(flags) === null) {
+        await starterListPublic();
+        return;
+      }
       const { client: client2, ctx: ctx2 } = requireClient(flags);
       await resolveWorkspace(client2, ctx2);
       await starterList(client2);
@@ -103286,14 +103603,18 @@ async function main() {
         console.error("       locally, so it needs node and a few minutes.");
         process.exit(1);
       }
+      if (flags.json) setMachineOutput(true);
       const { client: client2, ctx: ctx2 } = requireClient(flags);
       await resolveWorkspace(client2, ctx2);
-      await starterInit(client2, {
+      const result = await starterInit(client2, {
         starter_id: toolArgs,
         ...restArgs[0] !== void 0 ? { targetPath: restArgs[0] } : {},
         ...flags.noSampleData === true ? { noSampleData: true } : {},
         ...flags.adopt === true ? { adopt: true } : {}
       });
+      if (flags.json) {
+        emitJson({ organization_id: ctx2.orgId, workspace_id: ctx2.workspaceId, ...result });
+      }
       return;
     }
     if (subcommand === "fixtures") {
@@ -103464,7 +103785,7 @@ async function main() {
   if (command === "preview") {
     if (subcommand && isStoredFileId(subcommand)) {
       const { client: client2 } = requireClient(flags);
-      const tmpDir = fs14.mkdtempSync(path13.join(os4.tmpdir(), "lotics-preview-"));
+      const tmpDir = fs14.mkdtempSync(path12.join(os4.tmpdir(), "lotics-preview-"));
       try {
         const { path: localPath, filename } = await client2.downloadFileById(subcommand, tmpDir);
         const output = flags.output ?? defaultPreviewOutputPath(filename, process.cwd());
@@ -104067,6 +104388,7 @@ ${JSON.stringify(info.input_schema, null, 2)}`);
   }
 }
 main().then(() => checkForUpdate(VERSION)).catch((error52) => {
+  flushPendingWarnings();
   console.error(describeCliError(error52));
   process.exit(1);
 });