phewsh 0.15.58 → 0.15.59

package/bin/phewsh.js

@@ -18,7 +18,18 @@ if (command === 'shim-preflight') {
 // 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 */ }
+try {
+  const ui = require('../lib/ui');
+  // Restore a width the user pinned with `/width` in a past session, so the fix
+  // for a misreporting terminal sticks without re-typing it every launch.
+  try {
+    const os = require('os');
+    const path = require('path');
+    const cfg = require('../lib/config-file').loadConfig(path.join(os.homedir(), '.phewsh', 'config.json'));
+    if (cfg && cfg.displayWidth) ui.setWidth(cfg.displayWidth);
+  } catch { /* no saved width is fine */ }
+  ui.installSmartWrap();
+} catch { /* never block the CLI on cosmetics */ }
 
 // ── ANSI helpers (no chalk dependency)
 const b  = (s) => `\x1b[1m${s}\x1b[0m`;   // bold

package/commands/session.js

@@ -938,7 +938,7 @@ async function main() {
     'sync', 'harnesses', 'fallback', 'outcomes', 'tour', 'update', 'upgrade',
     'agents', 'context', 'truth', 'brief', 'wrap', 'reconcile', 'gate', 'reload', 'sequence', 'seq', 'setup', 'system', 'watch',
     'next', 'recommend', 'guide', 'thread', 'continuity', 'learn', 'stats',
-    'pack', 'packs', 'remember', 'commands',
+    'pack', 'packs', 'remember', 'commands', 'width',
   ]);
   const installedIds = harnesses.filter(h => h.installed).map(h => h.id);
   let turnAbort = null;       // AbortController while an API turn streams
@@ -1669,6 +1669,7 @@ async function main() {
         console.log(`    ${teal('/key')}         ${sage('Set API key (optional — harnesses need none)')}`);
         console.log(`    ${teal('/login')}       ${sage('Identity + cloud sync')}`);
         console.log(`    ${teal('/model')} ${slate('<name>')} ${sage('Switch model — passed through, the provider validates')}`);
+        console.log(`    ${teal('/width')} ${slate('[n]')}   ${sage('Fix mid-word wrapping if your terminal misreports its size')}`);
         console.log(`    ${teal('/update')}      ${sage('Update phewsh')}`);
         console.log(`    ${teal('/tour')}        ${sage('Quick walkthrough')}`);
         console.log('');
@@ -1714,6 +1715,48 @@ async function main() {
         return;
       }
 
+      // /width — fix mid-word breaks when the terminal misreports its size.
+      // `/width` shows what phewsh thinks; `/width 80` pins it (saved, sticks
+      // across sessions); `/width auto` clears the pin back to detection.
+      if (cmd === 'width') {
+        const arg = (cmdArg || '').trim().toLowerCase();
+        if (!arg) {
+          console.log('');
+          console.log(`  ${b(cream('Display width'))} ${slate('— used to wrap text at word boundaries')}`);
+          console.log(`  ${sage('phewsh is wrapping at')} ${cream(String(ui.rawWidth()))} ${sage('columns')} ${slate(config?.displayWidth ? '(pinned)' : '(auto-detected)')}`);
+          console.log(`  ${slate('If words still break mid-line, your terminal reports a wider size than it shows.')}`);
+          console.log(`  ${sage('Pin your real width:')} ${cream('/width 80')}  ${slate('·')}  ${sage('back to auto:')} ${cream('/width auto')}`);
+          console.log('');
+          rl.prompt();
+          return;
+        }
+        if (arg === 'auto' || arg === 'off' || arg === 'reset') {
+          ui.setWidth(null);
+          config = config || {};
+          delete config.displayWidth;
+          try { configFile.saveConfig(CONFIG_PATH, config); } catch { /* best effort */ }
+          console.log(`  ${teal('●')} ${sage('Width back to auto-detect')} ${slate('(' + ui.rawWidth() + ' columns)')}`);
+          console.log('');
+          rl.prompt();
+          return;
+        }
+        const set = ui.setWidth(arg);
+        if (!set) {
+          console.log(`  ${ember('!')} ${sage('Give a number ≥ 20, e.g.')} ${cream('/width 80')} ${slate('· or')} ${cream('/width auto')}`);
+          console.log('');
+          rl.prompt();
+          return;
+        }
+        config = config || {};
+        config.displayWidth = set;
+        try { configFile.saveConfig(CONFIG_PATH, config); } catch { /* best effort */ }
+        console.log(`  ${teal('●')} ${sage('Wrapping at')} ${cream(String(set))} ${sage('columns now')} ${slate('— saved, sticks across sessions')}`);
+        console.log(`  ${slate('This sentence is a quick check: if it wraps cleanly at a word and never cuts a word in half, you are set.')}`);
+        console.log('');
+        rl.prompt();
+        return;
+      }
+
       if (cmd === 'context') {
         if (intentFiles.length > 0) {
           console.log('');

package/lib/ui.js

@@ -121,18 +121,34 @@ async function brandReveal(fast = false) {
 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() {
+// Best available terminal width, with a safety margin so content never sits
+// flush against the edge (where terminals add their own mid-word wrap). The
+// width is pinnable, the escape hatch for host terminals that misreport their
+// size — some embedded/agent terminals (e.g. Grok Build) advertise a wider pty
+// than the visible pane, so text breaks mid-word even with smart wrap on.
+// Resolution order: live override (set by `/width`) → PHEWSH_WIDTH env →
+// the tty's reported columns → COLUMNS env → 80. Two columns are held back as
+// margin so an off-by-one in the host's report can't cause a mid-word break.
+let _widthOverride = null;
+const WIDTH_MARGIN = 2;
+
+function setWidth(n) {
+  const v = parseInt(n, 10);
+  _widthOverride = (Number.isFinite(v) && v >= 20) ? v : null;
+  return _widthOverride;
+}
+
+// The raw width phewsh believes the terminal is, before margin — what `/width`
+// reports back so the user can compare it to their visible pane.
+function rawWidth() {
+  if (_widthOverride) return _widthOverride;
   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);
+  if (Number.isFinite(pin) && pin >= 20) return pin;
+  return process.stdout.columns || parseInt(process.env.COLUMNS, 10) || 80;
+}
+
+function termWidth() {
+  return Math.max(24, rawWidth() - WIDTH_MARGIN);
 }
 
 // Active SGR state after consuming `s`, starting from `prev`. A reset clears it;
@@ -348,7 +364,7 @@ module.exports = {
   spinner, brandReveal, statusPanel, interopLine, divider, typewrite,
   randomTip, TOUR_PAGES,
   // Smart wrap
-  wrapAnsi, installSmartWrap, termWidth,
+  wrapAnsi, installSmartWrap, termWidth, rawWidth, setWidth,
   // ANSI helpers
   hide, show, up, clearLine, sleep,
 };

package/package.json

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