# Draft: openspec-cleanup

## Cross-Reference: Git Tags vs openspec Batches

### Archived Stub Files — Tag Verification

| Stub File | Claims Version | Actual Tag | Verdict |
|---|---|---|---|
| `v1.13.12-skills-audit.md` (57B) | v1.13.12 | `v1.13.14-skills-audit` | **WRONG** — off by 2 versions |
| `v1.13.15-codecontext-synth.md` (62B) | v1.13.15 | `v1.13.15-codecontext-synth` | ✅ correct |
| `v1.13.17-cross-repo-reads.md` (61B) | v1.13.17 | `v1.13.17-cross-repo-reads` | ✅ correct |
| `v1.13.18-codecontext-file-path.md` (66B) | v1.13.18 | `v1.13.18-codecontext-file-path` | ✅ correct |
| `v1.13.20-drop-legacy-cols.md` (61B) | v1.13.20 | `v1.13.20-drop-legacy-cols` | ✅ correct |
| `v1.14-outer-loop.md` (52B) | v1.14 | `v1.14.0-outer-loop` | ⚠️ close (1.14 → 1.14.0) |
| `v1.14.1-mcp-poc.md` (51B) | v1.14.1 | `v1.14.1-mcp-poc` | ✅ correct |
| `v1.14.x-html-artifact-panes.md` (63B) | v1.14.x | `v1.13.19-html-artifact-panes` | **WRONG** — shipped as 1.13.19 |
| `v1.15-mcp-multi.md` (51B) | v1.15 | `v1.15.0-mcp-multi` | ⚠️ close (1.15 → 1.15.0) |
| `v2.0-boocoder.md` (49B) | v2.0 | `v2.0.0` | ⚠️ close (2.0 → 2.0.0) |
| `v2.2-paseo-providers.md` (222B) | v2.2 | `v2.2-paseo-providers` | ✅ correct |

### Archived Folder Entries — Tag Verification

| Archived Folder | Git Tag(s) | Status |
|---|---|---|
| `agent-status-normalize/` | `v2.7.6-agent-status-normalize` | ✅ shipped |
| `claude-sdk-sessionstore/` | `v2.7.5-claude-sdk-sessionstore` | ✅ shipped |
| `contracts-ssot/` | `v2.7.13-contracts-ssot` | ✅ shipped |
| `license-debt-mit/` | `v2.7.0-mit` | ✅ shipped |
| `mistake-tracker-file-ledger/` | `v2.7.4-mistake-tracker-ledger` | ✅ shipped (slug differs slightly) |
| `orchestrator/` | `v2.7.17-orchestrator` | ✅ shipped |
| `sampling-streamjson-tokens/` | `v2.7.3-sampling-streamjson-tokens` | ✅ shipped |
| `v2-3-provider-lifecycle/` | `v2.5.4-*` through `v2.5.13-*` | ✅ shipped (diff version numbering) |
| `v2-6-persistent-agent-sessions/` | `v2.6.4-*`, `v2.6.8-*` | ✅ shipped |
| `write-edit-robustness/` | `v2.7.1-write-edit-robustness` | ✅ shipped |

### Misplaced Proposals in Archived/

| 2026-06-07 Folder | Git Tag? | Actually Shipped? | Should Be |
|---|---|---|---|
| `2026-06-07-boocontext/` | **None** | No | `changes/boocontext/` (partly shipped in v2.8.0) |
| `2026-06-07-eval-sandbox-agent-runtime/` | **None** | No | Merge into `changes/import-*` |
| `2026-06-07-hybrid-workflow-engine/` | **None** | No | Merge into `changes/orchestrator-flow-advanced/` |
| `2026-06-07-memory-context-engineering/` | **None** | No | Merge into `changes/memory-context/` |
| `2026-06-07-port-audit-parlant-patterns/` | **None** | No | Merge into `changes/add-behavioral-engine/` |

## Active Batches — All Uncommitted, All Unshipped

All 22 active batches (changes/*/) have **zero** git tags or commits referencing them. Every batch was created locally on 2026-06-07 and exists only on the filesystem.

## High-Value Prioritization (for Implementation Plan)

### Tier 1: Ship in Current Batch (small scope, high value)
1. **openspec-cleanup** — Fix folder structure: delete stubs, move misplaced proposals, add .openspec.yaml, populate config.yaml
2. **llama-cache-and-spec** — KV cache quantization + ngram speculative decoding (llama-server arg changes only)
3. **results-page** — New `/results` route, uses existing API endpoints
4. **token-analyzer-ui** — New `/analytics` route, uses existing DB data

### Tier 2: Current+ Batch (moderate scope)
5. **enhanced-file-panel** — Side-by-side diff, inline comments, in-browser editing
6. **pty-enhancements** — Exit notifications, session metadata, X-Agent-Flags

### Tier 3: Next Batch (larger scope, foundation work)
7. **memory-v2-hybrid-search** — BM25 + local embedding hybrid search
8. **orchestrator-flow-advanced** — Trigger rules, conditional branching, HITL
9. **omo-paseo-bridge** — OMO subagent visibility in Paseo

### Tier 4: Future Batches (speculative / big effort)
10. **add-behavioral-engine** / **audit-harness-integration** / **import-llm-evaluator** / **import-pregel-engine** — Big integration efforts
11. **code-intelligence-upgrade** / **dev-workflow** / **conductor-evolution** — Platform work
12. **plugin-platform** / **ui-overhaul** / **add-3tier-memory** / **add-type-inject-mcp** — Future

## Scope Boundaries for This Plan

**IN SCOPE:**
- Delete 11 stub files from archived/
- Move 5 misplaced 2026-06-07 proposals from archived/ to changes/ (with dedup)
- Add missing .openspec.yaml to 6 active batches
- Populate openspec/config.yaml with project context
- Implement Tier 1-2 high-value batches:
  - llama-cache-and-spec (llama-server args)
  - results-page (new route, frontend)
  - token-analyzer-ui (new route, frontend + backend)
  - enhanced-file-panel (frontend changes)
  - pty-enhancements (backend changes)

**OUT OF SCOPE:**
- Tier 3-4 batches (future planning)
- Full behavioral engine or Pregel state machine integration
- Plugin platform architecture