phewsh 0.15.62 → 0.15.63

package/commands/session.js

@@ -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 */ }

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.62",
+  "version": "0.15.63",
   "description": "Turn intent into action. Structure your thinking, execute your next step.",
   "bin": {
     "phewsh": "bin/phewsh.js"