claude-code-pulsify 1.2.0 → 1.3.0

package/README.md

@@ -34,6 +34,14 @@ npx claude-code-pulsify@latest --uninstall
 - **Context monitor** -- Warns at 65% and 75% context usage via PostToolUse hook
 - **Update checker** -- Background version check on session start, non-blocking
 
+## Context bar
+
+The context bar shows **usable** context, not raw token count — it accounts for Claude's autocompact buffer (~16.5% of the window), which is reserved and unavailable to you.
+
+- **0%** = fresh session
+- **100%** = autocompact imminent (context will be compressed)
+- Color thresholds: **green** (<50%) → **yellow** (50-65%) → **orange** (65-80%) → **red** (>80%)
+
 ## Checking your installed version
 
 ```bash
@@ -49,3 +57,8 @@ You can also check manually:
 ## Configuration
 
 Respects the `CLAUDE_CONFIG_DIR` environment variable. Defaults to `~/.claude`.
+
+## Future Enhancements
+
+- Lines changed display (+added / -removed)
+- Token usage counter

package/bin/install.js

@@ -4,6 +4,8 @@
 const fs = require('node:fs')
 const path = require('node:path')
 
+const { isOurEntry, upsertHookArray, removeFromHookArray } = require('../lib/install')
+
 const PACKAGE_VERSION = require('../package.json').version
 const HOOKS_SOURCE = path.join(__dirname, '..', 'hooks')
 const HOOK_FILES = ['statusline.js', 'context-monitor.js', 'check-update.js', 'check-update-worker.js']
@@ -33,24 +35,6 @@ function writeJSON(filePath, data) {
   fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf8')
 }
 
-function isOurEntry(entry) {
-  const cmd = entry?.hooks?.[0]?.command || ''
-  return cmd.includes('claude-code-pulsify')
-}
-
-function upsertHookArray(arr, newEntry) {
-  const idx = arr.findIndex(isOurEntry)
-  if (idx >= 0) {
-    arr[idx] = newEntry
-  } else {
-    arr.push(newEntry)
-  }
-}
-
-function removeFromHookArray(arr) {
-  return arr.filter((entry) => !isOurEntry(entry))
-}
-
 // --- Install ---
 
 function install() {

package/hooks/context-monitor.js

@@ -8,21 +8,9 @@
  */
 
 const fs = require('node:fs')
-const path = require('node:path')
 
-// Thresholds on "used percentage" (normalized, 0-100)
-const WARNING_THRESHOLD = 65 // remaining ~35% usable
-const CRITICAL_THRESHOLD = 75 // remaining ~25% usable
-
-// Debounce: minimum tool calls between repeated warnings at the same severity
-const DEBOUNCE_COUNT = 5
-
-// Bridge data older than this is considered stale and ignored
-const BRIDGE_STALE_MS = 60_000
-
-function sanitizeId(id) {
-  return id.replace(/[^a-zA-Z0-9_-]/g, '')
-}
+const { sanitizeId } = require('../lib/statusline')
+const { BRIDGE_STALE_MS, getSeverity, shouldFireWarning } = require('../lib/context')
 
 // State file to track debounce across invocations
 function getStateFile(sessionId) {
@@ -78,20 +66,14 @@ async function main() {
   if (usedPct == null) return
 
   // Determine severity
-  let severity = null
-  if (usedPct >= CRITICAL_THRESHOLD) severity = 'CRITICAL'
-  else if (usedPct >= WARNING_THRESHOLD) severity = 'WARNING'
-
+  const severity = getSeverity(usedPct)
   if (!severity) return // Context is fine
 
   // Debounce logic
   const state = readState(sessionId)
   state.callsSinceWarning = (state.callsSinceWarning || 0) + 1
 
-  const isEscalation = severity === 'CRITICAL' && state.lastSeverity === 'WARNING'
-  const shouldWarn = isEscalation || state.callsSinceWarning >= DEBOUNCE_COUNT
-
-  if (!shouldWarn) {
+  if (!shouldFireWarning(state.callsSinceWarning, severity, state.lastSeverity)) {
     writeState(sessionId, state)
     return
   }

package/hooks/statusline.js

@@ -10,72 +10,10 @@
 const fs = require('node:fs')
 const path = require('node:path')
 
-// ANSI helpers
-const ESC = '\x1b['
-const RESET = `${ESC}0m`
-const BOLD = `${ESC}1m`
-const DIM = `${ESC}2m`
-const FG = (r, g, b) => `${ESC}38;2;${r};${g};${b}m`
-
-// Colors
-const GRAY = FG(100, 100, 100)
-const WHITE = FG(200, 200, 200)
-const GREEN = FG(80, 200, 80)
-const YELLOW = FG(220, 200, 60)
-const ORANGE = FG(230, 140, 40)
-const RED = FG(220, 60, 60)
-const CYAN = FG(80, 200, 220)
-
-const SEPARATOR = `${GRAY}\u2502${RESET}`
-
-const PROGRESS_BAR_SEGMENTS = 15
-const MAX_TASK_LABEL_LENGTH = 40
-
-// Claude's autocompact kicks in around 16.5% remaining context.
-// We normalize the bar so 0% = empty, 100% = autocompact threshold,
-// giving users a view of their *usable* context rather than total.
-const AUTOCOMPACT_BUFFER = 16.5
-
-function sanitizeId(id) {
-  return id.replace(/[^a-zA-Z0-9_-]/g, '')
-}
-
-function normalizeUsage(remainingPct) {
-  // remaining_percentage goes from 100 (empty) to 0 (full)
-  // usable range is 100 down to ~16.5 (autocompact buffer)
-  const usableRange = 100 - AUTOCOMPACT_BUFFER
-  const usableRemaining = Math.max(0, remainingPct - AUTOCOMPACT_BUFFER)
-  const usedPct = ((usableRange - usableRemaining) / usableRange) * 100
-  return Math.min(100, Math.max(0, usedPct))
-}
-
-function getBarColor(usedPct) {
-  if (usedPct < 50) return GREEN
-  if (usedPct < 65) return YELLOW
-  if (usedPct < 80) return ORANGE
-  return RED
-}
-
-function buildProgressBar(usedPct) {
-  const filled = Math.round((usedPct / 100) * PROGRESS_BAR_SEGMENTS)
-  const empty = PROGRESS_BAR_SEGMENTS - filled
-  const color = getBarColor(usedPct)
-  const emphasis = usedPct >= 80 ? BOLD : ''
-
-  const filledBar = `${emphasis}${color}${'█'.repeat(filled)}${RESET}`
-  const emptyBar = `${GRAY}${'░'.repeat(empty)}${RESET}`
-  const pctLabel = `${color}${BOLD}${Math.round(usedPct)}%${RESET}`
-
-  return `${filledBar}${emptyBar} ${pctLabel}`
-}
-
-function getActiveTask(data) {
-  const todos = data.todos || []
-  const active = todos.find((t) => t.status === 'in_progress') || todos.find((t) => t.status === 'pending')
-  if (!active) return null
-  const label = active.content || active.description || ''
-  return label.length > MAX_TASK_LABEL_LENGTH ? label.slice(0, MAX_TASK_LABEL_LENGTH - 3) + '...' : label
-}
+const {
+  RESET, DIM, WHITE, CYAN, SEPARATOR,
+  sanitizeId, normalizeUsage, buildProgressBar, getActiveTask, formatCost,
+} = require('../lib/statusline')
 
 function getUpdateIndicator() {
   const configDir = process.env.CLAUDE_CONFIG_DIR || path.join(require('node:os').homedir(), '.claude')
@@ -114,30 +52,6 @@ function writeBridgeFile(sessionId, metrics) {
   }
 }
 
-function formatCost(costUsd) {
-  if (!costUsd) return ''
-  if (costUsd < 1) return `${WHITE}$${costUsd.toFixed(2).replace(/0+$/, '').replace(/\.$/, '')}${RESET}`
-  const str = costUsd.toFixed(1).replace(/\.0$/, '')
-  return `${WHITE}$${str}${RESET}`
-}
-
-function formatLinesChanged(added, removed) {
-  const parts = []
-  if (added) parts.push(`${GREEN}+${added}${RESET}`)
-  if (removed) parts.push(`${RED}-${removed}${RESET}`)
-  return parts.join(' ')
-}
-
-function formatTokenCount(input, output) {
-  const total = (input || 0) + (output || 0)
-  if (!total) return ''
-  let compact
-  if (total >= 1e6) compact = `${(total / 1e6).toFixed(1)}M`
-  else if (total >= 1e3) compact = `${(total / 1e3).toFixed(1)}k`
-  else compact = `${total}`
-  return `${DIM}${compact} tok${RESET}`
-}
-
 async function main() {
   let input = ''
   await Promise.race([
@@ -179,10 +93,6 @@ async function main() {
   const remainingPct = data.context_window?.remaining_percentage ?? 100
   const sessionId = data.session?.id || data.session_id || null
   const costUsd = data.cost?.total_cost_usd ?? 0
-  const linesAdded = data.cost?.total_lines_added ?? 0
-  const linesRemoved = data.cost?.total_lines_removed ?? 0
-  const totalInputTokens = data.context_window?.total_input_tokens ?? 0
-  const totalOutputTokens = data.context_window?.total_output_tokens ?? 0
 
   // Normalize and build bar
   const usedPct = normalizeUsage(remainingPct)
@@ -207,10 +117,8 @@ async function main() {
     model,
   })
 
-  // Format new segments
+  // Format cost
   const cost = formatCost(costUsd)
-  const lines = formatLinesChanged(linesAdded, linesRemoved)
-  const tokenCount = formatTokenCount(totalInputTokens, totalOutputTokens)
 
   // Build segments array (only include non-empty optional segments)
   const segments = [
@@ -218,9 +126,7 @@ async function main() {
     dirLabel,
   ]
   if (cost) segments.push(cost)
-  if (lines) segments.push(lines)
-  const barWithTokens = tokenCount ? `${bar} ${tokenCount}` : bar
-  segments.push(barWithTokens)
+  segments.push(bar)
 
   // Output statusline
   const line = segments.join(` ${SEPARATOR} `) + taskSegment + updateIndicator

package/lib/context.js

@@ -0,0 +1,31 @@
+'use strict'
+
+// Thresholds on "used percentage" (normalized, 0-100)
+const WARNING_THRESHOLD = 65 // remaining ~35% usable
+const CRITICAL_THRESHOLD = 75 // remaining ~25% usable
+
+// Debounce: minimum tool calls between repeated warnings at the same severity
+const DEBOUNCE_COUNT = 5
+
+// Bridge data older than this is considered stale and ignored
+const BRIDGE_STALE_MS = 60_000
+
+function getSeverity(usedPct) {
+  if (usedPct >= CRITICAL_THRESHOLD) return 'CRITICAL'
+  if (usedPct >= WARNING_THRESHOLD) return 'WARNING'
+  return null
+}
+
+function shouldFireWarning(callsSinceWarning, severity, lastSeverity) {
+  const isEscalation = severity === 'CRITICAL' && lastSeverity === 'WARNING'
+  return isEscalation || callsSinceWarning >= DEBOUNCE_COUNT
+}
+
+module.exports = {
+  WARNING_THRESHOLD,
+  CRITICAL_THRESHOLD,
+  DEBOUNCE_COUNT,
+  BRIDGE_STALE_MS,
+  getSeverity,
+  shouldFireWarning,
+}

package/lib/install.js

@@ -0,0 +1,21 @@
+'use strict'
+
+function isOurEntry(entry) {
+  const cmd = entry?.hooks?.[0]?.command || ''
+  return cmd.includes('claude-code-pulsify')
+}
+
+function upsertHookArray(arr, newEntry) {
+  const idx = arr.findIndex(isOurEntry)
+  if (idx >= 0) {
+    arr[idx] = newEntry
+  } else {
+    arr.push(newEntry)
+  }
+}
+
+function removeFromHookArray(arr) {
+  return arr.filter((entry) => !isOurEntry(entry))
+}
+
+module.exports = { isOurEntry, upsertHookArray, removeFromHookArray }

package/lib/statusline.js

@@ -0,0 +1,83 @@
+'use strict'
+
+// ANSI helpers
+const ESC = '\x1b['
+const RESET = `${ESC}0m`
+const BOLD = `${ESC}1m`
+const DIM = `${ESC}2m`
+const FG = (r, g, b) => `${ESC}38;2;${r};${g};${b}m`
+
+// Colors
+const GRAY = FG(100, 100, 100)
+const WHITE = FG(200, 200, 200)
+const GREEN = FG(80, 200, 80)
+const YELLOW = FG(220, 200, 60)
+const ORANGE = FG(230, 140, 40)
+const RED = FG(220, 60, 60)
+const CYAN = FG(80, 200, 220)
+
+const SEPARATOR = `${GRAY}\u2502${RESET}`
+
+const PROGRESS_BAR_SEGMENTS = 15
+const MAX_TASK_LABEL_LENGTH = 40
+
+// Claude's autocompact kicks in around 16.5% remaining context.
+// We normalize the bar so 0% = empty, 100% = autocompact threshold,
+// giving users a view of their *usable* context rather than total.
+const AUTOCOMPACT_BUFFER = 16.5
+
+function sanitizeId(id) {
+  return id.replace(/[^a-zA-Z0-9_-]/g, '')
+}
+
+function normalizeUsage(remainingPct) {
+  // remaining_percentage goes from 100 (empty) to 0 (full)
+  // usable range is 100 down to ~16.5 (autocompact buffer)
+  const usableRange = 100 - AUTOCOMPACT_BUFFER
+  const usableRemaining = Math.max(0, remainingPct - AUTOCOMPACT_BUFFER)
+  const usedPct = ((usableRange - usableRemaining) / usableRange) * 100
+  return Math.min(100, Math.max(0, usedPct))
+}
+
+function getBarColor(usedPct) {
+  if (usedPct < 50) return GREEN
+  if (usedPct < 65) return YELLOW
+  if (usedPct < 80) return ORANGE
+  return RED
+}
+
+function buildProgressBar(usedPct) {
+  const filled = Math.round((usedPct / 100) * PROGRESS_BAR_SEGMENTS)
+  const empty = PROGRESS_BAR_SEGMENTS - filled
+  const color = getBarColor(usedPct)
+  const emphasis = usedPct >= 80 ? BOLD : ''
+
+  const filledBar = `${emphasis}${color}${'█'.repeat(filled)}${RESET}`
+  const emptyBar = `${GRAY}${'░'.repeat(empty)}${RESET}`
+  const pctLabel = `${color}${BOLD}${Math.round(usedPct)}%${RESET}`
+
+  return `${filledBar}${emptyBar} ${pctLabel}`
+}
+
+function getActiveTask(data) {
+  const todos = data.todos || []
+  const active = todos.find((t) => t.status === 'in_progress') || todos.find((t) => t.status === 'pending')
+  if (!active) return null
+  const label = active.content || active.description || ''
+  return label.length > MAX_TASK_LABEL_LENGTH ? label.slice(0, MAX_TASK_LABEL_LENGTH - 3) + '...' : label
+}
+
+function formatCost(costUsd) {
+  if (!costUsd) return ''
+  if (costUsd < 1) return `${WHITE}$${costUsd.toFixed(2).replace(/0+$/, '').replace(/\.$/, '')}${RESET}`
+  const str = costUsd.toFixed(1).replace(/\.0$/, '')
+  return `${WHITE}$${str}${RESET}`
+}
+
+module.exports = {
+  // ANSI helpers
+  RESET, DIM, WHITE, CYAN,
+  SEPARATOR,
+  // Functions
+  sanitizeId, normalizeUsage, getBarColor, buildProgressBar, getActiveTask, formatCost,
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-pulsify",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Context-aware statusline and context monitor for Claude Code",
   "bin": {
     "claude-code-pulsify": "bin/install.js"
@@ -12,12 +12,16 @@
   "engines": {
     "node": ">=20"
   },
+  "scripts": {
+    "test": "node --test 'tests/*.test.js'"
+  },
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
   "files": [
     "bin/",
-    "hooks/"
+    "hooks/",
+    "lib/"
   ]
 }