Skip to content

OMP Plan Kit v1.2.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 04 Sep 20:30
· 23 commits to main since this release
v1.2.0
19b1496

OMP Plan Kit v1.2.0

OMP Plan Kit v1.2.0 introduces deterministic batch structural plan validation and bounded repair convergence for Oh My Pi (OMP) plan mode.

Key Changes

1. Batch Structural Plan Validator (src/plan-validator.ts)

  • Enforces canonical Markdown ## sections outside code fences:
    • Required in order: ## Context, ## Approach, ## Verification
    • Optional constrained placement: ## Critical files & anchors (strictly between Approach and Verification), ## Assumptions & contingencies (strictly after Verification)
  • Returns all independent structural errors in a single actionable repair packet, rather than failing fast on the first error.
  • Suppresses dependent errors when sections are missing.
  • Provides stable issue signatures based on sorted code:section pairs, ignoring line-number shifts from cosmetic edits.

2. Bounded Repair Convergence Controller (src/extension.ts)

  • Prevents infinite repair loops with hard, deterministic limits:
    • MAX_FAILED_VALIDATIONS = 3: maximum 3 failed validation attempts per slug;
    • MAX_SAME_HASH_REPEATS = 2: maximum 2 repeated proposals of an unchanged invalid plan;
    • MAX_NO_PROGRESS_ATTEMPTS = 2: maximum 2 consecutive proposals without reducing the issue count;
    • MAX_TURN_PROPOSALS = 4: maximum 4 proposals per user turn across all slugs before turn-blocking ([PLAN_VALIDATOR_TURN_BLOCKED]).
  • Implements a sticky turn latch: preserves rich [PLAN_VALIDATOR_STOPPED] diagnostics in the transcript without invoking ctx.abort() (which would overwrite error messages with a generic abort failure), while ensuring subsequent attempts fail fast in $O(1)$ time without re-running the validator or advisor.
  • Fresh budget on new prompt or native Refine plan: before_agent_start resets turn and cycle blocks.

3. Pipeline Order & Advisor Savings

  • Strict execution order: Preflight (0 tokens) → Plan Validator (0 tokens) → Advisor LLM Review (bounded) → OMP Native Review Overlay.
  • Structurally invalid plans never invoke the LLM advisor, saving 100% of advisor tokens on malformed plans.

4. Batch Tool-Call Semantics Note

  • Documents OMP's batch tool-call execution model: all tool_call hooks execute before any tool writes files to disk.
  • Models must emit write local://<slug>-plan.md and write xd://propose <slug> in separate sequential turns.

Installation

Install as a user-scoped OMP plugin:

omp plugin install github:stgmt/omp-plan-kit#v1.2.0

Verify installation:

omp plugin list --json

Rollback

To rollback to v1.1.0:

omp plugin uninstall omp-plan-kit
omp plugin install github:stgmt/omp-plan-kit#v1.1.0
Assets 3
Loading