@suwujs/codex-vault 0.6.0 → 0.7.0

package/README.md

@@ -63,20 +63,20 @@ git commit (persistent)
 Next session → session-start hook injects context back
 ```
 
-Three hooks power the loop:
+Hooks power the loop:
 
-| Hook | When | What |
-|------|------|------|
-| **session-start** | Agent starts | Injects North Star goals, recent git changes, active work, vault file listing |
-| **classify-message** | Every message | Detects decisions, wins, project updates — hints the agent where to file them |
-| **validate-write** | After writing `.md` | Checks frontmatter and wikilinks — catches mistakes before they stick |
+| Hook | When | What | Claude Code | Codex CLI |
+|------|------|------|-------------|-----------|
+| **session-start** | Agent starts | Injects North Star goals, recent git changes, active work, vault file listing | SessionStart | SessionStart |
+| **classify-message** | Every message | Detects decisions, wins, project updates — hints the agent where to file them | UserPromptSubmit | UserPromptSubmit |
+| **validate-write** | After writing `.md` | Checks frontmatter and wikilinks — catches mistakes before they stick | PostToolUse (Write\|Edit) | N/A (Codex only supports Bash) |
 
 ## Supported Agents
 
 | Agent | Hooks | Skills | Status |
 |-------|-------|--------|--------|
 | Claude Code | 3 hooks via `.claude/settings.json` | `/dump` `/recall` `/ingest` `/wrap-up` | Full support |
-| Codex CLI | 3 hooks via `.codex/hooks.json` | `$dump` `$recall` `$ingest` `$wrap-up` | Full support |
+| Codex CLI | 2 hooks via `.codex/hooks.json` | `$dump` `$recall` `$ingest` `$wrap-up` | Full support (PostToolUse limited to Bash by Codex) |
 | Other | Write an adapter ([docs/adding-an-agent.md](docs/adding-an-agent.md)) | Depends on agent | Community |
 
 ## Vault Structure

package/README.zh-CN.md

@@ -95,20 +95,20 @@ git commit（持久化）
 下次 session → session-start hook 注入上下文
 ```
 
-三个 hook 驱动整个循环：
+Hook 驱动整个循环：
 
-| Hook | 触发时机 | 做什么 |
-|------|---------|--------|
-| **session-start** | Agent 启动 | 注入 North Star 目标、近期 git 变更、活跃项目、vault 文件清单 |
-| **classify-message** | 每条消息 | 检测决策、成果、项目更新 — 提示 agent 该归档到哪里 |
-| **validate-write** | 写 `.md` 后 | 检查 frontmatter 和 wikilinks — 在落盘前纠错 |
+| Hook | 触发时机 | 做什么 | Claude Code | Codex CLI |
+|------|---------|--------|-------------|-----------|
+| **session-start** | Agent 启动 | 注入 North Star 目标、近期 git 变更、活跃项目、vault 文件清单 | SessionStart | SessionStart |
+| **classify-message** | 每条消息 | 检测决策、成果、项目更新 — 提示 agent 该归档到哪里 | UserPromptSubmit | UserPromptSubmit |
+| **validate-write** | 写 `.md` 后 | 检查 frontmatter 和 wikilinks — 在落盘前纠错 | PostToolUse (Write\|Edit) | 不支持（Codex 仅支持 Bash） |
 
 ## 支持的 Agent
 
 | Agent | Hooks | Skills | 状态 |
 |-------|-------|--------|------|
 | Claude Code | `.claude/settings.json` 3 hooks | `/dump` `/recall` `/ingest` `/wrap-up` | 完整支持 |
-| Codex CLI | `.codex/hooks.json` 3 hooks | `$dump` `$recall` `$ingest` `$wrap-up` | 完整支持 |
+| Codex CLI | `.codex/hooks.json` 2 hooks | `$dump` `$recall` `$ingest` `$wrap-up` | 完整支持（PostToolUse 受 Codex 限制仅支持 Bash） |
 | 其他 | 写适配器（[指南](docs/adding-an-agent.md)） | 取决于 agent | 社区贡献 |
 
 ## Vault 结构

package/bin/codex-vault-run.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# Codex-Vault wrapper — shows vault banner then launches Codex CLI
+# Usage: codex-vault-run [codex args...]
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_DIR="$(pwd)"
+
+# Find session-start hook relative to project or plugin
+HOOK=""
+for candidate in \
+  "$PROJECT_DIR/plugin/hooks/codex/session-start.py" \
+  "$PROJECT_DIR/.codex-vault/hooks/codex/session-start.py" \
+  "$SCRIPT_DIR/../plugin/hooks/codex/session-start.py"; do
+  if [ -f "$candidate" ]; then
+    HOOK="$candidate"
+    break
+  fi
+done
+
+if [ -n "$HOOK" ]; then
+  SUMMARY=$(echo '{}' | python3 "$HOOK" 2>/dev/null \
+    | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('systemMessage',''))" 2>/dev/null)
+  if [ -n "$SUMMARY" ]; then
+    echo "  $SUMMARY"
+  fi
+fi
+
+exec codex "$@"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@suwujs/codex-vault",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Persistent knowledge vault for LLM agents (Claude Code, Codex CLI)",
   "license": "MIT",
   "repository": {

package/plugin/hooks/codex/classify-message.py

@@ -283,16 +283,14 @@ def main():
         icon = "\U0001f504" if mode == "auto" else "\U0001f4a1"
         label = ", ".join(feedback_parts) if feedback_parts else "intent detected"
 
-        # Codex CLI: use stderr for feedback (no systemMessage rendering)
-        sys.stderr.write(f"  {icon} vault: {label}\n")
-
+        # hookSpecificOutput + additionalContext → injected into LLM context
         output = {
             "hookSpecificOutput": {
                 "hookEventName": "UserPromptSubmit",
                 "additionalContext": context
-            },
+            }
         }
-        json.dump(output, sys.stdout)
+        sys.stdout.write(json.dumps(output) + "\n")
         sys.stdout.flush()
 
     sys.exit(0)

package/plugin/hooks/codex/session-start.py

@@ -351,7 +351,7 @@ def main():
                 "additionalContext": "## Session Context\n\n(No vault found)"
             }
         }
-        json.dump(output, sys.stdout)
+        sys.stdout.write(json.dumps(output) + "\n")
         sys.exit(0)
 
     # Read hook input for session metadata
@@ -361,20 +361,33 @@ def main():
         event = {}
 
     context = _build_context(vault_dir)
-    banner = _build_banner(vault_dir)
 
-    # Codex CLI: systemMessage not rendered by TUI,
-    # use stderr for terminal visibility (best effort)
-    sys.stderr.write(banner + "\n")
+    # Build a short summary for user-facing display
+    goal = _north_star_goal(vault_dir)
+    active_dir = os.path.join(vault_dir, "work", "active")
+    work_count = len([f for f in os.listdir(active_dir) if f.endswith(".md")]) if os.path.isdir(active_dir) else 0
+    changes = _git_status_short(vault_dir)
+    all_files = _find_md_files(vault_dir)
+
+    summary_parts = ["[Vault]"]
+    branch = _run_git(["rev-parse", "--abbrev-ref", "HEAD"], vault_dir)
+    if branch:
+        summary_parts.append(branch[0])
+    if goal:
+        summary_parts.append(f"goal: {goal}")
+    summary_parts.append(f"active:{work_count}")
+    summary_parts.append(f"changes:{len(changes)}")
+    summary_parts.append(f"{len(all_files)} notes")
+    summary = " | ".join(summary_parts)
 
     output = {
         "hookSpecificOutput": {
             "hookEventName": "SessionStart",
             "additionalContext": context
         },
+        "systemMessage": summary
     }
-
-    json.dump(output, sys.stdout)
+    sys.stdout.write(json.dumps(output) + "\n")
     sys.stdout.flush()
     sys.exit(0)
 

package/plugin/hooks/codex/validate-write.py

@@ -1,121 +1,113 @@
 #!/usr/bin/env python3
-"""Post-write validation for vault notes — Codex CLI version.
+"""PostToolUse hook for Codex CLI — Bash command validation.
 
-Checks frontmatter and wikilinks on any .md file written to the vault.
-Outputs hookSpecificOutput for Codex CLI. Feedback via stderr
-(Codex CLI does not render systemMessage).
-
-Note: Codex CLI PostToolUse only supports Bash matcher, so this script
-will only run when triggered by a Bash tool writing .md files. The
-validation logic is identical to the Claude Code version.
+Checks Bash command output for hard failures (command not found,
+permission denied, missing paths) and non-zero exit codes with
+informative output. Modeled after oh-my-codex's native PostToolUse.
 """
 import json
 import re
 import sys
-import os
-from pathlib import Path
 
 
-def _check_log_format(content):
-    """Validate log.md entry format: ## [YYYY-MM-DD] <type> | <title>"""
-    warnings = []
-    for i, line in enumerate(content.splitlines(), 1):
-        if line.startswith("## ") and not line.startswith("## ["):
-            # Heading that looks like a log entry but missing date brackets
-            if any(t in line.lower() for t in ["ingest", "session", "query", "maintenance", "decision", "archive"]):
-                warnings.append(f"Line {i}: log entry missing date format — expected `## [YYYY-MM-DD] <type> | <title>`")
-        elif line.startswith("## ["):
-            if not re.match(r"^## \[\d{4}-\d{2}-\d{2}\] \w+", line):
-                warnings.append(f"Line {i}: malformed log entry — expected `## [YYYY-MM-DD] <type> | <title>`")
-    return warnings
+HARD_FAILURE_PATTERNS = re.compile(
+    r"command not found|permission denied|no such file or directory",
+    re.IGNORECASE,
+)
+
+
+def _safe_string(value):
+    return value if isinstance(value, str) else ""
+
+
+def _safe_int(value):
+    if isinstance(value, int):
+        return value
+    if isinstance(value, str) and value.strip().lstrip("-").isdigit():
+        return int(value.strip())
+    return None
+
+
+def _parse_tool_response(raw):
+    """Try to parse tool_response as JSON dict."""
+    if isinstance(raw, dict):
+        return raw
+    if isinstance(raw, str):
+        try:
+            parsed = json.loads(raw)
+            if isinstance(parsed, dict):
+                return parsed
+        except (ValueError, TypeError):
+            pass
+    return None
 
 
 def main():
     try:
-        input_data = json.load(sys.stdin)
+        payload = json.load(sys.stdin)
     except (ValueError, EOFError, OSError):
         sys.exit(0)
 
-    tool_input = input_data.get("tool_input")
-    if not isinstance(tool_input, dict):
+    tool_name = _safe_string(payload.get("tool_name", "")).strip()
+    if tool_name != "Bash":
         sys.exit(0)
 
-    file_path = tool_input.get("file_path", "")
-    if not isinstance(file_path, str) or not file_path:
-        sys.exit(0)
+    # Extract command and response
+    tool_input = payload.get("tool_input") if isinstance(payload.get("tool_input"), dict) else {}
+    command = _safe_string(tool_input.get("command", "")).strip()
 
-    if not file_path.endswith(".md"):
-        sys.exit(0)
+    raw_response = payload.get("tool_response")
+    parsed = _parse_tool_response(raw_response)
 
-    normalized = file_path.replace("\\", "/")
-    basename = os.path.basename(normalized)
+    exit_code = None
+    stdout_text = ""
+    stderr_text = ""
 
-    # Skip non-vault files
-    skip_names = {"README.md", "CHANGELOG.md", "CONTRIBUTING.md", "CLAUDE.md", "AGENTS.md", "LICENSE"}
-    if basename in skip_names:
-        sys.exit(0)
-    if basename.startswith("README.") and basename.endswith(".md"):
-        sys.exit(0)
+    if parsed:
+        exit_code = _safe_int(parsed.get("exit_code")) or _safe_int(parsed.get("exitCode"))
+        stdout_text = _safe_string(parsed.get("stdout", "")).strip()
+        stderr_text = _safe_string(parsed.get("stderr", "")).strip()
+    else:
+        stdout_text = _safe_string(raw_response).strip()
 
-    skip_paths = [".claude/", ".codex/", ".codex-vault/", ".mind/", "templates/", "thinking/", "node_modules/", "plugin/", "docs/"]
-    if any(skip in normalized for skip in skip_paths):
+    combined = f"{stderr_text}\n{stdout_text}".strip()
+    if not combined:
         sys.exit(0)
 
-    warnings = []
-
-    try:
-        content = Path(file_path).read_text(encoding="utf-8")
-
-        if not content.startswith("---"):
-            warnings.append("Missing YAML frontmatter")
-        else:
-            parts = content.split("---", 2)
-            if len(parts) >= 3:
-                fm = parts[1]
-                if "date:" not in fm and basename != "log.md":
-                    warnings.append("Missing `date` in frontmatter")
-                if "tags:" not in fm:
-                    warnings.append("Missing `tags` in frontmatter")
-                if "description:" not in fm:
-                    warnings.append("Missing `description` in frontmatter (~150 chars)")
-
-        if len(content) > 300 and "[[" not in content:
-            warnings.append("No [[wikilinks]] found — every note should link to at least one other note")
-
-        # Check for unfilled template placeholders
-        placeholders = re.findall(r"\{\{[^}]+\}\}", content)
-        if placeholders:
-            examples = ", ".join(placeholders[:3])
-            warnings.append(f"Unfilled template placeholders found: {examples}")
-
-        # Validate log.md format
-        if basename == "log.md":
-            log_warnings = _check_log_format(content)
-            warnings.extend(log_warnings)
-
-    except Exception:
+    # Check for hard failures
+    if HARD_FAILURE_PATTERNS.search(combined):
+        output = {
+            "decision": "block",
+            "reason": "Bash output indicates a command/setup failure that should be fixed before retrying.",
+            "hookSpecificOutput": {
+                "hookEventName": "PostToolUse",
+                "additionalContext": (
+                    "Bash reported `command not found`, `permission denied`, or a missing file/path. "
+                    "Verify the command, dependency installation, PATH, file permissions, "
+                    "and referenced paths before retrying."
+                ),
+            },
+        }
+        sys.stdout.write(json.dumps(output) + "\n")
+        sys.stdout.flush()
         sys.exit(0)
 
-    if warnings:
-        hint_list = "\n".join(f"  - {w}" for w in warnings)
-        count = len(warnings)
-        first = warnings[0]
-        if count == 1:
-            feedback = f"\u26a0\ufe0f  vault: {basename} — {first}"
-        else:
-            feedback = f"\u26a0\ufe0f  vault: {basename} — {first} (+{count - 1} more)"
-
-        # Codex CLI: use stderr for feedback (no systemMessage rendering)
-        sys.stderr.write(f"  {feedback}\n")
-
+    # Check for non-zero exit code with informative output
+    if exit_code is not None and exit_code != 0 and len(combined) > 0:
         output = {
+            "decision": "block",
+            "reason": "Bash command returned a non-zero exit code but produced useful output that should be reviewed before retrying.",
             "hookSpecificOutput": {
                 "hookEventName": "PostToolUse",
-                "additionalContext": f"Vault warnings for `{basename}`:\n{hint_list}\nFix these before moving on."
+                "additionalContext": (
+                    "The Bash output appears informative despite the non-zero exit code. "
+                    "Review and report the output before retrying instead of assuming the command simply failed."
+                ),
             },
         }
-        json.dump(output, sys.stdout)
+        sys.stdout.write(json.dumps(output) + "\n")
         sys.stdout.flush()
+        sys.exit(0)
 
     sys.exit(0)
 

package/vault/.codex-vault/hooks/codex/classify-message.py

@@ -283,16 +283,12 @@ def main():
         icon = "\U0001f504" if mode == "auto" else "\U0001f4a1"
         label = ", ".join(feedback_parts) if feedback_parts else "intent detected"
 
-        # Codex CLI: use stderr for feedback (no systemMessage rendering)
-        sys.stderr.write(f"  {icon} vault: {label}\n")
-
-        output = {
-            "hookSpecificOutput": {
-                "hookEventName": "UserPromptSubmit",
-                "additionalContext": context
-            },
-        }
-        json.dump(output, sys.stdout)
+        # stdout print → directly displayed to user
+        print(f"  {icon} vault: {label}")
+
+        # systemMessage → injected into LLM context
+        result = {"systemMessage": context}
+        sys.stdout.write(json.dumps(result))
         sys.stdout.flush()
 
     sys.exit(0)

package/vault/.codex-vault/hooks/codex/session-start.py

@@ -345,13 +345,9 @@ def _build_banner(vault_dir):
 def main():
     vault_dir = _find_vault_root()
     if not vault_dir:
-        output = {
-            "hookSpecificOutput": {
-                "hookEventName": "SessionStart",
-                "additionalContext": "## Session Context\n\n(No vault found)"
-            }
-        }
-        json.dump(output, sys.stdout)
+        print("📚 Codex-Vault: No vault found")
+        result = {"systemMessage": "## Session Context\n\n(No vault found)"}
+        sys.stdout.write(json.dumps(result))
         sys.exit(0)
 
     # Read hook input for session metadata
@@ -361,20 +357,21 @@ def main():
         event = {}
 
     context = _build_context(vault_dir)
-    banner = _build_banner(vault_dir)
 
-    # Codex CLI: systemMessage not rendered by TUI,
-    # use stderr for terminal visibility (best effort)
-    sys.stderr.write(banner + "\n")
+    # stdout print → directly displayed to user
+    goal = _north_star_goal(vault_dir)
+    active_dir = os.path.join(vault_dir, "work", "active")
+    work_count = len([f for f in os.listdir(active_dir) if f.endswith(".md")]) if os.path.isdir(active_dir) else 0
+    changes = _git_status_short(vault_dir)
 
-    output = {
-        "hookSpecificOutput": {
-            "hookEventName": "SessionStart",
-            "additionalContext": context
-        },
-    }
+    print("📚 Codex-Vault loaded!")
+    if goal:
+        print(f"🎯 {goal}")
+    print(f"📝 Active: {work_count} | Changes: {len(changes)}")
 
-    json.dump(output, sys.stdout)
+    # systemMessage → injected into LLM context
+    result = {"systemMessage": context}
+    sys.stdout.write(json.dumps(result))
     sys.stdout.flush()
     sys.exit(0)
 

package/vault/AGENTS.md

@@ -1,118 +1 @@
-# Codex-Vault — Core Instructions
-
-A structured knowledge vault maintained by an LLM agent. You write notes, maintain links, and keep indexes current. The human curates sources, directs analysis, and asks questions.
-
-## Vault Structure
-
-| Folder | Purpose |
-|--------|---------|
-| `Home.md` | Vault entry point — quick links, current focus |
-| `brain/` | Persistent memory — goals, decisions, patterns |
-| `work/` | Work notes index (`Index.md`) |
-| `work/active/` | Current projects (move to archive when done) |
-| `work/archive/` | Completed work |
-| `templates/` | Note templates with YAML frontmatter |
-| `sources/` | Raw source documents — immutable, LLM reads only |
-| `thinking/` | Scratchpad — promote findings, then delete |
-| `reference/` | Saved answers and analyses from query writeback |
-
-## Session Lifecycle
-
-### Start
-
-The SessionStart hook injects: North Star goals, recent git changes, active work, vault file listing. You start with context, not a blank slate.
-
-### Work
-
-1. The classify hook detects intent and suggests skills — **do not auto-execute**. Suggest the skill to the user and let them decide.
-2. Available skills: `/dump`, `/recall`, `/ingest`, `/wrap-up`
-3. Search before creating — check if a related note exists (use `/recall <topic>` for targeted vault search)
-4. Update `work/Index.md` if a new note was created
-
-### End
-
-When the user says "wrap up" or similar:
-1. Verify new notes have frontmatter and wikilinks
-2. Update `work/Index.md` with any new or completed notes
-3. Archive completed projects: move from `work/active/` to `work/archive/`
-4. Check if `brain/` notes need updating with new decisions or patterns
-
-## Creating Notes
-
-1. **Always use YAML frontmatter**: `date`, `description` (~150 chars), `tags`
-2. **Use templates** from `templates/`
-3. **Place files correctly**: active work in `work/active/`, completed in `work/archive/`, source summaries in `work/active/` (tag: `source-summary`), drafts in `thinking/`
-4. **Name files descriptively** — use the note title as filename
-
-## Linking — Critical
-
-**Graph-first.** Folders group by purpose, links group by meaning. A note lives in one folder but links to many notes.
-
-**A note without links is a bug.** Every new note must link to at least one existing note via `[[wikilinks]]`.
-
-Link syntax:
-- `[[Note Title]]` — standard wikilink
-- `[[Note Title|display text]]` — aliased
-- `[[Note Title#Heading]]` — deep link
-
-### When to Link
-
-- Work note ↔ Decision Record (bidirectional)
-- Index → all work notes
-- North Star → active projects
-- Memories → source notes
-
-## Memory System
-
-All persistent memory lives in `brain/`:
-
-| File | Stores |
-|------|--------|
-| `North Star.md` | Goals and focus areas — read every session |
-| `Memories.md` | Index of memory topics |
-| `Key Decisions.md` | Decisions worth recalling across sessions |
-| `Patterns.md` | Recurring patterns discovered across work |
-
-When asked to "remember" something: write to the appropriate `brain/` file with a wikilink to context.
-
-## Sources & Ingest
-
-`sources/` holds raw source documents (articles, papers, web clips). This is the immutable layer — the agent reads from it but never modifies source files.
-
-- Drop raw files into `sources/` (markdown preferred) or use `/ingest` with a URL
-- `/ingest` reads the source, discusses key takeaways, then creates a **Source Summary** in `work/active/` with tag `source-summary`
-- The summary uses the Source Summary template: Key Takeaways, Summary, Connections, Quotes/Data Points
-- Every ingest updates `work/Index.md` (Sources section) and checks for cross-links to existing notes
-- If the source contains decisions or patterns, update the relevant `brain/` notes too
-- Source summaries link back to the raw source via the `source` frontmatter field
-
-## Operation Log
-
-Append to `log.md` after significant operations: ingests, decisions, project archives, maintenance passes.
-
-- Format: `## [YYYY-MM-DD] <type> | <title>` followed by bullet points
-- Types: `ingest`, `session`, `query`, `maintenance`, `decision`, `archive`
-- Don't log every small edit — only operations that change the vault's knowledge state
-- Entries are append-only; never edit or delete previous entries
-
-## Query Writeback
-
-When answering a substantial question that synthesizes multiple vault notes:
-
-1. Offer: "This answer could be useful later — want me to save it as a reference note?"
-2. If yes, create a Reference Note in `reference/` using the template
-3. Link the reference note from related work notes in `## Related`
-4. Add the reference note to `work/Index.md` under `## Reference`
-5. Don't prompt for trivial questions — only for answers that synthesize, compare, or analyze
-
-## Vault Location
-
-The vault may live at the project root or in a `vault/` subdirectory. Use the SessionStart context to determine the actual path. All folder references above (e.g. `brain/`, `work/active/`) are relative to the vault root.
-
-## Rules
-
-- Preserve existing frontmatter when editing notes
-- Always check for and suggest connections between notes
-- Every note must have a `description` field (~150 chars)
-- When reorganizing, never delete without user confirmation
-- Use `[[wikilinks]]` not markdown links
+@CLAUDE.md

package/plugin/hooks/session-start.sh

@@ -1,221 +0,0 @@
-#!/bin/bash
-set -eo pipefail
-
-# Codex-Vault session-start hook
-# Injects vault context into the agent's prompt at session start.
-# Works with any agent that supports SessionStart hooks (Claude Code, Codex CLI).
-#
-# Output contract (matches claude-mem pattern):
-#   stdout → JSON with hookSpecificOutput.additionalContext (agent context)
-#   stderr → visible banner (user terminal)
-#
-# Dynamic context: adapts git log window, reads full North Star,
-# shows all active work, and includes uncommitted changes.
-
-VAULT_DIR="${CLAUDE_PROJECT_DIR:-${CODEX_PROJECT_DIR:-$(pwd)}}"
-cd "$VAULT_DIR"
-
-# Find vault root (look for Home.md or brain/ directory)
-if [ ! -f "Home.md" ] && [ ! -d "brain/" ]; then
-  # Try vault/ subdirectory (integrated layout)
-  if [ -d "vault/" ]; then
-    VAULT_DIR="$VAULT_DIR/vault"
-    cd "$VAULT_DIR"
-  fi
-fi
-
-# --- Visible banner (stderr → user terminal) ---
-{
-  echo ""
-  echo "  📚 Codex-Vault · Session Loaded"
-
-  # North Star preview
-  if [ -f "brain/North Star.md" ]; then
-    GOAL=$(sed -n '/^## Current Focus/,/^## /{/^- ./{s/^- //;p;q;};}' "brain/North Star.md" | cut -c1-40)
-    [ -n "$GOAL" ] && echo "  🎯 $GOAL" || echo "  🎯 (set goals in North Star.md)"
-  else
-    echo "  🎯 (create brain/North Star.md)"
-  fi
-
-  # Active work count
-  WORK_COUNT=$(find work/active -name "*.md" 2>/dev/null | wc -l | tr -d ' ')
-  echo "  📋 $WORK_COUNT active project(s)"
-
-  # Uncommitted changes count
-  CHANGE_COUNT=$(git status --short -- . 2>/dev/null | wc -l | tr -d ' ')
-  if [ "$CHANGE_COUNT" -gt 0 ]; then
-    echo "  ✏️  $CHANGE_COUNT uncommitted change(s)"
-  else
-    echo "  ✅ working tree clean"
-  fi
-  echo ""
-} >&2
-
-# --- Collect context into variable ---
-CONTEXT=$(
-cat <<'CONTEXT_HEADER'
-## Session Context
-
-CONTEXT_HEADER
-
-echo "### Date"
-echo "$(date +%Y-%m-%d) ($(date +%A))"
-echo ""
-
-# North Star — full file (should be concise by design)
-echo "### North Star"
-if [ -f "brain/North Star.md" ]; then
-  cat "brain/North Star.md"
-else
-  echo "(No North Star found — create brain/North Star.md to set goals)"
-fi
-echo ""
-
-# Recent changes — adaptive window
-echo "### Recent Changes"
-COMMITS_48H=$(git log --oneline --since="48 hours ago" --no-merges 2>/dev/null | wc -l | tr -d ' ')
-if [ "$COMMITS_48H" -gt 0 ]; then
-  echo "(last 48 hours)"
-  git log --oneline --since="48 hours ago" --no-merges 2>/dev/null | head -15 || true
-else
-  COMMITS_7D=$(git log --oneline --since="7 days ago" --no-merges 2>/dev/null | wc -l | tr -d ' ')
-  if [ "$COMMITS_7D" -gt 0 ]; then
-    echo "(nothing in 48h — showing last 7 days)"
-    git log --oneline --since="7 days ago" --no-merges 2>/dev/null | head -15 || true
-  else
-    echo "(nothing recent — showing last 5 commits)"
-    git log --oneline -5 --no-merges 2>/dev/null || echo "(no git history)"
-  fi
-fi
-echo ""
-
-# Recent operations from log — adaptive
-echo "### Recent Operations"
-if [ -f "log.md" ]; then
-  ENTRY_COUNT=$(grep -c "^## \[" "log.md" 2>/dev/null || echo "0")
-  if [ "$ENTRY_COUNT" -gt 0 ]; then
-    # Show last 5 entries with full header line (includes date + type)
-    grep "^## \[" "log.md" | tail -5
-  else
-    echo "(no entries in log.md)"
-  fi
-else
-  echo "(no log.md)"
-fi
-echo ""
-
-# Active work — show all (this is the current focus, no truncation)
-echo "### Active Work"
-if [ -d "work/active" ]; then
-  WORK_FILES=$(ls work/active/*.md 2>/dev/null || true)
-  if [ -n "$WORK_FILES" ]; then
-    echo "$WORK_FILES" | sed 's|work/active/||;s|\.md$||'
-  else
-    echo "(none)"
-  fi
-else
-  echo "(no work/active/ directory)"
-fi
-echo ""
-
-# Uncommitted changes — shows agent what's in-flight
-echo "### Uncommitted Changes"
-CHANGES=$(git status --short -- . 2>/dev/null | head -20 || true)
-if [ -n "$CHANGES" ]; then
-  echo "$CHANGES"
-else
-  echo "(working tree clean)"
-fi
-echo ""
-
-# Recently modified brain files — highlights memory that may need review
-echo "### Recently Modified Brain Files"
-if [ -d "brain" ]; then
-  GIT_DIR=$(git rev-parse --git-dir 2>/dev/null || echo "")
-  if [ -n "$GIT_DIR" ] && [ -f "$GIT_DIR/index" ]; then
-    RECENT_BRAIN=$(find brain/ -name "*.md" -newer "$GIT_DIR/index" 2>/dev/null || true)
-  else
-    RECENT_BRAIN=""
-  fi
-  if [ -n "$RECENT_BRAIN" ]; then
-    echo "$RECENT_BRAIN" | sed 's|brain/||;s|\.md$||'
-  else
-    # Fallback: show brain files modified in last 7 days
-    RECENT_BRAIN=$(find brain/ -name "*.md" -mtime -7 2>/dev/null || true)
-    if [ -n "$RECENT_BRAIN" ]; then
-      echo "(modified in last 7 days)"
-      echo "$RECENT_BRAIN" | sed 's|brain/||;s|\.md$||'
-    else
-      echo "(no recent changes)"
-    fi
-  fi
-fi
-echo ""
-
-# Vault file listing — tiered to avoid flooding context in large vaults
-echo "### Vault Files"
-ALL_FILES=$(find . -name "*.md" -not -path "./.git/*" -not -path "./.obsidian/*" -not -path "./thinking/*" -not -path "./.claude/*" -not -path "./.codex/*" -not -path "./.codex-vault/*" -not -path "./node_modules/*" 2>/dev/null | sort)
-FILE_COUNT=$(echo "$ALL_FILES" | grep -c . 2>/dev/null || echo "0")
-
-_folder_summary() {
-  echo "$ALL_FILES" | sed 's|^\./||' | cut -d/ -f1 | sort | uniq -c | sort -rn | while read count dir; do
-    echo "  $dir/ ($count files)"
-  done
-}
-
-_key_files() {
-  echo "$ALL_FILES" | grep -E "(Home|Index|North Star|Memories|Key Decisions|Patterns|log)\\.md$" || true
-}
-
-if [ "$FILE_COUNT" -le 20 ]; then
-  echo "$ALL_FILES"
-
-elif [ "$FILE_COUNT" -le 50 ]; then
-  HOT_FILES=$(echo "$ALL_FILES" | grep -v -E "^\./sources/|^\./work/archive/" || true)
-  COLD_COUNT=$(echo "$ALL_FILES" | grep -E "^\./sources/|^\./work/archive/" | grep -c . 2>/dev/null || echo "0")
-
-  if [ -n "$HOT_FILES" ]; then
-    echo "$HOT_FILES"
-  fi
-  if [ "$COLD_COUNT" -gt 0 ]; then
-    echo ""
-    echo "(+ $COLD_COUNT files in sources/ and work/archive/ — use /recall to search)"
-  fi
-
-elif [ "$FILE_COUNT" -le 150 ]; then
-  echo "($FILE_COUNT files — showing summary)"
-  echo ""
-  _folder_summary
-  echo ""
-  echo "Recently modified (7 days):"
-  find . -name "*.md" -mtime -7 -not -path "./.git/*" -not -path "./.obsidian/*" -not -path "./thinking/*" -not -path "./.claude/*" -not -path "./.codex/*" -not -path "./.codex-vault/*" -not -path "./node_modules/*" 2>/dev/null | sort || echo "  (none)"
-  echo ""
-  echo "Key files:"
-  _key_files
-
-else
-  echo "($FILE_COUNT files — showing summary)"
-  echo ""
-  _folder_summary
-  echo ""
-  echo "Recently modified (3 days):"
-  find . -name "*.md" -mtime -3 -not -path "./.git/*" -not -path "./.obsidian/*" -not -path "./thinking/*" -not -path "./.claude/*" -not -path "./.codex/*" -not -path "./.codex-vault/*" -not -path "./node_modules/*" 2>/dev/null | sort || echo "  (none)"
-  echo ""
-  echo "Key files:"
-  _key_files
-  echo ""
-  echo "Use /recall <topic> to search the vault."
-fi
-)
-
-# --- Output structured JSON (stdout → agent via hookSpecificOutput) ---
-python3 -c "
-import json, sys
-context = sys.stdin.read()
-json.dump({
-    'hookSpecificOutput': {
-        'hookEventName': 'SessionStart',
-        'additionalContext': context
-    }
-}, sys.stdout)
-" <<< "$CONTEXT"