chore(npm): rebrand packages to @opengsd scope (#127)

* chore(npm): rebrand packages to @opengsd scope Rename: - get-shit-done-redux → @opengsd/get-shit-done-redux - @gsd-redux/sdk → @opengsd/gsd-sdk Add publishConfig.access=public for first-time scoped publish. CLI binary names (get-shit-done-redux, gsd-sdk, gsd-tools) unchanged. Sweeps install commands, npx invocations, CI publish/version-check workflows, tests, docs, READMEs (all translations), and the PACKAGE_NAME constant in check-latest-version. Bumps qs 6.15.1 → 6.15.2 to clear a moderate advisory surfaced by the audit-clean test (GHSA-q8mj-m7cp-5q26). Closes #126 * chore: pin 2.0.0 release + remove canary workflow - Bump both packages 1.50.0-canary.0 → 2.0.0 for first @opengsd publish - Remove .github/workflows/canary.yml and canary dist-tag handling in release.yml / release-sdk.yml - Drop canary section from VERSIONING.md Refs #126 * chore: address review findings + harden tarball-smoke timeout - .changeset/opengsd-org-rename.md: match project's custom parse.cjs frontmatter (type: Changed / pr: 127); the scoped @changesets/cli keys were silently rejected. - CONTEXT.md: drop two canary-stream policy lines and a dangling DEFECT.CANARY-VERSION-LEAK.cross-ref now that canary.yml is gone. - tests/release-tarball-smoke.install.test.cjs: pass timeout: 600_000 for npm pack + global install; the 3-minute runNpm default was timing out on slower Docker hosts (cartographer). Refs #126 * fix(sdk): add missing type/runtime devDependencies for build prepublishOnly invokes tsc which couldn't resolve @types/node, @types/ws, or synckit. They had been hoisted from root but were not declared in sdk/'s own package.json — first publish from a clean SDK tree failed. Refs #126 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * fix(ci): use npm pack stdout instead of glob to find tarball `npm pack --silent` for a scoped package (@opengsd/get-shit-done-redux) produces `opengsd-get-shit-done-redux-*.tgz`, not `get-shit-done-redux-*.tgz`. Capture the filename from stdout instead of a hardcoded glob so the step works regardless of package name format. Fixes smoke (ubuntu-latest, 22, false) CI failure. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * ci: treat workflow-file changes as test-skip eligible `.github/workflows/install-smoke.yml` (and other workflow files) were in neither `test.yml` paths nor `test-skip.yml` paths-ignore, so neither workflow ran on a workflow-only commit — leaving the required test-skip check perpetually missing. Refs #126 * chore: reset version to 1.0.0 for first @opengsd publish Nothing has been published yet under the @opengsd scope, so the inaugural release uses 1.0.0 rather than 2.0.0. The "major bump" in the changeset reflects the breaking install-command change for users migrating from the prior unscoped `get-shit-done-redux`, not a numeric continuation from a 1.x line under the new identity. Refs #126 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-22 16:22:41 -04:00
parent 76dd22deed
commit 334a64168e
95 changed files with 551 additions and 694 deletions
--- a/docs/CANARY.md
+++ b/docs/CANARY.md
@@ -20,13 +20,13 @@ A canary build NEVER becomes a `next` build directly, and a `next` build NEVER b

 ```bash
 # One-off invocation (npx)
-npx get-shit-done-redux@canary
+npx @opengsd/get-shit-done-redux@canary

 # Pin to the canary dist-tag globally
-npm install -g get-shit-done-redux@canary
+npm install -g @opengsd/get-shit-done-redux@canary

 # Pin to an exact canary version
-npm install -g get-shit-done-redux@1.50.0-canary.1
+npm install -g @opengsd/get-shit-done-redux@1.50.0-canary.1
 ```

 The CC installer's defensive purge rewrites stale config blocks left by older GSD versions, so reinstalling on top of an existing project is safe.
@@ -47,10 +47,10 @@ The CC installer's defensive purge rewrites stale config blocks left by older GS

 ```bash
 # Back to the current stable
-npm install -g get-shit-done-redux@latest
+npm install -g @opengsd/get-shit-done-redux@latest

 # Or to the next/RC train
-npm install -g get-shit-done-redux@next
+npm install -g @opengsd/get-shit-done-redux@next
 ```

 If you have a local project that interacted with canary-only features (for instance, an MVP-mode phase planned by 1.50.0-canary), the planner artifacts in `.planning/` remain valid — older GSD versions will just ignore the `**Mode:** mvp` field on phases.
--- a/docs/CLI-TOOLS.md
+++ b/docs/CLI-TOOLS.md
@@ -1,6 +1,6 @@
 # GSD CLI Tools Reference

-> Surface-area reference for `get-shit-done/bin/gsd-tools.cjs` (legacy Node CLI). Workflows and agents should prefer `gsd-sdk query` or `@gsd-redux/sdk` where a handler exists — see [SDK and programmatic access](#sdk-and-programmatic-access). For slash commands and user flows, see [Command Reference](COMMANDS.md).
+> Surface-area reference for `get-shit-done/bin/gsd-tools.cjs` (legacy Node CLI). Workflows and agents should prefer `gsd-sdk query` or `@opengsd/gsd-sdk` where a handler exists — see [SDK and programmatic access](#sdk-and-programmatic-access). For slash commands and user flows, see [Command Reference](COMMANDS.md).

 ---

@@ -43,7 +43,7 @@ Use this when authoring workflows, not when you only need the command list below
 - Resolves argv with the same **longest-prefix** rules as the typed registry (`resolveQueryArgv` in `sdk/src/query/registry.ts`). Unregistered commands **fail fast** — use `node …/gsd-tools.cjs` only for handlers not in the registry.
 - Full matrix (CJS command → registry key, CLI-only tools, aliases, golden tiers): [sdk/src/query/QUERY-HANDLERS.md](../sdk/src/query/QUERY-HANDLERS.md).

-**2. TypeScript — `@gsd-redux/sdk` (`GSDTools`, `createRegistry`)**
+**2. TypeScript — `@opengsd/gsd-sdk` (`GSDTools`, `createRegistry`)**

 - `GSDTools` now routes through the **SDK Runtime Bridge Module** (`sdk/src/query-runtime-bridge.ts`). Native registry dispatch is preferred; subprocess fallback is explicit policy (`allowFallbackToSubprocess`) and can be disabled for strict SDK-only execution.
 - `strictSdk` mode fails fast when a command has no native adapter, making SDK publish/readiness checks deterministic.
--- a/docs/FEATURES.md
+++ b/docs/FEATURES.md
@@ -1054,7 +1054,7 @@ When the user declines (or keeps a non-GSD) statusline, the installer offers a S
 GSD update available: 1.39.0 → 1.40.0. Run /gsd-update.
 ```

-The banner is silent when up-to-date and rate-limits "check failed" diagnostics to once per 24 hours. Removed cleanly by `npx get-shit-done-redux --uninstall` or by deleting the SessionStart entry that references `gsd-update-banner.js`.
+The banner is silent when up-to-date and rate-limits "check failed" diagnostics to once per 24 hours. Removed cleanly by `npx @opengsd/get-shit-done-redux --uninstall` or by deleting the SessionStart entry that references `gsd-update-banner.js`.

 ### 38. Developer Profiling

@@ -1436,7 +1436,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject

 ### 55. Multi-Runtime Installer Selection

-**Part of:** `npx get-shit-done-redux`
+**Part of:** `npx @opengsd/get-shit-done-redux`

 **Purpose:** Select multiple runtimes in a single interactive install session.

@@ -1455,7 +1455,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject

 ### 56. Windsurf Runtime Support

-**Part of:** `npx get-shit-done-redux`
+**Part of:** `npx @opengsd/get-shit-done-redux`

 **Purpose:** Add Windsurf as a supported AI CLI runtime for GSD installation and execution.

@@ -1695,7 +1695,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject

 ### 68. Claude Code Skills Migration

-**Part of:** `npx get-shit-done-redux`
+**Part of:** `npx @opengsd/get-shit-done-redux`

 **Purpose:** Migrate GSD commands to Claude Code 2.1.88+ skills format with backward compatibility.

@@ -1959,7 +1959,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject

 ### 85. New Runtime Support (Trae, Cline, Augment Code)

-**Part of:** `npx get-shit-done-redux`
+**Part of:** `npx @opengsd/get-shit-done-redux`

 **Purpose:** Extend GSD installation to Trae IDE, Cline, and Augment Code runtimes.

@@ -2301,7 +2301,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject

 ### 104. New Runtime Support (Cline, CodeBuddy, Qwen Code)

-**Part of:** `npx get-shit-done-redux`
+**Part of:** `npx @opengsd/get-shit-done-redux`

 **Purpose:** Extend GSD installation to Cline, CodeBuddy, and Qwen Code runtimes.

@@ -2778,7 +2778,7 @@ Users who run a memory / knowledge-base MCP server (for example, ExoCortex-style
 - The hook reads the existing `~/.cache/gsd/gsd-update-check.json` cache — the same cache used by the statusline — and prints a banner only when an update is available.
 - Silent when up-to-date.
 - Failure diagnostics rate-limited to once per 24 h.
- Cleanly removed by `npx get-shit-done-redux --uninstall`.
+- Cleanly removed by `npx @opengsd/get-shit-done-redux --uninstall`.

 **Requirements:**
 - REQ-BANNER-01: Banner does not install without explicit opt-in.
--- a/docs/RELEASE-v1.39.0-rc.4.md
+++ b/docs/RELEASE-v1.39.0-rc.4.md
@@ -3,7 +3,7 @@
 Pre-release candidate. Published to npm under the `next` tag.

 ```
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next
 ```

 ---
@@ -62,16 +62,16 @@ The installer now:

 ```bash
 # npm
-npm install -g get-shit-done-redux@next
+npm install -g @opengsd/get-shit-done-redux@next

 # npx (one-shot)
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next
 ```

 To pin to this exact RC:

 ```bash
-npm install -g get-shit-done-redux@1.39.0-rc.4
+npm install -g @opengsd/get-shit-done-redux@1.39.0-rc.4
 ```

 ---
--- a/docs/RELEASE-v1.39.0-rc.5.md
+++ b/docs/RELEASE-v1.39.0-rc.5.md
@@ -3,7 +3,7 @@
 Pre-release candidate. Published to npm under the `next` tag.

 ```bash
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next
 ```

 ---
@@ -77,16 +77,16 @@ The installer now:

 ```bash
 # npm
-npm install -g get-shit-done-redux@next
+npm install -g @opengsd/get-shit-done-redux@next

 # npx (one-shot)
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next
 ```

 To pin to this exact RC:

 ```bash
-npm install -g get-shit-done-redux@1.39.0-rc.5
+npm install -g @opengsd/get-shit-done-redux@1.39.0-rc.5
 ```

 ---
--- a/docs/RELEASE-v1.39.0-rc.6.md
+++ b/docs/RELEASE-v1.39.0-rc.6.md
@@ -3,7 +3,7 @@
 Pre-release candidate. Published to npm under the `next` tag.

 ```bash
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next
 ```

 ---
@@ -93,16 +93,16 @@ The installer now:

 ```bash
 # npm
-npm install -g get-shit-done-redux@next
+npm install -g @opengsd/get-shit-done-redux@next

 # npx (one-shot)
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next
 ```

 To pin to this exact RC:

 ```bash
-npm install -g get-shit-done-redux@1.39.0-rc.6
+npm install -g @opengsd/get-shit-done-redux@1.39.0-rc.6
 ```

 ---
--- a/docs/RELEASE-v1.39.0-rc.7.md
+++ b/docs/RELEASE-v1.39.0-rc.7.md
@@ -3,7 +3,7 @@
 Pre-release candidate. Published to npm under the `next` tag.

 ```bash
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next
 ```

 ---
@@ -19,7 +19,7 @@ reaches the registry.
 ### Added

 - **Manual canary release workflow** — `.github/workflows/canary.yml` publishes
-  `{base}-canary.{N}` builds of `get-shit-done-redux` under the `canary` dist-tag on
+  `{base}-canary.{N}` builds of `@opengsd/get-shit-done-redux` under the `canary` dist-tag on
  demand via `workflow_dispatch` (manual trigger only). Optional `dry_run` boolean.
  ([#2828](https://github.com/GSD-redux/get-shit-done-redux/issues/2828))

@@ -39,7 +39,7 @@ reaches the registry.
  `argument-hint:`, `Triggers:` keyword-stuffing lists, and numbered enumeration. New
  CI lint gate `npm run lint:descriptions` fails if any description exceeds 100
  chars. ([#2789](https://github.com/GSD-redux/get-shit-done-redux/issues/2789))
- **`gsd-sdk` binary collision with `@gsd-redux/sdk` resolved** — workstream-aware
+- **`gsd-sdk` binary collision with `@opengsd/gsd-sdk` resolved** — workstream-aware
  query registry now respects the `GSD_WORKSTREAM` env var; `gsd-tools` bin alias
  added. ([#2791](https://github.com/GSD-redux/get-shit-done-redux/issues/2791))
 - **`OpenCode` agents embed `model_profile_overrides.opencode.<tier>`** — per-tier
@@ -165,16 +165,16 @@ with a strict TOML parser.

 ```bash
 # npm
-npm install -g get-shit-done-redux@next
+npm install -g @opengsd/get-shit-done-redux@next

 # npx (one-shot)
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next
 ```

 To pin to this exact RC:

 ```bash
-npm install -g get-shit-done-redux@1.39.0-rc.7
+npm install -g @opengsd/get-shit-done-redux@1.39.0-rc.7
 ```

 ---
--- a/docs/RELEASE-v1.40.0-rc.1.md
+++ b/docs/RELEASE-v1.40.0-rc.1.md
@@ -3,7 +3,7 @@
 Pre-release candidate. Published to npm under the `next` tag.

 ```bash
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next
 ```

 ---
@@ -112,16 +112,16 @@ and nine additional correctness fixes across OpenCode, Codex, and Gemini runtime

 ```bash
 # npm
-npm install -g get-shit-done-redux@next
+npm install -g @opengsd/get-shit-done-redux@next

 # npx (one-shot)
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next
 ```

 To pin to this exact RC:

 ```bash
-npm install -g get-shit-done-redux@1.40.0-rc.1
+npm install -g @opengsd/get-shit-done-redux@1.40.0-rc.1
 ```

 ---
--- a/docs/RELEASE-v1.41.0.md
+++ b/docs/RELEASE-v1.41.0.md
@@ -3,7 +3,7 @@
 Stable release. Published to npm under the `latest` tag.

 ```bash
-npx get-shit-done-redux@latest
+npx @opengsd/get-shit-done-redux@latest
 ```

 ---
@@ -186,13 +186,13 @@ colon-form slash-command conversion.

 ```bash
 # npm (global)
-npm install -g get-shit-done-redux@latest
+npm install -g @opengsd/get-shit-done-redux@latest

 # npx (one-shot)
-npx get-shit-done-redux@latest
+npx @opengsd/get-shit-done-redux@latest

 # Pin to this exact version
-npm install -g get-shit-done-redux@1.41.0
+npm install -g @opengsd/get-shit-done-redux@1.41.0
 ```

 The installer is idempotent — re-running on an existing install updates in-place,
--- a/docs/RELEASE-v1.42.0-rc.1.md
+++ b/docs/RELEASE-v1.42.0-rc.1.md
@@ -3,9 +3,9 @@
 First release candidate for the **1.42.0** train. Published to npm under the `next` dist-tag.

 ```bash
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next
 # or pin exact:
-npm install -g get-shit-done-redux@1.42.0-rc1
+npm install -g @opengsd/get-shit-done-redux@1.42.0-rc1
 ```

 > **Release-candidate stream caveat.** RCs come from `main` and are the staging stream for the next stable `latest`. They are stable enough for everyday use but may carry bake items resolved before the matching `vX.Y.0` is published. See [CANARY.md](CANARY.md) for the stream policy.
@@ -82,13 +82,13 @@ Closes [#3270](https://github.com/GSD-redux/get-shit-done-redux/issues/3270).

 ```bash
 # npm (global, RC channel)
-npm install -g get-shit-done-redux@next
+npm install -g @opengsd/get-shit-done-redux@next

 # npx (one-shot)
-npx get-shit-done-redux@next
+npx @opengsd/get-shit-done-redux@next

 # Pin to this exact RC
-npm install -g get-shit-done-redux@1.42.0-rc1
+npm install -g @opengsd/get-shit-done-redux@1.42.0-rc1
 ```

 The installer is idempotent — re-running on an existing install updates in-place, preserving your `.planning/` directory and local patches.
@@ -96,5 +96,5 @@ The installer is idempotent — re-running on an existing install updates in-pla
 To roll back to the latest stable, install with `@latest`:

 ```bash
-npx get-shit-done-redux@latest
+npx @opengsd/get-shit-done-redux@latest
 ```
--- a/docs/RELEASE-v1.42.1.md
+++ b/docs/RELEASE-v1.42.1.md
@@ -3,7 +3,7 @@
 Stable release. Published to npm under the `latest` tag.

 ```bash
-npx get-shit-done-redux@latest
+npx @opengsd/get-shit-done-redux@latest
 ```

 ---
@@ -165,13 +165,13 @@ secure-phase audits, cross-runtime installs, and statusline parsing.

 ```bash
 # npm (global)
-npm install -g get-shit-done-redux@latest
+npm install -g @opengsd/get-shit-done-redux@latest

 # npx (one-shot)
-npx get-shit-done-redux@latest
+npx @opengsd/get-shit-done-redux@latest

 # Pin to this exact version
-npm install -g get-shit-done-redux@1.42.1
+npm install -g @opengsd/get-shit-done-redux@1.42.1
 ```

 The installer is idempotent — re-running on an existing install updates in-place,
--- a/docs/RELEASE-v1.42.3.md
+++ b/docs/RELEASE-v1.42.3.md
@@ -3,7 +3,7 @@
 Hotfix release. Published to npm under the `latest` tag.

 ```bash
-npx get-shit-done-redux@latest
+npx @opengsd/get-shit-done-redux@latest
 ```

 ---
@@ -11,7 +11,7 @@ npx get-shit-done-redux@latest
 ## What's in this release

 1.42.3 is a stability hotfix on top of 1.42.2. The headline is **Codex
-CLI 0.130.0 install routability** — after `npx get-shit-done-redux@latest
+CLI 0.130.0 install routability** — after `npx @opengsd/get-shit-done-redux@latest
 --codex`, `$gsd-*` skills now resolve correctly under Codex 0.130.0 and
 later, where the previous build left users with zero routable
 entrypoints. The release also ships **runtime-aware slash formatting**
@@ -136,13 +136,13 @@ SDK install readiness, and decimal-phase dependencies.

 ```bash
 # npm (global)
-npm install -g get-shit-done-redux@latest
+npm install -g @opengsd/get-shit-done-redux@latest

 # npx (one-shot)
-npx get-shit-done-redux@latest
+npx @opengsd/get-shit-done-redux@latest

 # Pin to this exact version
-npm install -g get-shit-done-redux@1.42.3
+npm install -g @opengsd/get-shit-done-redux@1.42.3
 ```

 The installer is idempotent — re-running on an existing install
--- a/docs/RELEASE-v1.50.0-canary.1.md
+++ b/docs/RELEASE-v1.50.0-canary.1.md
@@ -3,9 +3,9 @@
 First canary cut for the **1.50.0** train. Published to npm under the `canary` dist-tag.

 ```bash
-npx get-shit-done-redux@canary
+npx @opengsd/get-shit-done-redux@canary
 # or pin exact:
-npm install -g get-shit-done-redux@1.50.0-canary.1
+npm install -g @opengsd/get-shit-done-redux@1.50.0-canary.1
 ```

 > **Canary stream caveat.** Canary builds come from the long-lived `dev` integration branch and may carry rough edges that the `next` (RC) and `latest` (stable) channels never see. Use canary when you want to exercise in-flight features early and report findings; do NOT pin production projects to it. See [CANARY.md](CANARY.md) for the stream policy and rollback path.
@@ -72,10 +72,10 @@ The MVP slice closes out with read-side surfaces:

 ```bash
 # Try the canary
-npx get-shit-done-redux@canary
+npx @opengsd/get-shit-done-redux@canary

 # Or pin exact
-npm install -g get-shit-done-redux@1.50.0-canary.1
+npm install -g @opengsd/get-shit-done-redux@1.50.0-canary.1
 ```

 The installer's defensive purge will rewrite stale config blocks left by older GSD versions on first run. No manual cleanup needed.
--- a/docs/USER-GUIDE.md
+++ b/docs/USER-GUIDE.md
@@ -1263,10 +1263,10 @@ Cline uses a rules-based integration — GSD installs as `.clinerules` rather th

 ```bash
 # Global install (applies to all projects)
-npx get-shit-done-redux --cline --global
+npx @opengsd/get-shit-done-redux --cline --global

 # Local install (this project only)
-npx get-shit-done-redux --cline --local
+npx @opengsd/get-shit-done-redux --cline --local
 ```

 Global installs write to `~/.cline/`. Local installs write to `./.cline/`. No custom slash commands are registered — GSD rules are loaded automatically by Cline from the rules file.
@@ -1276,7 +1276,7 @@ Global installs write to `~/.cline/`. Local installs write to `./.cline/`. No cu
 CodeBuddy uses a skills-based integration.

 ```bash
-npx get-shit-done-redux --codebuddy --global
+npx @opengsd/get-shit-done-redux --codebuddy --global
 ```

 Skills are installed to `~/.codebuddy/skills/gsd-*/SKILL.md`.
@@ -1286,7 +1286,7 @@ Skills are installed to `~/.codebuddy/skills/gsd-*/SKILL.md`.
 Qwen Code uses the same open skills standard as Claude Code 2.1.88+.

 ```bash
-npx get-shit-done-redux --qwen --global
+npx @opengsd/get-shit-done-redux --qwen --global
 ```

 Skills are installed to `~/.qwen/skills/gsd-*/SKILL.md`. Use the `QWEN_CONFIG_DIR` environment variable to override the default install path.
@@ -1300,7 +1300,7 @@ GSD does not enumerate prerelease editions as separate named runtimes. They are
 **Pattern.** Set the runtime's `*_CONFIG_DIR` env var to the prerelease directory before running the installer:

 ```bash
-WINDSURF_CONFIG_DIR=~/.codeium/windsurf-next npx get-shit-done-redux@latest --windsurf --global
+WINDSURF_CONFIG_DIR=~/.codeium/windsurf-next npx @opengsd/get-shit-done-redux@latest --windsurf --global
 ```

 Select the corresponding stable runtime in the installer prompt. Skills land in the prerelease directory; commands appear in the prerelease editor.
@@ -1340,7 +1340,7 @@ Since v1.17, the installer backs up locally modified files to `gsd-local-patches

 ### Cannot Update via npm

-If `npx get-shit-done-redux` fails due to npm outages or network restrictions, see [docs/manual-update.md](manual-update.md) for a step-by-step manual update procedure that works without npm access.
+If `npx @opengsd/get-shit-done-redux` fails due to npm outages or network restrictions, see [docs/manual-update.md](manual-update.md) for a step-by-step manual update procedure that works without npm access.

 ### Surface GSD Update Notifications Without GSD's Statusline

@@ -1362,7 +1362,7 @@ GSD update available: 1.39.0 → 1.40.0. Run /gsd-update.

 The banner is silent when no update is available. If the cache file is corrupt, GSD emits one diagnostic line (`GSD update check failed.`) and stays silent for 24 hours so a broken cache does not nag every session.

-**Opt-out / removal:** delete the SessionStart hook entry that references `gsd-update-banner.js` from your runtime's `settings.json` (Claude Code: `~/.claude/settings.json`; Gemini: `~/.gemini/settings.json`). `npx get-shit-done-redux --uninstall` removes both the script and the registration in one pass.
+**Opt-out / removal:** delete the SessionStart hook entry that references `gsd-update-banner.js` from your runtime's `settings.json` (Claude Code: `~/.claude/settings.json`; Gemini: `~/.gemini/settings.json`). `npx @opengsd/get-shit-done-redux --uninstall` removes both the script and the registration in one pass.

 The banner is not offered when GSD's statusline is installed — that channel already surfaces update info, so re-prompting would be noise.

--- a/docs/adr/0003-model-catalog-module.md
+++ b/docs/adr/0003-model-catalog-module.md
@@ -30,8 +30,8 @@ The catalog owns:
 - agent → dynamic-routing default tier mapping

 The canonical file lives in a location both packages ship:
- repo root package (`get-shit-done-redux`) includes it
- standalone SDK package (`@gsd-redux/sdk`) includes it
+- repo root package (`@opengsd/get-shit-done-redux`) includes it
+- standalone SDK package (`@opengsd/gsd-sdk`) includes it

 Both CJS and SDK load this exact file. Neither package keeps its own independent list.

--- a/docs/adr/0007-sdk-package-seam-module.md
+++ b/docs/adr/0007-sdk-package-seam-module.md
@@ -3,6 +3,6 @@
 - **Status:** Accepted
 - **Date:** 2026-05-07

-We decided to define one explicit SDK Package Seam Module for the `@gsd-redux/sdk` → `get-shit-done-redux` transition. During this transition, install-layout probing, legacy `gsd-tools.cjs` discovery, legacy `core.cjs` discovery, and compatibility-only missing-asset diagnostics must live behind one seam instead of leaking across SDK Modules. This keeps callers thin, raises leverage for standalone-SDK testing, and improves locality by making package-readiness bugs land in one place. First tracer-bullet slice: add one compatibility Adapter Module at this seam and migrate current legacy asset callers onto it before broader native replacement work.
+We decided to define one explicit SDK Package Seam Module for the `@opengsd/gsd-sdk` → `@opengsd/get-shit-done-redux` transition. During this transition, install-layout probing, legacy `gsd-tools.cjs` discovery, legacy `core.cjs` discovery, and compatibility-only missing-asset diagnostics must live behind one seam instead of leaking across SDK Modules. This keeps callers thin, raises leverage for standalone-SDK testing, and improves locality by making package-readiness bugs land in one place. First tracer-bullet slice: add one compatibility Adapter Module at this seam and migrate current legacy asset callers onto it before broader native replacement work.

 Runtime-global skills directory resolution is explicitly out of scope for this seam. That policy varies by runtime (`claude`, `codex`, `cline`, etc.) rather than by legacy package/install layout, so it now lives in a separate Runtime-Global Skills Policy Module consumed by `agent-skills` and `skill-manifest`.
--- a/docs/context-monitor.md
+++ b/docs/context-monitor.md
@@ -60,7 +60,7 @@ GSD's `/gsd-pause-work` command saves execution state. The WARNING message sugge

 ## Setup

-Both hooks are automatically registered during `npx get-shit-done-redux` installation:
+Both hooks are automatically registered during `npx @opengsd/get-shit-done-redux` installation:

 - **Statusline** (writes bridge file): Registered as `statusLine` in settings.json
 - **Context Monitor** (reads bridge file): Registered as `PostToolUse` hook in settings.json (`AfterTool` for Gemini)
--- a/docs/gsd-sdk-query-migration-blurb.md
+++ b/docs/gsd-sdk-query-migration-blurb.md
@@ -4,7 +4,7 @@ Copy-paste friendly for Discord and GitHub comments.

 ---

-**@gsd-redux/sdk** replaces the untyped, monolithic `gsd-tools.cjs` subprocess with a typed, tested, registry-based query system and **`gsd-sdk query`**, giving GSD structured results, classified errors (`GSDError` with `ErrorClassification`), and golden-verified parity with the old CLI. That gives the framework one stable contract instead of a fragile, very large CLI that every workflow had to spawn and parse by hand.
+**@opengsd/gsd-sdk** replaces the untyped, monolithic `gsd-tools.cjs` subprocess with a typed, tested, registry-based query system and **`gsd-sdk query`**, giving GSD structured results, classified errors (`GSDError` with `ErrorClassification`), and golden-verified parity with the old CLI. That gives the framework one stable contract instead of a fragile, very large CLI that every workflow had to spawn and parse by hand.

 **What users can expect**

--- a/docs/ja-JP/FEATURES.md
+++ b/docs/ja-JP/FEATURES.md
@@ -1308,7 +1308,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を

 ### 55. マルチランタイムインストーラー選択

-**対象:** `npx get-shit-done-redux`
+**対象:** `npx @opengsd/get-shit-done-redux`

 **目的:** 1回のインタラクティブなインストールセッションで複数のランタイムを選択します。

@@ -1327,7 +1327,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を

 ### 56. Windsurf ランタイムサポート

-**対象:** `npx get-shit-done-redux`
+**対象:** `npx @opengsd/get-shit-done-redux`

 **目的:** Windsurf AI IDE のサポートを追加します。

@@ -1568,7 +1568,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を

 ### 68. Claude Code スキルマイグレーション

-**対象:** `npx get-shit-done-redux`
+**対象:** `npx @opengsd/get-shit-done-redux`

 **目的:** GSD コマンドを Claude Code 2.1.88+ のスキル形式に後方互換性を維持してマイグレーションします。

@@ -1831,7 +1831,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を

 ### 85. 新規ランタイムサポート (Trae, Cline, Augment Code)

-**対象:** `npx get-shit-done-redux`
+**対象:** `npx @opengsd/get-shit-done-redux`

 **目的:** Trae IDE、Cline、Augment Code ランタイムへの GSD インストールを拡張します。

--- a/docs/ja-JP/context-monitor.md
+++ b/docs/ja-JP/context-monitor.md
@@ -60,7 +60,7 @@ GSD の `/gsd-pause-work` コマンドは実行状態を保存します。WARNIN

 ## セットアップ

-両フックは `npx get-shit-done-redux` のインストール時に自動的に登録されます:
+両フックは `npx @opengsd/get-shit-done-redux` のインストール時に自動的に登録されます:

 - **ステータスライン**（ブリッジファイルの書き込み）: settings.json の `statusLine` として登録
 - **コンテキストモニター**（ブリッジファイルの読み取り）: settings.json の `PostToolUse` フックとして登録（Gemini では `AfterTool`）
--- a/docs/ko-KR/FEATURES.md
+++ b/docs/ko-KR/FEATURES.md
@@ -1308,7 +1308,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하

 ### 55. Multi-Runtime Installer Selection

-**일부:** `npx get-shit-done-redux`
+**일부:** `npx @opengsd/get-shit-done-redux`

 **목적:** 단일 대화형 설치 세션에서 여러 런타임을 선택합니다.

@@ -1327,7 +1327,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하

 ### 56. Windsurf 런타임 지원

-**대상:** `npx get-shit-done-redux`
+**대상:** `npx @opengsd/get-shit-done-redux`

 **목적:** Windsurf AI IDE 지원을 추가합니다.

@@ -1568,7 +1568,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하

 ### 68. Claude Code 스킬 마이그레이션

-**대상:** `npx get-shit-done-redux`
+**대상:** `npx @opengsd/get-shit-done-redux`

 **목적:** GSD 명령어를 하위 호환성을 유지하면서 Claude Code 2.1.88+ 스킬 형식으로 마이그레이션합니다.

@@ -1831,7 +1831,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하

 ### 85. 신규 런타임 지원 (Trae, Cline, Augment Code)

-**대상:** `npx get-shit-done-redux`
+**대상:** `npx @opengsd/get-shit-done-redux`

 **목적:** Trae IDE, Cline, Augment Code 런타임으로 GSD 설치를 확장합니다.

--- a/docs/ko-KR/context-monitor.md
+++ b/docs/ko-KR/context-monitor.md
@@ -60,7 +60,7 @@ GSD의 `/gsd-pause-work` 명령어는 실행 상태를 저장합니다. WARNING

 ## 설정

-두 훅 모두 `npx get-shit-done-redux` 설치 중에 자동으로 등록됩니다.
+두 훅 모두 `npx @opengsd/get-shit-done-redux` 설치 중에 자동으로 등록됩니다.

 - **Statusline** (브리지 파일 기록): settings.json에 `statusLine`으로 등록
 - **Context Monitor** (브리지 파일 읽기): settings.json에 `PostToolUse` 훅으로 등록 (Gemini의 경우 `AfterTool`)
--- a/docs/manual-update.md
+++ b/docs/manual-update.md
@@ -1,6 +1,6 @@
 # Manual Update (Non-npm Install)

-Use this procedure when `npx get-shit-done-redux@latest` is unavailable — e.g. during a publish outage or if you are working directly from the source repo.
+Use this procedure when `npx @opengsd/get-shit-done-redux@latest` is unavailable — e.g. during a publish outage or if you are working directly from the source repo.

 ## Prerequisites

--- a/docs/prd/3524-cjs-sdk-hard-seam.md
+++ b/docs/prd/3524-cjs-sdk-hard-seam.md
@@ -209,7 +209,7 @@ Phase 5 specifically preserves the in-process model: `QueryRuntimeBridge.execute
 ### Build/install pipeline impact

 - Each generator runs at build time on the developer machine (and in CI for the freshness check). No runtime generator execution.
- The published `get-shit-done-redux` package already includes both `get-shit-done/bin/` and `sdk/dist/`. The generated `.cjs` files are committed to the repo (like `command-aliases.generated.cjs` today), so the install flow is unchanged — no on-install code generation.
+- The published `@opengsd/get-shit-done-redux` package already includes both `get-shit-done/bin/` and `sdk/dist/`. The generated `.cjs` files are committed to the repo (like `command-aliases.generated.cjs` today), so the install flow is unchanged — no on-install code generation.
 - `npm run build:sdk` continues to do what it does. Generators are invoked via `npm run gen:<module>` per the existing precedent.

 ### Risks
--- a/docs/pt-BR/CLI-TOOLS.md
+++ b/docs/pt-BR/CLI-TOOLS.md
@@ -1,7 +1,7 @@
 # Referência de Ferramentas CLI

 Resumo em Português das ferramentas CLI do GSD.  
-Para API completa (assinaturas, argumentos e comportamento detalhado), consulte [CLI-TOOLS.md em inglês](../CLI-TOOLS.md) — inclui a secção **SDK and programmatic access** (`gsd-sdk query`, `@gsd-redux/sdk`).
+Para API completa (assinaturas, argumentos e comportamento detalhado), consulte [CLI-TOOLS.md em inglês](../CLI-TOOLS.md) — inclui a secção **SDK and programmatic access** (`gsd-sdk query`, `@opengsd/gsd-sdk`).

 ---

--- a/docs/zh-CN/README.md
+++ b/docs/zh-CN/README.md
@@ -6,8 +6,8 @@

 **解决上下文衰减 —— 即 Claude 填充上下文窗口时发生的质量退化问题。**

-[![npm version](https://img.shields.io/npm/v/get-shit-done-redux?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/get-shit-done-redux)
-[![npm downloads](https://img.shields.io/npm/dm/get-shit-done-redux?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/get-shit-done-redux)
+[![npm version](https://img.shields.io/npm/v/%40opengsd%2Fget-shit-done-redux?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@opengsd/get-shit-done-redux)
+[![npm downloads](https://img.shields.io/npm/dm/%40opengsd%2Fget-shit-done-redux?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@opengsd/get-shit-done-redux)
 [![Tests](https://img.shields.io/github/actions/workflow/status/GSD-redux/get-shit-done-redux/test.yml?branch=main&style=for-the-badge&logo=github&label=Tests)](https://github.com/GSD-redux/get-shit-done-redux/actions/workflows/test.yml)
 [![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/mYgfVNfA2r)
 [![X (Twitter)](https://img.shields.io/badge/X-@gsd__foundation-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/gsd_foundation)
@@ -18,7 +18,7 @@
 <br>

 ```bash
-npx get-shit-done-redux@latest
+npx @opengsd/get-shit-done-redux@latest
 ```

 **支持 Mac、Windows 和 Linux。**
@@ -78,7 +78,7 @@ GSD 解决了这个问题。它是让 Claude Code 变得可靠的上下文工程
 ## 快速开始

 ```bash
-npx get-shit-done-redux@latest
+npx @opengsd/get-shit-done-redux@latest
 ```

 安装程序会提示你选择：
@@ -99,7 +99,7 @@ npx get-shit-done-redux@latest
 GSD 快速迭代。定期更新：

 ```bash
-npx get-shit-done-redux@latest
+npx @opengsd/get-shit-done-redux@latest
 ```

 <details>
@@ -107,25 +107,25 @@ npx get-shit-done-redux@latest

 ```bash
 # Claude Code
-npx get-shit-done-redux --claude --global   # 安装到 ~/.claude/
-npx get-shit-done-redux --claude --local    # 安装到 ./.claude/
+npx @opengsd/get-shit-done-redux --claude --global   # 安装到 ~/.claude/
+npx @opengsd/get-shit-done-redux --claude --local    # 安装到 ./.claude/

 # OpenCode
-npx get-shit-done-redux --opencode --global # 安装到 ~/.config/opencode/
+npx @opengsd/get-shit-done-redux --opencode --global # 安装到 ~/.config/opencode/

 # Gemini CLI
-npx get-shit-done-redux --gemini --global   # 安装到 ~/.gemini/
+npx @opengsd/get-shit-done-redux --gemini --global   # 安装到 ~/.gemini/

 # Kilo
-npx get-shit-done-redux --kilo --global     # 安装到 ~/.config/kilo/
-npx get-shit-done-redux --kilo --local      # 安装到 ./.kilo/
+npx @opengsd/get-shit-done-redux --kilo --global     # 安装到 ~/.config/kilo/
+npx @opengsd/get-shit-done-redux --kilo --local      # 安装到 ./.kilo/

 # Codex
-npx get-shit-done-redux --codex --global    # 安装到 ~/.codex/
-npx get-shit-done-redux --codex --local     # 安装到 ./.codex/
+npx @opengsd/get-shit-done-redux --codex --global    # 安装到 ~/.codex/
+npx @opengsd/get-shit-done-redux --codex --local     # 安装到 ./.codex/

 # 所有运行时
-npx get-shit-done-redux --all --global      # 安装到所有目录
+npx @opengsd/get-shit-done-redux --all --global      # 安装到所有目录
 ```

 使用 `--global`（`-g`）或 `--local`（`-l`）跳过位置提示。
@@ -652,18 +652,18 @@ GSD 的代码库映射和分析命令读取文件以了解你的项目。**保

 **命令没有按预期工作？**
 - 运行 `/gsd-help` 验证安装
- 重新运行 `npx get-shit-done-redux` 重新安装
+- 重新运行 `npx @opengsd/get-shit-done-redux` 重新安装

 **更新到最新版本？**
 ```bash
-npx get-shit-done-redux@latest
+npx @opengsd/get-shit-done-redux@latest
 ```

 **使用 Docker 或容器化环境？**

 如果用波浪号路径（`~/.claude/...`）读取文件失败，在安装前设置 `CLAUDE_CONFIG_DIR`：
 ```bash
-CLAUDE_CONFIG_DIR=/home/youruser/.claude npx get-shit-done-redux --global
+CLAUDE_CONFIG_DIR=/home/youruser/.claude npx @opengsd/get-shit-done-redux --global
 ```
 这确保使用绝对路径而不是 `~`，后者在容器中可能无法正确展开。

@@ -673,16 +673,16 @@ CLAUDE_CONFIG_DIR=/home/youruser/.claude npx get-shit-done-redux --global

 ```bash
 # 全局安装
-npx get-shit-done-redux --claude --global --uninstall
-npx get-shit-done-redux --opencode --global --uninstall
-npx get-shit-done-redux --kilo --global --uninstall
-npx get-shit-done-redux --codex --global --uninstall
+npx @opengsd/get-shit-done-redux --claude --global --uninstall
+npx @opengsd/get-shit-done-redux --opencode --global --uninstall
+npx @opengsd/get-shit-done-redux --kilo --global --uninstall
+npx @opengsd/get-shit-done-redux --codex --global --uninstall

 # 本地安装（当前项目）
-npx get-shit-done-redux --claude --local --uninstall
-npx get-shit-done-redux --opencode --local --uninstall
-npx get-shit-done-redux --kilo --local --uninstall
-npx get-shit-done-redux --codex --local --uninstall
+npx @opengsd/get-shit-done-redux --claude --local --uninstall
+npx @opengsd/get-shit-done-redux --opencode --local --uninstall
+npx @opengsd/get-shit-done-redux --kilo --local --uninstall
+npx @opengsd/get-shit-done-redux --codex --local --uninstall
 ```

 这删除所有 GSD 命令、代理、钩子和设置，同时保留你的其他配置。
@@ -691,7 +691,7 @@ npx get-shit-done-redux --codex --local --uninstall

 ## 社区移植

-OpenCode、Gemini CLI、Kilo 和 Codex 现在通过 `npx get-shit-done-redux` 原生支持。
+OpenCode、Gemini CLI、Kilo 和 Codex 现在通过 `npx @opengsd/get-shit-done-redux` 原生支持。

 这些社区移植开创了多运行时支持：