Skip to content

docs: restore FEAT-011/012/013 post-MVP app roadmap entries#25

Merged
brettheap merged 1 commit into
mainfrom
docs/restore-feat-011-012-013-roadmap
May 23, 2026
Merged

docs: restore FEAT-011/012/013 post-MVP app roadmap entries#25
brettheap merged 1 commit into
mainfrom
docs/restore-feat-011-012-013-roadmap

Conversation

@brettheap
Copy link
Copy Markdown
Contributor

@brettheap brettheap commented May 23, 2026

Summary

  • Restores docs/mvp-feature-sequence.md roadmap entries for FEAT-011 (Local App Backend Contract), FEAT-012 (Flutter Desktop Control Panel), and FEAT-013 (Managed Session Creation) that were dropped during the 2026-05-22 main resync.
  • Original work is preserved at commit c810b67 on the local safety branch backup/main-pre-sync-2026-05-22; this PR cherry-picks it cleanly onto current main.
  • FEAT-011 implementation already landed on main (specs/011-app-backend-contract/), but the roadmap doc never picked the entry back up — this PR closes that gap and also re-establishes the FEAT-012/013 planning records that have no spec yet.

Note on the "Later Features" bullet removal

The cherry-pick also removes the "Open a new tmux pane or window attached to a selected container." bullet from the Later Features list. This is intentional and part of the original commit: that capability is now covered by FEAT-013 (Managed Session Creation and Lifecycle), so leaving it under Later Features would have double-counted the work.

Test plan

  • Confirm docs/mvp-feature-sequence.md contains headings ## FEAT-011, ## FEAT-012, ## FEAT-013 and the "These are intentionally after FEAT-013:" transition into Later Features.
  • Confirm the restored FEAT-011 description is consistent with specs/011-app-backend-contract/spec.md (local-only, adopt-existing-panes first, managed session creation deferred to FEAT-013).
  • Confirm no implementation or non-doc files were touched (git diff main..HEAD --stat should list only docs/mvp-feature-sequence.md).

🤖 Generated with Claude Code

Copilot AI review requested due to automatic review settings May 23, 2026 14:41
@sourcery-ai
Copy link
Copy Markdown

sourcery-ai Bot commented May 23, 2026

Reviewer's Guide

Restores the missing roadmap sections for FEAT-011/012/013 in the MVP feature sequence doc and updates the transition into the Later Features section, without touching any non-doc files or changing existing specs/implementation.

Flow diagram for restored FEAT-011/012/013 roadmap sequence

flowchart LR
    FEAT011["FEAT-011\nLocal App Backend Contract"] --> FEAT012["FEAT-012\nFlutter Desktop Control Panel (Adopt Existing Sessions)"]
    FEAT012 --> FEAT013["FEAT-013\nManaged Session Creation and Lifecycle"]
    FEAT013 --> LaterFeatures["Later Features\n(these are intentionally after FEAT-013)"]
Loading

File-Level Changes

Change Details Files
Reintroduce roadmap entry describing the local app backend contract for a packaged desktop control panel (FEAT-011).
  • Add FEAT-011 section with goal, build, acceptance criteria, and out-of-scope items centered on exposing a structured local-only app-facing API over the existing daemon
  • Clarify responsibilities such as bootstrap/health checks, response envelopes suitable for Flutter, and explicit exclusions like desktop UI and managed session creation
docs/mvp-feature-sequence.md
Add roadmap entry for the initial Flutter desktop control panel focused on adopting existing sessions (FEAT-012).
  • Define FEAT-012 section outlining a cross-platform Flutter desktop app that surfaces daemon status, containers, panes, agents, logs, events, queue, and routes
  • Specify user actions and acceptance criteria for adopting existing tmux panes into managed agents while remaining local-first, plus what remains out of scope
docs/mvp-feature-sequence.md
Add roadmap entry for managed session creation and lifecycle (FEAT-013).
  • Introduce FEAT-013 section describing creation and management of tmux-backed sessions from the control panel, including templates, auto-registration, and log handling
  • Capture acceptance criteria for creating full multi-agent layouts and distinguishing managed vs adopted agents, along with explicit exclusions like cross-host orchestration
docs/mvp-feature-sequence.md
Align the Later Features section with the restored FEAT-013 milestone boundary.
  • Update the introductory line for Later Features to state they are intentionally after FEAT-013 instead of after the first 10 features
  • Remove the bullet for opening a new tmux pane/window attached to a container from the Later Features list, since that is now covered by earlier FEAT entries
docs/mvp-feature-sequence.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

Copy link
Copy Markdown

@sourcery-ai sourcery-ai Bot left a comment

Choose a reason for hiding this comment

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

Hey - I've reviewed your changes and they look great!


Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR restores post-MVP roadmap entries (FEAT-011/012/013) in docs/mvp-feature-sequence.md that were removed during a prior resync, reestablishing the documented sequencing for the desktop-app backend contract, initial Flutter control panel, and managed session creation.

Changes:

  • Reintroduces roadmap sections for FEAT-011 (Local App Backend Contract), FEAT-012 (Flutter Desktop Control Panel adopting existing sessions), and FEAT-013 (Managed session creation/lifecycle).
  • Updates the “Later Features” transition line to explicitly anchor it after FEAT-013.
  • Removes one “Later Features” bullet (“Open a new tmux pane or window attached to a selected container.”), which appears incidental relative to the PR’s stated intent.

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

Comment on lines 550 to 555
## Later Features

These are intentionally after the first 10:
These are intentionally after FEAT-013:

- Open a new tmux pane or window attached to a selected container.
- Inferred swarm parentage.
- Shell helper integration for yodex, yolo, cta, and related tools.
Comment on lines +509 to +511
- The app can manage the same end-to-end workflow the CLI demo proved:
register, attach log, observe events, send direct input, create route, and
inspect queue/audit state.
@sonarqubecloud
Copy link
Copy Markdown

@brettheap brettheap merged commit b2d9001 into main May 23, 2026
4 checks passed
@brettheap brettheap deleted the docs/restore-feat-011-012-013-roadmap branch May 23, 2026 14:47
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