savepoint 1.0.11 → 1.2.0

package/README.md

@@ -62,7 +62,56 @@ Built for a cinematic, technical feel without the bloat.
 | `savepoint --version` | Print the installed Savepoint version.                                                            |
 | `savepoint init`   | Scaffold the loop, write your `AGENTS.md` guide, drop the baby gates, and generate the magic prompt. |
 | `savepoint board`  | Launch the Atari-Noir Kanban TUI to track the vibe.                                                  |
-| `savepoint doctor` | Check the integrity of the state machine.                                                            |
+| `savepoint doctor` | Check the integrity of the state machine.                            |
+| `savepoint upgrade-assets [dir] [--dry-run] [--force]` | Refresh package-owned templates and agent skills in an existing Savepoint project without touching project state. |
+
+---
+
+## 🐛 Defect Workflow
+
+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.
+
+```
+.savepoint/releases/v1/defects/
+  D001-auth-crash.md
+  D002-slow-query.md
+```
+
+Each defect file uses YAML frontmatter:
+
+```yaml
+---
+id: v1/D001-auth-crash
+release: v1
+status: planned          # planned | in_progress | done
+severity: high           # critical | high | medium | low
+title: "Auth crash on empty token"
+introduced: v1.0.3       # optional: version where bug appeared
+reference: E12-slug/T003-slug  # optional: related task ID
+---
+```
+
+- Press **`d`** on the board to open the defect overlay and see all defects for the current release.
+- `savepoint doctor` validates defect files and reports malformed frontmatter, invalid status, and broken task references.
+
+**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.
+
+**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.
+
+---
+
+## 📦 Updating
+
+After updating the Savepoint package:
+
+```bash
+npm update -g savepoint
+savepoint upgrade-assets
+```
+
+The `upgrade-assets` command refreshes bundled `agent-skills/**/SKILL.md` files and the Savepoint-managed block in `AGENTS.md` from the latest templates. It never overwrites `.savepoint/PRD.md`, `.savepoint/Design.md`, `.savepoint/releases/**`, or any task/epic/audit files.
+
+Use `--dry-run` to preview changes before applying them.
 
 ---
 
@@ -76,4 +125,3 @@ I’m sharing it to prove a point: The real power of AI isn't just the size of t
 
 **License:** MIT  
 **Status:** Recursive Construction (v1 MVP in progress)
-us:** Recursive Construction (v1 MVP in progress)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "savepoint",
-  "version": "1.0.11",
+  "version": "1.2.0",
   "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.",
   "keywords": [
     "board",
@@ -28,6 +28,7 @@
   "scripts": {
     "build": "go build -o savepoint.exe .",
     "test": "echo \"Run 'make test' for Go tests\"",
+    "postinstall": "node -e \"console.log('Run \\\"savepoint upgrade-assets\\\" in each existing Savepoint project to refresh agent skills and templates.')\"",
     "prepublishOnly": "npm run build"
   }
-}
+}