phewsh 0.15.76 → 0.15.78

package/README.md

@@ -1,6 +1,11 @@
 # phewsh
 
-Turn intent into action. Structure your thinking, execute your next step.
+**One mission. Many AI tools. No lost context.**
+
+PHEWSH is the continuity layer for AI-assisted work: it turns what you're
+building into durable project intent (`.intent/`) and carries it across
+Claude Code, Codex, Cursor, Gemini, your terminal, and your team — so the
+next AI knows what the last one learned.
 
 ## Install
 
@@ -204,6 +209,18 @@ the same canonical `.intent/` source.
 
 [phewsh.com/intent](https://phewsh.com/intent)
 
+## Feedback
+
+Something missing, confusing, or broken?
+
+```bash
+phewsh feedback "what you expected vs what happened"
+```
+
+That opens a prefilled public issue on this repo (only your words plus
+version/OS/node — documented in [SECURITY.md](./SECURITY.md)). Private
+channel: hello@phewsh.com.
+
 ## License
 
 MIT

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/commands/status.js

@@ -59,7 +59,7 @@ function main() {
   if (!hasIntent) {
     console.log(row('PROJECT', `${off} ${sage('no shared project truth here yet')}`));
     console.log(row('', slate('create it so you — and the next AI — inherit context:')));
-    console.log(row('', cream('phewsh intent --init')));
+    console.log(row('', `${cream('phewsh init')} ${slate('(two questions) · guided:')} ${cream('phewsh clarify')}`));
   } else {
     const files = fs.readdirSync(intentDir).filter(f => /\.(md|json)$/.test(f));
     const has = (f) => files.includes(f);

package/lib/shims.js

@@ -114,7 +114,7 @@ function preflightBanner(bin, cwd = process.cwd()) {
       const n = bumpNudge(cwd);
       if (n <= 3) {
         return `${C.sage('😮‍💨🤫 phewsh')} ${C.slate('· no shared project truth here yet')}\n`
-          + `   ${C.slate('so every AI tool stays in sync, create it:')} ${C.cream('phewsh intent --init')} ${C.slate('· → ' + bin)}`;
+          + `   ${C.slate('so every AI tool stays in sync, create it:')} ${C.cream('phewsh init')} ${C.slate('· → ' + bin)}`;
       }
       return `${C.sage('😮‍💨🤫 phewsh active')} ${C.slate('· → ' + bin)}`;
     }

package/lib/slash-commands.js

@@ -24,7 +24,7 @@ const INTENT_PROMPT = `Show me this project's current intent, read from its \`.i
 - **Constraints** — budget, time, scope, non-negotiables
 - **Recent decisions** — and any that are still open
 
-If there is no \`.intent/\` directory here, say so and tell me I can create one with \`phewsh intent --init\` so every AI tool I use shares the same project truth.`;
+If there is no \`.intent/\` directory here, say so and tell me I can create one with \`phewsh init\` so every AI tool I use shares the same project truth.`;
 
 // Tools that support file-based custom slash commands, and how each wants them.
 // parentDir must already exist (the tool is installed) before we write.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "phewsh",
-  "version": "0.15.76",
-  "description": "Turn intent into action. Structure your thinking, execute your next step.",
+  "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"
   },
@@ -25,7 +25,15 @@
     "claude",
     "mcp",
     "model-context-protocol",
-    "phewsh"
+    "phewsh",
+    "continuity",
+    "context",
+    "agents",
+    "claude-code",
+    "codex",
+    "cursor",
+    "gemini",
+    "agents-md"
   ],
   "author": "Phewsh <hello@phewsh.com>",
   "license": "MIT",