Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
115 changes: 1 addition & 114 deletions PLANS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,121 +4,9 @@ plan_schema_version: 2

Use this file for active, blocked, ready-for-closure, or recently completed execution work. The canonical lifecycle is the installed `engineering-workflow` planning reference.

## Active Plan: GPT-6 Model Profiles And Marketplace Release

Status: active
Owner: root
Last Updated: 2026-09-23

### Goal

Update the engineering-workflow model recommendations and optional Codex agent templates for the current GPT-6 family, publish a source release, import it into xeonvs-engineering, and refresh the managed local marketplaces.

### Plan Origin

direct_execution

### Requested Scope

- Support the current models in the relevant source and distribution repositories and release the marketplace update.

### Requirement Traceability

| Requirement | Complete outcome | Source | Work queue | Acceptance or validation | Status |
| --- | --- | --- | --- | --- | --- |
| REQ-001 | Current Codex role mappings, optional agent templates, and model-specific guidance reflect supported GPT-6 models without changing Claude inheritance or user pins. | User request; official OpenAI model catalog and guidance | WQ-01 | Model and effort readback, behavioral/contract tests, aggregate diff review | done |
| REQ-006 | A target upgrade refreshes previously generated Codex agent model profiles when their prior bytes are pristine, while preserving customized files and established opt-in state. | User clarification | WQ-01 | Report/apply/prompt fixture matrix for pristine, customized, and opt-out targets | done |
| REQ-002 | All active source/package version owners and generated bytes agree in a new source release. | User request; repository release contract | WQ-02 | Full release/security gate, package validators, PR merge, annotated tag and release readback | pending |
| REQ-003 | xeonvs-engineering imports exact immutable source bytes and publishes its own release while preserving tgrep-search. | User request; marketplace sync contract | WQ-03 | Recorded provenance/byte verification, catalog tests, release workflow and asset readback | pending |
| REQ-004 | Local Codex and Claude managed marketplaces and workflow installations resolve the published version. | Prior user preference; current release request | WQ-04 | Native CLI update and active version readback | pending |
| REQ-005 | Source and marketplace plans close with durable release evidence. | Workflow lifecycle contract | WQ-05 | Lifecycle check and closure readback | pending |

### Explicit Non-Goals

- Change tgrep-search source or version; overwrite user-pinned models; copy Responses API-only fields into Codex TOML; rewrite published history.

### Constraints

- Preserve role-specific cost, latency, reasoning, and read-only behavior; confirm target slugs and effort levels against current official documentation and actual Codex availability.
- Keep source repository canonical and marketplace distribution generated from a stable annotated source tag.
- Review each logical commit and aggregate release diff; run final full and pre-push security gates.

### Inputs And Sources

- https://developers.openai.com/api/docs/models
- https://developers.openai.com/api/docs/guides/latest-model
- Current `model_profiles.md`, optional agent templates, validators/tests, source and marketplace release contracts.
- Repository audit summary in `/tmp/engineering-model-audit-20260923.json` (generic migration findings are outside this release's model scope).

### User Decisions And Answers

- 2026-09-23: Add support for new models in the relevant repositories and publish the marketplace update.
- 2026-09-23: Retain GPT-5.6 where it is cheaper or useful as a fallback; current API prices support Terra as an availability/evaluation fallback, not the cheaper default for these roles.
- 2026-09-23: Route routine commands and tests through tools without a model worker; upgrade an already configured target's generated model profiles when pristine.
- 2026-09-23: Keep Astra available for unusually complex/high-consequence work; require a concrete rationale and user confirmation before the agent initiates a more expensive Astra worker or saved-profile escalation. An explicit user choice already confirms it.
- Earlier session: after publication, refresh local managed marketplaces and installed skills.

### Completed Baseline State

- [x] Source main is clean at the start; engineering-workflow 0.9.7 and marketplace 1.0.7 are the last completed releases. The source already maps standard/review to Astra, while utility/explorer remain pinned to GPT-5.6 Terra.

### Current Work Queue

- [x] WQ-01 — Implement and validate GPT-6 task routing, profiles, templates, and conservative target migration for REQ-001/REQ-006. `done`
- [ ] WQ-02 — Bump source version, validate, review, merge, tag and release for REQ-002. `in_progress`
- [ ] WQ-03 — Import, validate, review, merge and release xeonvs-engineering for REQ-003. `pending`
- [ ] WQ-04 — Refresh and read back local managed installations for REQ-004. `pending`
- [ ] WQ-05 — Reconcile and close source and marketplace plans for REQ-005. `pending`

### Locked Decisions

- Patch release target is provisionally engineering-workflow 0.9.8 and xeonvs-engineering 1.0.8, subject to current remote tag inspection.
- Route deterministic commands and tests through tools; recommend Luna low for bounded utility semantics and Sol medium for exploration, standard work and routine review. Raise Sol review effort to high only for justified complexity. Reserve Astra high for explicit user choice or confirmed agent-proposed escalation. Preserve supported user pins and explicit Terra fallback.

### Verification

- Official model/effort source and current Codex model availability; focused model-profile tests; source full/release/security checks and plugin validators.
- Marketplace sync provenance and recorded-byte verification, catalog tests, release workflow, checksummed asset, and installed-version readback.

### Latest Validation Results

- 2026-09-23: Official OpenAI model catalog, migration guidance, Codex model selection, and subagent configuration opened; GPT-6 Astra, Sol, Luna and supported low/medium/high efforts verified. Terra's published API pricing ($2 input/$12 output per million tokens) exceeds Luna's and does not undercut Sol's $2 input/$10 output; subscription usage is not inferred from API prices. Source audit produced a bounded report; initial checkout was clean.
- 2026-09-23: Source/package 0.9.8 generated in parity. Full gate passed 9/9 with 266 tests (one skipped); review found and corrected an overly costly routine reviewer effort. Migration tests cover previously opted-in pristine templates, customized model pins, and targets without opt-in. No current upstream 0.9.8 tag or open source PR exists.
- 2026-09-23: Source and generated package quick validation, Codex plugin validation, and strict Claude plugin/marketplace validation passed. Final review incorporated the user's explicit confirmation rule for agent-initiated Astra escalation; full release gate must be rerun on those final bytes.

### Risks And Recovery

- A proposed model may not be exposed in a specific Codex installation. Verify locally before committing template defaults; preserve existing supported pins if unavailable.
- Remote refs may advance during release. Reinspect exact head and tags before push/merge; revalidate changed content.
- Marketplace import may reject candidate bytes or provenance. Stop before publishing and correct only the failed import stage.

### Resume Point

- WQ-02: run final release/security validation and external plugin validators on the reviewed source tree, then commit and publish the source PR/tag/release.

### Plan Fidelity Check

- [x] Full requested source, marketplace, local update, and closure outcomes are mapped to ordered work.
- [x] Constraints, exclusions, sources, decisions, validation, recovery, and exact resume point are recorded.

### Reconciliation Check

- [ ] Final source, marketplace, release, installation, and plan states agree.

### Closure Gate

- [ ] All requirements and queue items are terminal with applicable validation and delivery evidence.

### Post-Close Delivery

- Source and marketplace publication plus local refresh are active work under WQ-02 through WQ-04.

### Handoff Notes

- None.

## Recently Completed

- [x] 2026-09-23: Completed GPT-6 Model Profiles And Marketplace Release; [full archived plan](docs/archive/plans/2026-09-23-gpt-6-model-profiles-and-marketplace-release.md).
- [x] 2026-09-20: Completed Publish Repository Audit Fix 0.9.7; [full archived plan](docs/archive/plans/2026-09-20-publish-repository-audit-fix-0-9-7.md).
- [x] 2026-09-20: Completed Bounded Git-Aware Repository Audit 0.9.7; [full archived plan](docs/archive/plans/2026-09-20-bounded-git-aware-repository-audit-0-9-7.md).
- [x] 2026-09-15: Completed Context Discipline And Bounded Delegation 0.9.6; [full archived plan](docs/archive/plans/2026-09-15-context-discipline-and-bounded-delegation-0-9-6.md).
Expand All @@ -128,4 +16,3 @@ direct_execution
- [x] 2026-09-12: Completed Engineering Workflow 0.9.2 Current-State Efficiency And Agent-Neutral Continuation; [full archived plan](docs/archive/plans/2026-09-12-engineering-workflow-0-9-2-current-state-efficiency-and-agent-neutral-continuati.md).
- [x] 2026-09-05: Completed Engineering Workflow 0.9.1 Astra And Claude Compatibility; [full archived plan](docs/archive/plans/2026-09-05-engineering-workflow-0-9-1-astra-and-claude-compatibility.md).
- [x] 2026-08-29: Completed Engineering Workflow 0.9.0 Ownership-Aware Closure And Review Discipline; [full archived plan](docs/archive/plans/2026-08-29-engineering-workflow-0-9-0-ownership-aware-closure-and-review-discipline.md).
- [x] 2026-08-29: Completed Add Dynamic Release Version Badge.
Loading
Loading