phewsh 0.11.11 → 0.11.12

package/commands/session.js

@@ -17,7 +17,9 @@ const { select, refreshSession: refreshSess } = require('../lib/supabase');
 const { readPPS } = require('../lib/pps');
 const { push, pull, ensureValidToken } = require('./sync');
 
-const { b, d, w, g, green, cyan, yellow } = ui;
+// Brand palette shortcuts
+const { b, d, w, g, green, cyan, yellow,
+        teal, peach, sage, slate, cream, ember } = ui;
 
 // Sync awareness: compare local .intent/ timestamps with cloud updated_at
 async function checkSyncStatus(config) {
@@ -32,7 +34,6 @@ async function checkSyncStatus(config) {
     const cloudId = pps?.adapters?.phewsh?.cloud_id;
     const projectName = path.basename(process.cwd());
 
-    // Find cloud project
     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`;
@@ -42,7 +43,6 @@ async function checkSyncStatus(config) {
 
     const project = projects[0];
 
-    // Get latest cloud artifact updated_at
     const artifacts = await select(
       'artifacts',
       `project_id=eq.${project.id}&user_id=eq.${config.supabaseUserId}&select=kind,updated_at&order=updated_at.desc&limit=1`,
@@ -53,7 +53,6 @@ async function checkSyncStatus(config) {
       ? new Date(artifacts[0].updated_at).getTime()
       : new Date(project.updated_at).getTime();
 
-    // Get latest local file mtime
     const localFiles = ['vision.md', 'plan.md', 'next.md'];
     let latestLocal = 0;
     for (const file of localFiles) {
@@ -67,7 +66,6 @@ async function checkSyncStatus(config) {
     if (latestLocal === 0) return { status: 'local-only' };
 
     const drift = Math.abs(cloudTime - latestLocal);
-    // Within 60 seconds = synced
     if (drift < 60000) return { status: 'synced' };
 
     if (cloudTime > latestLocal) {
@@ -78,7 +76,7 @@ async function checkSyncStatus(config) {
       return { status: 'local-newer', ago };
     }
   } catch {
-    return null; // Network error — silently skip
+    return null;
   }
 }
 
@@ -140,7 +138,6 @@ async function streamChat(apiKey, messages, systemPrompt, modelId) {
   const body = { model: modelId, max_tokens: 2048, messages, stream: true };
   if (systemPrompt) body.system = systemPrompt;
 
-  // Start spinner while waiting for first token
   const spin = ui.spinner('thinking');
 
   const response = await fetch('https://api.anthropic.com/v1/messages', {
@@ -178,7 +175,7 @@ async function streamChat(apiKey, messages, systemPrompt, modelId) {
         const parsed = JSON.parse(data);
         if (parsed.type === 'content_block_delta' && parsed.delta?.text) {
           if (firstToken) {
-            spin.stop(); // Clear spinner before first output
+            spin.stop();
             firstToken = false;
           }
           process.stdout.write(parsed.delta.text);
@@ -194,7 +191,7 @@ async function streamChat(apiKey, messages, systemPrompt, modelId) {
     }
   }
 
-  if (firstToken) spin.stop(); // In case we got no tokens
+  if (firstToken) spin.stop();
   process.stdout.write('\n');
 
   return { content: fullResponse, promptTokens, completionTokens, model: modelId };
@@ -204,58 +201,58 @@ async function main() {
   let config = loadConfig();
   let intentFiles = loadIntentContext();
   let systemPrompt = buildSystemPrompt(intentFiles);
-  const messages = []; // conversation history
+  const messages = [];
   const projectName = path.basename(process.cwd());
   let currentModel = DEFAULT_MODEL;
   let totalPromptTokens = 0;
   let totalCompletionTokens = 0;
 
-  // ── Animated brand reveal ──────────────────────────────
+  // ── The Exhale: animated brand reveal ──────────────────
   await ui.brandReveal();
 
-  // ── First-run welcome or status panel ──────────────────
+  // ── First-run welcome ──────────────────────────────────
   if (!config?.apiKey) {
-    console.log(`  ${b(w('Welcome to PHEWSH.'))}`);
-    console.log(`  ${g('Your AI knows your project. No more re-explaining.')}`);
+    console.log(`  ${b(cream('Welcome.'))}`);
+    console.log(`  ${sage('Your AI already knows your project. No more re-explaining.')}`);
     console.log('');
-    console.log(`  ${w('To chat, you need an API key.')} ${g('(not a subscription)')}`);
-    console.log(`  ${g('ChatGPT Plus / Claude Pro are separate — API keys are pay-as-you-go.')}`);
+    console.log(`  ${cream('To chat, you need an API key.')} ${slate('(not a subscription)')}`);
+    console.log(`  ${slate('ChatGPT Plus / Claude Pro don\'t include API access.')}`);
+    console.log(`  ${slate('API keys are pay-as-you-go — both providers offer free credits.')}`);
     console.log('');
-    console.log(`  ${cyan('1')}  ${b('Anthropic')} ${g('(recommended)')}`);
-    console.log(`     ${g('console.anthropic.com/settings/keys')}`);
-    console.log(`     ${g('Direct access to Claude. Best quality. ~$0.01/message.')}`);
+    console.log(`  ${teal('1')}  ${b(cream('Anthropic'))} ${slate('(recommended)')}`);
+    console.log(`     ${sage('console.anthropic.com/settings/keys')}`);
+    console.log(`     ${slate('Direct Claude access. Best quality. ~$0.01/message.')}`);
     console.log('');
-    console.log(`  ${cyan('2')}  ${b('OpenRouter')}`);
-    console.log(`     ${g('openrouter.ai/keys')}`);
-    console.log(`     ${g('One key, many models (Claude, GPT, Gemini, etc.)')}`);
+    console.log(`  ${teal('2')}  ${b(cream('OpenRouter'))}`);
+    console.log(`     ${sage('openrouter.ai/keys')}`);
+    console.log(`     ${slate('One key → Claude, GPT, Gemini, and more.')}`);
     console.log('');
-    console.log(`  ${g('Got a key? Type')} /key ${g('to paste it in.')}`);
-    console.log(`  ${g('Want cloud sync too?')} /login ${g('connects your identity.')}`);
-    console.log(`  ${g('Curious?')} /tour ${g('to see what PHEWSH can do (no key needed).')}`);
+    console.log(`  ${sage('Got a key?')} ${cream('/key')} ${sage('to paste it in.')}`);
+    console.log(`  ${sage('Curious?')} ${cream('/tour')} ${sage('to explore (no key needed).')}`);
     console.log('');
   } else if (!config.apiKey.startsWith('sk-')) {
-    console.log(`  ${yellow('!')} Stored API key looks invalid.`);
-    console.log(`  ${g('Run')} /key ${g('to set a new one')}`);
+    console.log(`  ${ember('!')} ${sage('Stored API key looks invalid.')}`);
+    console.log(`  ${sage('Run')} ${cream('/key')} ${sage('to set a new one')}`);
     console.log('');
-    config.apiKey = null; // Don't try to use a bad key
+    config.apiKey = null;
   }
 
   // ── Project status ─────────────────────────────────────
   if (intentFiles.length > 0) {
-    console.log(`  ${green('●')} ${cyan(projectName)} ${g('·')} ${intentFiles.map(f => f.file).join(', ')}`);
+    console.log(`  ${teal('●')} ${cream(projectName)} ${slate('·')} ${sage(intentFiles.map(f => f.file).join(', '))}`);
   } else {
-    console.log(`  ${green('●')} ${cyan(projectName)} ${g('·')} no .intent/ context`);
-    console.log(`  ${g('  run /init to create .intent/ artifacts')}`);
+    console.log(`  ${teal('●')} ${cream(projectName)} ${slate('·')} ${sage('no .intent/ context')}`);
+    console.log(`  ${slate('  run /init to create .intent/ artifacts')}`);
   }
-  console.log(`  ${g('  model:')} ${MODELS[currentModel].name}`);
+  console.log(`  ${slate('  model:')} ${sage(MODELS[currentModel].name)}`);
   if (config?.email) {
-    console.log(`  ${g('  user:')} ${config.email}`);
+    console.log(`  ${slate('  user:')} ${sage(config.email)}`);
   }
 
-  // ── Interop line ───────────────────────────────────────
+  // ── Interop ────────────────────────────────────────────
   ui.interopLine(config, intentFiles);
 
-  // Sync status check (non-blocking, 3s timeout)
+  // Sync status (non-blocking)
   if (config?.supabaseUserId && intentFiles.length > 0) {
     const syncResult = await Promise.race([
       checkSyncStatus(config),
@@ -263,32 +260,32 @@ async function main() {
     ]);
     if (syncResult) {
       if (syncResult.status === 'cloud-newer') {
-        console.log(`  ${yellow('↓')} Cloud is newer (${syncResult.ago}) — run /pull`);
+        console.log(`  ${ember('↓')} ${sage('Cloud is newer (' + syncResult.ago + ') — run /pull')}`);
       } else if (syncResult.status === 'local-newer') {
-        console.log(`  ${yellow('↑')} Local changes not pushed (${syncResult.ago}) — run /push`);
+        console.log(`  ${ember('↑')} ${sage('Local changes not pushed (' + syncResult.ago + ') — run /push')}`);
       } else if (syncResult.status === 'synced') {
-        console.log(`  ${green('↕')} ${g('synced')}`);
+        console.log(`  ${teal('↕')} ${slate('synced')}`);
       } else if (syncResult.status === 'local-only') {
-        console.log(`  ${g('↕ not linked to cloud — run /push to sync')}`);
+        console.log(`  ${slate('↕ not linked to cloud — run /push to sync')}`);
       }
     }
   }
 
   console.log('');
-  ui.divider('─');
+  ui.divider('line');
   if (!config?.apiKey) {
-    console.log(`  ${g('type')} /key ${g('to get started ·')} /tour ${g('to explore ·')} /help ${g('for all commands')}`);
+    console.log(`  ${sage('type')} ${cream('/key')} ${sage('to get started ·')} ${cream('/tour')} ${sage('to explore ·')} ${cream('/help')} ${sage('for commands')}`);
   } else {
     console.log(`  ${ui.randomTip()}`);
-    console.log(`  ${g('type naturally · /help for commands · /quit to exit')}`);
+    console.log(`  ${sage('type naturally ·')} ${cream('/help')} ${sage('for commands ·')} ${cream('/quit')} ${sage('to exit')}`);
   }
-  ui.divider('─');
+  ui.divider('line');
   console.log('');
 
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout,
-    prompt: `  ${cyan('phewsh')} ${green('>')} `,
+    prompt: `  ${teal('phewsh')} ${sage('>')} `,
     historySize: 100,
   });
 
@@ -311,53 +308,55 @@ async function main() {
       if (cmd === 'quit' || cmd === 'exit' || cmd === 'q') {
         const turns = messages.length / 2;
         console.log('');
-        ui.divider('─');
-        console.log(`  ${g('session ended · ' + turns + ' exchanges · ' + (totalPromptTokens + totalCompletionTokens) + ' tokens')}`);
-        ui.divider('─');
+        ui.divider('line');
+        console.log(`  ${sage('session ended · ' + turns + ' exchanges · ' + (totalPromptTokens + totalCompletionTokens) + ' tokens')}`);
+        ui.divider('line');
         console.log('');
         process.exit(0);
       }
 
       if (cmd === 'help' || cmd === 'h') {
-        console.log(`
-  ${b(w('Session commands'))}
-
-  ${w('conversation')}
-    ${cyan('/clear')}       Clear conversation history
-    ${cyan('/run')} ${d('<prompt>')} One-shot prompt (doesn't add to conversation)
-    ${cyan('/quit')}        End session
-
-  ${w('project')}
-    ${cyan('/init')}        Create .intent/ artifacts in this directory
-    ${cyan('/clarify')}     AI-assisted artifact generation
-    ${cyan('/gate')}        Declare operational constraints (budget, time, skill)
-    ${cyan('/export')}      Export portable context for other AI tools
-    ${cyan('/context')}     Show loaded .intent/ files
-    ${cyan('/reload')}      Reload .intent/ context from disk
-    ${cyan('/status')}      Show session stats
-
-  ${w('sync')}
-    ${cyan('/push')}        Push .intent/ to cloud
-    ${cyan('/pull')}        Pull .intent/ from cloud (reloads context)
-    ${cyan('/sync')}        Check sync status
-
-  ${w('configuration')}
-    ${cyan('/login')}       Set up identity + cloud sync
-    ${cyan('/key')}         Set or update your API key
-    ${cyan('/model')} ${d('<name>')} Switch model (sonnet, opus, haiku)
-    ${cyan('/models')}      List available models
-    ${cyan('/provider')}    Show current provider info
-    ${cyan('/update')}      Update phewsh to the latest version
-
-  ${w('explore')}
-    ${cyan('/tour')}        Guided walkthrough of everything PHEWSH can do
-    ${cyan('/system')}      Show current system prompt
-`);
+        console.log('');
+        ui.divider('line');
+        console.log(`  ${b(cream('Session commands'))}`);
+        ui.divider('line');
+        console.log('');
+        console.log(`  ${cream('conversation')}`);
+        console.log(`    ${teal('/clear')}       ${sage('Clear conversation history')}`);
+        console.log(`    ${teal('/run')} ${slate('<prompt>')} ${sage('One-shot prompt (no history)')}`);
+        console.log(`    ${teal('/quit')}        ${sage('End session')}`);
+        console.log('');
+        console.log(`  ${cream('project')}`);
+        console.log(`    ${teal('/init')}        ${sage('Create .intent/ artifacts in this directory')}`);
+        console.log(`    ${teal('/clarify')}     ${sage('AI-assisted artifact generation')}`);
+        console.log(`    ${teal('/gate')}        ${sage('Declare constraints (budget, time, skill)')}`);
+        console.log(`    ${teal('/export')}      ${sage('Export portable context for other AI tools')}`);
+        console.log(`    ${teal('/context')}     ${sage('Show loaded .intent/ files')}`);
+        console.log(`    ${teal('/reload')}      ${sage('Reload .intent/ context from disk')}`);
+        console.log(`    ${teal('/status')}      ${sage('Show session stats')}`);
+        console.log('');
+        console.log(`  ${cream('sync')}`);
+        console.log(`    ${teal('/push')}        ${sage('Push .intent/ to cloud')}`);
+        console.log(`    ${teal('/pull')}        ${sage('Pull .intent/ from cloud (reloads context)')}`);
+        console.log(`    ${teal('/sync')}        ${sage('Check sync status')}`);
+        console.log('');
+        console.log(`  ${cream('configuration')}`);
+        console.log(`    ${teal('/login')}       ${sage('Set up identity + cloud sync')}`);
+        console.log(`    ${teal('/key')}         ${sage('Set or update your API key')}`);
+        console.log(`    ${teal('/model')} ${slate('<name>')} ${sage('Switch model (sonnet, opus, haiku)')}`);
+        console.log(`    ${teal('/models')}      ${sage('List available models')}`);
+        console.log(`    ${teal('/provider')}    ${sage('Show current provider info')}`);
+        console.log(`    ${teal('/update')}      ${sage('Update phewsh to the latest version')}`);
+        console.log('');
+        console.log(`  ${cream('explore')}`);
+        console.log(`    ${teal('/tour')}        ${sage('Guided walkthrough of PHEWSH')}`);
+        console.log(`    ${teal('/system')}      ${sage('Show current system prompt')}`);
+        console.log('');
         rl.prompt();
         return;
       }
 
-      // ── /tour — guided walkthrough ─────────────────────
+      // ── /tour ──────────────────────────────────────────
       if (cmd === 'tour') {
         const pages = ui.TOUR_PAGES;
         let pageIdx = cmdArg ? parseInt(cmdArg) - 1 : 0;
@@ -366,15 +365,15 @@ async function main() {
 
         const page = pages[pageIdx];
         console.log('');
-        ui.divider('─');
-        console.log(`  ${b(w(page.title))}  ${g(`(${pageIdx + 1}/${pages.length})`)}`);
-        ui.divider('─');
+        ui.divider('line');
+        console.log(`  ${b(cream(page.title))}  ${slate(`(${pageIdx + 1}/${pages.length})`)}`);
+        ui.divider('line');
         page.body.forEach(line => console.log(line));
         console.log('');
         if (pageIdx < pages.length - 1) {
-          console.log(`  ${g('next:')} /tour ${pageIdx + 2}  ${g('·')}  ${g('or /tour 1-' + pages.length + ' to jump')}`);
+          console.log(`  ${sage('next:')} ${cream('/tour ' + (pageIdx + 2))}  ${slate('·')}  ${sage('/tour 1-' + pages.length + ' to jump')}`);
         } else {
-          console.log(`  ${green('●')} ${g('End of tour. You\'re ready to go.')}`);
+          console.log(`  ${teal('●')} ${sage('End of tour. You\'re ready.')}`);
         }
         console.log('');
         rl.prompt();
@@ -383,7 +382,7 @@ async function main() {
 
       if (cmd === 'clear') {
         messages.length = 0;
-        console.log(`  ${g('conversation cleared')}`);
+        console.log(`  ${sage('conversation cleared')}`);
         rl.prompt();
         return;
       }
@@ -391,13 +390,13 @@ async function main() {
       if (cmd === 'context') {
         if (intentFiles.length > 0) {
           console.log('');
-          console.log(`  ${b('Loaded from')} ${cyan('.intent/')}`);
-          ui.divider('─');
-          intentFiles.forEach(f => console.log(`    ${green('●')} ${w(f.file)} ${g('(' + f.content.length + ' chars)')}`));
-          ui.divider('─');
+          console.log(`  ${b(cream('Loaded from'))} ${teal('.intent/')}`);
+          ui.divider('line');
+          intentFiles.forEach(f => console.log(`    ${teal('●')} ${cream(f.file)} ${slate('(' + f.content.length + ' chars)')}`));
+          ui.divider('line');
         } else {
-          console.log(`\n  ${g('No .intent/ context found in')} ${process.cwd()}`);
-          console.log(`  ${g('Run')} /init ${g('to create one')}`);
+          console.log(`\n  ${sage('No .intent/ context found in')} ${slate(process.cwd())}`);
+          console.log(`  ${sage('Run')} ${cream('/init')} ${sage('to create one')}`);
         }
         console.log('');
         rl.prompt();
@@ -406,7 +405,7 @@ async function main() {
 
       if (cmd === 'status') {
         const turns = messages.length / 2;
-        config = loadConfig(); // refresh
+        config = loadConfig();
         ui.statusPanel('Session', [
           ['Turns', String(turns)],
           ['Tokens', `${totalPromptTokens} in → ${totalCompletionTokens} out`],
@@ -414,7 +413,7 @@ async function main() {
           ['Context', intentFiles.length > 0 ? intentFiles.map(f => f.file).join(', ') : 'none', intentFiles.length > 0 ? 'green' : 'yellow'],
           ['Model', MODELS[currentModel].name],
           ['Provider', MODELS[currentModel].provider],
-          ['User', config?.email || g('not logged in')],
+          ['User', config?.email || slate('not logged in')],
           ['API key', config?.apiKey ? config.apiKey.slice(0, 8) + '...' : 'not set', config?.apiKey ? 'green' : 'yellow'],
         ]);
         rl.prompt();
@@ -424,34 +423,32 @@ async function main() {
       if (cmd === 'reload') {
         intentFiles = loadIntentContext();
         systemPrompt = buildSystemPrompt(intentFiles);
-        console.log(`  ${green('●')} Reloaded ${intentFiles.length} artifact${intentFiles.length !== 1 ? 's' : ''}`);
+        console.log(`  ${teal('●')} ${sage('Reloaded ' + intentFiles.length + ' artifact' + (intentFiles.length !== 1 ? 's' : ''))}`);
         rl.prompt();
         return;
       }
 
       if (cmd === 'system') {
-        console.log(`\n${g(systemPrompt)}\n`);
+        console.log(`\n${slate(systemPrompt)}\n`);
         rl.prompt();
         return;
       }
 
       if (cmd === 'init') {
         if (fs.existsSync(path.join(INTENT_DIR, 'vision.md'))) {
-          console.log(`\n  ${g('.intent/ already exists in')} ${process.cwd()}`);
-          console.log(`  ${g('Use /reload to refresh context')}\n`);
+          console.log(`\n  ${sage('.intent/ already exists in')} ${slate(process.cwd())}`);
+          console.log(`  ${sage('Use /reload to refresh context')}\n`);
         } else {
           try {
-            // Delegate to the intent --init command
             const { execSync } = require('child_process');
             execSync('node ' + path.join(__dirname, 'intent.js') + ' --init', { stdio: 'inherit' });
-            // Reload context after init
             intentFiles = loadIntentContext();
             systemPrompt = buildSystemPrompt(intentFiles);
             if (intentFiles.length > 0) {
-              console.log(`  ${green('●')} Context loaded: ${intentFiles.map(f => f.file).join(', ')}`);
+              console.log(`  ${teal('●')} ${sage('Context loaded:')} ${cream(intentFiles.map(f => f.file).join(', '))}`);
             }
           } catch (err) {
-            console.error(`  ${g('Init failed:')} ${err.message}`);
+            console.error(`  ${sage('Init failed:')} ${err.message}`);
           }
         }
         console.log('');
@@ -461,7 +458,7 @@ async function main() {
 
       if (cmd === 'clarify') {
         if (!config?.apiKey) {
-          console.log(`\n  ${yellow('!')} No API key. Run /key to set one.\n`);
+          console.log(`\n  ${ember('!')} ${sage('No API key. Run /key to set one.')}\n`);
           rl.prompt();
           return;
         }
@@ -469,14 +466,13 @@ async function main() {
           const { execSync } = require('child_process');
           const args = cmdArg ? `--text "${cmdArg.replace(/"/g, '\\"')}"` : '';
           execSync(`node ${path.join(__dirname, 'clarify.js')} ${args}`, { stdio: 'inherit' });
-          // Reload context after clarify
           intentFiles = loadIntentContext();
           systemPrompt = buildSystemPrompt(intentFiles);
           if (intentFiles.length > 0) {
-            console.log(`  ${green('●')} Context loaded: ${intentFiles.map(f => f.file).join(', ')}`);
+            console.log(`  ${teal('●')} ${sage('Context loaded:')} ${cream(intentFiles.map(f => f.file).join(', '))}`);
           }
         } catch (err) {
-          console.error(`  ${g('Clarify failed:')} ${err.message}`);
+          console.error(`  ${sage('Clarify failed:')} ${err.message}`);
         }
         console.log('');
         rl.prompt();
@@ -488,11 +484,10 @@ async function main() {
           const { execSync } = require('child_process');
           const gateArg = cmdArg || 'status';
           execSync(`node ${path.join(__dirname, 'gate.js')} ${gateArg}`, { stdio: 'inherit' });
-          // Reload context after gate changes (gate.json may have updated)
           intentFiles = loadIntentContext();
           systemPrompt = buildSystemPrompt(intentFiles);
         } catch (err) {
-          console.error(`  ${g('Gate failed:')} ${err.message}`);
+          console.error(`  ${sage('Gate failed:')} ${err.message}`);
         }
         rl.prompt();
         return;
@@ -505,12 +500,12 @@ async function main() {
           if (content) {
             const outPath = path.join(process.cwd(), '.phewsh.context');
             fs.writeFileSync(outPath, content);
-            console.log(`\n  ${green('●')} Written to ${outPath}\n`);
+            console.log(`\n  ${teal('●')} ${sage('Written to')} ${cream(outPath)}\n`);
           } else {
-            console.log(`\n  ${g('No artifacts to export')}\n`);
+            console.log(`\n  ${sage('No artifacts to export')}\n`);
           }
         } catch (err) {
-          console.error(`  ${g('Export failed:')} ${err.message}`);
+          console.error(`  ${sage('Export failed:')} ${err.message}`);
         }
         rl.prompt();
         return;
@@ -518,16 +513,16 @@ async function main() {
 
       if (cmd === 'push') {
         if (!config?.supabaseUserId) {
-          console.log(`\n  ${yellow('!')} Not logged in. Run /login first.\n`);
+          console.log(`\n  ${ember('!')} ${sage('Not logged in. Run /login first.')}\n`);
           rl.prompt();
           return;
         }
         try {
           const token = await ensureValidToken(config);
-          if (!token) { console.log(`\n  ${yellow('!')} Session expired. Run /login.\n`); rl.prompt(); return; }
+          if (!token) { console.log(`\n  ${ember('!')} ${sage('Session expired. Run /login.')}\n`); rl.prompt(); return; }
           await push(config, token);
         } catch (err) {
-          console.error(`  ${yellow('!')} Push failed: ${err.message}\n`);
+          console.error(`  ${ember('!')} ${sage('Push failed:')} ${err.message}\n`);
         }
         rl.prompt();
         return;
@@ -535,22 +530,21 @@ async function main() {
 
       if (cmd === 'pull') {
         if (!config?.supabaseUserId) {
-          console.log(`\n  ${yellow('!')} Not logged in. Run /login first.\n`);
+          console.log(`\n  ${ember('!')} ${sage('Not logged in. Run /login first.')}\n`);
           rl.prompt();
           return;
         }
         try {
           const token = await ensureValidToken(config);
-          if (!token) { console.log(`\n  ${yellow('!')} Session expired. Run /login.\n`); rl.prompt(); return; }
+          if (!token) { console.log(`\n  ${ember('!')} ${sage('Session expired. Run /login.')}\n`); rl.prompt(); return; }
           await pull(config, token);
-          // Reload context after pull
           intentFiles = loadIntentContext();
           systemPrompt = buildSystemPrompt(intentFiles);
           if (intentFiles.length > 0) {
-            console.log(`  ${green('●')} Context reloaded: ${intentFiles.map(f => f.file).join(', ')}`);
+            console.log(`  ${teal('●')} ${sage('Context reloaded:')} ${cream(intentFiles.map(f => f.file).join(', '))}`);
           }
         } catch (err) {
-          console.error(`  ${yellow('!')} Pull failed: ${err.message}\n`);
+          console.error(`  ${ember('!')} ${sage('Pull failed:')} ${err.message}\n`);
         }
         console.log('');
         rl.prompt();
@@ -558,24 +552,23 @@ async function main() {
       }
 
       if (cmd === 'sync') {
-        // Show sync status
         if (!config?.supabaseUserId) {
-          console.log(`\n  ${yellow('!')} Not logged in. Run /login first.\n`);
+          console.log(`\n  ${ember('!')} ${sage('Not logged in. Run /login first.')}\n`);
           rl.prompt();
           return;
         }
         const syncSpin = ui.spinner('checking sync');
         const syncResult = await checkSyncStatus(config);
         if (!syncResult) {
-          syncSpin.stop(`${g('Could not check sync status')}`);
+          syncSpin.stop(`${sage('Could not check sync status')}`);
         } else if (syncResult.status === 'cloud-newer') {
-          syncSpin.stop(`${yellow('↓')} Cloud is newer (${syncResult.ago}) — run /pull`);
+          syncSpin.stop(`${ember('↓')} ${sage('Cloud is newer (' + syncResult.ago + ') — run /pull')}`);
         } else if (syncResult.status === 'local-newer') {
-          syncSpin.stop(`${yellow('↑')} Local changes not pushed (${syncResult.ago}) — run /push`);
+          syncSpin.stop(`${ember('↑')} ${sage('Local changes not pushed (' + syncResult.ago + ') — run /push')}`);
         } else if (syncResult.status === 'synced') {
-          syncSpin.stop(`${green('↕')} In sync`);
+          syncSpin.stop(`${teal('↕')} ${sage('In sync')}`);
         } else if (syncResult.status === 'local-only') {
-          syncSpin.stop(`${g('↕ Not linked to cloud — run /push to sync')}`);
+          syncSpin.stop(`${slate('↕ Not linked to cloud — run /push to sync')}`);
         }
         console.log('');
         rl.prompt();
@@ -586,9 +579,9 @@ async function main() {
         try {
           const { execSync } = require('child_process');
           execSync('node ' + path.join(__dirname, 'login.js'), { stdio: 'inherit' });
-          config = loadConfig(); // refresh after login
+          config = loadConfig();
         } catch (err) {
-          console.error(`  ${g('Login failed:')} ${err.message}`);
+          console.error(`  ${sage('Login failed:')} ${err.message}`);
         }
         rl.prompt();
         return;
@@ -596,56 +589,54 @@ async function main() {
 
       if (cmd === 'key') {
         if (cmdArg) {
-          // Inline: /key sk-ant-...
           const apiKey = cmdArg.trim();
           config = loadConfig() || {};
           if (apiKey.startsWith('sk-ant-') || apiKey.startsWith('sk-')) {
             config.apiKey = apiKey;
             config.provider = 'anthropic';
             saveConfig(config);
-            console.log(`  ${green('●')} Anthropic API key saved. You're ready to go — just type.\n`);
+            console.log(`  ${teal('●')} ${sage('Anthropic key saved. You\'re ready — just type.')}\n`);
           } else if (apiKey.startsWith('sk-or-')) {
             config.apiKey = apiKey;
             config.provider = 'openrouter';
             saveConfig(config);
-            console.log(`  ${green('●')} OpenRouter API key saved. You're ready to go — just type.\n`);
+            console.log(`  ${teal('●')} ${sage('OpenRouter key saved. You\'re ready — just type.')}\n`);
           } else {
             config.apiKey = apiKey;
             saveConfig(config);
-            console.log(`  ${green('●')} API key saved. You're ready to go — just type.\n`);
+            console.log(`  ${teal('●')} ${sage('API key saved. You\'re ready — just type.')}\n`);
           }
           rl.prompt();
           return;
         }
         console.log('');
-        ui.divider('─');
-        console.log(`  ${b(w('Where to get an API key'))}`);
-        ui.divider('─');
+        ui.divider('line');
+        console.log(`  ${b(cream('Where to get an API key'))}`);
+        ui.divider('line');
         console.log('');
-        console.log(`  ${cyan('Anthropic')} ${g('(recommended)')}`);
-        console.log(`    ${g('1.')} Go to ${w('console.anthropic.com/settings/keys')}`);
-        console.log(`    ${g('2.')} Create key → copy it (starts with sk-ant-)`)
+        console.log(`  ${teal('Anthropic')} ${slate('(recommended)')}`);
+        console.log(`    ${sage('1.')} Go to ${cream('console.anthropic.com/settings/keys')}`);
+        console.log(`    ${sage('2.')} Create key → copy it ${slate('(starts with sk-ant-)')}`);
         console.log('');
-        console.log(`  ${cyan('OpenRouter')} ${g('(multi-model)')}`);
-        console.log(`    ${g('1.')} Go to ${w('openrouter.ai/keys')}`);
-        console.log(`    ${g('2.')} Create key → copy it (starts with sk-or-)`)
+        console.log(`  ${teal('OpenRouter')} ${slate('(multi-model)')}`);
+        console.log(`    ${sage('1.')} Go to ${cream('openrouter.ai/keys')}`);
+        console.log(`    ${sage('2.')} Create key → copy it ${slate('(starts with sk-or-)')}`);
         console.log('');
-        console.log(`  ${g('Note: API keys are separate from ChatGPT Plus / Claude Pro subscriptions.')}`);
-        console.log(`  ${g('Both providers offer free credits to get started.')}`);
+        console.log(`  ${slate('Note: API keys ≠ subscriptions. Both providers offer free credits.')}`);
         console.log('');
         const keyRl = readline.createInterface({ input: process.stdin, output: process.stdout });
-        keyRl.question(`  Paste your API key\n  > `, (apiKey) => {
+        keyRl.question(`  ${sage('Paste your API key')}\n  ${teal('>')} `, (apiKey) => {
           keyRl.close();
           apiKey = apiKey.trim();
           if (!apiKey) {
-            console.log(`  ${g('Cancelled')}\n`);
+            console.log(`  ${slate('Cancelled')}\n`);
           } else {
             config = loadConfig() || {};
             config.apiKey = apiKey;
             if (apiKey.startsWith('sk-or-')) config.provider = 'openrouter';
             else config.provider = 'anthropic';
             saveConfig(config);
-            console.log(`\n  ${green('●')} API key saved. You're ready — just type naturally.\n`);
+            console.log(`\n  ${teal('●')} ${sage('API key saved. You\'re ready — just type naturally.')}\n`);
           }
           rl.prompt();
         });
@@ -654,35 +645,34 @@ async function main() {
 
       if (cmd === 'models') {
         console.log('');
-        ui.divider('─');
-        console.log(`  ${b(w('Available models'))}`);
-        ui.divider('─');
+        ui.divider('line');
+        console.log(`  ${b(cream('Available models'))}`);
+        ui.divider('line');
         for (const [key, model] of Object.entries(MODELS)) {
-          const active = key === currentModel ? ` ${green('●')}` : '';
-          console.log(`    ${w(key.padEnd(16))} ${g(model.name)}${active}`);
+          const active = key === currentModel ? ` ${teal('●')}` : '';
+          console.log(`    ${cream(key.padEnd(16))} ${sage(model.name)}${active}`);
         }
-        console.log(`\n  ${g('Switch with:')} /model <name>\n`);
+        console.log(`\n  ${sage('Switch with:')} ${cream('/model <name>')}\n`);
         rl.prompt();
         return;
       }
 
       if (cmd === 'model') {
         if (!cmdArg) {
-          console.log(`  ${g('Current:')} ${MODELS[currentModel].name}`);
-          console.log(`  ${g('Usage:')} /model <sonnet|opus|haiku>`);
+          console.log(`  ${sage('Current:')} ${cream(MODELS[currentModel].name)}`);
+          console.log(`  ${sage('Usage:')} ${cream('/model <sonnet|opus|haiku>')}`);
           rl.prompt();
           return;
         }
-        // Fuzzy match model name
         const query = cmdArg.toLowerCase().replace('claude-', '').replace('claude', '');
         const match = Object.keys(MODELS).find(k =>
           k.includes(query) || MODELS[k].name.toLowerCase().includes(query)
         );
         if (match) {
           currentModel = match;
-          console.log(`  ${green('●')} Switched to ${MODELS[match].name}`);
+          console.log(`  ${teal('●')} ${sage('Switched to')} ${cream(MODELS[match].name)}`);
         } else {
-          console.log(`  ${g('Unknown model. Available:')} ${Object.keys(MODELS).join(', ')}`);
+          console.log(`  ${sage('Unknown model. Available:')} ${cream(Object.keys(MODELS).join(', '))}`);
         }
         rl.prompt();
         return;
@@ -701,26 +691,26 @@ async function main() {
       }
 
       if (cmd === 'update' || cmd === 'upgrade') {
-        const updateSpin = ui.spinner('checking for updates');
+        const updateSpin = ui.spinner('checking for updates', 'gentle');
         try {
           const pkg = require('../../package.json');
           const res = await fetch(`https://registry.npmjs.org/${pkg.name}/latest`, { signal: AbortSignal.timeout(5000) });
           const data = await res.json();
           if (!data.version || data.version === pkg.version) {
-            updateSpin.stop(`${green('●')} Already on the latest version (${pkg.version})`);
+            updateSpin.stop(`${teal('●')} ${sage('Already on the latest version (' + pkg.version + ')')}`);
             console.log('');
             rl.prompt();
             return;
           }
-          updateSpin.stop(`${cyan(pkg.version)} → ${cyan(data.version)}`);
-          console.log(`  ${g('Installing...')}\n`);
+          updateSpin.stop(`${peach(pkg.version)} ${sage('→')} ${peach(data.version)}`);
+          console.log(`  ${sage('Installing...')}\n`);
           const { execSync } = require('child_process');
           execSync(`npm install -g ${pkg.name}@latest`, { stdio: 'inherit' });
-          console.log(`\n  ${green('●')} Updated to ${data.version}`);
-          console.log(`  ${g('Restart phewsh to use the new version.')}\n`);
+          console.log(`\n  ${teal('●')} ${sage('Updated to')} ${cream(data.version)}`);
+          console.log(`  ${slate('Restart phewsh to use the new version.')}\n`);
         } catch (err) {
-          updateSpin.stop(`${yellow('!')} Update failed: ${err.message}`);
-          console.log(`  ${g('You can update manually:')} npm install -g phewsh\n`);
+          updateSpin.stop(`${ember('!')} ${sage('Update failed:')} ${err.message}`);
+          console.log(`  ${sage('You can update manually:')} ${cream('npm install -g phewsh')}\n`);
         }
         rl.prompt();
         return;
@@ -728,16 +718,15 @@ async function main() {
 
       if (cmd === 'run') {
         if (!cmdArg) {
-          console.log(`  ${g('Usage:')} /run <prompt>`);
+          console.log(`  ${sage('Usage:')} ${cream('/run <prompt>')}`);
           rl.prompt();
           return;
         }
         if (!config?.apiKey) {
-          console.log(`  ${yellow('!')} No API key. Run /key to set one.`);
+          console.log(`  ${ember('!')} ${sage('No API key. Run /key to set one.')}`);
           rl.prompt();
           return;
         }
-        // One-shot: don't add to conversation history
         console.log('');
         try {
           const result = await streamChat(
@@ -747,7 +736,7 @@ async function main() {
             MODELS[currentModel].id
           );
           if (result.promptTokens || result.completionTokens) {
-            console.log(g(`  ${result.promptTokens || '?'}→${result.completionTokens || '?'} tokens`));
+            console.log(slate(`  ${result.promptTokens || '?'}→${result.completionTokens || '?'} tokens`));
           }
           trackSap({
             userId: config.supabaseUserId,
@@ -766,7 +755,7 @@ async function main() {
       }
 
       // Unknown slash command
-      console.log(`  ${g('Unknown command:')} /${cmd} ${g('— type /help for available commands')}`);
+      console.log(`  ${sage('Unknown command:')} ${cream('/' + cmd)} ${slate('— type /help for available commands')}`);
       rl.prompt();
       return;
     }
@@ -774,12 +763,12 @@ async function main() {
     // Regular input → send to AI
     if (!config?.apiKey) {
       console.log('');
-      console.log(`  ${yellow('Almost there!')} You need an API key to chat.`);
-      console.log(`  Type ${w('/key')} and paste one in — takes 10 seconds.`);
+      console.log(`  ${peach('Almost there.')} ${sage('You need an API key to chat.')}`);
+      console.log(`  ${sage('Type')} ${cream('/key')} ${sage('and paste one in — takes 10 seconds.')}`);
       console.log('');
-      console.log(`  ${g('Get a key:')}  ${cyan('console.anthropic.com/settings/keys')}`);
-      console.log(`  ${g('Or try:')}     ${cyan('openrouter.ai/keys')}`);
-      console.log(`  ${g('Explore:')}    ${cyan('/tour')} ${g('to see what PHEWSH does (no key needed)')}`);
+      console.log(`  ${slate('Get a key:')}  ${sage('console.anthropic.com/settings/keys')}`);
+      console.log(`  ${slate('Or try:')}     ${sage('openrouter.ai/keys')}`);
+      console.log(`  ${slate('Explore:')}    ${cream('/tour')} ${slate('to see what PHEWSH does (no key needed)')}`);
       console.log('');
       rl.prompt();
       return;
@@ -792,16 +781,13 @@ async function main() {
       const result = await streamChat(config.apiKey, messages, systemPrompt, MODELS[currentModel].id);
       messages.push({ role: 'assistant', content: result.content });
 
-      // Track totals
       if (result.promptTokens) totalPromptTokens += result.promptTokens;
       if (result.completionTokens) totalCompletionTokens += result.completionTokens;
 
-      // Token count footer
       if (result.promptTokens || result.completionTokens) {
-        console.log(g(`  ${result.promptTokens || '?'}→${result.completionTokens || '?'} tokens · ${MODELS[currentModel].name}`));
+        console.log(slate(`  ${result.promptTokens || '?'}→${result.completionTokens || '?'} tokens · ${MODELS[currentModel].name}`));
       }
 
-      // SAP tracking (fire-and-forget)
       trackSap({
         userId: config.supabaseUserId,
         source: 'cli',
@@ -812,7 +798,6 @@ async function main() {
       });
     } catch (err) {
       console.error(`\n  ${err.message}\n`);
-      // Remove the failed user message
       messages.pop();
     }
 
@@ -821,7 +806,7 @@ async function main() {
   });
 
   rl.on('close', () => {
-    console.log(`\n  ${g('Session ended')}\n`);
+    console.log(`\n  ${sage('session ended')}\n`);
     process.exit(0);
   });
 }

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 = 'relief. quiet execution.';
+  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('·')} ${sage('Type')} ${cream('/clarify')} ${sage('to turn a messy idea into a structured spec')}`,
+  `${slate('·')} ${cream('/gate')} ${sage('sets budget, time, and skill constraints — AI respects them')}`,
+  `${slate('·')} ${sage('Run')} ${cream('phewsh watch')} ${sage('in another tab for live sync to CLAUDE.md')}`,
+  `${slate('·')} ${cream('/export')} ${sage('creates a portable context file for any AI tool')}`,
+  `${slate('·')} ${cream('/model opus')} ${sage('for complex reasoning,')} ${cream('/model haiku')} ${sage('for speed')}`,
+  `${slate('·')} ${sage('Your')} ${cream('.intent/')} ${sage('files are plain markdown — edit them anytime')}`,
+  `${slate('·')} ${cream('phewsh context --copy')} ${sage('puts your project context on the clipboard')}`,
+  `${slate('·')} ${cream('/tour')} ${sage('walks you through everything PHEWSH can do')}`,
 ];
 
 function randomTip() {
@@ -167,86 +246,97 @@ const TOUR_PAGES = [
   {
     title: 'What is PHEWSH?',
     body: [
-      `  PHEWSH gives your project a ${b('portable identity')}.`,
+      '',
+      `  ${cream('phew')} ${sage('— the relief of not starting from scratch.')}`,
+      `  ${cream('shh')}  ${sage('— it just works. No noise.')}`,
+      '',
+      `  PHEWSH gives your project a ${b(cream('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.`,
+      `  It works ${cream('standalone')} as its own AI shell,`,
+      `  and ${cream('inside')} Claude Code, Cursor, ChatGPT, and 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('Your project context lives in')} ${teal('.intent/')} ${sage('— plain markdown.')}`,
+      `  ${sage('You own them. They travel with your code.')}`,
     ]
   },
   {
     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 project's full context.`,
+      '',
+      `    ${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 doesn\'t need a warmup. It already knows.')}`,
     ]
   },
   {
     title: 'Inside 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 → auto-updates CLAUDE.md')}`,
+      `  ${b(cream('Cursor'))}        ${sage('phewsh context --file → .phewsh.context')}`,
+      `  ${b(cream('ChatGPT'))}       ${sage('phewsh context --copy → paste in')}`,
+      `  ${b(cream('MCP agents'))}    ${sage('phewsh mcp setup → agents self-brief')}`,
+      '',
+      `  ${sage('Same identity. Every tool. No re-explaining.')}`,
+      `  ${sage('Switch tools 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('●')} Type naturally to chat with your project context`,
+      `  ${teal('●')} ${cream('/init')} or ${cream('/clarify')} to create .intent/ artifacts`,
+      `  ${teal('●')} ${cream('/gate')} to set your constraints`,
+      `  ${teal('●')} ${cream('/help')} for all commands`,
+      '',
+      `  ${sage('PHEWSH is your project\'s home base.')}`,
+      `  ${sage('The exhale before execution.')}`,
     ]
   },
 ];
 
 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.12",
   "description": "Turn intent into action. Structure your thinking, execute your next step.",
   "bin": {
     "phewsh": "bin/phewsh.js"