@hivehub/rulebook 5.4.1 → 5.5.0

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

@@ -1,143 +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
-}
+# 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
+}