@lotics/cli 0.197.0 → 0.198.0

package/README.md

@@ -92,6 +92,12 @@ It creates no apps of its own: build one in the workspace afterwards
 copied in — bound onto the tables the model just made — as part of the same run.
 `setup` refuses a table name your workspace already has; `lotics scaffold apply model.json` is the
 additive verb — it adopts that table, adds what the model declares beyond it, and deletes nothing.
+Because it never renames, the file and the workspace drift: `lotics scaffold diff model.json`
+prints exactly where and exits non-zero on any difference, and
+`lotics field rename <table> <field> "<new label>"` moves a label on the platform, in the file
+(`--model`) and in every app bound to it (`--apps`) at once. `lotics scaffold apply model.json
+--documents` writes only the file cells of the model's rows, onto the records the first run made —
+rows land only into empty tables, so it is the one way back for attachments that were missed.
 
 The other direction, once a workspace works: `lotics scaffold export > model.json` prints its
 tables (or only `--tables tbl_a,tbl_b`) as that same file, findings on stderr. It is a starting
@@ -177,7 +183,7 @@ lotics workspace select wks_...     # records the workspace in the local pin
 
 Each worktree resolves independently; switching the global default in another shell leaves pinned worktrees untouched. `.lotics/` should be gitignored.
 
-Every command that resolves a workspace names its target before it acts — `lotics → <org> / <workspace>` on **stderr**, so stdout stays clean for piping. When nothing in the directory or environment chose the org and it came from the machine-wide default, the line says so and prints the `--local` command to pin — that default is the one another shell can move between two of your commands. `lotics auth whoami` reports the same resolution on demand, including which source won.
+Every command that resolves a workspace names its target before it acts — `lotics → Starters / Equipment & Projects` on **stderr**, so stdout stays clean for piping. Both halves are NAMES, since the line exists to be read before a destructive write; the workspace's name is cached beside its id the first time any command lists it, and until then the line prints the id and says the name is not known yet. When nothing in the directory or environment chose the org and it came from the machine-wide default, the line says so and prints the `--local` command to pin — that default is the one another shell can move between two of your commands. `lotics auth whoami` reports the same resolution on demand, including which source won.
 
 ### Resolution precedence
 
@@ -189,6 +195,8 @@ Every command that resolves a workspace names its target before it acts — `lot
 
 `LOTICS_WORKSPACE` (or `--workspace <id>` / `-w`) overrides the workspace at any level. For ephemeral or CI use, set `LOTICS_API_KEY` instead of saving anything.
 
+**`LOTICS_ORG` is resolved once, before any command runs.** A value matching no saved credential refuses every verb with one sentence — a read, a write, and a check that needs no credential alike — and the refusal lists the orgs this machine does hold, so it is answerable without another command. It refuses even when a key arrives another way: a variable that scopes the command must not go unread while `LOTICS_API_KEY` sends the write somewhere else. When the variable resolves AND a key is supplied, the key decides the org and the command says so. A server-side rename leaves the cached org name stale, so name an org by its `org_` id when a concurrent session may rename it.
+
 ### Diagnostics
 
 Every request identifies the CLI (`user-agent: lotics-cli/<version> node/<v> <platform>`) and names the command that made it (`x-lotics-cli-command: app.workflow.set`), so a failure in the server's logs can be traced to the verb and version that produced it. Neither header carries arguments: the command chain stops before any id, path, `@file`, or JSON payload.
@@ -353,6 +361,13 @@ lotics app codegen                         # import { F, OPT } from "../.lotics/
 # the code calls that nothing bound, undeclared capabilities, query drift. Exits 1 on what a deploy refuses, so CI can gate on it.
 lotics app check
 
+# --screens adds the rendered surface: each screen the app's navigation reaches,
+# and the first record each one opens onto a PAGE, headless in Chrome at 1280
+# and 375, measured against @lotics/ui docs/reviewing.md. --screen and --width
+# narrow it while you iterate on one screen.
+lotics app check --screens
+lotics app check --screens --screen "Đơn hàng" --width 375
+
 # Running an app's alias is a TOOL call, like every other tool. Exits non-zero
 # when the RUN failed, not only when the call did.
 lotics run run_app_workflow '{"app_id":"app_...","alias":"issueInvoice","inputs":{"record_id":"rec_..."}}'
@@ -365,7 +380,8 @@ lotics run run_app_workflow '{...}' --cleanup   # also deletes created records (
 # Edit workflow bodies as files. `app pull` writes src/workflows/<alias>.ts (the
 # faithful server source, wrapped + referencing its .lotics/workflows/<alias>.globals.d.ts);
 # edit the body, then push it back through set_app_workflow — the server verifies it
-# (deploy still never authors workflows). `app workflow check` runs the server's own
+# (a deploy calls the same verb for every alias the project holds ahead of the app, so
+# this is the one-alias spelling of it). `app workflow check` runs the server's own
 # JS-subset parser + type-check locally, so a body that passes is one `set` will accept
 # (`set` still adds name resolution + lint + structural checks, which need the workspace):
 lotics app workflow pull                    # rewrite src/workflows/*.ts + globals from the server
@@ -394,7 +410,7 @@ LOTICS_UI_SRC=/abs/monorepo/packages/ui/src lotics app deploy -m "..."   # warns
 lotics app dev                             # unset ⇒ @lotics/ui resolves from node_modules again
 ```
 
-`app codegen` reads `package.json#lotics.queries` to decide which tables to put in `app_fields.ts`; widen the set with `package.json#lotics.codegen.tables` (an array of `tbl_…` ids) for tables the app only writes via workflows.
+`app codegen` puts a table in `app_fields.ts` when a declared query reads it or a bound workflow writes it — the queries come from `package.json#lotics.queries`, the written tables from each binding's own `table_ids`, so a table only a workflow body touches is addressable by alias with nothing to declare.
 
 ## SDK
 

package/dist/probe_page.js

@@ -21,9 +21,12 @@ var __loticsProbe = (() => {
   // src/probe_page.ts
   var probe_page_exports = {};
   __export(probe_page_exports, {
-    pressTab: () => pressTab,
+    PROBES: () => PROBES,
+    openRecord: () => openRecord,
+    openScreen: () => openScreen,
+    recordRows: () => recordRows,
     run: () => run,
-    tabs: () => tabs,
+    screens: () => screens,
     textLeafCount: () => textLeafCount
   });
 
@@ -99,23 +102,57 @@ var __loticsProbe = (() => {
     const skipTag = /^(SCRIPT|STYLE|TITLE|META|LINK|NOSCRIPT|TEMPLATE)$/;
     const notAValue = 'a, button, [role="tab"], [role="button"], input, th, [role="columnheader"], nav';
     const pictureMin = 32;
-    const samples = [];
-    let bare = 0;
+    const nameReach = 360;
+    const values = [];
+    const labels = [];
     const walk = (node) => {
       if (node.nodeType === Node.TEXT_NODE) {
         const text = (node.textContent || "").trim();
         const parent = node.parentElement;
         if (!text || !parent || skipTag.test(parent.tagName)) return;
         if (typeof parent.checkVisibility === "function" && !parent.checkVisibility()) return;
-        if (!numeric.test(text) || dateLike.test(text)) return;
+        const rect = parent.getBoundingClientRect();
+        if (rect.width === 0 && rect.height === 0) return;
+        const leaf = { text, left: Math.round(rect.left), right: Math.round(rect.right), top: Math.round(rect.top) };
+        if (!numeric.test(text) || dateLike.test(text)) {
+          labels.push(leaf);
+          return;
+        }
         if (parent.closest(notAValue)) return;
-        bare += 1;
-        if (samples.length < 6) samples.push(text);
+        values.push(leaf);
         return;
       }
       node.childNodes.forEach(walk);
     };
     walk(document.body);
+    const clusters = [];
+    for (const leaf of [...values].sort((a, b) => a.left - b.left || a.top - b.top)) {
+      const cluster = clusters.find((c) => leaf.left < c.right && leaf.right > c.left);
+      if (cluster !== void 0) {
+        cluster.items.push(leaf);
+        cluster.left = Math.min(cluster.left, leaf.left);
+        cluster.right = Math.max(cluster.right, leaf.right);
+      } else {
+        clusters.push({ left: leaf.left, right: leaf.right, items: [leaf] });
+      }
+    }
+    const columns = [];
+    let bare = 0;
+    for (const cluster of clusters) {
+      const items = [...cluster.items].sort((a, b) => a.top - b.top);
+      const ordinal = items.length >= 3 && items.every((item, index) => item.text === String(index + 1));
+      if (ordinal) continue;
+      const top = items[0];
+      const above = labels.filter((label) => label.top < top.top && top.top - label.top <= nameReach && label.left < cluster.right && label.right > cluster.left).sort((a, b) => b.top - a.top)[0];
+      const beside = labels.filter((label) => Math.abs(label.top - top.top) <= 8 && label.right <= top.left).sort((a, b) => b.right - a.right)[0];
+      bare += items.length;
+      columns.push({
+        slot: (above ?? beside)?.text.slice(0, 40) ?? "",
+        size: items.length,
+        samples: items.slice(0, 4).map((item) => item.text)
+      });
+    }
+    columns.sort((a, b) => b.size - a.size);
     const drawn = Array.from(document.querySelectorAll('[role="meter"], [role="progressbar"], canvas')).filter((el) => {
       const r = el.getBoundingClientRect();
       return r.width > 0 && r.height > 0;
@@ -126,7 +163,7 @@ var __loticsProbe = (() => {
       return r.width >= pictureMin && r.height >= pictureMin;
     });
     const encoded = drawn.length + pictures.length;
-    return { total: bare + encoded, bare, encoded, samples };
+    return { total: bare + encoded, bare, encoded, columns };
   }
   function internalIds() {
     const skipTag = /^(SCRIPT|STYLE|TITLE|META|LINK|NOSCRIPT|TEMPLATE)$/;
@@ -149,11 +186,16 @@ var __loticsProbe = (() => {
     return { total, ids: [...ids] };
   }
   function tabStrips() {
-    const strips = Array.from(document.querySelectorAll('[role="tablist"]')).filter((el) => {
+    const all = Array.from(document.querySelectorAll('[role="tablist"]')).filter((el) => {
       const r = el.getBoundingClientRect();
       return r.width > 0 && r.height > 0;
-    }).map((el) => Array.from(el.querySelectorAll('[role="tab"]')).map((tab) => (tab.textContent || "").trim()));
-    return { total: strips.length, strips };
+    });
+    const counted = all.filter((el) => el.getAttribute("data-order") !== "sequence");
+    return {
+      total: all.length,
+      counted: counted.length,
+      strips: counted.map((el) => Array.from(el.querySelectorAll('[role="tab"]')).map((tab) => (tab.textContent || "").trim()))
+    };
   }
   function truncatedLeaves() {
     const skipTag = /^(SCRIPT|STYLE|TITLE|META|LINK|NOSCRIPT|TEMPLATE)$/;
@@ -301,6 +343,55 @@ var __loticsProbe = (() => {
   }
 
   // src/probe_page.ts
+  var PROBES = {
+    money_edges: {
+      section: "6",
+      fix: "One right edge per money column: give every figure in it the same alignment and the same unit."
+    },
+    reported_values: {
+      section: "9",
+      fix: "Encode the column the screen is ABOUT \u2014 a mark, a meter, a chart or a picture \u2014 and leave the rest as text."
+    },
+    internal_ids: {
+      section: "8",
+      fix: "A key is not a name: render the record's own label, and keep the id in the link."
+    },
+    tab_strips: {
+      section: "8a",
+      fix: "One navigation strip per screen. A second is a filter wearing navigation's clothes \u2014 draw it as one."
+    },
+    truncation: {
+      section: "8g",
+      fix: "Shed a trailing column or let the subject take two lines, so the distinguishing half of the name survives."
+    },
+    banned_glyph: {
+      section: "10",
+      fix: "No punctuation doing a word's job \u2014 separate the two facts with layout, or write the word."
+    },
+    compact_money_words: {
+      section: "10",
+      fix: "Abbreviate in the currency's own words: tr/t\u1EF7 beside \u20AB, K/M/B beside $ and \u20AC."
+    },
+    stacked_pairs: {
+      section: "1",
+      fix: "Demote once, not twice: either the size steps down or the subject gets the weight."
+    },
+    row_marks: {
+      section: "9",
+      fix: "One rung per row: a mark's size follows what the row is ABOUT, so the supporting mark takes the smaller one."
+    },
+    render: {
+      section: "8",
+      fix: "Open the screen and read it: nothing below this was measured, so a clean run over the rest means nothing."
+    },
+    settle: {
+      section: "9c",
+      fix: "A screen that never stops changing has a render that re-renders or a request that never lands \u2014 find which."
+    }
+  };
+  function signature(probe) {
+    return PROBES[probe];
+  }
   var MONEY_EDGES_ALLOWED = 2;
   var MONEY_COLUMN_MIN = 3;
   var BARE_VALUES_FLOOR = 8;
@@ -311,6 +402,7 @@ var __loticsProbe = (() => {
     if (ragged.length > 0) {
       findings.push({
         probe: "money_edges",
+        ...signature("money_edges"),
         total: money.total,
         count: ragged.length,
         detail: ragged.slice(0, 5).map((column) => `x=${column.x}: ${column.edges.length} right edges over ${column.size} figures \u2014 ${column.samples.join(" | ")}`)
@@ -320,21 +412,26 @@ var __loticsProbe = (() => {
     if (values.bare >= BARE_VALUES_FLOOR && values.encoded === 0) {
       findings.push({
         probe: "reported_values",
+        ...signature("reported_values"),
         total: values.total,
         count: values.bare,
-        detail: [`${values.bare} values as bare text, 0 as a mark, meter, chart or picture \u2014 e.g. ${values.samples.join(", ")}`]
+        detail: [
+          `${values.bare} values as bare text, 0 as a mark, meter, chart or picture`,
+          ...values.columns.slice(0, 5).map((column) => `  ${column.slot === "" ? "(unnamed)" : column.slot}: ${column.size} \u2014 ${column.samples.join(", ")}`)
+        ]
       });
     }
     const ids = internalIds();
     if (ids.ids.length > 0) {
-      findings.push({ probe: "internal_ids", total: ids.total, count: ids.ids.length, detail: ids.ids.slice(0, 5) });
+      findings.push({ probe: "internal_ids", ...signature("internal_ids"), total: ids.total, count: ids.ids.length, detail: ids.ids.slice(0, 5) });
     }
     const strips = tabStrips();
-    if (strips.total > 1) {
+    if (strips.counted > 1) {
       findings.push({
         probe: "tab_strips",
+        ...signature("tab_strips"),
         total: strips.total,
-        count: strips.total,
+        count: strips.counted,
         detail: strips.strips.map((strip) => strip.join(" / "))
       });
     }
@@ -343,6 +440,7 @@ var __loticsProbe = (() => {
       if (cut.cut.length > 0) {
         findings.push({
           probe: "truncation",
+          ...signature("truncation"),
           total: cut.total,
           count: cut.cut.length,
           detail: cut.cut.slice(0, 5).map((leaf) => `"${leaf.text}" needs ${leaf.needs}px of ${leaf.axis} in ${leaf.has}px`)
@@ -351,12 +449,13 @@ var __loticsProbe = (() => {
     }
     const glyphs = bannedGlyphs();
     if (glyphs.found.length > 0) {
-      findings.push({ probe: "banned_glyph", total: glyphs.total, count: glyphs.found.length, detail: glyphs.found.slice(0, 5) });
+      findings.push({ probe: "banned_glyph", ...signature("banned_glyph"), total: glyphs.total, count: glyphs.found.length, detail: glyphs.found.slice(0, 5) });
     }
     const compact = compactMoneyWords();
     if (compact.foreign.length > 0) {
       findings.push({
         probe: "compact_money_words",
+        ...signature("compact_money_words"),
         total: compact.total,
         count: compact.foreign.length,
         detail: compact.foreign.slice(0, 5).map((text) => `"${text}" abbreviates in the other currency's words`)
@@ -366,6 +465,7 @@ var __loticsProbe = (() => {
     if (pairs.overDemoted.length > 0) {
       findings.push({
         probe: "stacked_pairs",
+        ...signature("stacked_pairs"),
         total: pairs.total,
         count: pairs.overDemoted.length,
         detail: pairs.overDemoted.slice(0, 5).map((pair) => `"${pair.subject}" ${pair.sizes[0]}px/${pair.weights[0]} over "${pair.supporting}" ${pair.sizes[1]}px/${pair.weights[1]}`)
@@ -375,6 +475,7 @@ var __loticsProbe = (() => {
     if (marks.mismatches.length > 0) {
       findings.push({
         probe: "row_marks",
+        ...signature("row_marks"),
         total: marks.total,
         count: marks.mismatches.length,
         detail: marks.mismatches.slice(0, 5).map((row) => `y=${row.y}: ${row.marks.join(", ")}`)
@@ -387,7 +488,7 @@ var __loticsProbe = (() => {
         money: money.total,
         bare: values.bare,
         encoded: values.encoded,
-        strips: strips.total
+        strips: strips.counted
       }
     };
   }
@@ -405,16 +506,53 @@ var __loticsProbe = (() => {
     walk(document.body);
     return count;
   }
-  function tabs() {
+  function navItems() {
+    const nav = document.querySelector("nav");
+    if (nav === null) return [];
+    return Array.from(nav.querySelectorAll('a[href], [role="link"]')).filter(
+      (item) => (item.textContent || "").trim() !== ""
+    );
+  }
+  function tabItems() {
     const strip = document.querySelector('[role="tablist"]');
     if (strip === null) return [];
-    return Array.from(strip.querySelectorAll('[role="tab"]')).map((tab) => (tab.textContent || "").trim());
+    return Array.from(strip.querySelectorAll('[role="tab"]'));
   }
-  function pressTab(index) {
-    const strip = document.querySelector('[role="tablist"]');
-    const tab = strip?.querySelectorAll('[role="tab"]')[index];
-    if (!(tab instanceof HTMLElement)) return false;
-    tab.click();
+  function screens() {
+    const nav = navItems();
+    if (nav.length > 0) return { source: "nav", labels: nav.map((item) => (item.textContent || "").trim()) };
+    const tabs = tabItems();
+    if (tabs.length > 0) return { source: "tabs", labels: tabs.map((item) => (item.textContent || "").trim()) };
+    return { source: "root", labels: [] };
+  }
+  function openScreen(source, index) {
+    const items = source === "nav" ? navItems() : source === "tabs" ? tabItems() : [];
+    const item = items[index];
+    if (item === void 0) return false;
+    item.click();
+    return true;
+  }
+  function recordLinks() {
+    const here = location.pathname + location.search;
+    const doors = Array.from(document.querySelectorAll('a[href], [data-opens="page"]'));
+    return doors.filter((door) => {
+      if (door.closest('nav, [role="banner"], [role="tablist"]') !== null) return false;
+      if (doors.some((other) => other !== door && other.contains(door))) return false;
+      const rect = door.getBoundingClientRect();
+      if (rect.width === 0 || rect.height === 0) return false;
+      const href = door.getAttribute("href");
+      if (href === null) return true;
+      if (href === "" || href.startsWith("http") || href.startsWith("#")) return false;
+      return href !== here;
+    });
+  }
+  function recordRows() {
+    return recordLinks().map((door) => (door.textContent || "").trim() || door.getAttribute("href") || "");
+  }
+  function openRecord(index) {
+    const door = recordLinks()[index];
+    if (door === void 0) return false;
+    door.click();
     return true;
   }
   return __toCommonJS(probe_page_exports);