phewsh 0.11.11 → 0.11.13

package/commands/watch.js

@@ -2,7 +2,7 @@
 //
 // Watches .intent/ for changes and auto-pushes to Supabase + regenerates CLAUDE.md.
 // This is the backbone of cross-tool continuity:
-//   edit in terminal → web dashboard updates → Claude Code knows.
+//   edit in terminal → phewsh.com/intent updates → Claude Code knows.
 //
 // Usage:
 //   phewsh watch              Start watching (push + CLAUDE.md)
@@ -85,8 +85,8 @@ function generateClaudeSection() {
   const decisionGate = gate || projectJson?.decisionGate;
 
   sections.push(`# PHEWSH Adaptive Context — ${projectName}`);
+  sections.push(`> **Generated file. Do not edit.** Modify .intent/ instead — this section regenerates automatically.`);
   sections.push(`> Auto-synced by \`phewsh watch\` | ${new Date().toISOString().split('T')[0]}`);
-  sections.push(`> This section is regenerated on every .intent/ change. Do not edit manually.`);
   sections.push('');
 
   // Project identity
@@ -318,25 +318,25 @@ function watchIntent() {
 
 function showHelp() {
   console.log(`
-  phewsh watch — Live .intent/ sync daemon
+  phewsh watch — Keep AI tools in sync with .intent/
 
   Usage:
     phewsh watch              Start watching
     phewsh watch --no-claude  Skip CLAUDE.md regeneration
-    phewsh watch --no-push    Skip cloud push (local CLAUDE.md only)
+    phewsh watch --no-push    Skip cloud push (local only)
     phewsh watch --verbose    Show detailed sync info
 
   What it does:
     Watches .intent/ for changes and automatically:
-    1. Pushes updated artifacts to Supabase (web dashboard updates live)
-    2. Regenerates the PHEWSH section in CLAUDE.md (Claude Code stays current)
+    1. Regenerates CLAUDE.md so Claude Code stays current with .intent/
+    2. Pushes to phewsh.com/intent (optional — needs account)
 
-    This creates the cross-tool continuity loop:
-      edit gate in terminal -> web dashboard reorganizes -> Claude already knows
+    The loop:
+      edit .intent/ → CLAUDE.md updates → cloud mirror updates → every tool knows
 
   Requirements:
     - .intent/ directory must exist (run \`phewsh intent --init\`)
-    - \`phewsh login\` for cloud push (optional — CLAUDE.md works without it)
+    - Everything works without an account. Account adds cloud sync.
   `);
 }
 
@@ -352,8 +352,8 @@ async function main() {
   const loggedIn = !!config?.supabaseUserId;
 
   console.log('');
-  console.log(`  ${b(w('PHEWSH Watch'))} ${g('v' + require('../package.json').version)}`);
-  console.log(`  ${g('Live .intent/ sync — cross-tool continuity')}`);
+  console.log(`  ${b(w('.intent/ Watch'))} ${g('v' + require('../package.json').version)}`);
+  console.log(`  ${g('Keeps your AI tools in sync with .intent/')}`);
   console.log('');
 
   // Show what's enabled
@@ -361,7 +361,7 @@ async function main() {
   if (!flags.noClaude) features.push(`${green('●')} CLAUDE.md auto-sync`);
   else features.push(`${g('○')} CLAUDE.md ${g('(disabled)')}`);
 
-  if (!flags.noPush && loggedIn) features.push(`${green('●')} Cloud push (web dashboard)`);
+  if (!flags.noPush && loggedIn) features.push(`${green('●')} Cloud push → phewsh.com/intent`);
   else if (!flags.noPush && !loggedIn) features.push(`${yellow('●')} Cloud push ${g('(not logged in — run phewsh login)')}`);
   else features.push(`${g('○')} Cloud push ${g('(disabled)')}`);
 

package/lib/ui.js

@@ -1,6 +1,22 @@
-// phewsh ui — zero-dependency terminal animations and visual helpers
-// Pure ANSI escape sequences. No chalk, no ora, no bloat.
+// phewsh ui — the exhale
+// Relief. Quiet execution. Cool sweet future.
+// Zero dependencies. Pure ANSI. The terminal breathes.
 
+// ── PHEWSH palette ───────────────────────────────────────
+// 24-bit color for terminals that support it (most modern ones do).
+// Fallback-safe: if 24-bit fails, the text still renders.
+const rgb = (r, g, b) => (s) => `\x1b[38;2;${r};${g};${b}m${s}\x1b[0m`;
+const rgbBg = (r, g, b) => (s) => `\x1b[48;2;${r};${g};${b}m${s}\x1b[0m`;
+
+// Brand colors — relief, quiet, future
+const teal    = rgb(100, 215, 195);   // cool calm — primary
+const peach   = rgb(255, 195, 145);   // warm exhale — accent
+const sage    = rgb(130, 150, 140);   // quiet — secondary text
+const slate   = rgb(80, 90, 88);      // whisper — dim text
+const cream   = rgb(240, 235, 225);   // clarity — bright text
+const ember   = rgb(220, 140, 90);    // glow — warnings/energy
+
+// Standard ANSI fallbacks (used where 24-bit might not render)
 const b  = (s) => `\x1b[1m${s}\x1b[0m`;
 const d  = (s) => `\x1b[2m${s}\x1b[0m`;
 const w  = (s) => `\x1b[97m${s}\x1b[0m`;
@@ -18,30 +34,43 @@ const show = '\x1b[?25h';
 const up = (n = 1) => `\x1b[${n}A`;
 const clearLine = '\x1b[2K\r';
 
-// ── Spinner ──────────────────────────────────────────────
-// Returns { stop } — call stop() when work is done.
-const SPINNER_FRAMES = ['    ·', '   · ·', '  · · ·', ' · · · ·', '· · · · ·', ' · · · ·', '  · · ·', '   · ·'];
-const BRAILLE_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-const BREATH_FRAMES = ['░', '▒', '▓', '█', '▓', '▒', '░', ' '];
-const PULSE_FRAMES = ['·', '•', '●', '•'];
-
-function spinner(text = 'thinking', style = 'braille') {
-  const frames = style === 'dots' ? SPINNER_FRAMES
-    : style === 'breath' ? BREATH_FRAMES
-    : style === 'pulse' ? PULSE_FRAMES
-    : BRAILLE_FRAMES;
+// ── Sleep helper ─────────────────────────────────────────
+const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+
+// ── Spinner: the exhale pulse ────────────────────────────
+// Breathes in and out. Calm. Not frantic.
+const EXHALE_FRAMES = [
+  '    ·    ',
+  '   · ·   ',
+  '  ·   ·  ',
+  ' ·     · ',
+  '·       ·',
+  ' ·     · ',
+  '  ·   ·  ',
+  '   · ·   ',
+];
+
+const BREATH_DOTS = ['  ·', ' · ·', '· · ·', ' · ·', '  ·', '    '];
+
+const GENTLE_FRAMES = ['·', '•', '●', '•', '·', ' '];
+
+function spinner(text = 'thinking', style = 'exhale') {
+  const frames = style === 'gentle' ? GENTLE_FRAMES
+    : style === 'dots' ? BREATH_DOTS
+    : EXHALE_FRAMES;
   let i = 0;
   let stopped = false;
+  let currentText = text;
   process.stdout.write(hide);
   const interval = setInterval(() => {
     if (stopped) return;
     const frame = frames[i % frames.length];
-    process.stdout.write(`${clearLine}  ${cyan(frame)} ${g(text)}`);
+    process.stdout.write(`${clearLine}  ${teal(frame)} ${sage(currentText)}`);
     i++;
-  }, style === 'breath' ? 120 : 80);
+  }, style === 'gentle' ? 150 : 100);
 
   return {
-    update(newText) { text = newText; },
+    update(newText) { currentText = newText; },
     stop(finalText) {
       stopped = true;
       clearInterval(interval);
@@ -51,86 +80,136 @@ function spinner(text = 'thinking', style = 'braille') {
   };
 }
 
-// ── Animated brand reveal ────────────────────────────────
-// Draws the PHEWSH logo line by line with a cascading effect.
-function brandReveal(fast = false) {
-  return new Promise((resolve) => {
-    const lines = [
-      '',
-      `  ${d('😮\u200d💨')} ${d('🤫')}`,
-      '',
-      `  ${b(w('█▀█ █░█ █▀▀ █░█ █▀ █░█'))}`,
-      `  ${b(w('█▀▀ █▀█ ██▄ ▀▄▀ ▄█ █▀█'))}`,
-      '',
-    ];
+// ── The Exhale: signature brand animation ────────────────
+// This is the first thing you see. It should feel like a breath.
+// Inhale (pause) → exhale (particles expand) → settle (logo forms) → calm.
+async function brandReveal(fast = false) {
+  if (fast) {
+    console.log('');
+    console.log(`  ${d('😮\u200d💨')} ${d('🤫')}`);
+    console.log('');
+    console.log(`  ${b(cream('█▀█ █░█ █▀▀ █░█ █▀ █░█'))}`);
+    console.log(`  ${b(cream('█▀▀ █▀█ ██▄ ▀▄▀ ▄█ █▀█'))}`);
+    console.log('');
+    return;
+  }
+
+  process.stdout.write(hide);
+
+  // Phase 1: The inhale — brief stillness
+  console.log('');
+  await sleep(200);
+
+  // Phase 2: The exhale — particles drift outward
+  const exhaleStages = [
+    '                  ·',
+    '               ·  ·  ·',
+    '           ·    ·    ·    ·',
+    '        ·     ·     ·     ·     ·',
+    '     ·      ·      ·      ·      ·',
+  ];
+
+  for (const stage of exhaleStages) {
+    process.stdout.write(`${clearLine}  ${slate(stage)}`);
+    await sleep(70);
+  }
+
+  // Phase 3: Particles converge into the emoji
+  await sleep(100);
+  process.stdout.write(`${clearLine}`);
+  console.log(`  ${d('😮\u200d💨')} ${d('🤫')}`);
+  console.log('');
+  await sleep(150);
 
-    if (fast) {
-      lines.forEach(l => console.log(l));
-      resolve();
-      return;
+  // Phase 4: Logo wave — each letter block appears left to right
+  const logoTop = ['█▀█', '█░█', '█▀▀', '█░█', '█▀', '█░█'];
+  const logoBot = ['█▀▀', '█▀█', '██▄', '▀▄▀', '▄█', '█▀█'];
+
+  let topLine = '  ';
+  let botLine = '  ';
+
+  for (let i = 0; i < logoTop.length; i++) {
+    topLine += cream(logoTop[i]) + ' ';
+    botLine += cream(logoBot[i]) + ' ';
+
+    // Overwrite both lines
+    if (i === 0) {
+      process.stdout.write(`  ${b(topLine.trim())}`);
+      process.stdout.write('\n');
+      process.stdout.write(`  ${b(botLine.trim())}`);
+    } else {
+      process.stdout.write(up(1));
+      process.stdout.write(`${clearLine}  ${b(topLine.trim())}`);
+      process.stdout.write('\n');
+      process.stdout.write(`${clearLine}  ${b(botLine.trim())}`);
     }
+    await sleep(55);
+  }
 
-    let idx = 0;
-    const interval = setInterval(() => {
-      if (idx >= lines.length) {
-        clearInterval(interval);
-        resolve();
-        return;
-      }
-      console.log(lines[idx]);
-      idx++;
-    }, 60);
-  });
+  process.stdout.write('\n');
+  await sleep(100);
+
+  // Phase 5: Tagline fades in — dim → sage → cream
+  const tagline = '.intent/ is your project\'s working memory.';
+  process.stdout.write(`  ${slate(tagline)}`);
+  await sleep(200);
+  process.stdout.write(`${clearLine}  ${sage(tagline)}`);
+  await sleep(200);
+  process.stdout.write(`${clearLine}  ${teal(tagline)}`);
+  await sleep(300);
+
+  console.log('');
+  console.log('');
+  process.stdout.write(show);
 }
 
 // ── Status panel ─────────────────────────────────────────
-// Draws a bordered status box with labeled rows.
 function statusPanel(title, rows) {
   const maxLabel = Math.max(...rows.map(r => r[0].length));
   console.log('');
-  console.log(`  ${b(w(title))}`);
-  console.log(`  ${g('─'.repeat(48))}`);
+  console.log(`  ${b(cream(title))}`);
+  console.log(`  ${slate('─'.repeat(48))}`);
   for (const [label, value, color] of rows) {
     const colorFn = color === 'green' ? green
-      : color === 'yellow' ? yellow
-      : color === 'cyan' ? cyan
+      : color === 'yellow' ? ember
+      : color === 'cyan' ? teal
       : color === 'red' ? red
+      : color === 'peach' ? peach
       : (s) => s;
-    console.log(`  ${g(label.padEnd(maxLabel + 2))} ${colorFn(value)}`);
+    console.log(`  ${sage(label.padEnd(maxLabel + 2))} ${colorFn(value)}`);
   }
-  console.log(`  ${g('─'.repeat(48))}`);
+  console.log(`  ${slate('─'.repeat(48))}`);
   console.log('');
 }
 
 // ── Interop badge line ───────────────────────────────────
-// Shows where phewsh is connected / can connect.
 function interopLine(config, intentFiles) {
   const parts = [];
-  if (intentFiles.length > 0) parts.push(green('●') + ' .intent/');
-  if (config?.apiKey) parts.push(green('●') + ' AI');
-  if (config?.supabaseUserId) parts.push(green('●') + ' cloud');
+  if (intentFiles.length > 0) parts.push(teal('●') + sage(' .intent/'));
+  if (config?.apiKey) parts.push(teal('●') + sage(' AI'));
+  if (config?.supabaseUserId) parts.push(teal('●') + sage(' cloud'));
 
-  // Always show what's available
-  const available = [];
-  available.push(g('Claude Code'));
-  available.push(g('Cursor'));
-  available.push(g('ChatGPT'));
-  available.push(g('MCP'));
+  const available = [
+    sage('Claude Code'),
+    sage('Cursor'),
+    sage('ChatGPT'),
+    sage('MCP'),
+  ];
 
   if (parts.length > 0) {
-    console.log(`  ${g('connected')}  ${parts.join(g('  ·  '))}`);
+    console.log(`  ${slate('active')}    ${parts.join(slate('  ·  '))}`);
   }
-  console.log(`  ${g('works with')}  ${available.join(g(' · '))}`);
+  console.log(`  ${slate('works in')}  ${available.join(slate(' · '))}`);
 }
 
 // ── Divider ──────────────────────────────────────────────
-function divider(char = '·', width = 48) {
-  console.log(`  ${g(char.repeat(width))}`);
+function divider(style = 'line', width = 48) {
+  const char = style === 'dots' ? '·' : style === 'fade' ? '░' : '─';
+  console.log(`  ${slate(char.repeat(width))}`);
 }
 
 // ── Typewriter ───────────────────────────────────────────
-// Writes text character by character. Returns a promise.
-function typewrite(text, speed = 20) {
+function typewrite(text, speed = 25) {
   return new Promise((resolve) => {
     let i = 0;
     const interval = setInterval(() => {
@@ -146,16 +225,16 @@ function typewrite(text, speed = 20) {
   });
 }
 
-// ── Welcome tips (rotates each session) ──────────────────
+// ── Welcome tips ─────────────────────────────────────────
 const TIPS = [
-  `${g('tip:')} Type ${w('/clarify')} to turn a messy idea into a structured spec`,
-  `${g('tip:')} ${w('/gate')} lets you set budget, time, and skill constraints`,
-  `${g('tip:')} Run ${w('phewsh watch')} in another tab for live sync to CLAUDE.md`,
-  `${g('tip:')} ${w('/export')} creates a portable context file for any AI tool`,
-  `${g('tip:')} ${w('/model opus')} switches to Claude Opus for complex reasoning`,
-  `${g('tip:')} Your ${w('.intent/')} files are plain markdown — edit them anytime`,
-  `${g('tip:')} ${w('phewsh context --copy')} puts your project context on the clipboard`,
-  `${g('tip:')} ${w('/tour')} walks you through everything PHEWSH can do`,
+  `${slate('·')} ${cream('/clarify')} ${sage('turns a messy idea into .intent/ artifacts')}`,
+  `${slate('·')} ${cream('/gate')} ${sage('sets constraints — every AI response respects your budget and time')}`,
+  `${slate('·')} ${sage('Run')} ${cream('phewsh watch')} ${sage('in another tab — keeps CLAUDE.md in sync with .intent/')}`,
+  `${slate('·')} ${cream('/export')} ${sage('exports .intent/ as portable context for any AI tool')}`,
+  `${slate('·')} ${sage('.intent/ files are plain markdown — edit them directly anytime')}`,
+  `${slate('·')} ${cream('phewsh context --copy')} ${sage('puts your .intent/ context on the clipboard')}`,
+  `${slate('·')} ${cream('/tour')} ${sage('walks through the .intent/ workflow (no key needed)')}`,
+  `${slate('·')} ${sage('Everything works without an account. Account adds sync + sharing.')}`,
 ];
 
 function randomTip() {
@@ -165,88 +244,98 @@ function randomTip() {
 // ── Tour content ─────────────────────────────────────────
 const TOUR_PAGES = [
   {
-    title: 'What is PHEWSH?',
+    title: 'What is .intent/?',
     body: [
-      `  PHEWSH gives your project a ${b('portable identity')}.`,
-      `  Define what you're building once — every AI tool reads it.`,
       '',
-      `  It works ${w('standalone')} as its own AI shell,`,
-      `  and ${w('inside')} Claude Code, Cursor, ChatGPT, and any MCP agent.`,
+      `  ${teal('.intent/')} ${sage('is your project\'s working memory.')}`,
+      `  Plain markdown files, committed with your code, read by every AI tool.`,
+      '',
+      `  ${cream('phew')} ${sage('— the relief of not re-explaining.')}`,
+      `  ${cream('shh')}  ${sage('— it just works. No noise.')}`,
+      '',
+      `  PHEWSH is the tool that ${cream('authors')} and ${cream('syncs')} .intent/.`,
+      `  It works standalone, inside Claude Code, Cursor, ChatGPT, or any MCP agent.`,
       '',
-      `  ${g('Your project context lives in')} ${cyan('.intent/')} ${g('— plain markdown files.')}`,
-      `  ${g('You own them. They travel with your code.')}`,
+      `  ${sage('You own these files. They travel with your code.')}`,
+      `  ${sage('Everything works without an account. Account adds sync + sharing.')}`,
     ]
   },
   {
     title: 'The .intent/ directory',
     body: [
-      `  ${cyan('.intent/')}`,
-      `    ${green('vision.md')}    ${g('What this project is and why it exists')}`,
-      `    ${green('plan.md')}      ${g('Strategy, phases, milestones')}`,
-      `    ${green('next.md')}      ${g('Current tasks and what to do right now')}`,
-      `    ${yellow('gate.json')}    ${g('Your constraints (budget, time, skill)')}`,
       '',
-      `  ${g('Create these with')} /init ${g('or')} /clarify`,
+      `  ${teal('.intent/')}`,
+      `    ${peach('vision.md')}    ${sage('What this project is and why it exists')}`,
+      `    ${peach('plan.md')}      ${sage('Strategy, phases, milestones')}`,
+      `    ${peach('next.md')}      ${sage('Current tasks and what to do right now')}`,
+      `    ${ember('gate.json')}    ${sage('Your constraints (budget, time, skill)')}`,
+      '',
+      `  ${sage('Create these with')} ${cream('/init')} ${sage('or')} ${cream('/clarify')}`,
     ]
   },
   {
     title: 'Standalone mode',
     body: [
-      `  When you run ${w('phewsh')} on its own, you get an AI shell`,
-      `  that knows your project inside and out.`,
       '',
-      `  Just type naturally:`,
-      `    ${cyan('>')} what should I focus on today?`,
-      `    ${cyan('>')} is my plan realistic given my budget?`,
-      `    ${cyan('>')} break this feature into tasks`,
+      `  Run ${cream('phewsh')} and type naturally.`,
+      `  Every message carries your .intent/ context automatically.`,
+      '',
+      `    ${teal('phewsh')} ${sage('>')} what should I focus on today?`,
+      `    ${teal('phewsh')} ${sage('>')} is my plan realistic given my budget?`,
+      `    ${teal('phewsh')} ${sage('>')} break this feature into tasks`,
       '',
-      `  ${g('Every message includes your vision, plan, and constraints.')}`,
+      `  ${sage('The AI reads .intent/ — no warmup needed.')}`,
     ]
   },
   {
-    title: 'Inside other tools',
+    title: '.intent/ in other tools',
     body: [
-      `  ${b('Claude Code')}   ${g('phewsh watch → auto-updates CLAUDE.md')}`,
-      `  ${b('Cursor')}        ${g('phewsh context --file → .phewsh.context')}`,
-      `  ${b('ChatGPT')}       ${g('phewsh context --copy → paste into Custom Instructions')}`,
-      `  ${b('MCP agents')}    ${g('phewsh mcp setup → agents pull tasks automatically')}`,
       '',
-      `  ${g('Same project identity, every tool. No re-explaining.')}`,
+      `  ${b(cream('Claude Code'))}   ${sage('phewsh watch → CLAUDE.md stays in sync with .intent/')}`,
+      `  ${b(cream('Cursor'))}        ${sage('phewsh context --file → exports .intent/ to .phewsh.context')}`,
+      `  ${b(cream('ChatGPT'))}       ${sage('phewsh context --copy → .intent/ on your clipboard')}`,
+      `  ${b(cream('MCP agents'))}    ${sage('phewsh mcp setup → agents read .intent/ automatically')}`,
+      '',
+      `  ${sage('Same .intent/. Every tool. Switch mid-thought. Nothing lost.')}`,
     ]
   },
   {
     title: 'The Decision Gate',
     body: [
-      `  Before you build, decide ${b('whether')} to build.`,
+      '',
+      `  Before you build, decide ${b(cream('whether'))} to build.`,
       `  The gate captures what you can actually spend:`,
       '',
-      `    ${g('Budget')}     ${w('$50')}            ${g('Skill')}      ${w('expert')}`,
-      `    ${g('Time')}       ${w('15 hrs/week')}     ${g('Urgency')}    ${w('high')}`,
+      `    ${sage('Budget')}     ${cream('$50')}            ${sage('Skill')}      ${cream('expert')}`,
+      `    ${sage('Time')}       ${cream('15 hrs/week')}     ${sage('Urgency')}    ${cream('high')}`,
       '',
-      `  ${g('These constraints shape every AI response.')}`,
-      `  ${g('Run')} /gate activate ${g('to set yours.')}`,
+      `  ${sage('These constraints shape every AI response.')}`,
+      `  ${sage('Run')} ${cream('/gate activate')} ${sage('to set yours.')}`,
     ]
   },
   {
     title: 'You\'re ready',
     body: [
-      `  ${green('●')} Type naturally to chat with your project context`,
-      `  ${green('●')} ${w('/init')} or ${w('/clarify')} to create .intent/ artifacts`,
-      `  ${green('●')} ${w('/gate')} to set your constraints`,
-      `  ${green('●')} ${w('/help')} for all commands`,
       '',
-      `  ${g('PHEWSH is your project\'s home base.')}`,
-      `  ${g('The AI that knows you doesn\'t need to be re-taught.')}`,
+      `  ${teal('●')} ${cream('/init')} or ${cream('/clarify')} to create .intent/ artifacts`,
+      `  ${teal('●')} Type naturally — .intent/ context is always loaded`,
+      `  ${teal('●')} ${cream('/gate')} to set your constraints`,
+      `  ${teal('●')} ${cream('phewsh watch')} to keep AI tools in sync`,
+      `  ${teal('●')} ${cream('/help')} for all commands`,
+      '',
+      `  ${sage('.intent/ is your project\'s working memory. PHEWSH keeps it useful.')}`,
     ]
   },
 ];
 
 module.exports = {
-  // Colors
+  // Brand palette
+  teal, peach, sage, slate, cream, ember,
+  // Standard ANSI
   b, d, w, g, green, cyan, yellow, magenta, blue, red,
   // Components
   spinner, brandReveal, statusPanel, interopLine, divider, typewrite,
   randomTip, TOUR_PAGES,
   // ANSI helpers
-  hide, show, up, clearLine,
+  hide, show, up, clearLine, sleep,
 };

package/package.json

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