wayfind 2.0.70 → 2.0.71

package/README.md

@@ -1,68 +1,55 @@
 # Wayfind
 
-**Team decision trail for AI-assisted development.**
+**Team memory for AI-assisted engineering.**
 
-> AI makes individual engineers faster. Nobody has solved coherent, maintainable software built by a *team* over time. Every handoff loses context. Wayfind captures it.
+Your AI coding assistant forgets everything between sessions. Wayfind gives it a memory — for you and your whole team.
+
+Plain markdown files. No infrastructure. Works with any MCP client.
 
 [![CI](https://github.com/usewayfind/wayfind/actions/workflows/ci.yml/badge.svg)](https://github.com/usewayfind/wayfind/actions/workflows/ci.yml)
-[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
 [![npm](https://img.shields.io/npm/v/wayfind)](https://www.npmjs.com/package/wayfind)
+[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
 
----
-
-## Install
-
-### Claude Code plugin (recommended)
+**Works with:** Claude Code | Cursor | Any MCP client
 
-In a Claude Code session:
+---
 
-```
-/plugin marketplace add usewayfind/wayfind
-/plugin install wayfind@usewayfind
-```
+## The Problem
 
-Then initialize a repo:
+AI coding assistants are stateless. Every session starts cold. The decisions you made yesterday, the architecture you agreed on last week, the reason you chose Postgres over Mongo — gone. You re-explain, or the AI guesses wrong.
 
-```
-/wayfind:init-memory
-```
+Now multiply that across a team. Five engineers, each with their own AI sessions, none of them aware of what the others decided. Your PM reads the standup notes, but the AI that writes the code doesn't.
 
-Your AI sessions now resume where you left off instead of cold-starting.
+## What Wayfind Does
 
-### npm CLI
+**For you:** Sessions resume where they left off. Decisions are extracted automatically and become searchable history. Drift detection flags when work veers from the stated goal.
 
-The plugin includes the CLI, but you can also install it standalone:
+**For your team:** A daily digest summarizes what everyone shipped, decided, and discovered — tailored per role (engineering, product, design, strategy). Team members who use AI tools get session memory directly. Everyone else gets a Slack digest.
 
-```bash
-npm install -g wayfind
-wayfind init
-```
+**For your AI tools:** An MCP server exposes your team's full decision history as tools. Claude, Cursor, or any MCP client can search decisions, browse by date, and retrieve context — no file reading or guessing.
 
-The CLI is required for digest generation, Slack bot, signal connectors, and team management. The plugin handles session hooks and slash commands.
+<!-- TODO: demo GIF here — see #175 -->
 
 ---
 
-## What It Does
+## Quick Start
 
-### For You (solo engineer)
+### Option A: Claude Code plugin
 
-- **Persistent memory** — sessions pick up where the last one ended
-- **Automatic journal** — decisions and rationale extracted from every session
-- **Searchable history** — `wayfind search-journals "auth refactor"`
-- **Drift detection** — AI flags when work drifts from the stated goal
-
-### For Your Team
-
-- **Digests** — weekly summaries tailored per role (engineering, product, design, strategy)
-- **Slack bot** — anyone on the team asks `@wayfind` and gets answers from the decision trail
-- **Signal connectors** — pull context from GitHub, Intercom, and Notion into digests
-- **Context shift detection** — surfaces significant pivots and architecture changes
+```
+/plugin marketplace add usewayfind/wayfind
+/plugin install wayfind@usewayfind
+/wayfind:init-memory
+```
 
-Only the engineer installs anything. Everyone else sees a Slack digest.
+### Option B: npm (works with any AI tool)
 
+```bash
+npm install -g wayfind
+wayfind init
 ```
-/wayfind:init-team     # Set up team context, journals, and digests
-```
+
+Your next AI session has memory. That's it.
 
 ---
 
@@ -85,118 +72,72 @@ All context is plain markdown in directories you control:
 
 No proprietary formats. No vendor lock-in. `grep` works if Wayfind breaks.
 
-### The Session Protocol
-
-**Start:** AI reads state files, summarizes context, asks "What's the goal?"
-
-**Mid-session:** If work drifts from the goal, the AI flags it.
+### The Session Loop
 
-**End:** Decisions are extracted, written as journal entries, and synced to the team repo — automatically via hooks.
+1. **Start** — AI reads state files, summarizes context, asks "What's the goal?"
+2. **Mid-session** — If work drifts from the goal, the AI flags it.
+3. **End** — Decisions are extracted, written as journal entries, and synced to the team repo — automatically via hooks.
 
-### Digests
+### Team Digests
 
-Each role sees the same underlying data through a different lens:
+Each role sees the same data through a different lens:
 
-- **Engineering**: What shipped, what drifted, patterns
+- **Engineering**: What shipped, what drifted, what patterns emerged
 - **Product**: What shipped vs. planned, discovery signals
-- **Design**: UX decisions, implementation gaps vs. design intent
 - **Strategy**: Cross-team patterns, drift trends, capability gaps
 
-### Signal Connectors
+The digest posts to Slack. Anyone on the team — engineer, PM, CEO — who uses an AI tool gets session memory. Everyone else gets the digest.
 
-```bash
-wayfind pull github       # Issues, PRs, Actions status
-wayfind pull intercom     # Support conversations, tags, response times
-wayfind pull notion       # Pages, databases, comments
-wayfind pull --all        # All configured channels
-```
+### MCP Server
 
----
+Wayfind includes an MCP server that exposes team context to any MCP-compatible AI tool. Auto-registered during `wayfind init`.
 
-## 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 hooks and commands |
-| `wayfind status` | Cross-project status |
-| `wayfind team create` | Create a new team |
-| `wayfind team join` | Join an existing team |
-| `wayfind digest` | Generate persona-specific digests |
-| `wayfind digest --deliver` | Generate and post to Slack |
-| `wayfind bot` | Start the Slack bot |
-| `wayfind reindex` | Index journals + conversations |
-| `wayfind search-journals <q>` | Search decision history |
-| `wayfind pull <channel>` | Pull signals from a source |
-| `wayfind journal sync` | Sync journals to team repo |
-| `wayfind onboard <repo>` | Generate onboarding context pack |
-| `wayfind deploy init` | Scaffold Docker deployment |
-| `wayfind deploy --team <id>` | Scaffold per-team Docker deployment |
-| `wayfind deploy set-endpoint <url>` | Set container endpoint for team search |
-| `wayfind deploy list` | List running team containers |
-| `wayfind deploy status` | Check container health |
-| `wayfind migrate-to-plugin` | Remove old hooks (after plugin install) |
-
-Run `wayfind help` for the full list.
+**Tools:**
 
----
+| Tool | What it does |
+|------|-------------|
+| `search_context` | Search decisions by query, date range, author, or repo. Semantic or browse mode. |
+| `get_entry` | Retrieve the full content of a specific entry. |
+| `get_signals` | Recent GitHub, Intercom, and Notion activity. |
+| `get_team_status` | Current team state: who's working on what, active projects, blockers. |
+| `add_context` | Capture a decision or blocker from the current session. |
+| `record_feedback` | Rate whether a result was useful (improves future retrieval). |
 
-## MCP Server
+Each team member's MCP server searches their local content store — journals synced from the shared team repo, with local embeddings generated automatically. No infrastructure required.
 
-Wayfind includes an MCP server (`wayfind-mcp`) that exposes team context to any MCP-compatible AI tool.
+---
 
-**Tools:** `search_context`, `get_entry`, `list_recent`, `get_signals`, `get_team_status`, `get_personas`, `record_feedback`, `add_context`
+## Signal Connectors
 
-Auto-registered during `wayfind init`. When a team container is running, the local MCP server proxies semantic search to it automatically — no config needed beyond the team-context repo.
+Pull external context into digests:
 
----
-
-## Environment Variables
+```bash
+wayfind pull github       # Issues, PRs, Actions status
+wayfind pull intercom     # Support conversations, tags, response times
+wayfind pull notion       # Pages, databases, comments
+wayfind pull --all        # All configured channels
+```
 
-### For digests and bot
+---
 
-| Variable | Description |
-|----------|-------------|
-| `ANTHROPIC_API_KEY` | Digest generation and bot answers |
-| `SLACK_BOT_TOKEN` | Slack bot token (`xoxb-...`) |
-| `SLACK_APP_TOKEN` | Slack app-level token (`xapp-...`) |
-| `GITHUB_TOKEN` | Signal data and journal sync |
+## Team Setup
 
-### Optional
+```
+/wayfind:init-team
+```
 
-| Variable | Description |
-|----------|-------------|
-| `OPENAI_API_KEY` | Upgrade semantic search to OpenAI embeddings (Xenova local model is used by default — no key needed) |
-| `TEAM_CONTEXT_LLM_MODEL` | LLM for digests (default: `claude-sonnet-4-5-20250929`) |
-| `TEAM_CONTEXT_DIGEST_SCHEDULE` | Cron schedule (default: `0 8 * * 1` — Monday 8am) |
-| `TEAM_CONTEXT_EXCLUDE_REPOS` | Repos to exclude from digests |
-| `TEAM_CONTEXT_TELEMETRY` | `true` for anonymous usage telemetry |
+This walks you through creating a team, setting up profiles, creating a shared team-context repo, and configuring Slack digest delivery. Multi-team support built in — bind repos to different teams, each with isolated context.
 
 ---
 
 ## Tool Support
 
-| Tool | Status | Setup |
-|------|--------|-------|
-| 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/` |
-| Any MCP client | Full support (MCP) | `wayfind init` auto-registers |
+| Tool | How | Setup |
+|------|-----|-------|
+| **Claude Code** | Plugin (full support) | `/plugin marketplace add usewayfind/wayfind` |
+| **Cursor** | MCP server | `wayfind init` auto-registers |
+| **Any MCP client** | MCP server | `wayfind init` auto-registers |
+| **Slack** | Bot + digests | `wayfind bot --configure` |
 
 ---
 
@@ -206,27 +147,23 @@ Everything that runs on your machine is open source (Apache 2.0).
 
 | Open Source (this repo) | Commercial (future) |
 |---|---|
-| CLI and all commands | Cloud-hosted team aggregation |
+| CLI, plugin, and all commands | Cloud-hosted team aggregation |
 | Session protocol and journal extraction | Managed digest delivery |
-| Content store and search | Web dashboard |
+| Content store, semantic search, MCP server | Web dashboard |
 | Signal connectors (GitHub, Intercom, Notion) | SSO and tenant isolation |
 | Digest generation (your API key) | |
 | Slack bot (self-hosted) | |
 | Multi-team support | |
-| MCP server (local + container proxy) | |
-| Per-team content store isolation | |
-
-See [LICENSING.md](LICENSING.md) for details.
 
 ---
 
 ## Architecture
 
 - [Data Flow](docs/architecture/data-flow.md) — sessions to digests
-- [Principles](docs/architecture/architecture-principles.md) — the eight constraints
+- [Query Path](docs/architecture/query-path.md) — how queries reach the content store
 - [Content Store](docs/architecture/content-store.md) — indexing, search, schema
+- [Principles](docs/architecture/architecture-principles.md) — the eight constraints
 - [Signal Channels](docs/architecture/architecture-signal-channels.md) — connector architecture
-- [Signal Roadmap](docs/architecture/signal-source-roadmap.md) — planned connectors
 
 ---
 
@@ -242,4 +179,4 @@ See [CONTRIBUTING.md](CONTRIBUTING.md). Good first contributions:
 
 ## License
 
-Apache 2.0. See [LICENSE](LICENSE) and [LICENSING.md](LICENSING.md).
+Apache 2.0. See [LICENSE](LICENSE).

package/package.json

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

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

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

package/setup.sh

@@ -215,7 +215,6 @@ if [ ! -f "$GLOBAL_STATE" ]; then
         run cp "$SCRIPT_DIR/templates/global.md" "$GLOBAL_STATE"
     fi
     log "Created $GLOBAL_STATE"
-    warn "Edit $GLOBAL_STATE to add your name, preferences, and projects"
 else
     info "Already exists: $GLOBAL_STATE — skipped"
 fi
@@ -656,40 +655,23 @@ Do not ask more than once per decision. Do not ask during routine implementation
     fi
 fi
 
-# ── Step 7: Personas (informational) ─────────────────────────────────────────
-
-header "Personas"
-
-echo ""
-echo "  Default personas: Product, Design, Engineering, Strategy"
-echo "  You can customize personas later with 'wayfind personas'"
-echo ""
-
-# ── Step 8: Summary ───────────────────────────────────────────────────────────
-
-header "Done"
+# ── Summary ──────────────────────────────────────────────────────────────────
 
 echo ""
-echo "Wayfind installed for $TOOL."
+echo -e "${GREEN}✓${RESET} Wayfind installed."
 echo ""
-echo "Next steps:"
-echo "  1. Edit $GLOBAL_STATE with your preferences and projects"
 
 if [ "$TOOL" = "claude-code" ]; then
-    echo "  2. Open a repo and run /init-memory to set it up"
-    echo "  3. Start a Claude Code session — it will load your state automatically"
-    echo "  4. Run /journal for a weekly digest of your AI session logs"
-    echo "  5. Set up your profile: wayfind whoami --setup"
-    echo "  6. Create or join a team: wayfind team create"
+    echo "  Next: open a repo and run /init-memory to set it up."
+    echo "        Then start a Claude Code session — Wayfind captures context automatically."
 elif [ "$TOOL" = "cursor" ]; then
-    echo "  2. Open a repo and run: bash setup.sh --tool cursor --repo <path>"
-    echo "  3. Start a Cursor session — the global rule loads your state automatically"
-    echo "  4. See specializations/cursor/README.md for full documentation"
+    echo "  Next: open a repo and run: bash setup.sh --tool cursor --repo <path>"
+    echo "        Then start a Cursor session — the global rule loads your state automatically."
 else
-    echo "  2. Add the session protocol to your tool's system prompt"
-    echo "     See: specializations/generic/README.md"
+    echo "  Next: add the session protocol to your tool's system prompt."
+    echo "        See: specializations/generic/README.md"
 fi
 
 echo ""
-echo "  Full documentation: README.md"
+echo "  Docs: https://github.com/usewayfind/wayfind"
 echo ""