diff --git a/Cargo.toml b/Cargo.toml
index c220572..c161388 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -4,7 +4,7 @@ version = "0.1.0"
 edition = "2021"
 license = "GPL-3.0-or-later"
 authors = ["Sulkta-Coop"]
-repository = "http://192.168.0.5:3001/Sulkta-Coop/strawcore"
+repository = "https://git.sulkta.com/Sulkta-Coop/strawcore"
 description = "Rust port of NewPipeExtractor (YT-only). Plugs into Straw via UniFFI."
 
 [lib]
diff --git a/README.md b/README.md
index 6833d16..9c7b8ac 100644
--- a/README.md
+++ b/README.md
@@ -1,27 +1,8 @@
 # strawcore
 
-Rust port of [NewPipeExtractor](https://github.com/TeamNewPipe/NewPipeExtractor) (v0.26.2), YouTube-only. Plugs into [Straw](http://192.168.0.5:3001/Sulkta-Coop/straw) via UniFFI.
+Rust port of [NewPipeExtractor](https://github.com/TeamNewPipe/NewPipeExtractor) (v0.26.2), YouTube-only. Plugs into [Straw](https://git.sulkta.com/Sulkta-Coop/straw) via UniFFI.
 
-## Why this exists
-
-`rustypipe` regex-parses YouTube's `player.js` and reimplements the signature deobfuscator in Rust. Every YT player rotation breaks it. NPE embeds Mozilla Rhino and executes the JS function live — resilient by design, and that's the architecture we're mirroring.
-
-The rustypipe-backed Straw build (vc=15..17) also routed playback through iOS-progressive URLs, which hit a server-side ~917 KiB end-byte cap. NPE uses the Android client + po_token → DASH manifest path, which doesn't see the cap. Same fix, different layer.
-
-See `memory/npe-audit-2026-05-24/SPEC.md` in the workspace repo for the full plan.
-
-## Status
-
-| Phase | Subsystem | Status |
-|---|---|---|
-| 1 | Foundation (downloader + service spine) | **in progress** |
-| 2 | JS engine (rquickjs + ress) | pending |
-| 3 | InnerTube + itag table | pending |
-| 4 | Stream extractor + DASH | pending |
-| 5 | PoTokenProvider trait + Android JNI bridge | pending |
-| 6 | Search + Channel + Playlist + Kiosks | pending |
-| 7 | UniFFI surface swap | pending |
-| 8 | Delete rustypipe everywhere | pending |
+`rustypipe` regex-parses YouTube's `player.js` and reimplements the signature deobfuscator in Rust — every YT player rotation breaks it. NPE embeds a JS engine and executes the function live, which survives rotations. strawcore mirrors that architecture on QuickJS via rquickjs.
 
 ## Build + test
 
diff --git a/src/downloader/mod.rs b/src/downloader/mod.rs
index c6e659d..b709902 100644
--- a/src/downloader/mod.rs
+++ b/src/downloader/mod.rs
@@ -1,7 +1,7 @@
 // Downloader contract — mirrors NPE's Downloader abstract class.
 //
-// Foundational invariants (SPEC §3, audited from NPE Downloader.java +
-// OkHttpDownloaderImpl in the NewPipe-app):
+// Foundational invariants (audited from NPE Downloader.java + the
+// NewPipe-app OkHttpDownloaderImpl):
 //
 //   * No automatic cookie jar. `Cookie:` header is hand-built per request.
 //   * HTTP non-2xx is NOT an error. Only HTTP 429 throws
diff --git a/src/downloader/request.rs b/src/downloader/request.rs
index 024cb86..e88a523 100644
--- a/src/downloader/request.rs
+++ b/src/downloader/request.rs
@@ -1,6 +1,6 @@
 // Request + RequestBuilder — mirrors NPE Request.java.
 //
-// PARITY: add_header silently overwrites instead of appending, per NPE
+// add_header silently overwrites instead of appending, per NPE
 // Request.java:215-221. Callers depend on this. append_header is our
 // own clean addition for callers we control.
 
@@ -91,7 +91,7 @@ impl RequestBuilder {
         }
     }
 
-    /// PARITY with NPE Request.Builder.addHeader: silently overwrites any
+    /// Mirrors NPE Request.Builder.addHeader: silently overwrites any
     /// existing values for `name`. Callers downstream of NPE-derived code
     /// depend on this. For new code prefer [`Self::append_header`].
     pub fn add_header(mut self, name: impl Into<String>, value: impl Into<String>) -> Self {
diff --git a/src/downloader/response.rs b/src/downloader/response.rs
index 4d00faf..cd34d32 100644
--- a/src/downloader/response.rs
+++ b/src/downloader/response.rs
@@ -1,8 +1,8 @@
 // Response — mirrors NPE Response.java.
 //
-// Header keys are lowercased (SPEC §3 invariant #3). latest_url tracks the
-// final URL after redirect chasing — used by every linkHandler and the
-// channel resolver loop.
+// Header keys are lowercased. latest_url tracks the final URL after
+// redirect chasing — used by every linkHandler and the channel resolver
+// loop.
 
 use std::collections::BTreeMap;
 
diff --git a/src/image.rs b/src/image.rs
index 25e3444..7fb0dc0 100644
--- a/src/image.rs
+++ b/src/image.rs
@@ -1,8 +1,7 @@
 // Image + ImageSet + ResolutionLevel. Mirrors NPE Image.java.
 //
-// HEIGHT_UNKNOWN / WIDTH_UNKNOWN are -1 sentinels per SPEC §3 invariant #10
-// — kept as i32, not Option<u32>, because several JSON output sites encode
-// this directly.
+// HEIGHT_UNKNOWN / WIDTH_UNKNOWN are -1 sentinels — kept as i32, not
+// Option<u32>, because several JSON output sites encode this directly.
 
 pub const HEIGHT_UNKNOWN: i32 = -1;
 pub const WIDTH_UNKNOWN: i32 = -1;
diff --git a/src/localization.rs b/src/localization.rs
index 822925f..21620dc 100644
--- a/src/localization.rs
+++ b/src/localization.rs
@@ -1,7 +1,7 @@
-// Localization + ContentCountry. Per SPEC §3 invariant #9, the DEFAULT
-// Localization is ("en", "GB") — not en-US, not the system locale.
-// NPE's Localization.java exposes ~100 country codes; we ship a small
-// in-source set today and grow as needed.
+// Localization + ContentCountry. The DEFAULT Localization is ("en", "GB")
+// — not en-US, not the system locale. NPE's Localization.java exposes
+// ~100 country codes; we ship a small in-source set today and grow as
+// needed.
 
 use std::fmt;
 
diff --git a/src/youtube/channel.rs b/src/youtube/channel.rs
index a28e3ed..cb5df07 100644
--- a/src/youtube/channel.rs
+++ b/src/youtube/channel.rs
@@ -8,9 +8,9 @@
 // URL, walks `endpoint.browseEndpoint.browseId` to get the UC... id, and
 // retries the browse call. Up to 3 redirect hops.
 //
-// Tab parsing (videos/shorts/live/playlists) is in audit Track D §5 —
-// `tabs[].tabRenderer.endpoint.browseEndpoint.params` is the magic
-// base64 needed to land on each tab.
+// Tab parsing (videos/shorts/live/playlists): the magic base64 needed to
+// land on each tab lives at
+// `tabs[].tabRenderer.endpoint.browseEndpoint.params`.
 
 use serde_json::Value;
 
@@ -88,8 +88,8 @@ pub fn resolve_handle_to_channel_id(url_fragment: &str) -> Result<String, Extrac
 }
 
 /// Magic params for the channel "Videos" tab — opaque base64. Same constant
-/// NPE uses (audit Track A §2.4). Sending it with the channel browseId
-/// switches YT's response from the Home tab to the Videos tab.
+/// NPE uses. Sending it with the channel browseId switches YT's response
+/// from the Home tab to the Videos tab.
 const CHANNEL_VIDEOS_TAB_PARAMS: &str = "EgZ2aWRlb3PyBgQKAjoA";
 
 pub fn fetch_channel_browse(channel_id: &str) -> Result<ChannelInfo, ExtractionError> {
diff --git a/src/youtube/client_request.rs b/src/youtube/client_request.rs
index 63f2547..55577f4 100644
--- a/src/youtube/client_request.rs
+++ b/src/youtube/client_request.rs
@@ -2,9 +2,9 @@
 // InnertubeClientRequestInfo.java + the prepareJsonBuilder() flow in
 // YoutubeParsingHelper.java:1494-1559.
 //
-// Wire-order matters (audit Track A §2.1) — `serde_json::json!` macro
-// preserves insertion order in the resulting Map, but we use a sequence
-// of `.insert()` calls into a `serde_json::Map` to be explicit.
+// Wire-order matters — `serde_json::json!` macro preserves insertion
+// order in the resulting Map, but we use a sequence of `.insert()`
+// calls into a `serde_json::Map` to be explicit.
 
 use serde_json::{json, Map, Value};
 
@@ -114,7 +114,7 @@ impl InnertubeClientRequestInfo {
 }
 
 /// Builds the InnerTube request envelope mirroring NPE prepareJsonBuilder.
-/// Insertion order matches NPE's wire-order verbatim (audit Track A §2.1).
+/// Insertion order matches NPE's wire-order verbatim.
 pub fn build_envelope(
     info: &InnertubeClientRequestInfo,
     localization: &Localization,
diff --git a/src/youtube/constants.rs b/src/youtube/constants.rs
index 6673da8..b5e2ac4 100644
--- a/src/youtube/constants.rs
+++ b/src/youtube/constants.rs
@@ -30,8 +30,8 @@ pub const ANDROID_CLIENT_ID: &str = "3";
 pub const ANDROID_CLIENT_NAME: &str = "ANDROID";
 pub const ANDROID_CLIENT_VERSION: &str = "21.03.36";
 
-// PARITY: NPE hard-codes androidSdkVersion=36 + osVersion=16 even though
-// the User-Agent advertises Android 15. DroidGuard doesn't check the
+// NPE hard-codes androidSdkVersion=36 + osVersion=16 even though the
+// User-Agent advertises Android 15. DroidGuard doesn't check the
 // InnerTube context so this mismatch is intentional and not a bug.
 pub const ANDROID_SDK_VERSION: u32 = 36;
 pub const ANDROID_OS_VERSION: &str = "16";
diff --git a/src/youtube/itag.rs b/src/youtube/itag.rs
index a6f6195..025bdc3 100644
--- a/src/youtube/itag.rs
+++ b/src/youtube/itag.rs
@@ -172,9 +172,7 @@ mod tests {
 
     #[test]
     fn table_has_57_entries() {
-        // Audit Track A §7 says "53" in prose but tallies the same 57
-        // entries below. NPE source ItagItem.java has 57 distinct itag
-        // IDs. Matches exactly.
+        // NPE source ItagItem.java has 57 distinct itag IDs. Matches exactly.
         assert_eq!(ITAG_TABLE.len(), 57);
     }
 
diff --git a/src/youtube/js/extractor.rs b/src/youtube/js/extractor.rs
index be27f38..3ec0883 100644
--- a/src/youtube/js/extractor.rs
+++ b/src/youtube/js/extractor.rs
@@ -5,7 +5,7 @@
 //   1. iframe_api regex (primary)
 //   2. embed/<videoId> page — Jsoup script-tag walk + jsUrl regex fallback
 //
-// PARITY: we deliberately reproduce NPE's bug where `select("script")
+// We deliberately reproduce NPE's bug where `select("script")
 // .attr("name", "player/base")` *mutates* the script tags and iterates ALL
 // of them. The intent was "find the script with name=player/base" but
 // Jsoup's attr-setter doesn't filter. Our walk does the same — iterate
@@ -77,7 +77,7 @@ fn extract_from_embed(downloader: &dyn Downloader, video_id: &str) -> Result<Str
         .map_err(|e| DeobfError::FetchEmbed(e.to_string()))?;
     let body = resp.response_body();
 
-    // PARITY: NPE iterates every <script> tag (the `.attr("name","player/base")`
+    // NPE iterates every <script> tag (the `.attr("name","player/base")`
     // call sets an attribute rather than filtering). We do the same.
     for caps in SCRIPT_TAG.captures_iter(body) {
         if let Some(src) = caps.get(1) {
diff --git a/src/youtube/js/nsig.rs b/src/youtube/js/nsig.rs
index ddf0814..f70c493 100644
--- a/src/youtube/js/nsig.rs
+++ b/src/youtube/js/nsig.rs
@@ -1,7 +1,7 @@
 // Throttling-parameter (nsig / `n=` URL param) deobfuscation function
 // extraction. Mirrors NPE services/youtube/YoutubeThrottlingParameterUtils.java.
 //
-// Flow per audit Track B §3:
+// Flow:
 //   1. Quick check: if URL doesn't contain `&n=` or `?n=`, return None.
 //      (60-900× perf win — load-bearing, NPE adds this 2025-07-10.)
 //   2. Walk DEOBFUSCATION_FUNCTION_NAME_REGEXES — first match wins.
@@ -41,9 +41,9 @@ pub fn throttling_parameter_from_url(url: &str) -> Option<String> {
 }
 
 /// Returns `(function_name, assembled_snippet)`. The snippet declares
-/// the function as `var <name> = function(...) { ... };` (explicit `var`
-/// is a PORT DEVIATION — NPE relies on Rhino's non-strict bare-assignment
-/// behavior; QuickJS rejects it).
+/// the function as `var <name> = function(...) { ... };` — the explicit
+/// `var` differs from NPE, which relies on Rhino's non-strict
+/// bare-assignment behavior. QuickJS rejects bare assignment.
 pub fn build_deobfuscator(player_code: &str) -> Result<(String, String), DeobfError> {
     let name = deobfuscation_function_name(player_code)?;
     let body = deobfuscation_function_body(player_code, &name)?;
diff --git a/src/youtube/js/player_manager.rs b/src/youtube/js/player_manager.rs
index c16d503..46c4f72 100644
--- a/src/youtube/js/player_manager.rs
+++ b/src/youtube/js/player_manager.rs
@@ -2,7 +2,7 @@
 // Mirrors NPE services/youtube/YoutubeJavaScriptPlayerManager.java (the
 // sole public class in the JS subsystem).
 //
-// Cache layout per audit Track B §5.3:
+// Cache layout:
 //   * cached_player_code         — process-lifetime, until clear_all_caches
 //   * cached_signature_timestamp
 //   * cached_sig_snippet         — assembled JS, ready for runtime::run
diff --git a/src/youtube/js/runtime.rs b/src/youtube/js/runtime.rs
index 0005d5d..b82caf5 100644
--- a/src/youtube/js/runtime.rs
+++ b/src/youtube/js/runtime.rs
@@ -3,7 +3,7 @@
 // NPE's Rhino surface is 35 lines: compile_or_throw + run. We replicate
 // the same shape on QuickJS via rquickjs.
 //
-// Mirroring decisions per audit Track B §4:
+// Mirroring decisions:
 //   * One Runtime + Context per call. QuickJS contexts are cheap; this
 //     mirrors NPE's `Context.enter()` per call.
 //   * Context::full gives the ECMAScript built-ins (Array, String, Math)
diff --git a/src/youtube/js/signature.rs b/src/youtube/js/signature.rs
index 0bb9403..423f718 100644
--- a/src/youtube/js/signature.rs
+++ b/src/youtube/js/signature.rs
@@ -1,7 +1,7 @@
 // Signature (sig) deobfuscation function extraction.
 // Mirrors NPE services/youtube/YoutubeSignatureUtils.java.
 //
-// Flow per audit Track B §2:
+// Flow:
 //   1. Walk FUNCTION_REGEXES — first match wins. Captures (a) function
 //      name (group 1) and optionally (b) additional-params prefix
 //      (group 2 on regex 0).
@@ -11,7 +11,7 @@
 //   5. Extract global string array.
 //   6. Assemble: globalVar; helperObject; sigBody; function deobfuscate(a){return name(addlParams, a);}
 //
-// Also exposes the signature timestamp extraction (§2.7).
+// Also exposes the signature timestamp extraction.
 
 use once_cell::sync::Lazy;
 use regex::Regex;
@@ -29,18 +29,18 @@ pub const DEOBFUSCATION_FUNCTION_NAME: &str = "deobfuscate";
 /// Group 2 = additional-params prefix on regex 0 (e.g. "43,"). For other
 /// regexes group 2 (if present) is a backref or param name — NPE has a
 /// latent bug where the groupCount>1 branch fires anyway, which we
-/// faithfully reproduce per audit Track B §2.1.
+/// faithfully reproduce.
 static FUNCTION_REGEXES_SRC: &[&str] = &[
     r#"\b(?:[a-zA-Z0-9_$]+)&&\((?:[a-zA-Z0-9_$]+)=([a-zA-Z0-9_$]{2,})\((\d+,)decodeURIComponent\((?:[a-zA-Z0-9_$]+)\)\)"#,
     r#"\b(?:[a-zA-Z0-9_$]+)&&\((?:[a-zA-Z0-9_$]+)=([a-zA-Z0-9_$]{2,})\(decodeURIComponent\((?:[a-zA-Z0-9_$]+)\)\)"#,
     r#"\bm=([a-zA-Z0-9$]{2,})\(decodeURIComponent\(h\.s\)\)"#,
     r#"\bc&&\(c=([a-zA-Z0-9$]{2,})\(decodeURIComponent\(c\)\)"#,
     r#"(?:\b|[^a-zA-Z0-9$])([a-zA-Z0-9$]{2,})\s*=\s*function\(\s*a\s*\)\s*\{\s*a\s*=\s*a\.split\(\s*""\s*\)"#,
-    // PORT DEVIATION: NPE's 6th regex uses Java backref `\2` to match
-    // the same param name twice. Rust's `regex` crate doesn't support
-    // backrefs (linear-time NFA). Dropping it. Audit Track B §2.1 flags
-    // this same regex as having a latent groupCount bug — the loss is
-    // a fallback path that NPE itself half-broke.
+    // NPE's 6th regex uses Java backref `\2` to match the same param
+    // name twice. Rust's `regex` crate doesn't support backrefs
+    // (linear-time NFA). Dropped — NPE's same regex also has a latent
+    // groupCount bug, so what we lose is a fallback path NPE itself
+    // half-broke.
     r#"([a-zA-Z0-9$]+)\s*=\s*function\([a-zA-Z0-9$]+\)\s*\{\s*[a-zA-Z0-9$]+\s*=\s*[a-zA-Z0-9$]+\.split\(""\)\s*;"#,
 ];
 
@@ -48,16 +48,15 @@ static FUNCTION_REGEXES: Lazy<Vec<Regex>> = Lazy::new(|| {
     FUNCTION_REGEXES_SRC.iter().map(|s| Regex::new(s).unwrap()).collect()
 });
 
-// PARITY: NPE's helper-object body regex uses Java atomic group `(?>...)`.
+// NPE's helper-object body regex uses Java atomic group `(?>...)`.
 // Rust's `regex` crate is backtracking-free already, so we drop the
-// atomic marker. See audit Track B §2.3.
+// atomic marker.
 static SIG_DEOBF_HELPER_OBJ_NAME: Lazy<Regex> =
     Lazy::new(|| Regex::new(r"[;,]([A-Za-z0-9_$]{2,})\[..").unwrap());
 
 static SIG_DEOBF_GLOBAL_ARRAY: Lazy<Regex> = Lazy::new(|| {
     // `[A-z]` is the NPE-original loose ASCII range (covers A-Z, a-z, plus
-    // a handful of punctuation between). Audit Track B §2.4 calls this
-    // intentional. Kept verbatim.
+    // a handful of punctuation between). Intentional in NPE — kept verbatim.
     Regex::new(r#"(var [A-z]=['"].*['"].split\("[;{]"\))"#).unwrap()
 });
 
@@ -74,10 +73,10 @@ pub fn deobfuscation_function_name_and_params(
             if name.is_empty() {
                 continue;
             }
-            // PARITY with NPE: if the regex has a group 2, treat it as a
-            // literal prefix even when it's actually a backref/param name.
-            // The resulting snippet would just fail to compile for those
-            // cases, falling through to the next attempt — same as NPE.
+            // If the regex has a group 2, treat it as a literal prefix
+            // even when it's actually a backref/param name — matches
+            // NPE. The resulting snippet would just fail to compile for
+            // those cases, falling through to the next attempt.
             let extra = c.get(2).map(|m| m.as_str().to_string()).unwrap_or_default();
             return Ok((name, extra));
         }
@@ -94,7 +93,7 @@ pub fn signature_timestamp(player_code: &str) -> Result<i32, DeobfError> {
 }
 
 /// Extracts the sig deobfuscation body. Tries lexer first, falls back to
-/// the naive regex per NPE §2.2.
+/// the naive regex.
 pub fn deobfuscate_function_body(
     player_code: &str,
     function_name: &str,
@@ -151,11 +150,11 @@ pub fn global_array(player_code: &str) -> Result<String, DeobfError> {
 /// Assembles the final JS snippet — globalVar; helperObject; sigBody;
 /// function deobfuscate(a) { return <name>(<extra>a); }
 ///
-/// PORT DEVIATION from NPE: we prepend `var ` to the sig body so the
-/// function name is an explicit global declaration. NPE relies on
-/// Rhino's non-strict mode auto-creating globals from bare assignment
-/// (`xyz=function(){}`). QuickJS treats undeclared-bare assignment as an
-/// error. Functionally identical once the function is in scope.
+/// We prepend `var ` to the sig body so the function name is an explicit
+/// global declaration. NPE relies on Rhino's non-strict mode auto-
+/// creating globals from bare assignment (`xyz=function(){}`); QuickJS
+/// treats undeclared-bare assignment as an error. Functionally identical
+/// once the function is in scope.
 pub fn assemble_snippet(
     global_var: &str,
     helper_object: &str,
diff --git a/src/youtube/linkhandler/mod.rs b/src/youtube/linkhandler/mod.rs
index 26d7404..4f2f671 100644
--- a/src/youtube/linkhandler/mod.rs
+++ b/src/youtube/linkhandler/mod.rs
@@ -2,9 +2,9 @@
 // resource categories. Mirrors NPE
 // services/youtube/linkHandler/Youtube*LinkHandlerFactory.java.
 //
-// PORT SCOPE (per SPEC §6.6): we keep youtube.com / youtube-nocookie.com
-// / youtu.be / m.youtube.com / music.youtube.com. The 27-host Invidious
-// mirror list in NPE is dropped — Sulkta isn't an Invidious mirror.
+// Accepted hosts: youtube.com / youtube-nocookie.com / youtu.be /
+// m.youtube.com / music.youtube.com. The 27-host Invidious mirror list
+// in NPE is dropped — strawcore isn't an Invidious mirror.
 
 pub mod channel;
 pub mod search;
@@ -24,7 +24,7 @@ pub enum LinkError {
     MalformedId(String),
 }
 
-/// The acceptable hosts for first-party YT links. Audit Track D §6.
+/// The acceptable hosts for first-party YT links.
 pub const ACCEPTED_HOSTS: &[&str] = &[
     "youtube.com",
     "www.youtube.com",
diff --git a/src/youtube/linkhandler/search.rs b/src/youtube/linkhandler/search.rs
index 23a963c..6dc0e82 100644
--- a/src/youtube/linkhandler/search.rs
+++ b/src/youtube/linkhandler/search.rs
@@ -1,6 +1,6 @@
 // YoutubeSearchQueryHandlerFactory + search filters. Filter params are
 // opaque base64 protobufs — NPE doesn't decode them, just sends the
-// magic strings. We mirror that. See audit Track D §3.
+// magic strings. We mirror that.
 //
 // Music* filter variants were ported from NPE but never wired through
 // (search_extractor rejected anything with `uses_music_endpoint()`).
diff --git a/src/youtube/parsing.rs b/src/youtube/parsing.rs
index 6f6aaf1..f6e2adb 100644
--- a/src/youtube/parsing.rs
+++ b/src/youtube/parsing.rs
@@ -55,7 +55,7 @@ pub fn youtube_post_headers() -> Vec<(String, String)> {
 }
 
 /// Mobile (Android/iOS) POST headers — UA + format-version only. No
-/// X-YouTube-Client-Name, no Origin/Referer, no Cookie (audit Track A §6.2).
+/// X-YouTube-Client-Name, no Origin/Referer, no Cookie.
 pub fn mobile_post_headers(user_agent: &str) -> Vec<(String, String)> {
     vec![
         ("Content-Type".into(), "application/json".into()),
diff --git a/src/youtube/potoken/mod.rs b/src/youtube/potoken/mod.rs
index f453901..86b4630 100644
--- a/src/youtube/potoken/mod.rs
+++ b/src/youtube/potoken/mod.rs
@@ -7,7 +7,7 @@
 // adapter that calls into PoTokenWebView (lifted verbatim from NewPipe
 // app under GPL-3.0 compat).
 //
-// Two distinct token strings per call (audit Track E):
+// Two distinct token strings per call:
 //   * player_request_po_token  — goes into JSON body
 //                                serviceIntegrityDimensions.poToken
 //   * streaming_data_po_token  — goes into URL &pot=<...>
@@ -17,11 +17,10 @@
 // player request MUST send the same visitorData in context.client, or
 // YT 403's the streaming URLs.
 //
-// FIX (audit Track E §2.2): NPE's Java API returns null both for
-// "provider declined" and "provider errored." We split: Ok(None) =
-// declined (no provider available for this client / video), Err = the
-// provider tried and failed (the caller should still attempt extraction
-// without po_token).
+// NPE's Java API returns null both for "provider declined" and "provider
+// errored." We split: Ok(None) = declined (no provider available for
+// this client / video), Err = the provider tried and failed (the caller
+// should still attempt extraction without po_token).
 
 pub mod noop;
 
diff --git a/src/youtube/search_extractor.rs b/src/youtube/search_extractor.rs
index b50b280..8a9dc29 100644
--- a/src/youtube/search_extractor.rs
+++ b/src/youtube/search_extractor.rs
@@ -2,7 +2,7 @@
 // services/youtube/extractors/YoutubeSearchExtractor.java.
 //
 // Calls /youtubei/v1/search with the WEB client (via desktop fast-path
-// envelope). Body shape per audit Track D §3:
+// envelope). Body shape:
 //   {
 //     "context": { "client": { ... } },
 //     "query":  "<query>",
diff --git a/src/youtube/stream_extractor.rs b/src/youtube/stream_extractor.rs
index ced32a6..4341608 100644
--- a/src/youtube/stream_extractor.rs
+++ b/src/youtube/stream_extractor.rs
@@ -1,9 +1,9 @@
 // YoutubeStreamExtractor — orchestrator. Mirrors NPE
 // services/youtube/extractors/YoutubeStreamExtractor.java:onFetchPage().
 //
-// Order (per audit Track C §1.2):
-//   1. Optional Android po_token from PoTokenProvider (Phase 5 wires this;
-//      until then we always go anonymous → reel endpoint).
+// Order:
+//   1. Optional Android po_token from PoTokenProvider (until a provider
+//      is registered we always go anonymous → reel endpoint).
 //   2. Android `/player` (if po_token) or `/reel/reel_item_watch` (anon).
 //      checkPlayabilityStatus → typed ContentUnavailable variants.
 //      isPlayerResponseNotValid → reject the "you're a bot" decoy.
@@ -12,7 +12,7 @@
 //      Exceptions swallowed → falls back to Android-response thumbnails.
 //   5. WEB `/next` — description + related + chapters. Mandatory.
 //
-// Per-format URL post-processing (audit Track C §4.1):
+// Per-format URL post-processing:
 //   * If format has `url` → use as-is (Android + iOS path).
 //   * Else parse `signatureCipher` → deobfuscate `s` → assemble
 //     `url&sp=<decoded>` (WEB path; not exercised in the current
@@ -699,9 +699,8 @@ fn codec_from_mime(fmt: &Value) -> Option<String> {
     Some(after[..end].to_string())
 }
 
-/// FIX (NPE deviation flagged in SPEC §5): dedup by itag id + delivery
-/// method, NOT by `mediaFormat.id` — NPE's dedup collides itag 140 and
-/// 141 because both are M4A.
+/// Dedup by itag id + delivery method, NOT by `mediaFormat.id` — NPE's
+/// dedup collides itag 140 and 141 because both are M4A.
 fn push_audio_dedup(list: &mut Vec<AudioStream>, candidate: AudioStream) {
     if list
         .iter()
diff --git a/src/youtube/stream_helper.rs b/src/youtube/stream_helper.rs
index e6c60d6..69b2571 100644
--- a/src/youtube/stream_helper.rs
+++ b/src/youtube/stream_helper.rs
@@ -72,8 +72,8 @@ fn envelope_to_body(envelope: Value) -> Map<String, Value> {
     }
 }
 
-/// WEB-client metadata-only /player call. Per audit Track A §4.4 — used
-/// for microformat + thumbnails only; never used as a stream URL source.
+/// WEB-client metadata-only /player call — used for microformat +
+/// thumbnails only; never used as a stream URL source.
 pub fn get_web_metadata_player_response(
     video_id: &str,
     localization: &Localization,
diff --git a/tests/foundation_smoke.rs b/tests/foundation_smoke.rs
index 15dab90..1fb88f2 100644
--- a/tests/foundation_smoke.rs
+++ b/tests/foundation_smoke.rs
@@ -1,10 +1,9 @@
-// Phase 1 smoke — exercises the foundation against live httpbin.org.
+// Foundation smoke — exercises the downloader/service-spine against
+// live httpbin.org. Builds a Request, sends through default Downloader,
+// parses Response, confirms latest_url follows redirects.
 //
-// Per SPEC §4 Phase 1 "Done when": build a Request, send through default
-// Downloader, parse Response, confirm latest_url follows redirects.
-//
-// These tests hit the network — gated on the `online` cfg so CI offline
-// runs aren't broken.
+// These tests hit the network — gated on the `online-tests` feature so
+// CI offline runs aren't broken.
 
 #![cfg(feature = "online-tests")]