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
22 changes: 5 additions & 17 deletions cocoder/PRIORITIES.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,7 @@ Slim index of active and archived priorities. Open a priority's folder for detai

| Slug | Description | Status | Canon | Owner | Blocked on |
|---|---|---|---|---|---|
| [`v0.1-foundation`](./priorities/v0.1-foundation/README.md) | Ship CoCoder v0.1 — extraction, Oz MVP, docs, public publish | Shipped | **`v0.1.0` tagged + released 2026-05-27** (merged to `main`, CI green). | Bob + founder | **Archival ceremony folded into v0.5 Phase 3** (carryover: ADR-0011 + P-R1/P-R3, then archive). |
| [`v0.5-orchestration-services`](./priorities/v0.5-orchestration-services/README.md) | Cheap/fast-model admin delegation — Oscar offloads wrap/compaction/teardown to bounded services | **Active** | Adoption — engine + launch config (route + boundary) now on `main` (ADR-0009) | Bob + founder | **Sequenced before v0.4** (founder 2026-05-27). **Now launchable from Oz.** Next: Phase 2 (reconcile PR #51) + Phase 3 (adoption + v0.1 carryover/archive). |
| [`v0.5-orchestration-services`](./priorities/v0.5-orchestration-services/README.md) | Cheap/fast-model admin delegation — Oscar offloads wrap/compaction/teardown to bounded services | **Active** | Adoption — engine + launch config (route + boundary) on `main` (ADR-0009) | Bob + founder | **Sequenced before v0.4** (founder 2026-05-27). **Launchable from Oz.** Next: Phase 2 (reconcile PR #51) + Phase 3 (adoption). |

## Draft

Expand All @@ -28,27 +27,16 @@ Slim index of active and archived priorities. Open a priority's folder for detai

## Recently Archived

*(none yet — see `priorities/zArchive/INDEX.md` once populated)*
| Slug | Disposition | Archived | Closeout |
|---|---|---|---|
| [`v0.1-foundation`](./priorities/zArchive/v0.1-foundation/README.md) | Complete — **`v0.1.0` shipped + tagged** | 2026-05-27 | [ADR-0011](./decisions/0011-v0.1-closeout.md) (Refine validations waived; validated by ship + founder real-use). Full list in [`priorities/zArchive/INDEX.md`](./priorities/zArchive/INDEX.md). |

---

## Parser-readable priority entries

> The slim table above is the human-readable index. The headings below feed `extractPriorityEntry()` (the orchestration launch-time priority scanner in `packages/core/lib/fs-utils.mjs`), which matches `## [slug]` headings, not table rows. Update both this section and the table together (per the SSOT rule in `AGENTS.md`).

### [v0.1-foundation](./priorities/v0.1-foundation/README.md)
**Owner:** Bob
**Summary:** Ship CoCoder v0.1 — extraction, Oz MVP, docs, public publish.
**What:** Master priority covering Sub-Playbooks A (foundation + config survival), E (dogfood ramp), B (personas + workspace template), C (Oz MVP), D (docs + dogfood + publish). Currently mid-Refine on A (Milestone M4 audit remediation) with E mid-Expand (Talia orchestration ramp).
**Active task (v0.1 Completion Plan — three remaining items to ship v0.1):** Audit §4 port-first list is CLOSED (12 of 12 ports landed 2026-05-22). Three remaining work items, bundled in [`plans/2026-05-23-v0.1-completion.plan.md`](./priorities/v0.1-foundation/plans/2026-05-23-v0.1-completion.plan.md):

1. **Resolve ticket 0001** — `.command` wrapper restore/retire decision. Cheapest: 10min (retire) or 1-2h (restore). Unblocks 6 skipped tests in `launch-command.test.mjs`.
2. **Sub-Playbook A M4 free-wins cleanup** — M4.5–M4.14 + M4.16–M4.21 (medium-priority audit findings; ~3-5h total). Clean v0.1 audit close.
3. **Sub-Playbook B activation** — Witness/Interrogate/Solve-target for adopter onboarding (workspace template + `cocoder init` + getting-started doc). Multi-session work; the marquee remaining v0.1 deliverable.

**Recommended next-session ordering:** Item 1 → Item 2 (in batches) → Item 3 (Witness/Interrogate only). The completion plan has an appendix with a verbatim resume prompt for fresh-session pickup. **Done = ticket 0001 closed, M4 free-wins all `[x]` or marked deferred-to-v0.2, Sub-Playbook B Witness populated + Status flipped to Active.**
**Status:** Active — Refine. Sub-Playbook F Complete 2026-05-23. Sub-Playbook B Expand merged (PR #33 → `9bf2433`). Sub-Playbook C Expand complete 2026-05-23 (PRs #42–#47 → `f46dcff`). **Sub-Playbook D doc + CI-gate authoring COMPLETE 2026-05-27 (run 1wna3uxq) on branch `v0.1-publish`** (off `main`, Option A disentangle): D-M1.7 ARCHITECTURE verify, D-M1.8 README adopter rewrite, D-M2.1 dogfood-evidence, D-S2 CI gates (gitleaks + LICENSE/NOTICE + faq) all landed; D-S1 internal-proxy + external stranger test both removed from v0.1 scope (founder). **Only the founder release remains:** review `v0.1-publish` → merge to `main` (triggers CI = D-S2 Class A) → tag `v0.1.0` + release notes (PD-Q6=A). v0.4 control-plane work stays on `oz-control-plane-design`. Local Class B checks green; Class A pending CI on `main`. B/C Refines parallel-tracked (founder). See [`priorities/v0.1-foundation/README.md`](./priorities/v0.1-foundation/README.md).

### [v0.2-adapter-extensibility](./priorities/v0.2-adapter-extensibility/README.md)
**Owner:** Bob + founder
**Summary:** Beyond local CLI models — add adapter kinds for cloud APIs and managed remote sessions.
Expand All @@ -71,4 +59,4 @@ Slim index of active and archived priorities. Open a priority's folder for detai
**Owner:** Bob + founder
**Summary:** Let Oscar run faster/cheaper models for repeatable admin work (priority/handoff editing, run wrap-up, teardown) via bounded non-persona orchestration services, instead of spending lead-model context.
**What:** Declarative services (`packages/core/services/*.json`) + two contracts + `lib/services.mjs` (build/validate/execute packet with deterministic git write-audit) + 5 CLI commands + a headless `cursor-agent-service` adapter. 11 services shipped. Services never commit/finalize/supersede (Oscar-only route control); adapter+model configurable per service (`cursor-agent` default). Oz unchanged (ADR-0008 preserved).
**Status:** **Active — engine + launch config (route entry + boundary) landed on `main` (ADR-0009; convergence 2026-05-27). Sequenced BEFORE v0.4 (founder). Launchable from Oz now.** Next: Phase 2 (reconcile PR #51 onto main — general orchestration infra; leave v0.4 design for the v0.4 run) + Phase 3 (adoption: wire services into Oscar's live wrap/teardown flow, prove headless `cursor-agent` end-to-end, verify Oz run-detail surfacing; v0.1 carryover: ADR-0011 + P-R1/P-R3 or waive B/C refines, then archive v0.1-foundation; add ghost-priority/dangling-ADR guard). Full brief in [`priorities/v0.5-orchestration-services/README.md`](./priorities/v0.5-orchestration-services/README.md).
**Status:** **Active — engine + launch config (route entry + boundary) landed on `main` (ADR-0009; convergence 2026-05-27). Sequenced BEFORE v0.4 (founder). Launchable from Oz now.** Next: Phase 2 (reconcile PR #51 onto main — general orchestration infra; leave v0.4 design for the v0.4 run) + Phase 3 (adoption: wire services into Oscar's live wrap/teardown flow, prove headless `cursor-agent` end-to-end, verify Oz run-detail surfacing; add ghost-priority/dangling-ADR guard). (v0.1-foundation already archived 2026-05-27 — ADR-0011.) Full brief in [`priorities/v0.5-orchestration-services/README.md`](./priorities/v0.5-orchestration-services/README.md).
37 changes: 37 additions & 0 deletions cocoder/decisions/0011-v0.1-closeout.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
id: ADR-0011
title: "v0.1-foundation closeout — ship criteria met; Refine validations waived"
status: accepted
date: 2026-05-27
relates-to: ADR-0001, ADR-0002, ADR-0003, ADR-0004, ADR-0009
---

# ADR-0011: v0.1-foundation closeout

## Context

CoCoder **v0.1.0 shipped** — merged to `main`, tagged + released publicly (`BadGuyFranco/cocoder`), CI green (lint, type-check, tests, public-readiness gates: gitleaks + LICENSE/NOTICE + FAQ). All sub-Playbook deliverables landed: A (foundation + config survival), B (personas + workspace template), C (Oz MVP), D (docs + dogfood + publish), E (dogfood ramp), F (structural cleanup).

The program-level **Refine validations** were never executed as formal tests, and two were already removed from scope by the founder (the external stranger test P-R2, and the internal-proxy dry-run D-S1). The founder elected to close v0.1 rather than run the remaining ceremony, validating instead through real use of CoCoder on the founder's own projects.

## Decision

**v0.1-foundation is Complete and archived.** The following Refine/validation items are **waived** (recorded as *not run*, not as passed):

- **P-R1** (two real workspaces concurrently, no tmux collision) — waived; the founder runs CoBuilder + CoCoder dogfood concurrently in daily use.
- **P-R3** (delete `<CoCoder>/local/`, restore from Syncthing, Oz re-attaches via token resolution) — waived; token path resolution was proven in Sub-Playbook C Solve (C-S8); the end-to-end restore drill is left to real use.
- **P-R4** (dashboard UX restraint review) — waived; the Oz MVP shipped and is dogfooded.
- **Sub-Playbook B & C "founder Refines"** — waived; both Expands merged and were exercised by the dogfood; no blocking findings surfaced.
- (P-R2 external stranger recruit and D-S1 internal proxy were removed from v0.1 scope earlier, 2026-05-27.)

If any waived validation later surfaces a real defect, it is addressed as a small **v0.1.x patch priority**, not by reopening v0.1-foundation.

## Numbering note

ADR-0010 (run lifecycle — wrap/teardown) was authored on the `oz-control-plane-design` branch and lands on `main` via the **v0.5 Phase 2** reconcile. Until then `main` has a temporary `0009 → 0011` gap; this is the parallel-branch reservation, reconciled at that merge.

## Consequences

- `cocoder/priorities/v0.1-foundation/` moves to `cocoder/priorities/zArchive/v0.1-foundation/`; its row drops from `PRIORITIES.md` (kept in `zArchive/INDEX.md`).
- The active priority becomes **v0.5-orchestration-services** (sequenced before v0.4 per founder, 2026-05-27).
- v0.5's Phase 3 no longer carries v0.1 close-out work — it is purely orchestration-services adoption.
1 change: 1 addition & 0 deletions cocoder/decisions/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ Numbered, dated, single-purpose decisions. Each ADR captures **context → decis
| [ADR-0007](./0007-workspace-files-and-multiroot-description.md) | Workspace files — storage location and the multi-root description convention | accepted (revised 2026-05-27) | 2026-05-26 |
| [ADR-0008](./0008-oz-control-plane-architecture.md) | Oz control-plane architecture | accepted | 2026-05-27 |
| [ADR-0009](./0009-orchestration-services.md) | Non-persona orchestration services (cheap-model admin delegation) | accepted | 2026-05-27 |
| [ADR-0011](./0011-v0.1-closeout.md) | v0.1-foundation closeout — ship criteria met; Refine validations waived | accepted | 2026-05-27 |

## Pending / proposed

Expand Down
4 changes: 2 additions & 2 deletions cocoder/priorities/v0.5-orchestration-services/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# v0.5 — Orchestration Services (cheap-model admin delegation)

**Status:** **Active — Phase 1 COMPLETE: engine + launch config (route entry + boundary) + `wrap-execution` fix landed on `main` (convergence 2026-05-27). Next = Phase 2 (reconcile PR #51) + Phase 3 (adoption + v0.1 carryover/archive).** **Sequenced BEFORE v0.4-oz-control-plane** (founder, 2026-05-27). **Owner:** Bob + founder (Oscar orchestrates).
**Status:** **Active — Phase 1 COMPLETE: engine + launch config (route entry + boundary) + `wrap-execution` fix landed on `main` (convergence 2026-05-27). Next = Phase 2 (reconcile PR #51) + Phase 3 (adoption).** **Sequenced BEFORE v0.4-oz-control-plane** (founder, 2026-05-27). **Owner:** Bob + founder (Oscar orchestrates).
**Decision:** [ADR-0009](../../decisions/0009-orchestration-services.md). **Relates to:** [ADR-0008](../../decisions/0008-oz-control-plane-architecture.md) (Oz unchanged).
**Launchable from Oz / `main`** — `oscar-lead` route now lists this priority (`bounded-writers`) and the v0.5 boundary is in place.

Expand Down Expand Up @@ -38,7 +38,7 @@ Oscar (the lead orchestrator) was spending expensive lead-model context on repea

**Phase 3 — adoption + v0.1 close-out:**
- Adoption items 1–3 above (wire into live wrap/teardown flow; prove real `cursor-agent` end-to-end; verify Oz run-detail surfacing).
- **v0.1 carryover:** write **ADR-0011 (v0.1 closeout)** (reserved); run Master **P-R1** (two-workspace concurrency) + **P-R3** (recovery test), or **waive the B/C founder Refines** with rationale; then **archive `v0.1-foundation`** (move to `priorities/zArchive/`, update `PRIORITIES.md` + `zArchive/INDEX.md`) — **founder confirms archival; do not self-archive.**
- **v0.1 carryover: ✅ DONE (2026-05-27).** v0.1-foundation archived to `priorities/zArchive/` with the Refine validations (P-R1/P-R3/P-R4, B/C Refines) waived per **[ADR-0011](../../decisions/0011-v0.1-closeout.md)**. No longer part of this priority.
- **Preventive guard:** add a check that flags ghost priorities (in a route but absent from `PRIORITIES.md`) and dangling ADRs (indexed but file-absent), so this fragmentation can't silently recur.

**Stop conditions:** a service must NEVER commit, finalize a run, or record supersession; do not merge v0.4 wholesale; do not self-archive v0.1 without founder confirmation.
Expand Down
7 changes: 7 additions & 0 deletions cocoder/priorities/zArchive/INDEX.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Archived Priorities — Index

Priorities that have reached Complete (or were cancelled) move here from the active `priorities/` tree; their rows drop from `PRIORITIES.md` and are recorded below.

| Slug | Disposition | Archived | Outcome | Closeout |
|---|---|---|---|---|
| [`v0.1-foundation`](./v0.1-foundation/README.md) | Complete | 2026-05-27 | **CoCoder `v0.1.0` shipped + tagged** (public, CI green): `cocoder` CLI, Oz MVP, persona orchestration, workspace template, adopter docs, Apache-2.0, recursive dogfood. Sub-Playbooks A–F all landed. | [ADR-0011](../../decisions/0011-v0.1-closeout.md) — ship criteria met; Refine validations (P-R1/P-R3/P-R4, B/C Refines) waived (validated by ship + founder real-use). |
Original file line number Diff line number Diff line change
@@ -1,8 +1,14 @@
# Priority: v0.1-foundation — Program Master Playbook

**Slug:** `v0.1-foundation` | **Created:** 2026-05-21 | **Updated:** 2026-05-22 (audit-driven Refine; pending decisions opened)
> # ✅ ARCHIVED — COMPLETE (2026-05-27)
> **CoCoder `v0.1.0` shipped + tagged + released** (public `BadGuyFranco/cocoder`, CI green). All sub-Playbooks A–F landed: `cocoder` CLI, Oz MVP, persona orchestration, workspace template, adopter docs, Apache-2.0, recursive dogfood.
> **Closeout: [ADR-0011](../../../decisions/0011-v0.1-closeout.md).** The Master Refine validations — **P-R1** (two-workspace concurrency), **P-R3** (recovery/Syncthing restore), **P-R4** (dashboard-UX review), and the **Sub-Playbook B & C founder Refines** — were **waived** (recorded as *not run*), validated instead by ship + founder real-use. (P-R2 external stranger + D-S1 internal proxy were removed from scope earlier.)
> Successor active priority: **v0.5-orchestration-services**. Any defect in a waived area is handled as a v0.1.x patch priority, not by reopening this one.
> *The historical content below is preserved as-is from the active period; relative links may point one level shallower than this archived location.*

**Slug:** `v0.1-foundation` | **Created:** 2026-05-21 | **Updated:** 2026-05-27 (**Complete — archived**; ADR-0011)
**Type:** One-time | **Collaboration:** Collaborative
**Status:** ActiveRefine (Sub-Playbook A audit remediation; pending decisions Q1–Q7 **Resolved 2026-05-22**)
**Status:** **CompleteArchived 2026-05-27 (v0.1.0 shipped; Refine validations waived per ADR-0011)**
**Method:** WISER Playbook (Program-level)
**Owner:** Bob + founder

Expand Down
Loading