utterplan 0.6.2__tar.gz → 0.6.4__tar.gz

utterplan-0.6.4/MANIFEST.in

@@ -0,0 +1,2 @@
+prune .ledger
+include docs/ssmdoc.md

{utterplan-0.6.2 → utterplan-0.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: utterplan
-Version: 0.6.2
+Version: 0.6.4
 Summary: Engine-independent text-to-speech planning compiler and interchange format
 Author-email: Holger Nahrstaedt <nahrstaedt@gmail.com>
 License:                                  Apache License
@@ -285,6 +285,16 @@ utterplan compile-many examples/*.ssmd --output-dir build/plans
 
 This writes one `.utterplan.toml` per source plus an atomically refreshed `compile-report.toml`. Terminal diagnostics default to warnings; `--diagnostics all` also prints informational records, while `--diagnostics none` suppresses non-failure details. Failures are always reported, and the operational report retains every diagnostic. Use `--fail-fast` to skip later inputs after a failure, `--force` to replace existing plans, or `--report PATH` to choose another report location.
 
+## Compile an SSMDDoc workspace
+
+Compile one editable `.ssmdoc` directory as one SSMD document and one FlowPlan:
+
+```bash
+utterplan compile-document story.ssmdoc
+```
+
+By default this writes `story.ssmdoc/.readio/utterplan/document-0001.utterplan.toml` and a `compile-report.toml`. The current `document.ssmd.md` is authoritative even if its manifest digest is stale; UtterPlan leaves the source and manifest untouched. This is separate from the multi-chapter SSMDBook workflow below. See the [SSMDDoc workspace guide](docs/ssmdoc.md) for manifest safety, output options, and the Python API.
+
 Compile a selected chapter range directly from an editable SSMDBook workspace:
 
 ```bash
@@ -353,6 +363,41 @@ creates or refreshes engine-backed profiles, then preflights and renders the
 resulting RenderPlans. The single-file `utterplan render-plan` command remains the
 low-level projection and deterministic replan primitive.
 
+When VoiceRender reports `preflight.replan`, use the new `replan-book` command to
+refine the exact active chapter plan. The operation reads the RenderProfile snapshot
+from the selected variant, writes a fingerprinted child RenderPlan, and updates only
+that chapter's active set entry. It does not replace the parent plan or rerun initial
+projection:
+
+```bash
+# VoiceRender measures the active plans; suppose chapter 5 returns preflight.replan.
+voicerender render-book . \
+  --variant narration4--28f616b6fe3b \
+  --chapters 5 \
+  --emphasis-policy defer-to-compose
+
+utterplan replan-book . \
+  --variant narration4--28f616b6fe3b \
+  --chapters 5
+
+# Measure/render the newly active child. Repeat these last two commands if it
+# still reports preflight.replan; each cycle must use feedback for the active plan.
+voicerender render-book . \
+  --variant narration4--28f616b6fe3b \
+  --chapters 5 \
+  --emphasis-policy defer-to-compose
+```
+
+Use the exact variant directory name (including its profile fingerprint). `replan-book`
+searches `preflight-recheck.toml` before `preflight.toml` and refuses stale feedback,
+so a report for a parent can never be applied to its child. The single-file
+`render-plan --previous ... --preflight ...` operation remains available for
+low-level replanning.
+
+This orchestration does not add a splitter, renderer-specific capacity estimate, or
+engine dependency. VoiceRender supplies preflight measurements and remains responsible
+for synthesis and audio composition.
+
 Related packages: [RenderPlan](https://pypi.org/project/renderplan/) defines the
 shared profile and plan contracts; [VoiceRender](https://pypi.org/project/voicerender/)
 creates engine-backed profiles and performs preflight and synthesis.

{utterplan-0.6.2 → utterplan-0.6.4}/README.md

@@ -41,6 +41,16 @@ utterplan compile-many examples/*.ssmd --output-dir build/plans
 
 This writes one `.utterplan.toml` per source plus an atomically refreshed `compile-report.toml`. Terminal diagnostics default to warnings; `--diagnostics all` also prints informational records, while `--diagnostics none` suppresses non-failure details. Failures are always reported, and the operational report retains every diagnostic. Use `--fail-fast` to skip later inputs after a failure, `--force` to replace existing plans, or `--report PATH` to choose another report location.
 
+## Compile an SSMDDoc workspace
+
+Compile one editable `.ssmdoc` directory as one SSMD document and one FlowPlan:
+
+```bash
+utterplan compile-document story.ssmdoc
+```
+
+By default this writes `story.ssmdoc/.readio/utterplan/document-0001.utterplan.toml` and a `compile-report.toml`. The current `document.ssmd.md` is authoritative even if its manifest digest is stale; UtterPlan leaves the source and manifest untouched. This is separate from the multi-chapter SSMDBook workflow below. See the [SSMDDoc workspace guide](docs/ssmdoc.md) for manifest safety, output options, and the Python API.
+
 Compile a selected chapter range directly from an editable SSMDBook workspace:
 
 ```bash
@@ -109,6 +119,41 @@ creates or refreshes engine-backed profiles, then preflights and renders the
 resulting RenderPlans. The single-file `utterplan render-plan` command remains the
 low-level projection and deterministic replan primitive.
 
+When VoiceRender reports `preflight.replan`, use the new `replan-book` command to
+refine the exact active chapter plan. The operation reads the RenderProfile snapshot
+from the selected variant, writes a fingerprinted child RenderPlan, and updates only
+that chapter's active set entry. It does not replace the parent plan or rerun initial
+projection:
+
+```bash
+# VoiceRender measures the active plans; suppose chapter 5 returns preflight.replan.
+voicerender render-book . \
+  --variant narration4--28f616b6fe3b \
+  --chapters 5 \
+  --emphasis-policy defer-to-compose
+
+utterplan replan-book . \
+  --variant narration4--28f616b6fe3b \
+  --chapters 5
+
+# Measure/render the newly active child. Repeat these last two commands if it
+# still reports preflight.replan; each cycle must use feedback for the active plan.
+voicerender render-book . \
+  --variant narration4--28f616b6fe3b \
+  --chapters 5 \
+  --emphasis-policy defer-to-compose
+```
+
+Use the exact variant directory name (including its profile fingerprint). `replan-book`
+searches `preflight-recheck.toml` before `preflight.toml` and refuses stale feedback,
+so a report for a parent can never be applied to its child. The single-file
+`render-plan --previous ... --preflight ...` operation remains available for
+low-level replanning.
+
+This orchestration does not add a splitter, renderer-specific capacity estimate, or
+engine dependency. VoiceRender supplies preflight measurements and remains responsible
+for synthesis and audio composition.
+
 Related packages: [RenderPlan](https://pypi.org/project/renderplan/) defines the
 shared profile and plan contracts; [VoiceRender](https://pypi.org/project/voicerender/)
 creates engine-backed profiles and performs preflight and synthesis.

{utterplan-0.6.2 → utterplan-0.6.4}/docs/architecture.md

@@ -1,6 +1,6 @@
 ---
 title: "Architecture Documentation"
-version: 1
+version: 2
 generator: "archledger 0.4.0"
 arc42_template_version: "9.0-EN"
 ---
@@ -60,6 +60,10 @@ The compiler still handles one document at a time; the CLI's explicit SSMDBook
 commands (`compile-book`, `render-book`) discover chapters and orchestrate per-file
 workspaces without changing book content.
 
+## Document workspaces
+
+An editable `ssmdconvert.document` v1 workspace (`.ssmdoc`) is another source path for the one-document compiler. `compile-document` discovers its canonical current SSMD document and writes one FlowPlan plus an operational report under `.readio/utterplan/`; it does not create a book or alter workspace source material.
+
 ## Requirements Overview
 
 <!-- archledger: no accepted records for this section yet -->
@@ -164,6 +168,12 @@ UtterPlan depends directly on SSMD, PhraseSplit, and TTSReady:
 - Renderer chunking, token-budget, and pause-realization choices.
 - Consumer-specific compatibility testing.
 
+## SSMDDoc source workspace
+
+- An editable `.ssmdoc` directory is discovered by its `ssmdconvert.document` v1 manifest, not by its directory suffix. Its canonical `document.ssmd.md` is the current compiler input.
+- The workspace remains one document to one FlowPlan. Manifest digests are provenance only for editable directories: UtterPlan compiles current content and never refreshes the manifest or edits the source.
+- `compile-document` is single-document convenience, not book orchestration. ZIP bundles, fake chapters, and an `ssmdconvert` runtime dependency are outside the contract.
+
 ## Business Context
 
 <!-- archledger: no accepted records for this section yet -->
@@ -253,6 +263,10 @@ provenance, diagnostics, and renderability evidence in a separate versioned TOML
 sidecar. Trace state is not renderer input and does not affect plan identity or
 TOML.
 
+## Document workspace orchestration
+
+`ssmdoc.py` performs read-only manifest discovery and canonical path safety checks; `source_input.py` centralizes standalone-file and `.ssmdoc` source loading; and `document_workspace.py` delegates one stable `document-0001` CompileRequest to the existing batch persistence/report path. The CLI and public package API expose `compile-document` and `compile_ssmdoc()` without shadowing the in-memory `compile_document()` compiler.
+
 <!-- archledger: no accepted records for this section yet -->
 
 # Runtime View
@@ -327,6 +341,17 @@ accepts TOML only and rejects JSON.
 RenderPlan and its matching preflight report are required together; UtterPlan does
 not calculate renderer-specific metrics.
 
+## Scenario: compile an editable SSMDDoc workspace
+
+```text
+ssmdconvert.document v1 manifest + current document.ssmd.md
+    -> utterplan compile-document
+    -> one FlowPlan at .readio/utterplan/document-0001.utterplan.toml
+       + one compile-report.toml
+```
+
+The manifest validates the workspace contract and safe canonical path; SSMD 0.9 content is compiled by the existing single-document path. A stale stored digest does not block editable-directory compilation, and UtterPlan does not modify source material or model the document as a chapter.
+
 <!-- archledger: no accepted records for this section yet -->
 
 # Deployment View
@@ -355,6 +380,8 @@ or audio dependencies:
 - **Quality gate.** `python -m pytest -q`, `ruff check .`, and `mypy utterplan` run
   against the self-contained repository test suite.
 
+- **Editable document workspaces.** `.ssmdoc` v1 is consumed as a stable file-format contract with the standard library; `ssmdconvert` is not a runtime dependency. `compile-document` writes derived plans under the reserved `.readio/utterplan/` directory without changing source files.
+
 <!-- archledger: no accepted records for this section yet -->
 
 # Cross-cutting Concepts
@@ -484,6 +511,8 @@ drafts and never become canonical plans.
   compiled plan; replanning is a separate operation. _Rationale:_ schema evolution
   must not force package-version coupling or silent replans.
 
+- **AD: SSMDDoc is one document, not a book.** An `ssmdconvert.document` v1 workspace resolves to its current canonical SSMD source and the existing one-document compiler, producing one FlowPlan. Editable directory digests do not override current source content; UtterPlan neither refreshes nor mutates the workspace. _Rationale:_ preserve one-document/one-plan semantics and keep source-workspace ownership in `ssmdconvert`.
+
 <!-- archledger: no accepted records for this section yet -->
 
 # Quality Requirements
@@ -584,4 +613,6 @@ drafts and never become canonical plans.
 | Planning attempt | Inspect-only `utterplan.planning-attempt.v1` artifact for reviewing blocked renderability outcomes; never a canonical plan.                                                                         |
 | plan_id          | Deterministic renderer-independent plan identity; v7 `utterplan-flow-v3` includes boundaries and never hashes TOML formatting.                                                                      |
 
+| SSMDDoc | Editable single-document workspace using the `ssmdconvert.document` v1 manifest; `compile-document` compiles the current canonical SSMD file to one FlowPlan without mutating source. |
+
 <!-- archledger: no accepted records for this section yet -->

{utterplan-0.6.2 → utterplan-0.6.4}/docs/changelog.md

@@ -4,6 +4,22 @@
 
 ## [Unreleased]
 
+## [v0.6.4] - 2026-10-19
+
+### Added
+
+- Added compile-document for editable SSMDDoc workspaces with safe source loading and plan reports
+
+<!-- generated by releaseledger -->
+
+## [v0.6.3] - 2026-10-15
+
+### Added
+
+- Added replan-book to refine active book RenderPlans from matching VoiceRender preflight feedback
+
+<!-- generated by releaseledger -->
+
 ## [v0.6.2] - 2026-10-14
 
 ### Added

{utterplan-0.6.2 → utterplan-0.6.4}/docs/cli.md

@@ -124,6 +124,21 @@ Compile reports use format version 2. Each successful item records its resolved
 
 Shared planning options include `--language`, `--input-format auto|plain|ssmd`, `--text-preparation`, `--spacy`, and `--renderability`. `--diagnostics warnings|all|none` controls terminal detail (default `warnings`): warnings mode suppresses informational diagnostics, all includes them, and none suppresses non-failure diagnostics. Failures are always reported, and the operational report always retains complete diagnostics. Progress, selected diagnostic details, actionable errors, and final counts are written to stderr. Exit status is 0 if every input succeeds, 1 if any input fails, and 2 for usage errors such as output collisions. `--fail-fast` skips later requests after the first failure but preserves all completed outputs and updates the report.
 
+## Compile one SSMDDoc workspace
+
+`compile-document` reads a single editable `ssmdconvert.document` v1 workspace and compiles its canonical SSMD 0.9 document into one plan. It accepts the workspace root or its canonical `document.ssmd.md` path:
+
+```text
+utterplan compile-document INPUT [--output-dir PATH] [--language LANGUAGE]
+  [--text-preparation {auto,ssmd,spokenform,identity}]
+  [--renderability {strict,repair}] [--spacy {auto,off,sm,md,lg,trf}]
+  [--force] [--report PATH] [--diagnostics {warnings,all,none}]
+```
+
+The default output directory is `<workspace>/.readio/utterplan/`, containing `document-0001.utterplan.toml` and `compile-report.toml`. `--output-dir` and `--report` override those locations. Existing plan files require `--force`; output collisions with the source or manifest are rejected. A document header's language is authoritative; `--language`/`--lang` is a fallback when it is absent.
+
+Editable content wins over the stored manifest digest: compilation reads the current `document.ssmd.md` but never modifies the manifest or source. The command has no `--input-format`, chapter selection, or `--fail-fast`; it handles one document. The existing `compile` and `validate` commands also accept the workspace root or canonical document path, while `compile` retains its normal stdout/`-o` behavior. This is not `compile-book`: an SSMDDoc creates one plan, while an SSMDBook orchestrates independent chapter plans. ZIP bundles are not supported and `ssmdconvert` is not a runtime dependency. See the [SSMDDoc guide](ssmdoc.md) for format validation and the `compile_ssmdoc()` Python API.
+
 ## Compile chapters from an SSMDBook workspace
 
 `compile-book` discovers selected SSMD chapters from an editable `.ssmdbook` manifest and compiles each chapter independently through the batch compiler. Pass either the book directory or its canonical `chapters/` directory:
@@ -205,6 +220,76 @@ are rejected before chapter processing. Exit status is 0 when all selected
 chapters succeed, 1 when any chapter fails, and 2 for usage or shared-configuration
 errors. See the [SSMDBook workflow guide](ssmdbook.md) for end-to-end and multi-voice examples.
 
+## Replan active RenderPlans for selected chapters
+
+`replan-book` is the book/variant orchestration for VoiceRender's capacity feedback.
+It loads the profile snapshot owned by the existing RenderPlanSet; callers must select
+the exact variant directory, not supply another profile:
+
+VoiceRender supplies capacity feedback: UtterPlan does not add renderer-specific
+metrics, a splitter, engine selection, synthesis, or audio composition.
+
+```text
+utterplan replan-book INPUT --variant VARIANT [--chapters SELECTOR]
+  [--renderplan-root PATH] [--voicerender-root PATH] [--report PATH]
+  [--dry-run] [--fail-fast] [--explain] [--json]
+```
+
+Example repeatable lifecycle:
+
+```bash
+# Initial projection and exact renderer preflight/render
+utterplan render-book . --profile narration4.renderprofile.toml --variant narration4 --chapters 5
+voicerender render-book . --variant narration4--28f616b6fe3b --chapters 5 \
+  --emphasis-policy defer-to-compose
+
+# If VoiceRender returns preflight.replan, refine only the active chapter plan
+utterplan replan-book . --variant narration4--28f616b6fe3b --chapters 5
+
+# Preflight/render the new active plan; repeat replan-book and this command if needed
+voicerender render-book . --variant narration4--28f616b6fe3b --chapters 5 \
+  --emphasis-policy defer-to-compose
+```
+
+`INPUT` is an SSMDBook root or its canonical `chapters/` directory. Chapter selectors
+use manifest source numbers and retain manifest order. The default RenderPlan root is
+`<book-root>/renderplan`; the default VoiceRender root is `<book-root>/voicerender`.
+The command reads `<variant>/renderprofile.toml` and the selected active plan paths
+from `renderplan-set.toml`. It discovers reports under
+`<voicerender-root>/<variant>/<chapter-id>/`, preferring `preflight-recheck.toml`
+over `preflight.toml` when both fully validate against the exact active RenderPlan.
+
+Only a matching `status="replan"` report is accepted. Missing reports, stale parent
+reports, mismatched profile/plan identities, and `ok`/`reject` statuses fail that
+chapter; the command never falls back to an initial RenderPlan projection. A successful
+replan writes a deterministic immutable child plan first, then atomically changes only
+the selected chapter's active set entry. Parent plans, source UtterPlans, profile
+identity, and unselected set entries remain unchanged. Run VoiceRender again after
+each replan; repeat the two feedback steps until preflight is `ok`.
+
+Defaults and behavior:
+
+- `--variant` is required and must name the existing full variant directory, including
+  its profile fingerprint. The profile snapshot is loaded from that collection.
+- `--chapters`: `all`, one source number, an inclusive range, or comma-separated
+  selections; default is `all`.
+- `--renderplan-root` and `--voicerender-root` override the collection/data roots,
+  not the selected variant or chapter paths recorded by the contracts.
+- `--report`: defaults to `<variant-dir>/replan-report.toml`; progress is persisted
+  after each chapter and the final report is marked complete.
+- `--dry-run`: validates and plans children without writing child RenderPlans or
+  changing the set index. It writes the operational report and reports successful
+  items as `planned`.
+- `--fail-fast`: later chapters are recorded as skipped after the first failure;
+  without it, later selected chapters continue.
+- `--explain` uses the existing per-request RenderPlan explanation; `--json` emits
+  structured outcome paths, identities, replacement counts, errors, and optional
+  explanations.
+
+Re-running with a stale report after activating a child fails with
+`renderplan.replan.book.preflight_stale`. VoiceRender must first measure the active
+child to produce its own matching feedback report.
+
 ## Explain a plan
 
 Explain an existing compiled plan as a human-readable speech narrative:

{utterplan-0.6.2 → utterplan-0.6.4}/docs/index.md

@@ -9,6 +9,7 @@ speech plans. It stops before G2P and synthesis.
 
 getting-started
 cli
+SSMDDoc workspace support <ssmdoc>
 SSMDBook and RenderPlan workflow <ssmdbook>
 consumer-guide
 format
@@ -27,4 +28,5 @@ changelog
 ```
 
 The [SSMDBook guide](ssmdbook.md) covers workspace compilation and the profile-specific `render-book` workflow, including how RenderPlan and VoiceRender fit after semantic planning.
+The [SSMDDoc guide](ssmdoc.md) covers one-document workspace compilation, source immutability, and how it differs from an SSMDBook.
 The package version and the UtterPlan schema version are independent. Schema v7 is the only version accepted by normal loading and execution. Schema-v5/v6 TOML and schemas v1–v4 remain immutable historical migration inputs; the sequential path reaches v6, while v6-to-v7 requires recompiling the original source.

utterplan-0.6.4/docs/ssmdoc.md

@@ -0,0 +1,64 @@
+# SSMDDoc workspace support
+
+UtterPlan can compile an editable `.ssmdoc` workspace as one SSMD 0.9 document. This is a workspace input convenience around the existing one-document compiler; it is not a book format and does not create chapter plans.
+
+## Workspace contract
+
+A workspace is identified by a `manifest.json` whose `format` is `ssmdconvert.document` and whose `schema_version` is `1`. UtterPlan supports the v1 contract and expects the canonical document entry to identify `document-0001` at the normalized relative path `document.ssmd.md`. The source is SSMD 0.9.
+
+The current `document.ssmd.md` is authoritative. Its manifest digest and character count are metadata, not a lock: if you edit the document and its recorded digest becomes stale, UtterPlan compiles the current file. It never rewrites the manifest, refreshes hashes, or edits source content. The `.readio/utterplan/` directory is reserved for derived UtterPlan artifacts.
+
+Discovery and path handling are deliberately strict. The manifest must be valid UTF-8 JSON within the 2 MiB limit, and the document is limited to 64 MiB. UtterPlan checks the canonical path and workspace containment, rejects unsupported manifest versions and unsafe paths, and does not follow a document path outside the workspace. It reads no source-media files. `ssmdconvert` is not a runtime dependency: UtterPlan consumes the published file-format contract directly.
+
+ZIP bundles are not supported by this workflow; use an editable directory workspace.
+
+## Compile a workspace
+
+Run `compile-document` with the workspace directory (the suffix need not be `.ssmdoc` if the manifest identifies it):
+
+```bash
+utterplan compile-document story.ssmdoc
+```
+
+It writes one plan and one operational report by default:
+
+```text
+story.ssmdoc/.readio/utterplan/
+├── document-0001.utterplan.toml
+└── compile-report.toml
+```
+
+The report describes the single compilation and is not a FlowPlan. You can override the destination and report path:
+
+```bash
+utterplan compile-document story.ssmdoc \
+  --output-dir build/story-plan \
+  --report build/story-report.toml \
+  --language en-US \
+  --spacy off
+```
+
+Options are `--output-dir`, `--report`, `--language`/`--lang`, `--text-preparation`, `--renderability`, `--spacy`, `--diagnostics`, and `--force`. SSMD header language remains authoritative; pass `--language` as a fallback when the document has no language. Existing plan outputs are protected unless `--force` is supplied. The report may not collide with the plan, manifest, or source document. `compile-document` is a single-workspace command, so it has no chapter selector or `--fail-fast` option.
+
+The existing `compile` and `validate` commands also accept the workspace root or its canonical `document.ssmd.md` file as input. `compile` keeps its normal stdout/`-o` behavior; use `compile-document` when you want the workspace-oriented default output directory and report. `validate` compiles the source for validation without writing a plan.
+
+## Python API
+
+Use `compile_ssmdoc()` for file-backed workspace compilation. The existing `compile_document()` remains the in-memory text API:
+
+```python
+from utterplan import compile_ssmdoc
+
+result = compile_ssmdoc("story.ssmdoc", language="en-US")
+if result.failed:
+    raise RuntimeError(f"workspace compilation failed; see {result.report_path}")
+print(result.plan_path)
+```
+
+The result provides the workspace and source paths, output and report paths, and the one-item batch outcome. Options include `output_dir`, `report`, `language`, `planner_config`, `force`, `diagnostics`, and progress/start callbacks. The default artifacts match the CLI: `.readio/utterplan/document-0001.utterplan.toml` and `compile-report.toml`.
+
+## SSMDDoc is not SSMDBook
+
+An SSMDDoc contains one editable document and produces one canonical FlowPlan. An SSMDBook manifest discovers multiple independent chapter documents; `compile-book` writes one plan per selected chapter and never builds a book-level combined plan. Use [SSMDBook workflows](ssmdbook.md) for book compilation and RenderPlan projection.
+
+Neither workspace workflow changes its source manifest or source documents. UtterPlan stops at semantic FlowPlans; engine selection, G2P, synthesis, and audio remain downstream.

utterplan-0.6.4/tests/fixtures/ssmdoc-v1/story.ssmdoc/document.ssmd.md

@@ -0,0 +1,6 @@
+---
+ssmd_version: "0.9"
+language: en-US
+---
+
+I have [UtterPlan]{ph="utter plan"} here.

utterplan-0.6.4/tests/fixtures/ssmdoc-v1/story.ssmdoc/manifest.json

@@ -0,0 +1,21 @@
+{
+  "format": "ssmdconvert.document",
+  "schema_version": 1,
+  "ssmd_version": "0.9",
+  "metadata": {
+    "title": "UtterPlan document fixture",
+    "language": "en-US"
+  },
+  "source": {
+    "format": "markdown",
+    "media_type": "text/markdown",
+    "name": "story.md",
+    "sha256": "0000000000000000000000000000000000000000000000000000000000000000"
+  },
+  "document": {
+    "id": "document-0001",
+    "path": "document.ssmd.md",
+    "char_count": 87,
+    "sha256": "ed67851d91bb3d82c08020d1cdfef99102632a62dbeea46ee1793cf8fa9a49c3"
+  }
+}

{utterplan-0.6.2 → utterplan-0.6.4}/tests/test_book_api.py

@@ -16,9 +16,15 @@ from utterplan import (
     BookCompileResult,
     BookRenderRequest,
     BookRenderResult,
+    BookReplanError,
+    BookReplanRequest,
+    BookReplanResult,
+    BookReplanStart,
     BookServiceError,
+    ReplanOutcome,
     compile_book,
     render_book,
+    replan_book,
 )
 from utterplan.config import LinguisticsConfig, PlannerConfig
 from utterplan.model import FlowPlan
@@ -95,9 +101,47 @@ def test_public_request_and_result_models_are_available_at_package_root() -> Non
         selected_chapter_ids=(),
         outcomes=(),
     )
+    replan_request = BookReplanRequest(Path("book"), variant="narration--abc")
+    replan_outcome = ReplanOutcome(
+        index=1,
+        id="chapter-0005",
+        source_number=5,
+        status="failed",
+        utterplan=None,
+        previous_renderplan=None,
+        previous_render_plan_id=None,
+        preflight=None,
+    )
+    replan_result = BookReplanResult(
+        workspace=Path("book"),
+        variant="narration--abc",
+        variant_dir=Path("book/renderplan/narration--abc"),
+        set_path=Path("book/renderplan/narration--abc/renderplan-set.toml"),
+        profile_path=Path("book/renderplan/narration--abc/renderprofile.toml"),
+        report_path=Path("book/renderplan/narration--abc/replan-report.toml"),
+        selected_chapter_ids=("chapter-0005",),
+        dry_run=False,
+        outcomes=(replan_outcome,),
+    )
+    replan_start = BookReplanStart(
+        workspace=Path("book"),
+        chapter_selector="5",
+        selected_chapter_ids=("chapter-0005",),
+        variant="narration--abc",
+        variant_dir=replan_result.variant_dir,
+        set_path=replan_result.set_path,
+        profile_path=replan_result.profile_path,
+        voicerender_dir=Path("book/voicerender/narration--abc"),
+        report_path=replan_result.report_path,
+    )
     assert compile_request.book == Path("book")
     assert render_request.profile == Path("profile.renderprofile.toml")
     assert compile_result.exit_code == render_result.exit_code == 0
+    assert replan_request.book == Path("book")
+    assert replan_result.exit_code == 1 and replan_result.failed == 1
+    assert replan_start.variant == replan_request.variant
+    assert callable(replan_book)
+    assert issubclass(BookReplanError, BookServiceError)
     assert compile_result.failed == render_result.failed == 0