phewsh 0.9.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`);

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

@@ -12,6 +12,10 @@ 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 { 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`;
@@ -20,6 +24,79 @@ 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' },
@@ -149,6 +226,26 @@ async function main() {
   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('');
@@ -193,10 +290,16 @@ async function main() {
 
   ${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
 
+  ${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
@@ -286,6 +389,94 @@ async function main() {
         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');

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.9.0",
+  "version": "0.10.0",
   "description": "Turn intent into action. Structure your thinking, execute your next step.",
   "bin": {
     "phewsh": "bin/phewsh.js"