phewsh 0.15.77 → 0.15.79

package/bin/phewsh.js

@@ -113,6 +113,7 @@ const COMMANDS = {
   remember: () => require('../commands/remember')(),
   task:    () => require('../commands/task')(),
   dispatch: () => require('../commands/task')(),
+  ion:     () => require('../commands/ion')(),
   pack:    () => require('../commands/pack')(),
   hook:    () => require('../commands/hook')(),
   feedback: () => require('../commands/feedback')(),
@@ -159,7 +160,8 @@ function showHelp() {
   console.log(`    ${cyan('seq')}        ${g('Sequence all memory → optimal context for any agent')}`);
   console.log(`    ${cyan('watch')}      ${g('Auto-sync .intent/ → native harness files + cloud')}`);
   console.log(`    ${cyan('push/pull')}  ${g('Manual sync to/from phewsh.com/intent')}`);
-  console.log(`    ${cyan('serve')}      ${g('Execution bridge — run from phewsh.com/intent')}`);
+  console.log(`    ${cyan('serve')}      ${g('Execution bridge — run from phewsh.com/ion or /intent')}`);
+  console.log(`    ${cyan('ion')}        ${g('Shared visual room for humans + local agents')}`);
   console.log(`    ${cyan('mcp')}        ${g('Connect AI agents via MCP protocol')}`);
   console.log(`    ${cyan('ambient')}    ${g('Continuity without launching phewsh — enhance your other tools')}`);
   console.log(`    ${cyan('shim')}       ${g('Guaranteed launch banner — phewsh prints status before each tool')}`);

package/commands/ion.js

@@ -0,0 +1,115 @@
+// phewsh ion — command surface for the shared visual room.
+//
+// Ion is not a second execution system. It is the room over the existing
+// Phewsh primitives:
+//   - `serve` exposes the local worker bridge
+//   - `task` owns shared requests, invites, claims, reviews, and receipts
+//   - `/ion` is the browser room where humans can see and steer the loop
+
+const { execFileSync } = require('child_process');
+
+const WEB_URL = 'https://phewsh.com/ion';
+
+const cream = (s) => `\x1b[97m${s}\x1b[0m`;
+const sage = (s) => `\x1b[38;5;247m${s}\x1b[0m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+
+function openBrowser(url = WEB_URL) {
+  try {
+    if (process.platform === 'darwin') execFileSync('open', [url]);
+    else if (process.platform === 'win32') execFileSync('cmd', ['/c', 'start', '', url]);
+    else execFileSync('xdg-open', [url]);
+    console.log(`\n  ${green('✓')} Opened ${cream(url)}\n`);
+  } catch {
+    console.log(`\n  ${sage('Could not open browser. Visit:')} ${cream(url)}\n`);
+  }
+}
+
+function showHelp() {
+  console.log(`
+  ${cream('phewsh ion')} — shared rooms for humans + local agents
+
+  ${sage('Open the room')}
+    ${cyan('phewsh ion')}              ${sage('open phewsh.com/ion')}
+    ${cyan('phewsh ion open')}         ${sage('same')}
+
+  ${sage('Make this machine available')}
+    ${cyan('phewsh ion serve')}        ${sage('start the local worker bridge')}
+    ${cyan('phewsh ion status')}       ${sage('show bridge/project/task status')}
+
+  ${sage('Use the existing task loop')}
+    ${cyan('phewsh ion task')}         ${sage('list shared tasks')}
+    ${cyan('phewsh ion request "..."')} ${sage('request work in the room')}
+    ${cyan('phewsh ion claim next')}   ${sage('manual claim + isolated PR flow')}
+    ${cyan('phewsh ion invite <email>')} ${sage('invite a teammate')}
+    ${cyan('phewsh ion join')}         ${sage('accept pending invites')}
+
+  ${sage('Connectors')}
+    ${cyan('phewsh ion connectors')}   ${sage('show Slack/Discord connector plan')}
+`);
+}
+
+function showConnectors() {
+  console.log(`
+  ${cream('Ion connectors')}
+
+  ${sage('Canonical room:')} ${cream('phewsh.com/ion')}
+  ${sage('Execution:')}      ${cream('phewsh ion serve')} ${sage('or')} ${cream('phewsh ion claim <id>')}
+
+  ${sage('Slack and Discord are connectors, not the core room yet.')}
+  ${sage('Planned flow:')}
+    Slack/Discord mention
+      → Ion task request
+      → human approval in Ion
+      → local/VPS Phewsh worker runs
+      → branch/PR/evidence returns to Ion
+      → notification posts back to Slack/Discord
+
+  ${sage('Do not build bot auto-execution first. Keep Ion as the source of truth.')}
+`);
+}
+
+function runTask(args) {
+  process.argv = [process.argv[0], process.argv[1], 'task', ...args];
+  return require('./task')();
+}
+
+function runServe(args) {
+  process.argv = [process.argv[0], process.argv[1], 'serve', ...args];
+  return require('./serve')();
+}
+
+module.exports = async function run() {
+  const args = process.argv.slice(3);
+  const sub = args[0] || 'open';
+  const rest = args.slice(1);
+
+  try {
+    if (sub === '--help' || sub === '-h' || sub === 'help') return showHelp();
+    if (sub === 'open') return openBrowser();
+    if (sub === 'serve' || sub === 'worker') return runServe(rest);
+    if (sub === 'status') {
+      console.log(`\n  ${cream('Ion room:')} ${cyan(WEB_URL)}`);
+      console.log(`  ${sage('Local worker:')} ${cream('phewsh ion serve')}`);
+      return runTask(['list']);
+    }
+    if (sub === 'task' || sub === 'tasks') return runTask(rest.length ? rest : ['list']);
+    if (sub === 'request' || sub === 'new') return runTask(['new', ...rest]);
+    if (sub === 'claim') return runTask(['claim', ...rest]);
+    if (sub === 'invite') return runTask(['invite', ...rest]);
+    if (sub === 'join') return runTask(['join']);
+    if (sub === 'reconcile') return runTask(['reconcile', ...rest]);
+    if (sub === 'connectors' || sub === 'slack' || sub === 'discord') return showConnectors();
+
+    console.log(`\n  ${red('✗')} Unknown ion command: ${sub}\n`);
+    showHelp();
+    process.exitCode = 1;
+  } catch (err) {
+    console.error(`\n  ${red('✗')} ${err.message}\n`);
+    process.exitCode = 1;
+  }
+};
+
+module.exports.openBrowser = openBrowser;

package/commands/serve.js

@@ -12,7 +12,7 @@
 //   phewsh serve --port 8080  Start on custom port
 
 const http = require('http');
-const { execSync, spawn } = require('child_process');
+const { execFileSync, spawn } = require('child_process');
 const crypto = require('crypto');
 const os = require('os');
 const path = require('path');
@@ -35,6 +35,18 @@ function getPort() {
   return 7483;
 }
 
+// The project this worker serves = the directory it was started in. The
+// normalized origin remote is the identity the claim path already verifies
+// against (task.js repo-match); name alone is display, remote is truth.
+function currentProject() {
+  let remote = null;
+  try {
+    remote = execFileSync('git', ['remote', 'get-url', 'origin'], { stdio: ['ignore', 'pipe', 'ignore'] })
+      .toString().trim() || null;
+  } catch { /* not a git repo, or no origin — worker still serves the directory */ }
+  return { name: path.basename(process.cwd()), remote };
+}
+
 // ─── Runtime Detection ─────────────────────────────────────────────────────
 
 // Harness runners — shared table in lib/harnesses.js. PHEWSH is not a
@@ -220,7 +232,7 @@ function json(req, res, data, status = 200) {
 
 function main() {
   if (process.argv.includes('--help') || process.argv.includes('-h')) {
-    console.log('\n  phewsh serve — local execution bridge for phewsh.com/intent');
+    console.log('\n  phewsh serve — local execution bridge for phewsh.com/ion and phewsh.com/intent');
     console.log('    Runs a loopback server so the web workspace can dispatch to your');
     console.log('    installed agents. Stays running until you stop it (ctrl+c).');
     console.log('\n  Usage:  phewsh serve [--port <n>]   (default 7483)\n');
@@ -245,10 +257,12 @@ function main() {
       return;
     }
 
-    // Health check
+    // Health check — includes which project this worker is serving, so the
+    // web can say "worker online — <project>" instead of an anonymous dot.
     if (url.pathname === '/health' && req.method === 'GET') {
       return json(req, res, {
         status: 'ok',
+        project: currentProject(),
         runtimes: detectRuntimes(),
         version: require('../package.json').version,
         uptime: process.uptime(),
@@ -351,6 +365,26 @@ function main() {
 
   const server = http.createServer(handleRequest);
 
+  // One worker per machine (per port) for now. A second `phewsh serve` used to
+  // die with a raw EADDRINUSE stack — say what's true and how to proceed instead.
+  server.on('error', (err) => {
+    if (err.code === 'EADDRINUSE') {
+      console.log('');
+      console.log(`  ${yellow('●')} A phewsh worker is already running on port ${port}.`);
+      console.log('');
+      console.log(`  ${g('One worker per machine for now — the running worker serves the project')}`);
+      console.log(`  ${g('directory it was started in. To serve a different project:')}`);
+      console.log(`    ${g('· stop the other worker (Ctrl+C) and start this one, or')}`);
+      console.log(`    ${g('· run on another port:')} ${w(`phewsh serve --port ${port + 1}`)}`);
+      console.log(`      ${g('(note: phewsh.com currently discovers port 7483 only)')}`);
+      console.log('');
+      console.log(`  ${g('A one-worker-many-projects registry is the planned next step.')}`);
+      console.log('');
+      process.exit(1);
+    }
+    throw err;
+  });
+
   server.listen(port, '127.0.0.1', () => {
     const mirror = http.createServer(handleRequest);
     mirror.on('error', () => { /* IPv6 unavailable or already bound */ });
@@ -358,7 +392,7 @@ function main() {
 
     console.log('');
     console.log(`  ${b(w('PHEWSH Serve'))} ${g('v' + require('../package.json').version)}`);
-    console.log(`  ${g('Live execution bridge for phewsh.com/intent')}`);
+    console.log(`  ${g('Live execution bridge for phewsh.com/ion and phewsh.com/intent')}`);
     console.log('');
     console.log(`  ${green('●')} Running on ${w(`http://localhost:${port}`)}`);
     console.log(`  ${g('Web cockpit:')} ${w('phewsh.com/cockpit')} ${g('— mirrors this machine live')}`);
@@ -374,7 +408,7 @@ function main() {
       console.log(`  ${g('https://docs.anthropic.com/en/docs/claude-code')}`);
     }
     console.log('');
-    console.log(`  ${g('Open phewsh.com/intent → Work tab to see the Live indicator')}`);
+    console.log(`  ${g('Open phewsh.com/ion to see the worker online, or phewsh.com/intent → Work')}`);
     console.log(`  ${g('Press Ctrl+C to stop')}`);
     console.log('');
   });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "phewsh",
-  "version": "0.15.77",
-  "description": "One mission. Many AI tools. No lost context. PHEWSH keeps your project's intent, decisions, and working context aligned across Claude Code, Codex, Cursor, Gemini and your team \u2014 so the next AI knows what the last one learned.",
+  "version": "0.15.79",
+  "description": "One mission. Many AI tools. No lost context. PHEWSH keeps your project's intent, decisions, and working context aligned across Claude Code, Codex, Cursor, Gemini and your team — so the next AI knows what the last one learned.",
   "bin": {
     "phewsh": "bin/phewsh.js"
   },