Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
35 commits
Select commit Hold shift + click to select a range
8ed756a
chore: bump package versions (#3401)
kixelated Sep 4, 2026
4cf2161
fix(moq-mux): slice the TS export on the PCR grid (#3351)
kixelated Sep 4, 2026
78f82e3
fix(obs): pin the plugin to OBS 32.2.2 and guard libobs CI compatibil…
kixelated Sep 4, 2026
a8c6b03
fix(moq-net): answer for a name the broadcast never served (#3366)
kixelated Sep 4, 2026
7039d49
chore(claude): add the spawn-quest skill (#3403)
kixelated Sep 4, 2026
b132fb3
docs(quest): require hop-path validation before banning Hop ID 0 (#3404)
kixelated Sep 4, 2026
3827f0b
docs(quest): plan the HLS identity, peer reconfigure, client goaway, …
kixelated Sep 4, 2026
9b90ea5
fix(claude): fetch and resolve stale branches before spawn-quest tria…
kixelated Sep 4, 2026
ecd2fdf
docs(quest): finish the reviewed planning contracts (#3411)
kixelated Sep 5, 2026
7bdc170
ci(nightly): compile the Apple-only code paths (#3413)
kixelated Sep 5, 2026
63b212d
fix(moq-video): stop openh264 leaking its picture pool, and survive a…
Frando Sep 5, 2026
f5e4ae1
feat(moq-audio)!: let publish_capture carry a catalog extension (#3356)
Frando Sep 5, 2026
03db0e0
fix(claude): let spawn-quest reclaim an abandoned quest branch (#3409)
kixelated Sep 5, 2026
89cf5df
chore(quest): settle the group-overflow abort plan, and split out #29…
kixelated Sep 5, 2026
5a5ba2a
docs(quest): audit the tree, and settle rewind, HLS identity, metadat…
kixelated Sep 5, 2026
c2c5558
chore(quest): claim 2985 js/net path-keyed publisher state
kixelated Sep 5, 2026
babac7c
fix(js/net): key the publisher's TRACK_INFO cache by broadcast, not path
kixelated Sep 5, 2026
9e4be87
docs(drafts): scope a TRACK_INFO cache to the announcement, not the path
kixelated Sep 5, 2026
9a5e845
docs(quest): land the review fixes auto-merge left out of #3416 (#3425)
kixelated Sep 5, 2026
419de62
fix(relay): make the web listeners share one socket-capturing accepto…
kixelated Sep 5, 2026
f6ba494
docs(quest): settle scope narrowing in place, and mark pre-media side…
kixelated Sep 5, 2026
27c199b
fix(moq-video): pick the V4L2 mode nearest the requested resolution (…
Frando Sep 5, 2026
3064644
Merge remote-tracking branch 'origin/main' into dev
kixelated Sep 5, 2026
cf862f8
Merge remote-tracking branch 'origin/dev' into dev
kixelated Sep 5, 2026
bac2850
Merge remote-tracking branch 'origin/main' into dev
kixelated Sep 5, 2026
23f4b48
feat(moq-video): add the Android MediaCodec encoder and decoder (#3354)
Frando Sep 5, 2026
3c2f236
fix(moq-video): make moq-video compile on dev again (#3423)
kixelated Sep 5, 2026
ee4aa85
docs(quest): fold the stream scheduler prototype into the noq schedul…
kixelated Sep 5, 2026
f9c3926
docs(quest): import the post-grooming issues as quests (#3431)
kixelated Sep 5, 2026
72cb79c
docs(quest): apply the Codex findings on the issue import (#3432)
kixelated Sep 5, 2026
339810a
fix(moq-mux): align TS tests with PCR buffering
kixelated Sep 5, 2026
ad65b05
Merge remote-tracking branch 'origin/dev' into dev
kixelated Sep 5, 2026
ac69338
Merge remote-tracking branch 'origin/main' into dev
kixelated Sep 5, 2026
ac8806f
feat(uring): report per-worker io_uring counters at /metrics (#3408)
kixelated Sep 5, 2026
d44e19c
Merge dev and repair the completed quest reference
kixelated Sep 5, 2026
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
102 changes: 102 additions & 0 deletions .claude/skills/spawn-quest/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
---
name: spawn-quest
description: Triage every quest in a scope interactively, then spawn background agents to open a PR for each one worth starting now. Use when the user invokes /spawn-quest, optionally with a scope such as /spawn-quest m0, or asks whether a milestone's quests should be worked on now.
---

Before you begin, read `quest/AGENTS.md` completely.

Resolve the first argument to a questline directory under `quest/`, defaulting
to `quest/` itself: `m0` means `quest/m0`.

`git fetch origin` **before** looking at claims. The remote branch is the
coordination mechanism, so stale remote-tracking refs mean offering a quest
another agent already claimed, and the spawned agent finds out only when its
push is rejected.

Read every quest in the scope, not just the summaries in each `README.md`. Drop
the ones a recent branch or open PR already claims.

Resolve a stale branch (old, no open PR) before keeping its quest in the start
pool, rather than only mentioning it. Left in place it makes the agent's claim
push fail as non-fast-forward, which the agent then reports as a lost race that
never happened.

Inspect what the branch carries beyond its base. A claim placeholder is itself
a commit, so "carries no work" is not the same as "has nothing unmerged", and
conflating the two strands a quest forever:

- **Placeholder commits only.** Someone claimed the quest and abandoned it
without starting. Delete the ref and keep the quest in the pool: nothing is
lost, and treating it as claimed would retire the quest permanently on the
strength of an empty commit. Pin the remote delete to the tip you inspected,
with `git push --force-with-lease=<branch>:<sha> origin --delete <branch>`.
An unconditional delete races the owner coming back, and would erase a real
commit pushed between the inspection and the delete along with the claim it
renewed. A rejected lease means that is what happened, so treat the quest as
claimed. Delete the local ref too when it points at that same tip, or the
agent cannot cut the branch it was told to cut.
- **Real commits.** Do not cut a fresh branch over them. Hand the agent the
existing branch to continue, rebased onto its base. It still claims, with a
fresh UUID placeholder pushed under a lease pinned to the tip you inspected.
Two runs that both adopt the same branch would otherwise both skip the claim,
and a rebase that changes nothing gives neither of them the rejected push
that decides the race.
- **Checked out in a worktree, or carrying an open PR.** Treat the quest as
claimed and take it out of the pool.

Put every quest to the user in priority order - the depth-first walk of the
scope's `Quests` lists - with a recommendation and the one fact behind it.
Batch the questions; do not spend a round per quest. The choices are **start**,
**plan** (use `$plan-quest` when a material decision is unmade), **move**,
**delete**, and **leave**.

Offer **start** only for a ready quest: `quest/AGENTS.md` executes one only when
it has no `Required` section. For work an agent cannot do - a decision that is
a conversation, a credential only the user can mint, or verification this
machine cannot run, such as a Linux-only build or a benchmark whose exit
criteria is a measured before/after - recommend **leave** and name what would
unblock it.

## Spawning

Settle a base branch **per quest** and pass it to that quest's agent. Apply the Branch Targeting rules in `CLAUDE.md`: `dev`
only for a semver break in a published API, `main` for everything else. One
scope mixes both, so a single base for the whole wave puts some PR on the
wrong branch. Never let an agent derive its own base: an agent branching from
wherever it stands puts this skill's own tree edits in its PR.

Spawn one background agent per **start**, each with `isolation: "worktree"`, in
waves of two or three unless the machine is idle - a saturated box makes agents
ship unverified. Never edit a running agent's worktree; message it instead.

Give each agent the base branch, the quest path, and nothing it could read for
itself. Instruct it to:

- Read `quest/AGENTS.md`, the quest, `CONTRIBUTING.md`, and the guides for the
areas it touches.
- Cut the quest branch (the quest path without `.md`) from that base and claim
it with an empty placeholder commit whose message contains a freshly
generated UUID, pushed immediately with `git push origin HEAD` after
pointing the upstream at the base. When triage hands over an existing branch to
continue, rebase it onto the base and claim it the same way, but push the
placeholder with `--force-with-lease` pinned to the tip triage inspected, so
a second adopter loses the race rather than joining it. The UUID is what makes the claim a race:
two agents claiming the same quest from the same base in the same second
otherwise produce the same commit object, and the loser's push succeeds as
already-up-to-date instead of being rejected. A rejected push lost the race:
stop and report. Never force the claim push; `--force-with-lease` pinned to
its own claim is fine after a rebase.
- Implement, run `just fix`, `just check`, and `just test` through
`nix develop --command`, exercise the changed surface for real, walk the
Cross-Package Sync table, and open a PR per `CONTRIBUTING.md`, deleting the
quest and every reference to it in that same PR.
- Leave package versions and lockfile version metadata alone.
- Name in the PR any check that did not run, rather than claiming it or leaving
it out.
- Never deploy, apply, or mutate anything outside the repository.
- On a blocker: write what it learned into the quest so the next attempt starts
ahead, push that, then stop and report rather than improvising past it.

**The scope ends at the open PR.** Neither you nor the agents merge one, and
nobody waits on CI. Report each PR as it lands, raise blockers for the user to
decide, and hand back what is still open.
4 changes: 4 additions & 0 deletions .claude/skills/spawn-quest/agents/openai.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
interface:
display_name: "Spawn Quest"
short_description: "Triage a milestone's quests and spawn agents for the ready ones"
default_prompt: "Use $spawn-quest to triage a scope's quests and spawn agents for the ones worth starting now."
58 changes: 54 additions & 4 deletions .github/workflows/nightly.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,10 @@ name: Nightly
# that a PR gate can't justify for how rarely it catches something. `obs` is
# diff-independent because its PR-time counterpart can't be: obs.yml has to
# name the paths that can break an external link to libmoq.a, and no list of
# paths covers every one of them (see the comment there). `windows` is
# diff-independent because what it catches is a whole target's worth of
# `#[cfg(target_os = "windows")]` code that no Linux job compiles at all, and a
# Windows runner is too slow to gate every PR on.
# paths covers every one of them (see the comment there). `windows` and `macos`
# are diff-independent because what they catch is a whole target's worth of
# `#[cfg(target_os = ...)]` code that no Linux job compiles at all, and those
# runners are throttled too hard to gate every PR on.
#
# A failure here lands on main rather than being caught in review, which is the
# accepted trade. Anything that must block a merge belongs in check.yml.
Expand Down Expand Up @@ -78,6 +78,21 @@ jobs:
if: ${{ !cancelled() }}
run: nix develop --command just obs ci

# The TS exporter's PCR release timing. Everything else about the stream
# can be graded from a capture, but *when* the bytes were handed over
# cannot: the grader has to sit on the exporter's stdout for the length of
# the run, stamping each packet. That is a real-time window no per-PR gate
# should pay for, so it lives here (see test/ts/README.md).
#
# 120 s rather than the 20 s default, because the drift term needs it. The
# exporter builds its mux buffer once and holds it, and a window that ends
# while it is still filling cannot tell that from a pipe running slow: the
# lag reaches ~480 ms over the first ~48 s and is flat after. Nightly is the
# one arm with the wall-clock time to see the flat part.
- name: TS timing
if: ${{ !cancelled() }}
run: nix develop --command just test ts --live --duration 120

# `just rs windows` is the only thing that compiles moq-video's Media
# Foundation capture/encode/decode, its D3D11 frames, and every
# `#[cfg(target_os = "windows")]` test module. The Linux gate skips all of it,
Expand Down Expand Up @@ -119,3 +134,38 @@ jobs:
- name: Check
shell: bash
run: just rs windows

# `just rs macos` is the only thing that compiles moq-video's VideoToolbox
# encode/decode and its ScreenCaptureKit / AVFoundation capture, plus
# moq-audio's ScreenCaptureKit system audio and its TCC permission pre-check.
# The Linux gate skips all of it. moq-video has a release-time backstop, since
# libmoq's `libmoq-v*` tag build compiles it on Apple Silicon, but moq-audio
# has none: libmoq and moq-ffi take it codecs-only, so no release build ever
# compiles its capture backend.
#
# Same shape as `windows` and for the same reasons: a separate job because it
# needs an Apple host and the runner-native toolchain, and no Swatinem cache
# because a once-a-day job shouldn't evict the Linux `target/` that every pull
# request restores. swift.yml already compiles moq-ffi here, so this stays
# scoped to the two crates holding the Apple-gated code.
macos:
name: macOS
runs-on: macos-latest
timeout-minutes: 60

steps:
- name: Checkout
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false

- name: Install Rust
uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable

# Pinned: `--locked` fixes just's own dependencies, not which version of
# just cargo selects.
- name: Install just
run: cargo install --locked just@1.52.0

- name: Check
run: just rs macos
4 changes: 2 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ One tool stays unrequired: `swift` exists only on macOS, so swift.yml is its gat

Two path-filtered workflows run recipes of their own alongside `check.yml`, each for something the Linux `just check` can't reach: swift.yml (`swift/scripts/check.sh`, on a Mac) and obs.yml (`just obs ci`, which links the OBS plugin against nixpkgs' libobs/Qt6 -- Linux is the only platform where that needs no obs-deps download).

Four workspace-wide gates live outside the PR path, in `.github/workflows/nightly.yml`: `just rs audit` (cargo-deny) because an advisory lands without this repo changing, `just rs features` (the `--all-features` and `--no-default-features` compiles) because each is a full extra workspace compile that shares almost nothing with the default one, `just obs ci` because obs.yml's path filter can't be complete (a build script can change what linking `libmoq.a` needs without touching a manifest), and `just rs windows` on a Windows runner because the Linux jobs never compile the `#[cfg(target_os = "windows")]` code at all. The PR check makes one scoped exception: when `moq-tokio` is selected, it compiles that crate alone with no, default, and all features because workspace feature unification otherwise hides its zero-feature build. A break in any other feature permutation lands on `main` rather than being caught in review, which is the accepted trade; anything that must block a merge belongs in `check`.
Five workspace-wide gates live outside the PR path, in `.github/workflows/nightly.yml`: `just rs audit` (cargo-deny) because an advisory lands without this repo changing, `just rs features` (the `--all-features` and `--no-default-features` compiles) because each is a full extra workspace compile that shares almost nothing with the default one, `just obs ci` because obs.yml's path filter can't be complete (a build script can change what linking `libmoq.a` needs without touching a manifest), and `just rs windows` / `just rs macos` on their own runners because the Linux jobs never compile the `#[cfg(target_os = ...)]` code at all. The PR check makes one scoped exception: when `moq-tokio` is selected, it compiles that crate alone with no, default, and all features because workspace feature unification otherwise hides its zero-feature build. A break in any other feature permutation lands on `main` rather than being caught in review, which is the accepted trade; anything that must block a merge belongs in `check`.

## Architecture

Expand Down Expand Up @@ -74,7 +74,7 @@ Top-level layout only. Per-crate and per-package detail lives in the nested guid
- `/bench/` - Repository-level benchmark orchestration, workload fixtures, and methodology. Rust benchmark binaries and microbenchmarks stay under `/rs/`.
- `/js/` - TypeScript/JavaScript packages for the browser, published as `@moq/*`. See `js/CLAUDE.md`.
- `/py/`, `/swift/`, `/kt/`, `/go/`, `/dart/` - language wrappers over `rs/moq-ffi` (see [Language Bindings](#language-bindings)). `/py/` has `py/CLAUDE.md`; the others defer to their `README.md`.
- `/cpp/` - C/C++ consumers of `libmoq`. `cpp/obs/` is the OBS Studio plugin (CMake; links `libmoq` via `MOQ_LOCAL`), licensed GPL-2.0-or-later because it links `libobs`. `just check` type-checks it via `just obs compile`, which needs headers rather than an obs-deps download, and obs.yml links it on Linux for `cpp/obs/` and `rs/libmoq/` PRs. Still manual, like `just rs macos`: `just obs build` (a loadable plugin, and the only path on macOS/Windows) and `just obs test` (`cpp/obs/test/` against stubbed libobs/libmoq under ThreadSanitizer). See `doc/bin/obs.md`.
- `/cpp/` - C/C++ consumers of `libmoq`. `cpp/obs/` is the OBS Studio plugin (CMake; links `libmoq` via `MOQ_LOCAL`), licensed GPL-2.0-or-later because it links `libobs`. `just check` type-checks it via `just obs compile`, which needs headers rather than an obs-deps download, and obs.yml links it on Linux for `cpp/obs/` and `rs/libmoq/` PRs. Still manual: `just obs build` (a loadable plugin, and the only path on macOS/Windows) and `just obs test` (`cpp/obs/test/` against stubbed libobs/libmoq under ThreadSanitizer). See `doc/bin/obs.md`.
- `/demo/` - demos and test media: relay configs, the web demo, MoQ Boy, media hosting, and a network throttle script.
- `/test/` - test harnesses that span more than one language or need a server. `test/smoke/` is the cross-language interop matrix (`just test smoke[-full]`); `test/wasm/` runs the `@moq/wasm` bindings in headless Chromium against a real relay (`just test wasm`), which is the only behavioral coverage `rs/moq-wasm` has.
- `/doc/` - documentation site (VitePress, deployed via Cloudflare). The `/draft/` section is generated from `drafts/` by `doc/.vitepress/drafts.ts`.
Expand Down
1 change: 1 addition & 0 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 6 additions & 6 deletions bun.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

88 changes: 44 additions & 44 deletions cpp/obs/buildspec.json
Original file line number Diff line number Diff line change
@@ -1,45 +1,45 @@
{
"dependencies": {
"obs-studio": {
"version": "31.1.1",
"baseUrl": "https://github.com/obsproject/obs-studio/archive/refs/tags",
"label": "OBS sources",
"hashes": {
"macos": "39751f067bacc13d44b116c5138491b5f1391f91516d3d590d874edd21292291",
"windows-x64": "2c8427c10b55ac6d68008df2e9a3e82f4647aaad18f105e30d4713c2de678ccf"
}
},
"prebuilt": {
"version": "2025-07-11",
"baseUrl": "https://github.com/obsproject/obs-deps/releases/download",
"label": "Pre-Built obs-deps",
"hashes": {
"macos": "495687e63383d1a287684b6e2e9bfe246bb8f156fe265926afb1a325af1edd2a",
"windows-x64": "c8c642c1070dc31ce9a0f1e4cef5bb992f4bff4882255788b5da12129e85caa7"
}
},
"qt6": {
"version": "2025-07-11",
"baseUrl": "https://github.com/obsproject/obs-deps/releases/download",
"label": "Pre-Built Qt6",
"hashes": {
"macos": "d3f5f04b6ea486e032530bdf0187cbda9a54e0a49621a4c8ba984c5023998867",
"windows-x64": "0e76bf0555dd5382838850b748d3dcfab44a1e1058441309ab54e1a65b156d0a"
},
"debugSymbols": {
"windows-x64": "11b7be92cf66a273299b8f3515c07a5cfb61614b59a4e67f7fc5ecba5e2bdf21"
}
}
},
"platformConfig": {
"macos": {
"bundleId": "dev.montevideotech.obs-moq"
}
},
"name": "obs-moq",
"displayName": "MOQ for OBS",
"version": "0.0.1",
"author": "Montevideo Tech",
"website": "https://montevideotech.dev",
"email": "emil@qualabs.com"
}
"dependencies": {
"obs-studio": {
"version": "32.2.2",
"baseUrl": "https://github.com/obsproject/obs-studio/archive/refs/tags",
"label": "OBS sources",
"hashes": {
"macos": "35d3cd0979d65664fada7119fdb612eca7c34b61a1623a330caec74bf72626c4",
"windows-x64": "f15f001f1fa526405318835f44f9910046502f496ebc3a30d5296a5018b831aa"
}
},
"prebuilt": {
"version": "2026-07-15",
"baseUrl": "https://github.com/obsproject/obs-deps/releases/download",
"label": "Pre-Built obs-deps",
"hashes": {
"macos": "4ecb4c598dfa853168df6c2a0c4e0ffec8495a81fbd1ba051ef88ecd5e0f7e53",
"windows-x64": "6f90e9598fa10cff5ad23cdcfae49b87868c07bf896b02cd464582b4ce2f2ba9"
}
},
"qt6": {
"version": "2026-07-15",
"baseUrl": "https://github.com/obsproject/obs-deps/releases/download",
"label": "Pre-Built Qt6",
"hashes": {
"macos": "d4b8058612a7067e44b2205fe7925ee24e9ec6b15ac8c29d3e6230c70030b102",
"windows-x64": "7c7f985711d80467bdc1795b6592275a27d5b0e5a2c7a61db1f2c1d08d6a5579"
},
"debugSymbols": {
"windows-x64": "471d0b2191c424a520a51d064f3741084f117e1ff6ee5af1d16aabcdbacc6659"
}
}
},
"platformConfig": {
"macos": {
"bundleId": "dev.montevideotech.obs-moq"
}
},
"name": "obs-moq",
"displayName": "MOQ for OBS",
"version": "0.0.1",
"author": "Montevideo Tech",
"website": "https://montevideotech.dev",
"email": "emil@qualabs.com"
}
Loading
Loading