safeword 0.12.2 → 0.13.0

package/templates/hooks/prompt-questions.sh

@@ -1,27 +0,0 @@
-#!/bin/bash
-# Safeword: Question protocol guidance (UserPromptSubmit)
-# Reminds Claude to ask 1-5 clarifying questions for ambiguous tasks
-
-# Change to project directory if set
-[ -n "$CLAUDE_PROJECT_DIR" ] && cd "$CLAUDE_PROJECT_DIR" || true
-
-if [ ! -d ".safeword" ]; then
-  exit 0
-fi
-
-# Read the user prompt from stdin
-input=$(cat)
-
-# Only trigger on substantial prompts (more than 20 chars)
-prompt_length=${#input}
-if [ "$prompt_length" -lt 20 ]; then
-  exit 0
-fi
-
-# Output guidance
-cat << 'EOF'
-SAFEWORD Question Protocol: For ambiguous or complex requests, ask 1-5 clarifying questions before proceeding. Focus on:
-- Scope boundaries (what's included/excluded)
-- Technical constraints (frameworks, patterns, compatibility)
-- Success criteria (how will we know it's done)
-EOF

package/templates/hooks/prompt-timestamp.sh

@@ -1,13 +0,0 @@
-#!/bin/bash
-# Safeword: Inject timestamp (UserPromptSubmit)
-# Outputs current timestamp for Claude's context awareness
-# Helps with accurate ticket timestamps and time-based reasoning
-
-# Natural language day/time in UTC
-natural=$(date -u +"%A, %B %d, %Y at %H:%M UTC")
-# ISO 8601 UTC
-iso=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-# Local timezone
-local_time=$(date +"%H:%M %Z")
-
-echo "Current time: $natural ($iso) | Local: $local_time"

package/templates/hooks/session-lint-check.sh

@@ -1,42 +0,0 @@
-#!/bin/bash
-# Safeword: Lint configuration sync check (SessionStart)
-# Warns if ESLint or Prettier configs are missing or out of sync
-
-# Change to project directory if set
-[ -n "$CLAUDE_PROJECT_DIR" ] && cd "$CLAUDE_PROJECT_DIR" || true
-
-if [ ! -d ".safeword" ]; then
-  exit 0
-fi
-
-warnings=()
-
-# Check for ESLint config
-if [ ! -f "eslint.config.mjs" ] && [ ! -f "eslint.config.js" ] && [ ! -f ".eslintrc.json" ] && [ ! -f ".eslintrc.js" ]; then
-  warnings+=("ESLint config not found - run 'npm run lint' may fail")
-fi
-
-# Check for Prettier config
-if [ ! -f ".prettierrc" ] && [ ! -f ".prettierrc.json" ] && [ ! -f "prettier.config.js" ]; then
-  warnings+=("Prettier config not found - formatting may be inconsistent")
-fi
-
-# Check for required dependencies
-if [ -f "package.json" ]; then
-  if ! grep -q '"eslint"' package.json 2>/dev/null; then
-    warnings+=("ESLint not in package.json - run 'npm install -D eslint'")
-  fi
-  if ! grep -q '"prettier"' package.json 2>/dev/null; then
-    warnings+=("Prettier not in package.json - run 'npm install -D prettier'")
-  fi
-fi
-
-# Output warnings if any
-if [ ${#warnings[@]} -gt 0 ]; then
-  echo "SAFEWORD Lint Check:"
-  for warning in "${warnings[@]}"; do
-    echo "  ⚠️  $warning"
-  done
-fi
-
-exit 0

package/templates/hooks/session-verify-agents.sh

@@ -1,31 +0,0 @@
-#!/bin/bash
-# Safeword: Verify AGENTS.md link (SessionStart)
-# Self-heals by restoring the link if removed
-
-# shellcheck disable=SC2016 # Backticks are literal markdown, not command substitution
-LINK='**⚠️ ALWAYS READ FIRST:** `.safeword/SAFEWORD.md`'
-
-# Change to project directory if set
-[ -n "$CLAUDE_PROJECT_DIR" ] && cd "$CLAUDE_PROJECT_DIR" || true
-
-if [ ! -d ".safeword" ]; then
-  # Not a safeword project, skip silently
-  exit 0
-fi
-
-if [ ! -f "AGENTS.md" ]; then
-  # AGENTS.md doesn't exist, create it
-  echo "$LINK" > AGENTS.md
-  echo "SAFEWORD: Created AGENTS.md with safeword link"
-  exit 0
-fi
-
-# Check if link is present
-if ! grep -q ".safeword/SAFEWORD.md" AGENTS.md; then
-  # Link missing, prepend it
-  CONTENT=$(cat AGENTS.md)
-  echo -e "$LINK\n\n$CONTENT" > AGENTS.md
-  echo "SAFEWORD: Restored AGENTS.md link (was removed)"
-fi
-
-exit 0

package/templates/hooks/session-version.sh

@@ -1,17 +0,0 @@
-#!/bin/bash
-# Safeword: Display version on session start (SessionStart)
-# Shows current safeword version and confirms hooks are active
-
-# Change to project directory if set
-[ -n "$CLAUDE_PROJECT_DIR" ] && cd "$CLAUDE_PROJECT_DIR" || true
-
-if [ ! -d ".safeword" ]; then
-  exit 0
-fi
-
-VERSION="unknown"
-if [ -f ".safeword/version" ]; then
-  VERSION=$(cat .safeword/version)
-fi
-
-echo "SAFE WORD Claude Config v${VERSION} installed - auto-linting and quality review active"

package/templates/hooks/stop-quality.sh

@@ -1,91 +0,0 @@
-#!/bin/bash
-# Auto Quality Review Stop Hook
-# Triggers quality review when changes are proposed or made
-# Only runs for projects with .safeword/ directory
-# Looks for {"proposedChanges": ..., "madeChanges": ...} JSON blob
-
-# Change to project directory if set
-[ -n "$CLAUDE_PROJECT_DIR" ] && cd "$CLAUDE_PROJECT_DIR" || true
-
-# Check for .safeword directory
-if [ ! -d ".safeword" ]; then
-  exit 0
-fi
-
-# Read hook input from stdin
-input=$(cat)
-
-# Require jq for JSON parsing
-if ! command -v jq &> /dev/null; then
-  exit 0
-fi
-
-# Get transcript path
-transcript_path=$(echo "$input" | jq -r '.transcript_path // empty' 2>/dev/null)
-
-if [ -z "$transcript_path" ] || [ ! -f "$transcript_path" ]; then
-  exit 0
-fi
-
-# Extract last assistant message from transcript
-# Transcript is JSONL format - each line is a message
-last_assistant_msg=$(grep '"role":"assistant"' "$transcript_path" | tail -1)
-
-if [ -z "$last_assistant_msg" ]; then
-  exit 0
-fi
-
-# Extract the text content from the message
-msg_text=$(echo "$last_assistant_msg" | jq -r '.message.content[]? | select(.type == "text") | .text' 2>/dev/null)
-
-if [ -z "$msg_text" ]; then
-  exit 0
-fi
-
-# Extract JSON blob containing our required fields (order-independent)
-# Strategy: Use jq to find and validate the response summary object
-# Look for object with exactly our three boolean fields anywhere in the text
-json_blob=$(echo "$msg_text" | grep -oE '\{[^}]+\}' | while IFS= read -r candidate; do
-  if echo "$candidate" | jq -e '
-    type == "object" and
-    (.proposedChanges | type) == "boolean" and
-    (.madeChanges | type) == "boolean" and
-    (.askedQuestion | type) == "boolean"
-  ' >/dev/null 2>&1; then
-    echo "$candidate"
-  fi
-done | tail -1)
-
-if [ -z "$json_blob" ]; then
-  # No valid JSON blob found - remind about required format
-  echo "SAFEWORD: Response missing required JSON summary. Add to end of response:" >&2
-  echo '{"proposedChanges": boolean, "madeChanges": boolean, "askedQuestion": boolean}' >&2
-  exit 2
-fi
-
-# Parse the boolean values (already validated, safe to extract)
-proposed_changes=$(echo "$json_blob" | jq -r '.proposedChanges')
-made_changes=$(echo "$json_blob" | jq -r '.madeChanges')
-asked_question=$(echo "$json_blob" | jq -r '.askedQuestion')
-
-# If asked a question, don't trigger review (waiting for user input)
-if [ "$asked_question" = "true" ]; then
-  exit 0
-fi
-
-# If either proposed or made changes, trigger quality review
-if [ "$proposed_changes" = "true" ] || [ "$made_changes" = "true" ]; then
-  echo "SAFEWORD Quality Review:" >&2
-  echo "" >&2
-  echo "Double check and critique your work again just in case." >&2
-  echo "Assume you've never seen it before." >&2
-  echo "" >&2
-  echo "- Is it correct?" >&2
-  echo "- Is it elegant?" >&2
-  echo "- Does it follow latest docs/best practices?" >&2
-  echo "- Ask me any non-obvious questions." >&2
-  echo "- Avoid bloat." >&2
-  exit 2
-fi
-
-exit 0

package/templates/lib/common.sh

@@ -1,26 +0,0 @@
-#!/bin/bash
-# Safeword common utilities for hook scripts
-
-# Output JSON response for Claude Code hooks
-# Usage: json_response '{"key": "value"}'
-json_response() {
-  echo "$1"
-}
-
-# Check if running in a safeword project
-is_safeword_project() {
-  [ -d ".safeword" ]
-}
-
-# Get project root (directory containing .safeword)
-get_project_root() {
-  local dir="$PWD"
-  while [ "$dir" != "/" ]; do
-    if [ -d "$dir/.safeword" ]; then
-      echo "$dir"
-      return 0
-    fi
-    dir=$(dirname "$dir")
-  done
-  return 1
-}

package/templates/lib/jq-fallback.sh

@@ -1,20 +0,0 @@
-#!/bin/bash
-# Fallback JSON output when jq is not available
-# Uses printf for safe JSON string escaping
-
-# Escape a string for JSON output
-json_escape() {
-  local str="$1"
-  str="${str//\\/\\\\}"
-  str="${str//\"/\\\"}"
-  str="${str//$'\n'/\\n}"
-  str="${str//$'\t'/\\t}"
-  echo "$str"
-}
-
-# Output a simple JSON object with one key-value pair
-json_kv() {
-  local key="$1"
-  local value="$2"
-  printf '{"proposedChanges": false, "madeChanges": false, "askedQuestion": false, "%s": "%s"}\n' "$key" "$(json_escape "$value")"
-}