phewsh 0.15.45 → 0.15.47

package/bin/phewsh.js

@@ -87,6 +87,7 @@ const COMMANDS = {
   seq:     () => require('../commands/sequence')(),
   ambient: () => require('../commands/ambient')(),
   shim:    () => require('../commands/shim')(),
+  status:  () => require('../commands/status')(),
   hook:    () => require('../commands/hook')(),
   welcome: () => require('../commands/welcome')(),
   intro:   () => require('../commands/welcome')(),
@@ -113,6 +114,7 @@ function showHelp() {
   console.log(`    ${cyan('intent')}     ${g('Create, view, evolve .intent/ artifacts')}`);
   console.log(`    ${cyan('gate')}       ${g('Set constraints (budget, time, skill, urgency)')}`);
   console.log(`    ${cyan('context')}    ${g('Export .intent/ for any AI tool')}`);
+  console.log(`    ${cyan('status')}     ${g('git status for AI continuity — truth, record, drift, what\'s wired')}`);
   console.log(`    ${cyan('truth')}      ${g('Read-only audit: versions, Git, intent, projections, conflicts')}`);
   console.log(`    ${cyan('brief')}      ${g('Provider-ready briefing built from verified project truth')}`);
   console.log(`    ${cyan('ai')}         ${g('One-shot prompt with .intent/ context')}
@@ -226,11 +228,12 @@ if (!command) {
   exitAfterUpdate(0);
 } else if (COMMANDS[command]) {
   COMMANDS[command]();
-} else if (require('../lib/harnesses').HARNESSES[command]) {
-  // `phewsh <harness>` — a doorway shortcut. Launch the session and have it
-  // auto-run /work for that harness (preflight → brief → native handoff →
-  // postflight). This is what the phewsh.com doorways copy as a single command.
-  process.env.PHEWSH_AUTOWORK = command;
+} else if (require('../lib/harnesses').resolveHarness(command)) {
+  // `phewsh <harness>` — a doorway shortcut. Accepts the id OR the tool's real
+  // binary (so `phewsh claude` works, since that's the Claude Code binary).
+  // Launch the session and auto-run /work for that harness (preflight → brief →
+  // native handoff → postflight). This is what the phewsh.com doorways copy.
+  process.env.PHEWSH_AUTOWORK = require('../lib/harnesses').resolveHarness(command);
   ambientSelfHeal().finally(() => maybeFirstRunIntro().then(() => COMMANDS.session()));
 } else {
   console.error(`\n  Unknown command: ${command}\n  Run 'phewsh help' for available commands.\n`);

package/commands/status.js

@@ -0,0 +1,118 @@
+// phewsh status — "git status for AI continuity."
+//
+// The product, stated as health. The user's real question isn't "did CLAUDE.md
+// load" — it's "will the next AI know what the last one learned?" This answers
+// it: project truth, the decision record, cross-tool continuity, drift, and how
+// phewsh is wired into this machine. Everything else (hooks, shims, base files,
+// /intent) is implementation that feeds this one view. Offline, deterministic.
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const b = (s) => `\x1b[1m${s}\x1b[0m`;
+const teal = (s) => `\x1b[38;5;79m${s}\x1b[0m`;
+const sage = (s) => `\x1b[38;5;151m${s}\x1b[0m`;
+const slate = (s) => `\x1b[38;5;247m${s}\x1b[0m`;
+const cream = (s) => `\x1b[38;5;230m${s}\x1b[0m`;
+const peach = (s) => `\x1b[38;5;216m${s}\x1b[0m`;
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+
+const ok = green('✓');
+const off = slate('○');
+const warn = peach('⚠');
+
+function row(label, value) {
+  return `  ${slate(label.padEnd(13))} ${value}`;
+}
+
+function projectName(cwd) {
+  try {
+    const m = JSON.parse(fs.readFileSync(path.join(cwd, '.intent', 'project.json'), 'utf-8'));
+    if (m.name) return m.name;
+  } catch { /* fall through */ }
+  return path.basename(cwd);
+}
+
+function loadDecisions() {
+  try { return JSON.parse(fs.readFileSync(path.join(os.homedir(), '.phewsh', 'outcomes', 'decisions.json'), 'utf-8')); }
+  catch { return []; }
+}
+
+function loadLedger() {
+  try { return JSON.parse(fs.readFileSync(path.join(os.homedir(), '.phewsh', 'ambient.json'), 'utf-8')); }
+  catch { return { applied: {} }; }
+}
+
+function main() {
+  const cwd = process.cwd();
+  const intentDir = path.join(cwd, '.intent');
+  const hasIntent = fs.existsSync(intentDir);
+  const key = path.basename(cwd);
+
+  console.log('');
+  console.log(`  ${b('😮‍💨 PHEWSH STATUS')} ${slate('· ' + projectName(cwd))}`);
+  console.log('');
+
+  // ── Continuity asset (the product) ─────────────────────────────────
+  if (!hasIntent) {
+    console.log(row('Truth', `${off} ${sage('no shared project truth here yet')}`));
+    console.log(row('', slate('create it so the next AI inherits this one\'s context:')));
+    console.log(row('', cream('phewsh intent --init')));
+  } else {
+    const files = fs.readdirSync(intentDir).filter(f => /\.(md|json)$/.test(f));
+    const has = (f) => files.includes(f);
+    console.log(row('Truth', `${ok} ${sage('.intent present')} ${slate('(' + files.length + ' files)')}`));
+    console.log(row('Vision', has('vision.md') ? `${ok} ${slate('loaded')}` : `${off} ${slate('missing')}`));
+    console.log(row('Next step', (has('next.md') || has('status.md')) ? `${ok} ${slate('loaded')}` : `${off} ${slate('missing')}`));
+
+    // Decision record
+    let stats = { total: 0, pending: 0 };
+    try { stats = require('../lib/outcomes').outcomeStats({ project: key }); } catch { /* none */ }
+    const pend = stats.pending ? `  ${warn} ${peach(stats.pending + ' pending')}` : `  ${ok} ${slate('all labeled')}`;
+    console.log(row('Record', `${cream(stats.total + ' decisions')}${stats.total ? pend : slate(' — none yet')}`));
+
+    // Cross-tool continuity
+    try {
+      const continuity = require('../lib/continuity');
+      const decisions = loadDecisions();
+      const tools = continuity.toolsInThread(decisions, { project: key });
+      const line = continuity.lastLeftOff(decisions, { project: key });
+      if (tools >= 2) console.log(row('Continuity', `${ok} ${sage(tools + ' tools, one thread')}${line && line.ts ? slate(' · last ' + continuity.agoText(line.ts)) : ''}`));
+      else if (tools === 1) console.log(row('Continuity', `${slate('1 tool so far — continuity builds as you switch tools')}`));
+      else console.log(row('Continuity', slate('no activity recorded yet')));
+    } catch { /* best-effort */ }
+
+    // Drift
+    try {
+      const drift = require('../lib/selfheal').commitsSinceIntent(cwd);
+      console.log(row('Drift', drift > 0
+        ? `${warn} ${peach(drift + ' commit(s) since .intent updated')} ${slate('— reconcile to refresh')}`
+        : `${ok} ${slate('0 — record matches the code')}`));
+    } catch { /* best-effort */ }
+  }
+
+  // ── Delivery (implementation — how phewsh reaches your tools) ───────
+  console.log('');
+  console.log(`  ${slate('Delivery')}`);
+  const ledger = loadLedger();
+  let ambientOn = false;
+  try { ambientOn = fs.readFileSync(path.join(os.homedir(), '.claude', 'settings.json'), 'utf-8').includes('phewsh hook session-start'); } catch { /* off */ }
+  const gb = (ledger.applied && ledger.applied.globalBase) ? 'base files' : null;
+  const sc = (ledger.applied && ledger.applied.slashCommands && ledger.applied.slashCommands.tools) || [];
+  const ambientBits = [ambientOn ? 'Claude hook' : null, gb, sc.length ? '/intent in ' + sc.join(', ') : null].filter(Boolean);
+  console.log(row('Ambient', (ambientOn || gb) ? `${ok} ${sage('on')} ${slate('(' + (ambientBits.join(' · ') || 'context sync') + ')')}` : `${off} ${slate('off — ')}${cream('phewsh ambient on')}`));
+
+  let shimInstalled = [];
+  try { shimInstalled = require('../lib/shims').shimStatus().installed; } catch { /* none */ }
+  console.log(row('Shim', shimInstalled.length
+    ? `${ok} ${sage('on')} ${slate('(' + shimInstalled.length + ' tools — banner each launch)')}`
+    : `${off} ${slate('off — ')}${cream('phewsh shim on')} ${slate('for a visible launch banner')}`));
+
+  console.log('');
+  console.log(`  ${slate('The question this answers:')} ${cream('will the next AI know what the last one learned?')}`);
+  console.log('');
+}
+
+module.exports = main;

package/lib/harnesses.js

@@ -218,9 +218,32 @@ function runViaHarness(id, systemPrompt, userPrompt, opts = {}) {
   });
 }
 
+// Resolve a user-typed token to a harness id. Accepts the canonical id, the
+// tool's actual binary (so `phewsh claude` → claude-code, since `claude` is the
+// Claude Code binary; `phewsh cursor-agent` → cursor), or a friendly alias.
+// Returns the harness id, or null if nothing matches.
+const HARNESS_ALIASES = {
+  claude: 'claude-code',
+  cc: 'claude-code',
+  'cursor-agent': 'cursor',
+  'kiro-cli': 'kiro',
+  copilot: 'copilot',
+};
+function resolveHarness(token) {
+  if (!token) return null;
+  const t = String(token).toLowerCase();
+  if (HARNESSES[t]) return t;
+  if (HARNESS_ALIASES[t]) return HARNESS_ALIASES[t];
+  for (const [id, h] of Object.entries(HARNESSES)) {
+    if (h.bin && h.bin.toLowerCase() === t) return id;
+  }
+  return null;
+}
+
 module.exports = {
   HARNESSES,
   INSTALL,
+  resolveHarness,
   isInstalled,
   detectInstalled,
   interactiveLaunchArgs,

package/lib/shims.js

@@ -118,23 +118,17 @@ function preflightBanner(bin, cwd = process.cwd()) {
       }
       return `${C.sage('😮‍💨🤫 phewsh active')} ${C.slate('· → ' + bin)}`;
     }
-    // Truth present — show the value + continuity health.
+    // Truth present — compact health line (like `git status` in a prompt, not a
+    // dump). Details live in `phewsh status`. One launch = one glance.
     const files = fs.readdirSync(intentDir).filter(f => /\.(md|json)$/.test(f)).length;
-    const vision = firstLine(path.join(intentDir, 'vision.md'));
-    const next = firstLine(path.join(intentDir, 'next.md')) || firstLine(path.join(intentDir, 'status.md'));
-    const decisions = decisionCount(cwd);
-    let health = '✓ intent';
+    let record = 'current';
     try {
       const { statusDrift } = require('./truth');
       const d = statusDrift(cwd);
-      if (d && d.tracked) health += d.commitsSince > 0 ? `  ${C.peach('⚠ record ' + d.commitsSince + ' behind')}` : '  ✓ record current';
+      if (d && d.tracked && d.commitsSince > 0) record = `${d.commitsSince} behind`;
     } catch { /* nicety */ }
-
-    const lines = [`${C.sage('😮‍💨🤫 phewsh active')}  ${C.slate(health)}  ${C.slate('· → ' + bin)}`];
-    if (vision) lines.push(`   ${C.slate('vision:')} ${C.cream(vision)}`);
-    if (next) lines.push(`   ${C.slate('next:  ')} ${C.cream(next)}${decisions ? C.slate('  · ' + decisions + ' decisions') : ''}`);
-    else if (decisions) lines.push(`   ${C.slate(decisions + ' decisions · ' + files + ' intent files')}`);
-    return lines.join('\n');
+    const continuity = decisionCount(cwd) >= 1 ? 'healthy' : 'building';
+    return `${C.sage('😮‍💨 phewsh')} ${C.teal('✓')}  ${C.slate('intent: ' + files + ' files · record: ' + record + ' · continuity: ' + continuity)}  ${C.slate('· phewsh status → ' + bin)}`;
   } catch {
     return `😮‍💨🤫 phewsh active · → ${bin}`; // never break the launch
   }

package/package.json

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