phewsh 0.8.0 → 0.10.0

package/README.md

@@ -1,6 +1,6 @@
 # phewsh
 
-Turn intent into action.
+Turn intent into action. Structure your thinking, execute your next step.
 
 ## Install
 
@@ -8,24 +8,64 @@ Turn intent into action.
 npm install -g phewsh
 ```
 
-## Usage
+## Quick Start
 
 ```bash
-phewsh intent --init      # Create .intent/ in any project
-phewsh intent --status    # Check artifact state and next actions
-phewsh intent --open      # Open the web compass
-phewsh intent --evolve    # Update artifacts as the project grows
+phewsh              # enter the interactive shell
+```
+
+Inside the shell:
+
+```
+/init       Create .intent/ artifacts
+/clarify    AI-assisted artifact generation
+/push       Sync local to cloud
+/pull       Sync cloud to local
+/context    View loaded artifacts
+/sync       Check sync status
+/help       All commands
 ```
 
 ## What it does
 
-`phewsh intent --init` asks what you're building and what success looks like, then creates three structured artifacts in `.intent/`:
+Creates three structured artifacts in `.intent/`:
 
 - **vision.md** — The north star. Why this exists and where it's going.
 - **plan.md** — The strategy. Phases, systems, sequence, constraints.
-- **next.md** — Right now. Executable checklist with copy-paste commands.
+- **next.md** — Right now. Executable checklist with next actions.
+
+These artifacts become persistent context for AI conversations, both in the shell and across tools.
+
+## Sync
+
+CLI and web (phewsh.com/intent) share the same cloud via Supabase.
+
+```bash
+phewsh login        # authenticate
+phewsh push         # upload .intent/ to cloud
+phewsh pull         # download from cloud
+```
+
+Sync is manual. The CLI shows status on startup:
+
+```
+↓ Cloud is newer (2h ago) — run /pull
+↑ Local changes not pushed (15m ago) — run /push
+↕ synced
+```
 
-Drop `.intent/` in any project and your AI tools gain full context instantly.
+The `/intent` Claude Code skill writes local files only — run `phewsh push` after using it.
+
+## Non-interactive mode
+
+```bash
+phewsh intent --init      # Create .intent/ without entering the shell
+phewsh intent --status    # Check artifact state
+phewsh clarify            # AI-assisted artifact generation
+phewsh ai run "prompt"    # One-shot AI with .intent/ context
+phewsh push               # Sync to cloud
+phewsh pull               # Sync from cloud
+```
 
 ## Web app
 

package/bin/phewsh.js

@@ -46,7 +46,7 @@ const COMMANDS = {
   login:   () => require('../commands/login'),
   ai:      () => require('../commands/ai'),
   style:   () => require('../commands/style'),
-  music:   () => require('../commands/music'),
+  mbhd:    () => require('../commands/mbhd'),
   sap:     () => require('../commands/sap'),
   help:    showHelp,
   version: showVersion,
@@ -74,7 +74,7 @@ function showHelp() {
   console.log(`    ${w('login')}     Set up identity, API key, and cloud sync`);
   console.log(`    ${w('sap')}       Sustainable AI Protocol — usage and accountability`);
   console.log(`    ${w('style')}     Build your style identity — ingest, profile, sync`);
-  console.log(`    ${w('music')}     MBHD music engine`);
+  console.log(`    ${w('mbhd')}      MBHD music engine`);
   console.log('');
   console.log(`  ${b('Quick start')}`);
   console.log(`    ${g('phewsh login')}                          Set up identity + API key`);
@@ -117,23 +117,9 @@ function exitAfterUpdate(code = 0) {
 }
 
 if (!command) {
-  // Bare `phewsh` — drop into persistent session
-  // If no API key, fall back to help
-  const fs = require('fs');
-  const path = require('path');
-  const os = require('os');
-  const configPath = path.join(os.homedir(), '.phewsh', 'config.json');
-  let hasKey = false;
-  try {
-    const cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-    hasKey = !!cfg.apiKey;
-  } catch {}
-  if (hasKey) {
-    COMMANDS.session();
-  } else {
-    showHelp();
-    exitAfterUpdate(0);
-  }
+  // Bare `phewsh` — always drop into persistent session
+  // Session handles missing API key gracefully with /login and /key commands
+  COMMANDS.session();
 } else if (command === 'help' || command === '--help' || command === '-h') {
   showHelp();
   exitAfterUpdate(0);

package/commands/{music.js → mbhd.js}

@@ -1,6 +1,6 @@
 const { execSync } = require('child_process');
 
-const WEB_URL = 'https://phewsh.com/music';
+const WEB_URL = 'https://phewsh.com/mbhd';
 
 console.log(`\n  🎵 Opening MBHD Music Engine...\n`);
 

package/commands/session.js

@@ -8,21 +8,113 @@ const os = require('os');
 const readline = require('readline');
 const { trackSap } = require('../lib/supabase');
 
-const CONFIG_PATH = path.join(os.homedir(), '.phewsh', 'config.json');
+const CONFIG_DIR = path.join(os.homedir(), '.phewsh');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
 const INTENT_DIR = path.join(process.cwd(), '.intent');
-const HISTORY_PATH = path.join(os.homedir(), '.phewsh', 'session_history.json');
+
+const { select, refreshSession: refreshSess } = require('../lib/supabase');
+const { readPPS } = require('../lib/pps');
+const { push, pull, ensureValidToken } = require('./sync');
 
 const b = (s) => `\x1b[1m${s}\x1b[0m`;
 const d = (s) => `\x1b[2m${s}\x1b[0m`;
+const w = (s) => `\x1b[97m${s}\x1b[0m`;
 const g = (s) => `\x1b[90m${s}\x1b[0m`;
 const green = (s) => `\x1b[32m${s}\x1b[0m`;
 const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+
+// Sync awareness: compare local .intent/ timestamps with cloud updated_at
+async function checkSyncStatus(config) {
+  if (!config?.supabaseUserId || !config?.supabaseAccessToken) return null;
+  if (!fs.existsSync(INTENT_DIR)) return null;
+
+  try {
+    const token = await ensureValidToken(config);
+    if (!token) return null;
+
+    const pps = readPPS(INTENT_DIR);
+    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`;
+
+    const projects = await select('projects', query, token);
+    if (projects.length === 0) return { status: 'local-only' };
+
+    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`,
+      token
+    );
+
+    const cloudTime = artifacts.length > 0
+      ? 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) {
+      const filePath = path.join(INTENT_DIR, file);
+      if (fs.existsSync(filePath)) {
+        const mtime = fs.statSync(filePath).mtimeMs;
+        if (mtime > latestLocal) latestLocal = mtime;
+      }
+    }
+
+    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) {
+      const ago = formatAgo(Date.now() - cloudTime);
+      return { status: 'cloud-newer', ago };
+    } else {
+      const ago = formatAgo(Date.now() - latestLocal);
+      return { status: 'local-newer', ago };
+    }
+  } catch {
+    return null; // Network error — silently skip
+  }
+}
+
+function formatAgo(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`;
+  const days = Math.floor(hrs / 24);
+  return `${days}d ago`;
+}
+
+const MODELS = {
+  'claude-sonnet': { id: 'claude-sonnet-4-6', name: 'Claude Sonnet 4.6', provider: 'anthropic' },
+  'claude-opus': { id: 'claude-opus-4-6', name: 'Claude Opus 4.6', provider: 'anthropic' },
+  'claude-haiku': { id: 'claude-haiku-4-5-20251001', name: 'Claude Haiku 4.5', provider: 'anthropic' },
+};
+
+const DEFAULT_MODEL = 'claude-sonnet';
 
 function loadConfig() {
   if (!fs.existsSync(CONFIG_PATH)) return null;
   try { return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8')); } catch { return null; }
 }
 
+function saveConfig(config) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+
 function loadIntentContext() {
   const files = ['vision.md', 'plan.md', 'next.md'];
   const loaded = [];
@@ -49,9 +141,8 @@ function buildSystemPrompt(intentFiles) {
   return `${base}\n\nThe user has structured intent artifacts for this project. Use them as primary context — stay aligned with their vision, plan, and next actions.\n\n${sections}`;
 }
 
-async function streamChat(apiKey, messages, systemPrompt, config) {
-  const model = 'claude-sonnet-4-6';
-  const body = { model, max_tokens: 2048, messages, stream: true };
+async function streamChat(apiKey, messages, systemPrompt, modelId) {
+  const body = { model: modelId, max_tokens: 2048, messages, stream: true };
   if (systemPrompt) body.system = systemPrompt;
 
   const response = await fetch('https://api.anthropic.com/v1/messages', {
@@ -97,42 +188,65 @@ async function streamChat(apiKey, messages, systemPrompt, config) {
 
   process.stdout.write('\n');
 
-  // SAP tracking (fire-and-forget)
-  trackSap({
-    userId: config.supabaseUserId,
-    source: 'cli',
-    model,
-    promptTokens,
-    completionTokens,
-    accessToken: config.supabaseAccessToken,
-  });
-
-  return { content: fullResponse, promptTokens, completionTokens };
+  return { content: fullResponse, promptTokens, completionTokens, model: modelId };
 }
 
 async function main() {
-  const config = loadConfig();
-
-  if (!config?.apiKey) {
-    console.log('\n  No API key found. Run `phewsh login --set-key` first.');
-    console.log('  Or start at: `phewsh login`\n');
-    process.exit(1);
-  }
-
-  const intentFiles = loadIntentContext();
-  const systemPrompt = buildSystemPrompt(intentFiles);
+  let config = loadConfig();
+  let intentFiles = loadIntentContext();
+  let systemPrompt = buildSystemPrompt(intentFiles);
   const messages = []; // conversation history
   const projectName = path.basename(process.cwd());
+  let currentModel = DEFAULT_MODEL;
+  let totalPromptTokens = 0;
+  let totalCompletionTokens = 0;
 
-  // Session banner
+  // Session banner with PHEWSH branding
   console.log('');
   console.log(`  ${d('😮‍💨')} ${d('🤫')}`);
   console.log('');
+  console.log(`  ${b(w('█▀█ █░█ █▀▀ █░█ █▀ █░█'))}`);
+  console.log(`  ${b(w('█▀▀ █▀█ ██▄ ▀▄▀ ▄█ █▀█'))}`);
+  console.log('');
+
+  if (!config?.apiKey) {
+    console.log(`  ${yellow('⚠')} No API key configured.`);
+    console.log(`  ${g('Run')} /login ${g('to set up identity + API key')}`);
+    console.log(`  ${g('Or')}  /key ${g('to add an API key directly')}`);
+    console.log('');
+  }
+
   if (intentFiles.length > 0) {
-    console.log(`  ${green('●')} Session started ${g('·')} ${cyan(projectName)} ${g('·')} ${intentFiles.map(f => f.file).join(', ')}`);
+    console.log(`  ${green('●')} ${cyan(projectName)} ${g('·')} ${intentFiles.map(f => f.file).join(', ')}`);
   } else {
-    console.log(`  ${green('●')} Session started ${g('·')} ${cyan(projectName)} ${g('·')} no .intent/ context`);
+    console.log(`  ${green('●')} ${cyan(projectName)} ${g('·')} no .intent/ context`);
+    console.log(`  ${g('  run /init to create .intent/ artifacts')}`);
   }
+  console.log(`  ${g('  model:')} ${MODELS[currentModel].name}`);
+  if (config?.email) {
+    console.log(`  ${g('  user:')} ${config.email}`);
+  }
+
+  // Sync status check (non-blocking, 3s timeout)
+  if (config?.supabaseUserId && intentFiles.length > 0) {
+    const syncResult = await Promise.race([
+      checkSyncStatus(config),
+      new Promise(resolve => setTimeout(() => resolve(null), 3000)),
+    ]);
+    if (syncResult) {
+      if (syncResult.status === 'cloud-newer') {
+        console.log(`  ${yellow('↓')} Cloud is newer (${syncResult.ago}) — run /pull`);
+      } else if (syncResult.status === 'local-newer') {
+        console.log(`  ${yellow('↑')} Local changes not pushed (${syncResult.ago}) — run /push`);
+      } else if (syncResult.status === 'synced') {
+        console.log(`  ${green('↕')} ${g('synced')}`);
+      } else if (syncResult.status === 'local-only') {
+        console.log(`  ${g('↕ not linked to cloud — run /push to sync')}`);
+      }
+    }
+  }
+
+  console.log('');
   console.log(`  ${g('type naturally · /help for commands · /quit to exit')}`);
   console.log('');
 
@@ -155,23 +269,46 @@ async function main() {
 
     // Slash commands
     if (input.startsWith('/')) {
-      const cmd = input.slice(1).split(' ')[0].toLowerCase();
+      const parts = input.slice(1).split(/\s+/);
+      const cmd = parts[0].toLowerCase();
+      const cmdArg = parts.slice(1).join(' ');
 
       if (cmd === 'quit' || cmd === 'exit' || cmd === 'q') {
-        console.log(`\n  ${g('Session ended · ' + messages.length / 2 + ' exchanges')}\n`);
+        const turns = messages.length / 2;
+        console.log(`\n  ${g('Session ended · ' + turns + ' exchanges · ' + (totalPromptTokens + totalCompletionTokens) + ' tokens')}\n`);
         process.exit(0);
       }
 
-      if (cmd === 'help') {
+      if (cmd === 'help' || cmd === 'h') {
         console.log(`
   ${b('Session commands')}
 
-    ${g('/quit')}        End session
+  ${w('conversation')}
     ${g('/clear')}       Clear conversation history
+    ${g('/run')} ${d('<prompt>')} One-shot prompt (doesn't add to conversation)
+    ${g('/quit')}        End session
+
+  ${w('project')}
+    ${g('/init')}        Create .intent/ artifacts in this directory
+    ${g('/clarify')}     AI-assisted artifact generation
     ${g('/context')}     Show loaded .intent/ files
+    ${g('/reload')}      Reload .intent/ context from disk
     ${g('/status')}      Show session stats
-    ${g('/reload')}      Reload .intent/ context
-    ${g('/system')}      Show system prompt (debug)
+
+  ${w('sync')}
+    ${g('/push')}        Push .intent/ to cloud
+    ${g('/pull')}        Pull .intent/ from cloud (reloads context)
+    ${g('/sync')}        Check sync status
+
+  ${w('configuration')}
+    ${g('/login')}       Set up identity + cloud sync
+    ${g('/key')}         Set or update your API key
+    ${g('/model')} ${d('<name>')} Switch model (sonnet, opus, haiku)
+    ${g('/models')}      List available models
+    ${g('/provider')}    Show current provider info
+
+  ${w('debug')}
+    ${g('/system')}      Show current system prompt
 `);
         rl.prompt();
         return;
@@ -190,7 +327,7 @@ async function main() {
           intentFiles.forEach(f => console.log(`    ${green('●')} ${f.file} ${g('(' + f.content.length + ' chars)')}`));
         } else {
           console.log(`\n  ${g('No .intent/ context found in')} ${process.cwd()}`);
-          console.log(`  ${g('Run')} phewsh clarify ${g('to create one')}`);
+          console.log(`  ${g('Run')} /init ${g('to create one')}`);
         }
         console.log('');
         rl.prompt();
@@ -199,21 +336,25 @@ async function main() {
 
       if (cmd === 'status') {
         const turns = messages.length / 2;
+        config = loadConfig(); // refresh
         console.log(`\n  ${b('Session')}`);
         console.log(`    Turns      ${turns}`);
+        console.log(`    Tokens     ${totalPromptTokens}→${totalCompletionTokens} (in→out)`);
         console.log(`    Project    ${projectName}`);
         console.log(`    Context    ${intentFiles.length > 0 ? intentFiles.map(f => f.file).join(', ') : 'none'}`);
-        console.log(`    Provider   anthropic (claude-sonnet-4-6)`);
+        console.log(`    Model      ${MODELS[currentModel].name}`);
+        console.log(`    Provider   ${MODELS[currentModel].provider}`);
+        if (config?.email) console.log(`    User       ${config.email}`);
+        console.log(`    API key    ${config?.apiKey ? config.apiKey.slice(0, 8) + '...' : yellow('not set')}`);
         console.log('');
         rl.prompt();
         return;
       }
 
       if (cmd === 'reload') {
-        const reloaded = loadIntentContext();
-        intentFiles.length = 0;
-        intentFiles.push(...reloaded);
-        console.log(`  ${green('●')} Reloaded ${reloaded.length} artifact${reloaded.length !== 1 ? 's' : ''}`);
+        intentFiles = loadIntentContext();
+        systemPrompt = buildSystemPrompt(intentFiles);
+        console.log(`  ${green('●')} Reloaded ${intentFiles.length} artifact${intentFiles.length !== 1 ? 's' : ''}`);
         rl.prompt();
         return;
       }
@@ -224,22 +365,270 @@ async function main() {
         return;
       }
 
-      // Unknown slash command — treat as normal input
+      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`);
+        } 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(', ')}`);
+            }
+          } catch (err) {
+            console.error(`  ${g('Init failed:')} ${err.message}`);
+          }
+        }
+        console.log('');
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'clarify') {
+        if (!config?.apiKey) {
+          console.log(`\n  ${yellow('⚠')} No API key. Run /key to set one.\n`);
+          rl.prompt();
+          return;
+        }
+        try {
+          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(', ')}`);
+          }
+        } catch (err) {
+          console.error(`  ${g('Clarify failed:')} ${err.message}`);
+        }
+        console.log('');
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'push') {
+        if (!config?.supabaseUserId) {
+          console.log(`\n  ${yellow('⚠')} 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; }
+          await push(config, token);
+        } catch (err) {
+          console.error(`  ${yellow('⚠')} Push failed: ${err.message}\n`);
+        }
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'pull') {
+        if (!config?.supabaseUserId) {
+          console.log(`\n  ${yellow('⚠')} 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; }
+          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(', ')}`);
+          }
+        } catch (err) {
+          console.error(`  ${yellow('⚠')} Pull failed: ${err.message}\n`);
+        }
+        console.log('');
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'sync') {
+        // Show sync status
+        if (!config?.supabaseUserId) {
+          console.log(`\n  ${yellow('⚠')} Not logged in. Run /login first.\n`);
+          rl.prompt();
+          return;
+        }
+        const syncResult = await checkSyncStatus(config);
+        if (!syncResult) {
+          console.log(`\n  ${g('Could not check sync status')}\n`);
+        } else if (syncResult.status === 'cloud-newer') {
+          console.log(`\n  ${yellow('↓')} Cloud is newer (${syncResult.ago}) — run /pull\n`);
+        } else if (syncResult.status === 'local-newer') {
+          console.log(`\n  ${yellow('↑')} Local changes not pushed (${syncResult.ago}) — run /push\n`);
+        } else if (syncResult.status === 'synced') {
+          console.log(`\n  ${green('↕')} In sync\n`);
+        } else if (syncResult.status === 'local-only') {
+          console.log(`\n  ${g('↕ Not linked to cloud — run /push to sync')}\n`);
+        }
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'login') {
+        try {
+          const { execSync } = require('child_process');
+          execSync('node ' + path.join(__dirname, 'login.js'), { stdio: 'inherit' });
+          config = loadConfig(); // refresh after login
+        } catch (err) {
+          console.error(`  ${g('Login failed:')} ${err.message}`);
+        }
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'key') {
+        const keyRl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        keyRl.question(`\n  Anthropic API key\n  > `, (apiKey) => {
+          keyRl.close();
+          apiKey = apiKey.trim();
+          if (apiKey) {
+            config = loadConfig() || {};
+            config.apiKey = apiKey;
+            saveConfig(config);
+            console.log(`  ${green('●')} API key saved\n`);
+          } else {
+            console.log(`  ${g('Cancelled')}\n`);
+          }
+          rl.prompt();
+        });
+        return;
+      }
+
+      if (cmd === 'models') {
+        console.log(`\n  ${b('Available models')}\n`);
+        for (const [key, model] of Object.entries(MODELS)) {
+          const active = key === currentModel ? ` ${green('●')}` : '';
+          console.log(`    ${w(key.padEnd(16))} ${g(model.name)}${active}`);
+        }
+        console.log(`\n  ${g('Switch with:')} /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>`);
+          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}`);
+        } else {
+          console.log(`  ${g('Unknown model. Available:')} ${Object.keys(MODELS).join(', ')}`);
+        }
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'provider') {
+        const model = MODELS[currentModel];
+        console.log(`\n  ${b('Provider')}`);
+        console.log(`    API        Anthropic (direct)`);
+        console.log(`    Model      ${model.name}`);
+        console.log(`    Endpoint   api.anthropic.com/v1/messages`);
+        console.log(`    Key        ${config?.apiKey ? config.apiKey.slice(0, 8) + '...' : yellow('not set')}`);
+        console.log('');
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'run') {
+        if (!cmdArg) {
+          console.log(`  ${g('Usage:')} /run <prompt>`);
+          rl.prompt();
+          return;
+        }
+        if (!config?.apiKey) {
+          console.log(`  ${yellow('⚠')} 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(
+            config.apiKey,
+            [{ role: 'user', content: cmdArg }],
+            systemPrompt,
+            MODELS[currentModel].id
+          );
+          if (result.promptTokens || result.completionTokens) {
+            console.log(g(`  ${result.promptTokens || '?'}→${result.completionTokens || '?'} tokens`));
+          }
+          trackSap({
+            userId: config.supabaseUserId,
+            source: 'cli',
+            model: MODELS[currentModel].id,
+            promptTokens: result.promptTokens,
+            completionTokens: result.completionTokens,
+            accessToken: config.supabaseAccessToken,
+          });
+        } catch (err) {
+          console.error(`\n  ${err.message}\n`);
+        }
+        console.log('');
+        rl.prompt();
+        return;
+      }
+
+      // Unknown slash command
+      console.log(`  ${g('Unknown command:')} /${cmd} ${g('— type /help for available commands')}`);
+      rl.prompt();
+      return;
     }
 
     // Regular input → send to AI
-    messages.push({ role: 'user', content: input });
+    if (!config?.apiKey) {
+      console.log(`\n  ${yellow('⚠')} No API key configured. Run /key to set one.\n`);
+      rl.prompt();
+      return;
+    }
 
+    messages.push({ role: 'user', content: input });
     console.log('');
 
     try {
-      const result = await streamChat(config.apiKey, messages, systemPrompt, config);
+      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`));
+        console.log(g(`  ${result.promptTokens || '?'}→${result.completionTokens || '?'} tokens · ${MODELS[currentModel].name}`));
       }
+
+      // SAP tracking (fire-and-forget)
+      trackSap({
+        userId: config.supabaseUserId,
+        source: 'cli',
+        model: MODELS[currentModel].id,
+        promptTokens: result.promptTokens,
+        completionTokens: result.completionTokens,
+        accessToken: config.supabaseAccessToken,
+      });
     } catch (err) {
       console.error(`\n  ${err.message}\n`);
       // Remove the failed user message

package/commands/sync.js

@@ -113,6 +113,7 @@ async function push(config, token) {
     if (!localPPS.adapters.phewsh) localPPS.adapters.phewsh = {};
     localPPS.adapters.phewsh.cloud_id = project.id;
     localPPS.adapters.phewsh.last_synced = new Date().toISOString();
+    localPPS.adapters.phewsh.last_updated_by = 'cli';
     writePPS(INTENT_DIR, localPPS);
   }
 
@@ -164,7 +165,7 @@ async function pull(config, token, cloudId = null) {
     // Keep any local adapter links
     if (localPPS?.adapters) merged.adapters = { ...project.pps_json.adapters, ...localPPS.adapters };
     merged.adapters = merged.adapters || {};
-    merged.adapters.phewsh = { cloud_id: project.id, last_synced: new Date().toISOString() };
+    merged.adapters.phewsh = { cloud_id: project.id, last_synced: new Date().toISOString(), last_updated_by: 'pull' };
     writePPS(INTENT_DIR, merged);
     pulled.push('pps.json');
   }

package/package.json

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