readio 0.3.0__tar.gz → 0.3.2__tar.gz

{readio-0.3.0 → readio-0.3.2}/.ledger/releaseledger/data/ledgers/main/events/events.jsonl

@@ -87,3 +87,17 @@
 {"data":{"kind":"docs","status":"accepted"},"entry_id":"entry-0004","event":"entry.added","event_id":"event-0087","record_revisions":{"entry:v0.2.5/entry-0004":1,"release:v0.2.5":5},"release_version":"v0.2.5","schema_version":2}
 {"data":{"audit_rewritten":false,"old_release_version":"v0.2.5","reason":null,"replace_canceled_target":false,"rewrote_successors":false},"event":"release.renamed","event_id":"event-0088","record_revisions":{"entry:v0.3.0/entry-0001":3,"entry:v0.3.0/entry-0002":3,"entry:v0.3.0/entry-0003":2,"entry:v0.3.0/entry-0004":2,"release:v0.3.0":6},"release_version":"v0.3.0","schema_version":2}
 {"data":{"released_at":"2026-09-26"},"event":"release.finalized","event_id":"event-0089","record_revisions":{"release:v0.3.0":7},"release_version":"v0.3.0","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0090","record_revisions":{"release:v0.3.1":1},"release_version":"v0.3.1","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-0091","record_revisions":{"release:v0.3.1":2},"release_version":"v0.3.1","schema_version":2}
+{"data":{"row_count":1},"event":"audit.created","event_id":"event-0092","record_revisions":{"commit_audit_sheet":1},"release_version":"v0.3.1","schema_version":2}
+{"data":{"updated_rows":1},"event":"audit.updated","event_id":"event-0093","record_revisions":{"commit_audit_sheet":2},"release_version":"v0.3.1","schema_version":2}
+{"data":{"entry_ids":["entry-0001"],"synced_audit_rows":1},"event":"entry.batch_added","event_id":"event-0094","record_revisions":{"commit_audit_sheet":3,"entry:v0.3.1/entry-0001":1,"release:v0.3.1":3},"release_version":"v0.3.1","schema_version":2}
+{"data":{"released_at":"2026-09-26"},"event":"release.finalized","event_id":"event-0095","record_revisions":{"release:v0.3.1":4},"release_version":"v0.3.1","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0096","record_revisions":{"release:v0.3.2":1},"release_version":"v0.3.2","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-0097","record_revisions":{"release:v0.3.2":2},"release_version":"v0.3.2","schema_version":2}
+{"data":{"row_count":2},"event":"audit.created","event_id":"event-0098","record_revisions":{"commit_audit_sheet":1},"release_version":"v0.3.2","schema_version":2}
+{"data":{"updated_rows":2},"event":"audit.updated","event_id":"event-0099","record_revisions":{"commit_audit_sheet":2},"release_version":"v0.3.2","schema_version":2}
+{"data":{"entry_ids":["entry-0001","entry-0002"],"synced_audit_rows":1},"event":"entry.batch_added","event_id":"event-0100","record_revisions":{"commit_audit_sheet":3,"entry:v0.3.2/entry-0001":1,"entry:v0.3.2/entry-0002":1,"release:v0.3.2":3},"release_version":"v0.3.2","schema_version":2}
+{"data":{"updated_rows":2},"event":"audit.updated","event_id":"event-0101","record_revisions":{"commit_audit_sheet":4},"release_version":"v0.3.2","schema_version":2}
+{"data":{"entry_ids":["entry-0003"],"synced_audit_rows":2},"event":"entry.batch_added","event_id":"event-0102","record_revisions":{"commit_audit_sheet":5,"entry:v0.3.2/entry-0003":1,"release:v0.3.2":4},"release_version":"v0.3.2","schema_version":2}
+{"data":{"released_at":"2026-09-28"},"event":"release.finalized","event_id":"event-0103","record_revisions":{"release:v0.3.2":5},"release_version":"v0.3.2","schema_version":2}

readio-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/v0.3.1/audit/commit-audit.yaml

@@ -0,0 +1,56 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 3
+release_version: v0.3.1
+git_base_ref: v0.3.0
+git_base_sha: b00d42ac1b78971c18349253e1bc566ba9032ca1
+git_head_ref: HEAD
+git_head_sha: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+git_range: b00d42ac1b78971c18349253e1bc566ba9032ca1..86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+commit_count: 1
+rows:
+  - sha: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+    source_ref: git:86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+    short_sha: 86a3aec
+    changed_paths:
+      - .taskledger/ledgers/main/indexes/active_locks.json
+      - .taskledger/ledgers/main/indexes/dependencies.json
+      - .taskledger/ledgers/main/indexes/introductions.json
+      - docs/api.md
+      - readio/api/__init__.py
+      - readio/api/audiobooks.py
+      - readio/api/projects.py
+      - readio/api/types.py
+      - readio/stages/synthesis.py
+      - tests/test_public_api_imports.py
+      - tests/test_public_api_projects.py
+      - tests/test_public_api_types.py
+    stats:
+      files_changed: 12
+      insertions: 427
+      deletions: 15
+    inspected: true
+    inspected_paths:
+      - docs/api.md
+      - readio/api/__init__.py
+      - readio/api/audiobooks.py
+      - readio/api/projects.py
+      - readio/api/types.py
+      - readio/stages/synthesis.py
+      - tests/test_public_api_imports.py
+      - tests/test_public_api_projects.py
+      - tests/test_public_api_types.py
+    observed_behavior:
+      Added public APIs for describing persisted audiobook chapters
+      and resolving effective synthesis settings without rendering audio; documented
+      both APIs and covered serialization, validation, request overrides, and no-mutation
+      behavior with tests. Releaseledger index files in .taskledger were excluded from
+      inspection per the release workflow boundary.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: audiobook api improved"
+    target_entry_id: entry-0001
+    notes: Public API additions; .taskledger index artifacts are not release behavior.

readio-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/v0.3.1/entries/entry-0001.md

@@ -0,0 +1,37 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: v0.3.1
+kind: added
+summary:
+  Added audiobook chapter descriptions and non-rendering synthesis resolution
+  to the public API
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+paths:
+  - docs/api.md
+  - readio/api/__init__.py
+  - readio/api/audiobooks.py
+  - readio/api/projects.py
+  - readio/api/types.py
+  - readio/stages/synthesis.py
+  - tests/test_public_api_imports.py
+  - tests/test_public_api_projects.py
+  - tests/test_public_api_types.py
+issues: []
+prs: []
+sources:
+  - git:86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 1
+---

readio-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/v0.3.1/release.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 4
+version: v0.3.1
+status: released
+history_state: curated
+title: null
+released_at: "2026-09-26"
+previous_version: v0.3.0
+cancel_reason: null
+superseded_by: null
+changelog_file: docs/changelog.md
+boundary_ref: null
+source_refs: []
+source_count: null
+entry_count: 1
+artifact_count: 0
+git_base_ref: v0.3.0
+git_base_sha: b00d42ac1b78971c18349253e1bc566ba9032ca1
+git_head_ref: HEAD
+git_head_sha: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+git_range: b00d42ac1b78971c18349253e1bc566ba9032ca1..86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+git_commit_count: 1
+---

readio-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/v0.3.2/audit/commit-audit.yaml

@@ -0,0 +1,108 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 5
+release_version: v0.3.2
+git_base_ref: v0.3.1
+git_base_sha: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+git_head_ref: HEAD
+git_head_sha: 0251443b706966ad97a118f3494246f20e005001
+git_range: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472..0251443b706966ad97a118f3494246f20e005001
+commit_count: 2
+rows:
+  - sha: 20c403748d0d85caf31bcbc2d107275c06010c36
+    source_ref: git:20c403748d0d85caf31bcbc2d107275c06010c36
+    short_sha: 20c4037
+    changed_paths:
+      - .ledger/releaseledger/data/ledgers/main/events/events.jsonl
+      - .ledger/releaseledger/data/ledgers/main/releases/v0.3.1/audit/commit-audit.yaml
+      - .ledger/releaseledger/data/ledgers/main/releases/v0.3.1/entries/entry-0001.md
+      - .ledger/releaseledger/data/ledgers/main/releases/v0.3.1/release.md
+      - .ledger/releaseledger/work/v0.3.1/audit-decisions.yaml
+      - .ledger/releaseledger/work/v0.3.1/audit.yaml
+      - .ledger/releaseledger/work/v0.3.1/entries.yaml
+      - .ledger/releaseledger/work/v0.3.1/evidence/86a3aec.patch
+      - .ledger/releaseledger/work/v0.3.1/evidence/manifest.json
+      - .ledger/releaseledger/work/v0.3.1/range.json
+      - docs/changelog.md
+    stats:
+      files_changed: 11
+      insertions: 981
+      deletions: 0
+    inspected: true
+    inspected_paths:
+      - docs/changelog.md
+      - .ledger/releaseledger/data/ledgers/main/releases/v0.3.1/entries/entry-0001.md
+      - .ledger/releaseledger/data/ledgers/main/releases/v0.3.1/release.md
+    observed_behavior:
+      Adds the generated v0.3.1 changelog section and its release metadata;
+      it records prior-release behavior, not new v0.3.2 product behavior.
+    public_impact: docs
+    decision: accepted
+    stale: false
+    evidence_subject: "doc: changelog"
+    target_entry_id: entry-0003
+    notes:
+      This commit adds the previously released v0.3.1 public API entry to the user-facing
+      changelog.
+  - sha: 0251443b706966ad97a118f3494246f20e005001
+    source_ref: git:0251443b706966ad97a118f3494246f20e005001
+    short_sha: "0251443"
+    changed_paths:
+      - docs/index.md
+      - readio/api/projects.py
+      - readio/api/types.py
+      - readio/cli.py
+      - readio/config.py
+      - readio/engines/pykokoro.py
+      - readio/plan.py
+      - readio/spotify_cli.py
+      - readio/stages/pipeline.py
+      - readio/synthesis.py
+      - skill/readio/references/cli.md
+      - skill/readio/references/troubleshooting.md
+      - tests/test_cli.py
+      - tests/test_config.py
+      - tests/test_engine_spine.py
+      - tests/test_incremental_project_render.py
+      - tests/test_plan.py
+      - tests/test_public_api_projects.py
+      - tests/test_spotify_cli.py
+    stats:
+      files_changed: 19
+      insertions: 271
+      deletions: 45
+    inspected: true
+    inspected_paths:
+      - docs/index.md
+      - readio/api/projects.py
+      - readio/api/types.py
+      - readio/cli.py
+      - readio/config.py
+      - readio/engines/pykokoro.py
+      - readio/plan.py
+      - readio/spotify_cli.py
+      - readio/stages/pipeline.py
+      - readio/synthesis.py
+      - skill/readio/references/cli.md
+      - skill/readio/references/troubleshooting.md
+      - tests/test_cli.py
+      - tests/test_config.py
+      - tests/test_engine_spine.py
+      - tests/test_incremental_project_render.py
+      - tests/test_plan.py
+      - tests/test_public_api_projects.py
+      - tests/test_spotify_cli.py
+    observed_behavior:
+      Short-sentence synthesis now defaults to phrase handling and
+      migrates legacy auto settings; project status reports readable explanations and
+      actionable commands through the CLI and public API.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: modify short sentence default and fix status"
+    target_entry_id: entry-0001
+    notes:
+      Curated as two user-facing entries; the short-sentence entry owns this commit's
+      source_ref.

readio-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/v0.3.2/entries/entry-0001.md

@@ -0,0 +1,41 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: v0.3.2
+kind: changed
+summary:
+  Changed the default short-sentence policy to phrase, with migration for legacy
+  auto settings
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:0251443b706966ad97a118f3494246f20e005001
+paths:
+  - docs/index.md
+  - readio/config.py
+  - readio/engines/pykokoro.py
+  - readio/plan.py
+  - readio/synthesis.py
+  - readio/cli.py
+  - readio/spotify_cli.py
+  - skill/readio/references/cli.md
+  - skill/readio/references/troubleshooting.md
+  - tests/test_config.py
+  - tests/test_engine_spine.py
+  - tests/test_plan.py
+  - tests/test_spotify_cli.py
+issues: []
+prs: []
+sources:
+  - git:0251443b706966ad97a118f3494246f20e005001
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 1
+---

readio-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/v0.3.2/entries/entry-0002.md

@@ -0,0 +1,34 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0002
+release_version: v0.3.2
+kind: changed
+summary:
+  Changed project status output with clear issue explanations and actionable
+  commands in the CLI and public API
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - readio/api/projects.py
+  - readio/api/types.py
+  - readio/cli.py
+  - readio/stages/pipeline.py
+  - tests/test_cli.py
+  - tests/test_incremental_project_render.py
+  - tests/test_public_api_projects.py
+issues: []
+prs: []
+sources:
+  - git:0251443b706966ad97a118f3494246f20e005001
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 2
+---

readio-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/v0.3.2/entries/entry-0003.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0003
+release_version: v0.3.2
+kind: docs
+summary: Documented the v0.3.1 public API addition in the generated changelog
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:20c403748d0d85caf31bcbc2d107275c06010c36
+paths:
+  - docs/changelog.md
+issues: []
+prs: []
+sources:
+  - git:20c403748d0d85caf31bcbc2d107275c06010c36
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 3
+---

readio-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/v0.3.2/release.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 5
+version: v0.3.2
+status: released
+history_state: curated
+title: null
+released_at: "2026-09-28"
+previous_version: v0.3.1
+cancel_reason: null
+superseded_by: null
+changelog_file: docs/changelog.md
+boundary_ref: null
+source_refs: []
+source_count: null
+entry_count: 3
+artifact_count: 0
+git_base_ref: v0.3.1
+git_base_sha: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+git_head_ref: HEAD
+git_head_sha: 0251443b706966ad97a118f3494246f20e005001
+git_range: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472..0251443b706966ad97a118f3494246f20e005001
+git_commit_count: 2
+---

readio-0.3.2/.ledger/releaseledger/work/v0.3.1/audit-decisions.yaml

@@ -0,0 +1,20 @@
+rows:
+  - sha: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+    inspected: true
+    inspected_paths:
+      - docs/api.md
+      - readio/api/__init__.py
+      - readio/api/audiobooks.py
+      - readio/api/projects.py
+      - readio/api/types.py
+      - readio/stages/synthesis.py
+      - tests/test_public_api_imports.py
+      - tests/test_public_api_projects.py
+      - tests/test_public_api_types.py
+    observed_behavior: Added public APIs for describing persisted audiobook chapters and resolving effective synthesis settings without rendering audio; documented both APIs and covered serialization, validation, request overrides, and no-mutation behavior with tests. Releaseledger index files in .taskledger were excluded from inspection per the release workflow boundary.
+    public_impact: public
+    decision: accepted
+    target_entry_key: null
+    target_entry_id: null
+    notes: Public API additions; .taskledger index artifacts are not release behavior.
+    stale: false

readio-0.3.2/.ledger/releaseledger/work/v0.3.1/audit.yaml

@@ -0,0 +1,40 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 1
+release_version: v0.3.1
+git_base_ref: v0.3.0
+git_base_sha: b00d42ac1b78971c18349253e1bc566ba9032ca1
+git_head_ref: HEAD
+git_head_sha: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+git_range: b00d42ac1b78971c18349253e1bc566ba9032ca1..86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+commit_count: 1
+rows:
+  - sha: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+    source_ref: git:86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+    short_sha: 86a3aec
+    changed_paths:
+      - .taskledger/ledgers/main/indexes/active_locks.json
+      - .taskledger/ledgers/main/indexes/dependencies.json
+      - .taskledger/ledgers/main/indexes/introductions.json
+      - docs/api.md
+      - readio/api/__init__.py
+      - readio/api/audiobooks.py
+      - readio/api/projects.py
+      - readio/api/types.py
+      - readio/stages/synthesis.py
+      - tests/test_public_api_imports.py
+      - tests/test_public_api_projects.py
+      - tests/test_public_api_types.py
+    stats:
+      files_changed: 12
+      insertions: 427
+      deletions: 15
+    inspected: false
+    inspected_paths: []
+    observed_behavior: ""
+    public_impact: unknown
+    decision: needs_review
+    stale: false
+    evidence_subject: "feat: audiobook api improved"

readio-0.3.2/.ledger/releaseledger/work/v0.3.1/entries.yaml

@@ -0,0 +1,32 @@
+schema: releaseledger.entry-batch.v1
+operation: create
+schema_version: 1
+object_type: release_entry_batch
+release_version: v0.3.1
+git_base_ref: b00d42ac1b78971c18349253e1bc566ba9032ca1
+git_base_sha: b00d42ac1b78971c18349253e1bc566ba9032ca1
+git_head_ref: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+git_head_sha: 86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+include_merges: nontrivial
+entries:
+  - kind: added
+    summary: Added audiobook chapter descriptions and non-rendering synthesis resolution to the public API
+    status: accepted
+    source_refs:
+      - git:86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+    paths:
+      - docs/api.md
+      - readio/api/__init__.py
+      - readio/api/audiobooks.py
+      - readio/api/projects.py
+      - readio/api/types.py
+      - readio/stages/synthesis.py
+      - tests/test_public_api_imports.py
+      - tests/test_public_api_projects.py
+      - tests/test_public_api_types.py
+    sources:
+      - git:86a3aecedd9d31f8c36e2b85d8ec18aa833a2472
+    prs: []
+    issues: []
+    contributors:
+      - "@holgern"