phewsh 0.14.2 → 0.14.4

package/commands/session.js

@@ -291,13 +291,6 @@ async function main() {
   // PROJECT what am I in · ROUTE where typing goes · BACKUP what's ready if
   // the route hits a wall · WEB am I mirrored · RECORD what's accumulated
   let syncState = null;
-  if (config?.supabaseUserId && intentFiles.length > 0) {
-    syncState = await Promise.race([
-      checkSyncStatus(config),
-      new Promise(resolve => setTimeout(() => resolve(null), 3000)),
-    ]);
-  }
-
   const row = (label, value) => console.log(`  ${slate(label.padEnd(9))}${value}`);
 
   // realpath both sides — macOS /tmp and /var are symlinks into /private
@@ -307,8 +300,21 @@ async function main() {
     const rp = realPath(p);
     return rp.startsWith(home) ? '~' + rp.slice(home.length) : p;
   };
-  const atHome = realPath(process.cwd()) === realPath(os.homedir());
-  const recents = intentFiles.length === 0
+  let atHome = false;
+  let recents = [];
+
+  // Fail-soft render: corrupt data or a network hiccup may cost a row —
+  // it must never kill the session.
+  try {
+  if (config?.supabaseUserId && intentFiles.length > 0) {
+    syncState = await Promise.race([
+      checkSyncStatus(config),
+      new Promise(resolve => setTimeout(() => resolve(null), 3000)),
+    ]);
+  }
+
+  atHome = realPath(process.cwd()) === realPath(os.homedir());
+  recents = intentFiles.length === 0
     ? listProjects().filter(p => realPath(p.path) !== realPath(process.cwd())).slice(0, 3)
     : [];
 
@@ -371,6 +377,18 @@ async function main() {
   } else {
     row('RECORD', slate('empty — decisions and outcomes accumulate as you work'));
   }
+  } catch (cockpitErr) {
+    console.log(`  ${slate('(cockpit row unavailable — ' + cockpitErr.message + ' · PHEWSH_DEBUG=1 phewsh for details)')}`);
+    if (process.env.PHEWSH_DEBUG) console.error(cockpitErr.stack);
+  }
+
+  // Chat-routable options as they exist on THIS machine — every usage hint
+  // derives from this so /use, /provider, and reality never disagree.
+  function useOptions() {
+    const opts = harnesses.filter(h => h.installed && h.headless).map(h => h.id);
+    if (config?.apiKey) opts.push('api');
+    return opts;
+  }
 
   function showModeMenu() {
     console.log(`  ${b(cream('What are you trying to do?'))}`);
@@ -704,6 +722,7 @@ async function main() {
         console.log(`    ${teal('/use')} ${slate('<route>')}  ${sage('Switch: claude-code, codex, gemini, cursor, opencode, api')}`);
         console.log(`    ${teal('/harnesses')}   ${sage('Agent CLIs detected on this machine')}`);
         console.log(`    ${teal('/provider')}    ${sage('Current route + what\'s available')}`);
+        console.log(`    ${teal('/fallback')}    ${sage('What happens at a usage wall: ask or auto-switch')}`);
         console.log(`    ${teal('/outcomes')}    ${sage('Decision record — kept/reverted/superseded/failed')}`);
         console.log('');
         console.log(`  ${cream('session')}`);
@@ -1091,22 +1110,49 @@ async function main() {
           ['Route', routeLabel(route, config), 'green'],
         ];
         for (const h of harnesses) {
-          rows.push([h.label, h.installed ? `installed (${h.auth})` : 'not installed', h.installed ? 'green' : undefined]);
+          if (!h.installed && !['aider', 'goose', 'amp', 'droid'].includes(h.id)) {
+            rows.push([h.label, 'not installed']);
+            continue;
+          }
+          if (!h.installed) continue; // hide the long tail of uninstalled extras
+          const via = h.headless ? '' : ' · /work only';
+          rows.push([h.label, `ready — ${h.role}${via}`, 'green']);
         }
         rows.push(['API key', config?.apiKey ? config.apiKey.slice(0, 8) + '... (' + (config.provider || 'anthropic') + ')' : 'not set — optional', config?.apiKey ? 'green' : 'yellow']);
-        rows.push(['Fallback', config?.fallback === 'auto' ? 'auto-switch on failure' : 'ask before switching', 'peach']);
+        rows.push(['Fallback', (config?.fallback === 'auto' ? 'auto-switch on failure' : 'ask before switching') + ' — /fallback to change', 'peach']);
         if (route?.type === 'api') rows.push(['Model', MODELS[currentModel].name, 'cyan']);
         ui.statusPanel('Provider', rows);
-        console.log(`  ${slate('switch:')} ${cream('/use <' + harnesses.filter(h => h.installed).map(h => h.id).concat(config?.apiKey ? ['api'] : []).join('|') + '>')}`);
+        console.log(`  ${sage('One terminal. Every AI worker. Shared project memory.')}`);
+        console.log(`  ${slate('switch:')} ${cream('/use <' + useOptions().join('|') + '>')} ${slate('· interactive tools: /work <hermes|pi>')}`);
         console.log('');
         rl.prompt();
         return;
       }
 
+      if (cmd === 'fallback') {
+        const arg = cmdArg?.trim().toLowerCase();
+        if (arg === 'ask' || arg === 'auto') {
+          config = loadConfig() || {};
+          config.fallback = arg;
+          saveConfig(config);
+          console.log(`  ${teal('●')} ${sage('Fallback:')} ${cream(arg === 'auto' ? 'auto-switch to the next route on failure' : 'ask before switching')}`);
+          console.log(`  ${slate('either way your project context and record stay intact')}`);
+        } else {
+          console.log(`  ${sage('Fallback is')} ${cream(config?.fallback === 'auto' ? 'auto-switch' : 'ask first')} ${slate('— when your route hits a usage wall, context travels to the next one.')}`);
+          console.log(`  ${sage('Usage:')} ${cream('/fallback ask')} ${slate('·')} ${cream('/fallback auto')}`);
+        }
+        rl.prompt();
+        return;
+      }
+
       if (cmd === 'use') {
         if (!cmdArg) {
           console.log(`  ${sage('Current route:')} ${cream(routeLabel(route, config))}`);
-          console.log(`  ${sage('Usage:')} ${cream('/use <claude-code|codex|gemini|cursor|opencode|api>')}`);
+          console.log(`  ${sage('Usage:')} ${cream('/use <' + useOptions().join('|') + '>')}`);
+          const workOnlyInstalled = harnesses.filter(h => h.installed && !h.headless);
+          if (workOnlyInstalled.length > 0) {
+            console.log(`  ${slate('interactive tools: /work <' + workOnlyInstalled.map(h => h.id).join('|') + '>')}`);
+          }
           rl.prompt();
           return;
         }
@@ -1364,5 +1410,7 @@ async function main() {
 
 main().catch(err => {
   console.error('\n  Error:', err.message);
+  if (process.env.PHEWSH_DEBUG) console.error('\n' + err.stack);
+  else console.error('  (run PHEWSH_DEBUG=1 phewsh for the full trace)');
   process.exit(1);
 });

package/lib/harnesses.js

@@ -15,17 +15,17 @@ const { execSync, spawn } = require('child_process');
 // how to launch it interactively (detection + /work still fully supported —
 // never guess flags; a wrong invocation looks like phewsh being broken).
 const HARNESSES = {
-  'claude-code': { bin: 'claude',       label: 'Claude Code',  auth: 'Claude subscription / Console', args: (p) => ['-p', p, '--output-format', 'text'] },
-  'codex':       { bin: 'codex',        label: 'Codex CLI',    auth: 'ChatGPT plan',                  args: (p) => ['exec', p] },
-  'gemini':      { bin: 'gemini',       label: 'Gemini CLI',   auth: 'Google login',                  args: (p) => ['-p', p] },
-  'cursor':      { bin: 'cursor-agent', label: 'Cursor Agent', auth: 'Cursor account',                args: (p) => ['-p', p, '--output-format', 'text'] },
-  'opencode':    { bin: 'opencode',     label: 'OpenCode',     auth: 'OpenCode Zen / configured',     args: (p) => ['run', p] },
-  'hermes':      { bin: 'hermes',       label: 'Hermes',       auth: 'Nous account',                  args: null },
-  'pi':          { bin: 'pi',           label: 'Pi',           auth: 'Pi login',                      args: null },
-  'aider':       { bin: 'aider',        label: 'Aider',        auth: 'configured keys',               args: (p) => ['--message', p] },
-  'goose':       { bin: 'goose',        label: 'Goose',        auth: 'Block / configured',            args: (p) => ['run', '-t', p] },
-  'amp':         { bin: 'amp',          label: 'Amp',          auth: 'Sourcegraph account',           args: (p) => ['-x', p] },
-  'droid':       { bin: 'droid',        label: 'Droid',        auth: 'Factory account',               args: (p) => ['exec', p] },
+  'claude-code': { bin: 'claude',       label: 'Claude Code',  role: 'writes code',          auth: 'Claude subscription / Console', args: (p) => ['-p', p, '--output-format', 'text'] },
+  'codex':       { bin: 'codex',        label: 'Codex CLI',    role: 'reasons & reviews',    auth: 'ChatGPT plan',                  args: (p) => ['exec', p] },
+  'gemini':      { bin: 'gemini',       label: 'Gemini CLI',   role: "another model's take", auth: 'Google login',                  args: (p) => ['-p', p] },
+  'cursor':      { bin: 'cursor-agent', label: 'Cursor Agent', role: 'edits files',          auth: 'Cursor account',                args: (p) => ['-p', p, '--output-format', 'text'] },
+  'opencode':    { bin: 'opencode',     label: 'OpenCode',     role: 'general agent',        auth: 'OpenCode Zen / configured',     args: (p) => ['run', p] },
+  'hermes':      { bin: 'hermes',       label: 'Hermes',       role: 'runs loops',           auth: 'Nous account',                  args: null },
+  'pi':          { bin: 'pi',           label: 'Pi',           role: 'conversation',         auth: 'Pi login',                      args: null },
+  'aider':       { bin: 'aider',        label: 'Aider',        role: 'pair-codes',           auth: 'configured keys',               args: (p) => ['--message', p] },
+  'goose':       { bin: 'goose',        label: 'Goose',        role: 'automates tasks',      auth: 'Block / configured',            args: (p) => ['run', '-t', p] },
+  'amp':         { bin: 'amp',          label: 'Amp',          role: 'agentic coding',       auth: 'Sourcegraph account',           args: (p) => ['-x', p] },
+  'droid':       { bin: 'droid',        label: 'Droid',        role: 'agentic coding',       auth: 'Factory account',               args: (p) => ['exec', p] },
 };
 
 function isInstalled(id) {

package/lib/outcomes.js

@@ -19,7 +19,11 @@ const DECISIONS_FILE = path.join(OUTCOMES_DIR, 'decisions.json');
 const OUTCOMES = ['kept', 'reverted', 'superseded', 'failed'];
 
 function load() {
-  try { return JSON.parse(fs.readFileSync(DECISIONS_FILE, 'utf-8')); } catch { return []; }
+  // Array-or-nothing: a corrupt/odd-shaped file must degrade, never throw
+  try {
+    const d = JSON.parse(fs.readFileSync(DECISIONS_FILE, 'utf-8'));
+    return Array.isArray(d) ? d : [];
+  } catch { return []; }
 }
 
 function save(decisions) {
@@ -122,7 +126,10 @@ const BYPASS_REASONS = [
 ];
 
 function loadBypasses() {
-  try { return JSON.parse(fs.readFileSync(BYPASSES_FILE, 'utf-8')); } catch { return []; }
+  try {
+    const d = JSON.parse(fs.readFileSync(BYPASSES_FILE, 'utf-8'));
+    return Array.isArray(d) ? d : [];
+  } catch { return []; }
 }
 
 function recordBypass(reason, note = '') {

package/lib/projects-index.js

@@ -4,13 +4,16 @@
 // so running `phewsh` at machine root becomes mission-control bootstrap
 // ("where do you want to work?") instead of "no project found, goodbye."
 //
-// Storage: ~/.phewsh/projects.json. Local-first; web sync layers on top.
+// Storage: ~/.phewsh/project-index.json. Local-first; web sync layers on top.
+// NOT projects.json — that file belongs to `phewsh mcp` (web project cache,
+// array-shaped). Claiming it caused a startup crash AND would have clobbered
+// MCP data on first write. One file, one owner.
 
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
-const INDEX_FILE = path.join(os.homedir(), '.phewsh', 'projects.json');
+const INDEX_FILE = path.join(os.homedir(), '.phewsh', 'project-index.json');
 
 // Shallow-scanned roots when the user asks to find projects. One level deep,
 // opt-in only — deep-scanning someone's machine uninvited is invasive.
@@ -24,7 +27,12 @@ const SCAN_ROOTS = [
 ];
 
 function load() {
-  try { return JSON.parse(fs.readFileSync(INDEX_FILE, 'utf-8')); } catch { return { projects: {} }; }
+  // Shape-or-nothing: corrupt index degrades to empty, never throws
+  try {
+    const i = JSON.parse(fs.readFileSync(INDEX_FILE, 'utf-8'));
+    if (i && typeof i === 'object' && i.projects && typeof i.projects === 'object') return i;
+    return { projects: {} };
+  } catch { return { projects: {} }; }
 }
 
 function save(index) {

package/package.json

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