phewsh 0.15.61 → 0.15.63

package/commands/session.js

@@ -439,15 +439,15 @@ async function main() {
       const dot = teal('●');
       const tools = `${toolCount} AI tool${toolCount !== 1 ? 's' : ''}`;
       if (hasProject && toolCount > 1) {
-        console.log(`  ${dot} ${sage('Welcome back. One shared memory of')} ${cream(projectName)}${sage(`, and ${tools} that all read it`)} ${slate('— switch tools mid-thought, nothing re-explained.')}`);
+        console.log(`  ${dot} ${sage('phew — you made it.')} ${slate('shh,')} ${cream(projectName)} ${sage(`and your ${tools} are aligned to one thread`)} ${slate('— switch mid-thought, nothing re-explained.')}`);
       } else if (hasProject) {
-        console.log(`  ${dot} ${sage('Welcome back. One verified memory of')} ${cream(projectName)} ${sage('— ready for whatever AI tool you reach for next.')}`);
+        console.log(`  ${dot} ${sage('phew — you made it.')} ${slate('shh,')} ${sage('one verified memory of')} ${cream(projectName)} ${sage('— ready for whatever tool you reach for next.')}`);
       } else if (toolCount > 1) {
-        console.log(`  ${dot} ${sage(`Welcome — you made it. ${tools} here; this is where they share one thread.`)} ${slate('/init')} ${sage('to begin.')}`);
+        console.log(`  ${dot} ${sage(`phew — you made it.`)} ${slate('shh,')} ${sage(`time to align your ${tools} to you and get down to business.`)} ${cream('/init')} ${sage('to begin.')}`);
       } else if (toolCount === 1) {
-        console.log(`  ${dot} ${sage('Welcome — you made it. Add Codex or Gemini and phewsh keeps every tool on the same page.')}`);
+        console.log(`  ${dot} ${sage('phew — you made it.')} ${slate('shh,')} ${sage('add Codex or Gemini and phewsh keeps every tool aligned to you.')}`);
       } else {
-        console.log(`  ${dot} ${sage('Welcome — you made it. Install Claude Code, Codex, or Gemini and phewsh keeps them all on the same page.')}`);
+        console.log(`  ${dot} ${sage('phew — you made it.')} ${slate('shh,')} ${sage('install Claude Code, Codex, or Gemini and phewsh keeps them aligned to you.')}`);
       }
       console.log('');
     } catch { /* the welcome is a flourish, never a blocker */ }
@@ -554,6 +554,8 @@ async function main() {
       const parts = [cream('HEAD ' + v.shortHead)];
       parts.push(v.dirtyCount ? peach(`${v.dirtyCount} uncommitted`) : sage('clean'));
       if (v.driftCommits > 0) parts.push(ember(`⚠ ${v.driftCommits} commit${v.driftCommits !== 1 ? 's' : ''} since .intent updated`));
+      // Sharper than recency: the docs still name an older version than shipped.
+      if (v.versionDrift) parts.push(ember(`⚠ .intent says ${v.versionDrift.claimed}, shipped ${v.versionDrift.shipped} — /reconcile`));
       row('VERIFIED', parts.join(slate(' · ')) + slate('  — /truth · /brief'));
     }
   } catch { /* the verified row is a glance, never a blocker */ }
@@ -2469,7 +2471,15 @@ async function main() {
           rl.prompt();
           return;
         }
-        const target = cmdArg.trim().toLowerCase();
+        // Forgiving aliases — people type the tool's everyday name, not its id.
+        // `/use claude` should just work, not bounce off "Unknown route".
+        const USE_ALIASES = {
+          claude: 'claude-code', cc: 'claude-code', claudecode: 'claude-code',
+          gpt: 'codex', chatgpt: 'codex', openai: 'codex',
+          grokbuild: 'grok',
+        };
+        const raw = cmdArg.trim().toLowerCase();
+        const target = USE_ALIASES[raw] || raw;
         if (target === 'api') {
           if (!config?.apiKey) {
             console.log(`  ${ember('!')} ${sage('No API key set — run /key first.')}`);

package/lib/truth.js

@@ -273,16 +273,50 @@ async function fetchNpmLatest(packageName, { fetchImpl = global.fetch, timeoutMs
 // Fast, offline, fail-soft snapshot for the front-door cockpit — no npm fetch,
 // no file hashing. Answers "what verified truth is loaded?" at a glance so the
 // product thesis (one verified truth) is visible the moment phewsh opens.
+// Cheap, offline version-claim drift: does the shipped package version sit ahead
+// of the newest version the .intent narrative still claims? This is the SHARP
+// staleness signal the front door was missing — the recency-based "commits since
+// .intent changed" check goes quiet the moment you edit status.md, even if its
+// headline claim is stale. We compare the project's package version (repo root,
+// or a cli/ monorepo child like phewsh itself) to the max version mentioned in
+// status.md/next.md, and only flag when code has shipped PAST the docs.
+function quickVersionDrift(cwd = process.cwd()) {
+  try {
+    let shipped = null;
+    for (const rel of ['package.json', 'cli/package.json']) {
+      const p = path.join(cwd, rel);
+      if (!fs.existsSync(p)) continue;
+      try { shipped = JSON.parse(fs.readFileSync(p, 'utf-8')).version; } catch { /* unreadable */ }
+      if (shipped) break;
+    }
+    if (!shipped) return null;
+    let claimed = null;
+    for (const rel of ['.intent/status.md', '.intent/next.md']) {
+      const p = path.join(cwd, rel);
+      if (!fs.existsSync(p)) continue;
+      for (const m of fs.readFileSync(p, 'utf-8').matchAll(/\bv?(\d+\.\d+\.\d+)\b/g)) {
+        if (!claimed || compareVersions(m[1], claimed) > 0) claimed = m[1];
+      }
+    }
+    if (!claimed) return null;
+    return compareVersions(shipped, claimed) > 0 ? { shipped, claimed } : null;
+  } catch {
+    return null;
+  }
+}
+
 function quickVerifiedState(cwd = process.cwd()) {
   try {
     const git = gitSnapshot(cwd);
-    if (!git.available) return { available: false, isRepo: false };
+    const versionDrift = quickVersionDrift(cwd);
+    if (!git.available) return { available: false, isRepo: false, versionDrift };
     return {
       available: true,
       isRepo: true,
       shortHead: git.shortHead,
       dirtyCount: git.tracked.length + git.untracked.length,
       driftCommits: git.drift?.tracked ? git.drift.commitsSince : 0,
+      versionDrift,
     };
   } catch {
     return { available: false, isRepo: false };
@@ -397,5 +431,6 @@ module.exports = {
   parsePorcelain,
   projectionInfo,
   quickVerifiedState,
+  quickVersionDrift,
   statusDrift,
 };

package/package.json

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