Skip to content

docs: Phase 6 go/no-go decision — keep the process boundary (no source merge)#155

Merged
BunsDev merged 1 commit into
mainfrom
docs/phase6-decision
Jul 14, 2026
Merged

docs: Phase 6 go/no-go decision — keep the process boundary (no source merge)#155
BunsDev merged 1 commit into
mainfrom
docs/phase6-decision

Conversation

@BunsDev

@BunsDev BunsDev commented Jul 14, 2026

Copy link
Copy Markdown
Member

Summary

Records the final decision of the coven CLI unification: Phase 6 go/no-go on merging the engine source into the coven binary — decided NO-GO (keep the process boundary). Docs-only.

Phases 0–5 delivered a single user-facing coven CLI driving coven-code as a managed engine process. Phase 6 is a decision, not code: should we go further to a single linked binary?

Decision: NO-GO — keep the process boundary

Rationale (full detail in the doc):

  1. License is dispositivecoven is MIT, coven-code is GPL-3.0 (inherited from upstream Claurst). Linking the claurst-* crates in makes the combined binary GPL; there's no "link but stay MIT," and relicensing needs upstream consent.
  2. Severs the upstream channel — the claurst-* names exist to keep git merge upstream/main low-friction; a source merge throws that away.
  3. Large migration, zero user-visible gain — tokio-into-the-sync-CLI, ratatui 0.30↔0.29, rusqlite 0.40↔0.31, ~148k LoC into a ~35k workspace, for an artifact users experience identically.
  4. The boundary costs nothing — one install/command, ~/.coven state, one session ledger + search, one doctor/--version, one brand all already ship without crossing the license line.

The doc also records measurable flip-criteria (revisit only if all three hold) and a migration sketch if ever taken — the process-boundary design keeps that door open at zero ongoing cost.

No code changes.

Copilot AI review requested due to automatic review settings July 14, 2026 09:11
@vercel

vercel Bot commented Jul 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Jul 14, 2026 9:11am

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds an ADR documenting the Phase 6 go/no-go decision for coven CLI unification: do not merge coven-code engine source into the coven binary, and keep the process boundary. This fits the repo’s unification documentation trail by closing out the last open architectural question without introducing code changes.

Changes:

  • Add a Phase 6 decision record (ADR) stating NO-GO on a single linked coven binary.
  • Document rationale (licensing, upstream merge channel, migration cost vs. user benefit) plus explicit flip-criteria for revisiting later.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@BunsDev
BunsDev merged commit c20ee27 into main Jul 14, 2026
2 checks passed
@BunsDev
BunsDev deleted the docs/phase6-decision branch July 14, 2026 09:20
BunsDev added a commit that referenced this pull request Jul 15, 2026
…164)

Close out the coven CLI unification paperwork now that every phase has
landed:

- unification.md: status complete; phase table rows 5 and 6 finalized
  (Phase 5 landed via #154/#158/#160 with the npm deprecation executed
  and npm-publish made opt-in in #162; Phase 6 decided NO-GO via #155);
  npm-package note rewritten in past tense.
- superpowers plans: COMPLETE status banners on the master plan and the
  phase 3/4/5 sub-plans pointing at docs/unification.md as the living
  summary; phase 5 task 5.3 marked done (coven-side version_line landed)
  and task 5.6 recorded as executed.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants