phewsh 0.7.0 → 0.9.0

package/bin/phewsh.js

@@ -37,6 +37,7 @@ function showBrand() {
 }
 
 const COMMANDS = {
+  session: () => require('../commands/session'),
   intent:  () => require('../commands/intent'),
   clarify: () => require('../commands/clarify'),
   push:    () => require('../commands/push'),
@@ -59,13 +60,17 @@ function showHelp() {
   const pkg = require('../package.json');
   showBrand();
   console.log(`  ${g('v' + pkg.version)}  ·  ${g('phewsh.com')}\n`);
+  console.log(`  ${b('Just type')} ${w('phewsh')} ${b('to start a session.')}`);
+  console.log(`  ${g('Opens a persistent AI shell with your .intent/ context injected.')}`);
+  console.log('');
   console.log(`  ${b('Commands')}`);
+  console.log(`    ${w('(bare)')}    Open persistent AI session — just type naturally`);
   console.log(`    ${w('clarify')}   Turn messy intent into a structured project spec`);
   console.log(`    ${w('push')}      Push local .intent/ to cloud`);
   console.log(`    ${w('pull')}      Pull project from cloud to .intent/`);
   console.log(`    ${w('link')}      Link local .intent/ to a cloud project`);
   console.log(`    ${w('intent')}    Manage .intent/ artifacts — status, open, evolve`);
-  console.log(`    ${w('ai')}        Run context-aware AI prompts (reads .intent/)`);
+  console.log(`    ${w('ai')}        One-shot AI prompt (reads .intent/)`);
   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`);
@@ -73,9 +78,9 @@ function showHelp() {
   console.log('');
   console.log(`  ${b('Quick start')}`);
   console.log(`    ${g('phewsh login')}                          Set up identity + API key`);
+  console.log(`    ${g('phewsh')}                                Open AI session (with .intent/ context)`);
   console.log(`    ${g('phewsh clarify')}                        Compile messy intent → structured spec`);
-  console.log(`    ${g('phewsh push')}                           Sync to cloud`);
-  console.log(`    ${g('phewsh ai run "what\'s next?"')}         AI with your project context`);
+  console.log(`    ${g('phewsh ai run "what\'s next?"')}         One-shot prompt`);
   console.log('');
 }
 
@@ -111,7 +116,11 @@ function exitAfterUpdate(code = 0) {
   setTimeout(() => process.exit(code), 2000);
 }
 
-if (!command || command === 'help' || command === '--help' || command === '-h') {
+if (!command) {
+  // 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);
 } else if (command === 'version' || command === '--version' || command === '-v') {

package/commands/session.js

@@ -0,0 +1,460 @@
+// phewsh session — persistent agent shell
+// Drops you into a REPL where you type naturally.
+// Under the hood: routes to Claude, injects .intent/ context, tracks SAP.
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const readline = require('readline');
+const { trackSap } = require('../lib/supabase');
+
+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 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`;
+
+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 = [];
+  for (const file of files) {
+    const p = path.join(INTENT_DIR, file);
+    if (fs.existsSync(p)) {
+      loaded.push({ file, content: fs.readFileSync(p, 'utf-8') });
+    }
+  }
+  return loaded;
+}
+
+function buildSystemPrompt(intentFiles) {
+  const base = `You are PHEWSH — a focused execution assistant. You help the user think clearly, build intentionally, and ship without drift. Be concise, direct, and opinionated. Respond in plain text, not markdown, unless the user asks for formatted output.`;
+
+  if (intentFiles.length === 0) {
+    return base + `\n\nNo .intent/ artifacts found in the current directory. The user hasn't set up project context yet — help them think through what they're building if they ask.`;
+  }
+
+  const sections = intentFiles.map(({ file, content }) =>
+    `## ${file}\n\n${content.trim()}`
+  ).join('\n\n---\n\n');
+
+  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, 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', {
+    method: 'POST',
+    headers: {
+      'x-api-key': apiKey,
+      'anthropic-version': '2023-06-01',
+      'content-type': 'application/json',
+    },
+    body: JSON.stringify(body),
+  });
+
+  if (!response.ok) {
+    const err = await response.json().catch(() => ({}));
+    throw new Error(err.error?.message || `API error ${response.status}`);
+  }
+
+  let fullResponse = '';
+  let promptTokens = null;
+  let completionTokens = null;
+
+  for await (const chunk of response.body) {
+    const text = Buffer.from(chunk).toString('utf-8');
+    const lines = text.split('\n').filter(l => l.startsWith('data: '));
+    for (const line of lines) {
+      const data = line.slice(6);
+      if (data === '[DONE]') continue;
+      try {
+        const parsed = JSON.parse(data);
+        if (parsed.type === 'content_block_delta' && parsed.delta?.text) {
+          process.stdout.write(parsed.delta.text);
+          fullResponse += parsed.delta.text;
+        }
+        if (parsed.type === 'message_start' && parsed.message?.usage) {
+          promptTokens = parsed.message.usage.input_tokens;
+        }
+        if (parsed.type === 'message_delta' && parsed.usage) {
+          completionTokens = parsed.usage.output_tokens;
+        }
+      } catch { /* skip */ }
+    }
+  }
+
+  process.stdout.write('\n');
+
+  return { content: fullResponse, promptTokens, completionTokens, model: modelId };
+}
+
+async function main() {
+  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 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('●')} ${cyan(projectName)} ${g('·')} ${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(`  ${g('  model:')} ${MODELS[currentModel].name}`);
+  if (config?.email) {
+    console.log(`  ${g('  user:')} ${config.email}`);
+  }
+  console.log('');
+  console.log(`  ${g('type naturally · /help for commands · /quit to exit')}`);
+  console.log('');
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: `  ${green('>')} `,
+    historySize: 100,
+  });
+
+  rl.prompt();
+
+  rl.on('line', async (line) => {
+    const input = line.trim();
+
+    if (!input) {
+      rl.prompt();
+      return;
+    }
+
+    // Slash commands
+    if (input.startsWith('/')) {
+      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') {
+        const turns = messages.length / 2;
+        console.log(`\n  ${g('Session ended · ' + turns + ' exchanges · ' + (totalPromptTokens + totalCompletionTokens) + ' tokens')}\n`);
+        process.exit(0);
+      }
+
+      if (cmd === 'help' || cmd === 'h') {
+        console.log(`
+  ${b('Session commands')}
+
+  ${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('/context')}     Show loaded .intent/ files
+    ${g('/reload')}      Reload .intent/ context from disk
+    ${g('/status')}      Show session stats
+
+  ${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;
+      }
+
+      if (cmd === 'clear') {
+        messages.length = 0;
+        console.log(`  ${g('conversation cleared')}`);
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'context') {
+        if (intentFiles.length > 0) {
+          console.log(`\n  Loaded from ${cyan('.intent/')}:`);
+          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')} /init ${g('to create one')}`);
+        }
+        console.log('');
+        rl.prompt();
+        return;
+      }
+
+      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(`    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') {
+        intentFiles = loadIntentContext();
+        systemPrompt = buildSystemPrompt(intentFiles);
+        console.log(`  ${green('●')} Reloaded ${intentFiles.length} artifact${intentFiles.length !== 1 ? 's' : ''}`);
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'system') {
+        console.log(`\n${g(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`);
+        } 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 === '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
+    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, 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}`));
+      }
+
+      // 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
+      messages.pop();
+    }
+
+    console.log('');
+    rl.prompt();
+  });
+
+  rl.on('close', () => {
+    console.log(`\n  ${g('Session ended')}\n`);
+    process.exit(0);
+  });
+}
+
+main().catch(err => {
+  console.error('\n  Error:', err.message);
+  process.exit(1);
+});

package/package.json

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