@ulrichc1/sparn 1.0.0 → 1.1.0

package/README.md

@@ -1,10 +1,14 @@
 # Sparn
 
+[![npm version](https://img.shields.io/npm/v/@ulrichc1/sparn.svg)](https://www.npmjs.com/package/@ulrichc1/sparn)
+[![npm downloads](https://img.shields.io/npm/dm/@ulrichc1/sparn.svg)](https://www.npmjs.com/package/@ulrichc1/sparn)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 > 🧠 Neuroscience-inspired context optimization for AI coding agents
 
-**Status**: ✅ **Production Ready** - All Core Features Complete
+**Status**: ✅ **Production Ready** - All Core Features Complete + Real-Time Optimization
 
-**Version**: 1.0.0
+**Version**: 1.1.0
 
 ---
 
@@ -34,10 +38,17 @@ Sparn is an npm CLI package that applies 6 neuroscience principles to intelligen
   - GenericAdapter + ClaudeCodeAdapter (Agent-Agnostic)
   - SleepCompressor (Sleep Replay)
 - ✅ **Context Optimization** - 60-90% token reduction pipeline
-- ✅ **CLI Commands** - init, optimize, stats, relay, consolidate, config
+- ✅ **Real-Time Optimization** (NEW!) - Always-on background daemon and hooks
+  - Background daemon with auto-optimization at 80K token threshold
+  - Claude Code hooks (pre-prompt & post-tool-result)
+  - Incremental optimization with <50ms delta processing
+  - Budget-aware pruning targeting specific token counts
+  - Tool output compression (npm, docker, tests, git diffs)
+- ✅ **CLI Commands** - init, optimize, stats, relay, consolidate, config, daemon, hooks
 - ✅ **Programmatic API** - Full TypeScript support, JSDoc, standalone modules
 - ✅ **Database** - SQLite with dual index/value tables, corruption detection
 - ✅ **Configuration** - YAML config with runtime modification
+- ✅ **Metrics & Telemetry** - P50/P95/P99 latency tracking, cache hit rates, token savings
 
 ### ✨ Polish & UX
 - ✨ **Progress Indicators** - Real-time ora spinners for all long operations
@@ -48,10 +59,10 @@ Sparn is an npm CLI package that applies 6 neuroscience principles to intelligen
 - ✨ **Lazy Loading** - Fast startup (<200ms for --help/--version)
 
 ### 📊 Quality & CI/CD
-- 📊 **96 Tests** - 51 unit + 45 integration tests, all passing
-- 📊 **Benchmarks** - Token reduction, processing speed, memory usage
+- 📊 **176 Tests** - Comprehensive unit + integration test coverage, all passing
+- 📊 **Performance Benchmarks** - Validates <50ms incremental optimization target
 - 📊 **CI Pipeline** - GitHub Actions with cross-platform tests (Ubuntu, macOS, Windows)
-- 📊 **Documentation** - NEUROSCIENCE.md, CONTRIBUTING.md, comprehensive README
+- 📊 **Documentation** - NEUROSCIENCE.md, CONTRIBUTING.md, CHANGELOG.md, comprehensive README
 - 📊 **NPM Ready** - Package validated with publish --dry-run
 
 ---
@@ -116,12 +127,37 @@ Before/after token savings with progress bars and celebration messages:
 
 ---
 
+## 🤖 Claude Code Integration
+
+**NEW!** Sparn now integrates with Claude Code CLI for real-time context optimization!
+
+### Quick Start with Claude Code
+
+1. **Install the skill**:
+   ```bash
+   # Skill is pre-installed at ~/.claude/skills/sparn/
+   # Just ensure Sparn is installed globally
+   npm install -g @ulrichc1/sparn
+   ```
+
+2. **Use in Claude Code**:
+   ```bash
+   claude-code
+   > /sparn.go        # Start real-time optimization
+   > /sparn.optimize  # Manual optimization
+   > /sparn.stats     # View statistics
+   ```
+
+**See** [`CLAUDE-CODE-SKILL.md`](./CLAUDE-CODE-SKILL.md) **for complete documentation.**
+
+---
+
 ## Installation
 
 ### Global CLI Install
 
 ```bash
-npm install -g sparn
+npm install -g @ulrichc1/sparn
 
 # Verify installation
 sparn --version
@@ -130,11 +166,11 @@ sparn --version
 ### Project Dependency
 
 ```bash
-npm install sparn
+npm install @ulrichc1/sparn
 
 # Or with other package managers
-yarn add sparn
-pnpm add sparn
+yarn add @ulrichc1/sparn
+pnpm add @ulrichc1/sparn
 ```
 
 ---