phewsh 0.15.31 → 0.15.32

package/commands/session.js

@@ -17,7 +17,7 @@ const intentDir = () => path.join(process.cwd(), '.intent');
 const { select, refreshSession: refreshSess } = require('../lib/supabase');
 const { readPPS } = require('../lib/pps');
 const { push, pull, ensureValidToken } = require('./sync');
-const { HARNESSES, interactiveLaunchArgs, listHarnesses, runViaHarness, cancelActive } = require('../lib/harnesses');
+const { HARNESSES, INSTALL, interactiveLaunchArgs, listHarnesses, runViaHarness, cancelActive } = require('../lib/harnesses');
 const { recordDecision, labelOutcome, pendingDecisions, recentDecisions, outcomeStats, OUTCOMES } = require('../lib/outcomes');
 const { suggest, suggestAll } = require('../lib/suggest');
 const continuity = require('../lib/continuity');
@@ -56,6 +56,23 @@ const { recordProject, listProjects, scanForProjects, fmtAgo } = require('../lib
 const { b, d, w, g, green, cyan, yellow,
         teal, peach, sage, slate, cream, ember } = ui;
 
+// Best-effort copy to the system clipboard so the brief survives the native
+// tool taking over the terminal (and any trust/permission gate). Returns true
+// if a clipboard tool accepted it. Never throws — it's a convenience.
+function copyToClipboard(text) {
+  const { spawnSync } = require('child_process');
+  const tries = process.platform === 'darwin' ? [['pbcopy', []]]
+    : process.platform === 'win32' ? [['clip', []]]
+    : [['wl-copy', []], ['xclip', ['-selection', 'clipboard']], ['xsel', ['--clipboard', '--input']]];
+  for (const [bin, args] of tries) {
+    try {
+      const r = spawnSync(bin, args, { input: text, stdio: ['pipe', 'ignore', 'ignore'] });
+      if (r.status === 0) return true;
+    } catch (_) { /* try next */ }
+  }
+  return false;
+}
+
 // Sync awareness: compare local .intent/ timestamps with cloud updated_at
 async function checkSyncStatus(config) {
   if (!config?.supabaseUserId || !config?.supabaseAccessToken) return null;
@@ -2367,7 +2384,16 @@ async function main() {
           return;
         }
         if (!harnesses.find(x => x.id === target)?.installed) {
-          console.log(`  ${ember('!')} ${sage(h.label + ' is not installed on this machine.')}`);
+          const how = INSTALL[target];
+          console.log('');
+          console.log(`  ${ember('!')} ${sage(h.label + ' isn\'t installed on this machine yet.')}`);
+          if (how) {
+            const isCmd = !how.startsWith('see ');
+            console.log(`  ${sage('Install:')}  ${isCmd ? cream(how) : slate(how)}`);
+          }
+          if (h.auth) console.log(`  ${sage('Sign in:')}  ${slate(h.auth + ' (the tool prompts you on first run)')}`);
+          console.log(`  ${sage('Then run:')} ${cream('phewsh ' + target)} ${slate('— phewsh briefs it and hands off')}`);
+          console.log('');
           rl.prompt();
           return;
         }
@@ -2375,9 +2401,13 @@ async function main() {
         const preflightTruth = await auditTruth();
         const before = captureSnapshot(preflightTruth);
         const generatedBrief = await generateBrief({ report: preflightTruth });
-        const launchBrief = `${generatedBrief.content}\n\nThis is a PHEWSH transition briefing. Use it as project context, preserve native tool behavior, and verify claims against the repository before acting. When you finish, exit this tool — PHEWSH resumes, runs an automatic postflight comparing what changed against this brief, and offers reconciliation.`;
+        const launchBrief = `${generatedBrief.content}\n\nYou are receiving a PHEWSH handoff brief — acknowledge in one short line that you've loaded it, then proceed. Use it as project context, preserve native tool behavior, and verify claims against the repository before acting. When you finish, exit this tool — PHEWSH resumes, runs an automatic postflight comparing what changed against this brief, and offers reconciliation.`;
         const savedBrief = persistBrief(generatedBrief.content, { project: projectName, route: target });
         const launch = interactiveLaunchArgs(target, launchBrief, { model: harnessModel });
+        // Foolproof fallback: the brief on the clipboard survives the native
+        // tool taking over the terminal and any trust/permission gate. If the
+        // tool ignores or never received it, the human just pastes it in.
+        const briefOnClipboard = copyToClipboard(launchBrief);
         const decisionId = recordDecision({
           project: projectName,
           route: target,
@@ -2391,8 +2421,13 @@ async function main() {
         console.log(`  ${sage('Route:')} ${cream(h.label)}${harnessModel ? slate(' · model ' + harnessModel) : slate(' · native default model')}`);
         console.log(`  ${sage('Git:')} ${cream(preflightTruth.git.shortHead || 'unknown')} ${slate('· ' + before.dirty.length + ' uncommitted path(s) before work')}`);
         console.log(`  ${sage('Truth:')} ${preflightTruth.conflicts.length ? peach(preflightTruth.conflicts.length + ' conflict(s) carried explicitly') : green('no explicit conflicts')}`);
-        console.log(`  ${sage('Brief:')} ${launch.briefingPassed ? green('passed directly to the native harness') : peach('not injectable for this harness; available via /brief')}`);
-        console.log(`  ${sage('Record:')} ${savedBrief.written ? slate('exact briefing saved locally for this transition') : peach('briefing persistence unavailable; launch continues')}`);
+        console.log(`  ${sage('Brief:')} ${launch.briefingPassed ? green('auto-attached to ' + h.label) : peach('not auto-injectable for this tool')}${briefOnClipboard ? slate(' · copied to your clipboard') : ''}`);
+        console.log(`  ${sage('Record:')} ${savedBrief.written ? slate('exact briefing saved locally' + (savedBrief.file ? ' → ' + savedBrief.file : '')) : peach('briefing persistence unavailable; launch continues')}`);
+        if (briefOnClipboard) {
+          console.log(`  ${slate('Foolproof:')} ${sage('if ' + h.label + ' shows a trust prompt or doesn\'t mention the brief, just paste it in')} ${slate('(⌘V / Ctrl+V)')}`);
+        } else if (savedBrief.file) {
+          console.log(`  ${slate('Foolproof:')} ${sage('if ' + h.label + ' doesn\'t pick up the brief, paste from')} ${cream(savedBrief.file)}`);
+        }
         console.log(`  ${slate('After exit PHEWSH will compare Git, files, intent claims, generated drift, and contradictions.')}`);
         ui.divider('line');
         console.log(`  ${teal('●')} ${sage('Handing the terminal to')} ${cream(h.label)} ${slate('— exit to return for postflight')}`);

package/lib/harnesses.js

@@ -36,6 +36,27 @@ const HARNESSES = {
   'droid':       { bin: 'droid',        label: 'Droid',        role: 'agentic coding',       bestFor: 'agentic coding',                           auth: 'Factory account',               args: (p) => ['exec', p] },
 };
 
+// Best-effort install hints, shown when a harness isn't on the machine yet.
+// Commands where the install path is well-known and stable; a docs pointer
+// otherwise. We never auto-run these — phewsh shows them; the human decides.
+// (Install paths and auth change upstream; treat as a guidepost, not gospel.)
+const INSTALL = {
+  'claude-code': 'npm i -g @anthropic-ai/claude-code',
+  'codex':       'npm i -g @openai/codex',
+  'gemini':      'npm i -g @google/gemini-cli',
+  'cursor':      'curl https://cursor.com/install -fsS | bash',
+  'opencode':    'npm i -g opencode-ai',
+  'grok':        'npm i -g @vibe-kit/grok-cli',
+  'copilot':     'npm i -g @github/copilot',
+  'kiro':        'see kiro.dev/downloads',
+  'hermes':      'see nousresearch.com',
+  'pi':          'see pi.ai',
+  'aider':       'python -m pip install aider-chat',
+  'goose':       'see block.github.io/goose',
+  'amp':         'npm i -g @sourcegraph/amp',
+  'droid':       'see factory.ai',
+};
+
 // In-flight harness children — so ESC in the session can cancel a turn.
 const ACTIVE_CHILDREN = new Set();
 
@@ -199,6 +220,7 @@ function runViaHarness(id, systemPrompt, userPrompt, opts = {}) {
 
 module.exports = {
   HARNESSES,
+  INSTALL,
   isInstalled,
   detectInstalled,
   interactiveLaunchArgs,

package/package.json

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