wayfind 2.0.14 → 2.0.16

package/BOOTSTRAP_PROMPT.md

@@ -7,34 +7,39 @@ Copy and paste the block below into a new Claude Code session. That's it.
 ```
 Please set up Wayfind for my Claude Code environment.
 
-Run these commands:
+Step 1 — Install the CLI:
 npm install -g wayfind
 wayfind init
 
-Once it completes:
+Step 2 — Install the Claude Code plugin:
+/plugin marketplace add usewayfind/wayfind
+/plugin install wayfind@usewayfind
+
+Once both steps complete:
 1. Tell me what was installed and what still needs to be configured
-2. Run /init-memory to initialize memory for the current repo
+2. Run /wayfind:init-memory to initialize memory for the current repo
 3. Ask me what my preferences are (communication style, tool preferences, commit
    conventions, anything I want Claude to always know) so we can fill in
    global-state.md together
 4. Ask me if I want to set up backup (see below) — I will need to provide a
    private GitHub repo URL before you can proceed with that step
 5. Run `wayfind whoami --setup` so I can provide my Slack user ID (used for @mentions and DMs)
-6. Ask me if I want to set up team context (/init-team) for shared journals,
+6. Ask me if I want to set up team context (/wayfind:init-team) for shared journals,
    digests, and product state
-7. Let me know about opt-in telemetry (set TEAM_CONTEXT_TELEMETRY=true to enable)
+7. Let me know that anonymous usage telemetry is enabled by default (set TEAM_CONTEXT_TELEMETRY=false to opt out)
 ```
 
 ---
 
 ## What happens
 
-The install command will:
-- Create `~/.claude/memory/` and `~/.claude/memory/journal/`
-- Install `~/.claude/global-state.md` (your persistent index)
-- Install `~/.claude/hooks/check-global-state.sh` (warns when state is stale)
-- Install slash commands: `/init-memory`, `/init-team`, `/journal`, `/doctor`
-- Register the hook in `~/.claude/settings.json`
+The CLI install creates:
+- `~/.claude/memory/` and `~/.claude/memory/journal/`
+- `~/.claude/global-state.md` (your persistent index)
+
+The plugin provides:
+- SessionStart and Stop hooks (context loading, decision extraction)
+- Slash commands: `/wayfind:init-memory`, `/wayfind:init-team`, `/wayfind:journal`, `/wayfind:doctor`, `/wayfind:standup`
 
 After the paste, Claude will walk you through filling in your preferences. From
 then on, every session in every repo will start with full context of where you
@@ -72,7 +77,7 @@ After that, your memory is backed up silently on every session — no manual ste
 
 ## Setting up team context (optional)
 
-Once you have the basics working, run `/init-team` in a Claude Code session to set up:
+Once you have the basics working, run `/wayfind:init-team` in a Claude Code session to set up:
 - A shared team context repo for journals and digests
 - Slack integration for weekly digest posts
 - Notion integration for browseable product state and digest archives
@@ -87,7 +92,7 @@ visibility across product, engineering, and strategy.
 
 In any repo you work in, run:
 ```
-/init-memory
+/wayfind:init-memory
 ```
 
 Claude will create `.claude/team-state.md` (shared) and `.claude/personal-state.md`
@@ -102,6 +107,8 @@ npm install -g wayfind
 wayfind init-cursor
 ```
 
+(The Claude Code plugin is not available for Cursor — use the CLI-only setup.)
+
 ---
 
 ## Source
@@ -110,11 +117,11 @@ https://github.com/usewayfind/wayfind
 
 To install a specific version:
 ```
-npm install -g wayfind@1.1.0
+npm install -g wayfind@2.0.15
 wayfind init
 ```
 
 Or via the shell installer with a pinned version:
 ```
-WAYFIND_VERSION=v1.1.0 bash <(curl -fsSL https://raw.githubusercontent.com/usewayfind/wayfind/main/install.sh)
+WAYFIND_VERSION=v2.0.15 bash <(curl -fsSL https://raw.githubusercontent.com/usewayfind/wayfind/main/install.sh)
 ```

package/README.md

@@ -12,19 +12,34 @@
 
 ## Install
 
-```bash
-npm install -g wayfind
-wayfind init
+### Claude Code plugin (recommended)
+
+In a Claude Code session:
+
+```
+/plugin marketplace add usewayfind/wayfind
+/plugin install wayfind@usewayfind
 ```
 
-Then in a Claude Code session:
+Then initialize a repo:
 
 ```
-/init-memory     # Persistent context for this repo
+/wayfind:init-memory
 ```
 
 Your AI sessions now resume where you left off instead of cold-starting.
 
+### npm CLI
+
+The plugin includes the CLI, but you can also install it standalone:
+
+```bash
+npm install -g wayfind
+wayfind init
+```
+
+The CLI is required for digest generation, Slack bot, signal connectors, and team management. The plugin handles session hooks and slash commands.
+
 ---
 
 ## What It Does
@@ -45,8 +60,8 @@ Your AI sessions now resume where you left off instead of cold-starting.
 
 Only the engineer installs anything. Everyone else sees a Slack digest.
 
-```bash
-/init-team       # Set up team context, journals, and digests
+```
+/wayfind:init-team     # Set up team context, journals, and digests
 ```
 
 ---
@@ -64,7 +79,8 @@ All context is plain markdown in directories you control:
     journal/YYYY-MM-DD.md   # Daily decision log
 
 <repo>/.claude/
-  state.md                  # Per-repo: branch, status, next steps
+  team-state.md             # Shared team context (committed)
+  personal-state.md         # Your context (gitignored)
 ```
 
 No proprietary formats. No vendor lock-in. `grep` works if Wayfind breaks.
@@ -99,11 +115,24 @@ wayfind pull --all        # All configured channels
 
 ## Commands
 
+### Plugin skills (in Claude Code)
+
+| Skill | Description |
+|-------|-------------|
+| `/wayfind:init-memory` | Initialize context for the current repo |
+| `/wayfind:init-team` | Set up team context, journals, and digests |
+| `/wayfind:doctor` | Check installation health |
+| `/wayfind:standup` | Daily standup summary |
+| `/wayfind:journal` | Weekly journal digest and drift detection |
+| `/wayfind:review-prs` | Review overnight PRs |
+
+### CLI commands
+
 | Command | Description |
 |---------|-------------|
 | `wayfind init` | Install for your AI tool |
 | `wayfind doctor` | Check installation health |
-| `wayfind update` | Update to latest version |
+| `wayfind update` | Update hooks and commands |
 | `wayfind status` | Cross-project status |
 | `wayfind team create` | Create a new team |
 | `wayfind team join` | Join an existing team |
@@ -116,6 +145,7 @@ wayfind pull --all        # All configured channels
 | `wayfind journal sync` | Sync journals to team repo |
 | `wayfind onboard <repo>` | Generate onboarding context pack |
 | `wayfind deploy init` | Scaffold Docker deployment |
+| `wayfind migrate-to-plugin` | Remove old hooks (after plugin install) |
 
 Run `wayfind help` for the full list.
 
@@ -148,7 +178,8 @@ Run `wayfind help` for the full list.
 
 | Tool | Status | Setup |
 |------|--------|-------|
-| Claude Code | Full support | `wayfind init` |
+| Claude Code | Full support (plugin) | `/plugin marketplace add usewayfind/wayfind` |
+| Claude Code | Full support (npm) | `wayfind init` |
 | Cursor | Session protocol | `wayfind init-cursor` |
 | Generic | Manual | See `specializations/generic/` |
 

package/bin/team-context.js

@@ -4448,7 +4448,7 @@ const COMMANDS = {
       // Files and directories to sync
       const syncItems = [
         'bin/', 'templates/', 'specializations/', 'plugin/', 'tests/', 'simulation/',
-        'backup/', '.github/', 'Dockerfile', 'package.json', 'marketplace.json', 'setup.sh',
+        'backup/', '.github/', '.claude-plugin/', 'Dockerfile', 'package.json', 'setup.sh',
         'install.sh', 'uninstall.sh', 'doctor.sh', 'journal-summary.sh',
         'BOOTSTRAP_PROMPT.md', '.gitattributes', '.gitignore', 'VERSIONS.md',
       ];

package/bin/telemetry.js

@@ -12,7 +12,7 @@ let enabled = false;
 function init() {
   if (client !== null) return; // already initialized (or disabled)
 
-  enabled = (process.env.TEAM_CONTEXT_TELEMETRY || '').toLowerCase() === 'true';
+  enabled = (process.env.TEAM_CONTEXT_TELEMETRY || '').toLowerCase() !== 'false';
   if (!enabled) {
     client = false; // marker: checked but disabled
     return;

package/doctor.sh

@@ -17,9 +17,37 @@ info() { echo "  $1"; }
 
 ISSUES=0
 
+is_plugin_installed() {
+    # Check if wayfind is installed as a Claude Code plugin
+    # Method 1: Check enabledPlugins in settings.json (authoritative — what Claude Code reads)
+    local SETTINGS="$HOME/.claude/settings.json"
+    if [ -f "$SETTINGS" ] && grep -q '"wayfind@' "$SETTINGS" 2>/dev/null; then
+        return 0
+    fi
+
+    # Method 2: Check plugin files on disk
+    local PLUGINS_DIR="$HOME/.claude/plugins"
+    if [ -d "$PLUGINS_DIR" ]; then
+        if find "$PLUGINS_DIR" -path '*/wayfind/plugin/.claude-plugin/plugin.json' -print -quit 2>/dev/null | grep -q .; then
+            return 0
+        fi
+        if find "$PLUGINS_DIR" -name 'plugin.json' -exec grep -l '"name": "wayfind"' {} + 2>/dev/null | grep -q .; then
+            return 0
+        fi
+    fi
+    return 1
+}
+
 check_hook_registered() {
     echo ""
     echo "Hook registration"
+
+    # If installed as a plugin, hooks are provided by the plugin — skip legacy checks
+    if is_plugin_installed; then
+        ok "Installed as Claude Code plugin (hooks provided by plugin)"
+        return
+    fi
+
     local SETTINGS="$HOME/.claude/settings.json"
     if [ ! -f "$SETTINGS" ]; then
         err "settings.json not found — hook is not registered"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wayfind",
-  "version": "2.0.14",
+  "version": "2.0.16",
   "description": "Team decision trail for AI-assisted development. The connective tissue between product, engineering, and strategy.",
   "bin": {
     "wayfind": "./bin/team-context.js"
@@ -28,7 +28,7 @@
   "files": [
     "bin/",
     "plugin/",
-    "marketplace.json",
+    ".claude-plugin/",
     "setup.sh",
     "install.sh",
     "uninstall.sh",

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "wayfind",
-  "version": "2.0.14",
+  "version": "2.0.15",
   "description": "Team decision trail for AI-assisted development. Session memory, decision journals, and team digests.",
   "author": {
     "name": "Wayfind",