savepoint 1.0.12 → 1.2.2

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.
package/README.md CHANGED
@@ -67,6 +67,39 @@ Built for a cinematic, technical feel without the bloat.
67
67
 
68
68
  ---
69
69
 
70
+ ## 🐛 Defect Workflow
71
+
72
+ When a bug surfaces during a build or after a release, create a defect file instead of a new task. Defects live in `.savepoint/releases/{release}/defects/` and are tracked separately from the epic backlog so the audit trail stays clean.
73
+
74
+ ```
75
+ .savepoint/releases/v1/defects/
76
+ D001-auth-crash.md
77
+ D002-slow-query.md
78
+ ```
79
+
80
+ Each defect file uses YAML frontmatter:
81
+
82
+ ```yaml
83
+ ---
84
+ id: v1/D001-auth-crash
85
+ release: v1
86
+ status: planned # planned | in_progress | done
87
+ severity: high # critical | high | medium | low
88
+ title: "Auth crash on empty token"
89
+ introduced: v1.0.3 # optional: version where bug appeared
90
+ reference: E12-slug/T003-slug # optional: related task ID
91
+ ---
92
+ ```
93
+
94
+ - Press **`d`** on the board to open the defect overlay and see all defects for the current release.
95
+ - `savepoint doctor` validates defect files and reports malformed frontmatter, invalid status, and broken task references.
96
+
97
+ **Use a defect when:** a regression is found in TUI testing, a build breaks after a merged epic, or a production bug is traced to a known release.
98
+
99
+ **Do NOT use a defect when:** a planned task needs rework (update the task instead), a scope changes (that is an epic), or something is a future enhancement.
100
+
101
+ ---
102
+
70
103
  ## 📦 Updating
71
104
 
72
105
  After updating the Savepoint package:
@@ -92,4 +125,3 @@ I’m sharing it to prove a point: The real power of AI isn't just the size of t
92
125
 
93
126
  **License:** MIT
94
127
  **Status:** Recursive Construction (v1 MVP in progress)
95
- us:** Recursive Construction (v1 MVP in progress)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "savepoint",
3
- "version": "1.0.12",
3
+ "version": "1.2.2",
4
4
  "description": "It’s a simple, file-based state machine and cinematic Terminal UI (TUI) designed to force you—and your agent (Claude, Cursor, Aider, Gemini)—to slow down, write down what you're actually building, and check your work before moving on.",
5
5
  "keywords": [
6
6
  "board",
package/savepoint.exe CHANGED
Binary file