set-prompt 0.5.4 → 0.6.0

package/CHANGELOG.md

@@ -4,6 +4,30 @@ All notable changes to this project will be documented in this file.
 
 ---
 
+## [0.6.0] - 2026-04-14
+
+### Added
+- `set-prompt repo status` — VCS status: current branch, upstream + ahead/behind, colored list of changed files (separate from `set-prompt status`, which shows linked agents)
+- `set-prompt repo pull` — git fetch + pull (replaces `set-prompt update`)
+- `set-prompt repo commit [-m <msg>]` — stage all + commit locally; auto-generates a subject+body message when `-m` omitted (subject: `update N files`, body: bullet list of repo-relative paths)
+- `set-prompt repo push` — push local commits to remote
+- `set-prompt repo save [-m <msg>]` — one-step macro: commit + push (also auto-generates message)
+- `set-prompt repo path` — prints the installed repo path to stdout (designed for `cd $(sppt repo path)`); errors go to stderr so piping stays clean
+- `set-prompt repo open` — opens the repo in the OS file manager (`explorer` / `open` / `xdg-open`); `--code` opens in VSCode (`code` CLI), `--stree` opens in Sourcetree (auto-detects `SourceTree.exe` at `%LOCALAPPDATA%\SourceTree` on Windows where the `stree` wrapper isn't shipped)
+
+### Changed
+- `scaffold` and `install`: when the resulting working tree is dirty, print a hint guiding the user to run `sppt repo save`. Non-interactive — the user stays in control (earlier design had auto-prompted to run `save`, which risked failing pushes during `install`).
+- `scaffold`: plugin manifests (`.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`) are no longer overwritten when they already exist. Existing files are validated against required fields (`name` for Claude; `name` + `skills` + `mcpServers` + `apps` for Codex — the latter three are pointers Codex uses to load each integration) and preserved as-is — custom values like `version`, `description`, or non-default `name` survive re-runs. Invalid files trigger a warning but stay untouched (status: `+` created / `✓` valid / `⚠` invalid).
+
+### Changed (Breaking)
+- `set-prompt update` removed. Use `set-prompt repo pull` instead.
+- Rationale: VCS-grouped commands read more clearly and leave room for future operations; `pull` is already the cross-VCS norm (Hg/JJ/Fossil all use it). `commit` and `push` stay pure git semantics; `save` is the convenience macro for the common case. `path` / `open` close the "where is my repo?" UX gap since the default install location (`~/.set-prompt/repo/`) felt distant.
+
+### Migration
+- Replace any `set-prompt update` / `sppt update` calls with `set-prompt repo pull` / `sppt repo pull`
+
+---
+
 ## [0.5.4] - 2026-04-13
 
 ### Changed

package/README.md

@@ -42,7 +42,8 @@ npx set-prompt <command>
 ```bash
 sppt install <url>        # connect an existing repo
 sppt link                 # link to AI agents
-sppt update               # pull latest changes
+sppt repo pull            # pull latest changes
+sppt repo save -m "…"     # commit + push local edits
 ```
 
 ## Workflow
@@ -78,6 +79,8 @@ my-prompts/
 └── SET_PROMPT_GUIDE.md          (optional reference doc)
 ```
 
+> **Re-run safety**: `scaffold` never overwrites existing plugin manifests. On re-run, it validates them against required fields and preserves your customizations (custom `name`, `version`, `description`, etc.). Invalid files trigger a warning but stay untouched.
+
 ---
 
 ### Step 2 — Link to AI agents
@@ -113,8 +116,22 @@ The interactive mode shows all agents with their current state. **Check to link,
 
 ### Step 3 — Keep in sync
 
+Primary flow — pull incoming, save outgoing:
+
+```bash
+set-prompt repo pull                  # fetch + pull latest changes from remote
+set-prompt repo save -m "message"     # stage + commit + push in one step
+set-prompt repo save                  # same, but auto-generates message from changed files
+```
+
+Additional commands:
+
 ```bash
-set-prompt update    # git pull latest changes from remote
+set-prompt repo status                # show branch, ahead/behind, changed files
+set-prompt repo commit -m "message"   # commit locally without pushing
+set-prompt repo push                  # push existing local commits
+set-prompt repo path                  # print repo location (e.g. cd "$(sppt repo path)")
+set-prompt repo open                  # open repo in OS file manager (--code VSCode, --stree Sourcetree)
 ```
 
 Symlink-based agents (Claude Code, Codex, RooCode, OpenClaw, Antigravity) reflect changes immediately after pull. Cursor's `mcp.json` is a hardlink to repo's `.mcp.json`, so edits to either side are reflected automatically.
@@ -135,9 +152,15 @@ set-prompt uninstall
 |---------|-------------|
 | `install <url>` | Clone remote git repo and register as prompt source |
 | `link [agent]` | Link/unlink agents interactively, or target one directly |
-| `update` | Fetch and pull latest changes from remote repo |
+| `repo status` | Show VCS status: branch, ahead/behind, changed files |
+| `repo pull` | Fetch and pull latest changes from remote repo |
+| `repo commit [-m <msg>]` | Stage all changes and commit locally (auto-generates message from changed files if omitted) |
+| `repo push` | Push local commits to remote |
+| `repo save [-m <msg>]` | Stage + commit + push in one step (macro) |
+| `repo path` | Print the repo path to stdout (e.g. `cd $(sppt repo path)`) |
+| `repo open` | Open the repo in the OS file manager (`--code` for VSCode, `--stree` for Sourcetree) |
 | `status` | Show current repo and linked agents |
-| `scaffold [path]` | Create directories and plugin manifests in a prompt repo |
+| `scaffold [path]` | Create or validate directories and plugin manifests (existing files are preserved) |
 | `uninstall` | Remove all set-prompt data and restore backups |
 
 ## What Gets Created