@snapback/cli 1.1.12 → 1.1.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/README.md +79 -18
  2. package/dist/SkippedTestDetector-AXTMWWHC.js +5 -0
  3. package/dist/SkippedTestDetector-QLSQV7K7.js +5 -0
  4. package/dist/analysis-6WTBZJH3.js +6 -0
  5. package/dist/analysis-C472LUGW.js +2475 -0
  6. package/dist/auth-HFJRXXG2.js +1446 -0
  7. package/dist/auto-provision-organization-SF6XM7X4.js +161 -0
  8. package/dist/chunk-23G5VYA3.js +4259 -0
  9. package/dist/{chunk-QAKFE3NE.js → chunk-4YTE4JEW.js} +3 -4
  10. package/dist/chunk-5EOPYJ4Y.js +12 -0
  11. package/dist/{chunk-G7QXHNGB.js → chunk-5SQA44V7.js} +1125 -32
  12. package/dist/{chunk-BW7RALUZ.js → chunk-7ADPL4Q3.js} +11 -4
  13. package/dist/chunk-CBGOC6RV.js +293 -0
  14. package/dist/chunk-DNEADD2G.js +3499 -0
  15. package/dist/{chunk-NKBZIXCN.js → chunk-DPWFZNMY.js} +122 -15
  16. package/dist/chunk-GQ73B37K.js +314 -0
  17. package/dist/chunk-HR34NJP7.js +6133 -0
  18. package/dist/chunk-ICKSHS3A.js +2264 -0
  19. package/dist/{chunk-KPETDXQO.js → chunk-OI2HNNT6.js} +565 -50
  20. package/dist/chunk-PL4HF4M2.js +593 -0
  21. package/dist/chunk-WS36HDEU.js +3735 -0
  22. package/dist/chunk-XYU5FFE3.js +111 -0
  23. package/dist/chunk-ZBQDE6WJ.js +108 -0
  24. package/dist/client-WIO6W447.js +8 -0
  25. package/dist/dist-E7E2T3DQ.js +9 -0
  26. package/dist/dist-TEWNOZYS.js +5 -0
  27. package/dist/dist-YZBJAYEJ.js +12 -0
  28. package/dist/index.js +65215 -26627
  29. package/dist/local-service-adapter-3JHN6G4O.js +6 -0
  30. package/dist/pioneer-oauth-hook-V2JKEXM7.js +12 -0
  31. package/dist/{secure-credentials-6UMEU22H.js → secure-credentials-UEPG7GWW.js} +15 -8
  32. package/dist/snapback-dir-MG7DTRMF.js +6 -0
  33. package/package.json +8 -42
  34. package/scripts/postinstall.mjs +2 -3
  35. package/dist/SkippedTestDetector-B3JZUE5G.js +0 -5
  36. package/dist/SkippedTestDetector-B3JZUE5G.js.map +0 -1
  37. package/dist/analysis-Z53F5FT2.js +0 -6
  38. package/dist/analysis-Z53F5FT2.js.map +0 -1
  39. package/dist/chunk-6MR2TINI.js +0 -27
  40. package/dist/chunk-6MR2TINI.js.map +0 -1
  41. package/dist/chunk-BW7RALUZ.js.map +0 -1
  42. package/dist/chunk-G7QXHNGB.js.map +0 -1
  43. package/dist/chunk-ISVRGBWT.js +0 -16223
  44. package/dist/chunk-ISVRGBWT.js.map +0 -1
  45. package/dist/chunk-KPETDXQO.js.map +0 -1
  46. package/dist/chunk-NKBZIXCN.js.map +0 -1
  47. package/dist/chunk-QAKFE3NE.js.map +0 -1
  48. package/dist/chunk-YOVA65PS.js +0 -12745
  49. package/dist/chunk-YOVA65PS.js.map +0 -1
  50. package/dist/dist-7UKXVKH3.js +0 -5
  51. package/dist/dist-7UKXVKH3.js.map +0 -1
  52. package/dist/dist-VDK7WEF4.js +0 -5
  53. package/dist/dist-VDK7WEF4.js.map +0 -1
  54. package/dist/dist-WKLJSPJT.js +0 -8
  55. package/dist/dist-WKLJSPJT.js.map +0 -1
  56. package/dist/index.js.map +0 -1
  57. package/dist/secure-credentials-6UMEU22H.js.map +0 -1
  58. package/dist/snapback-dir-T3CRQRY6.js +0 -6
  59. package/dist/snapback-dir-T3CRQRY6.js.map +0 -1
package/README.md CHANGED
@@ -1,14 +1,14 @@
1
- # @snapback/cli
2
-
3
- > **Git is for commits. SnapBack is for "oh no, what did I just do?"**
1
+ <p align="center">
2
+ <img src="./assets/github-cli.png" alt="SnapBack CLI - The command-line interface for effortless restores and snapshots" />
3
+ </p>
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/@snapback/cli.svg)](https://www.npmjs.com/package/@snapback/cli)
6
6
  [![npm downloads](https://img.shields.io/npm/dm/@snapback/cli.svg)](https://www.npmjs.com/package/@snapback/cli)
7
- [![License](https://img.shields.io/npm/l/@snapback/cli.svg)](https://github.com/snapback-dev/snapback/blob/main/LICENSE)
7
+ [![License](https://img.shields.io/npm/l/@snapback/cli.svg)](https://github.com/snapback-dev/snapback-cli/blob/main/LICENSE)
8
8
 
9
9
  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.
10
10
 
11
- **SnapBack is your safety net for AI-native development.**
11
+ **SnapBack makes your codebase smarter every session.** Day 1: Detection. Day 30: Patterns. Day 90: Prediction.
12
12
 
13
13
  ## Why SnapBack?
14
14
 
@@ -22,8 +22,8 @@ AI coding assistants like **Cursor**, **GitHub Copilot**, and **Claude** are inc
22
22
 
23
23
  ### Key Metrics
24
24
 
25
- - ⚡ **<100ms** snapshot creation
26
- - 🎯 **89%** AI change detection accuracy
25
+ - ⚡ **<100ms** snapshot creation (tested on 10K file repo, MacBook Pro M1, SSD)
26
+ - 🎯 **89%** AI change detection accuracy (internal benchmark, Q4 2025)
27
27
  - 🔒 **Privacy-first** — code never leaves your machine
28
28
  - 🧠 **Self-improving** — learns from your mistakes automatically
29
29
 
@@ -38,12 +38,12 @@ SnapBack has two primary interfaces:
38
38
  The extension provides the best experience with automatic snapshots, visual recovery UI, and real-time risk indicators.
39
39
 
40
40
  ```
41
- ext install snapback-vscode
41
+ ext install MarcelleLabs.snapback-vscode
42
42
  ```
43
43
 
44
44
  Or search "SnapBack" in the VS Code Extensions marketplace.
45
45
 
46
- [![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/snapback.snapback-vscode.svg)](https://marketplace.visualstudio.com/items?itemName=snapback.snapback-vscode)
46
+ [![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/MarcelleLabs.snapback-vscode.svg)](https://marketplace.visualstudio.com/items?itemName=MarcelleLabs.snapback-vscode)
47
47
 
48
48
  ### 💻 CLI Tool
49
49
 
@@ -52,6 +52,8 @@ For terminal workflows, CI/CD integration, and MCP server setup:
52
52
  ```bash
53
53
  # Install globally
54
54
  npm install -g @snapback/cli
55
+ # or
56
+ pnpm add -g @snapback/cli
55
57
 
56
58
  # Or run without installing
57
59
  npx @snapback/cli <command>
@@ -83,13 +85,20 @@ snap undo
83
85
 
84
86
  ---
85
87
 
86
- ## MCP Integration (Cursor, Claude, Windsurf)
88
+ ## Integration with AI Tools & Editors
89
+
90
+ SnapBack supports **two protocol layers** for maximum compatibility:
87
91
 
88
- SnapBack includes an MCP (Model Context Protocol) server that lets AI assistants understand your codebase and create checkpoints.
92
+ ### MCP Integration (AI Assistants)
89
93
 
90
- ### Quick Setup (Recommended)
94
+ **Model Context Protocol** for AI assistants like Claude, Cursor, and Windsurf.
91
95
 
92
- The CLI can automatically configure MCP for all detected AI tools:
96
+ **Supported AI Tools:**
97
+ - **Claude Desktop** - `.claude/mcp.json` or `~/.claude.json`
98
+ - **Qoder** - `.qoder-mcp-config.json`
99
+ - **Cursor, Windsurf, cline, Gemini, Roo Code** - `mcpServers` format
100
+
101
+ **Quick Setup:**
93
102
 
94
103
  ```bash
95
104
  # Auto-detect and configure all AI tools
@@ -101,6 +110,55 @@ snap tools configure --claude
101
110
  snap tools configure --windsurf
102
111
  ```
103
112
 
113
+ ### ACP Integration (Editor Agents)
114
+
115
+ **Agent Communication Protocol** for editor-native agents in Zed, JetBrains, and Neovim.
116
+
117
+ **Supported Editors:**
118
+ - **Zed** - `~/.config/zed/settings.json` (`agent_servers`)
119
+ - **JetBrains AI Assistant** - `~/.config/jetbrains/ai-assistant.json`
120
+ - **Neovim** - Coming soon
121
+
122
+ **Quick Setup:**
123
+
124
+ ```bash
125
+ # Auto-configure for Zed
126
+ snap acp configure --zed
127
+
128
+ # Auto-configure for JetBrains
129
+ snap acp configure --jetbrains
130
+
131
+ # Or configure all detected editors
132
+ snap acp configure --all
133
+ ```
134
+
135
+ **Manual Setup:**
136
+
137
+ ```bash
138
+ # View configuration examples
139
+ snap acp info
140
+
141
+ # Start ACP server manually
142
+ snap acp serve
143
+
144
+ # Or start with workspace path and verbose logging
145
+ snap acp serve --workspace /path/to/project --verbose
146
+ ```
147
+
148
+ **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.
149
+
150
+ ---
151
+
152
+ ### Compatibility Matrix
153
+
154
+ | Integration Layer | Protocol | Editors/Tools |
155
+ |-------------------|----------|---------------|
156
+ | **VS Code Extension** | Extension API | VS Code, Cursor, VSCodium, Code Server |
157
+ | **MCP** | JSON-RPC over stdio | Claude Desktop, Qoder, Windsurf, cline, Gemini, Roo Code |
158
+ | **ACP** | JSON-RPC 2.0 + Content-Length | Zed, JetBrains, Neovim |
159
+
160
+ **Total**: 13 tools/editors across 3 protocol layers.
161
+
104
162
  ### Manual Setup
105
163
 
106
164
  If you prefer manual configuration or the auto-setup doesn't work, add this to your AI tool's MCP config:
@@ -295,7 +353,10 @@ Once configured, your AI assistant can use:
295
353
  | `snap protect remove <file>` | Remove from protection |
296
354
  | `snap protect list` | List protected files |
297
355
  | `snap session start` | Start a coding session |
298
- | `snap session end` | End current session |
356
+ | `snap session end` | End current session (with learnings and validation) |
357
+ | `snap session end -l "learning"` | End session and capture learnings |
358
+ | `snap session end --ceremony` | End with validation (quick/standard/comprehensive) |
359
+ | `snap session end --outcome completed` | End with outcome status |
299
360
  | `snap watch` | Continuous file watching |
300
361
 
301
362
  ### MCP & Tools Commands
@@ -572,7 +633,7 @@ $ snap doctor
572
633
 
573
634
  | Package | Description |
574
635
  |---------|-------------|
575
- | [snapback-vscode](https://marketplace.visualstudio.com/items?itemName=snapback.snapback-vscode) | VS Code extension with visual UI |
636
+ | [MarcelleLabs.snapback-vscode](https://marketplace.visualstudio.com/items?itemName=MarcelleLabs.snapback-vscode) | VS Code extension with visual UI |
576
637
 
577
638
  ---
578
639
 
@@ -586,14 +647,14 @@ Unlock Pro features like checkpoint creation and restoration:
586
647
 
587
648
  ## License
588
649
 
589
- [Apache-2.0](https://github.com/snapback-dev/snapback/blob/main/LICENSE)
650
+ [Apache-2.0](https://github.com/snapback-dev/snapback-cli/blob/main/LICENSE)
590
651
 
591
652
  ---
592
653
 
593
654
  <p align="center">
594
- <strong>Stop losing work to AI mistakes.</strong><br>
655
+ <strong>SnapBack saw it coming.</strong><br>
595
656
  <a href="https://snapback.dev">Website</a> ·
596
657
  <a href="https://docs.snapback.dev">Docs</a> ·
597
658
  <a href="https://console.snapback.dev">Dashboard</a> ·
598
- <a href="https://discord.gg/snapback">Discord</a>
659
+ <a href="https://discord.gg/B4BXeYkE2F">Discord</a>
599
660
  </p>
@@ -0,0 +1,5 @@
1
+ #!/usr/bin/env node --no-warnings=ExperimentalWarning
2
+ export { analyzeSkippedTests, detectSkippedTests, getSkippedTestSummary } from './chunk-4YTE4JEW.js';
3
+ import './chunk-7ADPL4Q3.js';
4
+
5
+ process.env.SNAPBACK_CLI='true';
@@ -0,0 +1,5 @@
1
+ #!/usr/bin/env node --no-warnings=ExperimentalWarning
2
+ export { analyzeSkippedTests, detectSkippedTests, getSkippedTestSummary } from './chunk-ZBQDE6WJ.js';
3
+ import './chunk-7ADPL4Q3.js';
4
+
5
+ process.env.SNAPBACK_CLI='true';
@@ -0,0 +1,6 @@
1
+ #!/usr/bin/env node --no-warnings=ExperimentalWarning
2
+ 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';
3
+ export { analyzeSkippedTests, detectSkippedTests, getSkippedTestSummary } from './chunk-4YTE4JEW.js';
4
+ import './chunk-7ADPL4Q3.js';
5
+
6
+ process.env.SNAPBACK_CLI='true';