phewsh 0.15.12 → 0.15.13

package/commands/session.js

@@ -20,6 +20,7 @@ const { push, pull, ensureValidToken } = require('./sync');
 const { HARNESSES, listHarnesses, runViaHarness, cancelActive } = require('../lib/harnesses');
 const { recordDecision, labelOutcome, pendingDecisions, outcomeStats, OUTCOMES } = require('../lib/outcomes');
 const { suggest, suggestAll } = require('../lib/suggest');
+const { closest } = require('../lib/closest');
 const { recordSessionEvent } = require('../lib/receipts-data');
 const configFile = require('../lib/config-file');
 const { createFailureTracker, createLineDispatcher } = require('../lib/session-input');
@@ -332,6 +333,7 @@ async function main() {
   let awaitingFallback = null;     // { input, fullSystem, options } after a route failure
   let bootstrapChoices = null;     // root-bootstrap menu entries when no project here
   let nextChoices = null;          // ranked /next suggestions awaiting a numeric pick
+  let pendingDidYouMean = null;    // a suggested command; bare Enter accepts + runs it
   let decisionsThisSession = 0;
 
   // ── The Exhale: animated brand reveal ──────────────────
@@ -914,6 +916,9 @@ async function main() {
   async function handleInput(input) {
     input = expandPastes(input);
 
+    // Any typed input supersedes a pending "did you mean" offer.
+    if (pendingDidYouMean) pendingDidYouMean = null;
+
     // A bare number right after a route failure picks the fallback
     if (awaitingFallback) {
       const af = awaitingFallback;
@@ -1102,6 +1107,28 @@ async function main() {
       }
 
       if (cmd === 'help' || cmd === 'h') {
+        const wantsAll = /^(all|more|full|everything)$/i.test(cmdArg.trim());
+
+        // Bare /help → the short essentials a newcomer actually needs.
+        if (!wantsAll) {
+          console.log('');
+          console.log(`  ${sage('the loop: define .intent/ → sync → work → evolve → repeat')}`);
+          console.log('');
+          console.log(`  ${cream('the essentials')}`);
+          console.log(`    ${teal('just type')}      ${sage('chat — your .intent/ context travels with every route')}`);
+          console.log(`    ${teal('/next')}          ${sage('not sure? phewsh names the next step worth taking')}`);
+          console.log(`    ${teal('/use')} ${slate('<tool>')}   ${sage('route through Claude Code, Codex, Gemini… (their login, no key)')}`);
+          console.log(`    ${teal('@name')} ${slate('<msg>')}   ${sage('one message to one tool — @codex review this')}`);
+          console.log(`    ${teal('/work')} ${slate('[tool]')}  ${sage('hand off to the full interactive tool, outcome on return')}`);
+          console.log(`    ${teal('/clarify')}       ${sage('turn messy thoughts into .intent/ artifacts')}`);
+          console.log(`    ${teal('/outcomes')}      ${sage('label what you kept — the record that gets smarter')}`);
+          console.log('');
+          console.log(`  ${slate('/help all')} ${sage('everything')}  ${slate('·')}  ${slate('/tour')} ${sage('walkthrough')}  ${slate('·')}  ${slate('/quit')} ${sage('exit')}`);
+          console.log('');
+          rl.prompt();
+          return;
+        }
+
         console.log('');
         console.log(`  ${sage('the loop: define .intent/ → sync → work → evolve → repeat')}`);
         console.log('');
@@ -2044,8 +2071,14 @@ async function main() {
         return;
       }
 
-      // Unknown slash command
-      console.log(`  ${sage('Unknown command:')} ${cream('/' + cmd)} ${slate('— type /help for available commands')}`);
+      // Unknown slash command — suggest the nearest real one instead of a dead end.
+      const guess = closest(cmd, [...KNOWN_COMMANDS]);
+      if (guess) {
+        console.log(`  ${sage('No command')} ${cream('/' + cmd)}${sage('. Did you mean')} ${teal('/' + guess)}${sage('?')} ${slate('· enter = run it · /help all for everything')}`);
+        pendingDidYouMean = '/' + guess + (cmdArg ? ' ' + cmdArg : '');
+      } else {
+        console.log(`  ${sage('No command')} ${cream('/' + cmd)}${sage('.')} ${slate('Type')} ${teal('/next')} ${slate('for what to do, or')} ${teal('/help')} ${slate('for everything.')}`);
+      }
       rl.prompt();
       return;
     }
@@ -2099,7 +2132,16 @@ async function main() {
 
   const lineDispatcher = createLineDispatcher(handleInput, {
     onBatch: ({ input, lines }) => collapsePastedEcho(lines, input),
-    onNoop: () => rl.prompt(),
+    onNoop: () => {
+      // Bare Enter accepts a pending "did you mean" suggestion.
+      if (pendingDidYouMean) {
+        const cmd = pendingDidYouMean;
+        pendingDidYouMean = null;
+        handleInput(cmd).catch(() => {});
+        return;
+      }
+      rl.prompt();
+    },
     onError: (err) => {
       console.error(`\n  ${ember('!')} ${sage('Input failed:')} ${err.message}`);
       rl.prompt();

package/lib/closest.js

@@ -0,0 +1,59 @@
+// Find the nearest known command to a typo — so an unknown slash command
+// becomes "did you mean /clarify?" instead of a dead end. Pure + deterministic.
+//
+// Strategy, in order of confidence:
+//   1. Exact prefix — user typed a real abbreviation (/cla → /clarify).
+//   2. Small edit distance — a genuine typo (/claify → /clarify).
+// Returns the single best candidate, or null when nothing is close enough.
+
+function levenshtein(a, b) {
+  if (a === b) return 0;
+  if (!a.length) return b.length;
+  if (!b.length) return a.length;
+  let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  let curr = new Array(b.length + 1);
+  for (let i = 1; i <= a.length; i++) {
+    curr[0] = i;
+    for (let j = 1; j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+    }
+    [prev, curr] = [curr, prev];
+  }
+  return prev[b.length];
+}
+
+/**
+ * @param {string} input — the unknown token (no leading slash)
+ * @param {string[]} candidates — known command names
+ * @param {object} [opts]
+ * @param {number} [opts.maxDistance=2] — max edit distance to still suggest
+ * @returns {string|null} best candidate or null
+ */
+function closest(input, candidates, opts = {}) {
+  const maxDistance = opts.maxDistance ?? 2;
+  if (!input || !candidates || candidates.length === 0) return null;
+  const q = input.toLowerCase();
+
+  // 1. Prefix match — shortest matching command wins (most specific abbrev).
+  //    Require at least 2 chars so a stray "/a" doesn't latch onto everything.
+  if (q.length >= 2) {
+    const prefixes = candidates
+      .filter(c => c.toLowerCase().startsWith(q))
+      .sort((a, b) => a.length - b.length);
+    if (prefixes.length) return prefixes[0];
+  }
+
+  // 2. Edit distance — nearest within threshold; scale threshold down for
+  //    very short inputs so "x" doesn't "match" every 1-2 char command.
+  const cap = Math.min(maxDistance, Math.max(1, Math.floor(q.length / 2) + 1));
+  let best = null;
+  let bestD = Infinity;
+  for (const c of candidates) {
+    const d = levenshtein(q, c.toLowerCase());
+    if (d < bestD) { bestD = d; best = c; }
+  }
+  return bestD <= cap ? best : null;
+}
+
+module.exports = { closest, levenshtein };

package/package.json

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