@hivehub/rulebook 5.3.3 → 5.4.1

package/templates/hooks/terse-mode-tracker.ps1

@@ -0,0 +1,153 @@
+# Claude Code UserPromptSubmit hook for rulebook-terse (v5.4.0) — Windows.
+#
+# Mirrors templates/hooks/terse-mode-tracker.sh. Parses slash commands
+# + natural-language activation/deactivation, updates the flag file,
+# and emits an attention anchor JSON for persistent modes.
+
+$ErrorActionPreference = 'SilentlyContinue'
+
+$validModes = @('off','brief','terse','ultra','commit','review')
+$maxFlagBytes = 32
+
+$input = $null
+try { $input = [Console]::In.ReadToEnd() } catch { }
+
+$prompt = ''
+$cwd = $null
+if ($input) {
+  try {
+    $parsed = $input | ConvertFrom-Json
+    if ($parsed.prompt) { $prompt = $parsed.prompt }
+    if ($parsed.cwd)    { $cwd = $parsed.cwd }
+  } catch { }
+}
+
+$projectRoot = if ($cwd) { $cwd } elseif ($env:CLAUDE_PROJECT_DIR) { $env:CLAUDE_PROJECT_DIR } else { (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 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 Resolve-DefaultMode {
+  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 Write-SafeFlag([string]$content) {
+  $dir = Split-Path -Parent $flagPath
+  if (-not (Test-Path $dir)) { New-Item -ItemType Directory -Force $dir | Out-Null }
+  $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 }
+  }
+}
+
+function Read-Flag {
+  if (-not (Test-Path $flagPath)) { return $null }
+  $attr = (Get-Item $flagPath -Force).Attributes
+  if ($attr -band [IO.FileAttributes]::ReparsePoint) { return $null }
+  $size = (Get-Item $flagPath).Length
+  if ($size -gt $maxFlagBytes) { return $null }
+  $raw = (Get-Content -Raw $flagPath).Trim().ToLower()
+  if ($validModes -contains $raw) { return $raw }
+  return $null
+}
+
+$defaultMode = Resolve-DefaultMode
+$lowerPrompt = $prompt.ToLower()
+
+$newMode = $null
+$deactivate = $false
+
+if ($lowerPrompt -match '^\s*/rulebook-terse-commit\b') {
+  $newMode = 'commit'
+}
+elseif ($lowerPrompt -match '^\s*/rulebook-terse-review\b') {
+  $newMode = 'review'
+}
+elseif ($lowerPrompt -match '^\s*/rulebook-terse\s*$') {
+  $newMode = $defaultMode
+}
+elseif ($lowerPrompt -match '^\s*/rulebook-terse\s+(\S+)') {
+  $arg = $Matches[1]
+  switch ($arg) {
+    'off'    { $deactivate = $true }
+    { @('brief','terse','ultra','commit','review') -contains $_ } { $newMode = $arg }
+  }
+}
+
+if (-not $newMode -and -not $deactivate) {
+  $deactRegexes = @(
+    '\b(stop|disable|turn off|deactivate)\b.*\brulebook[- ]?terse\b',
+    '\brulebook[- ]?terse\b.*\b(stop|disable|turn off|deactivate)\b',
+    '\b(stop|disable) terse\b',
+    '\bnormal mode\b'
+  )
+  foreach ($re in $deactRegexes) {
+    if ($prompt -match $re) { $deactivate = $true; break }
+  }
+}
+
+if (-not $newMode -and -not $deactivate) {
+  $actRegexes = @(
+    '\b(activate|enable|turn on|start)\b.*\brulebook[- ]?terse\b',
+    '\brulebook[- ]?terse\b.*\b(mode|activate|enable|turn on|start)\b',
+    '\bbe terse\b',
+    '\bterse mode\b',
+    '\bless tokens?\b'
+  )
+  foreach ($re in $actRegexes) {
+    if ($prompt -match $re) { $newMode = $defaultMode; break }
+  }
+}
+
+if ($deactivate) {
+  if (Test-Path $flagPath) { Remove-Item -Force $flagPath }
+}
+elseif ($newMode) {
+  if ($newMode -eq 'off') {
+    if (Test-Path $flagPath) { Remove-Item -Force $flagPath }
+  } else {
+    Write-SafeFlag $newMode
+  }
+}
+
+$active = Read-Flag
+if ($active -and $active -ne 'off' -and $active -ne 'commit' -and $active -ne 'review') {
+  $keep = if ($active -eq 'brief') { 'Keep articles and full sentences.' } else { 'Fragments OK.' }
+  $text = "RULEBOOK-TERSE ACTIVE ($active). Drop filler/hedging/pleasantries. $keep Code/tests/commits/security: write full. Quality-gate failures + destructive ops: write full."
+  $payload = @{
+    hookSpecificOutput = @{
+      hookEventName = 'UserPromptSubmit'
+      additionalContext = $text
+    }
+  } | ConvertTo-Json -Compress -Depth 5
+  Write-Output $payload
+}

package/templates/hooks/terse-mode-tracker.sh

@@ -0,0 +1,187 @@
+#!/usr/bin/env bash
+# Claude Code UserPromptSubmit hook for rulebook-terse (v5.4.0).
+#
+# Parses slash commands + natural-language activation/deactivation
+# phrases in the user prompt, updates the project-local flag file,
+# and emits a short (~45 token) attention anchor as hookSpecificOutput
+# when a persistent mode is active — keeps the compression register in
+# the model's attention on every user message.
+#
+# Independent sub-skill modes (commit / review) do NOT get the anchor:
+# their own SKILL.md files drive behavior for the single turn they're
+# invoked.
+#
+# Silent-fails on every filesystem error.
+
+set -u
+
+input="$(cat || true)"
+prompt=""
+cwd=""
+if [ -n "$input" ]; then
+  # Parse JSON via node (always available in Claude Code hook env).
+  # Emits two lines: prompt on line 1, cwd on line 2.
+  parsed="$(printf '%s' "$input" | node -e "
+    try {
+      const data = JSON.parse(require('fs').readFileSync(0, 'utf8'));
+      process.stdout.write((data.prompt || '') + '\\n' + (data.cwd || ''));
+    } catch { process.stdout.write('\\n'); }
+  " 2>/dev/null || printf '\n')"
+  prompt="$(printf '%s' "$parsed" | head -n 1)"
+  cwd="$(printf '%s' "$parsed" | tail -n +2)"
+fi
+
+PROJECT_ROOT="${cwd:-${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)$'
+MAX_FLAG_BYTES=32
+
+resolve_default_mode() {
+  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
+  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
+  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'
+}
+
+safe_write_flag() {
+  local content="$1"
+  local dir
+  dir="$(dirname "$FLAG_PATH")"
+  mkdir -p "$dir" 2>/dev/null || return 0
+  [ -L "$dir" ] && return 0
+  [ -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"
+}
+
+read_flag() {
+  # Symlink-safe, size-capped, whitelist-validated read.
+  [ ! -f "$FLAG_PATH" ] && return 1
+  [ -L "$FLAG_PATH" ] && return 1
+  local size
+  size="$(wc -c < "$FLAG_PATH" 2>/dev/null || echo "$MAX_FLAG_BYTES")"
+  [ "$size" -gt "$MAX_FLAG_BYTES" ] && return 1
+
+  local raw
+  raw="$(head -c "$MAX_FLAG_BYTES" "$FLAG_PATH" 2>/dev/null | tr '[:upper:]' '[:lower:]' | tr -d '[:space:]')"
+  if [[ "$raw" =~ $VALID_MODES_RE ]]; then
+    printf '%s' "$raw"
+    return 0
+  fi
+  return 1
+}
+
+default_mode="$(resolve_default_mode)"
+lower_prompt="$(printf '%s' "$prompt" | tr '[:upper:]' '[:lower:]')"
+
+# Parse intent. Order matters: deactivation wins over accidental
+# activation, slash commands win over natural-language patterns.
+new_mode=""
+deactivate=0
+
+# Slash commands
+if [[ "$lower_prompt" == /rulebook-terse-commit* ]]; then
+  new_mode="commit"
+elif [[ "$lower_prompt" == /rulebook-terse-review* ]]; then
+  new_mode="review"
+elif [[ "$lower_prompt" == /rulebook-terse ]]; then
+  new_mode="$default_mode"
+elif [[ "$lower_prompt" == /rulebook-terse\ * ]]; then
+  arg="$(printf '%s' "$lower_prompt" | awk '{print $2}')"
+  case "$arg" in
+    off) deactivate=1 ;;
+    brief|terse|ultra|commit|review) new_mode="$arg" ;;
+    *) : ;;  # unknown subcommand → leave state unchanged
+  esac
+fi
+
+# Natural-language deactivation — checked first so "stop terse" wins.
+if [ -z "$new_mode" ] && [ "$deactivate" -eq 0 ]; then
+  if echo "$prompt" | grep -qiE '\b(stop|disable|turn off|deactivate)\b.*\brulebook[- ]?terse\b' \
+     || echo "$prompt" | grep -qiE '\brulebook[- ]?terse\b.*\b(stop|disable|turn off|deactivate)\b' \
+     || echo "$prompt" | grep -qiE '\b(stop|disable) terse\b' \
+     || echo "$prompt" | grep -qiE '\bnormal mode\b'; then
+    deactivate=1
+  fi
+fi
+
+# Natural-language activation
+if [ -z "$new_mode" ] && [ "$deactivate" -eq 0 ]; then
+  if echo "$prompt" | grep -qiE '\b(activate|enable|turn on|start)\b.*\brulebook[- ]?terse\b' \
+     || echo "$prompt" | grep -qiE '\brulebook[- ]?terse\b.*\b(mode|activate|enable|turn on|start)\b' \
+     || echo "$prompt" | grep -qiE '\bbe terse\b' \
+     || echo "$prompt" | grep -qiE '\bterse mode\b' \
+     || echo "$prompt" | grep -qiE '\bless tokens?\b'; then
+    new_mode="$default_mode"
+  fi
+fi
+
+# Apply intent
+if [ "$deactivate" -eq 1 ]; then
+  rm -f "$FLAG_PATH" 2>/dev/null || true
+elif [ -n "$new_mode" ]; then
+  if [ "$new_mode" = "off" ]; then
+    rm -f "$FLAG_PATH" 2>/dev/null || true
+  else
+    safe_write_flag "$new_mode"
+  fi
+fi
+
+# Emit attention anchor for persistent modes only.
+active_mode="$(read_flag || true)"
+case "$active_mode" in
+  brief|terse|ultra)
+    if [ "$active_mode" = "brief" ]; then
+      keep_clause="Keep articles and full sentences."
+    else
+      keep_clause="Fragments OK."
+    fi
+    text="RULEBOOK-TERSE ACTIVE (${active_mode}). Drop filler/hedging/pleasantries. ${keep_clause} Code/tests/commits/security: write full. Quality-gate failures + destructive ops: write full."
+    # Emit hookSpecificOutput JSON via node — universal across platforms.
+    node -e "
+      const text = process.argv[1];
+      process.stdout.write(JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: 'UserPromptSubmit',
+          additionalContext: text
+        }
+      }));
+    " "$text" 2>/dev/null || true
+    ;;
+  *)
+    # No active persistent mode, or commit/review sub-skill — no anchor.
+    :
+    ;;
+esac

package/templates/ides/CONTINUE_RULES.md

@@ -1,16 +1,16 @@
-<!-- RULEBOOK:START -->
-# Continue.dev — Code Assistant Rules
-
-## Context Loading
-- Always read AGENTS.md before making changes
-- Check `.rulebook/specs/` for relevant spec files
-
-## Code Standards
-- Match existing code style and conventions
-- Prefer editing existing files over creating new ones
-- Add types for all new parameters and return values
-
-## Testing
-- Write tests for every new function
-- Run existing tests after changes to verify no regressions
-<!-- RULEBOOK:END -->
+<!-- RULEBOOK:START -->
+# Continue.dev — Code Assistant Rules
+
+## Context Loading
+- Always read AGENTS.md before making changes
+- Check `.rulebook/specs/` for relevant spec files
+
+## Code Standards
+- Match existing code style and conventions
+- Prefer editing existing files over creating new ones
+- Add types for all new parameters and return values
+
+## Testing
+- Write tests for every new function
+- Run existing tests after changes to verify no regressions
+<!-- RULEBOOK:END -->

package/templates/ides/COPILOT.md

@@ -1,37 +1,37 @@
-<!-- COPILOT:START -->
-# GitHub Copilot Rules
-
-**Tool**: GitHub's AI pair programmer (inline + chat)
-
-## Quick Start
-
-Copilot reads:
-- `.github/copilot-instructions.md` (generated by `rulebook init`)
-- Workspace context (open files)
-
-## Usage
-
-```bash
-# In Copilot Chat:
-"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
-
-# Inline suggestions:
-Accept/reject based on AGENTS.md standards
-```
-
-## Modes
-
-**Inline Completions**: Context-aware suggestions while typing
-**Copilot Chat**: Ask questions, request implementations
-**Workspace Agent** (Labs): Multi-file autonomous mode
-
-## Workflow
-
-1. Rulebook generates `.github/copilot-instructions.md` → references AGENTS.md
-2. Keep AGENTS.md open for context
-3. Use `@workspace` to include project context
-4. Reference `@AGENTS.md` explicitly in chat
-
-**Critical**: Generated `copilot-instructions.md` points Copilot to AGENTS.md standards.
-
-<!-- COPILOT:END -->
+<!-- COPILOT:START -->
+# GitHub Copilot Rules
+
+**Tool**: GitHub's AI pair programmer (inline + chat)
+
+## Quick Start
+
+Copilot reads:
+- `.github/copilot-instructions.md` (generated by `rulebook init`)
+- Workspace context (open files)
+
+## Usage
+
+```bash
+# In Copilot Chat:
+"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
+
+# Inline suggestions:
+Accept/reject based on AGENTS.md standards
+```
+
+## Modes
+
+**Inline Completions**: Context-aware suggestions while typing
+**Copilot Chat**: Ask questions, request implementations
+**Workspace Agent** (Labs): Multi-file autonomous mode
+
+## Workflow
+
+1. Rulebook generates `.github/copilot-instructions.md` → references AGENTS.md
+2. Keep AGENTS.md open for context
+3. Use `@workspace` to include project context
+4. Reference `@AGENTS.md` explicitly in chat
+
+**Critical**: Generated `copilot-instructions.md` points Copilot to AGENTS.md standards.
+
+<!-- COPILOT:END -->

package/templates/ides/COPILOT_INSTRUCTIONS.md

@@ -1,23 +1,23 @@
-<!-- RULEBOOK:START -->
-# GitHub Copilot — Project Instructions
-
-## Code Style
-- Use TypeScript with strict mode
-- Follow existing naming conventions (camelCase functions, PascalCase classes)
-- Prefer `async/await` over callbacks or raw Promises
-
-## Architecture
-- Follow the module structure described in AGENTS.md
-- Keep functions small and focused (single responsibility)
-- Use dependency injection over direct imports where possible
-
-## Testing
-- Write Vitest tests for all new functions
-- Place tests in `tests/` directory, not alongside source files
-- Mock external dependencies in unit tests
-
-## Security
-- Never commit credentials or API keys
-- Validate all external input at system boundaries
-- Follow OWASP top 10 guidelines
-<!-- RULEBOOK:END -->
+<!-- RULEBOOK:START -->
+# GitHub Copilot — Project Instructions
+
+## Code Style
+- Use TypeScript with strict mode
+- Follow existing naming conventions (camelCase functions, PascalCase classes)
+- Prefer `async/await` over callbacks or raw Promises
+
+## Architecture
+- Follow the module structure described in AGENTS.md
+- Keep functions small and focused (single responsibility)
+- Use dependency injection over direct imports where possible
+
+## Testing
+- Write Vitest tests for all new functions
+- Place tests in `tests/` directory, not alongside source files
+- Mock external dependencies in unit tests
+
+## Security
+- Never commit credentials or API keys
+- Validate all external input at system boundaries
+- Follow OWASP top 10 guidelines
+<!-- RULEBOOK:END -->

package/templates/ides/CURSOR.md

@@ -1,43 +1,43 @@
-<!-- CURSOR:START -->
-# Cursor IDE Rules
-
-**IDE**: AI-first code editor with Agent mode and Composer
-
-## Quick Start
-
-Cursor automatically reads:
-- `.cursorrules` (generated by `rulebook init`)
-- `AGENTS.md` (via `@AGENTS.md` references)
-
-## Usage
-
-```bash
-# In Cursor chat/composer:
-"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
-
-# Agent mode (Ctrl+Shift+K):
-Use for complex multi-file changes
-Reference @AGENTS.md for standards
-
-# Composer (Cmd+I):
-Use for quick edits
-Reference @AGENTS.md when needed
-```
-
-## Features
-
-- **Auto-context**: Reads .cursorrules automatically
-- **@ Mentions**: Use `@AGENTS.md` to include standards
-- **Agent Mode**: Autonomous multi-step implementations
-- **Composer**: Quick inline edits
-
-## Workflow
-
-1. Rulebook generates `.cursorrules` pointing to AGENTS.md
-2. Use `@AGENTS.md` in prompts for explicit reference
-3. Agent/Composer follows standards automatically
-4. Review changes and run quality checks
-
-**Critical**: `.cursorrules` ensures Cursor follows AGENTS.md by default.
-
-<!-- CURSOR:END -->
+<!-- CURSOR:START -->
+# Cursor IDE Rules
+
+**IDE**: AI-first code editor with Agent mode and Composer
+
+## Quick Start
+
+Cursor automatically reads:
+- `.cursorrules` (generated by `rulebook init`)
+- `AGENTS.md` (via `@AGENTS.md` references)
+
+## Usage
+
+```bash
+# In Cursor chat/composer:
+"Follow @AGENTS.md. Implement [feature] with tests (95%+ coverage)."
+
+# Agent mode (Ctrl+Shift+K):
+Use for complex multi-file changes
+Reference @AGENTS.md for standards
+
+# Composer (Cmd+I):
+Use for quick edits
+Reference @AGENTS.md when needed
+```
+
+## Features
+
+- **Auto-context**: Reads .cursorrules automatically
+- **@ Mentions**: Use `@AGENTS.md` to include standards
+- **Agent Mode**: Autonomous multi-step implementations
+- **Composer**: Quick inline edits
+
+## Workflow
+
+1. Rulebook generates `.cursorrules` pointing to AGENTS.md
+2. Use `@AGENTS.md` in prompts for explicit reference
+3. Agent/Composer follows standards automatically
+4. Review changes and run quality checks
+
+**Critical**: `.cursorrules` ensures Cursor follows AGENTS.md by default.
+
+<!-- CURSOR:END -->

package/templates/ides/GEMINI_RULES.md

@@ -1,17 +1,17 @@
-<!-- RULEBOOK:START -->
-# Gemini CLI — Project Directives
-
-## Code Generation Rules
-- Generate TypeScript with strict mode enabled
-- Follow existing file and function naming conventions
-- Always add error handling for async operations
-- Generate tests alongside implementation code
-
-## Quality Standards
-- All code must pass TypeScript type-check
-- All code must pass ESLint without warnings
-- Test coverage must meet project thresholds
-
-## Project Context
-See AGENTS.md for full project architecture and team conventions.
-<!-- RULEBOOK:END -->
+<!-- RULEBOOK:START -->
+# Gemini CLI — Project Directives
+
+## Code Generation Rules
+- Generate TypeScript with strict mode enabled
+- Follow existing file and function naming conventions
+- Always add error handling for async operations
+- Generate tests alongside implementation code
+
+## Quality Standards
+- All code must pass TypeScript type-check
+- All code must pass ESLint without warnings
+- Test coverage must meet project thresholds
+
+## Project Context
+See AGENTS.md for full project architecture and team conventions.
+<!-- RULEBOOK:END -->