phewsh 0.15.58 → 0.15.60

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

@@ -73,6 +73,35 @@ function copyToClipboard(text) {
   return false;
 }
 
+// Show the cross-harness handoff — the heart of phewsh's continuity promise:
+// the verified brief that travels to whatever AI tool you pick up next, now
+// rendered as readable markdown instead of raw text and saved so the next tool
+// (or the next phewsh session) inherits it. Best-effort and fail-soft; a
+// handoff that can't generate must never block exit or a switch.
+async function showHandoff({ projectName, route, reason = '', nextHint = true } = {}) {
+  let result = { shown: false, file: null };
+  try {
+    const { content } = await generateBrief();
+    const { renderMarkdown } = require('../lib/md');
+    const saved = persistBrief(content, { project: projectName, route: route || 'unknown' });
+    console.log('');
+    console.log(`  ${teal('●')} ${b(cream('Handoff ready'))}${reason ? ' ' + slate('— ' + reason) : ''}`);
+    console.log(`  ${slate('This is exactly what travels to the next AI tool — nothing re-explained.')}`);
+    ui.divider('line');
+    console.log(renderMarkdown(content));
+    ui.divider('line');
+    if (saved.written) console.log(`  ${slate('saved · ' + saved.file.replace(require('os').homedir(), '~'))}`);
+    copyToClipboard(content);
+    console.log(`  ${slate('copied to clipboard · paste into any tool, or')} ${cream('/use codex')} ${slate('to continue here')}`);
+    if (nextHint) console.log(`  ${slate('full verified brief anytime:')} ${cream('/brief')} ${slate('·')} ${cream('/handoff')}`);
+    console.log('');
+    result = { shown: true, file: saved.file };
+  } catch (err) {
+    console.log(`  ${ember('!')} ${slate('Could not build the handoff: ' + err.message)}`);
+  }
+  return result;
+}
+
 // Sync awareness: compare local .intent/ timestamps with cloud updated_at
 async function checkSyncStatus(config) {
   if (!config?.supabaseUserId || !config?.supabaseAccessToken) return null;
@@ -938,7 +967,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', 'handoff',
   ]);
   const installedIds = harnesses.filter(h => h.installed).map(h => h.id);
   let turnAbort = null;       // AbortController while an API turn streams
@@ -1346,6 +1375,12 @@ async function main() {
           const h = selfheal.heal();
           if (h.healed) console.log(`  ${teal('↻')} ${sage("Harness context refreshed from .intent/ — you didn't have to")}`);
         } catch { /* self-heal must never block exit */ }
+        // The handoff is given, not asked for: leaving a project hands you the
+        // verified brief that the next AI tool inherits — the continuity promise
+        // made visible on the way out. Only in a real project; never blocks exit.
+        if (intentFiles.length > 0) {
+          await showHandoff({ projectName, route: route?.id, reason: 'carry this into your next tool', nextHint: false });
+        }
         try { require('../lib/intro').farewell(); } catch { /* sign-off is a nicety */ }
         console.log(`  ${sage('session ended · ' + turns + ' exchanges · ' + (totalPromptTokens + totalCompletionTokens) + ' tokens')}`);
         if (decisionsThisSession > 0) {
@@ -1658,6 +1693,7 @@ async function main() {
         console.log('');
         console.log(`  ${cream('session')}`);
         console.log(`    ${teal('/work')} ${slate('[harness]')} ${sage('Preflight, brief, native handoff, automatic postflight')}`);
+        console.log(`    ${teal('/handoff')}     ${sage('See the verified brief the next AI tool inherits — rendered + saved')}`);
         console.log(`    ${teal('/switch')} ${slate('<harness>')} ${sage('Launch another native tool with a freshly verified briefing')}`);
         console.log(`    ${teal('/run')} ${slate('<prompt>')} ${sage('One-shot prompt (no history)')}`);
         console.log(`    ${teal('esc')}          ${sage('Cancel a running turn · clear the input line')}`);
@@ -1669,6 +1705,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 +1751,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('');
@@ -1742,12 +1821,24 @@ async function main() {
       if (cmd === 'brief') {
         console.log('');
         const { content } = await generateBrief();
-        console.log(content);
+        const { renderMarkdown } = require('../lib/md');
+        console.log(renderMarkdown(content));
+        console.log('');
+        console.log(`  ${slate('this is your handoff — it travels to the next AI tool ·')} ${cream('/handoff')} ${slate('to save + copy it')}`);
         console.log('');
         rl.prompt();
         return;
       }
 
+      // /handoff — explicitly produce, render, save, and copy the cross-harness
+      // handoff so you can SEE what would carry into the next tool.
+      if (cmd === 'handoff') {
+        console.log(`  ${sage('Building your handoff…')}`);
+        await showHandoff({ projectName, route: route?.id, reason: 'what the next AI tool will pick up' });
+        rl.prompt();
+        return;
+      }
+
       if (cmd === 'status') {
         const turns = messages.length / 2;
         config = loadConfig();
@@ -2618,6 +2709,7 @@ async function main() {
         } else {
           console.log(`  ${teal('●')} ${sage('Back in phewsh.')} ${slate('No changes detected. 1 kept · 2 undid · 3 redid · 4 flopped · /reconcile · /switch <tool>')}`);
         }
+        console.log(`  ${slate('continuing elsewhere?')} ${cream('/handoff')} ${slate('shows the updated brief the next tool inherits')}`);
         console.log('');
         rl.prompt();
         return;

package/lib/md.js

@@ -120,4 +120,13 @@ function streamRenderer(write) {
   };
 }
 
-module.exports = { inlineMd, renderLine, streamRenderer };
+// Render a complete markdown string to styled, word-wrapped terminal text —
+// the non-streaming counterpart to streamRenderer, for content we already have
+// in full (a handoff brief, a saved record). Carries fence state across lines
+// so code blocks render literally.
+function renderMarkdown(md) {
+  const state = { inFence: false };
+  return String(md).split('\n').map((line) => renderLine(line, state)).join('\n');
+}
+
+module.exports = { inlineMd, renderLine, streamRenderer, renderMarkdown };

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.60",
   "description": "Turn intent into action. Structure your thinking, execute your next step.",
   "bin": {
     "phewsh": "bin/phewsh.js"