@imdeadpool/guardex 7.0.14 → 7.0.16
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +37 -4
- package/bin/multiagent-safety.js +1236 -171
- package/package.json +3 -2
- package/templates/scripts/agent-branch-finish.sh +35 -6
- package/templates/scripts/agent-branch-merge.sh +421 -0
- package/templates/scripts/agent-branch-start.sh +93 -15
- package/templates/scripts/agent-worktree-prune.sh +78 -44
- package/templates/scripts/codex-agent.sh +96 -4
- package/templates/scripts/guardex-docker-loader.sh +123 -0
- package/templates/scripts/openspec/init-plan-workspace.sh +42 -0
package/README.md
CHANGED
|
@@ -116,6 +116,8 @@ Running Codex across several existing worktrees (e.g. from VS Code Source Contro
|
|
|
116
116
|
gx finish --all
|
|
117
117
|
```
|
|
118
118
|
|
|
119
|
+
Codex sessions default to `.omx/agent-worktrees/`. Claude Code sessions default to `.omc/agent-worktrees/`, so Claude sandboxes stay under the Claude runtime folder instead of sharing the Codex root.
|
|
120
|
+
|
|
119
121
|
---
|
|
120
122
|
|
|
121
123
|
## Visual reference
|
|
@@ -161,13 +163,25 @@ gx setup --target /path/to/repo --parent-workspace-view
|
|
|
161
163
|
|
|
162
164
|
### Monorepo support
|
|
163
165
|
|
|
164
|
-
Setup auto-installs into every nested git repo (e.g. `apps/*/.git`). Submodules and worktrees under `.omx/agent-worktrees/` are skipped.
|
|
166
|
+
Setup auto-installs into every nested git repo (e.g. `apps/*/.git`). Submodules and worktrees under `.omx/agent-worktrees/` or `.omc/agent-worktrees/` are skipped.
|
|
165
167
|
|
|
166
168
|
```sh
|
|
167
169
|
gx setup --target /mainfolder
|
|
168
170
|
gx setup --target /mainfolder --no-recursive
|
|
169
171
|
```
|
|
170
172
|
|
|
173
|
+
### Fresh repos + Docker Compose
|
|
174
|
+
|
|
175
|
+
On a brand-new repo, `gx setup` now prints the next real steps too: commit the scaffold, start the first agent branch, and add `origin` if you want finish/merge flows to leave the machine.
|
|
176
|
+
|
|
177
|
+
If the repo already has `docker-compose.yml`, `docker-compose.yaml`, `compose.yml`, or `compose.yaml`, setup also points you at the bundled Docker loader:
|
|
178
|
+
|
|
179
|
+
```sh
|
|
180
|
+
GUARDEX_DOCKER_SERVICE=app bash scripts/guardex-docker-loader.sh -- npm test
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
When the service is already running, the loader uses `docker compose exec`; otherwise it falls back to `docker compose run --rm`.
|
|
184
|
+
|
|
171
185
|
### Protected branches
|
|
172
186
|
|
|
173
187
|
```sh
|
|
@@ -206,8 +220,15 @@ gx cleanup # prune merged/stale branches and worktrees
|
|
|
206
220
|
gx cleanup --watch --interval 60
|
|
207
221
|
gx cleanup --idle-minutes 10
|
|
208
222
|
gx cleanup --watch --once --interval 60
|
|
223
|
+
gx release # create/update the current GitHub release from README notes
|
|
209
224
|
```
|
|
210
225
|
|
|
226
|
+
### Release publishing
|
|
227
|
+
|
|
228
|
+
`gx release` is the maintainer path for package releases. It reads the versioned sections under `README.md -> Release notes`, finds the last published GitHub release, and writes one grouped GitHub release body covering everything newer than that release and up to the current package version.
|
|
229
|
+
|
|
230
|
+
That GitHub release then triggers `.github/workflows/release.yml`, which performs the actual `npm publish --provenance --access public` step.
|
|
231
|
+
|
|
211
232
|
### Prompts for your agents
|
|
212
233
|
|
|
213
234
|
```sh
|
|
@@ -441,6 +462,7 @@ scripts/openspec/init-plan-workspace.sh
|
|
|
441
462
|
.claude/commands/gitguardex.md
|
|
442
463
|
.github/pull.yml.example
|
|
443
464
|
.github/workflows/cr.yml
|
|
465
|
+
.omc/agent-worktrees
|
|
444
466
|
.omx/state/agent-file-locks.json
|
|
445
467
|
```
|
|
446
468
|
|
|
@@ -450,17 +472,17 @@ If `package.json` exists, setup also adds `agent:*` helper scripts.
|
|
|
450
472
|
|
|
451
473
|
## Frontend mirror
|
|
452
474
|
|
|
453
|
-
- Standalone frontend repo: <https://github.com/
|
|
475
|
+
- Standalone frontend repo: <https://github.com/recodeee/gitguardex-frontend>
|
|
454
476
|
- This repo tracks the frontend under `frontend/` and auto-mirrors it via `.github/workflows/sync-frontend-mirror.yml` on changes to `main`.
|
|
455
477
|
|
|
456
478
|
Setup (in this repo):
|
|
457
479
|
|
|
458
480
|
1. `Settings → Secrets and variables → Actions`
|
|
459
|
-
2. Add secret `GUARDEX_FRONTEND_MIRROR_PAT` with `contents:write` on `
|
|
481
|
+
2. Add secret `GUARDEX_FRONTEND_MIRROR_PAT` with `contents:write` on `recodeee/gitguardex-frontend`
|
|
460
482
|
|
|
461
483
|
Optional overrides (Actions Variables):
|
|
462
484
|
|
|
463
|
-
- `GUARDEX_FRONTEND_MIRROR_REPO` (default `
|
|
485
|
+
- `GUARDEX_FRONTEND_MIRROR_REPO` (default `recodeee/gitguardex-frontend`)
|
|
464
486
|
- `GUARDEX_FRONTEND_MIRROR_BRANCH` (default `main`)
|
|
465
487
|
|
|
466
488
|
Manual run:
|
|
@@ -507,6 +529,17 @@ npm pack --dry-run
|
|
|
507
529
|
<details>
|
|
508
530
|
<summary><strong>v7.x</strong></summary>
|
|
509
531
|
|
|
532
|
+
### v7.0.16
|
|
533
|
+
- `gx doctor` now keeps nested repo repair runs visibly progressing, and overlapping integration work stays off the protected base branch instead of trying to merge back on `main`.
|
|
534
|
+
- Cleanup and finish flows are less brittle: `codex-agent` no longer waits on PRs that can never exist, and prune cleanup now walks both managed worktree roots so stale sandboxes get removed consistently.
|
|
535
|
+
- Mirror-sync diagnostics are quieter: when the mirror PAT is unset, Guardex now skips the sync path instead of marking the run red, and shared `ralplan` lanes stay easier to identify during handoff/debugging.
|
|
536
|
+
- Bumped `@imdeadpool/guardex` from `7.0.15` → `7.0.16` after npm rejected a republish over the already-published `7.0.15`.
|
|
537
|
+
|
|
538
|
+
### v7.0.15
|
|
539
|
+
- `gx doctor` no longer blocks recursive nested protected-repo repairs on child PR merge waits; nested sandboxes now force `--no-wait-for-merge` so the parent repair loop can continue.
|
|
540
|
+
- `gx setup` can now refresh managed files from protected `main` through a temporary sandbox branch/worktree, sync the managed outputs back to the visible base checkout, and prune the sandbox afterward.
|
|
541
|
+
- Bumped `@imdeadpool/guardex` from `7.0.14` → `7.0.15` after npm rejected a republish over the already-published `7.0.14`.
|
|
542
|
+
|
|
510
543
|
### v7.0.14
|
|
511
544
|
- Bumped `@imdeadpool/guardex` from `7.0.13` → `7.0.14` after npm rejected a republish over the already-published `7.0.13`.
|
|
512
545
|
- No package payload changes beyond the release metadata bump; this release exists so `npm publish` can proceed with a fresh semver.
|