readio 0.2.2__tar.gz → 0.2.4__tar.gz

{readio-0.2.2 → readio-0.2.4}/.github/workflows/codecov.yml

@@ -16,8 +16,7 @@ jobs:
           cache: pip
       - name: Install Readio runtime dependencies
         run: |
-          python -m pip install "ssmd @ git+https://github.com/buchwandler/ssmd.git@631aa5a03ba2b2fcb364272843f88a8738d36484"
-          python -m pip install "pykokoro[playback] @ git+https://github.com/buchwandler/pykokoro.git@07fdd07f4cccff7ab58bbe1f5c801bebe8b41a85"
+          python -m pip install "pykokoro[playback]==0.9.9"
       - name: Install project and coverage tools
         run: |
           python -m pip install --upgrade pip

readio-0.2.4/.github/workflows/python-publish.yml

@@ -0,0 +1,49 @@
+# Build and publish Readio when a GitHub Release is published.
+
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out release
+        uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Install build tooling
+        run: python -m pip install --upgrade pip build twine
+      - name: Build package
+        run: python -m build
+      - name: Validate artifact metadata
+        run: python -m twine check dist/*
+      - name: Validate release version
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: |
+          python - <<'PY'
+          import os
+          from pathlib import Path
+          from packaging.utils import parse_wheel_filename
+
+          expected = os.environ["RELEASE_TAG"].removeprefix("v")
+          wheels = list(Path("dist").glob("*.whl"))
+          assert len(wheels) == 1, f"expected one wheel, found {len(wheels)}"
+          _, version, _, _ = parse_wheel_filename(wheels[0].name)
+          assert str(version) == expected, (
+              f"wheel version {version} does not match release tag {expected}"
+          )
+          PY
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.14.1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          attestations: false

{readio-0.2.2 → readio-0.2.4}/.github/workflows/tests.yml

@@ -25,8 +25,7 @@ jobs:
           cache: pip
       - name: Install Readio runtime dependencies
         run: |
-          python -m pip install "ssmd @ git+https://github.com/buchwandler/ssmd.git@631aa5a03ba2b2fcb364272843f88a8738d36484"
-          python -m pip install "pykokoro[playback] @ git+https://github.com/buchwandler/pykokoro.git@07fdd07f4cccff7ab58bbe1f5c801bebe8b41a85"
+          python -m pip install "pykokoro[playback]==0.9.9"
       - name: Install project and test tools
         run: |
           python -m pip install --upgrade pip
@@ -34,6 +33,49 @@ jobs:
       - name: Run test suite
         run: python -m pytest -q
 
+
+  minimum-compatibility:
+    name: Minimum PyKokoro compatibility (Ubuntu, Python 3.10)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install PortAudio
+        run: sudo apt-get update && sudo apt-get install --yes portaudio19-dev
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+          cache: pip
+      - name: Install minimum PyKokoro runtime
+        run: python -m pip install "pykokoro[playback]==0.9.9"
+      - name: Install project and test tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+      - name: Run minimum-version test suite
+        run: python -m pytest -q
+  current-compatibility:
+    name: Current PyKokoro compatibility (Ubuntu, Python 3.13)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install PortAudio
+        run: sudo apt-get update && sudo apt-get install --yes portaudio19-dev
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: pip
+      - name: Install current supported PyKokoro range
+        run: python -m pip install "pykokoro[playback]>=0.9.9,<0.10"
+      - name: Show installed PyKokoro version
+        run: python -c "import importlib.metadata; print('PyKokoro', importlib.metadata.version('pykokoro'))"
+      - name: Install project and test tools
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+      - name: Run current-range test suite
+        run: python -m pytest -q
   quality:
     name: Static quality checks
     runs-on: ubuntu-latest
@@ -48,8 +90,7 @@ jobs:
           cache: pip
       - name: Install Readio runtime dependencies
         run: |
-          python -m pip install "ssmd @ git+https://github.com/buchwandler/ssmd.git@631aa5a03ba2b2fcb364272843f88a8738d36484"
-          python -m pip install "pykokoro[playback] @ git+https://github.com/buchwandler/pykokoro.git@07fdd07f4cccff7ab58bbe1f5c801bebe8b41a85"
+          python -m pip install "pykokoro[playback]==0.9.9"
       - name: Install development tools
         run: python -m pip install -e ".[dev]"
       - name: Ruff lint
@@ -81,9 +122,9 @@ jobs:
         shell: bash
         run: |
           python -m venv "${RUNNER_TEMP}/readio-wheel-smoke"
-          "${RUNNER_TEMP}/readio-wheel-smoke/bin/python" -m pip install "ssmd @ git+https://github.com/buchwandler/ssmd.git@631aa5a03ba2b2fcb364272843f88a8738d36484"
-          "${RUNNER_TEMP}/readio-wheel-smoke/bin/python" -m pip install "pykokoro[playback] @ git+https://github.com/buchwandler/pykokoro.git@07fdd07f4cccff7ab58bbe1f5c801bebe8b41a85"
+          "${RUNNER_TEMP}/readio-wheel-smoke/bin/python" -m pip install "pykokoro[playback]==0.9.9"
           "${RUNNER_TEMP}/readio-wheel-smoke/bin/python" -m pip install dist/*.whl
+          "${RUNNER_TEMP}/readio-wheel-smoke/bin/python" -m pip check
           cd "${RUNNER_TEMP}"
           "${RUNNER_TEMP}/readio-wheel-smoke/bin/python" - <<'PY'
           import importlib.metadata

{readio-0.2.2 → readio-0.2.4}/.ledger/releaseledger/data/ledgers/main/events/events.jsonl

@@ -55,3 +55,26 @@
 {"data":{"kind":"quality","status":"accepted"},"entry_id":"entry-0005","event":"entry.added","event_id":"event-0055","record_revisions":{"entry:v0.2.2/entry-0005":1,"release:v0.2.2":9},"release_version":"v0.2.2","schema_version":2}
 {"data":{"kind":"quality","status":"accepted"},"entry_id":"entry-0006","event":"entry.added","event_id":"event-0056","record_revisions":{"entry:v0.2.2/entry-0006":1,"release:v0.2.2":10},"release_version":"v0.2.2","schema_version":2}
 {"data":{"kind":"internal","status":"accepted"},"entry_id":"entry-0007","event":"entry.added","event_id":"event-0057","record_revisions":{"entry:v0.2.2/entry-0007":1,"release:v0.2.2":11},"release_version":"v0.2.2","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0058","record_revisions":{"release:v0.2.3":1},"release_version":"v0.2.3","schema_version":2}
+{"data":{"kind":"changed","status":"accepted"},"entry_id":"entry-0001","event":"entry.added","event_id":"event-0059","record_revisions":{"entry:v0.2.3/entry-0001":1,"release:v0.2.3":2},"release_version":"v0.2.3","schema_version":2}
+{"data":{"kind":"quality","status":"accepted"},"entry_id":"entry-0002","event":"entry.added","event_id":"event-0060","record_revisions":{"entry:v0.2.3/entry-0002":1,"release:v0.2.3":3},"release_version":"v0.2.3","schema_version":2}
+{"data":{"kind":"changed","status":"accepted"},"entry_id":"entry-0003","event":"entry.added","event_id":"event-0061","record_revisions":{"entry:v0.2.3/entry-0003":1,"release:v0.2.3":4},"release_version":"v0.2.3","schema_version":2}
+{"data":{"kind":"docs","status":"accepted"},"entry_id":"entry-0004","event":"entry.added","event_id":"event-0062","record_revisions":{"entry:v0.2.3/entry-0004":1,"release:v0.2.3":5},"release_version":"v0.2.3","schema_version":2}
+{"data":{"kind":"changed","status":"accepted"},"entry_id":"entry-0005","event":"entry.added","event_id":"event-0063","record_revisions":{"entry:v0.2.3/entry-0005":1,"release:v0.2.3":6},"release_version":"v0.2.3","schema_version":2}
+{"data":{"added_source_refs":[],"fields":["summary"],"removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0005","event":"entry.updated","event_id":"event-0064","record_revisions":{"entry:v0.2.3/entry-0005":2},"release_version":"v0.2.3","schema_version":2}
+{"data":{"added_source_refs":[],"fields":["summary"],"reason":"Correct stale tested PyKokoro version to the supported 0.9.5 floor.","removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0001","event":"entry.updated","event_id":"event-0065","record_revisions":{"entry:v0.2.3/entry-0001":2},"release_version":"v0.2.3","schema_version":2}
+{"data":{"added_source_refs":[],"fields":["summary"],"reason":"Correct stale tested PyKokoro version to the supported 0.9.5 floor.","removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0004","event":"entry.updated","event_id":"event-0066","record_revisions":{"entry:v0.2.3/entry-0004":2},"release_version":"v0.2.3","schema_version":2}
+{"data":{"kind":"changed","status":"accepted"},"entry_id":"entry-0006","event":"entry.added","event_id":"event-0067","record_revisions":{"entry:v0.2.3/entry-0006":1,"release:v0.2.3":7},"release_version":"v0.2.3","schema_version":2}
+{"data":{"added_source_refs":[],"fields":["summary"],"reason":"Align the changed entry wording with its kind and supported dependency floor.","removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0001","event":"entry.updated","event_id":"event-0068","record_revisions":{"entry:v0.2.3/entry-0001":3},"release_version":"v0.2.3","schema_version":2}
+{"data":{"added_source_refs":[],"fields":["summary"],"reason":"Align the quality entry wording with its kind.","removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0002","event":"entry.updated","event_id":"event-0069","record_revisions":{"entry:v0.2.3/entry-0002":2},"release_version":"v0.2.3","schema_version":2}
+{"data":{"added_source_refs":[],"fields":["summary"],"reason":"Align the changed entry wording with its kind.","removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0003","event":"entry.updated","event_id":"event-0070","record_revisions":{"entry:v0.2.3/entry-0003":2},"release_version":"v0.2.3","schema_version":2}
+{"data":{"added_source_refs":[],"fields":["summary"],"reason":"Align the changed entry wording with its kind and recommended summary length.","removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0005","event":"entry.updated","event_id":"event-0071","record_revisions":{"entry:v0.2.3/entry-0005":3},"release_version":"v0.2.3","schema_version":2}
+{"data":{"added_source_refs":[],"fields":["summary"],"reason":"Shorten the new user-facing entry while retaining its behavior.","removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0006","event":"entry.updated","event_id":"event-0072","record_revisions":{"entry:v0.2.3/entry-0006":2},"release_version":"v0.2.3","schema_version":2}
+{"data":{"released_at":"2026-09-11"},"event":"release.finalized","event_id":"event-0073","record_revisions":{"release:v0.2.3":8},"release_version":"v0.2.3","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0074","record_revisions":{"release:v0.2.4":1},"release_version":"v0.2.4","schema_version":2}
+{"data":{"fields":["git_base_ref","git_base_sha","git_commit_count","git_head_ref","git_head_sha","git_range"]},"event":"release.updated","event_id":"event-0075","record_revisions":{"release:v0.2.4":2},"release_version":"v0.2.4","schema_version":2}
+{"data":{"row_count":4},"event":"audit.created","event_id":"event-0076","record_revisions":{"commit_audit_sheet":1},"release_version":"v0.2.4","schema_version":2}
+{"data":{"updated_rows":4},"event":"audit.updated","event_id":"event-0077","record_revisions":{"commit_audit_sheet":2},"release_version":"v0.2.4","schema_version":2}
+{"data":{"entry_ids":["entry-0001","entry-0002","entry-0003","entry-0004"],"synced_audit_rows":4},"event":"entry.batch_added","event_id":"event-0078","record_revisions":{"commit_audit_sheet":3,"entry:v0.2.4/entry-0001":1,"entry:v0.2.4/entry-0002":1,"entry:v0.2.4/entry-0003":1,"entry:v0.2.4/entry-0004":1,"release:v0.2.4":3},"release_version":"v0.2.4","schema_version":2}
+{"data":{"released_at":"2026-09-14"},"event":"release.finalized","event_id":"event-0079","record_revisions":{"release:v0.2.4":4},"release_version":"v0.2.4","schema_version":2}
+{"data":{"fields":["released_at"]},"event":"release.updated","event_id":"event-0080","record_revisions":{"release:v0.2.4":5},"release_version":"v0.2.4","schema_version":2}

readio-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/v0.2.3/entries/entry-0001.md

@@ -0,0 +1,29 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 3
+entry_id: entry-0001
+release_version: v0.2.3
+kind: changed
+summary:
+  Changed Readio dependency metadata and CI to use PyKokoro 0.9.5 and SSMD
+  0.8.7+
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - tl:task-0019
+paths:
+  - pyproject.toml
+  - .github/workflows/tests.yml
+  - .github/workflows/codecov.yml
+issues: []
+prs: []
+sources: []
+contributors: []
+breaking: false
+internal: false
+order: 1
+---

readio-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/v0.2.3/entries/entry-0002.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 2
+entry_id: entry-0002
+release_version: v0.2.3
+kind: quality
+summary: Improved PyKokoro compatibility and package metadata regression coverage
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - tests/test_pykokoro_09_contract.py
+  - tests/test_pykokoro_09_support.py
+  - tests/test_packaging_metadata.py
+issues: []
+prs: []
+sources:
+  - tl:task-0019
+contributors: []
+breaking: false
+internal: false
+order: 2
+---

readio-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/v0.2.3/entries/entry-0003.md

@@ -0,0 +1,25 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 2
+entry_id: entry-0003
+release_version: v0.2.3
+kind: changed
+summary: Changed package publishing with artifact checks and release-tag version validation
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - .github/workflows/python-publish.yml
+issues: []
+prs: []
+sources:
+  - tl:task-0019
+contributors: []
+breaking: false
+internal: false
+order: 3
+---

readio-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/v0.2.3/entries/entry-0004.md

@@ -0,0 +1,30 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 2
+entry_id: entry-0004
+release_version: v0.2.3
+kind: docs
+summary:
+  Documented the PyKokoro support floor, 0.9.5 tested target, and supported
+  SSMD API
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - README.md
+  - docs/index.md
+  - skill/readio/SKILL.md
+  - llm-guides
+issues: []
+prs: []
+sources:
+  - tl:task-0019
+contributors: []
+breaking: false
+internal: false
+order: 4
+---

readio-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/v0.2.3/entries/entry-0005.md

@@ -0,0 +1,31 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 3
+entry_id: entry-0005
+release_version: v0.2.3
+kind: changed
+summary:
+  Changed spaCy model-size and short-sentence synthesis controls, including
+  reader configuration migration
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - tl:task-0021
+paths:
+  - readio/config.py
+  - readio/cli.py
+  - readio/plan.py
+  - readio/reader.py
+  - readio/synthesis.py
+issues: []
+prs: []
+sources: []
+contributors: []
+breaking: false
+internal: false
+order: 5
+---

readio-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/v0.2.3/entries/entry-0006.md

@@ -0,0 +1,29 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 2
+entry_id: entry-0006
+release_version: v0.2.3
+kind: changed
+summary:
+  Changed Readio's speak/render pause default from tts to auto while preserving
+  config and CLI overrides
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - tl:task-0025
+paths:
+  - readio/config.py
+  - readio/plan.py
+  - readio/synthesis.py
+issues: []
+prs: []
+sources: []
+contributors: []
+breaking: false
+internal: false
+order: 6
+---

readio-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/v0.2.3/release.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 8
+version: v0.2.3
+status: released
+history_state: curated
+title: Readio v0.2.3
+released_at: "2026-09-11"
+previous_version: v0.2.2
+cancel_reason: null
+superseded_by: null
+changelog_file: null
+boundary_ref: null
+source_refs: []
+source_count: null
+entry_count: 6
+artifact_count: 0
+git_base_ref: null
+git_base_sha: null
+git_head_ref: null
+git_head_sha: null
+git_range: null
+git_commit_count: null
+---

readio-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/v0.2.4/audit/commit-audit.yaml

@@ -0,0 +1,212 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 3
+release_version: v0.2.4
+git_base_ref: v0.2.3
+git_base_sha: 9b264c5a7b09096c299b90d2f8fe6fb30a2a96d0
+git_head_ref: HEAD
+git_head_sha: 2c5e221eab0f4047a8157dcacb85e5d31c956d3a
+git_range: 9b264c5a7b09096c299b90d2f8fe6fb30a2a96d0..2c5e221eab0f4047a8157dcacb85e5d31c956d3a
+commit_count: 4
+rows:
+  - sha: 4791e709a5f940404c7e40f04333f0996931453d
+    source_ref: git:4791e709a5f940404c7e40f04333f0996931453d
+    short_sha: 4791e70
+    changed_paths:
+      - .ledger/releaseledger/data/ledgers/main/events/events.jsonl
+      - .ledger/releaseledger/data/ledgers/main/releases/v0.2.3/entries/entry-0005.md
+      - .ledger/releaseledger/data/ledgers/main/releases/v0.2.3/release.md
+      - README.md
+      - docs/changelog.md
+      - docs/index.md
+      - readio/cli.py
+      - readio/config.py
+      - readio/plan.py
+      - readio/reader.py
+      - readio/synthesis.py
+      - skill/readio/references/cli.md
+      - skill/readio/references/troubleshooting.md
+      - tests/test_config.py
+      - tests/test_plan.py
+      - tests/test_plan_no_tts_load.py
+      - tests/test_reader_synthesis.py
+      - tests/test_render_from_plan.py
+    stats:
+      files_changed: 0
+      insertions: 369
+      deletions: 26
+    inspected: true
+    inspected_paths:
+      - readio/config.py
+      - readio/plan.py
+      - readio/reader.py
+      - readio/synthesis.py
+      - tests/test_config.py
+      - tests/test_plan.py
+      - tests/test_reader_synthesis.py
+    observed_behavior:
+      Reader synthesis planning now supports explicit spaCy tiers and
+      configurable short-sentence handling, with legacy required values normalized to
+      sm.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: add spacy policy and parameter for short sentences"
+    target_entry_id: entry-0001
+    notes: ""
+  - sha: 18d17658338164cf7a62f805eece4802de217394
+    source_ref: git:18d17658338164cf7a62f805eece4802de217394
+    short_sha: 18d1765
+    changed_paths:
+      - .github/workflows/codecov.yml
+      - .github/workflows/tests.yml
+      - README.md
+      - docs/index.md
+      - llm-guides/README.md
+      - llm-guides/ssmd/audio-drama.md
+      - llm-guides/ssmd/debate-pro-con.md
+      - llm-guides/ssmd/document-summary.md
+      - llm-guides/ssmd/dramatic-story.md
+      - llm-guides/ssmd/educational-explainer.md
+      - llm-guides/ssmd/funny-story.md
+      - llm-guides/ssmd/general-narration.md
+      - llm-guides/ssmd/guided-meditation.md
+      - llm-guides/ssmd/kids-story.md
+      - llm-guides/ssmd/language-learning.md
+      - llm-guides/ssmd/news-briefing.md
+      - llm-guides/ssmd/podcast-interview.md
+      - llm-guides/ssmd/podcast-roundtable.md
+      - llm-guides/ssmd/podcast-solo.md
+      - llm-guides/ssmd/quiz-trivia.md
+      - pyproject.toml
+      - readio/cli.py
+      - readio/config.py
+      - readio/models.py
+      - readio/plan.py
+      - readio/ssmd.py
+      - readio/synthesis.py
+      - readio/voices.py
+      - skill/readio/SKILL.md
+      - skill/readio/references/cli.md
+      - skill/readio/references/ssmd.md
+      - skill/readio/references/troubleshooting.md
+      - tests/test_llm_guides.py
+      - tests/test_packaging_metadata.py
+      - tests/test_pykokoro_09_contract.py
+      - tests/test_pykokoro_09_regressions.py
+      - tests/test_voice_catalog.py
+      - tests/test_voices_cli.py
+    stats:
+      files_changed: 0
+      insertions: 817
+      deletions: 200
+    inspected: true
+    inspected_paths:
+      - readio/voices.py
+      - readio/cli.py
+      - readio/models.py
+      - tests/test_voice_catalog.py
+      - tests/test_voices_cli.py
+    observed_behavior:
+      Voice discovery now exposes stable locale-number selectors, metadata
+      filtering, selector inspection, and selector-aware role/default resolution.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: short form for voice selection and new voices command"
+    target_entry_id: entry-0002
+    notes: ""
+  - sha: 5840ad53704ab4efd000346c048638c9b2271eb7
+    source_ref: git:5840ad53704ab4efd000346c048638c9b2271eb7
+    short_sha: 5840ad5
+    changed_paths:
+      - README.md
+      - docs/index.md
+      - readio/audio.py
+      - readio/backends/__init__.py
+      - readio/backends/base.py
+      - readio/backends/pykokoro.py
+      - readio/backends/registry.py
+      - readio/cli.py
+      - readio/config.py
+      - readio/lexicons.py
+      - readio/models.py
+      - readio/plan.py
+      - readio/reader.py
+      - readio/ssmd.py
+      - readio/synthesis.py
+      - readio/voices.py
+      - skill/readio/SKILL.md
+      - skill/readio/references/cli.md
+      - tests/test_backend_config.py
+      - tests/test_backend_dispatch.py
+      - tests/test_backends.py
+      - tests/test_lexicon_catalog.py
+      - tests/test_lexicons_cli.py
+    stats:
+      files_changed: 0
+      insertions: 1508
+      deletions: 366
+    inspected: true
+    inspected_paths:
+      - readio/backends/base.py
+      - readio/backends/pykokoro.py
+      - readio/lexicons.py
+      - readio/cli.py
+      - tests/test_lexicon_catalog.py
+      - tests/test_lexicons_cli.py
+    observed_behavior:
+      Synthesis backend contracts and the PyKokoro adapter now expose
+      backend-neutral lexicon discovery, filtering, inspection, and runtime option plumbing.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: lexicon command to view lexicons"
+    target_entry_id: entry-0003
+    notes: ""
+  - sha: 2c5e221eab0f4047a8157dcacb85e5d31c956d3a
+    source_ref: git:2c5e221eab0f4047a8157dcacb85e5d31c956d3a
+    short_sha: 2c5e221
+    changed_paths:
+      - README.md
+      - docs/index.md
+      - readio/audio.py
+      - readio/backends/base.py
+      - readio/backends/pykokoro.py
+      - readio/cli.py
+      - readio/lexicons.py
+      - readio/models.py
+      - readio/plan.py
+      - readio/reader.py
+      - readio/ssmd.py
+      - readio/synthesis.py
+      - readio/voices.py
+      - skill/readio/SKILL.md
+      - skill/readio/references/cli.md
+      - tests/test_backend_dispatch.py
+      - tests/test_lexicons_cli.py
+      - tests/test_voice_catalog.py
+      - tests/test_voices_cli.py
+    stats:
+      files_changed: 0
+      insertions: 128
+      deletions: 88
+    inspected: true
+    inspected_paths:
+      - readio/lexicons.py
+      - readio/voices.py
+      - readio/cli.py
+      - tests/test_lexicons_cli.py
+      - tests/test_voice_catalog.py
+      - tests/test_voices_cli.py
+    observed_behavior:
+      Lexicon listing remains usable without a language filter and
+      backend-aware voice and lexicon selection is formatted and validated consistently.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "fix: lexicons list"
+    target_entry_id: entry-0004
+    notes: ""

readio-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/v0.2.4/entries/entry-0001.md

@@ -0,0 +1,46 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: v0.2.4
+kind: added
+summary:
+  Added explicit spaCy model tiers and configurable short-sentence synthesis
+  policies
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:4791e709a5f940404c7e40f04333f0996931453d
+paths:
+  - .ledger/releaseledger/data/ledgers/main/events/events.jsonl
+  - .ledger/releaseledger/data/ledgers/main/releases/v0.2.3/entries/entry-0005.md
+  - .ledger/releaseledger/data/ledgers/main/releases/v0.2.3/release.md
+  - README.md
+  - docs/changelog.md
+  - docs/index.md
+  - readio/cli.py
+  - readio/config.py
+  - readio/plan.py
+  - readio/reader.py
+  - readio/synthesis.py
+  - skill/readio/references/cli.md
+  - skill/readio/references/troubleshooting.md
+  - tests/test_config.py
+  - tests/test_plan.py
+  - tests/test_plan_no_tts_load.py
+  - tests/test_reader_synthesis.py
+  - tests/test_render_from_plan.py
+issues: []
+prs: []
+sources:
+  - git:4791e709a5f940404c7e40f04333f0996931453d
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 1
+---