Skip to content

docs: correct public story to match shipped state - #64

Open
yakimoto wants to merge 4 commits into
mainfrom
feat/public-status
Open

yakimoto wants to merge 4 commits into
mainfrom
feat/public-status

Conversation

@yakimoto

@yakimoto yakimoto commented Aug 11, 2026

Copy link
Copy Markdown
Contributor

Corrects the desktop repo's public story (same gap as wave-realtime-edge #354, wave-bridge-edge #161): the README claimed 'early / scaffolding' and marked OAuth + SRT encoder as Wave 2 'next' — but OAuth device-code + safeStorage token vault, the SRT encoder lifecycle, WHEP subscribe / WHIP publish sessions, and the loopback control-plane HTTP API (0.3.0) are all shipped and covered by the vitest suite.

Changed

  • README.md — status headline → 'working build, alpha'; roadmap → OAuth/WHEP/control-plane marked shipped; 'Why this exists' future-tense fixed.
  • CHANGELOG.md — Unreleased entry documenting the correction.

Not changed: no code, no behavior, no secrets. capabilities.json was already accurate (0.3.0, control plane, loopback-only).


View with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is enabled.


Note

Low Risk
Markdown-only README and CHANGELOG edits with no runtime, security, or dependency impact.

Overview
Documentation-only update so the repo’s public narrative matches what is already shipped—no application code, behavior, or secrets change.

The README status callout moves from “early / scaffolding” to working build, alpha, listing OAuth device-code + safeStorage vault, SRT encoder lifecycle, WHEP/WHIP sessions, and the loopback control-plane API (0.3.0) as shipped and vitest-covered. The roadmap table is realigned: W1–W4 (shell, OAuth/SRT, WHEP/WHIP, control plane) are marked shipped with version notes; multiview/WebRTC becomes W5 “next”; OBS, vMix, and conferencing bridge shift to W6–W8. “Why this exists” is rewritten from future tense (“after this app ships”) to present tense.

CHANGELOG adds an [Unreleased] → Changed entry documenting this correction.

Reviewed by Cursor Bugbot for commit cd85513. Configure here.

Review in cubic

Note

Update docs to reflect shipped alpha state and correct license to Apache-2.0

  • Updates README.md to change project status from 'early scaffolding' to 'working build, alpha', listing shipped features (OAuth device-code sign-in, safeStorage token vault, SRT encoder lifecycle, WHEP subscribe, WHIP publish, loopback control-plane API v0.3.0).
  • Documents that the encode→publish bridge is opt-in via WAVE_ENABLE_ENCODE_BRIDGE/VITE_WAVE_ENABLE_ENCODE_BRIDGE (default off) and overhauls the roadmap table to mark W1–W4 as shipped with versions.
  • Changes the license from MIT to Apache-2.0 in README.md, CONTRIBUTING.md, and CHANGELOG.md. No code changes.

Macroscope summarized c2001d8.

README status + roadmap now reflect reality: this is a working alpha, not a
scaffold. OAuth device-code + safeStorage token vault, SRT encoder lifecycle,
WHEP subscribe / WHIP publish sessions, and the loopback control-plane HTTP
API (0.3.0) are all shipped and covered by the vitest suite. Previously the
README claimed "early / scaffolding" and marked OAuth + SRT encoder as
Wave 2 "next".

No code changed.
@cursor

cursor Bot commented Aug 11, 2026

Copy link
Copy Markdown

Bugbot couldn't run - usage limit reached

Bugbot is counted against Cursor usage for this user or team, and this run hit a usage or spend limit.

A user or team admin can review and increase usage limits in the Cursor dashboard.

(requestId: serverGenReqId_f90b8b94-cff6-4287-88d5-bb0e1930bac5)

@coderabbitai

coderabbitai Bot commented Aug 11, 2026

Copy link
Copy Markdown

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Summary by CodeRabbit

  • Documentation
    • Updated project documentation to reflect the current alpha working build.
    • Documented available OAuth authentication, secure token storage, SRT encoding, WHEP/WHIP sessions, loopback API, and test coverage.
    • Revised roadmap status to distinguish shipped capabilities from upcoming work.

Walkthrough

The changelog and README now describe an alpha working build, shipped capabilities, present-tense availability, and updated roadmap sequencing.

Changes

Project status documentation

Layer / File(s) Summary
Alpha build and shipped features
CHANGELOG.md, README.md
The documentation identifies the project as an alpha working build and lists shipped authentication, token storage, media sessions, control-plane API, and test coverage.
Roadmap status alignment
README.md
The roadmap marks W1–W4 as shipped, identifies W5 as next, and lists pending OBS, vMix, and conferencing integrations in W6–W8.

Estimated code review effort: 1 (Trivial) | ~2 minutes

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title clearly and concisely describes the documentation change to align the public project story with the shipped state.
Description check ✅ Passed The description directly explains the README and CHANGELOG updates and confirms that no code or behavior changes were made.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/public-status
✨ Simplify code
  • Create PR with simplified code
  • Commit simplified code in branch feat/public-status

Comment @coderabbitai help to get the list of available commands.

@qodo-code-review

Copy link
Copy Markdown

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Grey Divider

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Grey Divider

Tip of the day
💡 Did you know, you can group findings by type and pick your Finding display, from Minimal to Full

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗

Grey Divider

Qodo Logo

@qodo-code-review

Copy link
Copy Markdown

PR Summary by Qodo

Docs: align README/roadmap with shipped alpha status

📝 Documentation 🕐 Less than 10 minutes

Grey Divider

AI Description

• Update README status from “scaffolding” to shipped working alpha
• Mark OAuth/SRT/WHEP/WHIP/control-plane items as shipped in roadmap table
• Add changelog note clarifying this is a documentation-only correction
Diagram

graph TD
  maintainer[Maintainers] --> readme["README.md"] --> audience[Public readers]
  maintainer --> changelog["CHANGELOG.md"] --> audience
Loading
High-Level Assessment

Current approach is appropriate: update the README to reflect shipped capabilities and add an Unreleased changelog entry for traceability. Alternatives (e.g., adding more detail or moving the status statement into a separate STATUS.md) would add process overhead without improving accuracy for this correction.

Files changed (2) +19 / -12

Documentation (2) +19 / -12
CHANGELOG.mdDocument the public-story correction under Unreleased +3/-0

Document the public-story correction under Unreleased

• Adds an Unreleased “Changed” entry explaining that the README status/roadmap was corrected to match shipped functionality. Explicitly notes that this is a documentation-only change with no code modifications.

CHANGELOG.md

README.mdUpdate status, tense, and roadmap to match shipped alpha +16/-12

Update status, tense, and roadmap to match shipped alpha

• Replaces the status callout from “early/scaffolding” to a shipped “working build, alpha” description listing key shipped capabilities. Adjusts the “Why this exists” section from future-tense to present-tense and revises the roadmap table to mark OAuth/SRT/WHEP/WHIP/control-plane as shipped (with versions where applicable).

README.md

@qodo-code-review

Copy link
Copy Markdown

Qodo Fixer

No findings are available for this PR yet. Findings appear here once Qodo has reviewed the PR.

devin-ai-integration[bot]

This comment was marked as resolved.

@cursor cursor Bot 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.

Risk: low. Left a non-blocking comment — Cursor Bugbot and Cursor Security Agent both skipped (Bugbot hit a usage limit), so the required automated review signals are incomplete and human review is needed. No reviewers were assigned (only the PR author is assignable on this repo).

Open in Web View Automation 

Sent by Cursor Approval Agent: Pull Request Router and Approver

macroscopeapp[bot]
macroscopeapp Bot previously approved these changes Aug 11, 2026
@macroscopeapp

macroscopeapp Bot commented Aug 11, 2026

Copy link
Copy Markdown

Approvability

Verdict: Approved c2001d8

Documentation-only changes updating project status, license references, and roadmap. No code modified. Author owns all changed files. Open comments are minor markdown style suggestions.

You can customize Macroscope's approvability policy. Learn more.

@coderabbitai coderabbitai Bot 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.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CHANGELOG.md`:
- Around line 9-10: Insert a blank line immediately after the “### Changed”
heading and before its first bullet in the changelog entry, preserving the
existing heading and bullet content.

In `@README.md`:
- Around line 95-102: Resolve the W5 status mismatch in README.md by aligning
the roadmap entry with the current-capability description: mark “Multiview grid
+ WebRTC push” as shipped if that functionality is available, or update the
earlier capability text to describe it as upcoming. Ensure both sections
consistently state the same status.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: 2b8fe4e5-3e80-492b-84e5-7356463ea90f

📥 Commits

Reviewing files that changed from the base of the PR and between 558fe79 and cd85513.

📒 Files selected for processing (2)
  • CHANGELOG.md
  • README.md
📜 Review details
⏰ Context from checks skipped due to timeout. (6)
  • GitHub Check: [code]smith
  • GitHub Check: semgrep-cloud-platform/scan
  • GitHub Check: Macroscope - Approvability Check
  • GitHub Check: Analyze (javascript-typescript)
  • GitHub Check: Cursor Approval Agent: Pull Request Router and Approver
  • GitHub Check: Analyze (javascript-typescript)
🧰 Additional context used
📓 Path-based instructions (1)
CHANGELOG.md

📄 CodeRabbit inference engine (AGENTS.md)

Update CHANGELOG.md under Unreleased section for user-facing changes

Files:

  • CHANGELOG.md
🪛 markdownlint-cli2 (0.23.2)
CHANGELOG.md

[warning] 9-9: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below

(MD022, blanks-around-headings)

🔇 Additional comments (1)
README.md (1)

6-10: LGTM!

Also applies to: 30-32

Comment thread CHANGELOG.md Outdated
Comment on lines +9 to +10
### Changed
- **Public story corrected to match shipped state** — README status + roadmap now reflect reality: this is a working alpha, not a scaffold. OAuth device-code + safeStorage token vault, SRT encoder lifecycle, WHEP subscribe / WHIP publish sessions, and the loopback control-plane API (0.3.0) are all shipped and tested. Previously the README claimed "early / scaffolding" and marked OAuth + SRT encoder as Wave 2 "next". No code changed.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Add a blank line after the Changed heading.

markdownlint-cli2 reports MD022 because Line 9 is not followed by a blank line. Insert one before the bullet.

Proposed fix
 ### Changed
+
 - **Public story corrected to match shipped state** — README status + roadmap now reflect reality: this is a working alpha, not a scaffold. OAuth device-code + safeStorage token vault, SRT encoder lifecycle, WHEP subscribe / WHIP publish sessions, and the loopback control-plane API (0.3.0) are all shipped and tested. Previously the README claimed "early / scaffolding" and marked OAuth + SRT encoder as Wave 2 "next". No code changed.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
### Changed
- **Public story corrected to match shipped state** — README status + roadmap now reflect reality: this is a working alpha, not a scaffold. OAuth device-code + safeStorage token vault, SRT encoder lifecycle, WHEP subscribe / WHIP publish sessions, and the loopback control-plane API (0.3.0) are all shipped and tested. Previously the README claimed "early / scaffolding" and marked OAuth + SRT encoder as Wave 2 "next". No code changed.
### Changed
- **Public story corrected to match shipped state** — README status + roadmap now reflect reality: this is a working alpha, not a scaffold. OAuth device-code + safeStorage token vault, SRT encoder lifecycle, WHEP subscribe / WHIP publish sessions, and the loopback control-plane API (0.3.0) are all shipped and tested. Previously the README claimed "early / scaffolding" and marked OAuth + SRT encoder as Wave 2 "next". No code changed.
🧰 Tools
🪛 markdownlint-cli2 (0.23.2)

[warning] 9-9: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below

(MD022, blanks-around-headings)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CHANGELOG.md` around lines 9 - 10, Insert a blank line immediately after the
“### Changed” heading and before its first bullet in the changelog entry,
preserving the existing heading and bullet content.

Source: Linters/SAST tools

Comment thread README.md
Comment on lines +95 to +102
| W1 | Shell + IPC contract + four-tab UI | shipped (0.2.0) |
| W2 | OAuth device-code + safeStorage + SRT encoder | shipped |
| W3 | WHEP subscribe + WHIP publish session surface | shipped |
| W4 | Loopback control-plane HTTP API (Companion / vMix / multiviewer) | shipped (0.3.0) |
| W5 | Multiview grid + WebRTC push | next |
| W6 | OBS plugin (#163, separate repo) | pending |
| W7 | vMix integration (#164) | pending |
| W8 | Zoom / Teams / Meet bridge (#166) | pending |

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Resolve the W5 status contradiction.

README.md Line 21 describes the multiview grid and optional WebRTC push as available. Lines 95-99 mark the same W5 surface as next. Mark W5 as shipped, or revise the current-capability text so both sections state the same status.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@README.md` around lines 95 - 102, Resolve the W5 status mismatch in README.md
by aligning the roadmap entry with the current-capability description: mark
“Multiview grid + WebRTC push” as shipped if that functionality is available, or
update the earlier capability text to describe it as upcoming. Ensure both
sections consistently state the same status.

Co-authored-by: Codesmith <codesmith-bot@users.noreply.github.com>
Co-authored-by: Codesmith <codesmith-bot@users.noreply.github.com>

@devin-ai-integration devin-ai-integration Bot 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.

Devin Review found 1 new potential issue.

Open in Devin Review

Comment thread README.md Outdated
Comment on lines +8 to +9
> WHIP publish sessions (the encode→publish bridge is opt-in via the
> `WAVE_ENABLE_ENCODE_BRIDGE` flag, default off), and a loopback

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🔍 README flag name omits the renderer's VITE_ prefix

README documents the encode bridge as opt-in via WAVE_ENABLE_ENCODE_BRIDGE, but src/shared/flags.ts:38-51 only honors the bare name in the main process; the renderer reads VITE_WAVE_ENABLE_ENCODE_BRIDGE (Vite inlines only VITE_-prefixed vars at build time). An operator setting just WAVE_ENABLE_ENCODE_BRIDGE before npm run dev will not enable the renderer-side bridge. Worth documenting both forms.

Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Co-authored-by: Codesmith <codesmith-bot@users.noreply.github.com>

@devin-ai-integration devin-ai-integration Bot 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.

Devin Review found 1 new potential issue.

Open in Devin Review

Comment thread README.md
Comment on lines +6 to +12
> **Status: working build, alpha.** The app runs — OAuth device-code sign-in,
> safeStorage-backed token vault, SRT encoder lifecycle, WHEP subscribe +
> WHIP publish sessions (the encode→publish bridge is opt-in via the
> `WAVE_ENABLE_ENCODE_BRIDGE` flag, or `VITE_WAVE_ENABLE_ENCODE_BRIDGE` for
> the renderer build; default off), and a loopback
> control-plane HTTP API (v0.3.0) are all shipped and covered by a vitest
> suite. Interfaces still evolve. Watch the

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🔍 README flag name is incomplete for the renderer build

The README instructs operators to enable the encode→publish bridge via WAVE_ENABLE_ENCODE_BRIDGE, but src/shared/flags.ts only honors the bare name in the main process; the renderer (where Session.tsx reads it) requires the Vite-inlined VITE_WAVE_ENABLE_ENCODE_BRIDGE. Setting only WAVE_ENABLE_ENCODE_BRIDGE will not turn on the renderer-side bridge, so the docs should mention both forms.

Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Already resolved in commit c2001d8: the README status blurb now documents both the bare WAVE_ENABLE_ENCODE_BRIDGE flag and the renderer's VITE_WAVE_ENABLE_ENCODE_BRIDGE form. This comment appears to have been generated against the pre-fix revision.

@wave-bugbot

wave-bugbot Bot commented Aug 12, 2026

Copy link
Copy Markdown

🟢 WAVE BugBot — clear

No confident findings on the changed lines.

Local review · $0 inference · wave-dispatch

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.

1 participant