feat(queue): make #966 open-PR merge trains executable

[seonghobae]

Outcome

Executable queue-control owner for Issue #966, stacked on canonical baseline #1116 without becoming a second baseline writer.

Exact current stack

• Protected product source: develop@314ddeae7b775a4957594b599358c8255617eb2e.
• Canonical baseline docs(gap): refresh product-technical baseline (74 repos, live census) #1116: docs/gap-baseline-2026-08-31@87d38b0d64dc7b162450ef0ccd2ea5f9df99e361.
• Queue-control head: docs/bandscope-product-readiness-baseline@aed2af9844d9705ae1641c805318ed24d1c9f06e.
• Project Persistence fix(project): stage saves before atomic publication #970 is Draft and has ordinarily adopted Resource Admission fix(audio): establish canonical local-audio resource policy #866; live fix(project): stage saves before atomic publication #970 PR state is its exact-head authority.
• Active Player child feat(player): admit and bind playable stem artifacts #1160 remains Draft and has not yet adopted current fix(project): stage saves before atomic publication #970.

Baseline adoption receipt

#1116 now avoids embedding mutable Draft exact heads as long-lived source truth. Protected/released identities remain exact where appropriate; active #970/#1160/#968 exact identities are delegated to live PR state while the baseline owns stable semantic contracts. This prevents the baseline from becoming stale simply because a correctly progressing Draft gains an ordinary descendant.

The queue branch was advanced by ordinary two-parent commit aed2af9844d9705ae1641c805318ed24d1c9f06e, using previous queue head 7c4bf89eeb4cd3a5e913809d3f488f061e11c322 as first parent and #1116 87d38b0d64dc7b162450ef0ccd2ea5f9df99e361 as second parent. The ref advanced with force=false.

Fresh compare from #1116 87d38b0… to queue head aed2af9… reports behind_by=0 and exactly 22 changed files. All 22 are queue-owned workflow/ADR/reference/manifest/script/test surfaces. docs/product-technical-gap-baseline.md is non-divergent.

The inherited baseline records #970's actual #866 adoption, v3 path-free source evidence, restart exact-byte re-admission, admitted-source snapshot decode continuity, mounted Open→Save preservation, Demucs compatibility admission including bounded PyTorch weights-only incompatibility, and the narrower remaining #1160 audible-authority gap without promoting Draft work into shipped truth.

Executable #966 contract retained here

refresh_open_pr_queue.py owns bounded live inventory and exact identities; verify_open_pr_queue.py validates graph/disposition consistency; collect_open_pr_readiness.py admits only unchanged non-Draft canonical-active entries with terminal required checks, qualifying exact-head approval, zero actionable threads and complete decision metadata; .github/workflows/open-pr-queue-live.yml preserves read-only live refresh/verification/parity evidence.

Verification / merge gate

Keep Draft. aed2af9… is a new exact head, so predecessor checks/reviews/approvals do not transfer. It requires terminal current-head checks, zero actionable unresolved findings and qualifying independent non-author last-push approval. Future #1116 movement requires another ordinary non-force descendant preserving the same queue-owned files. No force-push, destructive rebase, baseline source copy, self-approval, gate weakening or evidence transfer was used.

[coderabbitai]

📝 Walkthrough

Walkthrough

BandScope 1.0 제품 준비도와 병합 트레인을 문서화했습니다. GitHub open PR 큐 manifest를 갱신하고 검증하는 스크립트를 추가했습니다. quickcheck와 회귀 테스트가 manifest 구조, SHA, 페이지네이션, API 경로를 검증합니다.

Changes

제품 준비도 및 PR 큐

Layer / File(s)	Summary
제품 준비도 기준과 병합 트레인 docs/architecture/decisions/..., docs/doctoring/PRODUCT_READINESS_REFERENCES.md, docs/product-technical-gap-baseline.md	제품 경계, 증거 기준, 완료 조건, T0–T7 병합 트레인, 참고문헌과 스냅샷 한계를 문서화했습니다.
PR 큐 manifest와 정적 검증 docs/product-readiness/open-pr-queue.json, scripts/checks/verify_open_pr_queue.py	open PR 스냅샷을 추가했습니다. 검증기는 스키마, 저장소, 브랜치, 트레인, PR, URL과 SHA 상태를 검사합니다.
GitHub 기반 manifest 갱신 scripts/checks/refresh_open_pr_queue.py	GitHub API에서 bounded pagination으로 PR을 수집합니다. 기존 라우팅 정보를 보존하고 신규 PR을 T8로 추가합니다. 검증된 manifest를 fsync 후 원자적으로 저장합니다.
검증 회귀 테스트와 quickcheck 연결 scripts/harness/quickcheck.sh, services/analysis-engine/tests/test_open_pr_queue_*.py	manifest 오류, 페이지 한도, 중복 PR, SHA와 base ref 오류, API 경로 제한 및 quickcheck 연결을 테스트합니다.

Estimated code review effort: 4 (Complex) | ~45 minutes

Merge Risk: 🟡 Moderate · up to 735f3

The PR adds a live-refreshable PR queue, but invalid disposition values and records missing head revisions can currently pass validation and misroute follow-up actions. A required formatting check also remains failed, so merge should wait for these fixes and a clean exact-head check run.

Sequence Diagram(s)

sequenceDiagram
  participant RefreshScript
  participant GitHubAPI
  participant ManifestFile
  participant Quickcheck
  RefreshScript->>GitHubAPI: develop SHA와 open PR 목록 요청
  GitHubAPI-->>RefreshScript: PR JSON 페이지 반환
  RefreshScript->>ManifestFile: 검증된 manifest 원자적 저장
  Quickcheck->>ManifestFile: manifest 로드
  Quickcheck->>Quickcheck: verify_open_pr_queue.py 실행

Loading

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	Docstring check was indeterminate for this PR — some files could not be analyzed in time. Not blocking.
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.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	제목은 PR의 핵심 변경인 open-PR 병합 트레인의 실행 가능화와 직접 관련됩니다. queue 범위와 이슈 번호도 명확하며 간결합니다.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/bandscope-product-readiness-baseline

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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

[seonghobae]

@opencode-agent Continue only the existing canonical branch docs/bandscope-product-readiness-baseline if its exact head is still 6456d325ac32d41f11670ee37fb216e28701e40c; do not create another branch/PR. Fresh live BandScope evidence now reports 111 open PRs targeting develop, while docs/product-readiness/open-pr-queue.json at this head still declares open_pr_count: 83 and snapshot_date: 2026-08-20. This is not a request to hand-edit 111 entries or weaken the offline verifier: implement the next bounded #966 root-cause slice that makes live refresh executable and reproducible. TDD first: add fixture-driven tests for a live-queue refresh/generator that deterministically consumes GitHub PR metadata, rejects pagination truncation/incomplete results, duplicate PR numbers, wrong base refs, malformed/missing immutable head SHAs and unsupported dispositions, and emits a manifest whose declared count exactly matches the fetched complete open-PR set. Keep required CI network-independent by testing against recorded/local fixtures; any live GitHub call must be an explicit operator command, bounded, paginated, fail-closed and use no write token. Generate the human table from the same source or add an exact parity check rather than maintaining a second hand-edited count. Preserve the existing intrinsic verifier and current train/ownership semantics; do not claim check/review readiness from generated status-only data and do not touch #783 dependency/security ownership. Run focused tests, canonical quickcheck and exact-head CI, then report the resulting exact head/evidence. If the branch moved, inspect the intervening delta and adapt rather than racing it.

[opencode-agent]

Queued @opencode-agent for PR #968 at head 25e1610fff2a927ab421621eb147188ab86a3470. Central exact-name Actions artifacts are the durable dispatch ledger; existing review workflows remain authoritative for the final verdict and failure evidence.

[opencode-agent]

Queued @opencode-agent for PR #968 at head aed2af9844d9705ae1641c805318ed24d1c9f06e. Central exact-name Actions artifacts are the durable dispatch ledger; existing review workflows remain authoritative for the final verdict and failure evidence.