Publish Tiny Hinglish Turn Detector development preview

release inventory sha256: f381f906d00c3963b2975bf84b770ea4954880fdc834c2e981dcf4a25f914d8b

MODEL_CARD.md

@@ -303,7 +303,7 @@ failure aggregates, silence perturbation report, exact environment files, CPU
 benchmarks, and guarded release tooling. Per-example validation predictions and
 the text-bearing split manifest remain in the private local workspace; the
 public package contains aggregate reports and hashes, not those sensitive rows.
-The quality gate completed with Ruff 0.15.16 passing and 130/130 automated tests
+The quality gate completed with Ruff 0.15.16 passing and 131/131 automated tests
 passing via Python `unittest` discovery. The configured Hugging Face owner is
 `suvradeepp`.
 

README.md

@@ -303,7 +303,7 @@ failure aggregates, silence perturbation report, exact environment files, CPU
 benchmarks, and guarded release tooling. Per-example validation predictions and
 the text-bearing split manifest remain in the private local workspace; the
 public package contains aggregate reports and hashes, not those sensitive rows.
-The quality gate completed with Ruff 0.15.16 passing and 130/130 automated tests
+The quality gate completed with Ruff 0.15.16 passing and 131/131 automated tests
 passing via Python `unittest` discovery. The configured Hugging Face owner is
 `suvradeepp`.
 

REPORT.md

@@ -525,8 +525,8 @@ calendar days or the missing external data collection occurred.
 | 13 | Integrate controller and demo | replay, three-state controller, Gradio, Hinglish recording prompts | Preview model and synthetic controller integration complete; real sequence replay pending |
 | 14 | Freeze test, package, publish | sealed-test guard, atomic release builder, exact-mirror publisher | Development packaging path ready; official-test/final gates not satisfied |
 
-The repository quality gate passed Ruff 0.15.16 and all 130 automated tests
-(130 passed via Python `unittest` discovery). That validates the implemented behavior under test; it does not fill
+The repository quality gate passed Ruff 0.15.16 and all 131 automated tests
+(131 passed via Python `unittest` discovery). That validates the implemented behavior under test; it does not fill
 the missing empirical datasets or rights review.
 
 ## 9. Decision log and next experiments

SOURCE_README.md

@@ -26,7 +26,7 @@ engineering evidence, not a production-readiness claim.
 | Domain-shift stress | Measured, confounded | Source-held-out AP 0.5500/0.5368 for TinyTCN/baseline; both near chance in ranking, with wide nine-source bootstrap intervals |
 | Runtime/export | Measured | 611 KiB FP32 ONNX; exact PyTorch/ONNX parity; ONNX p95 0.956 ms neural-only and 1.629 ms waveform-to-probability |
 | Controller integration | Synthetic only | Metadata-bound 8-checkpoint/3-turn fixture emits 3 response edges with 0 duplicates; not model or product-quality evidence |
-| Code quality gate | Passed | Ruff 0.15.16; 130/130 automated tests passed via `unittest` discovery |
+| Code quality gate | Passed | Ruff 0.15.16; 131/131 automated tests passed via `unittest` discovery |
 | Accuracy/generalization | **Not established** | No full-corpus run, collected Hinglish recordings, real conversation replay, or official-test evaluation |
 | Hugging Face publication | Not claimed here | Local guarded release/publisher path exists; verify any remote publication separately |
 

export_manifest.json

@@ -126,9 +126,9 @@
       "sha256": "146763ebbe4d4ca0858c3fda2f56aa235aa9a4b6686b3216bcea58d148945d04"
     },
     {
-      "bytes": 37627,
+      "bytes": 40091,
       "path": "scripts/build_release.py",
-      "sha256": "c7b6fbca43fb28bf8f1835287f647954f5b5adf5877cddb0a8ee728315878117"
+      "sha256": "07963aacb56af58add680f0a011dc58baefa24355e127b2dc0f10c018bde9525"
     },
     {
       "bytes": 10147,
@@ -196,9 +196,9 @@
       "sha256": "40569f1e553f0cb340cf81414e072839ca734a7d303c5cb5f1e46c5035590804"
     },
     {
-      "bytes": 66,
+      "bytes": 51,
       "path": "space/requirements.txt",
-      "sha256": "44a1657dc82cbc10dabf766dfa64ff0cdcd773a99b5ee0303e11e34fe76bdce6"
+      "sha256": "7b99ddd361d3626972bc819c85237ee929b6c579fa70b66d845ef88dd8bda7e7"
     },
     {
       "bytes": 160,
@@ -371,7 +371,7 @@
       "sha256": "da0eac829fe43615f7bb149998c2f2762f148790fb0c14d4ba6db4d6b25298f4"
     }
   ],
-  "source_inventory_sha256": "259931c509dc4abd54a3c5c72ca12948449bd19d3aed2b2c2ea0fac88a6a705b",
+  "source_inventory_sha256": "e4f7592fd12f2fa89ff838df39dbb7ce487edf50ed439e8a17098e03cb71a6ab",
   "task": "audio-turn-end-detection",
   "threshold": 0.741000771522522,
   "training_data": {

release_provenance.json

@@ -16,7 +16,7 @@
       },
       "MODEL_CARD.md": {
         "bytes": 14805,
-        "sha256": "6add0853cdc0f09ff1abb594149c59e9d53f29ab4dba5de52bed7278cfb13c1b"
+        "sha256": "05162a2792ee71d642605d87bef18089cf5f57b52e6a9b32e6d34cbd26789b29"
       },
       "Makefile": {
         "bytes": 777,
@@ -28,15 +28,15 @@
       },
       "README.md": {
         "bytes": 14805,
-        "sha256": "6add0853cdc0f09ff1abb594149c59e9d53f29ab4dba5de52bed7278cfb13c1b"
+        "sha256": "05162a2792ee71d642605d87bef18089cf5f57b52e6a9b32e6d34cbd26789b29"
       },
       "REPORT.md": {
         "bytes": 32272,
-        "sha256": "9205011a4c547b8cf537d5b3538d25f1b8a9545c9bb020694f6d94deb26683f7"
+        "sha256": "40284013cd8d435f624464b5e9f7a3427f41a9a6410a5ae917ef34863a9a95b1"
       },
       "SOURCE_README.md": {
         "bytes": 20535,
-        "sha256": "64539b78efae390a42ca19a718b8e7354327826fff81dc6c1a9c7841b11132e0"
+        "sha256": "e74584ad5bc721c333d83346d9ee25e4f9a22c4c31f8efcf3ef30089dd3f8d0c"
       },
       "app.py": {
         "bytes": 10381,
@@ -108,7 +108,7 @@
       },
       "export_manifest.json": {
         "bytes": 12430,
-        "sha256": "1f70d8ec79c9c2430c9d3a16942f51254202279c984048e02a781a33313f242b"
+        "sha256": "7a5ec279128eeb68095467b00fd4c1ef5a644876f5a77867dcefbf81e20d99b8"
       },
       "model.onnx": {
         "bytes": 625431,
@@ -247,8 +247,8 @@
         "sha256": "146763ebbe4d4ca0858c3fda2f56aa235aa9a4b6686b3216bcea58d148945d04"
       },
       "scripts/build_release.py": {
-        "bytes": 37627,
-        "sha256": "c7b6fbca43fb28bf8f1835287f647954f5b5adf5877cddb0a8ee728315878117"
+        "bytes": 40091,
+        "sha256": "07963aacb56af58add680f0a011dc58baefa24355e127b2dc0f10c018bde9525"
       },
       "scripts/compare_models.py": {
         "bytes": 10147,
@@ -303,8 +303,8 @@
         "sha256": "40569f1e553f0cb340cf81414e072839ca734a7d303c5cb5f1e46c5035590804"
       },
       "space/requirements.txt": {
-        "bytes": 66,
-        "sha256": "44a1657dc82cbc10dabf766dfa64ff0cdcd773a99b5ee0303e11e34fe76bdce6"
+        "bytes": 51,
+        "sha256": "7b99ddd361d3626972bc819c85237ee929b6c579fa70b66d845ef88dd8bda7e7"
       },
       "src/turn_detection/__init__.py": {
         "bytes": 160,
@@ -531,8 +531,8 @@
         "sha256": "5af81ad7995b6bfd3816b7d97ee1226027659dc5b8a7cb4fe4376fa850dcd14e"
       },
       "tests/test_release_guardrails.py": {
-        "bytes": 17399,
-        "sha256": "8f7cccb7345be11943361808f6ff4b4e9e9ca2297bdac16312c6ae3240cfc9b0"
+        "bytes": 18405,
+        "sha256": "bc94fd488aadb1859172e9cdd803f4b7cb828d8884e79b1899286019af28af19"
       },
       "tests/test_runtime_controller.py": {
         "bytes": 3086,
@@ -566,15 +566,15 @@
       },
       "MODEL_CARD.md": {
         "bytes": 14805,
-        "sha256": "6add0853cdc0f09ff1abb594149c59e9d53f29ab4dba5de52bed7278cfb13c1b"
+        "sha256": "05162a2792ee71d642605d87bef18089cf5f57b52e6a9b32e6d34cbd26789b29"
       },
       "NOTICE": {
         "bytes": 563,
         "sha256": "aee9451763081ff03b717ba3b821b52f0a57eac9e1c7689817b9d41e6317b36c"
       },
       "README.md": {
-        "bytes": 1325,
-        "sha256": "26d2cc8f3eaebd4fd91a9406005724ac4c6f47de871eedcbd1051815d014b5db"
+        "bytes": 1314,
+        "sha256": "37e7617fceca4ee6196d2875b2cbda5e3211dd825f8c1b4a610a5a59fe2bf89c"
       },
       "app.py": {
         "bytes": 10381,
@@ -589,8 +589,8 @@
         "sha256": "43636ad5efb642138c281a4582e85f19b5aae2f4f6cca69211169341ae4399b4"
       },
       "requirements.txt": {
-        "bytes": 66,
-        "sha256": "44a1657dc82cbc10dabf766dfa64ff0cdcd773a99b5ee0303e11e34fe76bdce6"
+        "bytes": 51,
+        "sha256": "7b99ddd361d3626972bc819c85237ee929b6c579fa70b66d845ef88dd8bda7e7"
       },
       "src/turn_detection/__init__.py": {
         "bytes": 160,
@@ -626,5 +626,5 @@
   "metrics_file": "development_metrics.json",
   "metrics_scope": "development",
   "model_file": "model.onnx",
-  "source_and_artifact_inventory_sha256": "4c327046a4f44513d65a2a920a67566c646bf9c82e1f770a7f1ee6614006a47e"
+  "source_and_artifact_inventory_sha256": "1ef74a0b13c1cf68a4b96090911ca715e9bdfc2917bcfc4ac8483fc20d1d786a"
 }

scripts/build_release.py

@@ -19,6 +19,11 @@ SOURCE_ROOT = ROOT / "src"
 if str(SOURCE_ROOT) not in sys.path:
     sys.path.insert(0, str(SOURCE_ROOT))
 
+_SPACE_CARD_COLORS = frozenset(
+    {"red", "yellow", "green", "blue", "indigo", "purple", "pink", "gray"}
+)
+_SPACE_SHORT_DESCRIPTION_MAX_LENGTH = 60
+
 
 def parse_args() -> argparse.Namespace:
     parser = argparse.ArgumentParser(description=__doc__)
@@ -61,6 +66,59 @@ def _copy_file(source: Path, destination: Path) -> None:
     shutil.copy2(source, destination)
 
 
+def _space_card_frontmatter(path: Path) -> dict[str, str]:
+    """Parse the scalar fields used by the packaged Hugging Face Space card."""
+
+    try:
+        lines = path.read_text(encoding="utf-8").splitlines()
+    except OSError as exc:
+        raise SystemExit(f"Space README is unreadable: {path}") from exc
+    if not lines or lines[0].strip() != "---":
+        raise SystemExit("Space README must start with YAML frontmatter")
+    try:
+        closing_index = next(
+            index for index, line in enumerate(lines[1:], start=1) if line.strip() == "---"
+        )
+    except StopIteration as exc:
+        raise SystemExit("Space README frontmatter is not closed") from exc
+
+    metadata: dict[str, str] = {}
+    for line in lines[1:closing_index]:
+        stripped = line.strip()
+        if not stripped or stripped.startswith("#"):
+            continue
+        if ":" not in stripped:
+            raise SystemExit("Space README frontmatter must contain scalar key/value pairs")
+        key, value = stripped.split(":", 1)
+        key = key.strip()
+        value = value.strip().strip("'\"")
+        if not key or key in metadata:
+            raise SystemExit(f"Space README has an invalid or duplicate metadata key: {key!r}")
+        metadata[key] = value
+    return metadata
+
+
+def _validate_space_card(path: Path) -> None:
+    metadata = _space_card_frontmatter(path)
+    if metadata.get("sdk") != "gradio":
+        raise SystemExit("Space README sdk must be 'gradio'")
+    if metadata.get("app_file") != "app.py":
+        raise SystemExit("Space README app_file must be 'app.py'")
+    for field in ("colorFrom", "colorTo"):
+        color = metadata.get(field)
+        if color not in _SPACE_CARD_COLORS:
+            allowed = ", ".join(sorted(_SPACE_CARD_COLORS))
+            raise SystemExit(f"Space README {field} must be one of: {allowed}")
+    short_description = metadata.get("short_description", "")
+    if not short_description:
+        raise SystemExit("Space README short_description must be non-empty")
+    if len(short_description) > _SPACE_SHORT_DESCRIPTION_MAX_LENGTH:
+        raise SystemExit(
+            "Space README short_description must be at most "
+            f"{_SPACE_SHORT_DESCRIPTION_MAX_LENGTH} characters"
+        )
+
+
 def _copy_runtime(destination: Path) -> None:
     package_root = destination / "src" / "turn_detection"
     package_root.mkdir(parents=True, exist_ok=True)
@@ -694,6 +752,7 @@ def main() -> int:
             ROOT / "reports" / "controller_replay_integration.summary.json",
             metadata.get("controller"),
         )
+    _validate_space_card(ROOT / "space" / "README.md")
 
     frozen_manifest: dict | None = None
     if not metadata_is_development:

space/requirements.txt

@@ -1,4 +1,3 @@
-gradio==5.49.1
 numpy==2.3.5
 onnxruntime==1.26.0
 soundfile==0.14.0

tests/test_release_guardrails.py

@@ -85,6 +85,37 @@ class ReleaseGuardrailTest(unittest.TestCase):
             self.assertTrue((destination / "new.txt").is_file())
             self.assertFalse((destination / "old.txt").exists())
 
+    def test_space_card_rejects_server_invalid_frontmatter(self) -> None:
+        from scripts.build_release import _validate_space_card
+
+        valid = """---
+title: Test Space
+colorFrom: yellow
+colorTo: indigo
+sdk: gradio
+app_file: app.py
+short_description: Tiny endpoint detector
+---
+"""
+        with tempfile.TemporaryDirectory() as directory:
+            card = Path(directory) / "README.md"
+            card.write_text(valid, encoding="utf-8")
+            _validate_space_card(card)
+
+            card.write_text(
+                valid.replace("colorFrom: yellow", "colorFrom: orange"),
+                encoding="utf-8",
+            )
+            with self.assertRaisesRegex(SystemExit, "colorFrom"):
+                _validate_space_card(card)
+
+            card.write_text(
+                valid.replace("Tiny endpoint detector", "x" * 61),
+                encoding="utf-8",
+            )
+            with self.assertRaisesRegex(SystemExit, "at most 60"):
+                _validate_space_card(card)
+
     def test_synthetic_replay_must_be_labelled_and_hash_bound(self) -> None:
         from scripts.build_release import _validate_synthetic_replay