utterplan 0.2.0__tar.gz → 0.3.1__tar.gz

{utterplan-0.2.0 → utterplan-0.3.1}/.github/workflows/python-publish.yml

@@ -45,18 +45,21 @@ jobs:
           from packaging.requirements import Requirement
           from packaging.version import Version
 
-          def has_minimum(requirements, name, minimum):
+          def has_range(requirements, name, minimum, maximum):
               minimum_version = Version(minimum)
+              maximum_version = Version(maximum)
               return any(
                   requirement.name == name
                   and any(
-                      spec.operator in (">=", ">", "==")
-                      and Version(spec.version) >= minimum_version
+                      spec.operator == ">=" and Version(spec.version) == minimum_version
+                      for spec in requirement.specifier
+                  )
+                  and any(
+                      spec.operator == "<" and Version(spec.version) == maximum_version
                       for spec in requirement.specifier
                   )
                   for requirement in requirements
               )
-
           tag_version = os.environ["RELEASE_TAG"].removeprefix("v")
           artifacts = list(Path("dist").iterdir())
           wheels = [path for path in artifacts if path.suffix == ".whl"]
@@ -76,11 +79,18 @@ jobs:
               requirements = [
                   Requirement(value) for value in metadata.get_all("Requires-Dist", [])
               ]
-              assert has_minimum(requirements, "phrasplit", "0.3.9")
-              assert has_minimum(requirements, "ssmd", "0.8.7")
-              assert has_minimum(requirements, "spokenform", "0.4.3")
-              assert any(name.endswith("utterplan/py.typed") for name in archive.namelist())
-              assert any(name.endswith("utterplan/utterplan.schema.json") for name in archive.namelist())
+              assert has_range(requirements, "phrasplit", "0.3.9", "0.4")
+              assert has_range(requirements, "ssmd", "0.9.0", "0.10")
+              assert has_range(requirements, "spokenform", "0.4.3", "0.5")
+              names = set(archive.namelist())
+              expected = {
+                  "utterplan/py.typed",
+                  "utterplan/utterplan.schema.json",
+                  "utterplan/schemas/v1.schema.json",
+                  "utterplan/schemas/v2.schema.json",
+                  "utterplan/schemas/v3.schema.json",
+              }
+              assert expected <= names
           PY
 
       - name: Publish package to PyPI

utterplan-0.3.1/.github/workflows/tests.yml

@@ -0,0 +1,177 @@
+name: Run tests
+
+on:
+  push:
+  pull_request:
+  workflow_call:
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install package
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+          python -m compileall -q utterplan tests
+      - name: Type-check package
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
+        run: python -m mypy utterplan
+      - name: Lint package
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
+        run: python -m ruff check .
+      - name: Run tests
+        run: python -m pytest -q
+
+  lower-bounds:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+      - name: Install lower-bound dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install pytest jsonschema
+          python -m pip install \
+            "phrasplit==0.3.9" \
+            "ssmd==0.9.0" \
+            "spokenform==0.4.3" \
+            "typing_extensions>=4.0"
+          python -m pip install --no-deps -e .
+      - name: Run lower-bound tests
+        run: python -m pytest -q
+
+  package-smoke:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build wheel and sdist
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build --outdir "$RUNNER_TEMP/dist"
+      - name: Verify wheel and sdist contents and dependency metadata
+        run: |
+          python - <<'PY'
+          import os
+          import tarfile
+          from email import policy
+          from email.parser import Parser
+          from pathlib import Path
+          from zipfile import ZipFile
+
+          from packaging.requirements import Requirement
+          from packaging.version import Version
+
+          artifacts = Path(os.environ["RUNNER_TEMP"]) / "dist"
+          wheel = next(artifacts.glob("*.whl"))
+          sdist = next(artifacts.glob("*.tar.gz"))
+          expected = {
+              "utterplan/py.typed",
+              "utterplan/utterplan.schema.json",
+              "utterplan/schemas/v1.schema.json",
+              "utterplan/schemas/v2.schema.json",
+              "utterplan/schemas/v3.schema.json",
+          }
+          expected_ranges = {
+              "phrasplit": ("0.3.9", "0.4"),
+              "ssmd": ("0.9.0", "0.10"),
+              "spokenform": ("0.4.3", "0.5"),
+          }
+
+          def check_metadata(contents):
+              metadata = Parser(policy=policy.default).parsestr(contents)
+              requirements = metadata.get_all("Requires-Dist", [])
+              for name, (minimum, maximum) in expected_ranges.items():
+                  requirement = next(
+                      Requirement(value)
+                      for value in requirements
+                      if Requirement(value).name == name
+                  )
+                  assert any(
+                      spec.operator == ">=" and Version(spec.version) == Version(minimum)
+                      for spec in requirement.specifier
+                  ), (name, requirement)
+                  assert any(
+                      spec.operator == "<" and Version(spec.version) == Version(maximum)
+                      for spec in requirement.specifier
+                  ), (name, requirement)
+
+          with ZipFile(wheel) as archive:
+              wheel_names = set(archive.namelist())
+              assert expected <= wheel_names
+              metadata_name = next(
+                  name for name in wheel_names if name.endswith("METADATA")
+              )
+              check_metadata(archive.read(metadata_name).decode("utf-8"))
+
+          with tarfile.open(sdist, "r:gz") as archive:
+              sdist_names = archive.getnames()
+              assert all(
+                  any(name.endswith(resource) for name in sdist_names)
+                  for resource in expected
+              )
+              metadata_name = next(
+                  name for name in sdist_names if name.endswith("PKG-INFO")
+              )
+              check_metadata(
+                  archive.extractfile(metadata_name).read().decode("utf-8")
+              )
+          PY
+      - name: Install wheel in clean environment
+        run: |
+          python -m venv "$RUNNER_TEMP/utterplan-wheel-venv"
+          "$RUNNER_TEMP/utterplan-wheel-venv/bin/python" -m pip install \
+            "$RUNNER_TEMP"/dist/utterplan-*.whl
+      - name: Run installed smoke checks
+        run: |
+          "$RUNNER_TEMP/utterplan-wheel-venv/bin/python" -c \
+            "import importlib.metadata as m; import utterplan; assert m.version('utterplan') == utterplan.__version__"
+          "$RUNNER_TEMP/utterplan-wheel-venv/bin/utterplan" --version
+          cat > "$RUNNER_TEMP/test.ssmd.md" <<'EOF'
+          ---
+          ssmd_version: "0.9"
+          language: en-US
+          pause_defaults:
+            sentence: 500ms
+          ---
+          [Hello]{voice-name="test"} ...200ms world.
+          EOF
+          "$RUNNER_TEMP/utterplan-wheel-venv/bin/utterplan" compile \
+            "$RUNNER_TEMP/test.ssmd.md" --lang en-us --text-preparation identity --json \
+            > "$RUNNER_TEMP/test.utterplan.json"
+          "$RUNNER_TEMP/utterplan-wheel-venv/bin/utterplan" validate \
+            "$RUNNER_TEMP/test.utterplan.json"
+          cat > "$RUNNER_TEMP/test-0.8.ssmd.md" <<'EOF'
+          ---
+          ssmd_version: "0.8"
+          ---
+          Hello.
+          EOF
+          if "$RUNNER_TEMP/utterplan-wheel-venv/bin/utterplan" compile \
+            "$RUNNER_TEMP/test-0.8.ssmd.md" --lang en-us --text-preparation identity --json \
+            > "$RUNNER_TEMP/test-0.8.out" 2>&1; then
+            cat "$RUNNER_TEMP/test-0.8.out"
+            echo "Installed wheel accepted an SSMD 0.8 document" >&2
+            exit 1
+          fi
+          grep -q "header.version_unsupported" "$RUNNER_TEMP/test-0.8.out"
+          "$RUNNER_TEMP/utterplan-wheel-venv/bin/utterplan" migrate \
+            "$GITHUB_WORKSPACE/tests/schema_history/v1/basic.json" --check
+          "$RUNNER_TEMP/utterplan-wheel-venv/bin/utterplan" inspect \
+            "$RUNNER_TEMP/test.utterplan.json" --segment 0

{utterplan-0.2.0 → utterplan-0.3.1}/.ledger/releaseledger/data/ledgers/main/events/events.jsonl

@@ -36,3 +36,15 @@
 {"data":{"updated_rows":3},"event":"audit.updated","event_id":"event-0036","record_revisions":{"commit_audit_sheet":3},"release_version":"0.2.0","schema_version":2}
 {"data":{"entry_ids":["entry-0001","entry-0002","entry-0003","entry-0004"],"synced_audit_rows":3},"event":"entry.batch_added","event_id":"event-0037","record_revisions":{"commit_audit_sheet":4,"entry:0.2.0/entry-0001":1,"entry:0.2.0/entry-0002":1,"entry:0.2.0/entry-0003":1,"entry:0.2.0/entry-0004":1,"release:0.2.0":3},"release_version":"0.2.0","schema_version":2}
 {"data":{"released_at":"2026-09-22"},"event":"release.finalized","event_id":"event-0038","record_revisions":{"release:0.2.0":4},"release_version":"0.2.0","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0039","record_revisions":{"release:0.3.0":1},"release_version":"0.3.0","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-0040","record_revisions":{"release:0.3.0":2},"release_version":"0.3.0","schema_version":2}
+{"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}

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

@@ -0,0 +1,148 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 3
+release_version: 0.3.0
+git_base_ref: v0.2.0
+git_base_sha: 215d3a4b43ccaadbf50cb40b752ae30a5b4f39e5
+git_head_ref: HEAD
+git_head_sha: 49023f0470950eb3b1ff9a1c9a928bac5a47575e
+git_range: 215d3a4b43ccaadbf50cb40b752ae30a5b4f39e5..49023f0470950eb3b1ff9a1c9a928bac5a47575e
+commit_count: 1
+rows:
+  - sha: 49023f0470950eb3b1ff9a1c9a928bac5a47575e
+    source_ref: git:49023f0470950eb3b1ff9a1c9a928bac5a47575e
+    short_sha: 49023f0
+    changed_paths:
+      - .github/workflows/tests.yml
+      - README.md
+      - docs/architecture.md
+      - docs/cli.md
+      - docs/consumer-guide.md
+      - docs/coordinate-spaces.md
+      - docs/debugging.md
+      - docs/format.md
+      - docs/getting-started.md
+      - docs/python-api.md
+      - examples/chapter.ssmd
+      - pyproject.toml
+      - spec/schemas/v3.schema.json
+      - spec/utterplan.schema.json
+      - tests/fixtures/ssmd_09_comprehensive.ssmd
+      - tests/golden/ssmd_09_comprehensive.utterplan.json
+      - tests/migration/cases.py
+      - 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/schema_history/README.md
+      - tests/schema_history/v2/directives.json
+      - tests/test_cli.py
+      - tests/test_consumer_contract.py
+      - tests/test_consumer_readiness.py
+      - tests/test_coordinates.py
+      - tests/test_directives.py
+      - tests/test_explain.py
+      - tests/test_fake_renderer.py
+      - tests/test_format.py
+      - tests/test_golden.py
+      - tests/test_migration_framework.py
+      - tests/test_preparation.py
+      - tests/test_public_identity.py
+      - tests/test_schema_history.py
+      - tests/test_schema_registry.py
+      - tests/test_ssmd_09_parser.py
+      - utterplan/__init__.py
+      - utterplan/cli.py
+      - utterplan/directives.py
+      - utterplan/explain.py
+      - utterplan/language.py
+      - utterplan/migrations/__init__.py
+      - utterplan/migrations/v2_to_v3.py
+      - utterplan/model.py
+      - utterplan/parsers.py
+      - utterplan/pauses.py
+      - utterplan/planner.py
+      - utterplan/preparation.py
+      - utterplan/schema_registry.py
+      - utterplan/schemas/v3.schema.json
+      - utterplan/stages/segmentation/phrasplit.py
+      - utterplan/utterplan.schema.json
+      - utterplan/versioning.py
+    stats:
+      files_changed: 57
+      insertions: 4920
+      deletions: 507
+    inspected: true
+    inspected_paths:
+      - .github/workflows/tests.yml
+      - README.md
+      - docs/architecture.md
+      - docs/cli.md
+      - docs/consumer-guide.md
+      - docs/coordinate-spaces.md
+      - docs/debugging.md
+      - docs/format.md
+      - docs/getting-started.md
+      - docs/python-api.md
+      - examples/chapter.ssmd
+      - pyproject.toml
+      - spec/schemas/v3.schema.json
+      - spec/utterplan.schema.json
+      - tests/fixtures/ssmd_09_comprehensive.ssmd
+      - tests/golden/ssmd_09_comprehensive.utterplan.json
+      - tests/migration/cases.py
+      - 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/schema_history/README.md
+      - tests/schema_history/v2/directives.json
+      - tests/test_cli.py
+      - tests/test_consumer_contract.py
+      - tests/test_consumer_readiness.py
+      - tests/test_coordinates.py
+      - tests/test_directives.py
+      - tests/test_explain.py
+      - tests/test_fake_renderer.py
+      - tests/test_format.py
+      - tests/test_golden.py
+      - tests/test_migration_framework.py
+      - tests/test_preparation.py
+      - tests/test_public_identity.py
+      - tests/test_schema_history.py
+      - tests/test_schema_registry.py
+      - tests/test_ssmd_09_parser.py
+      - utterplan/__init__.py
+      - utterplan/cli.py
+      - utterplan/directives.py
+      - utterplan/explain.py
+      - utterplan/language.py
+      - utterplan/migrations/__init__.py
+      - utterplan/migrations/v2_to_v3.py
+      - utterplan/model.py
+      - utterplan/parsers.py
+      - utterplan/pauses.py
+      - utterplan/planner.py
+      - utterplan/preparation.py
+      - utterplan/schema_registry.py
+      - utterplan/schemas/v3.schema.json
+      - utterplan/stages/segmentation/phrasplit.py
+      - utterplan/utterplan.schema.json
+      - utterplan/versioning.py
+    observed_behavior:
+      Adds an SSMD 0.9-only parser and dependency contract, typed renderer-neutral
+      schema v3 semantics with source provenance, sequential v1/v2 plan migrations,
+      and matching CLI, documentation, and test coverage. The planner remains engine-independent
+      and retains deterministic sentence topology.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: support ssmd 0.9 and prepare v3 plan"
+    target_entry_id: entry-0001
+    notes: ""

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

@@ -0,0 +1,85 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: 0.3.0
+kind: changed
+summary: Changed source compatibility to SSMD 0.9 with typed schema v3 plans
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:49023f0470950eb3b1ff9a1c9a928bac5a47575e
+paths:
+  - .github/workflows/tests.yml
+  - README.md
+  - docs/architecture.md
+  - docs/cli.md
+  - docs/consumer-guide.md
+  - docs/coordinate-spaces.md
+  - docs/debugging.md
+  - docs/format.md
+  - docs/getting-started.md
+  - docs/python-api.md
+  - examples/chapter.ssmd
+  - pyproject.toml
+  - spec/schemas/v3.schema.json
+  - spec/utterplan.schema.json
+  - tests/fixtures/ssmd_09_comprehensive.ssmd
+  - tests/golden/ssmd_09_comprehensive.utterplan.json
+  - tests/migration/cases.py
+  - 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/schema_history/README.md
+  - tests/schema_history/v2/directives.json
+  - tests/test_cli.py
+  - tests/test_consumer_contract.py
+  - tests/test_consumer_readiness.py
+  - tests/test_coordinates.py
+  - tests/test_directives.py
+  - tests/test_explain.py
+  - tests/test_fake_renderer.py
+  - tests/test_format.py
+  - tests/test_golden.py
+  - tests/test_migration_framework.py
+  - tests/test_preparation.py
+  - tests/test_public_identity.py
+  - tests/test_schema_history.py
+  - tests/test_schema_registry.py
+  - tests/test_ssmd_09_parser.py
+  - utterplan/__init__.py
+  - utterplan/cli.py
+  - utterplan/directives.py
+  - utterplan/explain.py
+  - utterplan/language.py
+  - utterplan/migrations/__init__.py
+  - utterplan/migrations/v2_to_v3.py
+  - utterplan/model.py
+  - utterplan/parsers.py
+  - utterplan/pauses.py
+  - utterplan/planner.py
+  - utterplan/preparation.py
+  - utterplan/schema_registry.py
+  - utterplan/schemas/v3.schema.json
+  - utterplan/stages/segmentation/phrasplit.py
+  - utterplan/utterplan.schema.json
+  - utterplan/versioning.py
+issues: []
+prs: []
+sources:
+  - git:49023f0470950eb3b1ff9a1c9a928bac5a47575e
+contributors:
+  - "@holgern"
+breaking: true
+internal: false
+order: 1
+---
+
+SSMD input uses dialect 0.9 and older source syntax is rejected. Schema v3 preserves typed renderer-neutral directives and source provenance; supported v1 and v2 plans migrate to v3 without reparsing or replanning.

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

@@ -0,0 +1,29 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0002
+release_version: 0.3.0
+kind: fixed
+summary: Fixed precedence so authored SSMD breaks override generated pauses
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - utterplan/pauses.py
+  - tests/test_pauses.py
+  - tests/test_ssmd_09_parser.py
+issues: []
+prs: []
+sources:
+  - tl:task-0017
+contributors: []
+breaking: false
+internal: false
+order: 2
+---
+
+At a shared boundary, an explicit SSMD break wins over automatic or default pauses. Durations are not added, all contributing event IDs remain in provenance, and an authored zero-duration break still takes precedence.

utterplan-0.3.1/.ledger/releaseledger/data/ledgers/main/releases/0.3.0/entries/entry-0003.md

@@ -0,0 +1,32 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0003
+release_version: 0.3.0
+kind: changed
+summary: Changed Python input defaults and renamed SSMDConfig options
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - utterplan/config.py
+  - utterplan/parsers.py
+  - utterplan/planner.py
+  - docs/python-api.md
+  - docs/consumer-guide.md
+  - tests/test_consumer_readiness.py
+issues: []
+prs: []
+sources:
+  - tl:task-0017
+contributors: []
+breaking: true
+internal: false
+order: 3
+---
+
+PlannerConfig now treats strings as plain text unless SSMD is selected explicitly. The no-op strict_header and unknown_header options were removed; parse_header and the application pause_defaults option are now parse_yaml_header and pause_overrides. The source-header pause_defaults key remains unchanged.

utterplan-0.3.1/.ledger/releaseledger/data/ledgers/main/releases/0.3.0/entries/entry-0004.md

@@ -0,0 +1,28 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0004
+release_version: 0.3.0
+kind: changed
+summary: Changed clause enrichment to reuse provider-owned spaCy docs
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - utterplan/planner.py
+  - tests/test_linguistics.py
+issues: []
+prs: []
+sources:
+  - tl:task-0017
+contributors: []
+breaking: false
+internal: false
+order: 4
+---
+
+Clausal-boundary enrichment reuses the request-local provider document when available. Fallback analysis does not infer syntactic clauses, and sentence topology remains on the deterministic spaCy-free segmentation path.

utterplan-0.3.1/.ledger/releaseledger/data/ledgers/main/releases/0.3.0/entries/entry-0005.md

@@ -0,0 +1,30 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0005
+release_version: 0.3.0
+kind: added
+summary: Added PEP 561 metadata and SSMD 0.9 package checks
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - utterplan/py.typed
+  - pyproject.toml
+  - .github/workflows/tests.yml
+  - .github/workflows/python-publish.yml
+issues: []
+prs: []
+sources:
+  - tl:task-0017
+contributors: []
+breaking: false
+internal: false
+order: 5
+---
+
+Wheel and source-distribution checks require the PEP 561 marker, all schema resources, and the SSMD 0.9 dependency range. Installed-package smoke coverage accepts strict 0.9 input and rejects an explicit 0.8 header.

utterplan-0.3.1/.ledger/releaseledger/data/ledgers/main/releases/0.3.0/entries/entry-0006.md

@@ -0,0 +1,29 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0006
+release_version: 0.3.0
+kind: docs
+summary: Documented the 0.2-to-0.3 migration paths
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - docs/consumer-guide.md
+  - docs/python-api.md
+  - docs/format.md
+issues: []
+prs: []
+sources:
+  - tl:task-0017
+contributors: []
+breaking: false
+internal: false
+order: 6
+---
+
+The migration guide separates SSMD source conversion with ssmd migrate from UtterPlan JSON schema migration. It documents the plain Python input default, SSMDConfig renames, and continued v1/v2 plan migration to schema v3.

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

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 4
+version: 0.3.0
+status: released
+history_state: curated
+title: null
+released_at: "2026-09-24"
+previous_version: 0.2.0
+cancel_reason: null
+superseded_by: null
+changelog_file: docs/changelog.md
+boundary_ref: null
+source_refs: []
+source_count: null
+entry_count: 6
+artifact_count: 0
+git_base_ref: v0.2.0
+git_base_sha: 215d3a4b43ccaadbf50cb40b752ae30a5b4f39e5
+git_head_ref: HEAD
+git_head_sha: 49023f0470950eb3b1ff9a1c9a928bac5a47575e
+git_range: 215d3a4b43ccaadbf50cb40b752ae30a5b4f39e5..49023f0470950eb3b1ff9a1c9a928bac5a47575e
+git_commit_count: 1
+---