Skip to content

execution-plan.md

Latest commit

 

History

History
191 lines (144 loc) · 7.64 KB

execution-plan.md

File metadata and controls

191 lines (144 loc) · 7.64 KB
Raw

Execution Plan

Last updated: 2026-02-26 (post-M1 normalization) Primary tracker: masterchecklist.md Backlog source: TODO_JetBrains.md

1. Governance and Constraints

  • Use smallest reversible change sets.
  • Preserve security boundaries and approval safeguards.
  • Preserve or improve tests and coverage for touched areas.
  • Never push without explicit user instruction.
  • Keep docs and checklist in sync with code reality at each milestone close.

2. Current State

  • Canonical planning docs are in place and synchronized.
  • M2 (protocol + approvals technical debt) is complete.
  • M5 documentation/legal tranche is now partially complete:
    • NOTICE + license validation output
    • privacy/security/support disclosure docs
    • README/changelog/quick-start/settings guide refresh
  • M6 post-release operations documentation is complete:
    • monitoring playbook
    • roadmap
    • release retrospective template/scheduling guidance
  • M1 backlog normalization is complete:
    • SSOT declared as TODO_JetBrains.md
    • parity completion checklist contradictions corrected
    • docs index aligned to SSOT
  • Next engineering priorities are M3/M4 tasks that can be executed non-interactively.

3. Phase Plan

Phase A: Standardization Gate (complete)

  1. Generate masterchecklist.md.
  2. Generate execution-plan.md.
  3. Seed .AGENTS/todo.md and .AGENTS/plans/*.
  4. Record actions in docs/standardization-report.md and docs/development-progress.md.

Phase B: Code TODO Batch C2.1-C2.5 (complete)

  1. Implement approval prompt UI path in protocol layer.
  2. Remove auto-approval fallback and return explicit decisions.
  3. Add JSON-RPC method bridge for legacy sendOp calls.
  4. Align tool invocation path to concrete protocol method.
  5. Rework debounce tests to assert behavior with protocol call counting.

Acceptance criteria:

  • No TODO markers remain for C2.1-C2.5 in touched files.
  • Refresh tools/prompts emits real protocol requests.
  • Approval requests show deterministic dialog decision path.
  • New/updated tests pass.

Phase C: Validation (complete)

Required command sequence (Windows):

& "C:\Users\curtp\.codex\scripts\ensure-vcvars.ps1" -Quiet; .\gradlew.bat test --tests "dev.curt.codexjb.ui.ChatPanelDebounceTest"
& "C:\Users\curtp\.codex\scripts\ensure-vcvars.ps1" -Quiet; .\gradlew.bat test --tests "dev.curt.codexjb.ui.ChatPanelTest"
& "C:\Users\curtp\.codex\scripts\ensure-vcvars.ps1" -Quiet; .\gradlew.bat test --tests "dev.curt.codexjb.proto.*"
& "C:\Users\curtp\.codex\scripts\ensure-vcvars.ps1" -Quiet; .\gradlew.bat test

If any test fails:

  1. Fix failing behavior.
  2. Re-run affected tests and full suite.
  3. Update this plan with the root cause and resolution.

Validation outcomes:

  • Targeted tests passed:
    • dev.curt.codexjb.ui.ChatPanelDebounceTest
    • dev.curt.codexjb.ui.ChatPanelTest
    • dev.curt.codexjb.proto.ApprovalsTest
  • Full suite passed: ./gradlew test (run with JDK 21 via JAVA_HOME override).

Phase D: Backlog Sync

  1. Update TODO_JetBrains.md status for completed C tasks.
  2. Update masterchecklist.md M2 statuses.
  3. Append milestone outcome to docs/development-progress.md.

Phase E: Backlog Normalization M1 (complete)

  1. Declare and document TODO_JetBrains.md as SSOT.
  2. Reconcile parity checklist contradictions in VSCODE_PARITY_IMPLEMENTATION.md.
  3. Align docs index references with the active tracker model.

Outcome:

  • M1 checklist items marked complete.
  • Tracker drift reduced between TODO_JetBrains.md, todo-final.md, and docs index.

4. Worktree Execution Model

  • Default: one worktree per task batch under .worktrees/.
  • Because this repo is currently dirty, preserve existing local edits and apply surgical in-place changes for this batch to avoid overwriting unrelated work.
  • After workspace is clean and batched commits exist, resume strict per-task worktree fanout.

5. Exit Criteria for Next Batch

  • Execute next non-blocking milestone batch from M3/M4.
  • Keep masterchecklist.md, execution-plan.md, and .AGENTS/todo.md synchronized.
  • Run verification commands appropriate to touched scope and document outcomes.

6. Batch Notes

Batch: M5 doc/legal readiness tranche (complete for F1.1-F1.5, F4.1-F4.4, F4.6)

Changes:

  • Added NOTICE and docs/license-validation.md.
  • Added PRIVACY.md, SECURITY.md, and SUPPORT.md.
  • Added CHANGELOG.md and todo-release.md.
  • Added docs/quick-start.md and docs/settings-guide.md.
  • Refreshed README.md documentation index and Apache+NOTICE references.
  • Corrected stale JDK guidance in README.md and CONTRIBUTING.md from 17 to 21.

Tracker updates:

  • Marked F1.1-F1.5 complete in TODO_JetBrains.md.
  • Marked F4.1-F4.4 and F4.6 complete in TODO_JetBrains.md.
  • Marked first three M5 checklist items complete in masterchecklist.md.

Batch: M6 post-release operations docs (complete)

Changes:

  • Added docs/operations-playbook.md for monitoring/triage/escalation workflows.
  • Added docs/roadmap.md with near/mid/long-term milestones.
  • Added docs/release-retrospective.md template with scheduling guidance.
  • Confirmed existing issue templates + CONTRIBUTING.md satisfy release guidance task.

Tracker updates:

  • Marked F6.1-F6.4 complete in TODO_JetBrains.md.
  • Marked all M6 checklist items complete in masterchecklist.md.

Batch: F3.5 CI workflow review (complete)

Changes:

  • Reviewed and hardened .github/workflows/ci.yml for release readiness.
  • Added workflow_dispatch, concurrency control, wrapper validation, timeout, and always-on artifact uploads for distributions, tests, and Plugin Verifier reports.
  • Marked F3.5 complete in TODO_JetBrains.md and masterchecklist.md.

Batch: F3.3 full test verification with run log (complete)

Changes:

  • Executed full ./gradlew test on JDK 21.
  • Stored run output at docs/test-runs/gradlew-test-2026-02-26.log.
  • Marked F3.3 complete in TODO_JetBrains.md and masterchecklist.md.

Batch: F3.4 targeted UI tests (complete)

Changes:

  • Added PluginResourcesTest to verify plugin icon files exist and are non-empty.
  • Added ChatPanelTest.startsInIdleDefaultState to cover default toolwindow/chat idle state.
  • Executed focused test run for ChatPanelTest and PluginResourcesTest.
  • Marked F3.4 complete in TODO_JetBrains.md and masterchecklist.md.

Batch: F3.6 manual release process documentation (complete)

Changes:

  • Expanded RELEASING.md with explicit manual release checklist (verification, tagging, Marketplace upload, post-publish checks).
  • Marked F3.6 complete in TODO_JetBrains.md and masterchecklist.md.

Batch: F3.7 performance baseline capture (complete)

Changes:

  • Captured baseline build benchmark into perf.csv.
  • Recorded datapoint for gradlew buildPlugin duration.
  • Marked F3.7 complete in TODO_JetBrains.md and masterchecklist.md.

Batch: F3.1-F3.2 tracker/test-plan closure (complete)

Changes:

  • Closed stale tracker-gap reference task (F3.1) as part of backlog normalization work.
  • Added docs/test-plan.md covering reconnect, approvals, diff apply, and MCP test flows.
  • Marked F3.1 and F3.2 complete in TODO_JetBrains.md and masterchecklist.md.

Batch: F5 marketplace readiness documentation (partial complete)

Changes:

  • Added docs/marketplace-listing.md with listing copy and feature highlights.
  • Added docs/marketplace-compliance-checklist.md with policy/evidence checklist.
  • Added docs/release-cadence.md with alpha/beta/stable cadence and criteria.
  • Added spec.md for pipeline input requirement and scope definition.

Tracker updates:

  • Marked F5.1, F5.3, F5.4, and F5.6 complete in TODO_JetBrains.md.
  • Marked M5 remaining checklist items as in-progress pending manual asset/account validation.