From 2145102229ce78dc3ade6b7ac9e1f6bd57dd99bd Mon Sep 17 00:00:00 2001 From: NagyVikt Date: Wed, 22 Apr 2026 16:14:48 +0200 Subject: [PATCH] Plan the Active Agents branding follow-up before runtime edits The extension details page still shows the default placeholder icon even though the repo already carries a root logo asset. This commit captures a delta-only execution plan that starts with packaging the brand asset into the installable extension payload and only touches runtime behavior after audit proves a requested gap still exists. Constraint: VS Code extension icons must resolve from inside the installed extension directory Constraint: Active Agents already ships grouped state, repo changes, lock warnings, and AGENT.lock fallback Rejected: Rewrite the extension runtime from scratch | would duplicate already-landed behavior and widen risk Confidence: high Scope-risk: narrow Reversibility: clean Directive: Audit the shipped Active Agents behavior before editing provider/session logic; do not reference repo-root logo.png directly from package.json Tested: openspec validate agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --type change --strict; openspec validate --specs (no items found) Not-tested: node --test test/vscode-active-agents-session-state.test.js; manual VS Code icon rendering --- .../.openspec.yaml | 2 + .../proposal.md | 17 ++ .../vscode-active-agents-extension/spec.md | 28 +++ .../tasks.md | 41 ++++ .../README.md | 19 ++ .../architect/.openspec.yaml | 8 + .../architect/README.md | 11 ++ .../architect/proposal.md | 15 ++ .../architect/specs/architect/spec.md | 10 + .../architect/tasks.md | 32 +++ .../checkpoints.md | 4 + .../coordinator-prompt.md | 37 ++++ .../critic/.openspec.yaml | 8 + .../critic/README.md | 11 ++ .../critic/proposal.md | 15 ++ .../critic/specs/critic/spec.md | 10 + .../critic/tasks.md | 32 +++ .../executor/.openspec.yaml | 8 + .../executor/README.md | 11 ++ .../executor/checkpoints.md | 4 + .../executor/proposal.md | 15 ++ .../executor/specs/executor/spec.md | 10 + .../executor/tasks.md | 32 +++ .../kickoff-prompts.md | 108 ++++++++++ .../phases.md | 35 ++++ .../planner/.openspec.yaml | 8 + .../planner/README.md | 11 ++ .../planner/plan.md | 184 ++++++++++++++++++ .../planner/proposal.md | 15 ++ .../planner/specs/planner/spec.md | 10 + .../planner/tasks.md | 32 +++ .../summary.md | 20 ++ .../verifier/.openspec.yaml | 8 + .../verifier/README.md | 11 ++ .../verifier/proposal.md | 15 ++ .../verifier/specs/verifier/spec.md | 10 + .../verifier/tasks.md | 32 +++ .../writer/.openspec.yaml | 8 + .../writer/README.md | 11 ++ .../writer/proposal.md | 15 ++ .../writer/specs/writer/spec.md | 10 + .../writer/tasks.md | 32 +++ 42 files changed, 955 insertions(+) create mode 100644 openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/.openspec.yaml create mode 100644 openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/proposal.md create mode 100644 openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/specs/vscode-active-agents-extension/spec.md create mode 100644 openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/tasks.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/README.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/.openspec.yaml create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/README.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/proposal.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/specs/architect/spec.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/tasks.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/checkpoints.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/coordinator-prompt.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/.openspec.yaml create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/README.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/proposal.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/specs/critic/spec.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/tasks.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/.openspec.yaml create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/README.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/checkpoints.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/proposal.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/specs/executor/spec.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/tasks.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/kickoff-prompts.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/phases.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/.openspec.yaml create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/README.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/plan.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/proposal.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/specs/planner/spec.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/tasks.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/summary.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/.openspec.yaml create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/README.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/proposal.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/specs/verifier/spec.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/tasks.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/.openspec.yaml create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/README.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/proposal.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/specs/writer/spec.md create mode 100644 openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/tasks.md diff --git a/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/.openspec.yaml b/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/.openspec.yaml new file mode 100644 index 0000000..25345f4 --- /dev/null +++ b/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-04-22 diff --git a/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/proposal.md b/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/proposal.md new file mode 100644 index 0000000..97801e7 --- /dev/null +++ b/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/proposal.md @@ -0,0 +1,17 @@ +## Why + +- The VS Code extension details page for `GitGuardex Active Agents` still shows the default placeholder icon even though the repo already ships a root `logo.png`. +- The current Active Agents implementation already covers more of the user's requested runtime behavior than the brief assumes, so execution needs a delta-only plan instead of a rewrite. +- We need one scoped follow-up change that ties branding, install packaging, duplicated extension sources, runtime polish audit, docs, tests, and finish-flow verification together. + +## What Changes + +- Add a branded extension-icon lane that packages a copy of the repo `logo.png` inside the installable extension payload and wires the manifest to it. +- Audit the shipped Active Agents companion against the requested runtime brief and only implement still-missing deltas after that audit. +- Keep `vscode/guardex-active-agents/*`, `templates/vscode/guardex-active-agents/*`, install behavior, README guidance, and focused regression coverage aligned. + +## Impact + +- Affected surfaces: `logo.png`, `vscode/guardex-active-agents/*`, `templates/vscode/guardex-active-agents/*`, `scripts/install-vscode-active-agents-extension.js`, `test/vscode-active-agents-session-state.test.js`, and README surfaces that describe local install/use. +- Primary risk is duplicate work: grouped state sections, repo `CHANGES`, lock-aware decorations, and `AGENT.lock` fallback already exist, so the implementation lane must prove any runtime gap before editing provider logic. +- Packaging risk is narrow but real: the extension icon must resolve from inside the installed extension directory, not from the repo root. diff --git a/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/specs/vscode-active-agents-extension/spec.md b/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/specs/vscode-active-agents-extension/spec.md new file mode 100644 index 0000000..b24c3a8 --- /dev/null +++ b/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/specs/vscode-active-agents-extension/spec.md @@ -0,0 +1,28 @@ +## ADDED Requirements + +### Requirement: Active Agents ships a branded extension icon +The GitGuardex Active Agents extension SHALL package a branded icon that resolves from inside the installed extension directory. + +#### Scenario: Local install includes packaged icon asset +- **WHEN** `scripts/install-vscode-active-agents-extension.js` installs the extension +- **THEN** the installed extension directory contains an icon asset derived from the repo `logo.png` +- **AND** `vscode/guardex-active-agents/package.json` points its `icon` field at that packaged asset +- **AND** VS Code can show the branded icon instead of the default placeholder on the extension details page. + +### Requirement: Mirrored extension sources stay consistent +User-visible Active Agents extension behavior SHALL stay aligned across the duplicated `vscode/guardex-active-agents/` and `templates/vscode/guardex-active-agents/` trees unless the change intentionally collapses them to one canonical source. + +#### Scenario: Branding or runtime changes touch duplicated extension files +- **WHEN** this change updates extension packaging, manifest metadata, runtime behavior, or bundled assets +- **THEN** the same shipped behavior is present in both source trees +- **OR** the change removes one source tree and updates installer/tests to the new single source of truth in the same change +- **AND** focused regression coverage validates the shipped install payload. + +### Requirement: Runtime follow-up stays delta-based +This follow-up SHALL preserve the already-shipped Active Agents grouped tree behavior and only add runtime changes that are still missing after audit. + +#### Scenario: Runtime brief overlaps already-landed features +- **WHEN** the executor compares the requested runtime brief against the current extension code and prior Active Agents change specs +- **THEN** grouped `ACTIVE AGENTS` and repo `CHANGES` behavior, group ordering, lock awareness, and `AGENT.lock` fallback remain intact +- **AND** only unsatisfied deltas are added to `extension.js`, `session-schema.js`, related docs, or tests +- **AND** the change does not reimplement already-shipped behavior solely because it appeared in the user brief. diff --git a/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/tasks.md b/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/tasks.md new file mode 100644 index 0000000..169cf0e --- /dev/null +++ b/openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/tasks.md @@ -0,0 +1,41 @@ +## Definition of Done + +This change is complete only when **all** of the following are true: + +- Every checkbox below is checked. +- The agent branch reaches `MERGED` state on `origin` and the PR URL + state are recorded in the completion handoff. +- If any step blocks (test failure, conflict, ambiguous result), append a `BLOCKED:` line under section 5 explaining the blocker and **STOP**. Do not tick remaining cleanup boxes; do not silently skip the cleanup pipeline. + +## Handoff + +- Handoff: change=`agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`; branch=`agent/codex/vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`; scope=`logo.png packaging for the Active Agents extension, delta-only runtime audit, mirrored source parity, focused tests/docs`; action=`continue in this sandbox, execute the phase board in openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/, and finish with gx branch finish after validation`. +- Copy prompt: Continue `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` on branch `agent/codex/vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`. Work inside the existing sandbox, review `openspec/changes/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/tasks.md`, continue from the current state instead of creating a new sandbox, and when the work is done run `gx branch finish --branch agent/codex/vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --base main --via-pr --wait-for-merge --cleanup`. + +## 1. Specification + +- [x] 1.1 Finalize proposal scope around extension branding, install payload behavior, mirrored extension-source parity, and delta-only runtime follow-up. +- [x] 1.2 Define normative requirements in `specs/vscode-active-agents-extension/spec.md`. + +## 2. Planning + +- [x] 2.1 Create an execution-ready plan workspace under `openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/`. +- [x] 2.2 Replace generic role task scaffolds with concrete lanes for planner, architect, critic, executor, writer, and verifier. +- [ ] 2.3 Fold any later architect/critic review back into the plan before code edits start. + +## 3. Implementation + +- [ ] 3.1 Package a branded extension icon using the existing repo `logo.png` and wire it into the installed extension manifest. +- [ ] 3.2 Audit the current Active Agents code/specs against the requested runtime brief and only land still-missing deltas. +- [ ] 3.3 Keep `vscode/guardex-active-agents/*`, `templates/vscode/guardex-active-agents/*`, docs, and focused tests aligned. + +## 4. Verification + +- [ ] 4.1 Run focused extension/install coverage, including `node --test test/vscode-active-agents-session-state.test.js`. +- [ ] 4.2 Run `openspec validate agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --type change --strict`. +- [ ] 4.3 Run `openspec validate --specs`. + +## 5. Cleanup (mandatory; run before claiming completion) + +- [ ] 5.1 Run the cleanup pipeline: `gx branch finish --branch agent/codex/vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --base main --via-pr --wait-for-merge --cleanup`. This handles commit -> push -> PR create -> merge wait -> worktree prune in one invocation. +- [ ] 5.2 Record the PR URL and final merge state (`MERGED`) in the completion handoff. +- [ ] 5.3 Confirm the sandbox worktree is gone (`git worktree list` no longer shows the agent path; `git branch -a` shows no surviving local/remote refs for the branch). diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/README.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/README.md new file mode 100644 index 0000000..2da0dcd --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/README.md @@ -0,0 +1,19 @@ +# Plan Workspace: agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 + +This folder stores durable planning artifacts before implementation changes. + +## Role folders +- `planner/` +- `architect/` +- `critic/` +- `executor/` +- `writer/` +- `verifier/` + +Each role folder contains OpenSpec-style artifacts: +- `.openspec.yaml` +- `proposal.md` +- `tasks.md` (Spec / Tests / Implementation / Checkpoints checklists) +- `specs//spec.md` +Planner also gets `plan.md`; executor also gets `checkpoints.md`. +Planner plans should follow `openspec/plan/PLANS.md`. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/.openspec.yaml b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/.openspec.yaml new file mode 100644 index 0000000..57309ef --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/.openspec.yaml @@ -0,0 +1,8 @@ +schema: 1 +plan: agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 +role: architect +status: draft +artifacts: + proposal: proposal.md + tasks: tasks.md + spec: specs/architect/spec.md diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/README.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/README.md new file mode 100644 index 0000000..37d231e --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/README.md @@ -0,0 +1,11 @@ +# architect + +Role workspace for `architect`. + +Default artifacts: +- `.openspec.yaml` +- `proposal.md` +- `tasks.md` +- `specs//spec.md` + +Use this folder for role notes, artifacts, and status updates. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/proposal.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/proposal.md new file mode 100644 index 0000000..54d02ca --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/proposal.md @@ -0,0 +1,15 @@ +# Proposal: architect (agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05) + +## Why + +Summarize why this role's work is required for plan `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`. + +## What Changes + +- [ ] List the planned role-specific changes + +## Impact + +- Scope: +- Risks: +- Dependencies: diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/specs/architect/spec.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/specs/architect/spec.md new file mode 100644 index 0000000..ae40da7 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/specs/architect/spec.md @@ -0,0 +1,10 @@ +# Capability Spec: architect + +## ADDED Requirements + +### Requirement: architect responsibilities for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +This role MUST define and deliver its scoped outputs with evidence. + +#### Scenario: Role executes assigned scope +- **WHEN** the role begins execution for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +- **THEN** it follows `tasks.md` and records evidence for completion diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/tasks.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/tasks.md new file mode 100644 index 0000000..591a7ad --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/architect/tasks.md @@ -0,0 +1,32 @@ +# architect tasks + +## 1. Spec + +- [ ] 1.1 Decide whether this lane keeps `vscode/guardex-active-agents/` and `templates/vscode/guardex-active-agents/` mirrored or intentionally collapses them to one canonical source. +- [ ] 1.2 Lock the packaged-icon strategy: committed asset copy inside the extension tree versus any generated/install-time alternative. + +## 2. Tests + +- [ ] 2.1 Define compatibility checks for VS Code manifest `icon` metadata, installer payload copying, and mirrored-source parity. +- [ ] 2.2 Validate that any runtime follow-up preserves grouped `ACTIVE AGENTS` / `CHANGES`, lock-aware rows, and `AGENT.lock` fallback behavior. + +## 3. Implementation + +- [ ] 3.1 Compare the viable options: in-place patch, source-tree canonicalization, or installer-time asset injection. +- [ ] 3.2 Record the chosen architecture and guardrails in `planner/plan.md`. +- [ ] 3.3 Publish architecture sign-off notes for downstream execution. + +## 4. Checkpoints + +- [ ] [A1] READY - Architecture review checkpoint + +## 5. Collaboration + +- [ ] 5.1 Owner recorded this lane before edits. +- [ ] 5.2 Record joined agents / handoffs, or mark `N/A` when solo. + +## 6. Cleanup + +- [ ] 6.1 If this lane owns finalization, run `gx branch finish --branch agent/codex/vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --base main --via-pr --wait-for-merge --cleanup`. +- [ ] 6.2 Record PR URL + final `MERGED` state in the handoff. +- [ ] 6.3 Confirm sandbox cleanup (`git worktree list`, `git branch -a`) or append `BLOCKED:` and stop. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/checkpoints.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/checkpoints.md new file mode 100644 index 0000000..4500395 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/checkpoints.md @@ -0,0 +1,4 @@ +# Plan Checkpoints: agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 + +Chronological checkpoint log for all roles. + diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/coordinator-prompt.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/coordinator-prompt.md new file mode 100644 index 0000000..296a767 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/coordinator-prompt.md @@ -0,0 +1,37 @@ +# Master Coordinator Prompt + +You are the coordinator for plan `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`. + +## Objective + +Drive this plan from draft to execution-ready status with strict checkpoint discipline and no scope drift. + +## Source-of-truth artifacts + +- `openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/summary.md` +- `openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/checkpoints.md` +- `openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/plan.md` +- role `tasks.md` files for planner/architect/critic/executor/writer/verifier + +## Coordinator responsibilities + +1. Keep checkpoints current in each role `tasks.md` and root `checkpoints.md`. +2. Ensure each role has explicit acceptance criteria and verification evidence. +3. Prevent implementation from starting before planning gates are complete. +4. Keep handoffs concise: files changed, behavior touched, verification output, risks. + +## Wave-splitting decision (optional) + +Create wave prompts in `kickoff-prompts.md` only when at least one applies: + +- 3+ independent implementation lanes can run in parallel. +- Runtime cutover/rollback sequencing needs explicit lane ownership. +- Risk is high enough that bounded execution packets reduce coordination mistakes. + +If wave splitting is not needed, keep execution under a single owner with normal role checkpoints. + +## Exit criteria + +- All role checkpoints required for planning are done. +- Execution lanes (if any) have clear ownership boundaries. +- Verification plan and rollback expectations are explicit and testable. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/.openspec.yaml b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/.openspec.yaml new file mode 100644 index 0000000..d82f108 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/.openspec.yaml @@ -0,0 +1,8 @@ +schema: 1 +plan: agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 +role: critic +status: draft +artifacts: + proposal: proposal.md + tasks: tasks.md + spec: specs/critic/spec.md diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/README.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/README.md new file mode 100644 index 0000000..3ee2542 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/README.md @@ -0,0 +1,11 @@ +# critic + +Role workspace for `critic`. + +Default artifacts: +- `.openspec.yaml` +- `proposal.md` +- `tasks.md` +- `specs//spec.md` + +Use this folder for role notes, artifacts, and status updates. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/proposal.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/proposal.md new file mode 100644 index 0000000..be1ac15 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/proposal.md @@ -0,0 +1,15 @@ +# Proposal: critic (agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05) + +## Why + +Summarize why this role's work is required for plan `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`. + +## What Changes + +- [ ] List the planned role-specific changes + +## Impact + +- Scope: +- Risks: +- Dependencies: diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/specs/critic/spec.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/specs/critic/spec.md new file mode 100644 index 0000000..72531e6 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/specs/critic/spec.md @@ -0,0 +1,10 @@ +# Capability Spec: critic + +## ADDED Requirements + +### Requirement: critic responsibilities for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +This role MUST define and deliver its scoped outputs with evidence. + +#### Scenario: Role executes assigned scope +- **WHEN** the role begins execution for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +- **THEN** it follows `tasks.md` and records evidence for completion diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/tasks.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/tasks.md new file mode 100644 index 0000000..1be34a7 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/critic/tasks.md @@ -0,0 +1,32 @@ +# critic tasks + +## 1. Spec + +- [ ] 1.1 Validate that the plan stays delta-based and does not reopen already-landed Active Agents features without evidence. +- [ ] 1.2 Validate that risks, consequences, and mitigations are explicit for asset packaging, mirrored sources, and finish-flow cleanup. + +## 2. Tests + +- [ ] 2.1 Validate that every acceptance criterion maps to a concrete proof surface: installed asset, focused tests, OpenSpec validation, or merge evidence. +- [ ] 2.2 Validate that the verification steps are concrete and reproducible from the sandbox worktree. + +## 3. Implementation + +- [ ] 3.1 Produce a verdict (`APPROVE`, `ITERATE`, or `REJECT`) on the plan and call out any unnecessary runtime work. +- [ ] 3.2 Confirm revised drafts resolve prior findings before approval. +- [ ] 3.3 Publish final quality/risk sign-off notes. + +## 4. Checkpoints + +- [ ] [C1] READY - Quality gate checkpoint + +## 5. Collaboration + +- [ ] 5.1 Owner recorded this lane before edits. +- [ ] 5.2 Record joined agents / handoffs, or mark `N/A` when solo. + +## 6. Cleanup + +- [ ] 6.1 If this lane owns finalization, run `gx branch finish --branch agent/codex/vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --base main --via-pr --wait-for-merge --cleanup`. +- [ ] 6.2 Record PR URL + final `MERGED` state in the handoff. +- [ ] 6.3 Confirm sandbox cleanup (`git worktree list`, `git branch -a`) or append `BLOCKED:` and stop. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/.openspec.yaml b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/.openspec.yaml new file mode 100644 index 0000000..55da395 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/.openspec.yaml @@ -0,0 +1,8 @@ +schema: 1 +plan: agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 +role: executor +status: draft +artifacts: + proposal: proposal.md + tasks: tasks.md + spec: specs/executor/spec.md diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/README.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/README.md new file mode 100644 index 0000000..0c66034 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/README.md @@ -0,0 +1,11 @@ +# executor + +Role workspace for `executor`. + +Default artifacts: +- `.openspec.yaml` +- `proposal.md` +- `tasks.md` +- `specs//spec.md` + +Use this folder for role notes, artifacts, and status updates. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/checkpoints.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/checkpoints.md new file mode 100644 index 0000000..2a84973 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/checkpoints.md @@ -0,0 +1,4 @@ +# executor checkpoints + +Timestamped execution checkpoints for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`. + diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/proposal.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/proposal.md new file mode 100644 index 0000000..30acb63 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/proposal.md @@ -0,0 +1,15 @@ +# Proposal: executor (agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05) + +## Why + +Summarize why this role's work is required for plan `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`. + +## What Changes + +- [ ] List the planned role-specific changes + +## Impact + +- Scope: +- Risks: +- Dependencies: diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/specs/executor/spec.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/specs/executor/spec.md new file mode 100644 index 0000000..ad99b2e --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/specs/executor/spec.md @@ -0,0 +1,10 @@ +# Capability Spec: executor + +## ADDED Requirements + +### Requirement: executor responsibilities for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +This role MUST define and deliver its scoped outputs with evidence. + +#### Scenario: Role executes assigned scope +- **WHEN** the role begins execution for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +- **THEN** it follows `tasks.md` and records evidence for completion diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/tasks.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/tasks.md new file mode 100644 index 0000000..149858a --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/executor/tasks.md @@ -0,0 +1,32 @@ +# executor tasks + +## 1. Spec + +- [ ] 1.1 Audit the current extension against the requested brief and mark which behaviors already ship before editing code. +- [ ] 1.2 Freeze the touched-file list before coding starts: `logo.png`, extension asset path(s), `package.json`, installer/tests/docs, and only the runtime files that remain missing after audit. + +## 2. Tests + +- [ ] 2.1 Add or update focused tests for the packaged icon asset and any runtime delta that survives the audit. +- [ ] 2.2 Define the smoke path: local install, installed payload inspection, and focused Node test execution. + +## 3. Implementation + +- [ ] 3.1 Ship the branded icon lane first. +- [ ] 3.2 Apply runtime/provider changes only for missing deltas proven by the audit. +- [ ] 3.3 Sync mirrored sources, docs, and focused verification evidence before handoff. + +## 4. Checkpoints + +- [ ] [E1] READY - Execution start checkpoint + +## 5. Collaboration + +- [ ] 5.1 Owner recorded this lane before edits. +- [ ] 5.2 Record joined agents / handoffs, or mark `N/A` when solo. + +## 6. Cleanup + +- [ ] 6.1 If this lane owns finalization, run `gx branch finish --branch agent/codex/vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --base main --via-pr --wait-for-merge --cleanup`. +- [ ] 6.2 Record PR URL + final `MERGED` state in the handoff. +- [ ] 6.3 Confirm sandbox cleanup (`git worktree list`, `git branch -a`) or append `BLOCKED:` and stop. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/kickoff-prompts.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/kickoff-prompts.md new file mode 100644 index 0000000..51058f0 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/kickoff-prompts.md @@ -0,0 +1,108 @@ +# Kickoff Prompts (Copy/Paste) + +Use these only when the coordinator decides wave-splitting is needed. + +## Prompt A — Wave A (Primary lane) + +```text +You own Wave-A for plan `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` in /home/deadpool/Documents/codex-lb. + +Goal: +Implement the assigned Wave-A scope and return verification evidence. + +Hard constraints: +- You are not alone in the codebase; do not revert others' work. +- Stay in your owned files/modules only. +- Record explicit handoff notes for integration. + +Owned scope: +- + +Verification: +- + +Handoff format: +- Files changed +- Behavior touched +- Verification outputs +- Risks/follow-ups +``` + +## Prompt B — Wave B (Secondary lane) + +```text +You own Wave-B for plan `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` in /home/deadpool/Documents/codex-lb. + +Goal: +Implement the assigned Wave-B scope and return verification evidence. + +Hard constraints: +- You are not alone in the codebase; do not revert others' work. +- Stay in your owned files/modules only. +- Record explicit handoff notes for integration. + +Owned scope: +- + +Verification: +- + +Handoff format: +- Files changed +- Behavior touched +- Verification outputs +- Risks/follow-ups +``` + +## Prompt C — Wave C (Secondary lane) + +```text +You own Wave-C for plan `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` in /home/deadpool/Documents/codex-lb. + +Goal: +Implement the assigned Wave-C scope and return verification evidence. + +Hard constraints: +- You are not alone in the codebase; do not revert others' work. +- Stay in your owned files/modules only. +- Record explicit handoff notes for integration. + +Owned scope: +- + +Verification: +- + +Handoff format: +- Files changed +- Behavior touched +- Verification outputs +- Risks/follow-ups +``` + +## Prompt D — Integrator lane + +```text +You are the integrator for plan `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` in /home/deadpool/Documents/codex-lb. + +Goal: +Integrate completed waves, resolve conflicts, run final verification, and prepare rollout/cutover notes. + +Hard constraints: +- You are not alone in the codebase; do not revert others' work. +- Preserve safety-critical behavior unless explicitly planned and tested. +- Keep final output evidence-first. + +Owned scope: +- integration glue and shared touchpoints +- final validation + handoff summary + +Verification: +- + +Final report: +- Files changed +- Integration decisions +- Verification outputs +- Remaining risks +``` diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/phases.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/phases.md new file mode 100644 index 0000000..636fe2a --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/phases.md @@ -0,0 +1,35 @@ +# Plan Phases: agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 + +One entry per phase. Checkbox marks map to: `x` = completed, `>` = in progress, space = pending. +Indented sub-bullets are optional metadata consumed by the Plans UI: + +- `session`: which agent kind runs the phase (`codex` / `claude`). +- `checkpoints`: comma-separated role checkpoint ids delivered within the phase. +- `summary`: one short sentence rendered under the phase title. + +One phase is intended to fit into a single Codex or Claude session task. + +- [x] [PH01] Audit shipped Active Agents behavior and capture the follow-up scope + - session: codex + - checkpoints: P1 + - summary: Confirm the real gap list: root `logo.png` exists, installer copies only extension folders, and grouped state/lock fallback behavior already ships. + +- [ ] [PH02] Decide icon packaging and source-of-truth rules + - session: codex + - checkpoints: A1, C1 + - summary: Choose whether to keep mirrored `vscode/` + `templates/` sources or collapse them, and lock the icon-asset strategy. + +- [ ] [PH03] Ship branding plus only the missing runtime delta + - session: codex + - checkpoints: E1 + - summary: Add the branded icon first, then touch `extension.js` or `session-schema.js` only if the audit proves a requested runtime behavior is still absent. + +- [ ] [PH04] Refresh docs and focused regression coverage + - session: codex + - checkpoints: W1, V1 + - summary: Update install/docs language, add payload/runtime tests, and collect operator-facing evidence. + +- [ ] [PH05] Validate and finish the lane + - session: codex + - checkpoints: E1, V1 + - summary: Run focused verification, validate OpenSpec artifacts, then finish with `gx branch finish --via-pr --wait-for-merge --cleanup`. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/.openspec.yaml b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/.openspec.yaml new file mode 100644 index 0000000..b91f195 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/.openspec.yaml @@ -0,0 +1,8 @@ +schema: 1 +plan: agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 +role: planner +status: draft +artifacts: + proposal: proposal.md + tasks: tasks.md + spec: specs/planner/spec.md diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/README.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/README.md new file mode 100644 index 0000000..4693d43 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/README.md @@ -0,0 +1,11 @@ +# planner + +Role workspace for `planner`. + +Default artifacts: +- `.openspec.yaml` +- `proposal.md` +- `tasks.md` +- `specs//spec.md` + +Use this folder for role notes, artifacts, and status updates. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/plan.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/plan.md new file mode 100644 index 0000000..591c55f --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/plan.md @@ -0,0 +1,184 @@ +# ExecPlan: agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 + +This ExecPlan is a living document. Keep `Progress`, `Surprises & Discoveries`, `Decision Log`, and `Outcomes & Retrospective` current as work proceeds. + +Follow repository guidance in `openspec/plan/PLANS.md`. + +## Purpose / Big Picture + +After this plan lands, the `GitGuardex Active Agents` VS Code extension shows GitGuardex branding instead of the default placeholder icon, and any follow-up runtime work is limited to gaps that still exist after inspecting the shipped extension. Operators should be able to install the local extension, reload VS Code, and see the branded icon on the extension details page without losing the current `ACTIVE AGENTS` / `CHANGES` tree behavior. + +## Progress + +- [x] (2026-04-22 14:10Z) Capture initial scope, acceptance criteria, and the real packaging/runtime constraints from the current repo. +- [x] (2026-04-22 14:18Z) Draft architecture/tradeoff plan and verification strategy for branding plus delta-only runtime follow-up. +- [x] (2026-04-22 14:24Z) Publish execution-ready handoff with explicit lanes, files, and verification steps. + +## Surprises & Discoveries + +- Observation: The repo already has a root `logo.png`, but the local installer copies only `vscode/guardex-active-agents/` or `templates/vscode/guardex-active-agents/`, so the extension details page cannot see the root asset today. + Evidence: `logo.png`, `scripts/install-vscode-active-agents-extension.js` +- Observation: The Active Agents extension already implements grouped activity buckets, repo `CHANGES`, lock-aware change rows, and `AGENT.lock` fallback discovery, so the requested runtime brief overstates the missing scope. + Evidence: `vscode/guardex-active-agents/README.md`, `vscode/guardex-active-agents/session-schema.js`, `openspec/changes/agent-codex-vscode-working-agents-groups-2026-04-22-09-05/specs/vscode-working-agents-groups/spec.md` +- Observation: Extension sources are duplicated under both `vscode/guardex-active-agents/` and `templates/vscode/guardex-active-agents/`, and tests still reference the template copy in places. + Evidence: `vscode/guardex-active-agents/*`, `templates/vscode/guardex-active-agents/*`, `test/vscode-active-agents-session-state.test.js` + +## Decision Log + +- Decision: Use OpenSpec plan workspace as source of truth for this planning cycle. + Rationale: Keeps planning artifacts in-repo and reviewable. + Date/Author: 2026-04-22 / codex +- Decision: Prefer an in-place follow-up on the existing extension surfaces instead of a provider rewrite. + Rationale: The branding gap is real, but most runtime items from the user brief are already present; a rewrite would duplicate shipped behavior and widen risk. + Date/Author: 2026-04-22 / codex +- Decision: Ship the branded icon from inside the extension payload, sourced from the existing repo `logo.png`. + Rationale: VS Code extension manifest icons must resolve from the installed extension directory; referencing the repo root would not survive local install. + Date/Author: 2026-04-22 / codex + +## Outcomes & Retrospective + +Plan draft is ready. Next execution should start with icon packaging and source-parity decisions, not with runtime rewrites. + +## Context and Orientation + +- `logo.png`: existing brand source at the repo root. +- `vscode/guardex-active-agents/package.json`: manifest surface that needs `icon` metadata for the extension details page. +- `vscode/guardex-active-agents/extension.js`: Source Control tree provider, actions, watchers, and repo/session rendering. +- `vscode/guardex-active-agents/session-schema.js`: session-state parsing, repo-root change derivation, lock metadata, and `AGENT.lock` fallback. +- `templates/vscode/guardex-active-agents/*`: mirrored extension source still used by tests and installer fallback paths. +- `scripts/install-vscode-active-agents-extension.js`: local install helper that copies the extension source tree into `~/.vscode/extensions`. +- `test/vscode-active-agents-session-state.test.js`: focused regression surface for session schema behavior, install payload checks, and extension activation. +- Prior OpenSpec changes worth preserving rather than redoing: + - `openspec/changes/agent-codex-vscode-active-agents-extension-2026-04-21-17-38/` + - `openspec/changes/agent-codex-vscode-active-agents-scm-provider-layout-2026-04-21-23-22/` + - `openspec/changes/agent-codex-vscode-working-agents-groups-2026-04-22-09-05/` + - `openspec/changes/agent-codex-vscode-active-agents-live-worktree-telem-2026-04-22-13-43/` + - `openspec/changes/agent-codex-vscode-tree-lock-decorations-clean-2026-04-22-11-09/` + +## RALPLAN-DR Summary + +### Principles + +- Make the smallest change that fixes the real operator-visible gap. +- Ship assets from the installed extension payload, not repo-root-only paths. +- Preserve already-landed Active Agents behavior and avoid duplicate implementations. +- Keep mirrored extension surfaces consistent unless the change intentionally collapses them. +- Prove the work with focused extension/install validation instead of repo-wide noise. + +### Decision Drivers + +- The extension details page branding gap is user-visible now. +- The current code already satisfies much of the requested runtime brief. +- Installer/tests and duplicated source trees can drift unless the plan names them explicitly. + +### Viable Options + +1. Patch the current extension in place and keep the runtime scope delta-only. Preferred. + Pros: smallest blast radius, reuses current tests and installer flow, fixes the visible gap first. + Cons: requires discipline to keep `vscode/` and `templates/` aligned. +2. Collapse to a single canonical extension source before adding branding/runtime follow-up. + Pros: removes duplication risk long-term. + Cons: larger refactor than the current ask, higher chance of unrelated drift, not necessary to ship the branding fix. +3. Add installer-time asset injection without touching extension sources. + Pros: avoids editing duplicate source trees. + Cons: hides the real manifest/package truth, complicates tests, and makes the extension source misleading. + +## ADR + +### Decision + +Use an in-place follow-up on the existing Active Agents extension, package a copy of `logo.png` inside the installable extension tree, and gate any runtime changes behind an audit that proves the behavior is still missing. + +### Drivers + +- Visible branding defect in VS Code extension details. +- Existing runtime functionality already covers grouped states, repo changes, and lock/fallback behavior. +- Installer/tests depend on the extension folder contents, not on the repo root. + +### Alternatives Considered + +- Canonicalize to one source tree first. +- Inject the icon only at install time. + +### Why Chosen + +It fixes the visible defect fast, keeps the diff reviewable, and avoids reopening already-merged runtime work. + +### Consequences + +- Execution must explicitly keep the mirrored `vscode/` and `templates/` trees in sync, or collapse them intentionally in the same change. +- Runtime edits may end up being no-ops if the audit shows the requested items already ship. + +### Follow-ups + +- If mirrored source drift keeps recurring after this lane, open a separate change to canonicalize the extension source tree. + +## Plan of Work + +1. Audit current behavior against the requested brief. + Confirm exactly which requested items already exist in `package.json`, `extension.js`, `session-schema.js`, prior OpenSpec specs, and the installer/test surfaces. Convert the brief into a delta list before code edits. +2. Package the branded icon. + Choose the asset path inside `vscode/guardex-active-agents/` and `templates/vscode/guardex-active-agents/`, copy/derive from `logo.png`, and wire the manifest `icon` field so the local install payload carries the brand into VS Code. +3. Apply runtime delta only if still missing. + Touch `extension.js`, `session-schema.js`, or install/test/docs files only for behaviors that remain absent after audit. Keep current grouped buckets, `CHANGES`, lock-awareness, and `AGENT.lock` fallback intact. +4. Sync docs and tests. + Update extension README/root README install guidance if needed, and extend focused test coverage to prove icon packaging plus any runtime delta. +5. Validate and finish. + Run focused tests plus OpenSpec validation, then commit with Lore trailers and finish through `gx branch finish --via-pr --wait-for-merge --cleanup`. + +## Concrete Steps + +List exact commands with working directory and short expected outcomes. + + cd /home/deadpool/Documents/recodee/gitguardex/.omx/agent-worktrees/agent__codex__vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 + rg -n "icon|loading~spin|AGENT.lock|active-sessions|CHANGES" vscode/guardex-active-agents templates/vscode/guardex-active-agents test/vscode-active-agents-session-state.test.js + # Confirm the delta list before editing code. + + cd /home/deadpool/Documents/recodee/gitguardex/.omx/agent-worktrees/agent__codex__vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 + node --test test/vscode-active-agents-session-state.test.js + # Focused extension/install regression coverage. + + cd /home/deadpool/Documents/recodee/gitguardex/.omx/agent-worktrees/agent__codex__vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 + openspec validate agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --type change --strict + openspec validate --specs + # Validate the new change artifacts and repo specs. + + cd /home/deadpool/Documents/recodee/gitguardex/.omx/agent-worktrees/agent__codex__vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 + gx branch finish --branch agent/codex/vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --base main --via-pr --wait-for-merge --cleanup + # Commit, push, PR, merge wait, and sandbox prune. + +## Validation and Acceptance + +- Installed extension directory contains the branded icon asset and manifest metadata. +- Reloaded VS Code shows the branded icon on the extension details page instead of the generic placeholder. +- Existing `ACTIVE AGENTS` / `CHANGES` grouped behavior still works; if runtime code changed, focused tests cover the new branch. +- `vscode/` and `templates/` extension sources either remain behaviorally synced or are intentionally collapsed with installer/tests updated in the same change. +- `openspec validate ... --strict` and `openspec validate --specs` pass before finish. + +## Idempotence and Recovery + +- Re-running the installer should prune the older local extension copy and reinstall the current version with the branded asset. +- If the runtime audit finds no remaining missing behavior, the implementation may stop after the icon/docs/tests work without forcing extra provider changes. +- If mirrored source updates become too error-prone mid-flight, pause and either collapse to one canonical source in the same change or split that refactor into a follow-up change before mixing in runtime edits. + +## Artifacts and Notes + +- Branding source: `logo.png` +- Install path: `scripts/install-vscode-active-agents-extension.js` +- Extension sources: `vscode/guardex-active-agents/*`, `templates/vscode/guardex-active-agents/*` +- Focused tests: `test/vscode-active-agents-session-state.test.js` +- Prior spec anchors: + - `openspec/changes/agent-codex-vscode-active-agents-extension-2026-04-21-17-38/specs/vscode-active-agents-extension/spec.md` + - `openspec/changes/agent-codex-vscode-working-agents-groups-2026-04-22-09-05/specs/vscode-working-agents-groups/spec.md` + - `openspec/changes/agent-codex-vscode-tree-lock-decorations-clean-2026-04-22-11-09/specs/vscode-active-agents-extension/spec.md` + +## Interfaces and Dependencies + +- VS Code extension manifest contract: `package.json` `icon` path must point at a bundled asset. +- Installer contract: `fs.cpSync(sourceDir, targetDir, ...)` copies only the selected extension directory tree. +- Session-schema contract: runtime follow-up must preserve exported parsing/derivation behavior expected by `test/vscode-active-agents-session-state.test.js`. +- OpenSpec contract: change spec stays under `specs/vscode-active-agents-extension/spec.md`; plan workspace remains the execution source of truth. + +## Revision Note + +- 2026-04-22 14:24Z: Replaced scaffold with an execution-ready plan for Active Agents branding plus delta-only runtime follow-up. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/proposal.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/proposal.md new file mode 100644 index 0000000..acbec26 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/proposal.md @@ -0,0 +1,15 @@ +# Proposal: planner (agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05) + +## Why + +Summarize why this role's work is required for plan `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`. + +## What Changes + +- [ ] List the planned role-specific changes + +## Impact + +- Scope: +- Risks: +- Dependencies: diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/specs/planner/spec.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/specs/planner/spec.md new file mode 100644 index 0000000..79de43e --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/specs/planner/spec.md @@ -0,0 +1,10 @@ +# Capability Spec: planner + +## ADDED Requirements + +### Requirement: planner responsibilities for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +This role MUST define and deliver its scoped outputs with evidence. + +#### Scenario: Role executes assigned scope +- **WHEN** the role begins execution for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +- **THEN** it follows `tasks.md` and records evidence for completion diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/tasks.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/tasks.md new file mode 100644 index 0000000..7ab1cbb --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/planner/tasks.md @@ -0,0 +1,32 @@ +# planner tasks + +## 1. Spec + +- [x] 1.1 Define planning principles, decision drivers, and viable options for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`. +- [x] 1.2 Capture scope, constraints, and acceptance criteria in `summary.md`, `planner/plan.md`, and the change spec. + +## 2. Tests + +- [x] 2.1 Define focused verification for the execution lane: installer payload checks, `node --test test/vscode-active-agents-session-state.test.js`, and OpenSpec validation. +- [x] 2.2 Validate that this planning lane only needs focused artifact checks now; runtime tests remain queued for execution. + +## 3. Implementation + +- [x] 3.1 Produce the initial RALPLAN-DR plan draft. +- [ ] 3.2 Integrate Architect/Critic feedback into revised plan iterations if a review pass is requested. +- [x] 3.3 Publish execution lanes covering branding, mirrored-source parity, delta-only runtime work, docs/tests, and finish flow. + +## 4. Checkpoints + +- [x] [P1] READY - Initial planning draft checkpoint recorded in `summary.md`, `phases.md`, and `planner/plan.md`. + +## 5. Collaboration + +- [x] 5.1 Owner recorded this lane before edits. +- [x] 5.2 N/A - solo planning lane; no joined agents. + +## 6. Cleanup + +- [ ] 6.1 If this lane owns finalization, run `gx branch finish --branch agent/codex/vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --base main --via-pr --wait-for-merge --cleanup`. +- [ ] 6.2 Record PR URL + final `MERGED` state in the handoff. +- [ ] 6.3 Confirm sandbox cleanup (`git worktree list`, `git branch -a`) or append `BLOCKED:` and stop. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/summary.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/summary.md new file mode 100644 index 0000000..75ab23e --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/summary.md @@ -0,0 +1,20 @@ +# Plan Summary: agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 + +- **Mode:** ralplan +- **Status:** draft ready for execution + +## Context + +- User request: create the plan and markdown task files now for the GitGuardex Active Agents extension follow-up. +- Observed branding gap: the VS Code extension details page still shows the default placeholder icon, while the repo already has a root `logo.png`. +- Current implementation reality: grouped state buckets, repo `CHANGES`, lock-aware rows, and `AGENT.lock` fallback already exist in the extension code and prior change specs. +- Packaging constraint: `scripts/install-vscode-active-agents-extension.js` copies only `vscode/guardex-active-agents/` (falling back to `templates/vscode/guardex-active-agents/`), so any icon must live inside the copied extension tree. + +## Desired Outcome + +- Produce one execution-ready board that ships the branded icon, audits the requested runtime brief against current behavior, and limits code changes to missing deltas. + +## Scope Boundaries + +- In scope: extension icon packaging, `package.json` icon metadata, mirrored extension-source parity, runtime delta audit, focused docs/tests, OpenSpec validation, and finish-flow cleanup. +- Out of scope until audit proves otherwise: rewriting the tree provider, re-adding already-landed group/change/lock features, or broad repo-wide test churn. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/.openspec.yaml b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/.openspec.yaml new file mode 100644 index 0000000..669eb22 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/.openspec.yaml @@ -0,0 +1,8 @@ +schema: 1 +plan: agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 +role: verifier +status: draft +artifacts: + proposal: proposal.md + tasks: tasks.md + spec: specs/verifier/spec.md diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/README.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/README.md new file mode 100644 index 0000000..762669d --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/README.md @@ -0,0 +1,11 @@ +# verifier + +Role workspace for `verifier`. + +Default artifacts: +- `.openspec.yaml` +- `proposal.md` +- `tasks.md` +- `specs//spec.md` + +Use this folder for role notes, artifacts, and status updates. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/proposal.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/proposal.md new file mode 100644 index 0000000..abd72b1 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/proposal.md @@ -0,0 +1,15 @@ +# Proposal: verifier (agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05) + +## Why + +Summarize why this role's work is required for plan `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`. + +## What Changes + +- [ ] List the planned role-specific changes + +## Impact + +- Scope: +- Risks: +- Dependencies: diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/specs/verifier/spec.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/specs/verifier/spec.md new file mode 100644 index 0000000..3ac0f01 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/specs/verifier/spec.md @@ -0,0 +1,10 @@ +# Capability Spec: verifier + +## ADDED Requirements + +### Requirement: verifier responsibilities for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +This role MUST define and deliver its scoped outputs with evidence. + +#### Scenario: Role executes assigned scope +- **WHEN** the role begins execution for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +- **THEN** it follows `tasks.md` and records evidence for completion diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/tasks.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/tasks.md new file mode 100644 index 0000000..ebaedb0 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/verifier/tasks.md @@ -0,0 +1,32 @@ +# verifier tasks + +## 1. Spec + +- [ ] 1.1 Define the validation matrix for icon packaging, installed payload contents, preserved tree behavior, and finish evidence. +- [ ] 1.2 Validate success/failure conditions and evidence requirements before merge. + +## 2. Tests + +- [ ] 2.1 Execute focused verification commands and collect outputs, including `node --test test/vscode-active-agents-session-state.test.js`. +- [ ] 2.2 Validate idempotency/re-run behavior for install and cleanup flows plus any runtime error-path handling touched by the change. + +## 3. Implementation + +- [ ] 3.1 Verify completed work against the acceptance criteria in `specs/vscode-active-agents-extension/spec.md`. +- [ ] 3.2 Produce pass/fail findings with concrete evidence links. +- [ ] 3.3 Publish final verification sign-off or a blocker report. + +## 4. Checkpoints + +- [ ] [V1] READY - Verification checkpoint + +## 5. Collaboration + +- [ ] 5.1 Owner recorded this lane before edits. +- [ ] 5.2 Record joined agents / handoffs, or mark `N/A` when solo. + +## 6. Cleanup + +- [ ] 6.1 If this lane owns finalization, run `gx branch finish --branch agent/codex/vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --base main --via-pr --wait-for-merge --cleanup`. +- [ ] 6.2 Record PR URL + final `MERGED` state in the handoff. +- [ ] 6.3 Confirm sandbox cleanup (`git worktree list`, `git branch -a`) or append `BLOCKED:` and stop. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/.openspec.yaml b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/.openspec.yaml new file mode 100644 index 0000000..75fe0c1 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/.openspec.yaml @@ -0,0 +1,8 @@ +schema: 1 +plan: agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 +role: writer +status: draft +artifacts: + proposal: proposal.md + tasks: tasks.md + spec: specs/writer/spec.md diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/README.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/README.md new file mode 100644 index 0000000..afb0f0b --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/README.md @@ -0,0 +1,11 @@ +# writer + +Role workspace for `writer`. + +Default artifacts: +- `.openspec.yaml` +- `proposal.md` +- `tasks.md` +- `specs//spec.md` + +Use this folder for role notes, artifacts, and status updates. diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/proposal.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/proposal.md new file mode 100644 index 0000000..b1a1928 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/proposal.md @@ -0,0 +1,15 @@ +# Proposal: writer (agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05) + +## Why + +Summarize why this role's work is required for plan `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05`. + +## What Changes + +- [ ] List the planned role-specific changes + +## Impact + +- Scope: +- Risks: +- Dependencies: diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/specs/writer/spec.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/specs/writer/spec.md new file mode 100644 index 0000000..f508093 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/specs/writer/spec.md @@ -0,0 +1,10 @@ +# Capability Spec: writer + +## ADDED Requirements + +### Requirement: writer responsibilities for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +This role MUST define and deliver its scoped outputs with evidence. + +#### Scenario: Role executes assigned scope +- **WHEN** the role begins execution for `agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05` +- **THEN** it follows `tasks.md` and records evidence for completion diff --git a/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/tasks.md b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/tasks.md new file mode 100644 index 0000000..64a8248 --- /dev/null +++ b/openspec/plan/agent-codex-vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05/writer/tasks.md @@ -0,0 +1,32 @@ +# writer tasks + +## 1. Spec + +- [ ] 1.1 Validate the docs audience: operators installing the local VS Code companion and developers maintaining the duplicated extension sources. +- [ ] 1.2 Keep terminology consistent across plan artifacts, extension README copy, and any root README changes. + +## 2. Tests + +- [ ] 2.1 Define a docs verification checklist covering icon packaging, install commands, reload guidance, and scope notes about runtime deltas. +- [ ] 2.2 Validate command/help text examples against the actual installer and finish flow. + +## 3. Implementation + +- [ ] 3.1 Update `vscode/guardex-active-agents/README.md` and any root README/install guidance touched by the branding or runtime delta. +- [ ] 3.2 Add or refine operator examples for install, reload, and expected branded result. +- [ ] 3.3 Publish a final docs change summary with references. + +## 4. Checkpoints + +- [ ] [W1] READY - Docs update checkpoint + +## 5. Collaboration + +- [ ] 5.1 Owner recorded this lane before edits. +- [ ] 5.2 Record joined agents / handoffs, or mark `N/A` when solo. + +## 6. Cleanup + +- [ ] 6.1 If this lane owns finalization, run `gx branch finish --branch agent/codex/vscode-active-agents-logo-and-runtime-pl-2026-04-22-16-05 --base main --via-pr --wait-for-merge --cleanup`. +- [ ] 6.2 Record PR URL + final `MERGED` state in the handoff. +- [ ] 6.3 Confirm sandbox cleanup (`git worktree list`, `git branch -a`) or append `BLOCKED:` and stop.