Skip to content

Commit 8095f4f

Browse files
NagyViktNagyViktclaude
authored
fix(gx): rename colony package from @imdeadpool/colony-cli to colonyq (#555)
Colony's canonical npm package was renamed. `gx status` / `gx setup` were prompting users with the deprecated install command: [gitguardex] Missing companion tools: colony. Install missing companion tools now? (npm i -g @imdeadpool/colony-cli) Accepting installs a stale package; declining leaves colony missing. Update src/context.js:24 COLONY_PACKAGE -> 'colonyq'. The install-command builder in src/toolchain/index.js:279 constructs `npm i -g <packageName>` from this constant, so the prompt automatically becomes `npm i -g colonyq` and the global-toolchain detection (npm list -g --depth=0 --json lookup) checks the right package name. Inline comment documents the post-install chain (colony install --ide codex, npx skills add ..., colony health) as user-side setup so future contributors don't reintroduce the rename in pieces. OpenSpec notes at openspec/changes/agent-claude-rename-colony-package-to-colonyq-2026-05-11-13-03/. Co-authored-by: NagyVikt <nagy.viktordp@gmail.com> Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 0b50a56 commit 8095f4f

3 files changed

Lines changed: 44 additions & 1 deletion

File tree

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
schema: spec-driven
2+
created: 2026-05-11
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# rename-colony-package-to-colonyq (T1)
2+
3+
Branch: `agent/claude/rename-colony-package-to-colonyq-2026-05-11-13-03`
4+
5+
## Problem
6+
7+
Colony's canonical npm package was renamed from `@imdeadpool/colony-cli` to `colonyq`. Gitguardex still references the old name in `src/context.js:24` (`COLONY_PACKAGE`), so the `gx status` / `gx setup` companion-install prompt shows the wrong command:
8+
9+
```
10+
[gitguardex] Missing companion tools: colony.
11+
Install missing companion tools now? (npm i -g @imdeadpool/colony-cli) [y/n]
12+
```
13+
14+
Accepting installs a deprecated package; declining leaves the user without colony.
15+
16+
## Change
17+
18+
Rename the constant: `COLONY_PACKAGE = 'colonyq'`. The install-command builder in `src/toolchain/index.js:279` constructs `npm i -g <packageName>` from this constant, so the prompt automatically becomes `npm i -g colonyq` and the global-toolchain detection (`npm list -g --depth=0 --json` lookup) checks the right package name.
19+
20+
## Out of scope
21+
22+
The new colony post-install chain — `colony install --ide codex``npx skills add recodeee/colony/skills/colony-mcp``colony health` — is user-side configuration that colony itself orchestrates. Gitguardex only owns the `npm i -g` step. Adding a `postInstallCommand` field to `GLOBAL_TOOLCHAIN_SERVICES` so gitguardex could chain those is a separate refactor and isn't blocking this rename. Documented as a future follow-up in the inline comment near the constant.
23+
24+
## Verification
25+
26+
- `node --check src/context.js` passes.
27+
- `gx status` (once this lands and is rebuilt/republished) shows `npm i -g colonyq` in the companion prompt.
28+
- Global-toolchain detection now matches against `colonyq` in the `npm list -g` JSON output.
29+
30+
## Cleanup
31+
32+
- [ ] `gx branch finish --branch agent/claude/rename-colony-package-to-colonyq-2026-05-11-13-03 --base main --via-pr --wait-for-merge --cleanup`
33+
- [ ] Record PR URL + `MERGED` state.
34+
- [ ] Confirm sandbox worktree gone.

src/context.js

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,14 @@ const GLOBAL_INSTALL_COMMAND = `npm i -g ${packageJson.name}`;
2121
const OPENSPEC_PACKAGE = '@fission-ai/openspec';
2222
const OMC_PACKAGE = 'oh-my-claude-sisyphus';
2323
const OMC_REPO_URL = 'https://github.com/Yeachan-Heo/oh-my-claudecode';
24-
const COLONY_PACKAGE = '@imdeadpool/colony-cli';
24+
// Colony was published under @imdeadpool/colony-cli historically; the new
25+
// canonical npm name is `colonyq`. The companion-install prompt that
26+
// gx status / gx setup show now reads `npm i -g colonyq`. Post-install
27+
// setup the user runs themselves (gitguardex only owns the `npm i -g` step):
28+
// colony install --ide codex
29+
// npx skills add recodeee/colony/skills/colony-mcp
30+
// colony health
31+
const COLONY_PACKAGE = 'colonyq';
2532
const NPX_BIN = process.env.GUARDEX_NPX_BIN || 'npx';
2633
const GUARDEX_HOME_DIR = path.resolve(process.env.GUARDEX_HOME_DIR || os.homedir());
2734
const GLOBAL_TOOLCHAIN_SERVICES = [

0 commit comments

Comments
 (0)