phewsh 0.15.34 → 0.15.35

package/commands/hook.js

@@ -111,6 +111,28 @@ function sessionStart() {
   const cont = continuityBrief(path.basename(process.cwd()));
   if (cont) parts.push(`\n## Continuity (across your tools)\n${cont}`);
 
+  // Drift nudge (read-only): if code moved ahead of .intent/, say so — right
+  // here, where the agent will see it — so the human knows *when* to reconcile.
+  // We never auto-rewrite their source of truth; we just make the gap visible.
+  try {
+    const { statusDrift } = require('../lib/truth');
+    const drift = statusDrift(process.cwd());
+    if (drift && drift.tracked && drift.commitsSince > 0) {
+      parts.push(`\n## ⚠ phewsh drift\n.intent/ is ${drift.commitsSince} commit(s) behind the code (since ${drift.lastCommit}) — its current-state claims may be stale. Good moment to reconcile so every tool inherits today's reality.`);
+    }
+  } catch { /* drift is a nicety; never break the host */ }
+
+  // Ambient operating guidance: make phewsh *felt*, not invoked. The human may
+  // not know a single slash command — translate intent into phewsh actions for
+  // them, nudge gently, and leave a quiet signature so they feel the layer.
+  parts.push(`\n## Working with phewsh installed (ambient guidance)
+phewsh keeps this project's intent, decisions, and outcomes aligned across every AI tool — so nothing is lost when the human switches tools. Help it work *for* them without making them learn it:
+- Do their actual request first, and well.
+- When you make a real decision, ship something, or change direction, offer in plain language to keep the shared record current — e.g. "want me to reconcile this into phewsh so your other tools inherit it?" Never make them memorize slash commands; map their intent to phewsh actions yourself.
+- If the drift note above is present, mention it once, gently.
+- Keep nudges subtle and occasional — never nag, never block the work.
+- When phewsh context shaped your reply, sign off quietly with 😮‍💨🤫 (e.g. "— 😮‍💨🤫") so the human feels the continuity layer working in the background.`);
+
   parts.push(`\n(Brief injected by PHEWSH ambient from .intent/. Honor the constraints above. The human can run \`phewsh\` for mission control — council, outcomes, the decision record.)`);
 
   process.stdout.write(parts.join('\n') + '\n');

package/commands/session.js

@@ -2422,7 +2422,7 @@ async function main() {
         const preflightTruth = await auditTruth();
         const before = captureSnapshot(preflightTruth);
         const generatedBrief = await generateBrief({ report: preflightTruth });
-        const launchBrief = `${generatedBrief.content}\n\nYou are receiving a PHEWSH handoff brief — acknowledge in one short line that you've loaded it, then proceed. Use it as project context, preserve native tool behavior, and verify claims against the repository before acting. When you finish, exit this tool — PHEWSH resumes, runs an automatic postflight comparing what changed against this brief, and offers reconciliation.`;
+        const launchBrief = `${generatedBrief.content}\n\nYou are receiving a PHEWSH handoff brief — acknowledge in one short line that you've loaded it, then proceed. Use it as project context, preserve native tool behavior, and verify claims against the repository before acting. When you finish, exit this tool — PHEWSH resumes, runs an automatic postflight comparing what changed against this brief, and offers reconciliation.\n\nAmbient guidance: the human may not know any phewsh commands — make the layer felt, not invoked. Do their request first; when you make a real decision, ship something, or change direction, offer in plain language to keep the shared record current ("want me to reconcile this into phewsh so your other tools inherit it?"). Keep it subtle, never nag. When phewsh context shaped your reply, sign off quietly with 😮‍💨🤫 so they feel the continuity layer working.`;
         const savedBrief = persistBrief(generatedBrief.content, { project: projectName, route: target });
         const launch = interactiveLaunchArgs(target, launchBrief, { model: harnessModel });
         // Foolproof fallback: the brief on the clipboard survives the native

package/package.json

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