utterplan 0.3.0__tar.gz → 0.3.2__tar.gz

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

@@ -41,3 +41,16 @@
 {"data":{"row_count":1},"event":"audit.created","event_id":"event-0041","record_revisions":{"commit_audit_sheet":1},"release_version":"0.3.0","schema_version":2}
 {"data":{"updated_rows":1},"event":"audit.updated","event_id":"event-0042","record_revisions":{"commit_audit_sheet":2},"release_version":"0.3.0","schema_version":2}
 {"data":{"entry_ids":["entry-0001","entry-0002","entry-0003","entry-0004","entry-0005","entry-0006"],"synced_audit_rows":1},"event":"entry.batch_added","event_id":"event-0043","record_revisions":{"commit_audit_sheet":3,"entry:0.3.0/entry-0001":1,"entry:0.3.0/entry-0002":1,"entry:0.3.0/entry-0003":1,"entry:0.3.0/entry-0004":1,"entry:0.3.0/entry-0005":1,"entry:0.3.0/entry-0006":1,"release:0.3.0":3},"release_version":"0.3.0","schema_version":2}
+{"data":{"released_at":"2026-09-24"},"event":"release.finalized","event_id":"event-0044","record_revisions":{"release:0.3.0":4},"release_version":"0.3.0","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0045","record_revisions":{"release:0.3.1":1},"release_version":"0.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-0046","record_revisions":{"release:0.3.1":2},"release_version":"0.3.1","schema_version":2}
+{"data":{"row_count":1},"event":"audit.created","event_id":"event-0047","record_revisions":{"commit_audit_sheet":1},"release_version":"0.3.1","schema_version":2}
+{"data":{"updated_rows":1},"event":"audit.updated","event_id":"event-0048","record_revisions":{"commit_audit_sheet":2},"release_version":"0.3.1","schema_version":2}
+{"data":{"entry_ids":["entry-0001"],"synced_audit_rows":1},"event":"entry.batch_added","event_id":"event-0049","record_revisions":{"commit_audit_sheet":3,"entry:0.3.1/entry-0001":1,"release:0.3.1":3},"release_version":"0.3.1","schema_version":2}
+{"data":{"released_at":"2026-09-27"},"event":"release.finalized","event_id":"event-0050","record_revisions":{"release:0.3.1":4},"release_version":"0.3.1","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0051","record_revisions":{"release:0.3.2":1},"release_version":"0.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-0052","record_revisions":{"release:0.3.2":2},"release_version":"0.3.2","schema_version":2}
+{"data":{"row_count":3},"event":"audit.created","event_id":"event-0053","record_revisions":{"commit_audit_sheet":1},"release_version":"0.3.2","schema_version":2}
+{"data":{"updated_rows":3},"event":"audit.updated","event_id":"event-0054","record_revisions":{"commit_audit_sheet":2},"release_version":"0.3.2","schema_version":2}
+{"data":{"entry_ids":["entry-0001","entry-0002"],"synced_audit_rows":2},"event":"entry.batch_added","event_id":"event-0055","record_revisions":{"commit_audit_sheet":3,"entry:0.3.2/entry-0001":1,"entry:0.3.2/entry-0002":1,"release:0.3.2":3},"release_version":"0.3.2","schema_version":2}
+{"data":{"released_at":"2026-10-03"},"event":"release.finalized","event_id":"event-0056","record_revisions":{"release:0.3.2":4},"release_version":"0.3.2","schema_version":2}

{utterplan-0.3.0 → utterplan-0.3.2}/.ledger/releaseledger/data/ledgers/main/releases/0.3.0/release.md

@@ -3,16 +3,16 @@ schema_version: 2
 object_type: release
 versioning:
   schema_version: 1
-  revision: 3
+  revision: 4
 version: 0.3.0
-status: planned
+status: released
 history_state: curated
 title: null
-released_at: null
+released_at: "2026-09-24"
 previous_version: 0.2.0
 cancel_reason: null
 superseded_by: null
-changelog_file: null
+changelog_file: docs/changelog.md
 boundary_ref: null
 source_refs: []
 source_count: null

utterplan-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/0.3.1/audit/commit-audit.yaml

@@ -0,0 +1,57 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 3
+release_version: 0.3.1
+git_base_ref: v0.3.0
+git_base_sha: ad398fd2c943113966bb6ad0a247c2c6c90c676b
+git_head_ref: HEAD
+git_head_sha: 70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+git_range: ad398fd2c943113966bb6ad0a247c2c6c90c676b..70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+commit_count: 1
+rows:
+  - sha: 70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+    source_ref: git:70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+    short_sha: 70adac0
+    changed_paths:
+      - docs/consumer-guide.md
+      - docs/python-api.md
+      - tests/test_consumer_contract.py
+      - tests/test_directives.py
+      - tests/test_fake_renderer.py
+      - tests/test_format.py
+      - tests/test_identity_units.py
+      - tests/test_planner.py
+      - tests/test_preparation.py
+      - tests/test_ssmd_09_parser.py
+      - utterplan/parsers.py
+      - utterplan/planner.py
+    stats:
+      files_changed: 12
+      insertions: 719
+      deletions: 15
+    inspected: true
+    inspected_paths:
+      - docs/consumer-guide.md
+      - docs/python-api.md
+      - tests/test_consumer_contract.py
+      - tests/test_directives.py
+      - tests/test_fake_renderer.py
+      - tests/test_format.py
+      - tests/test_identity_units.py
+      - tests/test_planner.py
+      - tests/test_preparation.py
+      - tests/test_ssmd_09_parser.py
+      - utterplan/parsers.py
+      - utterplan/planner.py
+    observed_behavior:
+      Each SSMD audio annotation maps to one renderer-neutral segment;
+      audio sources remain opaque, fallback text is optional, zero-width occurrences
+      are retained, and unsupported audio topologies fail planning
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: handle audio media segments"
+    target_entry_id: entry-0001
+    notes: ""

utterplan-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/0.3.1/entries/entry-0001.md

@@ -0,0 +1,42 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: 0.3.1
+kind: added
+summary:
+  Added renderer-neutral SSMD audio segments with opaque sources and optional
+  spoken fallback
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+paths:
+  - docs/consumer-guide.md
+  - docs/python-api.md
+  - tests/test_consumer_contract.py
+  - tests/test_directives.py
+  - tests/test_fake_renderer.py
+  - tests/test_format.py
+  - tests/test_identity_units.py
+  - tests/test_planner.py
+  - tests/test_preparation.py
+  - tests/test_ssmd_09_parser.py
+  - utterplan/parsers.py
+  - utterplan/planner.py
+issues: []
+prs: []
+sources:
+  - git:70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 1
+---
+
+Each SSMD audio annotation maps to one segment carrying `directives.audio`; the source remains opaque and `segment.text` is optional fallback (empty when absent). Repeated sources remain distinct occurrences.

utterplan-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/0.3.1/release.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 4
+version: 0.3.1
+status: released
+history_state: curated
+title: null
+released_at: "2026-09-27"
+previous_version: 0.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: ad398fd2c943113966bb6ad0a247c2c6c90c676b
+git_head_ref: HEAD
+git_head_sha: 70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+git_range: ad398fd2c943113966bb6ad0a247c2c6c90c676b..70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+git_commit_count: 1
+---

utterplan-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/0.3.2/audit/commit-audit.yaml

@@ -0,0 +1,105 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 3
+release_version: 0.3.2
+git_base_ref: v0.3.1
+git_base_sha: b0415758f6c1d1890d8015ce40c1e52d6120cf46
+git_head_ref: HEAD
+git_head_sha: ba3b5afb6c619cf91e482db16b19d53f199eb1e2
+git_range: b0415758f6c1d1890d8015ce40c1e52d6120cf46..ba3b5afb6c619cf91e482db16b19d53f199eb1e2
+commit_count: 3
+rows:
+  - sha: 6c2a1ac444c76ea183a791b59af2e92fb60dbb23
+    source_ref: git:6c2a1ac444c76ea183a791b59af2e92fb60dbb23
+    short_sha: 6c2a1ac
+    changed_paths:
+      - tests/test_preparation.py
+      - utterplan/preparation.py
+    stats:
+      files_changed: 2
+      insertions: 40
+      deletions: 1
+    inspected: true
+    inspected_paths:
+      - tests/test_preparation.py
+      - utterplan/preparation.py
+    observed_behavior:
+      Spoken-text preparation protects annotation spans using sub,
+      as, say-as, ph, or phonemes from automated replacement while preserving source
+      offset mappings.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: improve prepare ssmd"
+    target_entry_id: entry-0001
+    notes: ""
+  - sha: a2bc20d5d25f880688886f1867f0fd398a5b8c7e
+    source_ref: git:a2bc20d5d25f880688886f1867f0fd398a5b8c7e
+    short_sha: a2bc20d
+    changed_paths:
+      - 01_todo.md
+      - plan.md
+    stats:
+      files_changed: 2
+      insertions: 0
+      deletions: 1907
+    inspected: true
+    inspected_paths:
+      - 01_todo.md
+      - plan.md
+    observed_behavior:
+      Removed planning-only repository files; no runtime or public
+      package behavior changed.
+    public_impact: internal
+    decision: internal
+    stale: false
+    evidence_subject: "chore: remove plan files"
+    notes: Repository planning artifacts only, with no user-facing change.
+  - sha: ba3b5afb6c619cf91e482db16b19d53f199eb1e2
+    source_ref: git:ba3b5afb6c619cf91e482db16b19d53f199eb1e2
+    short_sha: ba3b5af
+    changed_paths:
+      - tests/golden/ssmd_09_comprehensive.utterplan.json
+      - tests/migration/goldens/multilingual_preparation.json
+      - tests/migration/goldens/spokenform_numbers.json
+      - tests/migration/goldens/ssmd_break.json
+      - tests/migration/goldens/ssmd_language_detection.json
+      - tests/migration/goldens/ssmd_marker.json
+      - tests/migration/goldens/ssmd_pronunciation.json
+      - tests/test_consumer_readiness.py
+      - tests/test_preparation.py
+      - tests/test_ssmd_09_parser.py
+      - utterplan/parsers.py
+      - utterplan/planner.py
+      - utterplan/preparation.py
+    stats:
+      files_changed: 13
+      insertions: 183
+      deletions: 7
+    inspected: true
+    inspected_paths:
+      - tests/golden/ssmd_09_comprehensive.utterplan.json
+      - tests/migration/goldens/multilingual_preparation.json
+      - tests/migration/goldens/spokenform_numbers.json
+      - tests/migration/goldens/ssmd_break.json
+      - tests/migration/goldens/ssmd_language_detection.json
+      - tests/migration/goldens/ssmd_marker.json
+      - tests/migration/goldens/ssmd_pronunciation.json
+      - tests/test_consumer_readiness.py
+      - tests/test_preparation.py
+      - tests/test_ssmd_09_parser.py
+      - utterplan/parsers.py
+      - utterplan/planner.py
+      - utterplan/preparation.py
+    observed_behavior:
+      SSMD sequence_fallback_mode accepts spell or preserve, defaults
+      to spell, is forwarded to spoken-form preparation and serialized in plan metadata
+      and identity, and rejects invalid values.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: parse fallback mode parameter from ssmdconvert settings"
+    target_entry_id: entry-0002
+    notes: ""

utterplan-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/0.3.2/entries/entry-0001.md

@@ -0,0 +1,32 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: 0.3.2
+kind: fixed
+summary:
+  Fixed text preparation so authored SSMD substitutions and say-as annotations
+  remain unchanged
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:6c2a1ac444c76ea183a791b59af2e92fb60dbb23
+paths:
+  - tests/test_preparation.py
+  - utterplan/preparation.py
+issues: []
+prs: []
+sources:
+  - git:6c2a1ac444c76ea183a791b59af2e92fb60dbb23
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 1
+---
+
+Spoken-text preparation excludes spans with `sub`, `as`, and `say-as` attributes from automatic spoken-form replacement, preserving author-provided text while retaining existing pronunciation protections.

utterplan-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/0.3.2/entries/entry-0002.md

@@ -0,0 +1,41 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0002
+release_version: 0.3.2
+kind: added
+summary: Added SSMD sequence fallback mode controls for spoken-form preparation
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:ba3b5afb6c619cf91e482db16b19d53f199eb1e2
+paths:
+  - tests/golden/ssmd_09_comprehensive.utterplan.json
+  - tests/migration/goldens/multilingual_preparation.json
+  - tests/migration/goldens/spokenform_numbers.json
+  - tests/migration/goldens/ssmd_break.json
+  - tests/migration/goldens/ssmd_language_detection.json
+  - tests/migration/goldens/ssmd_marker.json
+  - tests/migration/goldens/ssmd_pronunciation.json
+  - tests/test_consumer_readiness.py
+  - tests/test_preparation.py
+  - tests/test_ssmd_09_parser.py
+  - utterplan/parsers.py
+  - utterplan/planner.py
+  - utterplan/preparation.py
+issues: []
+prs: []
+sources:
+  - git:ba3b5afb6c619cf91e482db16b19d53f199eb1e2
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 2
+---
+
+SSMD headers can choose `spell` or `preserve` for sequence fallback behavior. The default remains `spell`; the selected mode is carried in plan metadata, and invalid values are rejected during planning.

utterplan-0.3.2/.ledger/releaseledger/data/ledgers/main/releases/0.3.2/release.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 4
+version: 0.3.2
+status: released
+history_state: curated
+title: null
+released_at: "2026-10-03"
+previous_version: 0.3.1
+cancel_reason: null
+superseded_by: null
+changelog_file: null
+boundary_ref: null
+source_refs: []
+source_count: null
+entry_count: 2
+artifact_count: 0
+git_base_ref: v0.3.1
+git_base_sha: b0415758f6c1d1890d8015ce40c1e52d6120cf46
+git_head_ref: HEAD
+git_head_sha: ba3b5afb6c619cf91e482db16b19d53f199eb1e2
+git_range: b0415758f6c1d1890d8015ce40c1e52d6120cf46..ba3b5afb6c619cf91e482db16b19d53f199eb1e2
+git_commit_count: 3
+---

utterplan-0.3.2/.ledger/releaseledger/work/0.3.1/audit-decisions.yaml

@@ -0,0 +1,23 @@
+rows:
+  - sha: 70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+    inspected: true
+    inspected_paths:
+      - docs/consumer-guide.md
+      - docs/python-api.md
+      - tests/test_consumer_contract.py
+      - tests/test_directives.py
+      - tests/test_fake_renderer.py
+      - tests/test_format.py
+      - tests/test_identity_units.py
+      - tests/test_planner.py
+      - tests/test_preparation.py
+      - tests/test_ssmd_09_parser.py
+      - utterplan/parsers.py
+      - utterplan/planner.py
+    observed_behavior: Each SSMD audio annotation maps to one renderer-neutral segment; audio sources remain opaque, fallback text is optional, zero-width occurrences are retained, and unsupported audio topologies fail planning
+    public_impact: public
+    decision: accepted
+    target_entry_key: null
+    target_entry_id: null
+    notes: ""
+    stale: false

utterplan-0.3.2/.ledger/releaseledger/work/0.3.1/audit.yaml

@@ -0,0 +1,40 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 1
+release_version: 0.3.1
+git_base_ref: v0.3.0
+git_base_sha: ad398fd2c943113966bb6ad0a247c2c6c90c676b
+git_head_ref: HEAD
+git_head_sha: 70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+git_range: ad398fd2c943113966bb6ad0a247c2c6c90c676b..70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+commit_count: 1
+rows:
+  - sha: 70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+    source_ref: git:70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+    short_sha: 70adac0
+    changed_paths:
+      - docs/consumer-guide.md
+      - docs/python-api.md
+      - tests/test_consumer_contract.py
+      - tests/test_directives.py
+      - tests/test_fake_renderer.py
+      - tests/test_format.py
+      - tests/test_identity_units.py
+      - tests/test_planner.py
+      - tests/test_preparation.py
+      - tests/test_ssmd_09_parser.py
+      - utterplan/parsers.py
+      - utterplan/planner.py
+    stats:
+      files_changed: 12
+      insertions: 719
+      deletions: 15
+    inspected: false
+    inspected_paths: []
+    observed_behavior: ""
+    public_impact: unknown
+    decision: needs_review
+    stale: false
+    evidence_subject: "feat: handle audio media segments"

utterplan-0.3.2/.ledger/releaseledger/work/0.3.1/entries.yaml

@@ -0,0 +1,37 @@
+schema: releaseledger.entry-batch.v1
+operation: create
+schema_version: 1
+object_type: release_entry_batch
+release_version: 0.3.1
+git_base_ref: ad398fd2c943113966bb6ad0a247c2c6c90c676b
+git_base_sha: ad398fd2c943113966bb6ad0a247c2c6c90c676b
+git_head_ref: 70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+git_head_sha: 70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+include_merges: nontrivial
+entries:
+  - kind: added
+    summary: Added renderer-neutral SSMD audio segments with opaque sources and optional spoken fallback
+    status: accepted
+    body: >-
+      Each SSMD audio annotation maps to one segment carrying `directives.audio`; the source remains opaque and `segment.text` is optional fallback (empty when absent). Repeated sources remain distinct occurrences.
+    source_refs:
+      - git:70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+    paths:
+      - docs/consumer-guide.md
+      - docs/python-api.md
+      - tests/test_consumer_contract.py
+      - tests/test_directives.py
+      - tests/test_fake_renderer.py
+      - tests/test_format.py
+      - tests/test_identity_units.py
+      - tests/test_planner.py
+      - tests/test_preparation.py
+      - tests/test_ssmd_09_parser.py
+      - utterplan/parsers.py
+      - utterplan/planner.py
+    sources:
+      - git:70adac05bf008abfed0e8ea46eb9d0973ba1cd82
+    prs: []
+    issues: []
+    contributors:
+      - "@holgern"