@lotics/cli 0.197.0 → 0.204.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
@@ -163,7 +169,7 @@ lotics org use acme                 # switch active org by name (or org id)
 lotics org use "Acme Corp"          # names are case-insensitive
 ```
 
-The org **id** is the identity; the name is a label cached when the key was saved. Rename an org in the app and the cached label goes stale — the old name still works, the new one matches nothing — until `lotics auth whoami` refreshes it. A name matching two saved orgs is refused rather than guessed; use the id.
+The org **id** is the identity; the name is the label the key was saved under, and it is yours — renaming the org in the app never moves it, so the scripts scoping by it keep running. `lotics auth whoami` learns the new name and records it beside the label; both resolve, and `lotics org` prints `label (server: name)` while they differ. A name matching two saved orgs is refused rather than guessed; use the id.
 
 ### Working in parallel (worktrees)
 
@@ -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. An org keeps the name it was saved under: a server-side rename never moves it, the new name resolves as well, and `lotics org` prints both when they differ.
+
 ### 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
   });
 
@@ -95,38 +98,107 @@ var __loticsProbe = (() => {
   }
   function reportedValues() {
     const numeric = /^[-+−]?\d[\d.,]*\s?(?:%|[A-Za-z₫đ$€]{1,4})?$/;
+    const counted = /(?:%|[A-Za-z₫đ$€]{1,4})$/;
+    const delta = /^[↑↓→▲▼]\s*[-+−]?\d[\d.,]*\s?%$/;
     const dateLike = /\d[/:-]\d/;
     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 = [];
+    let deltas = 0;
     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;
+        if (delta.test(text)) {
+          deltas += 1;
+          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;
+    let quantities = 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];
+      const scaled = items.filter((item) => counted.test(item.text)).length;
+      bare += items.length;
+      quantities += scaled;
+      columns.push({
+        slot: (above ?? beside)?.text.slice(0, 40) ?? "",
+        size: items.length,
+        quantities: scaled,
+        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;
     });
+    const reads = (el) => {
+      const role = el.getAttribute("role");
+      if (role !== "meter" && role !== "progressbar") return true;
+      const stated = (name) => {
+        const raw = el.getAttribute(name);
+        return raw === null || raw.trim() === "" ? Number.NaN : Number(raw);
+      };
+      const bound = (name, fallback) => {
+        const value = stated(name);
+        return Number.isFinite(value) ? value : fallback;
+      };
+      const now = stated("aria-valuenow");
+      if (!Number.isFinite(now)) return false;
+      const floor = bound("aria-valuemin", 0);
+      const top = bound("aria-valuemax", 100);
+      return top > floor && now < top;
+    };
     const pictures = Array.from(document.querySelectorAll('[role="img"], svg, img')).filter((el) => {
       if (el.getAttribute("aria-hidden") === "true") return false;
       const r = el.getBoundingClientRect();
       return r.width >= pictureMin && r.height >= pictureMin;
     });
-    const encoded = drawn.length + pictures.length;
-    return { total: bare + encoded, bare, encoded, samples };
+    const encoded = drawn.filter(reads).length + pictures.length + deltas;
+    return {
+      total: bare + encoded,
+      bare,
+      quantities,
+      encoded,
+      devices: drawn.length + pictures.length + deltas,
+      columns
+    };
   }
   function internalIds() {
     const skipTag = /^(SCRIPT|STYLE|TITLE|META|LINK|NOSCRIPT|TEMPLATE)$/;
@@ -149,14 +221,21 @@ 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)$/;
+    const clippedAway = /^inset\(\s*50%/;
+    const breakable = /[\t\n\v\f\r \u200b\u3000]/;
     const cut = [];
     let total = 0;
     for (const el of Array.from(document.querySelectorAll("*"))) {
@@ -164,8 +243,17 @@ var __loticsProbe = (() => {
       const text = (el.textContent || "").trim();
       if (!text) continue;
       if (typeof el.checkVisibility === "function" && !el.checkVisibility()) continue;
+      const style = getComputedStyle(el);
+      const box = el.getBoundingClientRect();
+      if (box.width <= 1 && box.height <= 1) continue;
+      if (clippedAway.test(style.getPropertyValue("clip-path"))) continue;
       total += 1;
-      if (getComputedStyle(el).overflow === "visible") continue;
+      if (style.overflow === "visible") continue;
+      const states = (property) => {
+        const value = style.getPropertyValue(property);
+        return value !== "" && value !== "none";
+      };
+      if ((states("-webkit-line-clamp") || states("line-clamp")) && breakable.test(text)) continue;
       if (el.scrollWidth > el.clientWidth + 1) {
         cut.push({ text: text.slice(0, 40), axis: "width", has: el.clientWidth, needs: el.scrollWidth });
       } else if (el.scrollHeight > el.clientHeight + 1) {
@@ -224,6 +312,7 @@ var __loticsProbe = (() => {
       if (depth === 0 || el.children.length === 0) return null;
       return leafOf(el.children[0], depth - 1);
     };
+    const sameColumn = 8;
     let total = 0;
     const overDemoted = [];
     for (const el of Array.from(document.querySelectorAll("div"))) {
@@ -237,6 +326,7 @@ var __loticsProbe = (() => {
       const a = first.getBoundingClientRect();
       const b = second.getBoundingClientRect();
       if (b.top < a.bottom - 2) continue;
+      if (Math.abs(b.left - a.left) > sameColumn) continue;
       if (a.height === 0 || b.height === 0) continue;
       total += 1;
       if (px(supporting) < px(subject) && weight(subject) > weight(supporting)) {
@@ -301,9 +391,59 @@ 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; a meter whose maximum is the bound it alarms at reads the same on every row, so it encodes nothing."
+    },
+    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 widen this one until the value fits \u2014 a date, a code or a figure cut inside itself reads as a different one."
+    },
+    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;
+  var QUANTITY_COLUMN_MIN = 2;
   function run(options) {
     const findings = [];
     const money = moneyColumns();
@@ -311,30 +451,37 @@ 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(" | ")}`)
       });
     }
     const values = reportedValues();
-    if (values.bare >= BARE_VALUES_FLOOR && values.encoded === 0) {
+    const measurable = values.columns.some((column) => column.quantities >= QUANTITY_COLUMN_MIN) || values.devices > 0;
+    if (values.bare >= BARE_VALUES_FLOOR && values.encoded === 0 && measurable) {
       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.devices === 0 ? `${values.bare} values as bare text, nothing drawn as a mark, meter, chart or picture` : `${values.bare} values as bare text; ${values.devices} drawn, none of them reading a value`,
+          ...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 +490,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 +499,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 +515,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 +525,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(", ")}`)
@@ -386,8 +537,10 @@ var __loticsProbe = (() => {
         leaves: textLeafCount(),
         money: money.total,
         bare: values.bare,
+        quantities: values.quantities,
         encoded: values.encoded,
-        strips: strips.total
+        devices: values.devices,
+        strips: strips.counted
       }
     };
   }
@@ -405,16 +558,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);