feat(catalog): Plan 21 session-start dedup + Phase C sensors (#46)

Cuts session-start context redundancy and completes Plan 08 Phase C:
- session-context sensor now filters memory/session-start protocols
  (duplicates of sensor-injected content), skips empty FieldNotes,
  summarizes pending reports instead of full-cat, drops misfired
  end-of-session reminder block, and scopes to SessionStart matcher
  startup|resume|clear so /compact can be handled by a separate sensor.
- session-start protocol rewritten to assume sensor did the heavy
  lifting — no more 10-step re-read list.
- context-guard gains verify + plan pattern detection with word-boundary
  (not end-anchored) regex; planning reminder suppressed when wrap-up
  already fired to avoid triple-stacking.
- new compact-recovery sensor (matcher=compact) re-injects minimal
  context (Quick Triggers + Work State) after /compact, <2000 chars
  in normal conditions.
- station self-awareness.md trimmed: durable UX preferences moved to
  memory.md Feedback section where they structurally belong.

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>

Author: LastStep

.bonsai.yaml

@@ -39,6 +39,7 @@ agents:
             - agent-review
             - dispatch-guard
             - subagent-stop-review
+            - compact-recovery
         routines:
             - backlog-hygiene
             - dependency-audit

catalog/protocols/session-start/session-start.md

@@ -1,6 +1,6 @@
 ---
 tags: [protocol, session]
-description: Ordered startup sequence — always steps + conditional loading by task type.
+description: Session startup — act on the context the session-context sensor already injected.
 ---
 
 # Protocol: Session Start
@@ -10,37 +10,34 @@ description: Ordered startup sequence — always steps + conditional loading by
 
 ---
 
-## Always (every session)
+## Always
 
-1. Read [agent/Core/identity.md](../Core/identity.md) — confirm role and mindset
-2. Read [agent/Core/memory.md](../Core/memory.md) — surface pending flags, check work state
-3. Read [agent/Core/self-awareness.md](../Core/self-awareness.md) — refresh context monitoring rules
-4. Read [INDEX.md](../../INDEX.md) — get project snapshot
-5. Read [Playbook/Status.md](../../Playbook/Status.md) — see what's in progress and pending
-6. Scan [Playbook/Backlog.md](../../Playbook/Backlog.md) — check for P0 items not yet in Status.md (escalate immediately if found)
-7. Read [Logs/FieldNotes.md](../../Logs/FieldNotes.md) — check for user updates since last session
-8. Check [Reports/Pending/](../../Reports/Pending/) — process any unreviewed agent reports
-9. Read [agent/Protocols/security.md](security.md) — refresh security constraints (if installed)
-10. Read [agent/Protocols/scope-boundaries.md](scope-boundaries.md) — refresh what you own (if installed)
+The session-context sensor injects the following at SessionStart: identity.md, memory.md, self-awareness.md, INDEX.md, Status.md, FieldNotes.md (when non-empty), Reports/Pending summary, and always-on Protocols (security, scope-boundaries). Health warnings (stale memory, Backlog P0, pending reports, log freshness) are also surfaced.
+
+Your job:
+
+1. **Address any flags** in the injected `memory.md` Flags section.
+2. **Confirm work state** from `memory.md` — resume in-flight tasks or start fresh as appropriate.
+3. **Act on health warnings** the sensor raised (stale memory, P0 items, pending reports).
+4. **Process pending reports** by reading each file in `Reports/Pending/` (sensor gave summaries only).
 
 > [!note]
-> Paths like `INDEX.md`, `Playbook/`, `Logs/`, and `Reports/` refer to the project docs location configured during `bonsai init`. Check your workspace CLAUDE.md → External References for the exact paths.
-> Backlog.md is a scan, not a full read — look for P0 items only. Full backlog review is handled by the backlog-hygiene routine.
+> If the session-context sensor is NOT installed (headless agent), fall back to reading core files manually: identity, memory, self-awareness, INDEX, Status, then scan Backlog P0 and check Reports/Pending.
 
 ---
 
 ## Conditional (by task type)
 
 ### If executing a plan
 
-- Read the assigned plan in full before writing any code
+- Read the assigned plan in full before any dispatch
 - Read [Playbook/Standards/SecurityStandards.md](../../Playbook/Standards/SecurityStandards.md)
-- Read relevant coding standards from [agent/Skills/](../Skills/)
+- Read relevant skills from [agent/Skills/](../Skills/)
 
 ### If starting new work
 
-- Check if a plan exists in [Playbook/Plans/Active/](../../Playbook/Plans/Active/) — if not, ask the user
-- Read scope boundaries before touching any files
+- Check for an existing plan in [Playbook/Plans/Active/](../../Playbook/Plans/Active/); ask the user if none
+- Re-read scope-boundaries if touching new files
 
 ### If reviewing or reporting
 

catalog/sensors/compact-recovery/compact-recovery.sh.tmpl

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# Compact Recovery — {{ .AgentDisplayName }}
+# Re-injects minimal context after Claude Code /compact. Target: <2000 chars.
+
+ROOT="${1:-.}"
+WORKSPACE="${ROOT}/{{ .Workspace }}"
+
+echo "=== POST-COMPACT RECOVERY ==="
+echo ""
+
+# 1. Extract Quick Triggers table from workspace CLAUDE.md
+if [[ -f "${WORKSPACE}CLAUDE.md" ]]; then
+  echo "--- Quick Triggers (from CLAUDE.md) ---"
+  awk '/^### Quick Triggers/,/^### Protocols/' "${WORKSPACE}CLAUDE.md" | sed '/^### Protocols/d'
+  echo ""
+fi
+
+# 2. Extract Work State section from memory.md
+if [[ -f "${WORKSPACE}agent/Core/memory.md" ]]; then
+  echo "--- Work State (from memory.md) ---"
+  awk '/^## Work State/,/^## Notes/' "${WORKSPACE}agent/Core/memory.md" | sed '/^## Notes/d'
+  echo ""
+fi
+
+echo "Context compacted. Resume from Work State above. If uncertain, re-read memory.md and Status.md."

catalog/sensors/compact-recovery/meta.yaml

@@ -0,0 +1,6 @@
+name: compact-recovery
+description: Re-injects minimal context after /compact (Quick Triggers + Work State only)
+agents: all
+required: all
+event: SessionStart
+matcher: "compact"

catalog/sensors/context-guard/context-guard.sh.tmpl

@@ -119,6 +119,53 @@ if triggered:
         )
     injection = (injection + '\\n' + checklist) if injection else checklist
 
+# ── Verification triggers — word-boundary only, not end-anchored ────────────
+
+verify_patterns = [
+    r'\\bverify\\s+(everything|it\\s+all)\\b',
+    r'\\bcheck\\s+(your|the)\\s+work\\b',
+    r'\\bcheck\\s+if\\s+you\\s+missed\\b',
+    r'\\breview\\s+(your|the)\\s+changes\\b',
+    r'\\breview\\s+before\\s+(commit|push|ship)\\b',
+    r'\\bdoes\\s+everything\\s+look\\s+(right|good)\\b',
+]
+
+verify_hit = any(re.search(p, normalized) for p in verify_patterns)
+
+if verify_hit:
+    checklist = (
+        '\\nVERIFICATION REQUESTED. Before proceeding:\\n'
+        '1. Re-read your own changes — check for bugs, edge cases, regressions\\n'
+        '2. Verify all tests pass (if applicable)\\n'
+        '3. Check for stale references in documentation\\n'
+        '4. Confirm no security issues introduced'
+    )
+    injection = (injection + '\\n' + checklist) if injection else checklist
+
+# ── Planning triggers — word-boundary only ──────────────────────────────────
+
+plan_patterns = [
+    r'\\b(lets|let\\s+us)\\s+plan\\b',
+    r'\\bplan\\s+(this|the|a)\\b',
+    r'\\bcreate\\s+a\\s+plan\\b',
+    r'\\bdesign\\s+(this|the|a)\\b',
+    r'\\barchitect\\s+(this|the|a)\\b',
+]
+
+plan_hit = any(re.search(p, normalized) for p in plan_patterns)
+
+if plan_hit:
+    reminder = (
+        '\\nPLANNING DETECTED. Before drafting a plan:\\n'
+        '1. Load planning workflow: {workspace}agent/Workflows/planning.md\\n'
+        '2. Load planning-template skill: {workspace}agent/Skills/planning-template.md\\n'
+        '3. Follow the Tier rules and Verification requirements'
+    ).replace('{workspace}', os.path.join(root, ''))
+    # Only inject planning reminder if no wrap-up trigger already fired
+    # (avoid triple-stacking injections)
+    if not triggered:
+        injection = (injection + '\\n' + reminder) if injection else reminder
+
 # ── Output ──────────────────────────────────────────────────────────────────
 
 if not injection:

catalog/sensors/session-context/meta.yaml

@@ -3,3 +3,4 @@ description: Injects core identity, memory, protocols, and project status at ses
 agents: all
 required: all
 event: SessionStart
+matcher: "startup|resume|clear"

catalog/sensors/session-context/session-context.sh.tmpl

@@ -40,32 +40,71 @@ if [[ -n "$DOCS" ]]; then
     cat "${DOCS}Playbook/Status.md"
   fi
 
+  # FieldNotes: skip dump when file is effectively empty (only header/separators).
+  # Effectively empty = 1 or fewer non-blank, non-header-marker, non-frontmatter lines
+  # after removing the top YAML frontmatter block and markdown headings.
   if [[ -f "${DOCS}Logs/FieldNotes.md" ]]; then
-    echo ""
-    echo "=== Logs/FieldNotes.md ==="
-    cat "${DOCS}Logs/FieldNotes.md"
+    content_lines=$(awk '
+      BEGIN { in_fm = 0; fm_done = 0 }
+      NR == 1 && /^---[[:space:]]*$/ { in_fm = 1; next }
+      in_fm && /^---[[:space:]]*$/ { in_fm = 0; fm_done = 1; next }
+      in_fm { next }
+      /^[[:space:]]*$/ { next }
+      /^#/ { next }
+      /^---[[:space:]]*$/ { next }
+      /^>/ { next }
+      { count++ }
+      END { print count + 0 }
+    ' "${DOCS}Logs/FieldNotes.md")
+    if [[ "$content_lines" -gt 1 ]]; then
+      echo ""
+      echo "=== Logs/FieldNotes.md ==="
+      cat "${DOCS}Logs/FieldNotes.md"
+    fi
   fi
 
-  # Pending reports
+  # Pending reports: summarize (name + description) instead of full cat.
   if [[ -d "${DOCS}Reports/Pending/" ]] && [ -n "$(ls -A "${DOCS}Reports/Pending/" 2>/dev/null)" ]; then
     echo ""
     echo "=== Reports/Pending/ ==="
     for f in "${DOCS}Reports/Pending/"*; do
+      [[ -f "$f" ]] || continue
       echo ""
       echo "--- $(basename "$f") ---"
-      cat "$f"
+      # Try to extract description from YAML frontmatter first
+      desc=$(awk '
+        BEGIN { in_fm = 0 }
+        NR == 1 && /^---[[:space:]]*$/ { in_fm = 1; next }
+        in_fm && /^---[[:space:]]*$/ { exit }
+        in_fm && /^description:/ {
+          sub(/^description:[[:space:]]*/, "")
+          print
+          exit
+        }
+      ' "$f")
+      if [[ -n "$desc" ]]; then
+        echo "$desc"
+      else
+        # Fallback: first non-empty, non-separator line
+        awk '
+          /^---[[:space:]]*$/ { next }
+          /^[[:space:]]*$/ { next }
+          { print; exit }
+        ' "$f"
+      fi
     done
   fi
 fi
 
 # ── Protocols ───────────────────────────────────────────────────────────────
-{{ range .Protocols }}
-
+{{ range .Protocols -}}
+{{ if and (ne . "memory") (ne . "session-start") }}
 if [[ -f "${WORKSPACE}agent/Protocols/{{ . }}.md" ]]; then
   echo ""
   echo "=== PROTOCOL: {{ . }}.md ==="
   cat "${WORKSPACE}agent/Protocols/{{ . }}.md"
 fi
+{{ end -}}
 {{ end }}
 
 # ── Health checks ───────────────────────────────────────────────────────────
@@ -115,10 +154,3 @@ if [[ -n "$DOCS" ]] && [[ -d "${DOCS}Logs/" ]]; then
     fi
   fi
 fi
-
-# End-of-session reminder
-echo ""
-echo "REMINDER: Before ending this session:"
-echo "  - Update memory.md with current work state"
-echo "  - Update Status.md if any tasks changed status"
-echo "  - Write session log if significant work was done"

station/.claude/settings.json

@@ -16,33 +16,47 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bash -c 'r=\"$PWD\"; while [ \"$r\" != \"/\" ] \u0026\u0026 [ ! -f \"$r/.bonsai.yaml\" ]; do r=$(dirname \"$r\"); done; bash \"$r/station/agent/Sensors/dispatch-guard.sh\" \"$r\"'"
+            "command": "bash -c 'r=\"$PWD\"; while [ \"$r\" != \"/\" ] \u0026\u0026 [ ! -f \"$r/.bonsai.yaml\" ]; do r=$(dirname \"$r\"); done; bash \"$r/station/agent/Sensors/scope-guard-files.sh\" \"$r\"'"
           }
         ],
-        "matcher": "Agent"
+        "matcher": "Edit|Write"
       },
       {
         "hooks": [
           {
             "type": "command",
-            "command": "bash -c 'r=\"$PWD\"; while [ \"$r\" != \"/\" ] \u0026\u0026 [ ! -f \"$r/.bonsai.yaml\" ]; do r=$(dirname \"$r\"); done; bash \"$r/station/agent/Sensors/scope-guard-files.sh\" \"$r\"'"
+            "command": "bash -c 'r=\"$PWD\"; while [ \"$r\" != \"/\" ] \u0026\u0026 [ ! -f \"$r/.bonsai.yaml\" ]; do r=$(dirname \"$r\"); done; bash \"$r/station/agent/Sensors/dispatch-guard.sh\" \"$r\"'"
           }
         ],
-        "matcher": "Edit|Write"
+        "matcher": "Agent"
       }
     ],
     "SessionStart": [
       {
         "hooks": [
-          {
-            "type": "command",
-            "command": "bash -c 'r=\"$PWD\"; while [ \"$r\" != \"/\" ] \u0026\u0026 [ ! -f \"$r/.bonsai.yaml\" ]; do r=$(dirname \"$r\"); done; bash \"$r/station/agent/Sensors/session-context.sh\" \"$r\"'"
-          },
           {
             "type": "command",
             "command": "bash -c 'r=\"$PWD\"; while [ \"$r\" != \"/\" ] \u0026\u0026 [ ! -f \"$r/.bonsai.yaml\" ]; do r=$(dirname \"$r\"); done; bash \"$r/station/agent/Sensors/routine-check.sh\" \"$r\"'"
           }
         ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash -c 'r=\"$PWD\"; while [ \"$r\" != \"/\" ] \u0026\u0026 [ ! -f \"$r/.bonsai.yaml\" ]; do r=$(dirname \"$r\"); done; bash \"$r/station/agent/Sensors/compact-recovery.sh\" \"$r\"'"
+          }
+        ],
+        "matcher": "compact"
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash -c 'r=\"$PWD\"; while [ \"$r\" != \"/\" ] \u0026\u0026 [ ! -f \"$r/.bonsai.yaml\" ]; do r=$(dirname \"$r\"); done; bash \"$r/station/agent/Sensors/session-context.sh\" \"$r\"'"
+          }
+        ],
+        "matcher": "startup|resume|clear"
       }
     ],
     "Stop": [

station/.claude/skills/code-review/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: code-review
+description: Reviewing agent output against the plan for correctness and standards. Checking implementation changes before merging
+when_to_use: Reviewing agent output against the plan for correctness and standards; Checking implementation changes before merging
+---
+
+Load and follow the **Code Review** workflow at `station/agent/Workflows/code-review.md`.
+
+## Examples
+
+> **User:** "Review the changes on the feature branch"
+> **Action:** Load code-review workflow, diff branch against main, check plan compliance
+

station/.claude/skills/issue-to-implementation/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: issue-to-implementation
+description: Taking an issue from intake through to shipped code. Running the full autonomous implementation workflow
+when_to_use: Taking an issue from intake through to shipped code; Running the full autonomous implementation workflow
+---
+
+Load and follow the **Issue To Implementation** workflow at `station/agent/Workflows/issue-to-implementation.md`.
+
+## Examples
+
+> **User:** "Pick up issue #15 and ship it"
+> **Action:** Load issue-to-implementation workflow, analyze issue, plan, dispatch, review, merge
+