phewsh 0.15.59 → 0.15.60

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', 'width',
+    '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')}`);
@@ -1785,8 +1821,20 @@ 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;
       }
@@ -2661,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/package.json

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