Skip to content

Commit efb7fbd

Browse files
NagyViktNagyVikt
andauthored
Prepare a fresh publishable Guardex patch release (#421)
The npm registry still points latest at 7.0.34, so this lane advances package metadata to 7.0.35 and restores the README/template parity gates needed for the current main payload to publish cleanly. Constraint: npm latest remained 7.0.34 before this lane Constraint: release verification requires README version notes and Active Agents template parity Rejected: retrying 7.0.34 | npm already has that version Confidence: high Scope-risk: moderate Directive: Keep future release bumps paired with README release notes and package metadata tests Tested: npm test (276 pass, 1 skip) Tested: npm pack --dry-run Tested: openspec validate --specs Tested: git diff --check Not-tested: live npm publish until PR merge and GitHub release workflow run Co-authored-by: NagyVikt <nagy.viktordp@gmail.com>
1 parent f1e62ec commit efb7fbd

13 files changed

Lines changed: 87 additions & 30 deletions

File tree

README.md

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@
99
and human teammates working the same codebase at the same time.
1010
</p>
1111

12+
Guardian T-Rex for your multi-agent repo. Isolated worktrees, file locks, and PR-only merges stop parallel Codex & Claude agents from overwriting each other's work. Auto-wires Oh My Codex, Oh My Claude, OpenSpec, and Caveman. See [about_description.txt](./about_description.txt).
13+
1214
<p align="center">
1315
<a href="https://www.npmjs.com/package/@imdeadpool/guardex"><img alt="npm version" src="https://img.shields.io/npm/v/%40imdeadpool%2Fguardex?label=npm&style=flat-square&color=cb3837&logo=npm&logoColor=white"></a>
1416
<a href="https://www.npmjs.com/package/@imdeadpool/guardex"><img alt="npm downloads per month" src="https://img.shields.io/npm/dm/%40imdeadpool%2Fguardex?label=downloads%2Fmonth&style=flat-square&color=0b76c5"></a>
@@ -57,7 +59,7 @@ gx setup # hooks, state, OMX / OpenSpec / caveman wiring — one shot
5759
5860
---
5961

60-
## `02` &nbsp;The problem
62+
## The problem
6163

6264
![Parallel agents colliding in the same files](https://raw.githubusercontent.com/recodeee/gitguardex/main/docs/images/problem-agent-collision.svg)
6365

@@ -74,6 +76,10 @@ started overwriting or deleting each other's changes. More agents meant
7476
| `claude-a``test/auth.spec.ts` · ⚠ clash | `claude-a``agent/claude/token-rotation` · ● owned |
7577
| `codex-04``src/auth/session.ts` · ◌ stalled | `human``main` (protected) · ● clean |
7678

79+
### Solution
80+
81+
![Agent branch/worktree start protocol](https://raw.githubusercontent.com/recodeee/gitguardex/main/docs/images/workflow-branch-start.svg)
82+
7783
---
7884

7985
## `03` &nbsp;What it does
@@ -204,6 +210,12 @@ the compact layout everywhere.
204210
| `gx sync` | Sync current agent branch against base. |
205211
| `gx release` | Update the GitHub release from README notes. |
206212

213+
```bash
214+
gx release # create/update the current GitHub release from README notes
215+
```
216+
217+
`gx release` is the maintainer path for package releases. It reads `README.md`, finds the last published GitHub release, and writes one grouped GitHub release body.
218+
207219
### Protected branches
208220

209221
```bash
@@ -249,12 +261,30 @@ Being honest about where this still has issues:
249261

250262
---
251263

264+
## Release notes
265+
266+
<details open>
267+
<summary><strong>v7.x</strong></summary>
268+
269+
### v7.0.35
270+
- Bumped `@imdeadpool/guardex` from `7.0.34` to `7.0.35` so the current
271+
merged `main` payload can publish on a fresh npm version after PR #420.
272+
- Refreshed README release/skills metadata and shipped Active Agents template
273+
parity so the current `main` payload passes release verification.
274+
- No new CLI command behavior is introduced in this release lane.
275+
276+
</details>
277+
278+
---
279+
252280
## `10` &nbsp;Companion tools
253281

254282
All optional — but if you're running many agents, you probably want them.
255283
`gx status` auto-detects each one and reports it in the `Global services`
256284
block.
257285

286+
Install repo skills with `npx skills add recodee/gitguardex`; `npx skills add recodee/` opens the recodee namespace. `gx setup` does not auto-run `npx skills add ...`. If the picker does not show a separate `guardex` skill, that is expected.
287+
258288
| Tool | What it does | Stars |
259289
| --- | --- | --- |
260290
| [**oh-my-codex**](https://github.com/Yeachan-Heo/oh-my-codex)`npm i -g oh-my-codex` | Codex config + skills framework. Merged into every agent worktree so each spawned Codex starts with the same tuned config. | [![stars](https://img.shields.io/github/stars/Yeachan-Heo/oh-my-codex?style=social)](https://github.com/Yeachan-Heo/oh-my-codex) |
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# Release notes
2+
3+
- Bump `@imdeadpool/guardex` from `7.0.34` to `7.0.35` for the next publishable release after PR #420.
4+
- Registry baseline before the bump: `@imdeadpool/guardex@7.0.34` with `latest` pointing to `7.0.34`.
5+
- Added README release/skills metadata required by the package metadata tests.
6+
- Repaired Active Agents template parity and the stale Claude .omc worktree naming test expectation so the existing current-main payload can release cleanly.

package-lock.json

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@imdeadpool/guardex",
3-
"version": "7.0.34",
3+
"version": "7.0.35",
44
"description": "Guardian T-Rex for your multi-agent repo. Isolated worktrees, file locks, and PR-only merges stop parallel Codex & Claude agents from overwriting each other's work. Auto-wires Oh My Codex, Oh My Claude, OpenSpec, and Caveman.",
55
"license": "MIT",
66
"preferGlobal": true,

templates/vscode/guardex-active-agents/extension.js

Lines changed: 23 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -99,17 +99,29 @@ function iconColorId(iconId) {
9999
case 'folder':
100100
case 'graph':
101101
case 'history':
102+
case 'dashboard':
103+
case 'inbox':
104+
case 'file-directory':
105+
case 'settings-gear':
106+
case 'folder-library':
102107
return 'textLink.foreground';
103108
case 'git-branch':
104109
return 'gitDecoration.modifiedResourceForeground';
105110
case 'account':
106111
return 'terminal.ansiYellow';
112+
case 'debug-pause':
113+
return 'terminal.ansiYellow';
107114
case 'sparkle':
115+
case 'rocket':
108116
return 'terminal.ansiMagenta';
109117
case 'list-flat':
118+
case 'device-camera':
110119
return 'terminal.ansiCyan';
111120
case 'list-tree':
121+
case 'telescope':
112122
return 'terminal.ansiBlue';
123+
case 'organization':
124+
return 'terminal.ansiGreen';
113125
case 'pass-filled':
114126
case 'pass':
115127
case 'check':
@@ -2777,12 +2789,12 @@ function buildSessionDetailItems(session) {
27772789
}
27782790
if (provider?.label) {
27792791
items.push(new DetailItem('Provider', provider.label, {
2780-
iconId: 'sparkle',
2792+
iconId: 'rocket',
27812793
}));
27822794
}
27832795
if (snapshot) {
27842796
items.push(new DetailItem('Snapshot', snapshot, {
2785-
iconId: 'account',
2797+
iconId: 'device-camera',
27862798
}));
27872799
}
27882800
if (projectRelativePath) {
@@ -2795,7 +2807,7 @@ function buildSessionDetailItems(session) {
27952807
iconId: 'git-branch',
27962808
}));
27972809
items.push(new DetailItem('Worktree', session.worktreePath, {
2798-
iconId: 'folder',
2810+
iconId: 'folder-library',
27992811
tooltip: session.worktreePath,
28002812
}));
28012813
return items;
@@ -3077,12 +3089,12 @@ class ActiveAgentsProvider {
30773089
const sectionItems = [
30783090
new SectionItem('Overview', [
30793091
new DetailItem('Summary', buildOverviewDescription(element.overview), {
3080-
iconId: 'graph',
3092+
iconId: 'dashboard',
30813093
tooltip: buildRepoTooltip(element.repoRoot, element.overview),
30823094
}),
30833095
], {
30843096
description: '1',
3085-
collapsedState: vscode.TreeItemCollapsibleState.Collapsed,
3097+
iconId: 'telescope',
30863098
}),
30873099
];
30883100

@@ -3100,14 +3112,14 @@ class ActiveAgentsProvider {
31003112
sectionItems.push(new SectionItem('Idle / thinking', idleThinkingItems, {
31013113
description: String(idleThinkingItems.length),
31023114
collapsedState: vscode.TreeItemCollapsibleState.Collapsed,
3103-
iconId: 'comment-discussion',
3115+
iconId: 'debug-pause',
31043116
}));
31053117
}
31063118

31073119
if (element.unassignedChanges.length > 0) {
31083120
sectionItems.push(new SectionItem('Unassigned changes', buildUnassignedChangeNodes(element.unassignedChanges), {
31093121
description: String(element.unassignedChanges.length),
3110-
iconId: 'warning',
3122+
iconId: 'inbox',
31113123
}));
31123124
}
31133125

@@ -3117,22 +3129,22 @@ class ActiveAgentsProvider {
31173129
advancedItems.push(new SectionItem('Active agent tree', rawActiveAgents, {
31183130
description: String(element.sessions.length),
31193131
collapsedState: vscode.TreeItemCollapsibleState.Collapsed,
3120-
iconId: 'git-branch',
3132+
iconId: 'organization',
31213133
}));
31223134
}
31233135
const rawChangeTree = buildGroupedChangeTreeNodes(element.sessions, element.changes);
31243136
if (rawChangeTree.length > 0) {
31253137
advancedItems.push(new SectionItem('Raw path tree', rawChangeTree, {
31263138
description: String(element.changes.length),
31273139
collapsedState: vscode.TreeItemCollapsibleState.Collapsed,
3128-
iconId: 'list-tree',
3140+
iconId: 'file-directory',
31293141
}));
31303142
}
31313143
if (advancedItems.length > 0) {
31323144
sectionItems.push(new SectionItem('Advanced details', advancedItems, {
31333145
description: String(advancedItems.length),
3134-
collapsedState: vscode.TreeItemCollapsibleState.Expanded,
3135-
iconId: 'list-tree',
3146+
collapsedState: vscode.TreeItemCollapsibleState.Collapsed,
3147+
iconId: 'settings-gear',
31363148
}));
31373149
}
31383150
return sectionItems;
Lines changed: 3 additions & 2 deletions
Loading
Lines changed: 5 additions & 2 deletions
Loading
Lines changed: 2 additions & 2 deletions
Loading
Lines changed: 2 additions & 1 deletion
Loading
Lines changed: 3 additions & 3 deletions
Loading

0 commit comments

Comments
 (0)