@bookedsolid/reagent 0.14.0 → 0.14.2

package/hooks/reagent-obsidian-journal.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# reagent-obsidian-journal.sh — Session journaling to Obsidian daily note
+#
+# Hook type: Stop (fires when Claude Code session ends)
+# Appends session summary to the project's daily note via Obsidian CLI.
+# Fail-silent: exits 0 even on error (non-blocking).
+#
+# Requires:
+#   - /usr/local/bin/obsidian CLI installed
+#   - REAGENT_OBSIDIAN_VAULT env var set
+#   - obsidian_vault.sync.journal: true in .reagent/gateway.yaml
+
+set -euo pipefail
+
+OBSIDIAN_CLI="/usr/local/bin/obsidian"
+POLICY_DIR=".reagent"
+GATEWAY="${POLICY_DIR}/gateway.yaml"
+TASK_STORE="${POLICY_DIR}/tasks.jsonl"
+
+# ── Guard: CLI available ──────────────────────────────────────────────
+if [[ ! -x "$OBSIDIAN_CLI" ]]; then
+  exit 0
+fi
+
+# ── Guard: gateway.yaml exists ────────────────────────────────────────
+if [[ ! -f "$GATEWAY" ]]; then
+  exit 0
+fi
+
+# ── Guard: journal sync enabled ──────────────────────────────────────
+# Anchored grep — must be indented (under sync: block), avoids matching comments
+if ! grep -qE '^\s+journal:\s*true' "$GATEWAY" 2>/dev/null; then
+  exit 0
+fi
+
+# ── Resolve vault name ────────────────────────────────────────────────
+VAULT_NAME=$(grep 'vault_name:' "$GATEWAY" 2>/dev/null | head -1 | sed "s/.*vault_name:\s*['\"]*//" | sed "s/['\"].*//")
+if [[ -z "$VAULT_NAME" ]]; then
+  exit 0
+fi
+
+# ── Build session summary ─────────────────────────────────────────────
+PROJECT_NAME=$(basename "$(pwd)")
+TIMESTAMP=$(date '+%Y-%m-%d %H:%M')
+SESSION_ID="${RANDOM}"
+
+SUMMARY="### ${PROJECT_NAME} — Session ${SESSION_ID} (${TIMESTAMP})\n"
+
+# Materialize task state if task store exists
+if [[ -f "$TASK_STORE" ]]; then
+  COMPLETED=$(grep -c '"completed"' "$TASK_STORE" 2>/dev/null || echo "0")
+  IN_PROGRESS=$(grep -c '"started"' "$TASK_STORE" 2>/dev/null || echo "0")
+  BLOCKED=$(grep -c '"blocked"' "$TASK_STORE" 2>/dev/null || echo "0")
+  CREATED=$(grep -c '"created"' "$TASK_STORE" 2>/dev/null || echo "0")
+
+  SUMMARY="${SUMMARY}- Completed: ${COMPLETED}\n"
+  SUMMARY="${SUMMARY}- In Progress: ${IN_PROGRESS}\n"
+  SUMMARY="${SUMMARY}- Blocked: ${BLOCKED}\n"
+  SUMMARY="${SUMMARY}- Backlog: ${CREATED}\n"
+else
+  SUMMARY="${SUMMARY}- No task store found\n"
+fi
+
+SUMMARY="${SUMMARY}\n---\n"
+
+# ── Append to daily note ──────────────────────────────────────────────
+"$OBSIDIAN_CLI" daily:append --vault "$VAULT_NAME" -- "$(echo -e "$SUMMARY")" 2>/dev/null || true
+
+exit 0

package/hooks/reagent-obsidian-precompact.sh

@@ -0,0 +1,88 @@
+#!/usr/bin/env bash
+# reagent-obsidian-precompact.sh — Knowledge extraction before context compaction
+#
+# Hook type: PreCompact (fires before Claude Code compacts context)
+# Spawns a subprocess to extract durable knowledge from the transcript
+# and creates a session knowledge note in Obsidian.
+#
+# Disabled by default (precompact: false in gateway.yaml).
+# Fail-silent: exits 0 even on error (non-blocking).
+#
+# Requires:
+#   - /usr/local/bin/obsidian CLI installed
+#   - REAGENT_OBSIDIAN_VAULT env var set
+#   - obsidian_vault.sync.precompact: true in .reagent/gateway.yaml
+
+set -euo pipefail
+
+OBSIDIAN_CLI="/usr/local/bin/obsidian"
+POLICY_DIR=".reagent"
+GATEWAY="${POLICY_DIR}/gateway.yaml"
+
+# ── Guard: CLI available ──────────────────────────────────────────────
+if [[ ! -x "$OBSIDIAN_CLI" ]]; then
+  exit 0
+fi
+
+# ── Guard: gateway.yaml exists ────────────────────────────────────────
+if [[ ! -f "$GATEWAY" ]]; then
+  exit 0
+fi
+
+# ── Guard: precompact sync enabled ───────────────────────────────────
+# Anchored grep — must be indented (under sync: block), avoids matching comments
+if ! grep -qE '^\s+precompact:\s*true' "$GATEWAY" 2>/dev/null; then
+  exit 0
+fi
+
+# ── Resolve vault name and sessions path ──────────────────────────────
+VAULT_NAME=$(grep 'vault_name:' "$GATEWAY" 2>/dev/null | head -1 | sed "s/.*vault_name:\s*['\"]*//" | sed "s/['\"].*//")
+if [[ -z "$VAULT_NAME" ]]; then
+  exit 0
+fi
+
+SESSIONS_PATH=$(grep 'sessions:' "$GATEWAY" 2>/dev/null | head -1 | sed "s/.*sessions:\s*['\"]*//" | sed "s/['\"].*//")
+SESSIONS_PATH="${SESSIONS_PATH:-Wiki/Sessions}"
+
+# ── Resolve engine ────────────────────────────────────────────────────
+ENGINE=$(grep 'engine:' "$GATEWAY" 2>/dev/null | head -1 | sed "s/.*engine:\s*['\"]*//" | sed "s/['\"].*//")
+ENGINE="${ENGINE:-claude}"
+
+PROJECT_NAME=$(basename "$(pwd)")
+DATE=$(date '+%Y-%m-%d')
+SESSION_ID="${RANDOM}"
+NOTE_NAME="${PROJECT_NAME} Session ${DATE} ${SESSION_ID}"
+
+# ── Stub: knowledge extraction ────────────────────────────────────────
+# TODO: Implement actual transcript extraction via claude subprocess or ollama
+# For now, create a placeholder session note
+
+CONTENT="---
+reagent_managed: true
+project: ${PROJECT_NAME}
+date: ${DATE}
+session_id: ${SESSION_ID}
+engine: ${ENGINE}
+---
+
+# Session Knowledge — ${PROJECT_NAME}
+
+*Auto-extracted at ${DATE} by reagent precompact hook.*
+
+> Knowledge extraction engine: ${ENGINE}
+> Status: stub — full extraction not yet implemented
+
+## Decisions
+
+## Discoveries
+
+## Open Questions
+"
+
+"$OBSIDIAN_CLI" create \
+  --vault "$VAULT_NAME" \
+  --path "$SESSIONS_PATH" \
+  --name "$NOTE_NAME" \
+  -- "$CONTENT" 2>/dev/null || true
+
+exit 0

package/hooks/reagent-obsidian-tasks.sh

@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+# reagent-obsidian-tasks.sh — Task sync to Obsidian individual notes
+#
+# Hook type: PostToolUse (fires after task_create, task_update MCP tools)
+# Materializes task events as individual Obsidian notes with typed frontmatter.
+# One-way sync: JSONL → Obsidian. Reverse sync deferred.
+#
+# Fail-silent: exits 0 even on error (non-blocking).
+#
+# Requires:
+#   - /usr/local/bin/obsidian CLI installed
+#   - REAGENT_OBSIDIAN_VAULT env var set
+#   - obsidian_vault.sync.tasks: true in .reagent/gateway.yaml
+
+set -euo pipefail
+
+OBSIDIAN_CLI="/usr/local/bin/obsidian"
+POLICY_DIR=".reagent"
+GATEWAY="${POLICY_DIR}/gateway.yaml"
+TASK_STORE="${POLICY_DIR}/tasks.jsonl"
+
+# ── Guard: CLI available ──────────────────────────────────────────────
+if [[ ! -x "$OBSIDIAN_CLI" ]]; then
+  exit 0
+fi
+
+# ── Guard: gateway.yaml exists ────────────────────────────────────────
+if [[ ! -f "$GATEWAY" ]]; then
+  exit 0
+fi
+
+# ── Guard: tasks sync enabled ────────────────────────────────────────
+# Match sync.tasks specifically — use awk to only match within the sync: block
+if ! awk '/^\s+sync:/{found=1} found && /tasks:\s*true/{exit 0} END{exit 1}' "$GATEWAY" 2>/dev/null; then
+  exit 0
+fi
+
+# ── Guard: task store exists ──────────────────────────────────────────
+if [[ ! -f "$TASK_STORE" ]]; then
+  exit 0
+fi
+
+# ── Resolve vault name and tasks path ─────────────────────────────────
+VAULT_NAME=$(grep 'vault_name:' "$GATEWAY" 2>/dev/null | head -1 | sed "s/.*vault_name:\s*['\"]*//" | sed "s/['\"].*//")
+if [[ -z "$VAULT_NAME" ]]; then
+  exit 0
+fi
+
+# Extract paths.tasks — use awk to match only within the paths: block (not sync:)
+TASKS_PATH=$(awk '/^\s+paths:/{found=1} found && /tasks:/{print; exit}' "$GATEWAY" 2>/dev/null | sed "s/.*tasks:\s*['\"]*//" | sed "s/['\"].*//")
+TASKS_PATH="${TASKS_PATH:-Tasks}"
+
+PROJECT_NAME=$(basename "$(pwd)")
+
+# ── Read tool result from stdin (Claude hook protocol) ────────────────
+TOOL_RESULT=""
+if [[ ! -t 0 ]]; then
+  TOOL_RESULT=$(cat 2>/dev/null || true)
+fi
+
+# Extract task ID from the tool result JSON
+TASK_ID=""
+if [[ -n "$TOOL_RESULT" ]]; then
+  TASK_ID=$(echo "$TOOL_RESULT" | grep -o '"id"\s*:\s*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)"$/\1/')
+fi
+
+# If we don't have a specific task ID, sync the most recent task
+if [[ -z "$TASK_ID" ]]; then
+  TASK_ID=$(tail -1 "$TASK_STORE" | grep -o '"id"\s*:\s*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)"$/\1/')
+fi
+
+if [[ -z "$TASK_ID" ]]; then
+  exit 0
+fi
+
+# ── Extract task data from JSONL ──────────────────────────────────────
+# Get the latest event for this task
+TASK_LINE=$(grep "\"$TASK_ID\"" "$TASK_STORE" | tail -1)
+
+if [[ -z "$TASK_LINE" ]]; then
+  exit 0
+fi
+
+# Extract fields (simple grep — avoids jq dependency)
+TITLE=$(echo "$TASK_LINE" | grep -o '"title"\s*:\s*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)"$/\1/')
+STATUS=$(echo "$TASK_LINE" | grep -o '"status"\s*:\s*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)"$/\1/')
+URGENCY=$(echo "$TASK_LINE" | grep -o '"urgency"\s*:\s*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)"$/\1/')
+ASSIGNEE=$(echo "$TASK_LINE" | grep -o '"assignee"\s*:\s*"[^"]*"' | head -1 | sed 's/.*"\([^"]*\)"$/\1/')
+
+TITLE="${TITLE:-Untitled Task}"
+STATUS="${STATUS:-created}"
+URGENCY="${URGENCY:-normal}"
+
+# ── Create/update note via Obsidian CLI ───────────────────────────────
+NOTE_NAME="${TASK_ID} ${TITLE}"
+
+CONTENT="---
+reagent_managed: true
+task_id: ${TASK_ID}
+project: ${PROJECT_NAME}
+status: ${STATUS}
+urgency: ${URGENCY}
+assignee: ${ASSIGNEE:-unassigned}
+---
+
+# ${TITLE}
+
+- **ID:** ${TASK_ID}
+- **Status:** ${STATUS}
+- **Urgency:** ${URGENCY}
+- **Assignee:** ${ASSIGNEE:-unassigned}
+- **Project:** ${PROJECT_NAME}
+"
+
+# Create note (overwrites if exists)
+"$OBSIDIAN_CLI" create \
+  --vault "$VAULT_NAME" \
+  --path "$TASKS_PATH" \
+  --name "$NOTE_NAME" \
+  -- "$CONTENT" 2>/dev/null || true
+
+# Set properties via CLI for proper frontmatter handling
+"$OBSIDIAN_CLI" property:set --vault "$VAULT_NAME" --file "${TASKS_PATH}/${NOTE_NAME}.md" \
+  --name "status" --value "$STATUS" 2>/dev/null || true
+
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bookedsolid/reagent",
-  "version": "0.14.0",
+  "version": "0.14.2",
   "description": "Governance layer for Claude Code — policy enforcement, hook-based safety gates, and audit logging for AI-assisted projects",
   "license": "MIT",
   "author": "Booked Solid Technology <oss@bookedsolid.tech> (https://bookedsolid.tech)",

package/profiles/bst-internal.json

@@ -6,7 +6,7 @@
   "huskyPreCommit": true,
   "huskyPrePush": true,
   "cursorRules": ["001-no-hallucination", "002-verify-before-act", "003-attribution"],
-  "blockedPaths": [".reagent/", ".env"],
+  "blockedPaths": [".reagent/policy.yaml", ".reagent/HALT", ".env"],
   "gitignoreEntries": [".claude/agents/", ".claude/hooks/", ".claude/settings.json", "RESTART.md"],
   "qualityGates": {
     "commitReview": { "enabled": true, "trivialThreshold": 20, "significantThreshold": 200 },

package/profiles/client-engagement.json

@@ -6,7 +6,7 @@
   "huskyPreCommit": true,
   "huskyPrePush": true,
   "cursorRules": ["001-no-hallucination", "002-verify-before-act", "003-attribution"],
-  "blockedPaths": [".reagent/", ".github/workflows/", ".env", ".env.*"],
+  "blockedPaths": [".reagent/policy.yaml", ".reagent/HALT", ".github/workflows/", ".env", ".env.*"],
   "gitignoreEntries": [".claude/hooks/", ".claude/settings.json", "RESTART.md"],
   "qualityGates": {
     "commitReview": { "enabled": true, "trivialThreshold": 20, "significantThreshold": 200 },