@thanaen/worktree-cleanup 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thanaen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# worktree-cleanup
+
+Safely remove stale Git worktrees created by coding agents and other tooling.
+The command is conservative: a worktree must be registered, clean, unlocked,
+and already merged into a trusted base branch before it can be offered for
+deletion.
+
+> The npm package will be published as `@thanaen/worktree-cleanup`. npm package
+> scopes are lowercase even though the GitHub account is displayed as Thanaen.
+
+## Install
+
+```bash
+pnpm add -g @thanaen/worktree-cleanup
+```
+
+## Usage
+
+```bash
+# Inspect smart defaults below the current directory
+worktree-cleanup
+
+# Equivalent shorter executable
+worktree-clean
+
+# Inspect exactly one root and ignore smart defaults
+worktree-cleanup --dir ../agent-worktrees
+
+# Approve the displayed plan without prompting
+worktree-cleanup --yes
+```
+
+Smart defaults are `worktrees`, `.claude/worktrees`, and `.codex/worktrees`.
+Only their immediate child directories are inspected.
+
+The command never force-removes a worktree and never deletes its branch. It
+asks once before deletion unless `-y` or `--yes` is passed. If stdin is not an
+interactive terminal, `--yes` is required.
+
+## What counts as stale?
+
+A worktree is removable only when all of these are true:
+
+- Git lists it as a registered worktree.
+- It is not the main or currently executing worktree.
+- It is unlocked and clean, including untracked files.
+- Its HEAD is an ancestor of the detected base ref.
+
+Base detection prefers `origin/HEAD`, then local `main`, local `master`, and
+finally the main worktree's current branch. Uncertain state is always skipped.
+Every candidate is revalidated immediately before removal.
+
+## Development
+
+This repository follows GitHub Spec Kit. The feature contract is in
+`specs/001-core-cleanup/`. Effect's official source is vendored under `repos/`
+as a Git subtree and used as read-only reference material.
+
+```bash
+pnpm install
+pnpm check
+```
+
+To update the Effect reference subtree:
+
+```bash
+git subtree pull --prefix=repos https://github.com/Effect-TS/effect.git main --squash
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@thanaen/worktree-cleanup",
+  "version": "0.1.0",
+  "description": "Safely discover and remove stale Git worktrees.",
+  "keywords": [
+    "cleanup",
+    "effect",
+    "git",
+    "worktree"
+  ],
+  "homepage": "https://github.com/Thanaen/worktree-cleanup#readme",
+  "bugs": {
+    "url": "https://github.com/Thanaen/worktree-cleanup/issues"
+  },
+  "license": "MIT",
+  "author": "Thanaen",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Thanaen/worktree-cleanup.git"
+  },
+  "bin": {
+    "worktree-clean": "dist/main.mjs",
+    "worktree-cleanup": "dist/main.mjs"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@effect/platform-node": "4.0.0-rc.108",
+    "effect": "4.0.0-rc.108"
+  },
+  "devDependencies": {
+    "@effect/tsgo": "0.36.4",
+    "@effect/vitest": "4.0.0-rc.108",
+    "@types/node": "26.2.0",
+    "oxfmt": "0.63.0",
+    "tsdown": "0.22.14",
+    "typescript": "7.0.2",
+    "vitest": "4.1.10"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check": "pnpm format:check && pnpm diagnostics && pnpm typecheck && pnpm test && pnpm build",
+    "diagnostics": "effect-tsgo diagnostics --project tsconfig.json",
+    "format": "oxfmt --ignore-path=.oxfmtignore .",
+    "format:check": "oxfmt --check --ignore-path=.oxfmtignore .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}