phewsh 0.6.1 → 0.8.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,16 +78,17 @@ 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('');
 }
 
-// Non-blocking update check
+// Non-blocking update check — resolves true if update found
+let _updateDone = false;
 function checkForUpdates() {
   const pkg = require('../package.json');
-  fetch(`https://registry.npmjs.org/${pkg.name}/latest`, { signal: AbortSignal.timeout(3000) })
+  return fetch(`https://registry.npmjs.org/${pkg.name}/latest`, { signal: AbortSignal.timeout(3000) })
     .then(r => r.json())
     .then(data => {
       if (data.version && data.version !== pkg.version) {
@@ -91,25 +97,50 @@ function checkForUpdates() {
         const isNewer = newer[0] > current[0] || newer[1] > current[1] || newer[2] > current[2];
         if (isNewer) {
           console.log(g(`\n  Update available: ${pkg.version} → ${data.version}`));
-          console.log(g(`  npm install -g phewsh\n`));
+          console.log(g(`  Run: npm install -g phewsh\n`));
         }
       }
     })
-    .catch(() => {});
+    .catch(() => {})
+    .finally(() => { _updateDone = true; });
 }
 
-if (!command || command === 'help' || command === '--help' || command === '-h') {
-  showHelp();
-  process.exit(0);
-}
+// Always check for updates (non-blocking)
+const updatePromise = checkForUpdates();
 
-if (command === 'version' || command === '--version' || command === '-v') {
-  showVersion();
-  process.exit(0);
+function exitAfterUpdate(code = 0) {
+  // If update check already resolved, exit now
+  if (_updateDone) return process.exit(code);
+  // Otherwise wait up to 2s for it to finish
+  updatePromise.then(() => process.exit(code));
+  setTimeout(() => process.exit(code), 2000);
 }
 
-if (COMMANDS[command]) {
-  checkForUpdates();
+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);
+  }
+} else if (command === 'help' || command === '--help' || command === '-h') {
+  showHelp();
+  exitAfterUpdate(0);
+} else if (command === 'version' || command === '--version' || command === '-v') {
+  showVersion();
+  exitAfterUpdate(0);
+} else if (COMMANDS[command]) {
   COMMANDS[command]();
 } else {
   console.error(`\n  Unknown command: ${command}\n  Run 'phewsh help' for available commands.\n`);

package/commands/session.js

@@ -0,0 +1,262 @@
+// 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_PATH = path.join(os.homedir(), '.phewsh', 'config.json');
+const INTENT_DIR = path.join(process.cwd(), '.intent');
+const HISTORY_PATH = path.join(os.homedir(), '.phewsh', 'session_history.json');
+
+const b = (s) => `\x1b[1m${s}\x1b[0m`;
+const d = (s) => `\x1b[2m${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`;
+
+function loadConfig() {
+  if (!fs.existsSync(CONFIG_PATH)) return null;
+  try { return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8')); } catch { return null; }
+}
+
+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, config) {
+  const model = 'claude-sonnet-4-6';
+  const body = { model, 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');
+
+  // SAP tracking (fire-and-forget)
+  trackSap({
+    userId: config.supabaseUserId,
+    source: 'cli',
+    model,
+    promptTokens,
+    completionTokens,
+    accessToken: config.supabaseAccessToken,
+  });
+
+  return { content: fullResponse, promptTokens, completionTokens };
+}
+
+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);
+  const messages = []; // conversation history
+  const projectName = path.basename(process.cwd());
+
+  // Session banner
+  console.log('');
+  console.log(`  ${d('😮‍💨')} ${d('🤫')}`);
+  console.log('');
+  if (intentFiles.length > 0) {
+    console.log(`  ${green('●')} Session started ${g('·')} ${cyan(projectName)} ${g('·')} ${intentFiles.map(f => f.file).join(', ')}`);
+  } else {
+    console.log(`  ${green('●')} Session started ${g('·')} ${cyan(projectName)} ${g('·')} no .intent/ context`);
+  }
+  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 cmd = input.slice(1).split(' ')[0].toLowerCase();
+
+      if (cmd === 'quit' || cmd === 'exit' || cmd === 'q') {
+        console.log(`\n  ${g('Session ended · ' + messages.length / 2 + ' exchanges')}\n`);
+        process.exit(0);
+      }
+
+      if (cmd === 'help') {
+        console.log(`
+  ${b('Session commands')}
+
+    ${g('/quit')}        End session
+    ${g('/clear')}       Clear conversation history
+    ${g('/context')}     Show loaded .intent/ files
+    ${g('/status')}      Show session stats
+    ${g('/reload')}      Reload .intent/ context
+    ${g('/system')}      Show system prompt (debug)
+`);
+        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')} phewsh clarify ${g('to create one')}`);
+        }
+        console.log('');
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'status') {
+        const turns = messages.length / 2;
+        console.log(`\n  ${b('Session')}`);
+        console.log(`    Turns      ${turns}`);
+        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('');
+        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' : ''}`);
+        rl.prompt();
+        return;
+      }
+
+      if (cmd === 'system') {
+        console.log(`\n${g(systemPrompt)}\n`);
+        rl.prompt();
+        return;
+      }
+
+      // Unknown slash command — treat as normal input
+    }
+
+    // Regular input → send to AI
+    messages.push({ role: 'user', content: input });
+
+    console.log('');
+
+    try {
+      const result = await streamChat(config.apiKey, messages, systemPrompt, config);
+      messages.push({ role: 'assistant', content: result.content });
+
+      // Token count footer
+      if (result.promptTokens || result.completionTokens) {
+        console.log(g(`  ${result.promptTokens || '?'}→${result.completionTokens || '?'} tokens`));
+      }
+    } 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.6.1",
+  "version": "0.8.0",
   "description": "Turn intent into action. Structure your thinking, execute your next step.",
   "bin": {
     "phewsh": "bin/phewsh.js"