moq-clock: convert to a moq-native example (#1494)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: kixelated

.release-plz.toml

@@ -1,12 +1,3 @@
 [workspace]
 dependencies_update = true
 git_release_enable = false
-
-# moq-clock is an example binary, not a distributed crate. publish = false
-# in its Cargo.toml stops cargo publish; release = false here also stops
-# release-plz from bumping the version, writing CHANGELOG entries, or
-# tagging it.
-[[package]]
-name = "moq-clock"
-release = false
-

CLAUDE.md

@@ -42,12 +42,11 @@ Key architectural rule: The CDN/relay does not know anything about media. Anythi
 ```
 /rs/                  # Rust crates
   moq-net/           # Core networking layer (published as moq-net; negotiates moq-lite or moq-transport)
-  moq-native/        # QUIC/WebTransport connection helpers for native apps
+  moq-native/        # QUIC/WebTransport connection helpers for native apps; clock example lives in examples/clock.rs
   moq-relay/         # Clusterable relay server (binary: moq-relay)
   moq-token/         # JWT authentication library
   moq-token-cli/     # JWT token CLI tool (binary: moq-token-cli)
   moq-cli/           # CLI tool for media operations (binary: moq)
-  moq-clock/         # Clock synchronization example (binary: moq-clock)
   moq-mux/           # Media muxers/demuxers (fMP4, CMAF, HLS)
   moq-audio/         # Native PCM ↔ Opus encode/decode on top of moq-mux
   hang/              # Media encoding/streaming (catalog/container format)

Cargo.lock

@@ -6,7 +6,6 @@ members = [
     "rs/moq-audio",
     "rs/moq-boy",
     "rs/moq-cli",
-    "rs/moq-clock",
     "rs/moq-ffi",
     "rs/moq-gst",
     "rs/moq-loc",
@@ -26,7 +25,6 @@ default-members = [
     "rs/moq-boy",
     "rs/moq-audio",
     "rs/moq-cli",
-    "rs/moq-clock",
     # "rs/moq-ffi",   # requires Python/maturin
     # "rs/moq-gst",   # requires GStreamer
     "rs/moq-loc",

Cargo.toml

@@ -211,7 +211,7 @@ clock action url="http://localhost:4443/anon" *args:
 		exit 1; \
 	fi
 
-	cargo run --bin moq-clock -- --url "{{url}}" --broadcast "clock" {{args}} {{action}}
+	cargo run -p moq-native --example clock -- --url "{{url}}" --broadcast "clock" {{args}} {{action}}
 
 # Connect tokio-console to the publisher (port 6681).
 console:

demo/pub/justfile

@@ -158,10 +158,6 @@ See [Authentication guide](/bin/relay/auth) for details.
 
 ## Utilities
 
-### moq-clock
-
-Timing and clock utilities for synchronization.
-
 ### libmoq
 
 [![docs.rs](https://docs.rs/libmoq/badge.svg)](https://docs.rs/libmoq)

doc/lib/rs/index.md

@@ -138,7 +138,6 @@
             name = "moq-all";
             paths = [
               moq-relay
-              moq-clock
               moq-cli
               moq-token-cli
             ];
@@ -147,7 +146,6 @@
           # Inherit packages from the overlay
           inherit (overlayPkgs)
             moq-relay
-            moq-clock
             moq-cli
             moq-token-cli
             moq-boy

flake.nix

@@ -22,7 +22,7 @@ If you're running a relay server locally, use `http://localhost:4443/anon` inste
 
 ## Wire Format
 
-The wire format is identical to the Rust `moq-clock` crate:
+The wire format is identical to the Rust [clock example](https://github.com/moq-dev/moq/blob/main/rs/moq-native/examples/clock.rs):
 
 1. **Groups**: Each group represents one minute of data
 2. **Base Frame**: First frame contains the timestamp base (e.g., "2025-01-31 14:23:")

js/clock/README.md

@@ -26,14 +26,6 @@ in
     }
   );
 
-  moq-clock = craneLib.buildPackage (
-    crateInfo ../rs/moq-clock/Cargo.toml
-    // {
-      src = craneLib.cleanCargoSource ../.;
-      cargoExtraArgs = "-p moq-clock";
-    }
-  );
-
   moq-cli = craneLib.buildPackage (
     crateInfo ../rs/moq-cli/Cargo.toml
     // {

nix/overlay.nix

@@ -1,4 +1,4 @@
-"""Publish or subscribe to a clock track — the Python twin of `rs/moq-clock`.
+"""Publish or subscribe to a clock track. Python twin of `rs/moq-native/examples/clock.rs`.
 
 Each minute is a new group; each second is a frame inside that group. The first
 frame of every group is the "YYYY-MM-DD HH:MM:" prefix, followed by one "SS"