wayfind 2.0.72 → 2.0.74

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wayfind",
-  "version": "2.0.72",
+  "version": "2.0.74",
   "description": "Team decision trail for AI-assisted development. The connective tissue between product, engineering, and strategy.",
   "bin": {
     "wayfind": "./bin/team-context.js",
@@ -46,7 +46,7 @@
     "test:all": "npm test && npm run test:sim"
   },
   "engines": {
-    "node": ">=16"
+    "node": ">=20"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.28.0",

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

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

package/plugin/hooks/hooks.json

@@ -7,7 +7,7 @@
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/scripts/session-start.sh",
-            "timeout": 15
+            "timeout": 60
           }
         ]
       }
@@ -19,7 +19,7 @@
           {
             "type": "command",
             "command": "${CLAUDE_PLUGIN_ROOT}/scripts/session-end.sh",
-            "timeout": 30
+            "timeout": 20
           }
         ]
       }

package/plugin/scripts/session-end.sh

@@ -1,16 +1,14 @@
 #!/usr/bin/env bash
 # Wayfind plugin — Stop hook
-# Runs incremental conversation indexing with journal export after each session.
-# Extracted decisions get written to the journal directory so they sync via git
-# and the container's journal indexer picks them up.
+# Persists the session: splits journal files by team suffix, then syncs to
+# team-context repo. No LLM calls — fast, reliable, durability only.
 #
-# Performance target: <5s for the common case (no new conversations to process).
+# Heavy work (reindex, embeddings, context shift detection) is handled by
+# the container on a schedule, or by the session-start hook for solo users.
 
 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.
+# Skip for worker agents in multi-agent swarms.
 if [ "${TEAM_CONTEXT_SKIP_EXPORT:-}" = "1" ]; then
   exit 0
 fi
@@ -28,29 +26,12 @@ if [ -z "$WAYFIND" ]; then
 fi
 
 if [ -z "$WAYFIND" ]; then
-  echo "[wayfind] CLI not found — decision extraction skipped. Install: npm install -g wayfind" >&2
   exit 0
 fi
 
-# ── Fast path: skip reindex if no conversation files changed ──────────────────
-LAST_RUN_FILE="$HOME/.claude/team-context/.last-reindex"
-if [ -f "$LAST_RUN_FILE" ]; then
-  CHANGED=$(find "$HOME/.claude/projects" -name "*.jsonl" -newer "$LAST_RUN_FILE" -print -quit 2>/dev/null)
-  if [ -z "$CHANGED" ]; then
-    # No conversation files changed — skip expensive reindex, just split and sync journals
-    $WAYFIND journal split 2>/dev/null
-    $WAYFIND journal sync 2>/dev/null &
-    exit 0
-  fi
-fi
-
-# Run incremental reindex
-$WAYFIND reindex --conversations-only --export --detect-shifts --write-stats 2>/dev/null || true
-
-# Update the marker so the next session's fast-path check works
-mkdir -p "$HOME/.claude/team-context"
-touch "$LAST_RUN_FILE"
+# Split any unsuffixed journal files by team (fast, filesystem only)
+$WAYFIND journal split >/dev/null 2>&1 || true
 
-# Split any unsuffixed journals, then sync to team-context repo (sync backgrounded)
-$WAYFIND journal split 2>/dev/null
-$WAYFIND journal sync 2>/dev/null &
+# Sync journals to team-context repo — the durability guarantee.
+# Runs synchronously so the push completes before the hook exits.
+$WAYFIND journal sync 2>/dev/null || true

package/plugin/scripts/session-start.sh

@@ -1,14 +1,17 @@
 #!/usr/bin/env bash
 # Wayfind plugin — SessionStart hook
-# Rebuilds the Active Projects index and checks for version updates.
-# Runs on every session start via the plugin hook system.
+# Pulls team context, indexes last session's conversations (solo mode only),
+# rebuilds the Active Projects index, then prompts for the session goal.
+#
+# Runs synchronously so the user sees what Wayfind is doing before they type.
+# Solo mode: no container_endpoint configured — reindex runs here instead of
+# in a background container.
 
 set -euo pipefail
 
 # Find wayfind binary
 WAYFIND="$(command -v wayfind 2>/dev/null || echo "")"
 if [ -z "$WAYFIND" ]; then
-  # Try common local checkout paths
   for candidate in \
     "$HOME/repos/wayfind/bin/team-context.js"; do
     if [ -f "$candidate" ]; then
@@ -19,17 +22,54 @@ if [ -z "$WAYFIND" ]; then
 fi
 
 if [ -z "$WAYFIND" ]; then
-  # No CLI available — plugin still works for skills, just no automation
-  echo "[wayfind] CLI not found. Skills work, but install the CLI for full features: npm install -g wayfind" >&2
+  echo "[wayfind] CLI not found — install for full features: npm install -g wayfind" >&2
   exit 0
 fi
 
-# Pull latest team-context in the background so this session sees
-# other engineers' recent work without blocking session start
-$WAYFIND context pull --quiet --background 2>/dev/null || true
+echo ""
+echo "  ── Wayfind ────────────────────────────────────────"
 
-# Rebuild Active Projects table (idempotent, concurrent-safe)
+# Pull latest team context (synchronous — start with fresh state)
+echo ""
+$WAYFIND context pull 2>/dev/null || true
+
+# Detect solo mode: no container_endpoint means no background container running reindex
+CONTEXT_JSON="${WAYFIND_DIR:-$HOME/.claude/team-context}/context.json"
+HAS_CONTAINER=false
+if [ -f "$CONTEXT_JSON" ] && grep -q '"container_endpoint"' "$CONTEXT_JSON" 2>/dev/null; then
+  HAS_CONTAINER=true
+fi
+
+# Solo mode: index last session's conversations now
+# Teams rely on the container's scheduled reindex instead.
+if [ "$HAS_CONTAINER" = "false" ]; then
+  LAST_RUN_FILE="${WAYFIND_DIR:-$HOME/.claude/team-context}/.last-reindex"
+  SHOULD_REINDEX=true
+
+  if [ -f "$LAST_RUN_FILE" ]; then
+    CHANGED=$(find "$HOME/.claude/projects" -name "*.jsonl" -newer "$LAST_RUN_FILE" -print -quit 2>/dev/null)
+    if [ -z "$CHANGED" ]; then
+      SHOULD_REINDEX=false
+    fi
+  fi
+
+  if [ "$SHOULD_REINDEX" = "true" ]; then
+    echo ""
+    echo "  Indexing last session's conversations..."
+    echo ""
+    $WAYFIND reindex --conversations-only --export --write-stats 2>/dev/null || true
+    mkdir -p "${WAYFIND_DIR:-$HOME/.claude/team-context}"
+    touch "$LAST_RUN_FILE"
+  fi
+fi
+
+# Rebuild Active Projects index (writes to global-state.md)
 $WAYFIND status --write --quiet 2>/dev/null || true
 
-# Check if installed version meets team minimum
+# Version check — silent unless outdated
 $WAYFIND check-version 2>/dev/null || true
+
+echo ""
+echo "  What's the goal for this session?"
+echo "  ───────────────────────────────────────────────────"
+echo ""

package/specializations/claude-code/hooks/check-global-state.sh

@@ -1,16 +1,78 @@
 #!/usr/bin/env bash
-# Wayfind — Rebuild Active Projects + version check on session start.
-# Rebuilds the Active Projects table from per-repo state files (idempotent,
-# concurrent-safe), then checks if the installed version meets the team
-# minimum configured in the team-context repo's wayfind.json.
+# Wayfind — SessionStart hook
+# Pulls team context, indexes last session's conversations (solo mode only),
+# rebuilds the Active Projects index, then prompts for the session goal.
+#
+# Runs synchronously so the user sees what Wayfind is doing before they type.
+# Solo mode: no container_endpoint configured — reindex runs here instead of
+# in a background container.
 #
 # Install: copy to ~/.claude/hooks/check-global-state.sh
 # Register: add to ~/.claude/settings.json (see settings.json in this directory)
 
 set -euo pipefail
 
-# Use installed wayfind CLI
-if command -v wayfind >/dev/null 2>&1; then
-    wayfind status --write --quiet 2>/dev/null || true
-    wayfind check-version 2>/dev/null || true
+# Find wayfind binary
+WAYFIND="$(command -v wayfind 2>/dev/null || echo "")"
+if [ -z "$WAYFIND" ]; then
+  for candidate in \
+    "$HOME/repos/wayfind/bin/team-context.js"; do
+    if [ -f "$candidate" ]; then
+      WAYFIND="node $candidate"
+      break
+    fi
+  done
+fi
+
+if [ -z "$WAYFIND" ]; then
+  echo "[wayfind] CLI not found — install for full features: npm install -g wayfind" >&2
+  exit 0
+fi
+
+echo ""
+echo "  ── Wayfind ────────────────────────────────────────"
+
+# Pull latest team context (synchronous — start with fresh state)
+echo ""
+$WAYFIND context pull 2>/dev/null || true
+
+# Detect solo mode: no container_endpoint means no background container running reindex
+CONTEXT_JSON="${WAYFIND_DIR:-$HOME/.claude/team-context}/context.json"
+HAS_CONTAINER=false
+if [ -f "$CONTEXT_JSON" ] && grep -q '"container_endpoint"' "$CONTEXT_JSON" 2>/dev/null; then
+  HAS_CONTAINER=true
 fi
+
+# Solo mode: index last session's conversations now
+# Teams rely on the container's scheduled reindex instead.
+if [ "$HAS_CONTAINER" = "false" ]; then
+  LAST_RUN_FILE="${WAYFIND_DIR:-$HOME/.claude/team-context}/.last-reindex"
+  SHOULD_REINDEX=true
+
+  if [ -f "$LAST_RUN_FILE" ]; then
+    CHANGED=$(find "$HOME/.claude/projects" -name "*.jsonl" -newer "$LAST_RUN_FILE" -print -quit 2>/dev/null)
+    if [ -z "$CHANGED" ]; then
+      SHOULD_REINDEX=false
+    fi
+  fi
+
+  if [ "$SHOULD_REINDEX" = "true" ]; then
+    echo ""
+    echo "  Indexing last session's conversations..."
+    echo ""
+    $WAYFIND reindex --conversations-only --export --write-stats 2>/dev/null || true
+    mkdir -p "${WAYFIND_DIR:-$HOME/.claude/team-context}"
+    touch "$LAST_RUN_FILE"
+  fi
+fi
+
+# Rebuild Active Projects index (writes to global-state.md)
+$WAYFIND status --write --quiet 2>/dev/null || true
+
+# Version check — silent unless outdated
+$WAYFIND check-version 2>/dev/null || true
+
+echo ""
+echo "  What's the goal for this session?"
+echo "  ───────────────────────────────────────────────────"
+echo ""

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

@@ -1,16 +1,14 @@
 #!/usr/bin/env bash
-# Wayfind session-end hook
-# Runs incremental conversation indexing with journal export after each session.
-# Extracted decisions get written to the journal directory so they sync via git
-# and the container's journal indexer picks them up.
+# Wayfind session-end hook (standalone / pre-plugin install)
+# Persists the session: splits journal files by team suffix, then syncs to
+# team-context repo. No LLM calls — fast, reliable, durability only.
 #
-# Performance target: <5s for the common case (no new conversations to process).
+# Heavy work (reindex, embeddings, context shift detection) is handled by
+# the container on a schedule, or by the session-start hook for solo users.
 
 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.
+# Skip for worker agents in multi-agent swarms.
 if [ "${TEAM_CONTEXT_SKIP_EXPORT:-}" = "1" ]; then
   exit 0
 fi
@@ -18,39 +16,23 @@ fi
 # Find wayfind binary
 WAYFIND="$(command -v wayfind 2>/dev/null || echo "")"
 if [ -z "$WAYFIND" ]; then
-  # Try npx
-  if command -v npx &>/dev/null; then
-    WAYFIND="npx --yes wayfind"
-  else
-    exit 0
-  fi
+  for candidate in \
+    "$HOME/repos/wayfind/bin/team-context.js"; do
+    if [ -f "$candidate" ]; then
+      WAYFIND="node $candidate"
+      break
+    fi
+  done
 fi
 
-# ── Fast path: skip reindex if no conversation files changed ──────────────────
-# The full reindex pipeline (load store, scan transcripts, hash check, LLM calls)
-# has a ~2-3s baseline cost even when nothing changed. This filesystem check
-# short-circuits in <50ms for the common case.
-LAST_RUN_FILE="$HOME/.claude/team-context/.last-reindex"
-if [ -f "$LAST_RUN_FILE" ]; then
-  CHANGED=$(find "$HOME/.claude/projects" -name "*.jsonl" -newer "$LAST_RUN_FILE" 2>/dev/null | head -1)
-  if [ -z "$CHANGED" ]; then
-    # No conversation files changed — skip expensive reindex, just sync journals
-    $WAYFIND journal sync 2>/dev/null &
-    exit 0
-  fi
+if [ -z "$WAYFIND" ]; then
+  echo "[wayfind] CLI not found — decision extraction skipped. Install: npm install -g wayfind" >&2
+  exit 0
 fi
 
-# Run incremental reindex (conversations only — journals are handled by the journal write itself)
-# --conversations-only: skip journals (just written by the session, no need to re-index)
-# --export: write extracted decisions as journal entries for git sync
-# --detect-shifts: auto-update state files when significant context shifts are detected
-# --write-stats: write session stats JSON for status line display
-$WAYFIND reindex --conversations-only --export --detect-shifts --write-stats 2>/dev/null || true
-
-# Update the marker so the next session's fast-path check works
-mkdir -p "$HOME/.claude/team-context"
-touch "$LAST_RUN_FILE"
+# Split any unsuffixed journal files by team (fast, filesystem only)
+$WAYFIND journal split >/dev/null 2>&1 || true
 
-# Sync authored journals to team-context repo (commit + push) — backgrounded
-# so the session can exit immediately. Git push is the slowest part (~1-3s).
-$WAYFIND journal sync 2>/dev/null &
+# Sync journals to team-context repo — the durability guarantee.
+# Runs synchronously so the push completes before the hook exits.
+$WAYFIND journal sync 2>/dev/null || true