@lotics/cli 0.89.1 → 0.91.0

package/dist/src/cli.js

@@ -30642,8 +30642,8 @@ import { spawn as spawn2 } from "node:child_process";
 import { tmpdir } from "node:os";
 
 // src/starter_template.ts
-var STARTER_FALLBACK_UI_VERSION = "6.1.0";
-var STARTER_FALLBACK_SDK_VERSION = "0.51.0";
+var STARTER_FALLBACK_UI_VERSION = "12.1.0";
+var STARTER_FALLBACK_SDK_VERSION = "0.52.0";
 var STARTER_REACT_NATIVE_VERSION = "0.85.3";
 var VITEST_SETUP_FILENAME = "vitest.setup.ts";
 var VITEST_SETUP_CONTENT = `import { vi } from "vitest";
@@ -30793,7 +30793,32 @@ function buildStarterTemplate(args) {
       path: "vite.config.ts",
       content: `/// <reference types="vitest" />
 import { defineConfig } from "vite";
+import type { Plugin } from "vite";
 import react from "@vitejs/plugin-react";
+import { loticsOptimizeDeps } from "@lotics/ui/vite";
+
+// @lotics/ui/icon.tsx deep-imports \`lucide-react-native/dist/esm/icons/<name>\`.
+// lucide-react-native's \`exports\` map lists only "." and "./icons", so a strict
+// resolver (the sandbox's vite dev optimizer) blocks the deep path with
+// \`Missing "./dist/esm/icons/<name>" specifier\`. lucide-react ships the same
+// per-icon files with NO exports map, so redirect there. A \`resolveId\` PLUGIN
+// (not \`resolve.alias\`) is required: the dep-optimizer SCAN runs plugin
+// resolveId hooks but does NOT apply regex \`resolve.alias\`, so the alias alone
+// fixes the production build but leaves the dev preview broken.
+function lucideIconsWebAlias(): Plugin {
+  return {
+    name: "lucide-icons-web-alias",
+    enforce: "pre",
+    async resolveId(source, importer, options) {
+      const m = /^lucide-react-native\\/dist\\/esm\\/icons\\/(.+)$/.exec(source);
+      if (!m) return null;
+      return this.resolve(\`lucide-react/dist/esm/icons/\${m[1]}\`, importer, {
+        ...options,
+        skipSelf: true,
+      });
+    },
+  };
+}
 
 // Vite default base (/) emits absolute asset URLs in index.html. Lotics's
 // render endpoint rewrites those to /v1/apps/{id}/asset/... so the bundle
@@ -30804,14 +30829,8 @@ import react from "@vitejs/plugin-react";
 // (View, Text, Pressable, StyleSheet, etc.) render in a pure-web environment.
 // .web.tsx is prioritized in resolve.extensions so per-target variants
 // (avatar.web.tsx, wave_avatar.web.tsx) win over the native .tsx file.
-//
-// @lotics/ui/icon.tsx imports from \`lucide-react-native/dist/esm/icons/<name>\`
-// \u2014 deep paths that lucide-react-native's package \`exports\` map blocks under
-// Vite's strict resolution. lucide-react has the same per-icon files with no
-// exports map, so we alias the deep path to use it. Web rendering of <svg>
-// is identical to RN-SVG when running under RN-Web.
 export default defineConfig({
-  plugins: [react()],
+  plugins: [lucideIconsWebAlias(), react()],
   // RN libraries reference globals Metro injects but Vite does not \u2014 undefined
   // \u21D2 the bundle throws. \`__DEV__\` (react-native-web, @react-native-picker's
   // UnimplementedView): throws at load, blank iframe. \`global\` (rn-web
@@ -30822,13 +30841,7 @@ export default defineConfig({
   // is safe. Define both so dev and the deployed build behave identically.
   define: { __DEV__: "false", global: "globalThis" },
   resolve: {
-    alias: [
-      {
-        find: /^lucide-react-native\\/dist\\/esm\\/icons\\/(.+)$/,
-        replacement: "lucide-react/dist/esm/icons/$1",
-      },
-      { find: "react-native", replacement: "react-native-web" },
-    ],
+    alias: [{ find: "react-native", replacement: "react-native-web" }],
     // \`.web.js\` resolves the web build of RN packages that ship \`X.js\` (native)
     // beside \`X.web.js\` (web) \u2014 e.g. @react-native-picker/picker, whose compiled
     // \`Picker.web.js\` renders a real <select>. Without it the extensionless
@@ -30843,43 +30856,15 @@ export default defineConfig({
     dedupe: ["react", "react-dom", "react-native-web"],
   },
   optimizeDeps: {
-    // \`react-native-svg\` (used by @lotics/ui's svg charts \u2014 PieChart, LineChart,
-    // Sparkline, RingGauge) ships a named-export entry Vite's dev optimizer won't
-    // resolve unbundled ("does not provide an export named 'parse'"), blanking the
-    // iframe the moment one of those charts renders. Pre-bundling it fixes the
-    // interop. Production build (rollup) resolves it without this \u2014 dev-only.
-    //
-    // react-native-web itself is force-prebundled (folds its core CJS deps like
-    // @react-native/normalize-colors into one interop'd chunk), and the deep
-    // subpaths it reaches via *default* imports (e.g. @react-native-picker's web
-    // <select> build) are each pre-bundled into an ESM shim \u2014 Vite's dev optimizer
-    // otherwise serves them without a synthesized default export ("does not
-    // provide an export named 'default'"), blanking the iframe. (Production/rollup
-    // resolves the interop already, so this is dev-only.)
-    //
-    // \`react-markdown\` (@lotics/ui's Markdown renderer, reached by AgentRun and
-    // any markdown surface) pulls a transitive CJS dep, \`style-to-js\`, whose
-    // default export the dev optimizer won't synthesize unbundled ("does not
-    // provide an export named 'default'") \u2014 blanking the iframe the moment a
-    // markdown component mounts. Pre-bundling react-markdown folds the whole
-    // subtree (incl. style-to-js) into one interop'd chunk. It is a regular dep
-    // of @lotics/ui (hoisted), so it needs no package.json entry here. (The GFM
-    // plugin @lotics/ui composes is pure ESM \u2014 no CJS interop to force.)
-    include: [
-      "react-native-svg",
-      "react-markdown",
-      "react-native-web", "@react-native/normalize-colors",
-      "inline-style-prefixer/lib/createPrefixer",
-      "inline-style-prefixer/lib/plugins/crossFade",
-      "inline-style-prefixer/lib/plugins/imageSet",
-      "inline-style-prefixer/lib/plugins/logical",
-      "inline-style-prefixer/lib/plugins/position",
-      "inline-style-prefixer/lib/plugins/sizing",
-      "inline-style-prefixer/lib/plugins/transition",
-      "postcss-value-parser", "fbjs/lib/invariant", "fbjs/lib/warning",
-      "styleq", "styleq/transform-localize-style",
-      "react", "react-dom", "react-dom/client", "nullthrows",
-    ],
+    // The dev dep-optimizer must pre-bundle @lotics/ui's RN-ecosystem + markdown
+    // CJS-interop deps or \`lotics app dev\` blanks the iframe ("does not provide an
+    // export named 'default'/'parse'"). Dev-ONLY: the prod rollup build resolves the
+    // interop without it, so typecheck/lint/build stay green while the dev iframe
+    // goes blank. The canonical list ships WITH @lotics/ui as \`loticsOptimizeDeps\`
+    // (imported above) so it can never drift from what the kit's transitive deps
+    // require across a major bump \u2014 the per-family rationale lives in that module.
+    // To add app-specific entries, spread: include: [...loticsOptimizeDeps, "my-dep"].
+    include: loticsOptimizeDeps,
     // The dep optimizer pre-bundles deps with a SEPARATE esbuild pass that
     // top-level \`define\` doesn't always reach, so a pre-bundled RN dep can
     // still hit \`__DEV__ is not defined\` under \`lotics app dev\`. Define it
@@ -30907,6 +30892,12 @@ export default defineConfig({
     // iframe loads modules from api.lotics.ai which already permits null
     // origin via CORS.
     cors: { origin: "*" },
+    // Chat-authoring previews reach this dev server through the sandbox proxy
+    // at \`5173-<id>-<token>.lotics-sandbox.app\`. Vite \u22655.4.12 rejects HMR
+    // WebSocket upgrades whose Origin doesn't match a trusted host (its
+    // cross-site WS hijack fix) \u2014 without this entry the proxied preview page
+    // loads over HTTP but HMR never connects, so edits stop live-updating.
+    allowedHosts: [".lotics-sandbox.app"],
     // @lotics/ui/fonts.css references the API's /iframe/fonts/*.woff2 files
     // by root-relative URL. A deployed app is served from the API origin so
     // they resolve directly; under \`lotics app dev\` the app runs on
@@ -31050,6 +31041,7 @@ mount(
 import { View } from "react-native";
 import { useNavigate, useParams } from "react-router-dom";
 import { AppRouter } from "@lotics/app-sdk/router";
+import { useAiContext } from "@lotics/app-sdk";
 import { Card } from "@lotics/ui/card";
 import { Text } from "@lotics/ui/text";
 import { Button } from "@lotics/ui/button";
@@ -31114,6 +31106,16 @@ function ItemDetailScreen() {
   const { id } = useParams();
   const navigate = useNavigate();
   const item = ITEMS.find((i) => i.id === id);
+  // Tell the member's ambient chat agent what this screen is showing, so a
+  // question like "summarise this" has context. This is PUSH-ONLY: a snapshot of
+  // what the app rendered to the member, never a channel for chat to pull app
+  // data \u2014 the text lands in the prompt as labeled data (not instructions) and
+  // any record refs would act only within the member's own IAM. Pass null to
+  // clear the slot (here: nothing to describe when the item isn't found).
+  useAiContext(
+    "item_detail",
+    item ? { description: \`Viewing item "\${item.name}".\`, data: { id: item.id } } : null,
+  );
   return (
     <Screen>
       {/* An in-app Back control; navigate(-1) walks the history (the browser Back
@@ -31203,9 +31205,9 @@ each alias lives in \`package.json#lotics.workflows.<alias>\`.
       path: "src/lucide-react-native.d.ts",
       content: `// Type shim for lucide-react-native's deep-icon imports
 // (\`lucide-react-native/dist/esm/icons/<name>\`). The package ships JS-only
-// files without per-file .d.ts. The Vite alias in vite.config.ts rewrites
-// these to lucide-react at bundle time; this declaration covers the
-// TypeScript compile-time gap.
+// files without per-file .d.ts. The lucideIconsWebAlias() plugin in
+// vite.config.ts redirects these to lucide-react at resolve time; this
+// declaration covers the TypeScript compile-time gap.
 declare module "lucide-react-native/dist/esm/icons/*" {
   import type { ComponentType } from "react";
   const Icon: ComponentType<{
@@ -32266,48 +32268,10 @@ function openBrowser(url) {
   child.unref();
 }
 
-// src/generate_app_workflows_dts.ts
-var HEADER = `// Auto-generated by 'lotics app pull/dev/deploy'.
-// DO NOT EDIT \u2014 regenerated from package.json#lotics.workflows.
-//
-// This file gives \`useWorkflow("alias")\` a typed input parameter at call
-// sites by augmenting the @lotics/app-sdk \`AppWorkflows\` interface.
-
-import "@lotics/app-sdk";
-`;
-function generateAppWorkflowsDts(workflows) {
-  const entries = Object.entries(workflows ?? {});
-  if (entries.length === 0) {
-    return `${HEADER}
-// No workflows declared in package.json#lotics.workflows.
-// Add an entry to enable typed useWorkflow<"alias"> at call sites.
-declare module "@lotics/app-sdk" {
-  interface AppWorkflows {}
-}
-`;
-  }
-  entries.sort(([a], [b]) => a.localeCompare(b));
-  const inputLines = [];
-  const resultLines = [];
-  for (const [alias, declaration] of entries) {
-    const valueType = declaration.inputs ? inputsToType(declaration.inputs, { nullableOptional: true }) : "Record<string, unknown>";
-    const aliasKey = isValidIdentifier(alias) ? alias : JSON.stringify(alias);
-    inputLines.push(`    ${aliasKey}: ${valueType};`);
-    if (declaration.outputs) {
-      resultLines.push(`    ${aliasKey}: ${objectFieldsToType(declaration.outputs)};`);
-    }
-  }
-  const resultsBlock = resultLines.length > 0 ? `
-  interface AppWorkflowResults {
-${resultLines.join("\n")}
-  }` : "";
-  return `${HEADER}
-declare module "@lotics/app-sdk" {
-  interface AppWorkflows {
-${inputLines.join("\n")}
-  }${resultsBlock}
-}
-`;
+// ../shared/src/app_dts.ts
+var IDENTIFIER_REGEX = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
+function isValidIdentifier(name) {
+  return IDENTIFIER_REGEX.test(name);
 }
 function inputsToType(inputs, opts) {
   const nullableOptional = opts?.nullableOptional === true;
@@ -32421,28 +32385,56 @@ function outputDeclToTsType(decl) {
       return "unknown";
   }
 }
-var IDENTIFIER_REGEX = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
-function isValidIdentifier(name) {
-  return IDENTIFIER_REGEX.test(name);
-}
+var QUERIES_HEADER = `// Auto-generated by 'lotics app pull/dev/deploy'.
+// DO NOT EDIT \u2014 regenerated from package.json#lotics.queries.
+//
+// This file gives \`useQuery("alias", params)\` typed params at call sites by
+// augmenting the @lotics/app-sdk \`AppQueries\` interface.
 
-// src/generate_app_agents_dts.ts
-var HEADER2 = `// Auto-generated by 'lotics app pull/dev/deploy'.
-// DO NOT EDIT \u2014 regenerated from package.json#lotics.agents.
+import "@lotics/app-sdk";
+`;
+function generateAppQueriesDts(queries) {
+  const entries = Object.entries(queries ?? {});
+  if (entries.length === 0) {
+    return `${QUERIES_HEADER}
+// No queries declared in package.json#lotics.queries.
+// Add an entry to enable typed useQuery("alias", params) at call sites.
+declare module "@lotics/app-sdk" {
+  interface AppQueries {}
+}
+`;
+  }
+  entries.sort(([a], [b]) => a.localeCompare(b));
+  const lines = [];
+  for (const [alias, declaration] of entries) {
+    const valueType = inputsToType(declaration.params ?? {});
+    const aliasKey = isValidIdentifier(alias) ? alias : JSON.stringify(alias);
+    lines.push(`    ${aliasKey}: ${valueType};`);
+  }
+  return `${QUERIES_HEADER}
+declare module "@lotics/app-sdk" {
+  interface AppQueries {
+${lines.join("\n")}
+  }
+}
+`;
+}
+var WORKFLOWS_HEADER = `// Auto-generated by 'lotics app pull/dev/deploy'.
+// DO NOT EDIT \u2014 regenerated from package.json#lotics.workflows.
 //
-// This file gives \`useAgentRun("alias")\` typed input + output at call sites by
-// augmenting the @lotics/app-sdk \`AppAgents\` / \`AppAgentResults\` interfaces.
+// This file gives \`useWorkflow("alias")\` a typed input parameter at call
+// sites by augmenting the @lotics/app-sdk \`AppWorkflows\` interface.
 
 import "@lotics/app-sdk";
 `;
-function generateAppAgentsDts(agents) {
-  const entries = Object.entries(agents ?? {});
+function generateAppWorkflowsDts(workflows) {
+  const entries = Object.entries(workflows ?? {});
   if (entries.length === 0) {
-    return `${HEADER2}
-// No agents declared in package.json#lotics.agents.
-// Add an entry to enable typed useAgentRun<"alias"> at call sites.
+    return `${WORKFLOWS_HEADER}
+// No workflows declared in package.json#lotics.workflows.
+// Add an entry to enable typed useWorkflow<"alias"> at call sites.
 declare module "@lotics/app-sdk" {
-  interface AppAgents {}
+  interface AppWorkflows {}
 }
 `;
   }
@@ -32450,7 +32442,7 @@ declare module "@lotics/app-sdk" {
   const inputLines = [];
   const resultLines = [];
   for (const [alias, declaration] of entries) {
-    const valueType = declaration.inputs ? inputsToType(declaration.inputs) : "Record<string, unknown>";
+    const valueType = declaration.inputs ? inputsToType(declaration.inputs, { nullableOptional: true }) : "Record<string, unknown>";
     const aliasKey = isValidIdentifier(alias) ? alias : JSON.stringify(alias);
     inputLines.push(`    ${aliasKey}: ${valueType};`);
     if (declaration.outputs) {
@@ -32458,53 +32450,78 @@ declare module "@lotics/app-sdk" {
     }
   }
   const resultsBlock = resultLines.length > 0 ? `
-  interface AppAgentResults {
+  interface AppWorkflowResults {
 ${resultLines.join("\n")}
   }` : "";
-  return `${HEADER2}
+  return `${WORKFLOWS_HEADER}
 declare module "@lotics/app-sdk" {
-  interface AppAgents {
+  interface AppWorkflows {
 ${inputLines.join("\n")}
   }${resultsBlock}
 }
 `;
 }
-
-// src/generate_app_queries_dts.ts
-var HEADER3 = `// Auto-generated by 'lotics app pull/dev/deploy'.
-// DO NOT EDIT \u2014 regenerated from package.json#lotics.queries.
+var AGENTS_HEADER = `// Auto-generated by 'lotics app pull/dev/deploy'.
+// DO NOT EDIT \u2014 regenerated from package.json#lotics.agents.
 //
-// This file gives \`useQuery("alias", params)\` typed params at call sites by
-// augmenting the @lotics/app-sdk \`AppQueries\` interface.
+// This file gives \`useAgentRun("alias")\` typed input + output at call sites by
+// augmenting the @lotics/app-sdk \`AppAgents\` / \`AppAgentResults\` interfaces.
 
 import "@lotics/app-sdk";
 `;
-function generateAppQueriesDts(queries) {
-  const entries = Object.entries(queries ?? {});
+function generateAppAgentsDts(agents) {
+  const entries = Object.entries(agents ?? {});
   if (entries.length === 0) {
-    return `${HEADER3}
-// No queries declared in package.json#lotics.queries.
-// Add an entry to enable typed useQuery("alias", params) at call sites.
+    return `${AGENTS_HEADER}
+// No agents declared in package.json#lotics.agents.
+// Add an entry to enable typed useAgentRun<"alias"> at call sites.
 declare module "@lotics/app-sdk" {
-  interface AppQueries {}
+  interface AppAgents {}
 }
 `;
   }
   entries.sort(([a], [b]) => a.localeCompare(b));
-  const lines = [];
+  const inputLines = [];
+  const resultLines = [];
   for (const [alias, declaration] of entries) {
-    const valueType = inputsToType(declaration.params ?? {});
+    const valueType = declaration.inputs ? inputsToType(declaration.inputs) : "Record<string, unknown>";
     const aliasKey = isValidIdentifier(alias) ? alias : JSON.stringify(alias);
-    lines.push(`    ${aliasKey}: ${valueType};`);
+    inputLines.push(`    ${aliasKey}: ${valueType};`);
+    if (declaration.outputs) {
+      resultLines.push(`    ${aliasKey}: ${objectFieldsToType(declaration.outputs)};`);
+    }
   }
-  return `${HEADER3}
+  const resultsBlock = resultLines.length > 0 ? `
+  interface AppAgentResults {
+${resultLines.join("\n")}
+  }` : "";
+  return `${AGENTS_HEADER}
 declare module "@lotics/app-sdk" {
-  interface AppQueries {
-${lines.join("\n")}
-  }
+  interface AppAgents {
+${inputLines.join("\n")}
+  }${resultsBlock}
 }
 `;
 }
+var CAPABILITY_GATED_CALLS = {
+  comments: ["useComments", "createComment", "updateComment", "deleteComment"]
+};
+function undeclaredCapabilities(sourceText, declared) {
+  const used = [];
+  for (const [capability, calls] of Object.entries(CAPABILITY_GATED_CALLS)) {
+    const isCalled = calls.some((call) => new RegExp(`\\b${call}\\b`).test(sourceText));
+    if (isCalled && declared?.[capability] !== true) used.push(capability);
+  }
+  return used;
+}
+function unboundAliases(declared, bound) {
+  const boundWorkflows = new Set(bound.workflows ?? []);
+  const boundAgents = new Set(bound.agents ?? []);
+  return {
+    workflows: [...declared.workflows ?? []].filter((a) => !boundWorkflows.has(a)),
+    agents: [...declared.agents ?? []].filter((a) => !boundAgents.has(a))
+  };
+}
 
 // ../shared/src/app_query_ast.ts
 function collectQueryTableIds(node) {
@@ -32545,7 +32562,7 @@ function walk(node, visit) {
 }
 
 // src/generate_app_fields.ts
-var HEADER4 = `// Auto-generated by 'lotics app codegen' (and app pull/dev/deploy).
+var HEADER = `// Auto-generated by 'lotics app codegen' (and app pull/dev/deploy).
 // DO NOT EDIT \u2014 regenerated from the workspace schema.
 //
 // Runtime field + option ids addressed by stable display-name aliases:
@@ -32639,7 +32656,7 @@ ${tableBlocks.join("\n")}
 }
 function generateAppFields(tables) {
   if (tables.length === 0) {
-    return `${HEADER4}
+    return `${HEADER}
 export const F = {} as const;
 
 export const OPT = {} as const;
@@ -32651,7 +32668,7 @@ export type AppOptions = typeof OPT;
 `;
   }
   const aliased = aliasTables(tables);
-  return `${HEADER4}
+  return `${HEADER}
 ${emitFieldMap(aliased)}
 
 ${emitOptionMap(aliased)}
@@ -32664,7 +32681,7 @@ export type AppOptions = typeof OPT;
 }
 
 // src/generate_package_fields.ts
-var HEADER5 = `// Auto-generated by 'lotics app codegen' (linked/published app; also app pull/dev/deploy).
+var HEADER2 = `// Auto-generated by 'lotics app codegen' (linked/published app; also app pull/dev/deploy).
 // DO NOT EDIT \u2014 regenerated from the installation's live binding.
 //
 // A package installation resolves F/OPT/ROLE at MODULE LOAD from its binding
@@ -32764,7 +32781,7 @@ ${lines.join("\n")}
 }
 function generatePackageAppFields(binding) {
   const { entities, roles } = parseBinding(binding);
-  return `${HEADER5}
+  return `${HEADER2}
 ${emitFieldMap2(entities)}
 
 ${emitOptionMap2(entities)}
@@ -33361,17 +33378,6 @@ Ready. Next steps:`);
   console.error(`  # edit src/App.tsx`);
   console.error(`  lotics app deploy`);
 }
-var CAPABILITY_GATED_CALLS = {
-  comments: ["useComments", "createComment", "updateComment", "deleteComment"]
-};
-function undeclaredCapabilities(sourceText, declared) {
-  const used = [];
-  for (const [capability, calls] of Object.entries(CAPABILITY_GATED_CALLS)) {
-    const isCalled = calls.some((call) => new RegExp(`\\b${call}\\b`).test(sourceText));
-    if (isCalled && declared?.[capability] !== true) used.push(capability);
-  }
-  return used;
-}
 function readAppSourceText(projectDir) {
   const srcDir = path5.join(projectDir, "src");
   if (!fs4.existsSync(srcDir)) return "";
@@ -33492,10 +33498,10 @@ function warnIfUnbranded(app) {
   );
 }
 function warnIfUnboundAliases(app, declaredWorkflows, declaredAgents) {
-  const boundWorkflows = new Set(Object.keys(app.workflows ?? {}));
-  const boundAgents = new Set(Object.keys(app.agents ?? {}));
-  const unboundWorkflows = Object.keys(declaredWorkflows).filter((a) => !boundWorkflows.has(a));
-  const unboundAgents = Object.keys(declaredAgents).filter((a) => !boundAgents.has(a));
+  const { workflows: unboundWorkflows, agents: unboundAgents } = unboundAliases(
+    { workflows: Object.keys(declaredWorkflows), agents: Object.keys(declaredAgents) },
+    { workflows: Object.keys(app.workflows ?? {}), agents: Object.keys(app.agents ?? {}) }
+  );
   if (unboundWorkflows.length === 0 && unboundAgents.length === 0) return;
   const lines = [
     "\n\u26A0 The manifest declares aliases that are NOT bound on the server. Deploy ships code +",

package/docs/knowledge_docs.md

@@ -86,7 +86,9 @@ question without ever loading the rest. Structure your content so it works:
 
 Send only the fields you're changing. Content edits are **diffs**, not a full rewrite: pass an
 `edits` array (replace / insert / append operations) plus the `expected_version` you got from
-`read_knowledge` (optimistic concurrency — a stale version is rejected). Refine structure as you
+`read_knowledge` (optimistic concurrency — a stale version is rejected). Over the CLI, the default
+`read_knowledge` text output omits the version — read `current_version` from `lotics run read_knowledge … --json`.
+Refine structure as you
 learn what users actually ask: add the synonym that failed to match, split the section that was
 too coarse to grep. See `lotics tools update_knowledge` for the edit shape.
 

package/package.json

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