From 3b7b0d64593aa959b550695f8d6c8af8b89f2a1c Mon Sep 17 00:00:00 2001 From: opencode controller Date: Mon, 29 Jun 2026 20:27:01 -0400 Subject: [PATCH] docs: propagate rutster-trunk rename + repo URL through plans/specs/DEVELOPMENT MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Mechanical propagation of the crate rename ( rutster-signaling-sip → rutster-trunk ) and the repo URL fix ( github.com/anomalyco → git.adlee.work/alee ) through the documents that name them: - docs/DEVELOPMENT.md: crate-layout sketch + stub-crate description. - docs/superpowers/plans/2026-06-28-slice-1-webrtc-loopback.md: the workspace members list in the plan's binding-values section — repository URL updated. - docs/superpowers/plans/2026-06-28-slice-2-agent-tap.md: workspace members list in binding-values + crate-layout sketch in the file- structure section (rutster-signaling-sip → rutster-trunk). - docs/superpowers/specs/2026-06-28-slice-2-agent-tap-design.md: §2.1 workspace-layout sketch's STUB crate-row. No content changes beyond the substitutions; the slice-2 spec/plan body (protocol, TapAudioPipe, TapClient, TapEngine, lifecycle, done- criteria) is untouched. --- docs/DEVELOPMENT.md | 4 ++-- .../superpowers/plans/2026-06-28-slice-1-webrtc-loopback.md | 2 +- docs/superpowers/plans/2026-06-28-slice-2-agent-tap.md | 6 +++--- .../specs/2026-06-28-slice-2-agent-tap-design.md | 2 +- 4 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md index 2600f2a..db752e8 100644 --- a/docs/DEVELOPMENT.md +++ b/docs/DEVELOPMENT.md @@ -34,13 +34,13 @@ rutster/ │ │ ├── src/rtc_session.rs # RtcSession (per-peer owner) │ │ └── src/loop_driver.rs # str0m poll loop │ ├── rutster-call-model/ # the Channel/Leg object embryo -│ ├── rutster-signaling-sip/ # stub until spearhead step 5 +│ ├── rutster-trunk/ # stub until spearhead step 5 │ ├── rutster-tap/ # stub until spearhead step 2 │ └── rutster-spend/ # stub until spearhead step 6 └── fuzz/ # placeholder cargo-fuzz dir (real harnesses: step 5) ``` -The three stub crates (`rutster-signaling-sip`, `rutster-tap`, +The three stub crates (`rutster-trunk`, `rutster-tap`, `rutster-spend`) exist to lock the ADR-0002 boundary shape without anticipating code. Each is a `lib.rs` with a `//!` module doc comment describing what will land there and when. Don't fill them in early — diff --git a/docs/superpowers/plans/2026-06-28-slice-1-webrtc-loopback.md b/docs/superpowers/plans/2026-06-28-slice-1-webrtc-loopback.md index 2818d00..ccb6bd1 100644 --- a/docs/superpowers/plans/2026-06-28-slice-1-webrtc-loopback.md +++ b/docs/superpowers/plans/2026-06-28-slice-1-webrtc-loopback.md @@ -132,7 +132,7 @@ members = [ [workspace.package] license = "GPL-3.0-or-later" edition = "2021" -repository = "https://github.com/anomalyco/rutster" +repository = "https://git.adlee.work/alee/rutster" # Pinned versions for all member crates. References are `foo.workspace = true` # in the member manifest. Keeps the dep tree unified (§2.1). diff --git a/docs/superpowers/plans/2026-06-28-slice-2-agent-tap.md b/docs/superpowers/plans/2026-06-28-slice-2-agent-tap.md index 9e091b9..6877a1a 100644 --- a/docs/superpowers/plans/2026-06-28-slice-2-agent-tap.md +++ b/docs/superpowers/plans/2026-06-28-slice-2-agent-tap.md @@ -18,7 +18,7 @@ Binding values for every task — copy verbatim where used. - **License:** every crate manifest sets `license = "GPL-3.0-or-later"` (ADR-0004). Reuse the SPDX expression string `"GPL-3.0-or-later"`. The `[workspace.package]` already sets this; new crates inherit via `license.workspace = true`. - **Workspace:** root `Cargo.toml` is `[workspace]` with `[workspace.dependencies]` (slice-1 §2.1). New deps go in `[workspace.dependencies]` in the root; member crates reference with `dep.workspace = true`. -- **Workspace members (delta on slice-1):** slice-1's six members (`crates/rutster`, `crates/rutster-media`, `crates/rutster-call-model`, `crates/rutster-signaling-sip`, `crates/rutster-tap`, `crates/rutster-spend`) plus ONE new member: `crates/rutster-tap-echo`. Total = 7 members. `crates/rutster-tap` transitions from stub → real. +- **Workspace members (delta on slice-1):** slice-1's six members (`crates/rutster`, `crates/rutster-media`, `crates/rutster-call-model`, `crates/rutster-trunk`, `crates/rutster-tap`, `crates/rutster-spend`) plus ONE new member: `crates/rutster-tap-echo`. Total = 7 members. `crates/rutster-tap` transitions from stub → real. - **Dependency direction (spec §2.1):** `rutster-tap` → `rutster-media` (for `PcmFrame`; re-exported so one canonical home remains); `rutster` (binary) → `rutster-tap` (for `TapAudioPipe`/`TapClient` types) and → `rutster-tap-echo` (dev-binary + integration-test `EchoServer`); `rutster-tap-echo` → `rutster-tap` (reuses protocol types — the wire-types-reusable contract test); `rutster-call-model` stays a leaf; `rutster-media` does **not** depend on `rutster-tap` (never). - **PCM format (slice-1 §3.1, §3.9, ARCHITECTURE.md):** 16-bit signed mono, 24 kHz, fixed 20 ms frame = **480 samples**. `PcmFrame { samples: [i16; 480] }` lives in `rutster-media` (single canonical home); `rutster-tap` re-exports it. - **Wire byte order (spec §3, §9):** PCM inside the base64 payload is **explicit little-endian**. Encoders use `i16::to_le_bytes()`; decoders use `i16::from_le_bytes()`. No host-endian silent hazard. @@ -78,7 +78,7 @@ rutster/ │ │ ├── Cargo.toml # deps: rutster-tap, tokio, tokio-tungstenite, futures-util, serde_json, tracing │ │ ├── src/lib.rs # EchoServer::start(addr) -> EchoHandle; echo_frame() logic │ │ └── src/main.rs # standalone binary: bind ws://127.0.0.1:8081/echo, echo loop -│ ├── rutster-signaling-sip/ # STUB (unchanged) +│ ├── rutster-trunk/ # STUB (unchanged) │ └── rutster-spend/ # STUB (unchanged) └── examples/ └── echo_brain/ @@ -137,7 +137,7 @@ members = [ "crates/rutster", "crates/rutster-call-model", "crates/rutster-media", - "crates/rutster-signaling-sip", + "crates/rutster-trunk", "crates/rutster-tap", "crates/rutster-tap-echo", "crates/rutster-spend", diff --git a/docs/superpowers/specs/2026-06-28-slice-2-agent-tap-design.md b/docs/superpowers/specs/2026-06-28-slice-2-agent-tap-design.md index b729adf..6dc98f4 100644 --- a/docs/superpowers/specs/2026-06-28-slice-2-agent-tap-design.md +++ b/docs/superpowers/specs/2026-06-28-slice-2-agent-tap-design.md @@ -130,7 +130,7 @@ rutster/ │ ├── rutster-tap-echo/ # NEW crate: the Rust reference echo brain + test server │ │ ├── src/lib.rs # EchoServer::start(addr) -> JoinHandle + EchoHandle (test driver) │ │ └── src/main.rs # standalone binary: ws://127.0.0.1:, echo audio_in → audio_out -│ ├── rutster-signaling-sip/ # STUB (unchanged) +│ ├── rutster-trunk/ # STUB (unchanged) │ └── rutster-spend/ # STUB (unchanged) └── examples/ └── echo_brain/