@snapback/cli 1.6.0 → 3.0.1

package/README.md

@@ -6,9 +6,9 @@
 [![npm downloads](https://img.shields.io/npm/dm/@snapback/cli.svg)](https://www.npmjs.com/package/@snapback/cli)
 [![License](https://img.shields.io/npm/l/@snapback/cli.svg)](https://github.com/snapback-dev/snapback-cli/blob/main/LICENSE)
 
-AI coding assistants like **Cursor**, **GitHub Copilot**, and **Claude** are incredible—until they're not. One wrong autocomplete can cascade into hours of debugging. Git doesn't help because you haven't committed yet.
+AI coding agents—Cursor, Claude Code, GitHub Copilot, Windsurf—are incredible until they're not. One hallucinated change cascades into hours of debugging. Git doesn't help because you haven't committed yet. And the faster you vibe-code, the faster mistakes compound.
 
-**SnapBack is your safety net for AI-native development.**
+**SnapBack makes your codebase smarter every session.** Day 1: Detection. Day 30: Patterns. Day 90: Prediction.
 
 ## Why SnapBack?
 
@@ -22,8 +22,8 @@ AI coding assistants like **Cursor**, **GitHub Copilot**, and **Claude** are inc
 
 ### Key Metrics
 
-- ⚡ **<100ms** snapshot creation
-- 🎯 **89%** AI change detection accuracy
+- ⚡ **<100ms** snapshot creation (tested on 10K file repo, MacBook Pro M1, SSD)
+- 🎯 **89%** AI change detection accuracy (internal benchmark, Q4 2025)
 - 🔒 **Privacy-first** — code never leaves your machine
 - 🧠 **Self-improving** — learns from your mistakes automatically
 
@@ -52,6 +52,8 @@ For terminal workflows, CI/CD integration, and MCP server setup:
 ```bash
 # Install globally
 npm install -g @snapback/cli
+# or
+pnpm add -g @snapback/cli
 
 # Or run without installing
 npx @snapback/cli <command>
@@ -83,13 +85,20 @@ snap undo
 
 ---
 
-## MCP Integration (Cursor, Claude, Windsurf)
+## Integration with AI Tools & Editors
 
-SnapBack includes an MCP (Model Context Protocol) server that lets AI assistants understand your codebase and create checkpoints.
+SnapBack supports **two protocol layers** for maximum compatibility:
 
-### Quick Setup (Recommended)
+### MCP Integration (AI Assistants)
 
-The CLI can automatically configure MCP for all detected AI tools:
+**Model Context Protocol** for AI assistants like Claude, Cursor, and Windsurf.
+
+**Supported AI Tools:**
+- **Claude Desktop** - `.claude/mcp.json` or `~/.claude.json`
+- **Qoder** - `.qoder-mcp-config.json`
+- **Cursor, Windsurf, cline, Gemini, Roo Code** - `mcpServers` format
+
+**Quick Setup:**
 
 ```bash
 # Auto-detect and configure all AI tools
@@ -101,6 +110,55 @@ snap tools configure --claude
 snap tools configure --windsurf
 ```
 
+### ACP Integration (Editor Agents)
+
+**Agent Communication Protocol** for editor-native agents in Zed, JetBrains, and Neovim.
+
+**Supported Editors:**
+- **Zed** - `~/.config/zed/settings.json` (`agent_servers`)
+- **JetBrains AI Assistant** - `~/.config/jetbrains/ai-assistant.json`
+- **Neovim** - Coming soon
+
+**Quick Setup:**
+
+```bash
+# Auto-configure for Zed
+snap acp configure --zed
+
+# Auto-configure for JetBrains
+snap acp configure --jetbrains
+
+# Or configure all detected editors
+snap acp configure --all
+```
+
+**Manual Setup:**
+
+```bash
+# View configuration examples
+snap acp info
+
+# Start ACP server manually
+snap acp serve
+
+# Or start with workspace path and verbose logging
+snap acp serve --workspace /path/to/project --verbose
+```
+
+**How it works:** The `snap acp serve` command starts a JSON-RPC 2.0 server over stdin/stdout that your editor communicates with. No network required - fully local.
+
+---
+
+### Compatibility Matrix
+
+| Integration Layer | Protocol | Editors/Tools |
+|-------------------|----------|---------------|
+| **VS Code Extension** | Extension API | VS Code, Cursor, VSCodium, Code Server |
+| **MCP** | JSON-RPC over stdio | Claude Desktop, Qoder, Windsurf, cline, Gemini, Roo Code |
+| **ACP** | JSON-RPC 2.0 + Content-Length | Zed, JetBrains, Neovim |
+
+**Total**: 13 tools/editors across 3 protocol layers.
+
 ### Manual Setup
 
 If you prefer manual configuration or the auto-setup doesn't work, add this to your AI tool's MCP config:
@@ -203,14 +261,33 @@ snap tools repair
 
 ### Available MCP Tools
 
-Once configured, your AI assistant can use:
+Once configured, your AI assistant uses the **V2 4-tool surface** — a session-oriented API designed for agentic coding loops:
 
-| Tool | Description |
-|------|-------------|
-| `snapback.get_context` | Understand your codebase |
-| `snapback.analyze_risk` | Assess change risks |
-| `snapback.create_checkpoint` | Create safety snapshots (Pro) |
-| `snapback.restore_checkpoint` | Recover from mistakes (Pro) |
+| Tool | When to call | What it returns |
+|------|-------------|----------------|
+| `snap_begin` | Start of every task | Intelligence briefing: past learnings, active warnings, session lineage |
+| `snap_pulse` | Mid-session check | Read-only vitals: pulse level, risk pressure, trajectory |
+| `snap_learn` | Any discovery | Captures a pattern, gotcha, or decision for future sessions |
+| `snap_end` | Task complete | Ceremony: outcome recorded, carry-forward context for next session |
+
+**The agentic workflow** (runs automatically in your AI assistant):
+
+```
+snap_begin({ task: "refactor auth module" })
+  → briefing with learnings, warnings, risk context
+
+  [... agent works ...]
+
+snap_pulse()  // optional mid-session check
+  → pulse: elevated, pressure: 42%, trajectory: stable
+
+snap_learn({ insight: "always snapshot before token refresh logic" })
+
+snap_end({ outcome: "completed", summary: "..." })
+  → ceremony: files changed, patterns captured, context for next session
+```
+
+The full surface (check, advise, safe_to_write, refactoring intelligence, learning intelligence) is also available for advanced workflows — see [MCP documentation →](https://docs.snapback.dev/mcp).
 
 ---
 
@@ -273,10 +350,13 @@ Once configured, your AI assistant can use:
 
 | Command | Description |
 |---------|-------------|
-| `snap context [task]` | Get relevant patterns before starting work |
+| `snap context [task]` | Pre-task briefing: relevant patterns, warnings, risk context (CLI equivalent of `snap_begin`) |
 | `snap validate <file>` | Run 7-layer validation pipeline |
 | `snap validate --all` | Validate all staged files |
 | `snap stats` | Show learning statistics |
+| `snap metrics [file]` | File momentum scores — which files are highest-churn / highest-risk |
+| `snap sync` | Collect signals and fit momentum scoring normalizers |
+| `snap refresh [--since]` | Incremental signal update |
 
 ### Learning Commands
 
@@ -295,7 +375,10 @@ Once configured, your AI assistant can use:
 | `snap protect remove <file>` | Remove from protection |
 | `snap protect list` | List protected files |
 | `snap session start` | Start a coding session |
-| `snap session end` | End current session |
+| `snap session end` | End current session (with learnings and validation) |
+| `snap session end -l "learning"` | End session and capture learnings |
+| `snap session end --ceremony` | End with validation (quick/standard/comprehensive) |
+| `snap session end --outcome completed` | End with outcome status |
 | `snap watch` | Continuous file watching |
 
 ### MCP & Tools Commands
@@ -313,14 +396,30 @@ Once configured, your AI assistant can use:
 | `snap tools validate` | Validate MCP configurations |
 | `snap tools repair` | Repair broken MCP configurations |
 
-### Daemon Commands
+### Daemon & Service Commands
 
 | Command | Description |
 |---------|-------------|
-| `snap daemon start` | Start SnapBack daemon |
+| `snap daemon start [--detach]` | Start SnapBack daemon (CLI↔Extension coordination) |
 | `snap daemon stop` | Stop SnapBack daemon |
 | `snap daemon status` | Check daemon status |
 | `snap daemon restart` | Restart daemon |
+| `snap daemon ping` | Verify daemon is responsive |
+| `snap service start [--daemon]` | Start local service (shared state for multi-client) |
+| `snap service stop` | Stop local service |
+| `snap service status` | Check service status |
+| `snap service logs [--follow]` | Stream service logs |
+| `snap service install` | Register as system service |
+| `snap service uninstall` | Unregister system service |
+
+### Workspace Baseline Commands
+
+| Command | Description |
+|---------|-------------|
+| `snap baseline scan` | Scan workspace and build intelligence baseline |
+| `snap baseline status` | Show baseline freshness and coverage |
+| `snap baseline show` | Display current baseline data |
+| `snap baseline invalidate` | Force baseline rebuild on next scan |
 
 ### Utility Commands
 
@@ -329,7 +428,7 @@ Once configured, your AI assistant can use:
 | `snap wizard` | Interactive first-run setup |
 | `snap doctor` | Diagnostics and health check |
 | `snap doctor --fix` | Auto-fix detected issues |
-| `snap upgrade` | Check for CLI updates |
+| `snap upgrade [--check|--canary]` | Update CLI or check for new version |
 | `snap config list` | List configuration values |
 | `snap config get <key>` | Get a specific config value |
 | `snap config set <key> <value>` | Set a configuration value |
@@ -580,7 +679,7 @@ $ snap doctor
 
 Unlock Pro features like checkpoint creation and restoration:
 
-👉 **[console.snapback.dev/settings/api-keys](https://console.snapback.dev/settings/api-keys)**
+👉 **[console.snapback.dev/app/settings/api-keys](https://console.snapback.dev/app/settings/api-keys)**
 
 ---
 
@@ -591,7 +690,7 @@ Unlock Pro features like checkpoint creation and restoration:
 ---
 
 <p align="center">
-  <strong>Stop losing work to AI mistakes.</strong><br>
+  <strong>SnapBack saw it coming.</strong><br>
   <a href="https://snapback.dev">Website</a> ·
   <a href="https://docs.snapback.dev">Docs</a> ·
   <a href="https://console.snapback.dev">Dashboard</a> ·

package/dist/SkippedTestDetector-AXTMWWHC.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node --no-warnings=ExperimentalWarning
+export { analyzeSkippedTests, detectSkippedTests, getSkippedTestSummary } from './chunk-4YTE4JEW.js';
+import './chunk-7ADPL4Q3.js';
+
+process.env.SNAPBACK_CLI='true';

package/dist/SkippedTestDetector-QLSQV7K7.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node --no-warnings=ExperimentalWarning
+export { analyzeSkippedTests, detectSkippedTests, getSkippedTestSummary } from './chunk-ZBQDE6WJ.js';
+import './chunk-7ADPL4Q3.js';
+
+process.env.SNAPBACK_CLI='true';

package/dist/analysis-6WTBZJH3.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node --no-warnings=ExperimentalWarning
+export { ChangeImpactAnalyzer, CompletenessAnalyzer, ComplexityAnalyzer, ImportGraphAnalyzer, SecurityAnalyzer, SyntaxAnalyzer, checkFilesForOrphanStatus, countASTNodes, createChangeImpactAnalyzer, detectOrphans, extractImportSources, extractImports, extractImportsBatch, filterOrphansToFiles, isSupportedFile, offsetToLine, parseSource, runAnalysisPipeline, runStaticAnalysis, walkAST } from './chunk-5SQA44V7.js';
+export { analyzeSkippedTests, detectSkippedTests, getSkippedTestSummary } from './chunk-4YTE4JEW.js';
+import './chunk-7ADPL4Q3.js';
+
+process.env.SNAPBACK_CLI='true';