phewsh 0.15.77 → 0.15.78

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

@@ -220,7 +220,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');
@@ -358,7 +358,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 +374,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.78",
+  "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"
   },