phewsh 0.15.73 → 0.15.75

package/bin/phewsh.js

@@ -115,6 +115,7 @@ const COMMANDS = {
   dispatch: () => require('../commands/task')(),
   pack:    () => require('../commands/pack')(),
   hook:    () => require('../commands/hook')(),
+  feedback: () => require('../commands/feedback')(),
   welcome: () => require('../commands/welcome')(),
   intro:   () => require('../commands/welcome')(),
   help:    showHelp,
@@ -171,6 +172,7 @@ function showHelp() {
   console.log(`    ${cyan('bypass')}     ${g('Went around phewsh? Record why — 10 seconds, no guilt')}`);
   console.log('');
   console.log(`  ${b(w('configure'))}`);
+  console.log(`    ${cyan('feedback')}   ${g('Tell us where it breaks — prefilled GitHub issue, nothing hidden')}`);
   console.log(`    ${cyan('login')}      ${g('Identity + API key + cloud sync')}`);
   console.log(`    ${cyan('link')}       ${g('Link local .intent/ to cloud project')}`);
   console.log(`    ${cyan('update')}     ${g('Update phewsh — or `phewsh update auto on` to stay current automatically')}`);

package/commands/clarify.js

@@ -81,6 +81,26 @@ function assembleRaw(answers) {
   return answers.map((a) => `${a.title} (${a.directive}): ${a.answer}`).join('\n');
 }
 
+// No-AI spec from the user's own words: the first answer line becomes the
+// goal (node label stripped), the raw text survives verbatim in pps.intent.raw,
+// and the first task points back at the AI compile.
+function fallbackSpec(raw) {
+  const first = String(raw).split('\n').find(l => l.trim()) || "Capture this project's intent";
+  const goal = first.replace(/^[A-Za-z]+ \([^)]*\):\s*/, '').trim().slice(0, 200);
+  return {
+    goal,
+    success_criteria: [],
+    constraints: [],
+    inputs: [],
+    outputs: [],
+    tasks: [
+      { text: 'Re-run `phewsh clarify --update` to compile this spec with AI', type: 'copy' },
+      { text: 'Refine the vision — complete vision.md', type: 'do' },
+      { text: 'Define Phase 1 — what is the smallest thing to ship?', type: 'do' },
+    ],
+  };
+}
+
 function buildClarifySystemPrompt(existing) {
   const isRefine = !!(existing?.intent?.goal);
   return `You are a project compiler. Your job is to extract clean, structured intent from messy human input.
@@ -264,8 +284,12 @@ async function main() {
       ? await callClarifyViaHarness(harnessId, raw, existing)
       : await callClarifyAPI(config.apiKey, raw, existing);
   } catch (err) {
-    console.error('\n  Clarify failed:', err.message, '\n');
-    process.exit(1);
+    // A failed compile must NEVER eat the user's answers. They just walked
+    // the compass — write a plain no-AI spec from what they typed, and let
+    // `clarify --update` enrich it when a route works again.
+    console.log(`\n  AI compile unavailable (${err.message}).`);
+    console.log('  Saving your answers as a plain spec instead — nothing you typed is lost.');
+    extracted = fallbackSpec(raw);
   }
 
   const entity = getProjectName();
@@ -333,4 +357,4 @@ if (require.main === module) {
   });
 }
 
-module.exports = { run: main, GUIDE_NODES, INTENT_NODES, assembleRaw, askGuided, extractJson };
+module.exports = { run: main, GUIDE_NODES, INTENT_NODES, assembleRaw, askGuided, extractJson, fallbackSpec };

package/commands/feedback.js

@@ -0,0 +1,62 @@
+// phewsh feedback — the door the launch post points at.
+//
+//   phewsh feedback                 open a prefilled GitHub issue in the browser
+//   phewsh feedback "it broke..."   same, with your words already in the body
+//
+// Deliberately no hidden telemetry: everything sent is shown first, travels
+// as a URL you can read, and lands in the public issue tracker. Email stays
+// the quiet alternative for anything private.
+
+const os = require('os');
+const { execFileSync } = require('child_process');
+
+const REPO_ISSUES = 'https://github.com/cleverIdeaz/phewsh-cli/issues/new';
+const EMAIL = 'hello@phewsh.com';
+
+const b = (s) => `\x1b[1m${s}\x1b[0m`;
+const g = (s) => `\x1b[38;5;247m${s}\x1b[0m`;
+const w = (s) => `\x1b[97m${s}\x1b[0m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+
+function buildUrl(text) {
+  const version = require('../package.json').version;
+  const body = [
+    text ? text.trim() : '<!-- What happened? What did you expect? -->',
+    '',
+    '---',
+    `phewsh ${version} · ${process.platform} ${os.release()} · node ${process.version}`,
+  ].join('\n');
+  const params = new URLSearchParams({ title: text ? text.trim().slice(0, 72) : '', body });
+  return `${REPO_ISSUES}?${params.toString()}`;
+}
+
+// Arg-array spawn only — the URL carries user text; it must never touch a shell.
+function openBrowser(url) {
+  try {
+    if (process.platform === 'darwin') execFileSync('open', [url]);
+    else if (process.platform === 'win32') execFileSync('cmd', ['/c', 'start', '', url]);
+    else execFileSync('xdg-open', [url]);
+    return true;
+  } catch { return false; }
+}
+
+function main() {
+  const text = process.argv.slice(3).filter(a => !a.startsWith('--')).join(' ');
+  const url = buildUrl(text);
+  console.log('');
+  console.log(`  ${b(w('phewsh feedback'))} ${g('— where it breaks is exactly what we want to hear')}`);
+  console.log(`  ${g('Includes only what you see: your words + version/OS/node. Nothing else.')}`);
+  console.log('');
+  const opened = openBrowser(url);
+  if (opened) {
+    console.log(`  ${cyan('●')} ${g('Opened a prefilled GitHub issue in your browser.')}`);
+  } else {
+    console.log(`  ${g('Open this to file it:')}`);
+    console.log(`  ${w(url)}`);
+  }
+  console.log(`  ${g('Prefer email?')} ${w(EMAIL)}`);
+  console.log('');
+}
+
+module.exports = main;
+module.exports.buildUrl = buildUrl;

package/commands/intent.js

@@ -6,7 +6,12 @@ const { createPPS, writeGuardedViews } = require('../lib/pps');
 
 const os = require('os');
 const configFile = require('../lib/config-file');
-const args = process.argv.slice(3);
+// Flags may arrive as `phewsh intent --init` / `phewsh init --init` (flag at
+// argv[3]) or as a direct `node intent.js --init` (flag at argv[2]) — the
+// session used the direct form and every flag was silently missed, so /init
+// printed help instead of initializing. Accept both shapes.
+const rawArgs = process.argv.slice(2);
+const args = (rawArgs[0] === 'intent' || rawArgs[0] === 'init') ? rawArgs.slice(1) : rawArgs;
 const INTENT_DIR = path.join(process.cwd(), '.intent');
 const CONFIG_PATH = path.join(os.homedir(), '.phewsh', 'config.json');
 const WEB_URL = 'https://phewsh.com/intent';

package/commands/session.js

@@ -1329,8 +1329,8 @@ async function main() {
       if (choice.kind === 'init') {
         bootstrapChoices = null;
         try {
-          const { execSync } = require('child_process');
-          execSync('node ' + path.join(__dirname, 'intent.js') + ' --init', { stdio: 'inherit' });
+          const { execFileSync } = require('child_process');
+          execFileSync(process.execPath, [path.join(__dirname, '..', 'bin', 'phewsh.js'), 'intent', '--init'], { stdio: 'inherit' });
           intentFiles = loadIntentContext();
           systemPrompt = buildSystemPrompt(intentFiles);
           if (intentFiles.length > 0) {
@@ -1916,8 +1916,8 @@ async function main() {
           console.log(`  ${sage('Use /reload to refresh context')}\n`);
         } else {
           try {
-            const { execSync } = require('child_process');
-            execSync('node ' + path.join(__dirname, 'intent.js') + ' --init', { stdio: 'inherit' });
+            const { execFileSync } = require('child_process');
+            execFileSync(process.execPath, [path.join(__dirname, '..', 'bin', 'phewsh.js'), 'intent', '--init'], { stdio: 'inherit' });
             intentFiles = loadIntentContext();
             systemPrompt = buildSystemPrompt(intentFiles);
             if (intentFiles.length > 0) {

package/lib/packs.js

@@ -54,11 +54,11 @@ const PACKS = {
   },
   'loop-library': {
     kind: 'linked',
-    title: 'Loop Library',
-    desc: 'Copy-ready agent loops with checks and stopping conditions. Good Work-layer inspiration; phewsh links to it without becoming a scheduler or runner.',
-    source: 'github.com/Forward-Future/loop-library · signals.forwardfuture.ai/loop-library',
+    title: 'Loop Library / Loopy',
+    desc: 'Forward Future\'s practical agent-loop library and Loopy skill, with checks and stopping conditions. Good Work-layer inspiration; phewsh links to it without becoming a scheduler or runner.',
+    source: 'signals.forwardfuture.com/loop-library · github.com/Forward-Future/loop-library',
     license: 'MIT',
-    install: 'npx skills add Forward-Future/loop-library --skill loop-library -g   # install through upstream skills tooling',
+    install: 'npx skills add Forward-Future/loop-library --skill loopy -g   # install Loopy through upstream skills tooling',
   },
   'matt-skills': {
     kind: 'linked',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phewsh",
-  "version": "0.15.73",
+  "version": "0.15.75",
   "description": "Turn intent into action. Structure your thinking, execute your next step.",
   "bin": {
     "phewsh": "bin/phewsh.js"