@wenathlan/argan 2.0.163 → 2.0.165

package/cli.ts

@@ -8,7 +8,10 @@
  * @module argan/cli
  * @family wave/clibin
  * @law same design as web / desktop, difference only responsiveness / DPI
- * @seat 2026 · rung 2.0.157 · hierarchical JSDoc, tokens/flags, no hardcoded
+ * @dpi native detection, never XDPI — the 1x / 1.5x / 2x / 3x scale ladder
+ *   folds the chrome to the terminal cell grid (windows terminal, conpty
+ *   and every linux pty), the <APP>_DPI environment override wins first.
+ * @seat 2026 · rung 2.0.163 · hierarchical JSDoc, tokens/flags, no hardcoded
  *   data — the version is read from package.json at runtime and the engine
  *   one-liner is quoted from the app docs.
  * @runtime node strips the types; the shebang hands the file to the runtime
@@ -43,16 +46,56 @@ const APP = "argan" as const;
 const ENGINE =
   "the network, DNS and edge engine of the devthink family — authoritative zones, record snapshots, dnssec validation math, a 231-protocol gateway mesh and a 3217-row media type catalog (docs/engine.md)" as const;
 
-/** the titlebar bar: the app name on the left rail, the window controls on the right — the windows 11 chrome inside the terminal. */
+/** the titlebar bar: the app name on the left rail, the window controls on the right — the windows 11 chrome inside the terminal, the rail folded through the dpi frame. */
 function titlebar(): string {
-  return `${ACCENT}┌ ${APP} ─ cli${RESET}  ${INK}${BAR.repeat(24)} ─ ❐ ✕${RESET}`;
+  return `${ACCENT}┌ ${APP} ─ cli${RESET}  ${INK}${BAR.repeat(FRAME.rail)} ─ ❐ ✕${RESET}`;
 }
 
-/** the top rule: the 28px divider of the web surface folded to one terminal line. */
+/** the top rule: the 28px divider of the web surface folded to one terminal line, scaled by the dpi seat. */
 function toprule(): string {
-  return `${FOCUS}${BAR.repeat(3)} ${APP} ${BAR.repeat(3)}${RESET}`;
+  const rail = Math.max(3, Math.round(3 * FRAME.scale));
+  return `${FOCUS}${BAR.repeat(rail)} ${APP} ${BAR.repeat(rail)}${RESET}`;
 }
 
+/* ════════════════════════════════════════════════════════════════════ */
+/* Section 1b: the dpi conversion — native detection, the 1x / 1.5x / 2x / 3x scale ladder and the terminal clamp (the pr13 law: DPI never XDPI — the same design as the web / desktop surface, only the responsiveness folds to the cell grid of the terminal, inside windows terminal and every linux pty). */
+/* ════════════════════════════════════════════════════════════════════ */
+
+/** the scale ladder the native detection resolves (the automatic scaling law). */
+const SCALESTEPS = [1, 1.5, 2, 3] as const;
+
+/** the dpi frame the chrome renders inside: the resolved scale seat, the terminal columns and the rail length the titlebar draws. */
+interface dpiframe {
+  /** the scale seat of the ladder (1, 1.5, 2 or 3). */
+  scale: number;
+  /** the columns the terminal answers (windows terminal, conpty, xterm, tmux — every pty reports them). */
+  columns: number;
+  /** the titlebar rail length in cells (the pixel rail folded to the grid and clamped so the line never wraps). */
+  rail: number;
+}
+
+/** resolves the dpi frame natively, zero dependencies: the columns come from stdout (every windows and linux terminal answers them), the scale seat from the column ladder — the explicit <APP>_DPI environment override wins first (the native scaling knob) — and the rail clamps inside the frame so the chrome never wraps a narrow console. */
+function detectdpiframe(): dpiframe {
+  const columns = Number.isFinite(stdout.columns) && Number(stdout.columns) > 0 ? Number(stdout.columns) : 80;
+  const override = Number(process.env[`${APP.toUpperCase()}_DPI`] ?? "");
+  const scale =
+    Number.isFinite(override) && override > 0 && SCALESTEPS.includes(override as (typeof SCALESTEPS)[number])
+      ? override
+      : columns >= 200
+        ? 3
+        : columns >= 160
+          ? 2
+          : columns >= 120
+            ? 1.5
+            : 1;
+  /* the rail folds the 24-cell rail of the 1x seat through the scale seat and clamps inside the frame with room for the name, the controls and the reset runs (the escapes are zero-width). */
+  const rail = Math.max(4, Math.min(Math.round(24 * scale), columns - APP.length - 16));
+  return { scale, columns, rail };
+}
+
+/** the dpi frame the console booted with (resolved once, before any chrome prints — a piped stdin answers the deterministic 80-column seat). */
+const FRAME = detectdpiframe();
+
 /* ════════════════════════════════════════════════════════════════════ */
 /* Section 2: the runtime reads — no hardcoded data; the version comes from package.json at runtime. */
 /* ════════════════════════════════════════════════════════════════════ */
@@ -77,6 +120,7 @@ function help(): string[] {
     `${INK}commands${RESET}`,
     `  help      ${INK}this list${RESET}`,
     `  version   ${INK}the package version, read from package.json at runtime${RESET}`,
+    `  dpi       ${INK}the resolved dpi seat of this terminal (scale, columns, rail)${RESET}`,
     `  engine    ${INK}the engine ownership one-liner of the app${RESET}`,
     `  exit      ${INK}close the console${RESET}`,
   ];
@@ -101,6 +145,7 @@ export async function main(): Promise<void> {
     if (command === "exit") rl.close();
     else if (command === "help") for (const row of help()) console.log(row);
     else if (command === "version") console.log(`${ACCENT}${APP}${RESET} ${version}`);
+    else if (command === "dpi") console.log(`${ACCENT}${APP}${RESET} ${INK}dpi seat ${FRAME.scale}x on ${FRAME.columns} columns — rail ${FRAME.rail} cells, ladder 1x / 1.5x / 2x / 3x${RESET}`);
     else if (command === "engine") console.log(`${INK}${ENGINE}${RESET}`);
     else if (command.length > 0) console.log(`${HOVER}✕${RESET} ${INK}unknown command: ${command} — type help${RESET}`);
     if (command === "exit") break;

package/docs/distributionlanes.md

@@ -0,0 +1,19 @@
+# Distribution lanes
+
+The eleven distribution lanes of the PR14 law and the honest status each lane answers for argan at the 2.0.163 family rung. A lane never ships metadata its real surface cannot back: a lane without a real carrier stays a documented stub until the surface lands, and no version ever bumps to fake a lane.
+
+| Lane | Carrier | Status | Note |
+| --- | --- | --- | --- |
+| npmjs | package.json — @wenathlan/argan | live | the family-npmjs lane publishes the envelope every release rung |
+| GitHub Packages npm | package.json — @wenathlan/argan | live | the family-githubnpm lane publishes the same envelope idempotently |
+| Maven | pom.xml — io.github.wenathlan:argan | live | the family-maven lane deploys the jar |
+| NuGet | argan.csproj | live | the family-nuget lane packs the envelope |
+| Gradle | build.gradle.kts — com.wenathlan:argan | live | the family-gradle lane publishes the module |
+| Ruby Gems | argan.gemspec | live | the family-rubygems lane pushes the gem |
+| Docker Container | Dockerfile | live | the family-ghcr lane pushes ghcr.io/wenathlan/argan and the family-container lane attaches the release archive |
+| Go Get | go.mod | stub | no Go source surface ships yet — the lane lands when a real Go adapter exists, never as an empty module |
+| Cargo Crates | Cargo.toml | stub | no Rust source surface ships yet — the lane lands with a real crate, never as an empty manifest |
+| PyPi | pyproject.toml | stub | no Python package surface ships yet — the lane lands with a real wheel, never as an empty project table |
+| Homebrew | Formula | stub | no tap repository ships yet — the formula lands pointing at the real release binaries with real checksums, never at a placeholder |
+
+The engines block of package.json keeps Go, Rust and Python as declared toolchain floors — a catalog row is not a distribution lane. The dual npm law answers through the npmjs and GitHub Packages rows; the release binaries (the desktop bundles, the mobile artifacts, the container archive) ride the family-desktop, family-mobile and family-container lanes every release rung.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wenathlan/argan",
-  "version": "2.0.163",
+  "version": "2.0.165",
   "description": "argan is the DNS and gateway library of the wenathlan family: zones, records, dnssec and handshake — the system network library whose site shares the unified database. The envelope distributes the documentation set, the zero-build site and the tests directory as one package.",
   "keywords": [
     "argan",
@@ -36,9 +36,11 @@
     "README.md",
     "docs",
     "tests",
+    "cli.ts",
     "mimetypes.ts"
   ],
   "engines": {
+    "babel": "^7.28.0",
     "bare": "^1.18.0",
     "bun": "^1.4.4",
     "cargo": ">=1.85.0",
@@ -61,6 +63,7 @@
     "typescript": "^5.8.0",
     "v": "^0.5.2",
     "vscode": "^1.118.0",
+    "yaml": "^2.9.1",
     "yarn": "^4.17.1"
   },
   "peerDependencies": {
@@ -87,12 +90,12 @@
     "@libsql/client": "^0.18.0",
     "@prisma/adapter-libsql": "^7.10.1",
     "@prisma/client": "^7.10.1",
+    "@wenathlan/argan": "~2.0.155",
     "@wenathlan/cadria": "~2.0.155",
     "@wenathlan/debonair": "~2.0.155",
     "@wenathlan/devthink": "~2.0.154",
     "@wenathlan/getry": "~2.0.155",
     "@wenathlan/saddle": "~2.0.155",
-    "@wenathlan/argan": "~2.0.155",
     "@wenathlan/vault": "~2.0.155",
     "better-sqlite3": "^13.0.3",
     "drizzle-orm": "^0.45.4",
@@ -205,22 +208,26 @@
     "zod": "^4.6.7"
   },
   "overrides": {
-    "esbuild": "^0.28.2",
+    "uuid": "^11.1.1",
     "deepmerge-ts": "^8.0.0",
+    "esbuild": "^0.28.2",
+    "follow-redirects": "^1.16.2",
+    "minimatch": "^11.0.3",
+    "glob": "^14.0.3",
     "mysql2": "^3.24.6",
-    "uuid": "^11.1.1",
     "postcss-selector-parser": "^7.1.6",
     "source-map-js": "1.2.2",
-    "katex": "^0.18.2",
     "proxy-addr": "2.0.8",
     "body-parser": "^2.4.0",
     "fast-uri": "^3.1.9",
-    "follow-redirects": "^1.16.2",
-    "minimatch": "^11.0.3",
-    "glob": "^14.0.3",
     "zod": "^4.6.7",
     "undici": "^7.30.1",
-    "shell-quote": "^1.11.0"
+    "katex": "^0.18.2",
+    "shell-quote": "^1.11.0",
+    "xcode": {
+      "uuid": "11.1.1"
+    },
+    "@grpc/grpc-js": "1.14.5"
   },
   "publishConfig": {
     "access": "public",