utterplan 0.3.2__tar.gz → 0.3.4__tar.gz

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

@@ -54,3 +54,13 @@
 {"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}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0057","record_revisions":{"release:0.3.3":1},"release_version":"0.3.3","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-0058","record_revisions":{"release:0.3.3":2},"release_version":"0.3.3","schema_version":2}
+{"data":{"row_count":2},"event":"audit.created","event_id":"event-0059","record_revisions":{"commit_audit_sheet":1},"release_version":"0.3.3","schema_version":2}
+{"data":{"updated_rows":2},"event":"audit.updated","event_id":"event-0060","record_revisions":{"commit_audit_sheet":2},"release_version":"0.3.3","schema_version":2}
+{"data":{"entry_ids":["entry-0001","entry-0002"],"synced_audit_rows":2},"event":"entry.batch_added","event_id":"event-0061","record_revisions":{"commit_audit_sheet":3,"entry:0.3.3/entry-0001":1,"entry:0.3.3/entry-0002":1,"release:0.3.3":3},"release_version":"0.3.3","schema_version":2}
+{"data":{"released_at":"2026-10-03"},"event":"release.finalized","event_id":"event-0062","record_revisions":{"release:0.3.3":4},"release_version":"0.3.3","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0063","record_revisions":{"release:0.3.4":1},"release_version":"0.3.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-0064","record_revisions":{"release:0.3.4":2},"release_version":"0.3.4","schema_version":2}
+{"data":{"row_count":0},"event":"audit.created","event_id":"event-0065","record_revisions":{"commit_audit_sheet":1},"release_version":"0.3.4","schema_version":2}
+{"data":{"kind":"added","status":"accepted"},"entry_id":"entry-0001","event":"entry.added","event_id":"event-0066","record_revisions":{"entry:0.3.4/entry-0001":1,"release:0.3.4":3},"release_version":"0.3.4","schema_version":2}

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

@@ -0,0 +1,90 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 3
+release_version: 0.3.3
+git_base_ref: v0.3.2
+git_base_sha: c2566055d7d5a93794bd9a30b06db862b0fa7bde
+git_head_ref: HEAD
+git_head_sha: ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+git_range: c2566055d7d5a93794bd9a30b06db862b0fa7bde..ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+commit_count: 2
+rows:
+  - sha: 66e2d83fc06ee2d46bff0aca0a5920c5caf8c8e0
+    source_ref: git:66e2d83fc06ee2d46bff0aca0a5920c5caf8c8e0
+    short_sha: 66e2d83
+    changed_paths:
+      - README.md
+      - docs/architecture.md
+      - docs/cli.md
+      - docs/python-api.md
+      - tests/fixtures/canonical_consumer_contract.expected.json
+      - tests/fixtures/canonical_consumer_contract.ssmd
+      - tests/test_cli.py
+      - tests/test_compiler.py
+      - tests/test_consumer_contract.py
+      - tests/test_consumer_readiness.py
+      - tests/test_import_boundaries.py
+      - tests/test_public_identity.py
+      - utterplan/__init__.py
+      - utterplan/cli.py
+      - utterplan/compiler.py
+      - utterplan/planner.py
+      - utterplan/preparation.py
+    stats:
+      files_changed: 17
+      insertions: 875
+      deletions: 74
+    inspected: true
+    inspected_paths:
+      - README.md
+      - docs/architecture.md
+      - docs/cli.md
+      - docs/python-api.md
+      - tests/fixtures/canonical_consumer_contract.expected.json
+      - tests/fixtures/canonical_consumer_contract.ssmd
+      - tests/test_cli.py
+      - tests/test_compiler.py
+      - tests/test_consumer_contract.py
+      - tests/test_consumer_readiness.py
+      - tests/test_import_boundaries.py
+      - tests/test_public_identity.py
+      - utterplan/__init__.py
+      - utterplan/cli.py
+      - utterplan/compiler.py
+      - utterplan/planner.py
+      - utterplan/preparation.py
+    observed_behavior:
+      Added the public compile_document API for one SSMD or explicitly
+      selected plain-text document, including immutable compile results, optional preparation
+      traces, authoritative header-language handling, and canonical consumer-contract
+      coverage.
+    public_impact: public
+    decision: accepted
+    stale: false
+    evidence_subject: "feat: lanf support in header"
+    target_entry_key: canonical-single-document-compiler
+    target_entry_id: entry-0001
+    notes: Reviewed implementation, documentation, fixtures, and tests.
+  - sha: ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+    source_ref: git:ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+    short_sha: ac797e4
+    changed_paths:
+      - utterplan/cli.py
+    stats:
+      files_changed: 1
+      insertions: 4
+      deletions: 4
+    inspected: true
+    inspected_paths:
+      - utterplan/cli.py
+    observed_behavior:
+      Renamed the local validation result variable to compile_result
+      without changing behavior.
+    public_impact: internal
+    decision: internal
+    stale: false
+    evidence_subject: "chore: fix mypy"
+    target_entry_id: entry-0002
+    notes: Mypy-oriented naming-only cleanup; excluded from public notes.

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

@@ -0,0 +1,45 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: 0.3.3
+kind: added
+summary:
+  Added canonical single-document compilation with plain-text support and preparation
+  traces
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:66e2d83fc06ee2d46bff0aca0a5920c5caf8c8e0
+paths:
+  - README.md
+  - docs/architecture.md
+  - docs/cli.md
+  - docs/python-api.md
+  - tests/fixtures/canonical_consumer_contract.expected.json
+  - tests/fixtures/canonical_consumer_contract.ssmd
+  - tests/test_cli.py
+  - tests/test_compiler.py
+  - tests/test_consumer_contract.py
+  - tests/test_consumer_readiness.py
+  - tests/test_import_boundaries.py
+  - tests/test_public_identity.py
+  - utterplan/__init__.py
+  - utterplan/cli.py
+  - utterplan/compiler.py
+  - utterplan/planner.py
+  - utterplan/preparation.py
+issues: []
+prs: []
+sources:
+  - git:66e2d83fc06ee2d46bff0aca0a5920c5caf8c8e0
+contributors:
+  - "@holgern"
+breaking: false
+internal: false
+order: 1
+---

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

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0002
+release_version: 0.3.3
+kind: internal
+summary: Changed CLI validation variable naming for mypy clarity
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+paths:
+  - utterplan/cli.py
+issues: []
+prs: []
+sources:
+  - git:ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+contributors:
+  - "@holgern"
+breaking: false
+internal: true
+order: 2
+---

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

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 4
+version: 0.3.3
+status: released
+history_state: curated
+title: null
+released_at: "2026-10-03"
+previous_version: 0.3.2
+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.2
+git_base_sha: c2566055d7d5a93794bd9a30b06db862b0fa7bde
+git_head_ref: HEAD
+git_head_sha: ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+git_range: c2566055d7d5a93794bd9a30b06db862b0fa7bde..ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+git_commit_count: 2
+---

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

@@ -0,0 +1,13 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 1
+release_version: 0.3.4
+git_base_ref: v0.3.3
+git_base_sha: 0e4e0751e2b8a5d5c0592a3efbda5a31f653c158
+git_head_ref: HEAD
+git_head_sha: 0e4e0751e2b8a5d5c0592a3efbda5a31f653c158
+git_range: 0e4e0751e2b8a5d5c0592a3efbda5a31f653c158..0e4e0751e2b8a5d5c0592a3efbda5a31f653c158
+commit_count: 0
+rows: []

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

@@ -0,0 +1,34 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: 0.3.4
+kind: added
+summary: Added typed planner progress events and reused unchanged linguistic analyses
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - tl:task-0021
+paths:
+  - utterplan/progress.py
+  - utterplan/planner.py
+  - utterplan/linguistics.py
+  - utterplan/compiler.py
+  - tests/test_progress.py
+  - tests/test_linguistics.py
+  - docs/python-api.md
+  - README.md
+issues: []
+prs: []
+sources: []
+contributors: []
+breaking: false
+internal: false
+order: 1
+---
+
+The optional synchronous callback reports planner phases, provider runs, and actual spaCy model loads without changing plan serialization; equivalent analyses are reused where safe.

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

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 3
+version: 0.3.4
+status: planned
+history_state: curated
+title: null
+released_at: null
+previous_version: 0.3.3
+cancel_reason: null
+superseded_by: null
+changelog_file: null
+boundary_ref: null
+source_refs: []
+source_count: null
+entry_count: 1
+artifact_count: 0
+git_base_ref: v0.3.3
+git_base_sha: 0e4e0751e2b8a5d5c0592a3efbda5a31f653c158
+git_head_ref: HEAD
+git_head_sha: 0e4e0751e2b8a5d5c0592a3efbda5a31f653c158
+git_range: 0e4e0751e2b8a5d5c0592a3efbda5a31f653c158..0e4e0751e2b8a5d5c0592a3efbda5a31f653c158
+git_commit_count: 0
+---

utterplan-0.3.4/.ledger/releaseledger/work/0.3.3/audit-decisions.yaml

@@ -0,0 +1,39 @@
+rows:
+  - sha: 66e2d83fc06ee2d46bff0aca0a5920c5caf8c8e0
+    inspected: true
+    inspected_paths:
+      - README.md
+      - docs/architecture.md
+      - docs/cli.md
+      - docs/python-api.md
+      - tests/fixtures/canonical_consumer_contract.expected.json
+      - tests/fixtures/canonical_consumer_contract.ssmd
+      - tests/test_cli.py
+      - tests/test_compiler.py
+      - tests/test_consumer_contract.py
+      - tests/test_consumer_readiness.py
+      - tests/test_import_boundaries.py
+      - tests/test_public_identity.py
+      - utterplan/__init__.py
+      - utterplan/cli.py
+      - utterplan/compiler.py
+      - utterplan/planner.py
+      - utterplan/preparation.py
+    observed_behavior: "Added the public compile_document API for one SSMD or explicitly selected plain-text document, including immutable compile results, optional preparation traces, authoritative header-language handling, and canonical consumer-contract coverage."
+    public_impact: public
+    decision: accepted
+    target_entry_key: canonical-single-document-compiler
+    target_entry_id: null
+    notes: "Reviewed implementation, documentation, fixtures, and tests."
+    stale: false
+  - sha: ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+    inspected: true
+    inspected_paths:
+      - utterplan/cli.py
+    observed_behavior: "Renamed the local validation result variable to compile_result without changing behavior."
+    public_impact: internal
+    decision: internal
+    target_entry_key: null
+    target_entry_id: null
+    notes: "Mypy-oriented naming-only cleanup; excluded from public notes."
+    stale: false

utterplan-0.3.4/.ledger/releaseledger/work/0.3.3/audit.yaml

@@ -0,0 +1,61 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 1
+release_version: 0.3.3
+git_base_ref: v0.3.2
+git_base_sha: c2566055d7d5a93794bd9a30b06db862b0fa7bde
+git_head_ref: HEAD
+git_head_sha: ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+git_range: c2566055d7d5a93794bd9a30b06db862b0fa7bde..ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+commit_count: 2
+rows:
+  - sha: 66e2d83fc06ee2d46bff0aca0a5920c5caf8c8e0
+    source_ref: git:66e2d83fc06ee2d46bff0aca0a5920c5caf8c8e0
+    short_sha: 66e2d83
+    changed_paths:
+      - README.md
+      - docs/architecture.md
+      - docs/cli.md
+      - docs/python-api.md
+      - tests/fixtures/canonical_consumer_contract.expected.json
+      - tests/fixtures/canonical_consumer_contract.ssmd
+      - tests/test_cli.py
+      - tests/test_compiler.py
+      - tests/test_consumer_contract.py
+      - tests/test_consumer_readiness.py
+      - tests/test_import_boundaries.py
+      - tests/test_public_identity.py
+      - utterplan/__init__.py
+      - utterplan/cli.py
+      - utterplan/compiler.py
+      - utterplan/planner.py
+      - utterplan/preparation.py
+    stats:
+      files_changed: 17
+      insertions: 875
+      deletions: 74
+    inspected: false
+    inspected_paths: []
+    observed_behavior: ""
+    public_impact: unknown
+    decision: needs_review
+    stale: false
+    evidence_subject: "feat: lanf support in header"
+  - sha: ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+    source_ref: git:ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+    short_sha: ac797e4
+    changed_paths:
+      - utterplan/cli.py
+    stats:
+      files_changed: 1
+      insertions: 4
+      deletions: 4
+    inspected: false
+    inspected_paths: []
+    observed_behavior: ""
+    public_impact: unknown
+    decision: needs_review
+    stale: false
+    evidence_subject: "chore: fix mypy"

utterplan-0.3.4/.ledger/releaseledger/work/0.3.3/entries.yaml

@@ -0,0 +1,54 @@
+schema: releaseledger.entry-batch.v1
+operation: create
+schema_version: 1
+object_type: release_entry_batch
+release_version: 0.3.3
+git_base_ref: c2566055d7d5a93794bd9a30b06db862b0fa7bde
+git_base_sha: c2566055d7d5a93794bd9a30b06db862b0fa7bde
+git_head_ref: ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+git_head_sha: ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+include_merges: nontrivial
+entries:
+  - kind: added
+    summary: "Added canonical single-document compilation with plain-text support and preparation traces"
+    status: accepted
+    source_refs:
+      - git:66e2d83fc06ee2d46bff0aca0a5920c5caf8c8e0
+    paths:
+      - README.md
+      - docs/architecture.md
+      - docs/cli.md
+      - docs/python-api.md
+      - tests/fixtures/canonical_consumer_contract.expected.json
+      - tests/fixtures/canonical_consumer_contract.ssmd
+      - tests/test_cli.py
+      - tests/test_compiler.py
+      - tests/test_consumer_contract.py
+      - tests/test_consumer_readiness.py
+      - tests/test_import_boundaries.py
+      - tests/test_public_identity.py
+      - utterplan/__init__.py
+      - utterplan/cli.py
+      - utterplan/compiler.py
+      - utterplan/planner.py
+      - utterplan/preparation.py
+    sources:
+      - git:66e2d83fc06ee2d46bff0aca0a5920c5caf8c8e0
+    prs: []
+    issues: []
+    contributors:
+      - "@holgern"
+  - kind: internal
+    summary: "Changed CLI validation variable naming for mypy clarity"
+    status: accepted
+    internal: true
+    source_refs:
+      - git:ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+    paths:
+      - utterplan/cli.py
+    sources:
+      - git:ac797e4a55e4eef9a8e9c76112f5ebee5ad9e2b8
+    prs: []
+    issues: []
+    contributors:
+      - "@holgern"