wayfind 2.0.29 → 2.0.31

package/bin/digest.js

@@ -755,12 +755,12 @@ async function generateDigest(config, personaIds, sinceDate, onProgress) {
     signalsDir: config.signals_dir,
   };
   const storeResult = collectFromStore(sinceDate, storeOpts);
-  if (storeResult.entryCount > 0) {
+  if (storeResult.entryCount > 0 && storeResult.journals) {
     journalContent = storeResult.journals;
     // Use store signals if available, otherwise fall back to direct file scan
     signalContent = storeResult.signals || collectSignals(sinceDate, config.signals_dir);
   } else {
-    // Fallback: direct file scan (store not indexed)
+    // Fallback: direct file scan (store not indexed or content retrieval failed)
     signalContent = collectSignals(sinceDate, config.signals_dir);
     journalContent = collectJournals(sinceDate, config.journal_dir);
   }

package/bin/distill.js

@@ -164,14 +164,13 @@ async function mergeEntries(entries, llmConfig, tier) {
   const systemPrompt = MERGE_PROMPTS[tier] || MERGE_PROMPTS.daily;
   const userContent = parts.join('\n\n---\n\n');
 
-  const result = await llm.chat({
+  const config = {
     provider: llmConfig.provider || 'anthropic',
     model: llmConfig.model || 'claude-haiku-4-5-20251001',
-    apiKeyEnv: llmConfig.api_key_env || 'ANTHROPIC_API_KEY',
-    system: systemPrompt,
-    messages: [{ role: 'user', content: userContent }],
+    api_key_env: llmConfig.api_key_env || 'ANTHROPIC_API_KEY',
     max_tokens: 2000,
-  });
+  };
+  const result = await llm.call(config, systemPrompt, userContent);
 
   // Extract title from first line or generate one
   const firstEntry = entries[0].entry;

package/bin/memory-compare.js

@@ -0,0 +1,171 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const HOME = process.env.HOME || process.env.USERPROFILE;
+
+/**
+ * Compare Claude Code auto-memory vs Wayfind global memory.
+ * Shows overlap, unique content in each, and freshness.
+ */
+function compare() {
+  const autoMemoryRoot = path.join(HOME, '.claude', 'projects');
+  const wayfindMemory = path.join(HOME, '.claude', 'memory');
+
+  // Collect auto-memory entries
+  const autoEntries = [];
+  if (fs.existsSync(autoMemoryRoot)) {
+    for (const proj of fs.readdirSync(autoMemoryRoot)) {
+      const memDir = path.join(autoMemoryRoot, proj, 'memory');
+      if (!fs.existsSync(memDir)) continue;
+      for (const file of fs.readdirSync(memDir).filter(f => f.endsWith('.md') && f !== 'MEMORY.md')) {
+        const fp = path.join(memDir, file);
+        const content = fs.readFileSync(fp, 'utf8');
+        const typeMatch = content.match(/^type:\s*(.+)$/m);
+        const descMatch = content.match(/^description:\s*(.+)$/m);
+        const stat = fs.statSync(fp);
+        autoEntries.push({
+          project: proj,
+          file,
+          type: typeMatch ? typeMatch[1].trim() : 'unknown',
+          description: descMatch ? descMatch[1].trim() : '',
+          size: content.length,
+          modified: stat.mtime,
+          daysAgo: Math.floor((Date.now() - stat.mtime) / (1000 * 60 * 60 * 24)),
+        });
+      }
+    }
+  }
+
+  // Collect Wayfind global memory entries
+  const wayfindEntries = [];
+  if (fs.existsSync(wayfindMemory)) {
+    for (const file of fs.readdirSync(wayfindMemory).filter(f => f.endsWith('.md'))) {
+      const fp = path.join(wayfindMemory, file);
+      const content = fs.readFileSync(fp, 'utf8');
+      const stat = fs.statSync(fp);
+      wayfindEntries.push({
+        file,
+        size: content.length,
+        modified: stat.mtime,
+        daysAgo: Math.floor((Date.now() - stat.mtime) / (1000 * 60 * 60 * 24)),
+      });
+    }
+  }
+
+  // Journal stats
+  const journalDir = path.join(wayfindMemory, 'journal');
+  let journalCount = 0;
+  let journalSize = 0;
+  let latestJournal = null;
+  if (fs.existsSync(journalDir)) {
+    const journals = fs.readdirSync(journalDir).filter(f => f.endsWith('.md'));
+    journalCount = journals.length;
+    for (const j of journals) {
+      const fp = path.join(journalDir, j);
+      journalSize += fs.statSync(fp).size;
+      const stat = fs.statSync(fp);
+      if (!latestJournal || stat.mtime > latestJournal) latestJournal = stat.mtime;
+    }
+  }
+
+  // Report
+  console.log('');
+  console.log('=== Memory Systems Comparison ===');
+  console.log('');
+
+  console.log('Claude Code Auto-Memory (per-project):');
+  const byType = {};
+  for (const e of autoEntries) {
+    byType[e.type] = (byType[e.type] || 0) + 1;
+  }
+  console.log(`  ${autoEntries.length} entries across ${new Set(autoEntries.map(e => e.project)).size} projects`);
+  for (const [type, count] of Object.entries(byType).sort((a, b) => b[1] - a[1])) {
+    console.log(`    ${type}: ${count}`);
+  }
+  const recentAuto = autoEntries.filter(e => e.daysAgo <= 7);
+  const staleAuto = autoEntries.filter(e => e.daysAgo > 30);
+  console.log(`  Fresh (≤7d): ${recentAuto.length} | Stale (>30d): ${staleAuto.length}`);
+  console.log('');
+
+  console.log('Wayfind Global Memory:');
+  console.log(`  ${wayfindEntries.length} topic files`);
+  console.log(`  ${journalCount} journal entries (${Math.round(journalSize / 1024)}KB)`);
+  const recentWf = wayfindEntries.filter(e => e.daysAgo <= 7);
+  const staleWf = wayfindEntries.filter(e => e.daysAgo > 30);
+  console.log(`  Fresh (≤7d): ${recentWf.length} | Stale (>30d): ${staleWf.length}`);
+  if (latestJournal) {
+    const jDaysAgo = Math.floor((Date.now() - latestJournal) / (1000 * 60 * 60 * 24));
+    console.log(`  Latest journal: ${jDaysAgo}d ago`);
+  }
+  console.log('');
+
+  // Overlap detection: look for similar topics
+  console.log('Potential Overlap (auto-memory projects with Wayfind topic files on same subject):');
+  let overlapCount = 0;
+  for (const auto of autoEntries) {
+    const keywords = auto.file.replace(/\.md$/, '').replace(/^(feedback|project|reference|user)_/, '').split(/[-_]/).filter(w => w.length > 2);
+    for (const wf of wayfindEntries) {
+      const wfWords = wf.file.replace(/\.md$/, '').split(/[-_]/).filter(w => w.length > 2);
+      const overlap = keywords.filter(k => wfWords.some(w => w.includes(k) || k.includes(w)));
+      if (overlap.length >= 2) {
+        console.log(`  AUTO: ${auto.file} (${auto.project.slice(-30)}) <-> WF: ${wf.file}`);
+        overlapCount++;
+      }
+    }
+  }
+  if (overlapCount === 0) console.log('  None detected');
+  console.log('');
+
+  // Secret scan across both memory systems
+  const SECRET_PATTERNS = [
+    /xoxb-[0-9A-Za-z-]+/,        // Slack bot token
+    /xapp-[0-9A-Za-z-]+/,        // Slack app token
+    /ghp_[0-9A-Za-z]+/,          // GitHub PAT
+    /gho_[0-9A-Za-z]+/,          // GitHub OAuth
+    /sk-[0-9A-Za-z]{20,}/,       // OpenAI / generic secret key
+    /pat-na1-[0-9a-f-]+/,        // HubSpot PAT
+    /ntn_[0-9A-Za-z]+/,          // Notion token
+    /dG9r[0-9A-Za-z+/=]{20,}/,   // Base64 "tok:" prefix (Intercom-style)
+    /AKIA[0-9A-Z]{16}/,          // AWS access key
+    /\b[A-Za-z0-9_]{10,}\.[A-Za-z0-9_-]{20,}/,  // Azure function key pattern (xxx.yyy)
+  ];
+
+  console.log('Secret Scan:');
+  let secretsFound = 0;
+  const allFiles = [
+    ...autoEntries.map(e => ({
+      path: path.join(autoMemoryRoot, e.project, 'memory', e.file),
+      label: `auto:${e.project.slice(-25)}/${e.file}`,
+    })),
+    ...wayfindEntries.map(e => ({
+      path: path.join(wayfindMemory, e.file),
+      label: `wayfind:${e.file}`,
+    })),
+  ];
+  for (const { path: fp, label } of allFiles) {
+    try {
+      const content = fs.readFileSync(fp, 'utf8');
+      for (const pattern of SECRET_PATTERNS) {
+        const match = content.match(pattern);
+        if (match) {
+          // Skip if it's inside a code example or command template (has $ prefix or is in backtick-quoted env var reference)
+          const line = content.split('\n').find(l => l.includes(match[0])) || '';
+          if (line.includes('$') && !line.includes('`' + match[0])) continue;
+          console.log(`  ⚠ ${label} — matches ${pattern.source.slice(0, 20)}...`);
+          secretsFound++;
+          break;
+        }
+      }
+    } catch { /* skip unreadable */ }
+  }
+  if (secretsFound === 0) {
+    console.log('  Clean — no secrets detected in memory files');
+  }
+}
+
+if (require.main === module) {
+  compare();
+}
+
+module.exports = { compare };

package/bin/memory-report.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Daily memory systems comparison report — posts to Slack via bot token.
+# Add to crontab: 43 8 * * * /home/greg/repos/greg/wayfind/bin/memory-report.sh
+#
+# Runs on host (needs access to ~/.claude/projects for auto-memory).
+# Pulls SLACK_BOT_TOKEN from the wayfind container if not set locally.
+
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+CHANNEL="${SLACK_MEMORY_REPORT_CHANNEL:-C0AHV3UUW67}"
+DATE=$(date +%Y-%m-%d)
+PATH="$HOME/.npm-global/bin:$HOME/.local/bin:/usr/local/bin:/usr/bin:/bin:$PATH"
+
+# Get Slack token from container if not in environment
+if [ -z "${SLACK_BOT_TOKEN:-}" ]; then
+  SLACK_BOT_TOKEN=$(docker exec wayfind printenv SLACK_BOT_TOKEN 2>/dev/null || true)
+fi
+if [ -z "${SLACK_BOT_TOKEN:-}" ]; then
+  echo "[$DATE] No SLACK_BOT_TOKEN available — skipping report"
+  exit 0
+fi
+
+# Generate comparison
+REPORT=$(node "$SCRIPT_DIR/memory-compare.js" 2>&1)
+
+# Format for Slack
+PAYLOAD=$(node -e "
+const report = process.argv[1];
+const date = process.argv[2];
+const msg = ':brain: *Daily Memory Systems Report — ' + date + '*\n\`\`\`\n' + report.replace(/=== Memory Systems Comparison ===\n\n/, '') + '\n\`\`\`';
+const body = JSON.stringify({ channel: process.argv[3], text: msg });
+process.stdout.write(body);
+" "$REPORT" "$DATE" "$CHANNEL")
+
+# Post to Slack
+curl -s -X POST https://slack.com/api/chat.postMessage \
+  -H "Authorization: Bearer $SLACK_BOT_TOKEN" \
+  -H "Content-Type: application/json" \
+  -d "$PAYLOAD" > /dev/null
+
+echo "[$DATE] Memory report posted to Slack"

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)
@@ -2884,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)) {
@@ -4301,6 +4264,23 @@ function ensureContainerConfig() {
     changed = true;
   }
 
+  // Backfill container-specific paths into existing digest config (fixes configs
+  // created before store_path/journal_dir/signals_dir were added)
+  if (config.digest) {
+    const defaults = {
+      store_path: process.env.TEAM_CONTEXT_STORE_PATH || contentStore.DEFAULT_STORE_PATH,
+      journal_dir: process.env.TEAM_CONTEXT_JOURNALS_DIR || '/data/journals',
+      signals_dir: process.env.TEAM_CONTEXT_SIGNALS_DIR || contentStore.DEFAULT_SIGNALS_DIR,
+      team_context_dir: process.env.TEAM_CONTEXT_TEAM_CONTEXT_DIR || '',
+    };
+    for (const [key, val] of Object.entries(defaults)) {
+      if (!config.digest[key]) {
+        config.digest[key] = val;
+        changed = true;
+      }
+    }
+  }
+
   // Slack bot config
   if (!config.slack_bot && process.env.SLACK_BOT_TOKEN) {
     config.slack_bot = {
@@ -4318,6 +4298,20 @@ function ensureContainerConfig() {
     changed = true;
   }
 
+  // Backfill container-specific paths into existing bot config
+  if (config.slack_bot) {
+    const botDefaults = {
+      store_path: process.env.TEAM_CONTEXT_STORE_PATH || contentStore.DEFAULT_STORE_PATH,
+      journal_dir: process.env.TEAM_CONTEXT_JOURNALS_DIR || '/data/journals',
+    };
+    for (const [key, val] of Object.entries(botDefaults)) {
+      if (!config.slack_bot[key]) {
+        config.slack_bot[key] = val;
+        changed = true;
+      }
+    }
+  }
+
   // GitHub connector
   if (!config.github && process.env.GITHUB_TOKEN) {
     const repos = process.env.TEAM_CONTEXT_GITHUB_REPOS;
@@ -4847,6 +4841,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),
@@ -5065,6 +5063,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.29",
+  "version": "2.0.31",
   "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