phewsh 0.15.56 → 0.15.58

package/bin/phewsh.js

@@ -14,6 +14,12 @@ if (command === 'shim-preflight') {
   process.exit(0);
 }
 
+// Smart word-wrap for all prose the CLI prints — wraps at word boundaries
+// instead of the terminal's mid-word hard wrap. TTY-only, idempotent, and it
+// leaves process.stdout.write paths (spinner, streamed AI) alone. Installed
+// after the shim-preflight fast path so that stays instant and untouched.
+try { require('../lib/ui').installSmartWrap(); } catch { /* never block the CLI on cosmetics */ }
+
 // ── ANSI helpers (no chalk dependency)
 const b  = (s) => `\x1b[1m${s}\x1b[0m`;   // bold
 const d  = (s) => `\x1b[2m${s}\x1b[0m`;   // dim

package/lib/md.js

@@ -44,7 +44,7 @@ const ANSI = /\x1b\[[0-9;]*m/g;
 const vis = (s) => s.replace(ANSI, '').length;
 
 function softWrap(s, base = '', hang) {
-  const width = process.stdout.columns;
+  const width = require('./ui').termWidth();
   if (!width || width < 24 || vis(s) <= width) return s;
   const lead = s.match(/^ */)[0].length;
   const indent = hang == null ? lead : hang;

package/lib/ui.js

@@ -111,6 +111,86 @@ async function brandReveal(fast = false) {
   console.log('');
 }
 
+// ── Smart line wrap ──────────────────────────────────────
+// The terminal's default hard wrap breaks mid-word at the window edge. This
+// wraps at word boundaries instead (CSS `text-wrap: pretty`, in spirit),
+// ANSI-aware: colour codes carry zero width, and the colour active at a break
+// is re-opened on the continuation line so nothing loses its tint. A word
+// longer than the line is left whole — we never split inside a word, which is
+// the whole point. Per physical line; only over-long lines are touched.
+const SGR = /\x1b\[[0-9;]*m/g;
+const visW = (s) => s.replace(SGR, '').length;
+
+// Best available terminal width, with one column of safety margin so content
+// never sits flush against the edge (where terminals add their own wrap).
+// `PHEWSH_WIDTH` pins it explicitly — the escape hatch for host terminals that
+// misreport their size (some embedded/agent terminals advertise a wider pty
+// than the visible pane, which makes text break mid-word even with smart wrap
+// on). Falls back to COLUMNS, then the live tty size, then 80.
+function termWidth() {
+  const pin = parseInt(process.env.PHEWSH_WIDTH, 10);
+  const base = (Number.isFinite(pin) && pin >= 20)
+    ? pin
+    : (process.stdout.columns || parseInt(process.env.COLUMNS, 10) || 80);
+  return Math.max(24, base - 1);
+}
+
+// Active SGR state after consuming `s`, starting from `prev`. A reset clears it;
+// any other colour code accumulates. Good enough to re-open colour at a break.
+function sgrAfter(prev, s) {
+  let active = prev;
+  for (const code of s.match(SGR) || []) {
+    active = (code === '\x1b[0m' || code === '\x1b[m') ? '' : active + code;
+  }
+  return active;
+}
+
+function wrapAnsi(s, width) {
+  if (!width || width < 24) return s;
+  return s.split('\n').map((line) => {
+    if (visW(line) <= width) return line;
+    const lead = line.match(/^ */)[0].length;
+    const pad = ' '.repeat(lead);
+    const words = line.slice(lead).split(/ +/);
+    const out = [];
+    let cur = pad, len = lead, started = false, active = '';
+    for (const word of words) {
+      const wl = visW(word);
+      if (started && len + 1 + wl > width) {
+        out.push(cur + '\x1b[0m');       // close colour cleanly at the break
+        cur = active + pad + word;       // re-open it on the continuation line
+        len = lead + wl;
+      } else {
+        cur += (started ? ' ' : '') + word;
+        len += (started ? 1 : 0) + wl;
+        started = true;
+      }
+      active = sgrAfter(active, word);
+    }
+    out.push(cur);
+    return out.join('\n');
+  }).join('\n');
+}
+
+// Monkeypatch console.log so every prose line the CLI prints wraps at word
+// boundaries. TTY-only (piped/redirected output stays raw for tooling), and
+// only the simple all-string case is transformed — object args pass through
+// untouched. Idempotent. process.stdout.write paths (spinner, typewriter,
+// streamed AI render) are intentionally left alone; they handle their own.
+function installSmartWrap() {
+  if (!process.stdout.isTTY || console.log.__phewshWrapped) return;
+  const orig = console.log.bind(console);
+  const wrapped = (...args) => {
+    if (args.length && args.every((a) => typeof a === 'string')) {
+      orig(wrapAnsi(args.join(' '), termWidth()));
+    } else {
+      orig(...args);
+    }
+  };
+  wrapped.__phewshWrapped = true;
+  console.log = wrapped;
+}
+
 // ── Status panel ─────────────────────────────────────────
 function statusPanel(title, rows) {
   const maxLabel = Math.max(...rows.map(r => r[0].length));
@@ -267,6 +347,8 @@ module.exports = {
   // Components
   spinner, brandReveal, statusPanel, interopLine, divider, typewrite,
   randomTip, TOUR_PAGES,
+  // Smart wrap
+  wrapAnsi, installSmartWrap, termWidth,
   // ANSI helpers
   hide, show, up, clearLine, sleep,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phewsh",
-  "version": "0.15.56",
+  "version": "0.15.58",
   "description": "Turn intent into action. Structure your thinking, execute your next step.",
   "bin": {
     "phewsh": "bin/phewsh.js"