@hivehub/rulebook 5.3.3 → 5.4.1

package/templates/hooks/resume-from-handoff.ps1

@@ -1,40 +1,40 @@
-# Claude Code SessionStart hook — auto-restore from handoff (PowerShell).
-# See resume-from-handoff.sh for the full design rationale.
-
-$ErrorActionPreference = 'Stop'
-
-# Read hook input from stdin to get the actual project cwd
-$input = [Console]::In.ReadToEnd()
-$ProjectRoot = $null
-if ($input) {
-    try { $ProjectRoot = ($input | ConvertFrom-Json).cwd } catch {}
-}
-if (-not $ProjectRoot) { $ProjectRoot = $env:CLAUDE_PROJECT_DIR }
-if (-not $ProjectRoot) { $ProjectRoot = (Get-Location).Path }
-$HandoffDir = Join-Path $ProjectRoot '.rulebook/handoff'
-$Pending = Join-Path $HandoffDir '_pending.md'
-$Urgent = Join-Path $HandoffDir '.urgent'
-
-if (-not (Test-Path $Pending)) {
-    Write-Output '{}'
-    exit 0
-}
-
-$content = Get-Content $Pending -Raw
-$timestamp = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH-mm-ss')
-$archiveName = "${timestamp}.md"
-Move-Item $Pending (Join-Path $HandoffDir $archiveName) -Force
-
-if (Test-Path $Urgent) { Remove-Item $Urgent -Force }
-
-$header = "## Session restored from handoff ($archiveName)`n`n"
-$ctx = $header + $content
-$out = @{
-    hookSpecificOutput = @{
-        hookEventName = 'SessionStart'
-        additionalContext = $ctx
-    }
-} | ConvertTo-Json -Compress -Depth 4
-
-Write-Output $out
-exit 0
+# Claude Code SessionStart hook — auto-restore from handoff (PowerShell).
+# See resume-from-handoff.sh for the full design rationale.
+
+$ErrorActionPreference = 'Stop'
+
+# Read hook input from stdin to get the actual project cwd
+$input = [Console]::In.ReadToEnd()
+$ProjectRoot = $null
+if ($input) {
+    try { $ProjectRoot = ($input | ConvertFrom-Json).cwd } catch {}
+}
+if (-not $ProjectRoot) { $ProjectRoot = $env:CLAUDE_PROJECT_DIR }
+if (-not $ProjectRoot) { $ProjectRoot = (Get-Location).Path }
+$HandoffDir = Join-Path $ProjectRoot '.rulebook/handoff'
+$Pending = Join-Path $HandoffDir '_pending.md'
+$Urgent = Join-Path $HandoffDir '.urgent'
+
+if (-not (Test-Path $Pending)) {
+    Write-Output '{}'
+    exit 0
+}
+
+$content = Get-Content $Pending -Raw
+$timestamp = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH-mm-ss')
+$archiveName = "${timestamp}.md"
+Move-Item $Pending (Join-Path $HandoffDir $archiveName) -Force
+
+if (Test-Path $Urgent) { Remove-Item $Urgent -Force }
+
+$header = "## Session restored from handoff ($archiveName)`n`n"
+$ctx = $header + $content
+$out = @{
+    hookSpecificOutput = @{
+        hookEventName = 'SessionStart'
+        additionalContext = $ctx
+    }
+} | ConvertTo-Json -Compress -Depth 4
+
+Write-Output $out
+exit 0

package/templates/hooks/resume-from-handoff.sh

@@ -1,61 +1,61 @@
-#!/usr/bin/env bash
-# Claude Code SessionStart hook — auto-restore from handoff.
-#
-# Checks for `.rulebook/handoff/_pending.md`. If present, emits its
-# contents as additionalContext so the new session begins with full
-# prior-session context loaded, then archives the file to
-# `.rulebook/handoff/<ISO-timestamp>.md` for history.
-
-set -euo pipefail
-
-# Read hook input from stdin to get the actual project cwd
-input="$(cat || true)"
-PROJECT_ROOT=""
-if [[ -n "$input" ]] && command -v jq &>/dev/null; then
-  PROJECT_ROOT="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null || true)"
-fi
-[[ -z "$PROJECT_ROOT" ]] && PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
-HANDOFF_DIR="${PROJECT_ROOT}/.rulebook/handoff"
-PENDING="${HANDOFF_DIR}/_pending.md"
-URGENT="${HANDOFF_DIR}/.urgent"
-CONFIG_FILE="${PROJECT_ROOT}/.rulebook/rulebook.json"
-
-# No pending handoff — nothing to inject
-if [[ ! -f "$PENDING" ]]; then
-  printf '%s' '{}'
-  exit 0
-fi
-
-content="$(cat "$PENDING")"
-
-# Archive the pending file with ISO timestamp
-timestamp=$(date -u +"%Y-%m-%dT%H-%M-%S")
-archive_name="${timestamp}.md"
-mv "$PENDING" "${HANDOFF_DIR}/${archive_name}"
-
-# Clear urgent sentinel if present
-rm -f "$URGENT"
-
-# Prune old handoff files (keep max N, default 50)
-max_history=50
-if [[ -f "$CONFIG_FILE" ]] && command -v jq &>/dev/null; then
-  max_history=$(jq -r '.handoff.maxHistoryFiles // 50' "$CONFIG_FILE" 2>/dev/null || echo 50)
-fi
-
-# Count and prune (oldest first, skip _pending.md and .urgent)
-history_count=$(find "$HANDOFF_DIR" -maxdepth 1 -name "*.md" -type f 2>/dev/null | wc -l)
-if [[ "$history_count" -gt "$max_history" ]]; then
-  excess=$(( history_count - max_history ))
-  find "$HANDOFF_DIR" -maxdepth 1 -name "*.md" -type f -printf '%T@ %p\n' 2>/dev/null \
-    | sort -n | head -"$excess" | awk '{print $2}' | xargs rm -f
-fi
-
-# Emit the handoff content as additionalContext
-header="## Session restored from handoff (${archive_name})\n\nThe following context was saved by the previous session's /handoff skill:\n\n"
-jq -nc --arg ctx "${header}${content}" '{
-  hookSpecificOutput: {
-    hookEventName: "SessionStart",
-    additionalContext: $ctx
-  }
-}'
-exit 0
+#!/usr/bin/env bash
+# Claude Code SessionStart hook — auto-restore from handoff.
+#
+# Checks for `.rulebook/handoff/_pending.md`. If present, emits its
+# contents as additionalContext so the new session begins with full
+# prior-session context loaded, then archives the file to
+# `.rulebook/handoff/<ISO-timestamp>.md` for history.
+
+set -euo pipefail
+
+# Read hook input from stdin to get the actual project cwd
+input="$(cat || true)"
+PROJECT_ROOT=""
+if [[ -n "$input" ]] && command -v jq &>/dev/null; then
+  PROJECT_ROOT="$(printf '%s' "$input" | jq -r '.cwd // empty' 2>/dev/null || true)"
+fi
+[[ -z "$PROJECT_ROOT" ]] && PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+HANDOFF_DIR="${PROJECT_ROOT}/.rulebook/handoff"
+PENDING="${HANDOFF_DIR}/_pending.md"
+URGENT="${HANDOFF_DIR}/.urgent"
+CONFIG_FILE="${PROJECT_ROOT}/.rulebook/rulebook.json"
+
+# No pending handoff — nothing to inject
+if [[ ! -f "$PENDING" ]]; then
+  printf '%s' '{}'
+  exit 0
+fi
+
+content="$(cat "$PENDING")"
+
+# Archive the pending file with ISO timestamp
+timestamp=$(date -u +"%Y-%m-%dT%H-%M-%S")
+archive_name="${timestamp}.md"
+mv "$PENDING" "${HANDOFF_DIR}/${archive_name}"
+
+# Clear urgent sentinel if present
+rm -f "$URGENT"
+
+# Prune old handoff files (keep max N, default 50)
+max_history=50
+if [[ -f "$CONFIG_FILE" ]] && command -v jq &>/dev/null; then
+  max_history=$(jq -r '.handoff.maxHistoryFiles // 50' "$CONFIG_FILE" 2>/dev/null || echo 50)
+fi
+
+# Count and prune (oldest first, skip _pending.md and .urgent)
+history_count=$(find "$HANDOFF_DIR" -maxdepth 1 -name "*.md" -type f 2>/dev/null | wc -l)
+if [[ "$history_count" -gt "$max_history" ]]; then
+  excess=$(( history_count - max_history ))
+  find "$HANDOFF_DIR" -maxdepth 1 -name "*.md" -type f -printf '%T@ %p\n' 2>/dev/null \
+    | sort -n | head -"$excess" | awk '{print $2}' | xargs rm -f
+fi
+
+# Emit the handoff content as additionalContext
+header="## Session restored from handoff (${archive_name})\n\nThe following context was saved by the previous session's /handoff skill:\n\n"
+jq -nc --arg ctx "${header}${content}" '{
+  hookSpecificOutput: {
+    hookEventName: "SessionStart",
+    additionalContext: $ctx
+  }
+}'
+exit 0

package/templates/hooks/terse-activate.ps1

@@ -0,0 +1,143 @@
+# Claude Code SessionStart hook for rulebook-terse (v5.4.0) — Windows.
+#
+# Mirrors templates/hooks/terse-activate.sh. Resolves mode, writes
+# flag file, reads SKILL.md, filters intensity table + examples to
+# the active level only, emits the filtered body to stdout.
+
+$ErrorActionPreference = 'SilentlyContinue'
+
+$validModes = @('off','brief','terse','ultra','commit','review')
+
+# Read optional JSON input from stdin (SessionStart may pass metadata).
+$input = $null
+if (-not [Console]::IsInputRedirected) { $input = $null }
+else { try { $input = [Console]::In.ReadToEnd() } catch { } }
+
+$projectRoot = $null
+if ($input) {
+  try { $projectRoot = (ConvertFrom-Json $input).cwd } catch { }
+}
+if (-not $projectRoot) {
+  if ($env:CLAUDE_PROJECT_DIR) { $projectRoot = $env:CLAUDE_PROJECT_DIR }
+  else { $projectRoot = (Get-Location).Path }
+}
+
+$flagPath     = Join-Path $projectRoot '.rulebook/.terse-mode'
+$projectCfg   = Join-Path $projectRoot '.rulebook/rulebook.json'
+$userCfgBase  = if ($env:XDG_CONFIG_HOME) { $env:XDG_CONFIG_HOME } else { Join-Path $env:APPDATA 'rulebook' }
+$userCfg      = Join-Path $userCfgBase 'config.json'
+
+function Resolve-Mode {
+  foreach ($candidate in @(
+    $env:RULEBOOK_TERSE_MODE,
+    (Get-ConfigMode $projectCfg),
+    (Get-ConfigMode $userCfg)
+  )) {
+    if ($candidate) {
+      $m = $candidate.Trim().ToLower()
+      if ($validModes -contains $m) { return $m }
+    }
+  }
+  return 'terse'
+}
+
+function Get-ConfigMode([string]$path) {
+  if (-not (Test-Path $path)) { return $null }
+  try {
+    $cfg = Get-Content -Raw -ErrorAction Stop $path | ConvertFrom-Json
+    if ($cfg -and $cfg.terse -and $cfg.terse.defaultMode) {
+      return $cfg.terse.defaultMode
+    }
+  } catch { }
+  return $null
+}
+
+function Write-SafeFlag([string]$content) {
+  $dir = Split-Path -Parent $flagPath
+  if (-not (Test-Path $dir)) { New-Item -ItemType Directory -Force $dir | Out-Null }
+
+  # Refuse if target or parent is a symlink.
+  $parentAttr = (Get-Item $dir -Force).Attributes
+  if ($parentAttr -band [IO.FileAttributes]::ReparsePoint) { return }
+  if (Test-Path $flagPath) {
+    $attr = (Get-Item $flagPath -Force).Attributes
+    if ($attr -band [IO.FileAttributes]::ReparsePoint) { return }
+  }
+
+  $tmp = Join-Path $dir (".terse-mode." + [Guid]::NewGuid().ToString('N').Substring(0,8))
+  try {
+    [IO.File]::WriteAllText($tmp, $content, (New-Object Text.UTF8Encoding $false))
+    Move-Item -Force $tmp $flagPath
+  } catch {
+    if (Test-Path $tmp) { Remove-Item -Force $tmp }
+  }
+}
+
+$mode = Resolve-Mode
+
+if ($mode -eq 'off') {
+  if (Test-Path $flagPath) { Remove-Item -Force $flagPath }
+  exit 0
+}
+
+Write-SafeFlag $mode
+
+# Locate SKILL.md.
+$skillCandidates = @(
+  (Join-Path $projectRoot '.claude/skills/rulebook-terse/SKILL.md'),
+  (Join-Path $projectRoot 'templates/skills/core/rulebook-terse/SKILL.md')
+)
+$skillBody = $null
+foreach ($p in $skillCandidates) {
+  if (Test-Path $p) {
+    $skillBody = Get-Content -Raw $p
+    break
+  }
+}
+
+Write-Output "RULEBOOK-TERSE MODE ACTIVE — level: $mode"
+Write-Output ""
+
+if (-not $skillBody) {
+  Write-Output @"
+## Persistence
+ACTIVE EVERY RESPONSE once set. Off only via "/rulebook-terse off", "normal mode", or session end.
+
+## Rules
+Drop filler (just, really, basically), pleasantries, hedging. Keep technical terms exact. Code blocks byte-for-byte unchanged.
+
+## Auto-Clarity
+Full prose for: security warnings, destructive-op confirmations, quality-gate failures, multi-step sequences, user confusion.
+
+## Boundaries
+Code/tests/commits/specs: unchanged.
+"@
+  exit 0
+}
+
+# Strip YAML frontmatter + filter intensity table + example rows.
+$lines = $skillBody -split "`n"
+$inFm = $false
+$pastFm = $false
+$tableRow = '^\s*\|\s*\*\*([^*]+)\*\*\s*\|'
+$exampleLine = '^\s*-\s*\*\*([^*]+)\*\*\s*:'
+
+foreach ($line in $lines) {
+  if (-not $pastFm) {
+    if ($line -match '^---\s*$') {
+      if (-not $inFm) { $inFm = $true; continue }
+      else { $inFm = $false; $pastFm = $true; continue }
+    }
+    if ($inFm) { continue }
+  }
+
+  if ($line -match $tableRow) {
+    if ($Matches[1] -eq $mode) { Write-Output $line }
+    continue
+  }
+  if ($line -match $exampleLine) {
+    if ($Matches[1] -eq $mode) { Write-Output $line }
+    continue
+  }
+  Write-Output $line
+}

package/templates/hooks/terse-activate.sh

@@ -0,0 +1,197 @@
+#!/usr/bin/env bash
+# Claude Code SessionStart hook for rulebook-terse (v5.4.0).
+#
+# Resolves the active intensity mode, writes it to the project-local
+# flag file via a symlink-safe path, reads the installed SKILL.md,
+# filters the intensity table + example rows down to the active
+# level only, and emits the filtered body to stdout — Claude Code
+# injects SessionStart stdout as hidden `additionalContext`.
+#
+# Contract matches `.rulebook/specs/RULEBOOK_TERSE.md`. Silent-fails
+# on every filesystem error so a broken hook never blocks session
+# start.
+#
+# Configuration resolution (first match wins):
+#   1. RULEBOOK_TERSE_MODE env var
+#   2. $PROJECT_ROOT/.rulebook/rulebook.json → terse.defaultMode
+#   3. $XDG_CONFIG_HOME/rulebook/config.json → terse.defaultMode
+#   4. ~/.config/rulebook/config.json       → terse.defaultMode
+#   5. "terse"
+
+set -u
+
+# Hook input may arrive on stdin as JSON — read it if present so we
+# can resolve PROJECT_ROOT from the `cwd` field (Claude Code may
+# invoke the hook from a sub-directory of the project).
+input=""
+if [ ! -t 0 ]; then
+  input="$(cat)"
+fi
+
+PROJECT_ROOT=""
+if [ -n "$input" ]; then
+  PROJECT_ROOT="$(printf '%s' "$input" | node -e "
+    try {
+      const data = JSON.parse(require('fs').readFileSync(0, 'utf8'));
+      process.stdout.write(data.cwd || '');
+    } catch { }
+  " 2>/dev/null || true)"
+fi
+[ -z "$PROJECT_ROOT" ] && PROJECT_ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
+
+FLAG_PATH="${PROJECT_ROOT}/.rulebook/.terse-mode"
+CONFIG_DIR="${XDG_CONFIG_HOME:-$HOME/.config}/rulebook"
+USER_CONFIG="${CONFIG_DIR}/config.json"
+PROJECT_CONFIG="${PROJECT_ROOT}/.rulebook/rulebook.json"
+
+VALID_MODES_RE='^(off|brief|terse|ultra|commit|review)$'
+
+resolve_mode() {
+  # 1. Env var
+  if [ -n "${RULEBOOK_TERSE_MODE:-}" ]; then
+    local m="$(printf '%s' "$RULEBOOK_TERSE_MODE" | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]')"
+    if [[ "$m" =~ $VALID_MODES_RE ]]; then
+      printf '%s' "$m"
+      return
+    fi
+  fi
+
+  # 2. Project config
+  if [ -f "$PROJECT_CONFIG" ]; then
+    local m
+    m="$(node -e "
+      try {
+        const cfg = JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'));
+        if (cfg.terse && cfg.terse.defaultMode) process.stdout.write(String(cfg.terse.defaultMode));
+      } catch { }
+    " "$PROJECT_CONFIG" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]' || true)"
+    if [ -n "$m" ] && [[ "$m" =~ $VALID_MODES_RE ]]; then
+      printf '%s' "$m"
+      return
+    fi
+  fi
+
+  # 3. User config
+  if [ -f "$USER_CONFIG" ]; then
+    local m
+    m="$(node -e "
+      try {
+        const cfg = JSON.parse(require('fs').readFileSync(process.argv[1], 'utf8'));
+        if (cfg.terse && cfg.terse.defaultMode) process.stdout.write(String(cfg.terse.defaultMode));
+      } catch { }
+    " "$USER_CONFIG" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]' || true)"
+    if [ -n "$m" ] && [[ "$m" =~ $VALID_MODES_RE ]]; then
+      printf '%s' "$m"
+      return
+    fi
+  fi
+
+  printf 'terse'
+}
+
+# Symlink-safe flag-file write. Refuses if target or parent is a
+# symlink; creates with 0600 via umask + atomic temp+rename.
+safe_write_flag() {
+  local content="$1"
+  local dir
+  dir="$(dirname "$FLAG_PATH")"
+
+  mkdir -p "$dir" 2>/dev/null || return 0
+
+  # Refuse if parent is itself a symlink.
+  [ -L "$dir" ] && return 0
+  # Refuse if target already exists as a symlink.
+  [ -L "$FLAG_PATH" ] && return 0
+
+  local tmp
+  tmp="$(mktemp "$dir/.terse-mode.XXXXXX" 2>/dev/null)" || return 0
+  {
+    umask 077
+    printf '%s' "$content" > "$tmp" 2>/dev/null || { rm -f "$tmp"; return 0; }
+  }
+  chmod 600 "$tmp" 2>/dev/null || true
+  mv -f "$tmp" "$FLAG_PATH" 2>/dev/null || rm -f "$tmp"
+}
+
+mode="$(resolve_mode)"
+
+# "off" → unlink the flag and exit cleanly (no hidden-context emission).
+if [ "$mode" = "off" ]; then
+  rm -f "$FLAG_PATH" 2>/dev/null || true
+  exit 0
+fi
+
+safe_write_flag "$mode"
+
+# Locate the SKILL.md. Prefer the installed copy; fall back to the
+# repo-local template when running inside the Rulebook source tree.
+SKILL_PATHS=(
+  "${PROJECT_ROOT}/.claude/skills/rulebook-terse/SKILL.md"
+  "${PROJECT_ROOT}/templates/skills/core/rulebook-terse/SKILL.md"
+)
+
+skill_body=""
+for p in "${SKILL_PATHS[@]}"; do
+  if [ -f "$p" ]; then
+    skill_body="$(cat "$p" 2>/dev/null || true)"
+    break
+  fi
+done
+
+# Emit the payload. When no SKILL.md is found, fall back to a
+# minimal hardcoded ruleset — matches the Caveman pattern for
+# standalone installs without templates.
+if [ -z "$skill_body" ]; then
+  cat <<EOF
+RULEBOOK-TERSE MODE ACTIVE — level: ${mode}
+
+## Persistence
+ACTIVE EVERY RESPONSE once set. Off only via "/rulebook-terse off", "normal mode", or session end.
+
+## Rules
+Drop filler (just, really, basically), pleasantries, hedging. Keep technical terms exact. Code blocks byte-for-byte unchanged.
+
+## Auto-Clarity
+Full prose for: security warnings, destructive-op confirmations, quality-gate failures, multi-step sequences, user confusion.
+
+## Boundaries
+Code/tests/commits/specs: unchanged.
+EOF
+  exit 0
+fi
+
+# Header + filtered body. Filtering:
+#   - Strip YAML frontmatter (everything up through the second `---`).
+#   - Intensity-table rows `| **<level>** | ...` — keep only the active one.
+#   - Example lines `- **<level>**: "..."` — keep only the active one.
+#   - All other lines pass through unchanged.
+#
+# Uses `node -e` for portability — BSD awk (macOS default) does not
+# support the 3-arg `match(str, re, array)` form that gawk ships with.
+printf 'RULEBOOK-TERSE MODE ACTIVE — level: %s\n\n' "$mode"
+
+printf '%s' "$skill_body" | node -e "
+  let body = '';
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', (c) => { body += c; });
+  process.stdin.on('end', () => {
+    const active = process.argv[1];
+    // Strip YAML frontmatter.
+    const stripped = body.replace(/^---\s*\n[\s\S]*?\n---\s*\n/, '');
+    const out = [];
+    for (const line of stripped.split('\n')) {
+      const tableRow = line.match(/^\s*\|\s*\*\*([^*]+)\*\*\s*\|/);
+      if (tableRow) {
+        if (tableRow[1] === active) out.push(line);
+        continue;
+      }
+      const exampleLine = line.match(/^\s*-\s*\*\*([^*]+)\*\*\s*:/);
+      if (exampleLine) {
+        if (exampleLine[1] === active) out.push(line);
+        continue;
+      }
+      out.push(line);
+    }
+    process.stdout.write(out.join('\n'));
+  });
+" "$mode"