Files

Tom Boucher 91f5bd7cb1 feat(#607 ): rebuild get-shit-done-cc → gsd-core migration (per-package cache + installer auto-cleanup + --dry-run) (#611 )

* feat(#607): rebuild get-shit-done-cc → gsd-core migration

Leftover get-shit-done-cc installs poisoned the shared update cache,
causing a permanent false "update available". Rebuild the migration so a
stale old install is both harmless and actively removed.

- Per-package update cache filename (gsd-update-check-<slug>.json) in the
  shared ~/.cache/gsd dir, single-sourced via package-identity; writers
  stamp package_name and readers reject foreign/absent lineage. Multi-
  runtime visibility preserved (same shared dir + filename across runtimes).
- New get-shit-done/bin/lib/legacy-cleanup.cjs seam: detects code-file
  references to the old package + the legacy fixed-name cache across home
  runtime dirs; installer auto-cleans on every install; --dry-run previews
  and mutates nothing. User hooks and dev-preferences are never touched.
- update.md cache-clear globs gsd-update-check*.json across ALL supported
  runtimes (adds cursor/windsurf/augment/trae/qwen/hermes/codebuddy/cline).
- Fix worker MODULE_NOT_FOUND post-install (ship managed-hooks-registry.cjs
  + degrade gracefully) so the per-package cache is always written.
- Diataxis how-to: docs/cleanup-get-shit-done-cc.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* chore(#607): add changeset for PR #611

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* fix(#607): set USERPROFILE alongside HOME in dry-run install test for Windows

os.homedir() reads USERPROFILE on win32, so HOME-only isolation let the
spawned installer scan the real runner home on windows-latest. Set both.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-02 12:19:57 -04:00

3.3 KiB

Raw Blame History

Cleaning Up get-shit-done-cc

Use this procedure when you see a persistent ⬆ /gsd:update indicator in your statusline even though @opengsd/gsd-core is already up to date. It removes leftover files from the old get-shit-done-cc package that was renamed to @opengsd/gsd-core in issue #607.

Why this happens

When the package was renamed, its version counter reset — get-shit-done-cc reached 1.42.x while @opengsd/gsd-core started at 1.2.0. If the old package is still installed in any runtime config directory (e.g. ~/.gemini), its update checker writes a higher latest version into the shared update cache (~/.cache/gsd/gsd-update-check.json), and older versions of the new tooling accepted those foreign writes. The statusline then permanently shows an upgrade that does not exist. The current installer detects and removes these leftovers automatically, and the update cache is now per-package with a package_name lineage field that readers validate — so a foreign package can no longer poison it.

Steps

1. Preview the cleanup (dry run)

Run the installer with --dry-run to see exactly what it would change without touching anything:

npx -y --package=@opengsd/gsd-core@latest -- gsd-core --claude --global --dry-run

The command prints the removal plan — each file path and the reason it would be deleted — and lists any stale update-cache files it would clear, then exits without making any modifications.

Swap --claude for the flag matching your runtime if you use a different one (see the runtime flags table).

2. Apply the cleanup

Run the same installer without --dry-run:

npx -y --package=@opengsd/gsd-core@latest -- gsd-core --claude --global

The installer:

Detects leftover get-shit-done-cc artifacts across all runtime config directories (~/.claude, ~/.gemini, ~/.codex, ~/.config/opencode, ~/.kilo, and others).
Removes orphaned hooks, commands, and any file that references the old package name.
Clears the stale shared update cache.
Preserves user-owned artifacts such as dev-preferences.md, custom agents, and any file not managed by GSD.

3. Manual fallback

If the installer cannot resolve get-shit-done-cc in your environment, or you prefer to clean up by hand:

Check each runtime config directory for a get-shit-done/ subtree left by the old package:
```
ls ~/.claude/get-shit-done/
ls ~/.gemini/get-shit-done/
ls ~/.codex/get-shit-done/
ls ~/.config/opencode/get-shit-done/
ls ~/.kilo/get-shit-done/
```
Remove any directories found there that were written by get-shit-done-cc (the new package installs under the same path, so only remove the directory if you have not yet run the new installer for that runtime).
Uninstall the old package if it is still resolvable:
```
npx get-shit-done-cc --uninstall
```

Delete the stale shared cache:

rm -f ~/.cache/gsd/gsd-update-check.json

4. Verify

Open a new terminal session (or restart your AI runtime). The ⬆ /gsd:update indicator should no longer appear in the statusline. You can confirm the installed version with:

npx @opengsd/gsd-core@latest -- gsd-core --version

3.3 KiB Raw Blame History