@tekmidian/pai 0.8.0 → 0.8.2

package/dist/hooks/whisper-rules.mjs

@@ -13,11 +13,7 @@ function getWhisperRules() {
     } catch {
     }
   }
-  return [
-    "NEVER suggest pausing, stopping, or ending the session. The user decides when to stop. Not you. Ever.",
-    "NEVER send emails. Always create drafts. No exceptions.",
-    "NEVER add Co-Authored-By or AI attribution to git commits."
-  ].join("\n");
+  return "";
 }
 function main() {
   const rules = getWhisperRules();

package/dist/hooks/whisper-rules.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/hooks/ts/user-prompt/whisper-rules.ts"],
-  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * whisper-rules.ts\n *\n * UserPromptSubmit hook that injects critical non-negotiable rules into every\n * prompt as a <system-reminder>. This ensures rules survive compaction \u2014 even\n * if CLAUDE.md content is lost during context compression, the whisper\n * re-injects the absolute rules on every single turn.\n *\n * Inspired by Letta's \"claude-subconscious\" whisper pattern.\n *\n * Rules are loaded from ~/.claude/whisper-rules.md if it exists,\n * otherwise falls back to hardcoded critical rules.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\n\nconst WHISPER_FILE = join(homedir(), \".claude\", \"whisper-rules.md\");\n\nfunction getWhisperRules(): string {\n  // User-customizable whisper file takes priority\n  if (existsSync(WHISPER_FILE)) {\n    try {\n      const content = readFileSync(WHISPER_FILE, \"utf-8\").trim();\n      if (content) return content;\n    } catch { /* fall through to defaults */ }\n  }\n\n  // Hardcoded critical rules \u2014 the ones that keep getting violated\n  return [\n    \"NEVER suggest pausing, stopping, or ending the session. The user decides when to stop. Not you. Ever.\",\n    \"NEVER send emails. Always create drafts. No exceptions.\",\n    \"NEVER add Co-Authored-By or AI attribution to git commits.\",\n  ].join(\"\\n\");\n}\n\nfunction main() {\n  const rules = getWhisperRules();\n  if (!rules) return;\n\n  // Output as system-reminder \u2014 Claude Code injects this into the conversation\n  console.log(`<system-reminder>\n${rules}\n</system-reminder>`);\n}\n\nmain();\n"],
-  "mappings": ";;;AAgBA,SAAS,YAAY,oBAAoB;AACzC,SAAS,YAAY;AACrB,SAAS,eAAe;AAExB,IAAM,eAAe,KAAK,QAAQ,GAAG,WAAW,kBAAkB;AAElE,SAAS,kBAA0B;AAEjC,MAAI,WAAW,YAAY,GAAG;AAC5B,QAAI;AACF,YAAM,UAAU,aAAa,cAAc,OAAO,EAAE,KAAK;AACzD,UAAI,QAAS,QAAO;AAAA,IACtB,QAAQ;AAAA,IAAiC;AAAA,EAC3C;AAGA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,OAAO;AACd,QAAM,QAAQ,gBAAgB;AAC9B,MAAI,CAAC,MAAO;AAGZ,UAAQ,IAAI;AAAA,EACZ,KAAK;AAAA,mBACY;AACnB;AAEA,KAAK;",
+  "sourcesContent": ["#!/usr/bin/env node\n\n/**\n * whisper-rules.ts\n *\n * UserPromptSubmit hook that injects critical non-negotiable rules into every\n * prompt as a <system-reminder>. This ensures rules survive compaction \u2014 even\n * if CLAUDE.md content is lost during context compression, the whisper\n * re-injects the absolute rules on every single turn.\n *\n * Inspired by Letta's \"claude-subconscious\" whisper pattern.\n *\n * Rules are loaded from ~/.claude/whisper-rules.md if it exists,\n * otherwise falls back to hardcoded critical rules.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { homedir } from \"node:os\";\n\nconst WHISPER_FILE = join(homedir(), \".claude\", \"whisper-rules.md\");\n\nfunction getWhisperRules(): string {\n  // User-managed whisper file \u2014 PAI provides the hook, user provides the rules\n  // Configure via /whisper skill or edit ~/.claude/whisper-rules.md directly\n  if (existsSync(WHISPER_FILE)) {\n    try {\n      const content = readFileSync(WHISPER_FILE, \"utf-8\").trim();\n      if (content) return content;\n    } catch { /* ignore read errors */ }\n  }\n\n  // No rules configured \u2014 silent (no injection)\n  return \"\";\n}\n\nfunction main() {\n  const rules = getWhisperRules();\n  if (!rules) return;\n\n  // Output as system-reminder \u2014 Claude Code injects this into the conversation\n  console.log(`<system-reminder>\n${rules}\n</system-reminder>`);\n}\n\nmain();\n"],
+  "mappings": ";;;AAgBA,SAAS,YAAY,oBAAoB;AACzC,SAAS,YAAY;AACrB,SAAS,eAAe;AAExB,IAAM,eAAe,KAAK,QAAQ,GAAG,WAAW,kBAAkB;AAElE,SAAS,kBAA0B;AAGjC,MAAI,WAAW,YAAY,GAAG;AAC5B,QAAI;AACF,YAAM,UAAU,aAAa,cAAc,OAAO,EAAE,KAAK;AACzD,UAAI,QAAS,QAAO;AAAA,IACtB,QAAQ;AAAA,IAA2B;AAAA,EACrC;AAGA,SAAO;AACT;AAEA,SAAS,OAAO;AACd,QAAM,QAAQ,gBAAgB;AAC9B,MAAI,CAAC,MAAO;AAGZ,UAAQ,IAAI;AAAA,EACZ,KAAK;AAAA,mBACY;AACnB;AAEA,KAAK;",
   "names": []
 }

package/dist/skills/Whisper/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: Whisper
+description: "Manage whisper rules — persistent behavioral constraints injected on every prompt. USE WHEN user says 'whisper', 'add whisper rule', 'remove whisper rule', 'list whisper rules', 'show whisper rules', '/whisper', OR wants to manage persistent behavioral rules."
+---
+
+## Whisper Rules Management
+
+USE WHEN user says 'whisper', 'add whisper rule', 'remove whisper rule', 'list whisper rules', 'show whisper rules', '/whisper', OR wants to manage persistent behavioral rules.
+
+Manage the rules that PAI injects into every prompt via the whisper-rules hook.
+
+Rules are stored in `~/.claude/whisper-rules.md` — one rule per line, plain text.
+The hook reads this file on every UserPromptSubmit and injects it as a `<system-reminder>`.
+Rules survive compaction, /clear, and session restarts.
+
+### Usage
+
+- `/whisper` — show current rules
+- `/whisper add <rule>` — add a new rule
+- `/whisper remove <number>` — remove rule by line number
+- `/whisper list` — list rules with line numbers
+- `/whisper clear` — remove all rules (with confirmation)
+
+### Workflow
+
+**Show current rules:**
+Read `~/.claude/whisper-rules.md` and display each rule with a line number.
+If the file doesn't exist, say "No whisper rules configured."
+
+**Add a rule:**
+Append the rule as a new line to `~/.claude/whisper-rules.md`.
+Create the file if it doesn't exist.
+Do NOT add duplicate rules — check if a similar rule already exists.
+
+**Remove a rule:**
+Read the file, remove the line at the given number, write the file back.
+Show the removed rule for confirmation.
+
+**Clear all rules:**
+Ask for confirmation first ("This will remove all N rules. Confirm?").
+Only proceed if the user explicitly confirms.
+
+### Important
+
+- Rules should be short, imperative statements (1-2 lines max)
+- Every rule is injected on EVERY prompt — keep the list focused on truly critical rules
+- Too many rules dilute their effectiveness and waste tokens
+- The file does not exist by default — PAI ships the hook, the user adds their own rules
+- Rules are global (shared across all sessions and projects)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekmidian/pai",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "PAI Knowledge OS — Personal AI Infrastructure with federated memory and project management",
   "type": "module",
   "main": "dist/index.mjs",

package/src/hooks/ts/user-prompt/whisper-rules.ts

@@ -21,20 +21,17 @@ import { homedir } from "node:os";
 const WHISPER_FILE = join(homedir(), ".claude", "whisper-rules.md");
 
 function getWhisperRules(): string {
-  // User-customizable whisper file takes priority
+  // User-managed whisper file — PAI provides the hook, user provides the rules
+  // Configure via /whisper skill or edit ~/.claude/whisper-rules.md directly
   if (existsSync(WHISPER_FILE)) {
     try {
       const content = readFileSync(WHISPER_FILE, "utf-8").trim();
       if (content) return content;
-    } catch { /* fall through to defaults */ }
+    } catch { /* ignore read errors */ }
   }
 
-  // Hardcoded critical rules — the ones that keep getting violated
-  return [
-    "NEVER suggest pausing, stopping, or ending the session. The user decides when to stop. Not you. Ever.",
-    "NEVER send emails. Always create drafts. No exceptions.",
-    "NEVER add Co-Authored-By or AI attribution to git commits.",
-  ].join("\n");
+  // No rules configured — silent (no injection)
+  return "";
 }
 
 function main() {