fss-link 1.9.3 → 1.9.4

package/bundle/worktrees/SKILL.md

@@ -70,9 +70,15 @@ cd /path/to/project/.fss-link/worktrees/fix-auth-bug && pip install -r requireme
 ```
 exit_worktree({ name: "fix-auth-bug", action: "keep" })      # Work in progress
 exit_worktree({ name: "fix-auth-bug", action: "remove" })    # Work committed
-exit_worktree({ name: "fix-auth-bug", action: "remove", discard_changes: true })  # Discard everything
+exit_worktree({ name: "fix-auth-bug", action: "remove", discard_changes: true })  # Discard system metadata
+exit_worktree({ name: "fix-auth-bug", action: "remove", discard_changes: true, confirm_destruction: true })  # Discard everything
 ```
 
+⚠️ **WARNING:** `discard_changes: true` is a destructive action. It will permanently delete all untracked content in the worktree.
+
+- Without `confirm_destruction`: the tool cleans up its own artifacts (.fss-link/) and lists any remaining user files. You must decide whether to delete them manually or confirm destruction.
+- With `confirm_destruction: true`: ALL untracked content is destroyed, including user files. Use only when you are certain no valuable untracked content exists.
+
 ## Quick Reference
 
 | Situation | Action |
@@ -81,14 +87,15 @@ exit_worktree({ name: "fix-auth-bug", action: "remove", discard_changes: true })
 | Already in a worktree | Do NOT call enter_worktree again |
 | Done, work in progress | `exit_worktree({ name, action: "keep" })` |
 | Done, work committed | `exit_worktree({ name, action: "remove" })` |
-| Done, discard everything | `exit_worktree({ name, action: "remove", discard_changes: true })` |
+| Done, discard system metadata only | `exit_worktree({ name, action: "remove", discard_changes: true })` |
+| Done, discard everything | `exit_worktree({ name, action: "remove", discard_changes: true, confirm_destruction: true })` |
 
 ## Common Mistakes
 
 1. **Using relative paths** — Always use full `worktreePath` for every tool call
 2. **Creating nested worktrees** — Check path first; if it contains `.fss-link/worktrees/`, you're already in one
 3. **Running `git worktree add` manually** — Always use the `enter_worktree` tool
-4. **Removing with uncommitted changes** — Commit or stash first, or use `discard_changes: true`
+4. **Removing with uncommitted changes** — Commit or stash first, or use `discard_changes: true` (system metadata only) or `confirm_destruction: true` (everything)
 
 ## Global Flags
 

package/docs/TOOLS.md

@@ -408,10 +408,13 @@ Exits a worktree previously created by `enter_worktree`.
 |-----------|------|-------------|
 | `name` | string | Slug of the worktree to exit (must match the name used in `enter_worktree`). |
 | `action` | string | `"keep"` preserves the worktree on disk; `"remove"` deletes it and its branch. |
-| `discard_changes` | boolean | When `action="remove"`, must be true to delete a worktree with uncommitted changes. |
+| `discard_changes` | boolean | When `action="remove"`, bypasses the dirty-worktree check. Automatically cleans up system metadata (.fss-link/). Lists remaining user files. |
+| `confirm_destruction` | boolean | When `action="remove"` and `discard_changes=true`, destroys ALL untracked content including user files. Requires `discard_changes=true`. |
 
 - `action='keep'` — preserves the worktree directory and branch on disk so it can be revisited later
 - `action='remove'` — deletes the worktree directory and branch. Refuses to run if the worktree contains uncommitted changes unless `discard_changes: true` is set
+- `discard_changes: true` — cleans up system metadata (.fss-link/). If other untracked files remain, lists them and refuses to proceed unless `confirm_destruction: true`
+- `confirm_destruction: true` — destroys ALL untracked content. Requires `discard_changes: true`. Use with caution.
 - Only invoke when the user explicitly asks to leave or clean up a worktree
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fss-link",
-  "version": "1.9.3",
+  "version": "1.9.4",
   "engines": {
     "node": ">=20.0.0"
   },
@@ -13,7 +13,7 @@
     "url": "git+https://github.com/FSSCoding/fss-link.git"
   },
   "config": {
-    "sandboxImageUri": "ghcr.io/fsscoding/fss-link:1.9.3"
+    "sandboxImageUri": "ghcr.io/fsscoding/fss-link:1.9.4"
   },
   "scripts": {
     "start": "node scripts/start.js",
@@ -95,6 +95,7 @@
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-vitest": "^0.5.4",
+    "fast-check": "^4.9.0",
     "globals": "^16.0.0",
     "ink": "^6.8.0",
     "ink-testing-library": "^4.0.0",
@@ -189,7 +190,7 @@
     "turndown": "^7.2.0",
     "turndown-plugin-gfm": "^1.0.2",
     "undici": "^7.10.0",
-    "vite": "^8.0.14",
+    "vite": "^6.3.5",
     "vitest": "^4.1.7",
     "xml2js": "^0.6.0",
     "yargs": "^17.7.2",