baobab-turn 0.1.0__tar.gz

baobab_turn-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,59 @@
+name: ci
+
+# Manual only.
+#
+# Hosted runners are not part of this project's workflow, and a workflow that
+# fires on every push would leave a permanent red cross on a public
+# repository for reasons that have nothing to do with the code. The gate is
+# `python scripts/check.py`, which runs the same lint, tests, purity check
+# and wheel verification locally and for free.
+#
+# This is kept, and kept correct, so it can be triggered by hand or switched
+# back to automatic by restoring the push and pull_request triggers.
+on:
+  workflow_dispatch:
+
+# Actions defaults to a broadly-scoped token. Nothing here writes to the
+# repository, so drop it to read-only.
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        # SPEC 10 mandates 3.10-3.12. 3.13 is confirmed supported by
+        # livekit-agents 1.8.0 and is the maintainer's local version, so it is
+        # required rather than allow-failure. See docs/FINDINGS.md D11.
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      - run: python -m pip install --upgrade pip
+      - run: pip install -e ".[dev]"
+      - name: Lint
+        run: ruff check .
+      - name: Tests
+        run: pytest
+
+  core-purity:
+    # The architectural boundary from SPEC 3.1, as its own required job so a
+    # violation is visible in the checks list and not buried in test output.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: pyproject.toml
+      # The purity check imports nothing beyond the standard library, so it
+      # does not need the framework extras that dominate install time.
+      - run: pip install -e . pytest
+      - run: pytest tests/test_core_purity.py -v

baobab_turn-0.1.0/.gitignore

@@ -0,0 +1,26 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.coverage
+htmlcov/
+.ruff_cache/
+.mypy_cache/
+.env
+.DS_Store
+
+# NEVER commit raw caller audio (SPEC §8.4). Manifests and metrics only.
+bench/datasets/audio/
+*.wav
+*.mp3
+*.flac
+*.ogg
+*.m4a
+
+# Benchmark run artifacts
+bench/out/
+*.jsonl

baobab_turn-0.1.0/CLAUDE.md

@@ -0,0 +1,63 @@
+# baobab-turn — working notes for Claude
+
+## What this is
+
+A turn-detection guard layer for African speech in voice agents. Pure-Python
+core, thin framework adapters, YAML language packs.
+
+## Read these first
+
+- `docs/SPEC.md` — the full engineering specification. Authoritative on intent.
+- `docs/FINDINGS.md` — verified SDK constraints and corrections to the spec.
+
+## Hard rules
+
+1. **`baobab_turn/core/` imports no framework. Ever.** Enforced by
+   `tests/test_core_purity.py`, which `scripts/check.py` runs as its own step.
+   If a framework type is needed in core, the adapter translates it instead.
+2. **Fail open.** If the guard raises, the inner detector's decision passes
+   through untouched. The agent must never break because our layer broke.
+3. **Never write marker lists for a language.** Generating discourse markers
+   with an LLM is machine translation with extra steps, which the spec
+   forbids. Build the schema and the validator; a speaker supplies the
+   content. This applies to subagents too.
+4. **Never commit raw caller audio.** Manifests and metrics only.
+5. **Every number lives in `core/config.py`.** Nothing hardcoded elsewhere,
+   because the benchmark ablates every flag.
+6. **`reasons` is not optional.** Every guard decision records which rules
+   fired, or the system cannot be tuned or debugged.
+7. **No estimated numbers in the README.** An empty benchmark table is honest.
+
+## LiveKit API churn
+
+The LiveKit Agents API changes frequently and this spec's code samples are
+marked `[VERIFY]` for that reason. Check the SDK source before depending on
+any signature. Docs lag source; source wins.
+
+## Checks
+
+**`python scripts/check.py` is the gate.** Run it before pushing; if it
+passes, the branch is good. It runs lint, the test suite, the core purity
+check, and -- importantly -- builds the wheel and installs it into a
+throwaway environment to confirm the language packs actually ship.
+
+That last step exists because the package was unbuildable for weeks and
+nothing noticed: every install was `pip install -e .`, and editable installs
+skip wheel packaging entirely.
+
+Hosted CI is **not** part of this workflow. `.github/workflows/ci.yml` is kept
+correct but set to `workflow_dispatch` only, so it never fires on a push.
+Do not add automatic triggers, and do not treat a missing green tick as a
+problem to solve.
+
+## Environment
+
+- Local Python is 3.13.7. `livekit-agents` 1.8.0 supports 3.10-3.14.
+- `uv` is not installed.
+- The LiveKit docs MCP server (`https://docs.livekit.io/mcp/`) that SPEC §0
+  asks for is **not configured**. Set it up before deep SDK work.
+
+## Build order
+
+Milestones in SPEC §9. Do not start a milestone before the previous one is
+real. M2 is gated on the open questions in `docs/FINDINGS.md`.

baobab_turn-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 baobab-turn contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.