utterplan 0.1.3__tar.gz → 0.2.0__tar.gz

{utterplan-0.1.3 → utterplan-0.2.0}/.gitignore

@@ -219,3 +219,6 @@ __marimo__/
 context_utterplan*.*
 
 utterplan/_version.py
+
+# Generated outputs from the runnable examples
+examples/*.utterplan.json

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

@@ -29,3 +29,10 @@
 {"data":{"added_source_refs":[],"fields":["internal","kind"],"removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0005","event":"entry.updated","event_id":"event-0029","record_revisions":{"entry:0.1.3/entry-0005":2},"release_version":"0.1.3","schema_version":2}
 {"data":{"updated_rows":3},"event":"audit.updated","event_id":"event-0030","record_revisions":{"commit_audit_sheet":6},"release_version":"0.1.3","schema_version":2}
 {"data":{"released_at":"2026-09-19"},"event":"release.finalized","event_id":"event-0031","record_revisions":{"release:0.1.3":11},"release_version":"0.1.3","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0032","record_revisions":{"release:0.2.0":1},"release_version":"0.2.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-0033","record_revisions":{"release:0.2.0":2},"release_version":"0.2.0","schema_version":2}
+{"data":{"row_count":3},"event":"audit.created","event_id":"event-0034","record_revisions":{"commit_audit_sheet":1},"release_version":"0.2.0","schema_version":2}
+{"data":{"updated_rows":3},"event":"audit.updated","event_id":"event-0035","record_revisions":{"commit_audit_sheet":2},"release_version":"0.2.0","schema_version":2}
+{"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}

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

@@ -0,0 +1,241 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 4
+release_version: 0.2.0
+git_base_ref: v0.1.3
+git_base_sha: 35a631ed89a676484546d62bccf08203f93b01e9
+git_head_ref: HEAD
+git_head_sha: 9637182acbf51763706e1047283b6df27def4bb8
+git_range: 35a631ed89a676484546d62bccf08203f93b01e9..9637182acbf51763706e1047283b6df27def4bb8
+commit_count: 3
+rows:
+  - sha: e49a6ddc97c789574098a635fc823da885b48439
+    source_ref: git:e49a6ddc97c789574098a635fc823da885b48439
+    short_sha: e49a6dd
+    changed_paths:
+      - .gitignore
+      - examples/basic.py
+      - examples/chapter.ssmd
+      - examples/compile_file.py
+      - examples/inspect_plan.py
+      - examples/multilingual.py
+      - examples/ssmd.py
+      - examples/ssmd_example.py
+    stats:
+      files_changed: 8
+      insertions: 93
+      deletions: 19
+    inspected: true
+    inspected_paths:
+      - .gitignore
+      - examples/basic.py
+      - examples/chapter.ssmd
+      - examples/compile_file.py
+      - examples/inspect_plan.py
+      - examples/multilingual.py
+      - examples/ssmd.py
+      - examples/ssmd_example.py
+    observed_behavior:
+      Example scripts now run through main() entry points. basic.py,
+      compile_file.py, and inspect_plan.py gained argparse interfaces with defaults
+      resolved next to the script and outputs written beside it. multilingual.py demonstrates
+      inline SSMD language switching. examples/ssmd.py was replaced by examples/ssmd_example.py,
+      examples/chapter.ssmd was added as sample SSMD input, and generated examples/*.utterplan.json
+      outputs are excluded from git.
+    public_impact: docs
+    decision: accepted
+    stale: false
+    evidence_subject: "fix: examples"
+    target_entry_id: entry-0003
+    notes:
+      Examples-only change with documentation impact; covered by the fixed entry
+      for the examples rework.
+  - sha: c52aa684cc872d348d90972001a8c5194ae7c7f8
+    source_ref: git:c52aa684cc872d348d90972001a8c5194ae7c7f8
+    short_sha: c52aa68
+    changed_paths:
+      - 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/index.md
+      - docs/pykokoro-integration.md
+      - docs/python-api.md
+      - pyproject.toml
+      - spec/schemas/v2.schema.json
+      - spec/utterplan.schema.json
+      - tests/golden/basic_en.utterplan.json
+      - tests/golden/directives.utterplan.json
+      - tests/golden/markers.utterplan.json
+      - tests/golden/multilingual.utterplan.json
+      - tests/golden/parenthetical.utterplan.json
+      - tests/golden/spokenform_offsets.utterplan.json
+      - tests/golden/ssmd_breaks.utterplan.json
+      - tests/test_cli.py
+      - tests/test_explain.py
+      - tests/test_format.py
+      - tests/test_linguistics.py
+      - tests/test_migration_framework.py
+      - tests/test_public_identity.py
+      - tests/test_schema_history.py
+      - tests/test_schema_registry.py
+      - utterplan/__init__.py
+      - utterplan/cli.py
+      - utterplan/explain.py
+      - utterplan/hashing.py
+      - utterplan/linguistics.py
+      - utterplan/migrations/__init__.py
+      - utterplan/migrations/registry.py
+      - utterplan/migrations/v1_to_v2.py
+      - utterplan/model.py
+      - utterplan/planner.py
+      - utterplan/schema_registry.py
+      - utterplan/schemas/v2.schema.json
+      - utterplan/units.py
+      - utterplan/utterplan.schema.json
+      - utterplan/versioning.py
+    stats:
+      files_changed: 44
+      insertions: 1714
+      deletions: 215
+    inspected: true
+    inspected_paths:
+      - 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/index.md
+      - docs/pykokoro-integration.md
+      - docs/python-api.md
+      - pyproject.toml
+      - spec/schemas/v2.schema.json
+      - spec/utterplan.schema.json
+      - tests/golden/basic_en.utterplan.json
+      - tests/golden/directives.utterplan.json
+      - tests/golden/markers.utterplan.json
+      - tests/golden/multilingual.utterplan.json
+      - tests/golden/parenthetical.utterplan.json
+      - tests/golden/spokenform_offsets.utterplan.json
+      - tests/golden/ssmd_breaks.utterplan.json
+      - tests/test_cli.py
+      - tests/test_explain.py
+      - tests/test_format.py
+      - tests/test_linguistics.py
+      - tests/test_migration_framework.py
+      - tests/test_public_identity.py
+      - tests/test_schema_history.py
+      - tests/test_schema_registry.py
+      - utterplan/__init__.py
+      - utterplan/cli.py
+      - utterplan/explain.py
+      - utterplan/hashing.py
+      - utterplan/linguistics.py
+      - utterplan/migrations/__init__.py
+      - utterplan/migrations/registry.py
+      - utterplan/migrations/v1_to_v2.py
+      - utterplan/model.py
+      - utterplan/planner.py
+      - utterplan/schema_registry.py
+      - utterplan/schemas/v2.schema.json
+      - utterplan/units.py
+      - utterplan/utterplan.schema.json
+      - utterplan/versioning.py
+    observed_behavior:
+      Serialized plans gain a v2 schema that embeds token annotations
+      with lemma, pos, tag, and morph fields plus linguistic run records carrying provider,
+      model, provider_version, and model_version provenance. Unit content hashes move
+      to the utterplan-unit-v2 payload that includes tokens. A registered v1-to-v2 migration
+      upgrades older files and the schema registry keeps v1 frozen. pyproject gains
+      a spacy optional extra. The inspect token view and detailed explain output report
+      provider and model provenance and per-segment tokens.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: add v2 with spacy tokens embedded"
+    target_entry_id: entry-0001
+    notes:
+      "Two entries describe this commit: the schema v2 feature owns the git source
+      ref and the inspect/explain output detail references it as supporting source."
+  - sha: 9637182acbf51763706e1047283b6df27def4bb8
+    source_ref: git:9637182acbf51763706e1047283b6df27def4bb8
+    short_sha: "9637182"
+    changed_paths:
+      - docs/cli.md
+      - docs/consumer-guide.md
+      - docs/getting-started.md
+      - docs/pykokoro-integration.md
+      - docs/python-api.md
+      - spec/schemas/v2.schema.json
+      - spec/utterplan.schema.json
+      - tests/golden/basic_en.utterplan.json
+      - tests/golden/directives.utterplan.json
+      - tests/golden/markers.utterplan.json
+      - tests/golden/multilingual.utterplan.json
+      - tests/golden/parenthetical.utterplan.json
+      - tests/golden/spokenform_offsets.utterplan.json
+      - tests/golden/ssmd_breaks.utterplan.json
+      - tests/test_cli.py
+      - tests/test_format.py
+      - tests/test_linguistics.py
+      - tests/test_schema_history.py
+      - utterplan/explain.py
+      - utterplan/hashing.py
+      - utterplan/migrations/v1_to_v2.py
+      - utterplan/model.py
+      - utterplan/planner.py
+      - utterplan/schemas/v2.schema.json
+      - utterplan/utterplan.schema.json
+    stats:
+      files_changed: 25
+      insertions: 159
+      deletions: 193
+    inspected: true
+    inspected_paths:
+      - docs/cli.md
+      - docs/consumer-guide.md
+      - docs/getting-started.md
+      - docs/pykokoro-integration.md
+      - docs/python-api.md
+      - spec/schemas/v2.schema.json
+      - spec/utterplan.schema.json
+      - tests/golden/basic_en.utterplan.json
+      - tests/golden/directives.utterplan.json
+      - tests/golden/markers.utterplan.json
+      - tests/golden/multilingual.utterplan.json
+      - tests/golden/parenthetical.utterplan.json
+      - tests/golden/spokenform_offsets.utterplan.json
+      - tests/golden/ssmd_breaks.utterplan.json
+      - tests/test_cli.py
+      - tests/test_format.py
+      - tests/test_linguistics.py
+      - tests/test_schema_history.py
+      - utterplan/explain.py
+      - utterplan/hashing.py
+      - utterplan/migrations/v1_to_v2.py
+      - utterplan/model.py
+      - utterplan/planner.py
+      - utterplan/schemas/v2.schema.json
+      - utterplan/utterplan.schema.json
+    observed_behavior:
+      "Formatter-only normalization: golden fixtures compacted to single-line
+      JSON arrays, schema required arrays expanded and rewrapped, and Python modules,
+      tests, and migrations rewrapped to formatter style. Hashing, validation, migration,
+      and planning behavior are unchanged."
+    public_impact: none
+    decision: internal
+    stale: false
+    evidence_subject: "chore: pre-commit"
+    target_entry_id: entry-0004
+    notes:
+      Formatting-only change with no user-visible behavior; represented by an internal
+      entry and excluded from the public changelog.

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

@@ -0,0 +1,74 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: 0.2.0
+kind: added
+summary:
+  Added schema version 2 with embedded token annotations, linguistic run provenance,
+  and a v1-to-v2 migration
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:c52aa684cc872d348d90972001a8c5194ae7c7f8
+paths:
+  - 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/index.md
+  - docs/pykokoro-integration.md
+  - docs/python-api.md
+  - pyproject.toml
+  - spec/schemas/v2.schema.json
+  - spec/utterplan.schema.json
+  - tests/golden/basic_en.utterplan.json
+  - tests/golden/directives.utterplan.json
+  - tests/golden/markers.utterplan.json
+  - tests/golden/multilingual.utterplan.json
+  - tests/golden/parenthetical.utterplan.json
+  - tests/golden/spokenform_offsets.utterplan.json
+  - tests/golden/ssmd_breaks.utterplan.json
+  - tests/test_cli.py
+  - tests/test_explain.py
+  - tests/test_format.py
+  - tests/test_linguistics.py
+  - tests/test_migration_framework.py
+  - tests/test_public_identity.py
+  - tests/test_schema_history.py
+  - tests/test_schema_registry.py
+  - utterplan/__init__.py
+  - utterplan/cli.py
+  - utterplan/explain.py
+  - utterplan/hashing.py
+  - utterplan/linguistics.py
+  - utterplan/migrations/__init__.py
+  - utterplan/migrations/registry.py
+  - utterplan/migrations/v1_to_v2.py
+  - utterplan/model.py
+  - utterplan/planner.py
+  - utterplan/schema_registry.py
+  - utterplan/schemas/v2.schema.json
+  - utterplan/units.py
+  - utterplan/utterplan.schema.json
+  - utterplan/versioning.py
+issues: []
+prs: []
+sources:
+  - git:c52aa684cc872d348d90972001a8c5194ae7c7f8
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 1
+---
+
+Serialized plans can now be written as schema version 2, which embeds token annotations with lemma, pos, tag, and morph fields and records linguistic run provenance (provider, model, provider version, model version). Unit content hashes move to the utterplan-unit-v2 payload that includes tokens. Older v1 files upgrade through the registered v1-to-v2 migration while v1 stays frozen, and spaCy support is available through the spacy optional extra.

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

@@ -0,0 +1,31 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0002
+release_version: 0.2.0
+kind: changed
+summary:
+  Improved inspect and explain output with token annotations and linguistic
+  run metadata
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - utterplan/cli.py
+  - utterplan/explain.py
+issues: []
+prs: []
+sources:
+  - git:c52aa684cc872d348d90972001a8c5194ae7c7f8
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 2
+---
+
+The inspect token view reports provider and model provenance alongside per-token lemma, pos, tag, and morph values. Detailed explain output lists each segment's tokens and the linguistic run information behind them.

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

@@ -0,0 +1,38 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0003
+release_version: 0.2.0
+kind: fixed
+summary:
+  Fixed runnable examples with command-line arguments, path-safe outputs, and
+  a dedicated SSMD example script
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:e49a6ddc97c789574098a635fc823da885b48439
+paths:
+  - .gitignore
+  - examples/basic.py
+  - examples/chapter.ssmd
+  - examples/compile_file.py
+  - examples/inspect_plan.py
+  - examples/multilingual.py
+  - examples/ssmd.py
+  - examples/ssmd_example.py
+issues: []
+prs: []
+sources:
+  - git:e49a6ddc97c789574098a635fc823da885b48439
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 3
+---
+
+Example scripts expose main() entry points with argparse interfaces, resolve default paths next to the script instead of the current working directory, and write generated plans beside the source. examples/ssmd.py is replaced by examples/ssmd_example.py, examples/chapter.ssmd provides sample SSMD input, and generated examples/\*.utterplan.json outputs are excluded from git.

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

@@ -0,0 +1,53 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0004
+release_version: 0.2.0
+kind: internal
+summary: Improved formatting in schema files, golden fixtures, and Python modules
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:9637182acbf51763706e1047283b6df27def4bb8
+paths:
+  - docs/cli.md
+  - docs/consumer-guide.md
+  - docs/getting-started.md
+  - docs/pykokoro-integration.md
+  - docs/python-api.md
+  - spec/schemas/v2.schema.json
+  - spec/utterplan.schema.json
+  - tests/golden/basic_en.utterplan.json
+  - tests/golden/directives.utterplan.json
+  - tests/golden/markers.utterplan.json
+  - tests/golden/multilingual.utterplan.json
+  - tests/golden/parenthetical.utterplan.json
+  - tests/golden/spokenform_offsets.utterplan.json
+  - tests/golden/ssmd_breaks.utterplan.json
+  - tests/test_cli.py
+  - tests/test_format.py
+  - tests/test_linguistics.py
+  - tests/test_schema_history.py
+  - utterplan/explain.py
+  - utterplan/hashing.py
+  - utterplan/migrations/v1_to_v2.py
+  - utterplan/model.py
+  - utterplan/planner.py
+  - utterplan/schemas/v2.schema.json
+  - utterplan/utterplan.schema.json
+issues: []
+prs: []
+sources:
+  - git:9637182acbf51763706e1047283b6df27def4bb8
+contributors:
+  - "@holgern"
+breaking: false
+internal: true
+order: 4
+---
+
+Formatter-only normalization. Golden fixtures were compacted to single-line JSON arrays, schema required arrays expanded and rewrapped, and Python sources rewrapped. No serialization, validation, migration, or planning behavior changed.

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

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 4
+version: 0.2.0
+status: released
+history_state: curated
+title: null
+released_at: "2026-09-22"
+previous_version: 0.1.3
+cancel_reason: null
+superseded_by: null
+changelog_file: null
+boundary_ref: null
+source_refs: []
+source_count: null
+entry_count: 4
+artifact_count: 0
+git_base_ref: v0.1.3
+git_base_sha: 35a631ed89a676484546d62bccf08203f93b01e9
+git_head_ref: HEAD
+git_head_sha: 9637182acbf51763706e1047283b6df27def4bb8
+git_range: 35a631ed89a676484546d62bccf08203f93b01e9..9637182acbf51763706e1047283b6df27def4bb8
+git_commit_count: 3
+---

utterplan-0.2.0/.ledger/releaseledger/work/0.2.0/audit-decisions.yaml

@@ -0,0 +1,131 @@
+rows:
+  - sha: e49a6ddc97c789574098a635fc823da885b48439
+    inspected: true
+    inspected_paths:
+      - .gitignore
+      - examples/basic.py
+      - examples/chapter.ssmd
+      - examples/compile_file.py
+      - examples/inspect_plan.py
+      - examples/multilingual.py
+      - examples/ssmd.py
+      - examples/ssmd_example.py
+    observed_behavior:
+      "Example scripts now run through main() entry points. basic.py,
+      compile_file.py, and inspect_plan.py gained argparse interfaces with defaults resolved
+      next to the script and outputs written beside it. multilingual.py demonstrates inline
+      SSMD language switching. examples/ssmd.py was replaced by examples/ssmd_example.py,
+      examples/chapter.ssmd was added as sample SSMD input, and generated examples/*.utterplan.json
+      outputs are excluded from git."
+    public_impact: docs
+    decision: accepted
+    target_entry_key: null
+    target_entry_id: null
+    notes:
+      "Examples-only change with documentation impact; covered by the fixed entry
+      for the examples rework."
+    stale: false
+  - sha: c52aa684cc872d348d90972001a8c5194ae7c7f8
+    inspected: true
+    inspected_paths:
+      - 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/index.md
+      - docs/pykokoro-integration.md
+      - docs/python-api.md
+      - pyproject.toml
+      - spec/schemas/v2.schema.json
+      - spec/utterplan.schema.json
+      - tests/golden/basic_en.utterplan.json
+      - tests/golden/directives.utterplan.json
+      - tests/golden/markers.utterplan.json
+      - tests/golden/multilingual.utterplan.json
+      - tests/golden/parenthetical.utterplan.json
+      - tests/golden/spokenform_offsets.utterplan.json
+      - tests/golden/ssmd_breaks.utterplan.json
+      - tests/test_cli.py
+      - tests/test_explain.py
+      - tests/test_format.py
+      - tests/test_linguistics.py
+      - tests/test_migration_framework.py
+      - tests/test_public_identity.py
+      - tests/test_schema_history.py
+      - tests/test_schema_registry.py
+      - utterplan/__init__.py
+      - utterplan/cli.py
+      - utterplan/explain.py
+      - utterplan/hashing.py
+      - utterplan/linguistics.py
+      - utterplan/migrations/__init__.py
+      - utterplan/migrations/registry.py
+      - utterplan/migrations/v1_to_v2.py
+      - utterplan/model.py
+      - utterplan/planner.py
+      - utterplan/schema_registry.py
+      - utterplan/schemas/v2.schema.json
+      - utterplan/units.py
+      - utterplan/utterplan.schema.json
+      - utterplan/versioning.py
+    observed_behavior:
+      "Serialized plans gain a v2 schema that embeds token annotations
+      with lemma, pos, tag, and morph fields plus linguistic run records carrying provider,
+      model, provider_version, and model_version provenance. Unit content hashes move
+      to the utterplan-unit-v2 payload that includes tokens. A registered v1-to-v2 migration
+      upgrades older files and the schema registry keeps v1 frozen. pyproject gains a
+      spacy optional extra. The inspect token view and detailed explain output report
+      provider and model provenance and per-segment tokens."
+    public_impact: public
+    decision: accepted
+    target_entry_key: null
+    target_entry_id: null
+    notes:
+      "Two entries describe this commit: the schema v2 feature owns the git source
+      ref and the inspect/explain output detail references it as supporting source."
+    stale: false
+  - sha: 9637182acbf51763706e1047283b6df27def4bb8
+    inspected: true
+    inspected_paths:
+      - docs/cli.md
+      - docs/consumer-guide.md
+      - docs/getting-started.md
+      - docs/pykokoro-integration.md
+      - docs/python-api.md
+      - spec/schemas/v2.schema.json
+      - spec/utterplan.schema.json
+      - tests/golden/basic_en.utterplan.json
+      - tests/golden/directives.utterplan.json
+      - tests/golden/markers.utterplan.json
+      - tests/golden/multilingual.utterplan.json
+      - tests/golden/parenthetical.utterplan.json
+      - tests/golden/spokenform_offsets.utterplan.json
+      - tests/golden/ssmd_breaks.utterplan.json
+      - tests/test_cli.py
+      - tests/test_format.py
+      - tests/test_linguistics.py
+      - tests/test_schema_history.py
+      - utterplan/explain.py
+      - utterplan/hashing.py
+      - utterplan/migrations/v1_to_v2.py
+      - utterplan/model.py
+      - utterplan/planner.py
+      - utterplan/schemas/v2.schema.json
+      - utterplan/utterplan.schema.json
+    observed_behavior:
+      "Formatter-only normalization: golden fixtures compacted to single-line
+      JSON arrays, schema required arrays expanded and rewrapped, and Python modules,
+      tests, and migrations rewrapped to formatter style. Hashing, validation, migration,
+      and planning behavior are unchanged."
+    public_impact: none
+    decision: internal
+    target_entry_key: null
+    target_entry_id: null
+    notes:
+      "Formatting-only change with no user-visible behavior; represented by an internal
+      entry and excluded from the public changelog."
+    stale: false