wayfind 2.0.28 → 2.0.30

package/bin/team-context.js

@@ -16,44 +16,7 @@ if (!HOME) {
 
 const WAYFIND_DIR = process.env.WAYFIND_DIR || path.join(HOME, '.claude', 'team-context');
 
-// --- Env var migration shim (v2.0.0) ---
-// Honor old MERIDIAN_* env vars with deprecation warning. Remove in v3.0.
-const ENV_VAR_MIGRATION = {
-  MERIDIAN_TELEMETRY: 'TEAM_CONTEXT_TELEMETRY',
-  MERIDIAN_AUTHOR: 'TEAM_CONTEXT_AUTHOR',
-  MERIDIAN_TENANT_ID: 'TEAM_CONTEXT_TENANT_ID',
-  MERIDIAN_TEAM_CONTEXT_DIR: 'TEAM_CONTEXT_DIR',
-  MERIDIAN_JOURNALS_DIR: 'TEAM_CONTEXT_JOURNALS_DIR',
-  MERIDIAN_SIGNALS_DIR: 'TEAM_CONTEXT_SIGNALS_DIR',
-  MERIDIAN_SKIP_EXPORT: 'TEAM_CONTEXT_SKIP_EXPORT',
-  MERIDIAN_EXCLUDE_REPOS: 'TEAM_CONTEXT_EXCLUDE_REPOS',
-  MERIDIAN_SLACK_WEBHOOK: 'TEAM_CONTEXT_SLACK_WEBHOOK',
-  MERIDIAN_LLM_MODEL: 'TEAM_CONTEXT_LLM_MODEL',
-  MERIDIAN_DIGEST_SCHEDULE: 'TEAM_CONTEXT_DIGEST_SCHEDULE',
-  MERIDIAN_SIGNAL_SCHEDULE: 'TEAM_CONTEXT_SIGNAL_SCHEDULE',
-  MERIDIAN_STORAGE_BACKEND: 'TEAM_CONTEXT_STORAGE_BACKEND',
-  MERIDIAN_MODE: 'TEAM_CONTEXT_MODE',
-  MERIDIAN_REINDEX_SCHEDULE: 'TEAM_CONTEXT_REINDEX_SCHEDULE',
-  MERIDIAN_ENCRYPTION_KEY: 'TEAM_CONTEXT_ENCRYPTION_KEY',
-  MERIDIAN_SIMULATE: 'TEAM_CONTEXT_SIMULATE',
-  MERIDIAN_SIM_FIXTURES: 'TEAM_CONTEXT_SIM_FIXTURES',
-  MERIDIAN_VERSION: 'TEAM_CONTEXT_VERSION',
-};
-for (const [oldKey, newKey] of Object.entries(ENV_VAR_MIGRATION)) {
-  if (process.env[oldKey] && !process.env[newKey]) {
-    process.env[newKey] = process.env[oldKey];
-    if (!process.env.TEAM_CONTEXT_SKIP_EXPORT) {
-      console.warn(`⚠ ${oldKey} is deprecated — rename to ${newKey}`);
-    }
-  }
-}
-
-// Also migrate config directory: if old ~/.claude/meridian/ exists but new doesn't, use old
-const OLD_DIR = path.join(HOME, '.claude', 'meridian');
-const EFFECTIVE_DIR = (fs.existsSync(WAYFIND_DIR) || !fs.existsSync(OLD_DIR)) ? WAYFIND_DIR : OLD_DIR;
-if (EFFECTIVE_DIR === OLD_DIR) {
-  console.warn('⚠ ~/.claude/meridian/ detected — rename to ~/.claude/team-context/');
-}
+const EFFECTIVE_DIR = WAYFIND_DIR;
 
 // Auto-load .env from config dir BEFORE requiring modules
 // (modules like content-store read env vars at load time)
@@ -718,6 +681,14 @@ async function runPull(args) {
       writeConnectorsConfig(freshConfig);
       printPullResult(name, result);
     }
+    // Auto-index signals into content store after pull
+    try {
+      console.log('\nIndexing signals...');
+      const signalStats = await contentStore.indexSignals({ embeddings: false });
+      console.log(`  ${signalStats.newEntries} new, ${signalStats.updatedEntries} updated, ${signalStats.skippedEntries} unchanged`);
+    } catch (err) {
+      console.log(`  Signal indexing skipped: ${err.message}`);
+    }
     return;
   }
 
@@ -827,6 +798,14 @@ async function runPull(args) {
   writeConnectorsConfig(freshConfig);
 
   printPullResult(channel, result);
+
+  // Auto-index signals into content store after pull
+  try {
+    const signalStats = await contentStore.indexSignals({ embeddings: false });
+    console.log(`\nSignals indexed: ${signalStats.newEntries} new, ${signalStats.updatedEntries} updated`);
+  } catch (err) {
+    console.log(`Signal indexing skipped: ${err.message}`);
+  }
 }
 
 function runSignals() {
@@ -928,6 +907,7 @@ async function runDigest(args) {
   const personaIdx = args.indexOf('--persona');
   const sinceIdx = args.indexOf('--since');
   const deliver = args.includes('--deliver');
+  const preview = args.includes('--preview');
 
   // Determine personas
   let personaIds;
@@ -981,6 +961,32 @@ async function runDigest(args) {
   });
 
   console.log('');
+
+  if (preview) {
+    // Preview mode: print digest content and stats to stdout
+    console.log('=== DIGEST PREVIEW ===');
+    console.log('');
+    if (result.inputStats) {
+      const s = result.inputStats;
+      console.log(`Input: ${s.journalEntries || 0} journal, ${s.signalEntries || 0} signal entries`);
+      if (s.budgetStats) {
+        console.log(`Budget: ${s.budgetStats.kept || 0} kept, ${s.budgetStats.dropped || 0} dropped`);
+      }
+      console.log('');
+    }
+    for (const f of result.files) {
+      try {
+        const content = fs.readFileSync(f, 'utf8');
+        const personaId = path.basename(path.dirname(f)) || 'combined';
+        console.log(`--- ${personaId} ---`);
+        console.log(content);
+        console.log('');
+      } catch { /* skip unreadable */ }
+    }
+    console.log('=== END PREVIEW ===');
+    return;
+  }
+
   console.log('Digests generated:');
   for (const f of result.files) {
     console.log(`  ${f}`);
@@ -1172,6 +1178,20 @@ async function runReindex(args) {
   const signalsOnly = args.includes('--signals-only');
   const doExport = args.includes('--export');
   const detectShifts = args.includes('--detect-shifts');
+  const force = args.includes('--force');
+
+  if (force) {
+    console.log('Force mode: clearing content store for full reindex...');
+    try {
+      const backend = contentStore.getBackend();
+      const emptyIndex = { version: contentStore.INDEX_VERSION, entries: {}, lastUpdated: Date.now(), entryCount: 0 };
+      backend.saveIndex(emptyIndex);
+      // Clear conversation fingerprint cache so all transcripts are re-extracted
+      backend.saveConversationIndex({});
+    } catch (err) {
+      console.log(`  Warning: could not clear store: ${err.message}`);
+    }
+  }
 
   if (!conversationsOnly && !signalsOnly) {
     console.log('=== Journals ===');
@@ -1192,6 +1212,44 @@ async function runReindex(args) {
     console.log('=== Signals ===');
     await indexSignalsIfAvailable();
   }
+
+  // Optional: run distillation after reindex
+  if (args.includes('--distill')) {
+    console.log('');
+    console.log('=== Distillation ===');
+    await runDistill(['--tier', 'daily']);
+  }
+}
+
+async function runDistill(args) {
+  const distill = require('./distill');
+  const dryRun = args.includes('--dry-run');
+  const tierIdx = args.indexOf('--tier');
+  const tier = (tierIdx !== -1 && args[tierIdx + 1]) ? args[tierIdx + 1] : 'daily';
+
+  console.log(`Distilling content (tier: ${tier}${dryRun ? ', dry run' : ''})...`);
+
+  // Build LLM config from connectors
+  let llmConfig = null;
+  if (!dryRun) {
+    const config = readConnectorsConfig();
+    if (config.digest && config.digest.llm) {
+      llmConfig = {
+        provider: config.digest.llm.provider,
+        model: config.digest.llm.intelligence?.model || 'claude-haiku-4-5-20251001',
+        api_key_env: config.digest.llm.api_key_env,
+      };
+    }
+  }
+
+  const stats = await distill.distillEntries({ tier, dryRun, llmConfig });
+
+  console.log('');
+  console.log('Distillation results:');
+  console.log(`  Groups: ${stats.grouped}`);
+  console.log(`  Deduped: ${stats.deduped}`);
+  console.log(`  Merged: ${stats.merged}`);
+  console.log(`  LLM calls: ${stats.llmCalls}`);
 }
 
 /**
@@ -2789,7 +2847,7 @@ function runMigrateToPlugin(args) {
   }
 
   // Step 3: Remove old command files (plugin skills replace these)
-  const oldCommandFiles = ['init-memory.md', 'init-team.md', 'doctor.md', 'journal.md', 'standup.md', 'review-prs.md'];
+  const oldCommandFiles = ['init-memory.md', 'init-team.md', 'init-folder.md', 'doctor.md', 'journal.md', 'standup.md', 'review-prs.md'];
   for (const file of oldCommandFiles) {
     const cmdPath = path.join(commandsDir, file);
     if (fs.existsSync(cmdPath)) {
@@ -4736,6 +4794,10 @@ const COMMANDS = {
     desc: 'Index all signal sources (journals + conversations)',
     run: (args) => runReindex(args),
   },
+  distill: {
+    desc: 'Distill content store: dedup, merge, and compact entries',
+    run: (args) => runDistill(args),
+  },
   'index-journals': {
     desc: 'Index journal entries into the content store',
     run: (args) => runIndexJournals(args),
@@ -4748,6 +4810,10 @@ const COMMANDS = {
     desc: 'Search indexed entries (journals + conversations, semantic or full-text)',
     run: (args) => runSearchJournals(args),
   },
+  'memory-compare': {
+    desc: 'Compare Claude Code auto-memory vs Wayfind memory systems',
+    run: () => require('./memory-compare').compare(),
+  },
   insights: {
     desc: 'Show insights from indexed journal data',
     run: (args) => runInsights(args),
@@ -4966,6 +5032,7 @@ function showHelp() {
   console.log('');
   console.log('In a Claude Code session:');
   console.log('  /init-memory                   Set up memory for current repo');
+  console.log('  /init-folder                   Set up memory for a non-repo folder');
   console.log('  /init-team                     Set up team context (journals, digests, Notion)');
   console.log('  /journal                       View your session journal digest');
   console.log('  /doctor                        Check installation health');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wayfind",
-  "version": "2.0.28",
+  "version": "2.0.30",
   "description": "Team decision trail for AI-assisted development. The connective tissue between product, engineering, and strategy.",
   "bin": {
     "wayfind": "./bin/team-context.js"

package/plugin/scripts/session-end.sh

@@ -11,7 +11,7 @@ set -euo pipefail
 # Skip export for worker agents in multi-agent swarms.
 # Set TEAM_CONTEXT_SKIP_EXPORT=1 when spawning worker agents so only the
 # orchestrator's decisions flow into the journal.
-if [ "${TEAM_CONTEXT_SKIP_EXPORT:-${MERIDIAN_SKIP_EXPORT:-}}" = "1" ]; then
+if [ "${TEAM_CONTEXT_SKIP_EXPORT:-}" = "1" ]; then
   exit 0
 fi
 

package/plugin/skills/init-folder/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: init-folder
+description: Initialize Wayfind for a non-repo folder (e.g., ~/admin, ~/). Creates .claude/personal-state.md, defensively updates .gitignore if one exists, and registers the folder in the global index. Safe to run multiple times (idempotent).
+user-invocable: true
+---
+
+# Initialize Wayfind for a Non-Repo Folder
+
+Run these steps in order. Skip any step that's already done (this command is idempotent).
+
+This command is for **non-repo working directories** — your home directory, an admin folder,
+a scratch workspace, etc. For git repos, use `/wayfind:init-memory` instead.
+
+## Step 1: Detect Context
+
+- Determine the current working directory (or ask the user which folder to initialize)
+- Check if it's a git repo (`git rev-parse --show-toplevel 2>/dev/null`)
+  - If it IS a git repo, suggest: "This looks like a git repo. Did you mean to run `/wayfind:init-memory` instead? That sets up team-state.md for shared context too."
+  - If the user confirms they want init-folder anyway, proceed.
+- Read `~/.claude/global-state.md` to check if this folder is already registered
+
+## Step 2: Create personal state file (if missing)
+
+Non-repo folders only get **one** state file — there's no team-state.md because there's
+no git repo to commit it to.
+
+If `.claude/personal-state.md` does not exist, create it:
+
+```markdown
+# [Folder Name] — Personal State
+
+Last updated: [today's date]
+
+(This file is local-only. It persists context across AI sessions in this folder.)
+
+## My Current Focus
+<!-- Your current tasks and next steps for work in this folder -->
+
+## Personal Context
+<!-- Working notes, decisions, things to remember -->
+
+## What I'm Watching
+<!-- Open questions, things to follow up on -->
+```
+
+Create the `.claude/` directory first if it doesn't exist.
+
+## Step 3: Defensive .gitignore update
+
+Check if a `.gitignore` file exists in the folder root.
+
+**If `.gitignore` exists:** Ensure `.claude/` is listed (the whole directory — unlike repos,
+non-repo folders have no team-state.md to preserve). If it's missing, append it.
+
+**If `.gitignore` does not exist:** Skip this step. Don't create one — this isn't a repo.
+
+## Step 4: Check CLAUDE.md
+
+Read the folder's `CLAUDE.md` (if it exists).
+
+**If it exists and does NOT contain "Session State Protocol":** Note to the user:
+"Your `~/CLAUDE.md` (or global instructions) should include the session protocol.
+If you're using Wayfind's standard `~/CLAUDE.md`, you're already covered."
+
+**If it exists and DOES contain "Session State Protocol":** Skip — already configured.
+
+**If it does not exist:** Do NOT create one. Note: "No CLAUDE.md in this folder.
+Your `~/CLAUDE.md` global instructions handle the session protocol."
+
+## Step 5: Register in Global Index
+
+Read `~/.claude/global-state.md`. Add the folder's state file to the State Files table
+if missing:
+
+```
+| `[full path]/.claude/personal-state.md` | Personal context for [folder name] (non-repo) |
+```
+
+The Active Projects table is auto-generated by `wayfind status --write` — do NOT add
+rows to it manually.
+
+## Step 6: Report
+
+Tell the user:
+- `.claude/personal-state.md` — created or already existed (local only)
+- `.gitignore` — updated or not applicable
+- `global-state.md` — folder registered or already listed
+
+Then print:
+
+**"This folder is now tracked by Wayfind. Context saved here will be available in future
+sessions. For cross-repo context that should be available everywhere, save to
+`~/.claude/memory/` instead."**

package/plugin/skills/init-team/SKILL.md

@@ -87,6 +87,14 @@ Create them if missing. If `prompts/` is new, add the README from `templates/pro
 
 Store the team context repo path for later steps.
 
+## Step 1a: Non-Repo Folder Setup (Optional)
+
+After the team context repo is set up, ask:
+
+**"Do you have a non-repo folder you use for admin or cross-cutting work? (e.g., your home directory) We can set that up too so context from those sessions is preserved."**
+
+If yes, run `/wayfind:init-folder` in that directory (or guide them to run it later).
+
 ## Step 2: Slack Integration
 
 Ask: **"Do you want weekly digests posted to Slack? You'll need a Slack Incoming Webhook URL. If you have one, paste it. If not, I can walk you through creating one."**

package/plugin/skills/session-protocol/SKILL.md

@@ -35,4 +35,6 @@ the plugin's hooks. This skill tells you where state files live so you can load
 - Keep `global-state.md` under 80 lines. Detail goes in `~/.claude/memory/` files.
 - Per-repo state files stay focused on that repo only.
 - New cross-repo topics get new files in `~/.claude/memory/`, not appended to global-state.md.
+- **NEVER write secrets, API keys, tokens, or credentials into memory or state files.** Store pointers to where secrets live, not the secrets themselves.
+- Do NOT write Wayfind files to `~/.claude/projects/<project>/memory/` root — that's Claude Code's native auto-memory space.
 - Do NOT use external memory databases or CLI tools for state storage. Use plain markdown files only.

package/specializations/claude-code/CLAUDE.md-global-fragment.md

@@ -3,15 +3,17 @@
 
 **Memory system:** Hierarchical plain-markdown files. No CLI tools, no databases.
 
+**Important:** Claude Code has its own auto-memory system that writes to `~/.claude/projects/<project>/memory/MEMORY.md`. Wayfind's memory files live in a separate `wayfind/` subfolder to avoid conflicts. Do NOT write Wayfind state files to the root memory directory — that's Claude Code's native auto-memory space.
+
 ### File Hierarchy
 
 ```
 ~/.claude/
   global-state.md          # Thin index — ALWAYS load at session start
   state.md                 # Admin/non-repo work
-  memory/                  # Topic files — load on demand
+  memory/                  # Cross-repo topic files — load on demand
     <topic>.md
-    journal/YYYY-MM-DD.md  # Daily log
+    journal/YYYY-MM-DD.md  # Daily work log
 
 <repo>/.claude/
   team-state.md            # Shared team context — committed to git
@@ -47,7 +49,9 @@ If work drifts from the stated goal, flag it: *"Quick check — we set out to [g
 
 ### Rules
 
+- **NEVER write secrets, API keys, tokens, passwords, or credentials into memory or state files.** Store a pointer to where the secret lives (e.g., "API key is in `~/.config/myapp/.env`"), not the secret itself. Memory files are plain text, may be synced to git, and are readable by any tool with filesystem access.
 - Keep `global-state.md` under 80 lines. Detail goes in `~/.claude/memory/` files.
 - Per-repo `state.md` stays focused on that repo only.
 - New cross-repo topics get new files in `~/.claude/memory/`, not appended to global-state.md.
+- Do NOT write Wayfind files to `~/.claude/projects/<project>/memory/` root — that's Claude Code's native auto-memory space.
 - Do NOT use external memory databases or CLI tools for state storage. Use plain markdown files only.

package/specializations/claude-code/CLAUDE.md-repo-fragment.md

@@ -13,4 +13,6 @@
 3. Do NOT update `~/.claude/global-state.md` — its Active Projects table is rebuilt automatically by `wayfind status`.
 4. If significant new cross-repo context was created (patterns, strategies, decisions), create or update a file in `~/.claude/memory/` and add it to the Memory Files manifest in global-state.md
 
+**NEVER write secrets, API keys, tokens, or credentials into memory or state files.** Store pointers to where secrets live, not the secrets themselves.
+**Do NOT write Wayfind files to `~/.claude/projects/<project>/memory/` root** — that's Claude Code's native auto-memory space.
 **Do NOT use external memory databases or CLI tools for state storage.** Use plain markdown files only.

package/specializations/claude-code/commands/init-folder.md

@@ -0,0 +1,91 @@
+---
+description: Initialize Wayfind for a non-repo folder (e.g., ~/admin, ~/). Creates .claude/personal-state.md, defensively updates .gitignore if one exists, and registers the folder in the global index. Safe to run multiple times (idempotent).
+---
+
+# Initialize Wayfind for a Non-Repo Folder
+
+Run these steps in order. Skip any step that's already done (this command is idempotent).
+
+This command is for **non-repo working directories** — your home directory, an admin folder,
+a scratch workspace, etc. For git repos, use `/init-memory` instead.
+
+## Step 1: Detect Context
+
+- Determine the current working directory (or ask the user which folder to initialize)
+- Check if it's a git repo (`git rev-parse --show-toplevel 2>/dev/null`)
+  - If it IS a git repo, suggest: "This looks like a git repo. Did you mean to run `/init-memory` instead? That sets up team-state.md for shared context too."
+  - If the user confirms they want init-folder anyway, proceed.
+- Read `~/.claude/global-state.md` to check if this folder is already registered
+
+## Step 2: Create personal state file (if missing)
+
+Non-repo folders only get **one** state file — there's no team-state.md because there's
+no git repo to commit it to.
+
+If `.claude/personal-state.md` does not exist, create it:
+
+```markdown
+# [Folder Name] — Personal State
+
+Last updated: [today's date]
+
+(This file is local-only. It persists context across AI sessions in this folder.)
+
+## My Current Focus
+<!-- Your current tasks and next steps for work in this folder -->
+
+## Personal Context
+<!-- Working notes, decisions, things to remember -->
+
+## What I'm Watching
+<!-- Open questions, things to follow up on -->
+```
+
+Create the `.claude/` directory first if it doesn't exist.
+
+## Step 3: Defensive .gitignore update
+
+Check if a `.gitignore` file exists in the folder root.
+
+**If `.gitignore` exists:** Ensure `.claude/` is listed (the whole directory — unlike repos,
+non-repo folders have no team-state.md to preserve). If it's missing, append it.
+
+**If `.gitignore` does not exist:** Skip this step. Don't create one — this isn't a repo.
+
+## Step 4: Check CLAUDE.md
+
+Read the folder's `CLAUDE.md` (if it exists).
+
+**If it exists and does NOT contain "Session State Protocol":** Note to the user:
+"Your `~/CLAUDE.md` (or global instructions) should include the session protocol.
+If you're using Wayfind's standard `~/CLAUDE.md`, you're already covered."
+
+**If it exists and DOES contain "Session State Protocol":** Skip — already configured.
+
+**If it does not exist:** Do NOT create one. Note: "No CLAUDE.md in this folder.
+Your `~/CLAUDE.md` global instructions handle the session protocol."
+
+## Step 5: Register in Global Index
+
+Read `~/.claude/global-state.md`. Add the folder's state file to the State Files table
+if missing:
+
+```
+| `[full path]/.claude/personal-state.md` | Personal context for [folder name] (non-repo) |
+```
+
+The Active Projects table is auto-generated by `wayfind status --write` — do NOT add
+rows to it manually.
+
+## Step 6: Report
+
+Tell the user:
+- `.claude/personal-state.md` — created or already existed (local only)
+- `.gitignore` — updated or not applicable
+- `global-state.md` — folder registered or already listed
+
+Then print:
+
+**"This folder is now tracked by Wayfind. Context saved here will be available in future
+sessions. For cross-repo context that should be available everywhere, save to
+`~/.claude/memory/` instead."**

package/specializations/claude-code/commands/init-team.md

@@ -142,6 +142,14 @@ Create `~/.claude/memory/wayfind-team-context.md` with:
 - <list of usernames with journal directories>
 ```
 
+## Step 1a: Non-Repo Folder Setup (Optional)
+
+After the team context repo is set up, ask:
+
+**"Do you have a non-repo folder you use for admin or cross-cutting work? (e.g., your home directory) We can set that up too so context from those sessions is preserved."**
+
+If yes, run `/init-folder` in that directory (or guide them to run it later).
+
 ## Step 1b: Link and Distribute Context
 
 Once the team context repo exists, link it so Wayfind knows where to find shared

package/specializations/claude-code/hooks/session-end.sh

@@ -11,7 +11,7 @@ set -euo pipefail
 # Skip export for worker agents in multi-agent swarms.
 # Set TEAM_CONTEXT_SKIP_EXPORT=1 when spawning worker agents so only the
 # orchestrator's decisions flow into the journal.
-if [ "${TEAM_CONTEXT_SKIP_EXPORT:-${MERIDIAN_SKIP_EXPORT:-}}" = "1" ]; then
+if [ "${TEAM_CONTEXT_SKIP_EXPORT:-}" = "1" ]; then
   exit 0
 fi