voicerender 0.2.3__tar.gz → 0.2.4__tar.gz

{voicerender-0.2.3 → voicerender-0.2.4}/.github/workflows/tests.yml

@@ -101,6 +101,7 @@ jobs:
             "pytest==8.0.0" \
             "numpy==1.23.0" \
             "soundfile==0.12.1" \
+            "tomlkit==0.13.3" \
             "tomli==2.0.1" \
             "renderplan==0.1.2" \
             "voicefolio==0.1.1"

{voicerender-0.2.3 → voicerender-0.2.4}/.ledger/releaseledger/data/ledgers/main/events/events.jsonl

@@ -33,3 +33,10 @@
 {"data":{"row_count":2},"event":"audit.created","event_id":"event-0033","record_revisions":{"commit_audit_sheet":1},"release_version":"0.2.3","schema_version":2}
 {"data":{"updated_rows":2},"event":"audit.updated","event_id":"event-0034","record_revisions":{"commit_audit_sheet":2},"release_version":"0.2.3","schema_version":2}
 {"data":{"entry_ids":["entry-0001","entry-0002"],"synced_audit_rows":2},"event":"entry.batch_added","event_id":"event-0035","record_revisions":{"commit_audit_sheet":3,"entry:0.2.3/entry-0001":1,"entry:0.2.3/entry-0002":1,"release:0.2.3":3},"release_version":"0.2.3","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0036","record_revisions":{"release:0.2.4":1},"release_version":"0.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-0037","record_revisions":{"release:0.2.4":2},"release_version":"0.2.4","schema_version":2}
+{"data":{"row_count":5},"event":"audit.created","event_id":"event-0038","record_revisions":{"commit_audit_sheet":1},"release_version":"0.2.4","schema_version":2}
+{"data":{"updated_rows":5},"event":"audit.updated","event_id":"event-0039","record_revisions":{"commit_audit_sheet":2},"release_version":"0.2.4","schema_version":2}
+{"data":{"entry_ids":["entry-0001","entry-0002","entry-0003","entry-0004","entry-0005"],"synced_audit_rows":5},"event":"entry.batch_added","event_id":"event-0040","record_revisions":{"commit_audit_sheet":3,"entry:0.2.4/entry-0001":1,"entry:0.2.4/entry-0002":1,"entry:0.2.4/entry-0003":1,"entry:0.2.4/entry-0004":1,"entry:0.2.4/entry-0005":1,"release:0.2.4":3},"release_version":"0.2.4","schema_version":2}
+{"data":{"released_at":"2026-10-18"},"event":"release.finalized","event_id":"event-0041","record_revisions":{"release:0.2.3":4},"release_version":"0.2.3","schema_version":2}
+{"data":{"released_at":"2026-10-20"},"event":"release.finalized","event_id":"event-0042","record_revisions":{"release:0.2.4":4},"release_version":"0.2.4","schema_version":2}

{voicerender-0.2.3 → voicerender-0.2.4}/.ledger/releaseledger/data/ledgers/main/releases/0.2.3/release.md

@@ -3,12 +3,12 @@ schema_version: 2
 object_type: release
 versioning:
   schema_version: 1
-  revision: 3
+  revision: 4
 version: 0.2.3
-status: planned
+status: released
 history_state: curated
 title: null
-released_at: null
+released_at: "2026-10-18"
 previous_version: 0.2.2
 cancel_reason: null
 superseded_by: null

voicerender-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/0.2.4/audit/commit-audit.yaml

@@ -0,0 +1,183 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 3
+release_version: 0.2.4
+git_base_ref: v0.2.3
+git_base_sha: 817587bef3fafffbe39f6b8b715720263dec50dd
+git_head_ref: HEAD
+git_head_sha: ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+git_range: 817587bef3fafffbe39f6b8b715720263dec50dd..ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+commit_count: 5
+rows:
+  - sha: 5ffdff4e822f5ea3bff212cf708a6d797029915d
+    source_ref: git:5ffdff4e822f5ea3bff212cf708a6d797029915d
+    short_sha: 5ffdff4
+    changed_paths:
+      - README.md
+      - tests/test_document_contract.py
+      - voicerender/__init__.py
+      - voicerender/cli.py
+      - voicerender/document.py
+      - voicerender/document_contract.py
+      - voicerender/errors.py
+      - voicerender/estimates.py
+    stats:
+      files_changed: 8
+      insertions: 970
+      deletions: 2
+    inspected: true
+    inspected_paths:
+      - README.md
+      - tests/test_document_contract.py
+      - voicerender/__init__.py
+      - voicerender/cli.py
+      - voicerender/document.py
+      - voicerender/document_contract.py
+      - voicerender/errors.py
+      - voicerender/estimates.py
+    observed_behavior:
+      Added SSMDDoc v1 workspace validation plus document-level render
+      and estimate operations that resolve a checked RenderPlan variant and keep outputs
+      and caches in variant-scoped workspace directories.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: add support for document dir"
+    target_entry_key: document-workspace
+    target_entry_id: entry-0001
+    notes: Reviewed implementation and focused contract tests.
+  - sha: efe4f37393479c1143e37f5288b8b586d3fbcc8c
+    source_ref: git:efe4f37393479c1143e37f5288b8b586d3fbcc8c
+    short_sha: efe4f37
+    changed_paths:
+      - README.md
+      - docs/index.md
+      - docs/renderprofile.md
+      - tests/test_document_contract.py
+      - tests/test_profile_roles_cli.py
+      - voicerender/cli.py
+      - voicerender/document.py
+    stats:
+      files_changed: 7
+      insertions: 416
+      deletions: 86
+    inspected: true
+    inspected_paths:
+      - README.md
+      - docs/index.md
+      - docs/renderprofile.md
+      - tests/test_document_contract.py
+      - tests/test_profile_roles_cli.py
+      - voicerender/cli.py
+      - voicerender/document.py
+    observed_behavior:
+      Expanded RenderProfile role workflows so one profile can describe
+      a complete cast with mixed engine bindings, including first-class role binding
+      and descriptive human and JSON profile inspection.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: better voice role binding"
+    target_entry_key: mixed-engine-casts
+    target_entry_id: entry-0002
+    notes: Reviewed CLI, documentation, and role presentation tests.
+  - sha: 304b84d7fca0509a1524e2d3131858740124ed1a
+    source_ref: git:304b84d7fca0509a1524e2d3131858740124ed1a
+    short_sha: 304b84d
+    changed_paths:
+      - .github/workflows/tests.yml
+      - pyproject.toml
+    stats:
+      files_changed: 2
+      insertions: 2
+      deletions: 0
+    inspected: true
+    inspected_paths:
+      - .github/workflows/tests.yml
+      - pyproject.toml
+    observed_behavior:
+      Added the tomlkit runtime dependency required by the release's
+      TOML report writing path and kept the dependency available in the test workflow.
+    public_impact: internal
+    decision: internal
+    stale: false
+    evidence_subject: "chore: fix tomli"
+    target_entry_key: tomlkit-dependency
+    target_entry_id: entry-0003
+    notes: Packaging and workflow support only; intentionally excluded from public notes.
+  - sha: 3d486d5fddcc8612430c321760e9ebd3d84607fc
+    source_ref: git:3d486d5fddcc8612430c321760e9ebd3d84607fc
+    short_sha: 3d486d5
+    changed_paths:
+      - README.md
+      - docs/renderprofile.md
+      - tests/test_engine_options.py
+      - tests/test_kittensynth_engine.py
+      - tests/test_kokoro_reference.py
+      - tests/test_renderplan_render.py
+      - tests/test_voice_clone.py
+      - voicerender/book.py
+      - voicerender/cli.py
+      - voicerender/document.py
+      - voicerender/engines/base.py
+      - voicerender/engines/kittensynth.py
+      - voicerender/engines/kokoro.py
+      - voicerender/renderplan_render.py
+      - voicerender/voice_clone.py
+    stats:
+      files_changed: 15
+      insertions: 1028
+      deletions: 73
+    inspected: true
+    inspected_paths:
+      - README.md
+      - docs/renderprofile.md
+      - tests/test_engine_options.py
+      - tests/test_kittensynth_engine.py
+      - tests/test_kokoro_reference.py
+      - tests/test_renderplan_render.py
+      - tests/test_voice_clone.py
+      - voicerender/book.py
+      - voicerender/cli.py
+      - voicerender/document.py
+      - voicerender/engines/base.py
+      - voicerender/engines/kittensynth.py
+      - voicerender/engines/kokoro.py
+      - voicerender/renderplan_render.py
+      - voicerender/voice_clone.py
+    observed_behavior:
+      Added configurable Kokoro short-sentence and voice-level controls,
+      normalized and clamped finite PCM overshoots with diagnostics, enforced AkinVox
+      transcript and speed constraints, delegated engine-specific clone binding, and
+      recorded segment and engine identity in render failures.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: pykokoro improvements"
+    target_entry_key: kokoro-rendering
+    target_entry_id: entry-0004
+    notes: Reviewed adapter, cloning, diagnostics, and regression tests.
+  - sha: ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+    source_ref: git:ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+    short_sha: ccd30d2
+    changed_paths:
+      - voicerender/renderplan_render.py
+    stats:
+      files_changed: 1
+      insertions: 1
+      deletions: 1
+    inspected: true
+    inspected_paths:
+      - voicerender/renderplan_render.py
+    observed_behavior:
+      Refined render result typing for the existing failure-diagnostics
+      fields without changing runtime behavior.
+    public_impact: internal
+    decision: internal
+    stale: false
+    evidence_subject: "chore: mypy"
+    target_entry_key: typing-maintenance
+    target_entry_id: entry-0005
+    notes: Static typing maintenance only; intentionally excluded from public notes.

voicerender-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/0.2.4/entries/entry-0001.md

@@ -0,0 +1,36 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: 0.2.4
+kind: added
+summary:
+  Added document workspace rendering and estimation with safe SSMDDoc validation
+  and variant-scoped outputs
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:5ffdff4e822f5ea3bff212cf708a6d797029915d
+paths:
+  - README.md
+  - tests/test_document_contract.py
+  - voicerender/__init__.py
+  - voicerender/cli.py
+  - voicerender/document.py
+  - voicerender/document_contract.py
+  - voicerender/errors.py
+  - voicerender/estimates.py
+issues: []
+prs: []
+sources:
+  - git:5ffdff4e822f5ea3bff212cf708a6d797029915d
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 1
+---

voicerender-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/0.2.4/entries/entry-0002.md

@@ -0,0 +1,35 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0002
+release_version: 0.2.4
+kind: added
+summary:
+  Added mixed-engine RenderProfile casts with role binding and descriptive
+  cast inspection
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:efe4f37393479c1143e37f5288b8b586d3fbcc8c
+paths:
+  - README.md
+  - docs/index.md
+  - docs/renderprofile.md
+  - tests/test_document_contract.py
+  - tests/test_profile_roles_cli.py
+  - voicerender/cli.py
+  - voicerender/document.py
+issues: []
+prs: []
+sources:
+  - git:efe4f37393479c1143e37f5288b8b586d3fbcc8c
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 2
+---

voicerender-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/0.2.4/entries/entry-0003.md

@@ -0,0 +1,28 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0003
+release_version: 0.2.4
+kind: internal
+summary: Added the tomlkit runtime dependency for TOML report writing
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:304b84d7fca0509a1524e2d3131858740124ed1a
+paths:
+  - .github/workflows/tests.yml
+  - pyproject.toml
+issues: []
+prs: []
+sources:
+  - git:304b84d7fca0509a1524e2d3131858740124ed1a
+contributors:
+  - "@holgern"
+breaking: false
+internal: true
+order: 3
+---

voicerender-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/0.2.4/entries/entry-0004.md

@@ -0,0 +1,43 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0004
+release_version: 0.2.4
+kind: changed
+summary:
+  Improved Kokoro controls, reference cloning, PCM safety, and render failure
+  diagnostics
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:3d486d5fddcc8612430c321760e9ebd3d84607fc
+paths:
+  - README.md
+  - docs/renderprofile.md
+  - tests/test_engine_options.py
+  - tests/test_kittensynth_engine.py
+  - tests/test_kokoro_reference.py
+  - tests/test_renderplan_render.py
+  - tests/test_voice_clone.py
+  - voicerender/book.py
+  - voicerender/cli.py
+  - voicerender/document.py
+  - voicerender/engines/base.py
+  - voicerender/engines/kittensynth.py
+  - voicerender/engines/kokoro.py
+  - voicerender/renderplan_render.py
+  - voicerender/voice_clone.py
+issues: []
+prs: []
+sources:
+  - git:3d486d5fddcc8612430c321760e9ebd3d84607fc
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 4
+---

voicerender-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/0.2.4/entries/entry-0005.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0005
+release_version: 0.2.4
+kind: internal
+summary: Changed static typing for render failure diagnostics
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+paths:
+  - voicerender/renderplan_render.py
+issues: []
+prs: []
+sources:
+  - git:ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+contributors:
+  - "@holgern"
+breaking: false
+internal: true
+order: 5
+---

voicerender-0.2.4/.ledger/releaseledger/data/ledgers/main/releases/0.2.4/release.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 4
+version: 0.2.4
+status: released
+history_state: curated
+title: null
+released_at: "2026-10-20"
+previous_version: 0.2.3
+cancel_reason: null
+superseded_by: null
+changelog_file: docs/changelog.md
+boundary_ref: null
+source_refs: []
+source_count: null
+entry_count: 5
+artifact_count: 0
+git_base_ref: v0.2.3
+git_base_sha: 817587bef3fafffbe39f6b8b715720263dec50dd
+git_head_ref: HEAD
+git_head_sha: ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+git_range: 817587bef3fafffbe39f6b8b715720263dec50dd..ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+git_commit_count: 5
+---

voicerender-0.2.4/.ledger/releaseledger/work/0.2.4/audit-decisions.yaml

@@ -0,0 +1,98 @@
+rows:
+  - sha: 5ffdff4e822f5ea3bff212cf708a6d797029915d
+    inspected: true
+    inspected_paths:
+      - README.md
+      - tests/test_document_contract.py
+      - voicerender/__init__.py
+      - voicerender/cli.py
+      - voicerender/document.py
+      - voicerender/document_contract.py
+      - voicerender/errors.py
+      - voicerender/estimates.py
+    observed_behavior: >-
+      Added SSMDDoc v1 workspace validation plus document-level render and estimate
+      operations that resolve a checked RenderPlan variant and keep outputs and
+      caches in variant-scoped workspace directories.
+    public_impact: public
+    decision: accepted
+    target_entry_key: document-workspace
+    target_entry_id: null
+    notes: Reviewed implementation and focused contract tests.
+    stale: false
+  - sha: efe4f37393479c1143e37f5288b8b586d3fbcc8c
+    inspected: true
+    inspected_paths:
+      - README.md
+      - docs/index.md
+      - docs/renderprofile.md
+      - tests/test_document_contract.py
+      - tests/test_profile_roles_cli.py
+      - voicerender/cli.py
+      - voicerender/document.py
+    observed_behavior: >-
+      Expanded RenderProfile role workflows so one profile can describe a complete
+      cast with mixed engine bindings, including first-class role binding and
+      descriptive human and JSON profile inspection.
+    public_impact: public
+    decision: accepted
+    target_entry_key: mixed-engine-casts
+    target_entry_id: null
+    notes: Reviewed CLI, documentation, and role presentation tests.
+    stale: false
+  - sha: 304b84d7fca0509a1524e2d3131858740124ed1a
+    inspected: true
+    inspected_paths:
+      - .github/workflows/tests.yml
+      - pyproject.toml
+    observed_behavior: >-
+      Added the tomlkit runtime dependency required by the release's TOML report
+      writing path and kept the dependency available in the test workflow.
+    public_impact: internal
+    decision: internal
+    target_entry_key: tomlkit-dependency
+    target_entry_id: null
+    notes: Packaging and workflow support only; intentionally excluded from public notes.
+    stale: false
+  - sha: 3d486d5fddcc8612430c321760e9ebd3d84607fc
+    inspected: true
+    inspected_paths:
+      - README.md
+      - docs/renderprofile.md
+      - tests/test_engine_options.py
+      - tests/test_kittensynth_engine.py
+      - tests/test_kokoro_reference.py
+      - tests/test_renderplan_render.py
+      - tests/test_voice_clone.py
+      - voicerender/book.py
+      - voicerender/cli.py
+      - voicerender/document.py
+      - voicerender/engines/base.py
+      - voicerender/engines/kittensynth.py
+      - voicerender/engines/kokoro.py
+      - voicerender/renderplan_render.py
+      - voicerender/voice_clone.py
+    observed_behavior: >-
+      Added configurable Kokoro short-sentence and voice-level controls, normalized
+      and clamped finite PCM overshoots with diagnostics, enforced AkinVox transcript
+      and speed constraints, delegated engine-specific clone binding, and recorded
+      segment and engine identity in render failures.
+    public_impact: public
+    decision: accepted
+    target_entry_key: kokoro-rendering
+    target_entry_id: null
+    notes: Reviewed adapter, cloning, diagnostics, and regression tests.
+    stale: false
+  - sha: ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+    inspected: true
+    inspected_paths:
+      - voicerender/renderplan_render.py
+    observed_behavior: >-
+      Refined render result typing for the existing failure-diagnostics fields
+      without changing runtime behavior.
+    public_impact: internal
+    decision: internal
+    target_entry_key: typing-maintenance
+    target_entry_id: null
+    notes: Static typing maintenance only; intentionally excluded from public notes.
+    stale: false

voicerender-0.2.4/.ledger/releaseledger/work/0.2.4/audit.yaml

@@ -0,0 +1,121 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 1
+release_version: 0.2.4
+git_base_ref: v0.2.3
+git_base_sha: 817587bef3fafffbe39f6b8b715720263dec50dd
+git_head_ref: HEAD
+git_head_sha: ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+git_range: 817587bef3fafffbe39f6b8b715720263dec50dd..ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+commit_count: 5
+rows:
+  - sha: 5ffdff4e822f5ea3bff212cf708a6d797029915d
+    source_ref: git:5ffdff4e822f5ea3bff212cf708a6d797029915d
+    short_sha: 5ffdff4
+    changed_paths:
+      - README.md
+      - tests/test_document_contract.py
+      - voicerender/__init__.py
+      - voicerender/cli.py
+      - voicerender/document.py
+      - voicerender/document_contract.py
+      - voicerender/errors.py
+      - voicerender/estimates.py
+    stats:
+      files_changed: 8
+      insertions: 970
+      deletions: 2
+    inspected: false
+    inspected_paths: []
+    observed_behavior: ""
+    public_impact: unknown
+    decision: needs_review
+    stale: false
+    evidence_subject: "feat: add support for document dir"
+  - sha: efe4f37393479c1143e37f5288b8b586d3fbcc8c
+    source_ref: git:efe4f37393479c1143e37f5288b8b586d3fbcc8c
+    short_sha: efe4f37
+    changed_paths:
+      - README.md
+      - docs/index.md
+      - docs/renderprofile.md
+      - tests/test_document_contract.py
+      - tests/test_profile_roles_cli.py
+      - voicerender/cli.py
+      - voicerender/document.py
+    stats:
+      files_changed: 7
+      insertions: 416
+      deletions: 86
+    inspected: false
+    inspected_paths: []
+    observed_behavior: ""
+    public_impact: unknown
+    decision: needs_review
+    stale: false
+    evidence_subject: "feat: better voice role binding"
+  - sha: 304b84d7fca0509a1524e2d3131858740124ed1a
+    source_ref: git:304b84d7fca0509a1524e2d3131858740124ed1a
+    short_sha: 304b84d
+    changed_paths:
+      - .github/workflows/tests.yml
+      - pyproject.toml
+    stats:
+      files_changed: 2
+      insertions: 2
+      deletions: 0
+    inspected: false
+    inspected_paths: []
+    observed_behavior: ""
+    public_impact: unknown
+    decision: needs_review
+    stale: false
+    evidence_subject: "chore: fix tomli"
+  - sha: 3d486d5fddcc8612430c321760e9ebd3d84607fc
+    source_ref: git:3d486d5fddcc8612430c321760e9ebd3d84607fc
+    short_sha: 3d486d5
+    changed_paths:
+      - README.md
+      - docs/renderprofile.md
+      - tests/test_engine_options.py
+      - tests/test_kittensynth_engine.py
+      - tests/test_kokoro_reference.py
+      - tests/test_renderplan_render.py
+      - tests/test_voice_clone.py
+      - voicerender/book.py
+      - voicerender/cli.py
+      - voicerender/document.py
+      - voicerender/engines/base.py
+      - voicerender/engines/kittensynth.py
+      - voicerender/engines/kokoro.py
+      - voicerender/renderplan_render.py
+      - voicerender/voice_clone.py
+    stats:
+      files_changed: 15
+      insertions: 1028
+      deletions: 73
+    inspected: false
+    inspected_paths: []
+    observed_behavior: ""
+    public_impact: unknown
+    decision: needs_review
+    stale: false
+    evidence_subject: "feat: pykokoro improvements"
+  - sha: ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+    source_ref: git:ccd30d20fcc85c71d35c850accaf41ffdc5fc960
+    short_sha: ccd30d2
+    changed_paths:
+      - voicerender/renderplan_render.py
+    stats:
+      files_changed: 1
+      insertions: 1
+      deletions: 1
+    inspected: false
+    inspected_paths: []
+    observed_behavior: ""
+    public_impact: unknown
+    decision: needs_review
+    stale: false
+    evidence_subject: "chore: mypy"