phewsh 0.15.19 → 0.15.22

package/bin/phewsh.js

@@ -53,6 +53,7 @@ const COMMANDS = {
   push:    () => require('../commands/push'),
   pull:    () => require('../commands/pull'),
   link:    () => require('../commands/link'),
+  sync:    () => require('../commands/sync').main('status'),
   login:   () => require('../commands/login'),
   ai:      () => require('../commands/ai'),
   style:   () => require('../commands/style'),
@@ -73,6 +74,8 @@ const COMMANDS = {
   seq:     () => require('../commands/sequence')(),
   ambient: () => require('../commands/ambient')(),
   hook:    () => require('../commands/hook')(),
+  welcome: () => require('../commands/welcome')(),
+  intro:   () => require('../commands/welcome')(),
   help:    showHelp,
   version: showVersion,
 };
@@ -157,10 +160,23 @@ function exitAfterUpdate(code = 0) {
   setTimeout(() => process.exit(code), 2000);
 }
 
+async function maybeFirstRunIntro() {
+  // First ever run → play the intro once, then never again. Marker, not config,
+  // so it's independent of login state. Never blocks the session on failure.
+  try {
+    const fs = require('fs'), path = require('path'), os = require('os');
+    const marker = path.join(os.homedir(), '.phewsh', '.welcomed');
+    if (fs.existsSync(marker)) return;
+    if (process.stdout.isTTY) await require('../lib/intro').playIntro();
+    fs.mkdirSync(path.dirname(marker), { recursive: true });
+    fs.writeFileSync(marker, new Date().toISOString());
+  } catch { /* the intro is a nicety — never let it block the session */ }
+}
+
 if (!command) {
-  // Bare `phewsh` — always drop into persistent session
+  // Bare `phewsh` — first run gets the intro, then drop into the session.
   // Session handles missing API key gracefully with /login and /key commands
-  COMMANDS.session();
+  maybeFirstRunIntro().then(() => COMMANDS.session());
 } else if (command === 'help' || command === '--help' || command === '-h') {
   showHelp();
   exitAfterUpdate(0);

package/commands/style.js

@@ -174,6 +174,15 @@ async function main() {
   const args = process.argv.slice(3);
   const config = loadConfig();
 
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log('\n  phewsh style — your creative identity (StyleTree)');
+    console.log('\n  Usage:');
+    console.log('    phewsh style                  show your style profile');
+    console.log('    phewsh style --ingest <file>  add an artifact to learn from');
+    console.log('    phewsh style --status         same as bare (profile + sync tip)\n');
+    return;
+  }
+
   // --status
   if (args.includes('--status') || args.length === 0) {
     const entries = loadLocal();

package/commands/sync.js

@@ -261,11 +261,63 @@ function isAuthError(err) {
   return m.includes('jwt') || m.includes('expired') || m.includes('401') || m.includes('unauthorized');
 }
 
+function agoMs(ms) {
+  const mins = Math.floor(ms / 60000);
+  if (mins < 1) return 'just now';
+  if (mins < 60) return `${mins}m ago`;
+  const hrs = Math.floor(mins / 60);
+  if (hrs < 24) return `${hrs}h ago`;
+  return `${Math.floor(hrs / 24)}d ago`;
+}
+
+// Compare local .intent/ against the cloud copy. Read-only — tells you which
+// way to sync, without doing it.
+async function status(config, token) {
+  if (!fs.existsSync(INTENT_DIR)) {
+    console.log('\n  No .intent/ here. Run `phewsh clarify` or `phewsh intent --init` first.\n');
+    return;
+  }
+  const pps = readPPS(INTENT_DIR);
+  const cloudId = pps?.adapters?.phewsh?.cloud_id;
+  const projectName = getProjectName();
+  const query = cloudId
+    ? `id=eq.${cloudId}&user_id=eq.${config.supabaseUserId}&select=id,updated_at`
+    : `name=eq.${encodeURIComponent(projectName)}&user_id=eq.${config.supabaseUserId}&select=id,updated_at`;
+
+  const projects = await select('projects', query, token);
+  if (projects.length === 0) {
+    console.log(`\n  ↕ "${projectName}" isn't in the cloud yet — run \`phewsh push\` to sync.\n`);
+    return;
+  }
+  const project = projects[0];
+  const artifacts = await select(
+    'artifacts',
+    `project_id=eq.${project.id}&user_id=eq.${config.supabaseUserId}&select=updated_at&order=updated_at.desc&limit=1`,
+    token
+  );
+  const cloudTime = artifacts.length > 0
+    ? new Date(artifacts[0].updated_at).getTime()
+    : new Date(project.updated_at).getTime();
+
+  let latestLocal = 0;
+  for (const f of ['vision.md', 'plan.md', 'next.md']) {
+    const p = path.join(INTENT_DIR, f);
+    if (fs.existsSync(p)) latestLocal = Math.max(latestLocal, fs.statSync(p).mtimeMs);
+  }
+  if (latestLocal === 0) { console.log('\n  ↕ Not linked to cloud — run `phewsh push`.\n'); return; }
+
+  const drift = Math.abs(cloudTime - latestLocal);
+  if (drift < 60000) console.log('\n  ↕ In sync — local and cloud match.\n');
+  else if (cloudTime > latestLocal) console.log(`\n  ↓ Cloud is newer (${agoMs(Date.now() - cloudTime)}) — run \`phewsh pull\`.\n`);
+  else console.log(`\n  ↑ Local changes not pushed (${agoMs(Date.now() - latestLocal)}) — run \`phewsh push\`.\n`);
+}
+
 async function main(direction = 'push') {
   const argv = process.argv.slice(3);
   if (argv.includes('--help') || argv.includes('-h')) {
-    console.log(`\n  phewsh ${direction === 'pull' ? 'pull' : direction === 'link' ? 'link <cloud-id>' : 'push'} — sync .intent/ with phewsh.com/intent`);
-    console.log(`    push   .intent/ → cloud      pull   cloud → .intent/      link   adopt a cloud project\n`);
+    console.log(`\n  phewsh ${direction} — sync .intent/ with phewsh.com/intent`);
+    console.log(`    sync   show which way to sync      push   .intent/ → cloud`);
+    console.log(`    pull   cloud → .intent/            link   adopt a cloud project\n`);
     return;
   }
 
@@ -284,7 +336,9 @@ async function main(direction = 'push') {
   // The token can still be rejected server-side (refresh token also expired).
   // Convert that into the same friendly nudge instead of a raw stack trace.
   try {
-    if (direction === 'pull') {
+    if (direction === 'status') {
+      await status(config, token);
+    } else if (direction === 'pull') {
       await pull(config, token);
     } else if (direction === 'link') {
       const cloudId = argv[0] && !argv[0].startsWith('-') ? argv[0] : process.argv[4];
@@ -306,4 +360,4 @@ async function main(direction = 'push') {
   }
 }
 
-module.exports = { main, push, pull, link, ensureValidToken, loadConfig };
+module.exports = { main, push, pull, link, status, ensureValidToken, loadConfig };

package/commands/welcome.js

@@ -0,0 +1,4 @@
+// phewsh welcome — the first-impression intro. Replayable any time.
+const { playIntro } = require('../lib/intro');
+
+module.exports = () => playIntro();

package/lib/intro.js

@@ -0,0 +1,83 @@
+// The first impression. A staggered, terminal-safe reveal: the mark, the
+// promise, then the magic moment — phewsh scans the machine and your installed
+// AI tools light up one by one. That last beat IS the value prop: "it already
+// works with everything you have."
+//
+// Safe by construction: line-by-line printing only, no cursor-up rewrites
+// (Apple Terminal hazard). Non-TTY / piped → everything prints instantly.
+// Timing + harness list + output are injectable so the sequence is testable.
+
+const ui = require('./ui');
+
+// The exhale mark (😮‍💨) — rasterized from assets/phew.svg to a 30×14 grid
+// once, baked here so there's no runtime cost. It draws in row by row.
+const FACE = [
+  '          ███ ██ ███',
+  '      █                █',
+  '    █                    █',
+  '  █        █      █        █',
+  ' █      ██          ██      █',
+  '█           █    █           █',
+  '█     █████        █████     █',
+  '█                            █',
+  '█                            █',
+  ' █  ██  ██   █  █           █',
+  '  ██        █    █         █',
+  '  █        █  ██         █',
+  '   ███  ███            █',
+  '          ███    ███',
+];
+
+const LOGO = ['█▀█ █░█ █▀▀ █░█ █▀ █░█', '█▀▀ █▀█ ██▄ ▀▄▀ ▄█ █▀█'];
+
+function sleep(ms) { return new Promise((r) => setTimeout(r, ms)); }
+
+async function playIntro(opts = {}) {
+  const {
+    animated = !!process.stdout.isTTY,
+    delay = sleep,
+    out = console.log,
+    listHarnesses = require('./harnesses').listHarnesses,
+  } = opts;
+
+  const { b, cream, sage, slate, teal, green } = ui;
+  const pause = async (ms) => { if (animated) await delay(ms); };
+
+  out('');
+  for (const line of FACE) { out(`  ${cream(line)}`); await pause(55); }
+  await pause(160);
+  out('');
+  for (const line of LOGO) { out(`  ${b(cream(line))}`); await pause(90); }
+  await pause(140);
+  out(`  ${sage('Keep all your AI tools.')} ${cream('phewsh is the one memory they share.')}`);
+  out('');
+  await pause(260);
+
+  // The magic beat: discover the tools already on this machine.
+  out(`  ${slate('scanning your machine for AI tools…')}`);
+  await pause(320);
+
+  let harnesses = [];
+  try { harnesses = listHarnesses().filter((h) => h.installed); } catch { /* none */ }
+
+  if (harnesses.length === 0) {
+    out(`  ${slate('· none found yet — install Claude Code, Codex, or Gemini and phewsh picks it up.')}`);
+  } else {
+    for (const h of harnesses) {
+      out(`    ${green('✓')} ${cream(h.label.padEnd(14))} ${sage(h.role || '')}`);
+      await pause(130);
+    }
+    await pause(160);
+    out('');
+    const n = harnesses.length;
+    out(`  ${teal('●')} ${sage(`Found ${n} tool${n !== 1 ? 's' : ''} — they'll all share one memory now.`)}`);
+  }
+  out('');
+  await pause(160);
+  out(`  ${sage('Next:')} ${cream('just type to start')} ${slate('·')} ${cream('phewsh setup')} ${slate('to pick a default route')}`);
+  out('');
+
+  return { toolsFound: harnesses.length };
+}
+
+module.exports = { playIntro, LOGO, FACE };

package/package.json

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