@imdeadpool/guardex 5.0.12 → 5.0.15

package/README.md

@@ -62,14 +62,14 @@ python3 scripts/agent-file-locks.py claim --branch "$(git rev-parse --abbrev-ref
 npm test
 
 # 4) Finish (commit/push/PR/merge flow)
-bash scripts/agent-branch-finish.sh --branch "$(git rev-parse --abbrev-ref HEAD)"
+bash scripts/agent-branch-finish.sh --branch "$(git rev-parse --abbrev-ref HEAD)" --base dev --via-pr --wait-for-merge
 
 # 5) Optional cleanup after merge
 gx cleanup --branch "$(git rev-parse --abbrev-ref HEAD)"
 ```
 
 If you use `scripts/codex-agent.sh`, the finish flow is auto-run after the Codex session exits.
-It auto-commits sandbox changes, retries once after syncing if the branch moved behind base during the run, then pushes/opens PR merge flow against the current base branch.
+It auto-commits sandbox changes, retries once after syncing if the branch moved behind base during the run, then pushes/opens PR merge flow against `dev`.
 
 If you run Codex in multiple existing agent worktrees directly (for example from VS Code Source Control), finalize all completed branches with:
 
@@ -111,6 +111,11 @@ gx doctor
 # setup + repair another repo without switching your current repo checkout
 gx setup --target /path/to/repo
 gx doctor --target /path/to/repo
+# optional: from parent folder, generate VS Code workspace view for repo + agent worktrees
+cd /path/to
+gx setup --target ./repo --parent-workspace-view
+# open this in VS Code to manage both base repo and .omx/agent-worktrees
+code ./repo-branches.code-workspace
 
 # protected branch management
 gx protect list
@@ -198,6 +203,7 @@ gx agents stop
 - `gx init` is alias of `gx setup`.
 - Setup/doctor can install missing global OMX/OpenSpec/codex-auth with explicit Y/N confirmation.
 - `gx setup` checks GitHub CLI (`gh`) and prints install guidance if missing.
+- Optional parent-folder VS Code Source Control view: `gx setup --target /path/to/repo --parent-workspace-view` creates `../<repo>-branches.code-workspace`.
 - Interactive self-update prompt defaults to **No** (`[y/N]`).
 - In initialized repos, `setup`/`install`/`fix` block protected-base writes unless explicitly overridden.
 - Direct commits/pushes to protected branches are blocked by default.
@@ -342,10 +348,12 @@ openspec update
 
 ### OpenSpec in agent sub-branches
 
-- `scripts/codex-agent.sh` enforces an OpenSpec workspace before it launches Codex in each sandbox branch/worktree.
-- `scripts/agent-branch-start.sh` can also scaffold `openspec/plan/<agent-branch-slug>/` when you set `MUSAFETY_OPENSPEC_AUTO_INIT=true`.
+- `scripts/codex-agent.sh` enforces OpenSpec workspaces before it launches Codex in each sandbox branch/worktree.
+- `scripts/agent-branch-start.sh` can scaffold both `openspec/changes/<agent-branch-slug>/` and `openspec/plan/<agent-branch-slug>/` when you set `MUSAFETY_OPENSPEC_AUTO_INIT=true`.
 - Set `MUSAFETY_OPENSPEC_AUTO_INIT=false` (default for `agent-branch-start`) to skip branch-start auto-bootstrap.
 - Set `MUSAFETY_OPENSPEC_PLAN_SLUG=<kebab-case-slug>` to force a specific plan workspace name.
+- Set `MUSAFETY_OPENSPEC_CHANGE_SLUG=<kebab-case-slug>` to force a specific change workspace name.
+- Set `MUSAFETY_OPENSPEC_CAPABILITY_SLUG=<kebab-case-slug>` to override the default capability folder used for `spec.md` scaffolding.
 
 ## Security and maintenance posture
 
@@ -364,6 +372,22 @@ npm pack --dry-run
 
 ## Release notes
 
+### v5.0.15
+
+- Added `gx setup --parent-workspace-view` to generate a parent-folder VS Code workspace (`../<repo>-branches.code-workspace`) that shows both the base repo and `.omx/agent-worktrees` in Source Control.
+- Added dry-run-safe parent workspace operations (`would-create` / `would-update`) and setup output that prints the created workspace path.
+- Added regression coverage for parent workspace generation and dry-run behavior.
+- Bumped package version from `5.0.14` to `5.0.15`.
+
+### v5.0.14
+
+- Changed release metadata for the next npm publish by bumping package version from `5.0.13` to `5.0.14`.
+- Kept Guardex release notes synchronized with the published package version.
+
+### v5.0.13
+
+- Bumped package version from `5.0.12` to `5.0.13` for the next npm publish.
+
 ### v5.0.12
 
 - Bumped package version from `5.0.11` to `5.0.12` for the next npm publish.