@ultimat3/cli 4.0.0 → 4.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/cli",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "The `x` binary: new, dev, build, verify, generate, db, mcp, doctor, deploy",
   "license": "MIT",
   "type": "module",
@@ -35,28 +35,28 @@
     "dev": "bun run src/bin.ts dev"
   },
   "dependencies": {
-    "@ultimat3/action": "4.0.0",
-    "@ultimat3/admin": "4.0.0",
-    "@ultimat3/ai": "4.0.0",
-    "@ultimat3/cache": "4.0.0",
-    "@ultimat3/core": "4.0.0",
-    "@ultimat3/db": "4.0.0",
-    "@ultimat3/entity": "4.0.0",
-    "@ultimat3/http": "4.0.0",
-    "@ultimat3/i18n": "4.0.0",
-    "@ultimat3/jobs": "4.0.0",
-    "@ultimat3/mail": "4.0.0",
-    "@ultimat3/manifest": "4.0.0",
-    "@ultimat3/mcp": "4.0.0",
-    "@ultimat3/policy": "4.0.0",
-    "@ultimat3/pwa": "4.0.0",
-    "@ultimat3/query": "4.0.0",
-    "@ultimat3/realtime": "4.0.0",
-    "@ultimat3/render": "4.0.0",
-    "@ultimat3/schema": "4.0.0",
-    "@ultimat3/seo": "4.0.0",
-    "@ultimat3/storage": "4.0.0",
-    "@ultimat3/testing": "4.0.0",
-    "@ultimat3/time": "4.0.0"
+    "@ultimat3/action": "4.1.0",
+    "@ultimat3/admin": "4.1.0",
+    "@ultimat3/ai": "4.1.0",
+    "@ultimat3/cache": "4.1.0",
+    "@ultimat3/core": "4.1.0",
+    "@ultimat3/db": "4.1.0",
+    "@ultimat3/entity": "4.1.0",
+    "@ultimat3/http": "4.1.0",
+    "@ultimat3/i18n": "4.1.0",
+    "@ultimat3/jobs": "4.1.0",
+    "@ultimat3/mail": "4.1.0",
+    "@ultimat3/manifest": "4.1.0",
+    "@ultimat3/mcp": "4.1.0",
+    "@ultimat3/policy": "4.1.0",
+    "@ultimat3/pwa": "4.1.0",
+    "@ultimat3/query": "4.1.0",
+    "@ultimat3/realtime": "4.1.0",
+    "@ultimat3/render": "4.1.0",
+    "@ultimat3/schema": "4.1.0",
+    "@ultimat3/seo": "4.1.0",
+    "@ultimat3/storage": "4.1.0",
+    "@ultimat3/testing": "4.1.0",
+    "@ultimat3/time": "4.1.0"
   }
 }

package/src/cmd-errors.ts

@@ -1,3 +1,4 @@
+import { singleLine } from '@ultimat3/core';
 // `x errors explain <CODE>` / `x errors list` — the error table, programmatically. An agent that
 // hits an `X_*` code should not have to leave the terminal to learn what it means, and a code it
 // invented should come back refused: the answer to an unregistered code is "no such code", never
@@ -35,9 +36,9 @@ const asJson = (explanation: ErrorExplanation): JsonValue => {
 
 /** The 3-line contract format, minus the leading blank code line `renderFinding` would add. */
 const detailLines = (explanation: ErrorExplanation): readonly string[] => [
-  `  cause: ${explanation.cause}`,
-  `  fix:   ${explanation.fix}`,
-  `  docs:  ${explanation.docs}`,
+  `  cause: ${singleLine(explanation.cause)}`,
+  `  fix:   ${singleLine(explanation.fix)}`,
+  `  docs:  ${singleLine(explanation.docs)}`,
 ];
 
 function explainOne(code: string): CommandResult {
@@ -69,7 +70,7 @@ function listAll(catalog: ErrorCatalog): CommandResult {
     ok: catalog.failed.length === 0,
     command: 'errors',
     summary: msg('cli.errors.count', { count: all.length }),
-    lines: all.map((entry) => `  ${entry.code.padEnd(30)} ${entry.cause}`),
+    lines: all.map((entry) => `  ${entry.code.padEnd(30)} ${singleLine(entry.cause)}`),
     findings: catalog.failed,
     data: {
       codes: all.map(asJson),

package/src/output.ts

@@ -2,7 +2,7 @@
 // and the JSON renderer are projections of it, so `--json` can never drift from the terminal
 // output (axiom 4). The human renderer owns the canonical 3-line error format.
 
-import { renderThrowable, stringField } from '@ultimat3/core';
+import { renderThrowable, singleLine, stringField } from '@ultimat3/core';
 import { msg } from './messages';
 
 export interface Finding {
@@ -113,13 +113,16 @@ const summaryOf = (value: UltimateErrorShape): string =>
  * ```
  */
 export function renderFinding(finding: Finding, indent = ''): string {
-  const head = finding.at === undefined ? finding.code : `${finding.code} (${finding.at})`;
+  // Every field through `singleLine`: this is the format's only renderer for the terminal and CI
+  // logs, and a `cause` carrying a newline would print a line a reader takes for a real finding.
+  const code = singleLine(finding.code);
+  const head = finding.at === undefined ? code : `${code} (${singleLine(finding.at)})`;
   const lines = [
     `${indent}${head}`,
-    `${indent}  cause: ${finding.cause}`,
-    `${indent}  fix:   ${finding.fix}`,
+    `${indent}  cause: ${singleLine(finding.cause)}`,
+    `${indent}  fix:   ${singleLine(finding.fix)}`,
   ];
-  if (finding.docs !== undefined) lines.push(`${indent}  docs:  ${finding.docs}`);
+  if (finding.docs !== undefined) lines.push(`${indent}  docs:  ${singleLine(finding.docs)}`);
   return lines.join('\n');
 }