phewsh 0.15.50 → 0.15.52

package/bin/phewsh.js

@@ -149,7 +149,7 @@ function showHelp() {
   console.log(`  ${b(w('configure'))}`);
   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 to the latest version')}`);
+  console.log(`    ${cyan('update')}     ${g('Update phewsh — or `phewsh update auto on` to stay current automatically')}`);
   console.log('');
   console.log(`  ${g('Works in: Claude Code · Cursor · ChatGPT · any MCP agent')}`);
   console.log(`  ${g('No account needed. Account adds sync + sharing.')}`);

package/commands/session.js

@@ -939,7 +939,7 @@ async function main() {
     'sync', 'harnesses', 'fallback', 'outcomes', 'tour', 'update', 'upgrade',
     'agents', 'context', 'truth', 'brief', 'wrap', 'reconcile', 'gate', 'reload', 'sequence', 'seq', 'setup', 'system', 'watch',
     'next', 'recommend', 'guide', 'thread', 'continuity', 'learn', 'stats',
-    'pack', 'packs', 'remember',
+    'pack', 'packs', 'remember', 'commands',
   ]);
   const installedIds = harnesses.filter(h => h.installed).map(h => h.id);
   let turnAbort = null;       // AbortController while an API turn streams
@@ -1533,8 +1533,8 @@ async function main() {
         return;
       }
 
-      if (cmd === 'help' || cmd === 'h') {
-        const wantsAll = /^(all|more|full|everything)$/i.test(cmdArg.trim());
+      if (cmd === 'help' || cmd === 'h' || cmd === 'commands') {
+        const wantsAll = cmd === 'commands' || /^(all|more|full|everything)$/i.test(cmdArg.trim());
 
         // Bare /help → the short essentials a newcomer actually needs.
         if (!wantsAll) {
@@ -1613,6 +1613,13 @@ async function main() {
         console.log(`    ${teal('/update')}      ${sage('Update phewsh')}`);
         console.log(`    ${teal('/tour')}        ${sage('Quick walkthrough')}`);
         console.log('');
+        console.log(`  ${cream('run in your terminal')} ${slate('— machine setup, run outside a session (not as /cmd)')}`);
+        console.log(`    ${teal('phewsh ambient on')}     ${sage("Every AI tool inherits your .intent/ — even without launching phewsh")}`);
+        console.log(`    ${teal('phewsh shim on')}        ${sage('A phewsh status banner before each tool launches — visible proof')}`);
+        console.log(`    ${teal('phewsh update auto on')} ${sage('Auto-update in the background on launch (default: notify-only)')}`);
+        console.log(`    ${teal('phewsh setup')}          ${sage('Guided setup — pick your default route')}`);
+        console.log(`    ${slate('also standalone:')} ${teal('phewsh status · next · work · remember')}  ${slate('· full list:')} ${teal('phewsh help')}`);
+        console.log('');
         rl.prompt();
         return;
       }

package/lib/sequencer/discover.js

@@ -42,7 +42,8 @@ function discover(cwd = process.cwd(), home = os.homedir()) {
     }
   }
 
-  // CLAUDE.md — split into manual and generated sections later by parser
+  // CLAUDE.md — the claude-md parser strips phewsh's generated block, so only
+  // the user's MANUAL content is ingested (safe, no recursion).
   const claudeMd = path.join(cwd, 'CLAUDE.md');
   if (fs.existsSync(claudeMd)) {
     add({ path: claudeMd, type: 'claude-md', name: 'CLAUDE.md', scope: 'project' });
@@ -79,25 +80,8 @@ function discover(cwd = process.cwd(), home = os.homedir()) {
     }
   }
 
-  // .cursorrules
-  const cursorrules = path.join(cwd, '.cursorrules');
-  if (fs.existsSync(cursorrules)) {
-    add({ path: cursorrules, type: 'cursor', name: '.cursorrules', scope: 'project' });
-  }
-
-  // agent.md / AGENTS.md (Codex / generic agent instructions, project scope)
-  for (const name of ['agent.md', 'AGENTS.md']) {
-    const p = path.join(cwd, name);
-    if (fs.existsSync(p)) {
-      add({ path: p, type: 'agent', name, scope: 'project' });
-    }
-  }
-
-  // GEMINI.md (project scope)
-  const geminiMd = path.join(cwd, 'GEMINI.md');
-  if (fs.existsSync(geminiMd)) {
-    add({ path: geminiMd, type: 'agent', name: 'GEMINI.md', scope: 'project' });
-  }
+  // (.cursorrules / AGENTS.md / GEMINI.md intentionally NOT read as sources —
+  // see note above: they are phewsh-managed outputs, not source truth.)
 
   // soul.md
   const soulMd = path.join(cwd, 'soul.md');

package/lib/sequencer/emitters/claude-md.js

@@ -59,11 +59,16 @@ function emit(chunks, options = {}) {
     sections.push('');
   }
 
-  // 3. State — what's happening now
+  // 3. State — what's happening now. LEAN: the latest entry only, capped — the
+  // full log lives in .intent/status.md. Architecture over prose: this block
+  // points at the source of truth, it does not become the source of truth.
   if (byKind.state?.length > 0) {
     sections.push('## Current State');
-    for (const chunk of byKind.state) {
-      sections.push(embedChunk(chunk));
+    const body = embedChunk(byKind.state[0]).split('\n').filter(l => l.trim());
+    sections.push(body.slice(0, 8).join('\n'));
+    if (body.length > 8 || byKind.state.length > 1) {
+      sections.push('');
+      sections.push('_Full state & history: `.intent/status.md` · run `phewsh status`._');
     }
     sections.push('');
   }

package/lib/sequencer/index.js

@@ -59,6 +59,14 @@ function sequence(options = {}) {
     sources = sources.filter(s => s.scope !== 'global');
   }
 
+  // A file's generated block must not restate the file's own manual content —
+  // that's circular (parallel truth). When emitting the claude-md block, drop
+  // the project CLAUDE.md source itself. The block carries .intent/-derived
+  // state and points at the source of truth; it does not echo the host file.
+  if (target === 'claude-md') {
+    sources = sources.filter(s => s.type !== 'claude-md');
+  }
+
   // Filter sources if requested
   if (sourceFilter && sourceFilter.length > 0) {
     sources = sources.filter(s =>

package/package.json

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