utterplan 0.6.6__tar.gz → 0.6.7__tar.gz

{utterplan-0.6.6 → utterplan-0.6.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: utterplan
-Version: 0.6.6
+Version: 0.6.7
 Summary: Engine-independent text-to-speech planning compiler and interchange format
 Author-email: Holger Nahrstaedt <nahrstaedt@gmail.com>
 License:                                  Apache License

{utterplan-0.6.6 → utterplan-0.6.7}/docs/bundles.md

@@ -26,6 +26,13 @@ utterplan bundle compile novel.ssmd-bundle --chapters 5-17
 utterplan bundle compile story.ssmd-bundle --text-preparation identity
 ```
 
+When already inside a bundle root, `.` is also accepted because the supplied path is resolved before the directory name is validated:
+
+```bash
+cd story.ssmd-bundle
+utterplan bundle compile --lang en .
+```
+
 Compilation defaults to all items. For book bundles, `--chapters` selects manifest `source_number` values: one number, an inclusive range, or comma-separated combinations such as `1,3-5,9`. Selected items retain manifest order. A document bundle accepts only `--chapters all`.
 
 By default, one schema-v7 `.utterplan.toml` plan per selected item and `compile-report.toml` are written under `<bundle>/utterplan/`. `--output-dir` and `--report` override those destinations. Existing plans are protected unless `--force` is supplied; `--fail-fast` records later selected items as skipped after a failure. `--language` is a fallback for SSMD language metadata. Bundle sources are SSMD 0.9, so the command does not accept an input-format override. The report is operational metadata and does not affect plan identity.
@@ -58,7 +65,7 @@ The full variant directory name, including its profile fingerprint, is required.
 
 ## Safe and read-only behavior
 
-The bundle path must be a directory named `<name>.ssmd-bundle` containing a regular `manifest.json`. Manifest item paths must be normalized relative POSIX paths, remain inside the resolved root, and resolve to regular files. Symlink escapes and unsafe output collisions are rejected. Manifest size and document size are bounded. Source digests are not used to replace current edited content; the manifest and source files are never refreshed or rewritten.
+The supplied workspace path is resolved first. The resolved directory must be named `<name>.ssmd-bundle` and contain a regular, non-symlink `manifest.json`. Therefore `.` and equivalent aliases are valid when they resolve to the bundle root; paths to `chapters/` or an item file remain invalid. Manifest item paths must be normalized relative POSIX paths, remain inside the resolved root, and resolve to regular files. Symlink escapes and unsafe output collisions are rejected. Manifest size and document size are bounded. Source digests are not used to replace current edited content; the manifest and source files are never refreshed or rewritten.
 
 ## Python API
 

{utterplan-0.6.6 → utterplan-0.6.7}/docs/changelog.md

@@ -4,6 +4,14 @@
 
 ## [Unreleased]
 
+## [v0.6.7] - 2026-10-22
+
+### Fixed
+
+- Fixed bundle path detection when a path resolves to an SSMD bundle root
+
+<!-- generated by releaseledger -->
+
 ## [v0.6.6] - 2026-10-21
 
 ### Added

{utterplan-0.6.6 → utterplan-0.6.7}/tests/test_bundle_replan.py

@@ -10,8 +10,10 @@ from renderplan import codec as renderplan_codec
 
 from tests.test_bundle_book_replan import _active_plan, _save_preflight, _setup
 from tests.test_bundle_services import _planner_config, _profile
+from utterplan._book_replan import BookReplanError, replan_book
 from utterplan.bundle import compile_bundle, render_bundle
 from utterplan.bundle_replan import BundleReplanError, replan_bundle
+from utterplan.ssmd_bundle import load_ssmd_bundle
 
 DOCUMENT_FIXTURE = Path(__file__).parent / "fixtures/document-bundle-v1/story.ssmd-bundle"
 
@@ -62,13 +64,24 @@ def _document_preflight(root: Path, variant: str, active_path: Path) -> Path:
 
 def test_replan_bundle_keeps_book_set_selection_and_immutable_child_behavior(
     tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
 ) -> None:
     root, variant, variant_dir, _ = _setup(tmp_path, numbers=(5, 6))
     entry, parent, _ = _active_plan(variant_dir)
+    loaded_indexes = []
+
+    def tracked_load(path):
+        index = load_ssmd_bundle(path)
+        loaded_indexes.append(index)
+        return index
+
+    monkeypatch.setattr("utterplan.bundle_replan.load_ssmd_bundle", tracked_load)
+    monkeypatch.setattr("utterplan._book_replan.load_ssmd_bundle", tracked_load)
     preflight_path = _save_preflight(root / "voicerender", variant, entry.id, parent)
     starts = []
 
     result = replan_bundle(root, variant=variant, chapters="5", on_start=starts.append)
+    assert len(loaded_indexes) == 1
 
     assert result.kind == "book"
     assert result.selected_item_ids == ("chapter-0005",)
@@ -133,3 +146,10 @@ def test_document_replan_rejects_non_all_selector(tmp_path: Path) -> None:
     root = _document_bundle(tmp_path / "story.ssmd-bundle")
     with pytest.raises(BundleReplanError, match="document bundles only support --chapters all"):
         replan_bundle(root, variant="any", chapters="1")
+
+
+def test_book_replan_rejects_document_bundle_direct_call(tmp_path: Path) -> None:
+    root = _document_bundle(tmp_path / "story.ssmd-bundle")
+
+    with pytest.raises(BookReplanError, match="bundle manifest format is not a book"):
+        replan_book(root, variant="not-a-book")

{utterplan-0.6.6 → utterplan-0.6.7}/tests/test_bundle_services.py

@@ -8,8 +8,10 @@ import pytest
 from renderplan import PausePolicy, PlanningPolicy, RenderProfile, RoleProfile
 from renderplan import codec as renderplan_codec
 
+from utterplan._book_service import BookServiceError, compile_book, render_book
 from utterplan.bundle import BundleServiceError, compile_bundle, render_bundle
 from utterplan.config import LinguisticsConfig, PlannerConfig
+from utterplan.ssmd_bundle import load_ssmd_bundle
 
 DOCUMENT_FIXTURE = Path(__file__).parent / "fixtures/document-bundle-v1/story.ssmd-bundle"
 
@@ -76,7 +78,7 @@ def _profile(path: Path) -> RenderProfile:
 
 @pytest.mark.parametrize("kind", ["book", "document"])
 def test_compile_bundle_dispatches_both_kinds_and_returns_uniform_result(
-    tmp_path: Path, kind: str
+    tmp_path: Path, kind: str, monkeypatch: pytest.MonkeyPatch
 ) -> None:
     root = (
         _book(tmp_path / "novel.ssmd-bundle")
@@ -84,6 +86,19 @@ def test_compile_bundle_dispatches_both_kinds_and_returns_uniform_result(
         else _document(tmp_path / "story.ssmd-bundle")
     )
     starts = []
+    loaded_indexes = []
+
+    def tracked_load(path):
+        index = load_ssmd_bundle(path)
+        loaded_indexes.append(index)
+        return index
+
+    for module in (
+        "utterplan.bundle",
+        "utterplan._book_service",
+        "utterplan._document_service",
+    ):
+        monkeypatch.setattr(f"{module}.load_ssmd_bundle", tracked_load)
 
     result = compile_bundle(root, planner_config=_planner_config(), on_start=starts.append)
 
@@ -100,6 +115,8 @@ def test_compile_bundle_dispatches_both_kinds_and_returns_uniform_result(
     assert starts[0].selected_item_ids == result.selected_item_ids
     assert result.report_path.is_file()
 
+    assert len(loaded_indexes) == 1
+
 
 def test_document_bundle_only_accepts_all_chapters_for_compile_and_render(tmp_path: Path) -> None:
     root = _document(tmp_path / "story.ssmd-bundle")
@@ -110,18 +127,45 @@ def test_document_bundle_only_accepts_all_chapters_for_compile_and_render(tmp_pa
         render_bundle(root, profile=tmp_path / "missing.renderprofile.toml", chapters="2")
 
 
-def test_render_bundle_dispatches_book_and_document_with_uniform_outputs(tmp_path: Path) -> None:
+def test_book_services_reject_document_bundle_direct_calls(tmp_path: Path) -> None:
+    root = _document(tmp_path / "story.ssmd-bundle")
+
+    with pytest.raises(BookServiceError, match="bundle manifest format is not a book"):
+        compile_book(root)
+    with pytest.raises(BookServiceError, match="bundle manifest format is not a book"):
+        render_book(root, profile=tmp_path / "missing.renderprofile.toml")
+
+
+def test_render_bundle_dispatches_book_and_document_with_uniform_outputs(
+    tmp_path: Path, monkeypatch: pytest.MonkeyPatch
+) -> None:
+    loaded_indexes = []
+
+    def tracked_load(path):
+        index = load_ssmd_bundle(path)
+        loaded_indexes.append(index)
+        return index
+
+    for module in (
+        "utterplan.bundle",
+        "utterplan._book_service",
+        "utterplan._document_service",
+    ):
+        monkeypatch.setattr(f"{module}.load_ssmd_bundle", tracked_load)
+
     for kind, root in (
         ("book", _book(tmp_path / "novel.ssmd-bundle")),
         ("document", _document(tmp_path / "story.ssmd-bundle")),
     ):
         compile_bundle(root, planner_config=_planner_config())
         profile_path = root / f"{kind}.renderprofile.toml"
+        loaded_indexes.clear()
         _profile(profile_path)
         starts = []
 
         result = render_bundle(root, profile=profile_path, on_start=starts.append)
 
+        assert len(loaded_indexes) == 1
         assert result.kind == kind
         assert result.workspace == root
         assert result.exit_code == 0

{utterplan-0.6.6 → utterplan-0.6.7}/tests/test_cli_bundle_compile_book.py

@@ -166,6 +166,39 @@ def test_compile_book_root_range_defaults_to_utterplan_and_writes_v6_plans(
     assert (root / "manifest.json").read_bytes() == manifest_before
 
 
+def test_bundle_compile_accepts_dot_from_current_book_bundle(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    root = tmp_path / "book.ssmd-bundle"
+    _write_book(root, (5,), contents={5: _ssmd("Chapter 5.")})
+    manifest = root / "manifest.json"
+    manifest_before = manifest.read_bytes()
+    monkeypatch.chdir(root)
+
+    result = main(
+        [
+            "bundle",
+            "compile",
+            "--lang",
+            "en",
+            ".",
+            "--text-preparation",
+            "identity",
+            "--spacy",
+            "off",
+        ]
+    )
+
+    capsys.readouterr()
+    assert result == 0
+    assert (root / "utterplan/chapter-0005.utterplan.toml").is_file()
+    assert (root / "utterplan/compile-report.toml").is_file()
+    assert _plan_text(root / "utterplan/chapter-0005.utterplan.toml") == "Chapter 5."
+    assert manifest.read_bytes() == manifest_before
+
+
 def test_compile_book_report_records_ssmd_mode_and_repaired_cut_details(
     tmp_path: Path, capsys: pytest.CaptureFixture[str], monkeypatch: pytest.MonkeyPatch
 ) -> None:

{utterplan-0.6.6 → utterplan-0.6.7}/tests/test_cli_bundle_document.py

@@ -84,6 +84,41 @@ def test_compile_document_uses_manifest_kind_with_canonical_root(
     assert (root / "utterplan/document.utterplan.toml").is_file()
 
 
+def test_bundle_compile_accepts_dot_from_current_document_bundle(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+    capsys: pytest.CaptureFixture[str],
+) -> None:
+    root = _workspace(tmp_path)
+    manifest = root / "manifest.json"
+    source = root / "document.ssmd.md"
+    manifest_before = manifest.read_bytes()
+    source_before = source.read_bytes()
+    monkeypatch.chdir(root)
+
+    result = main(
+        [
+            "bundle",
+            "compile",
+            "--lang",
+            "en",
+            ".",
+            "--text-preparation",
+            "identity",
+            "--spacy",
+            "off",
+        ]
+    )
+
+    capsys.readouterr()
+    assert result == 0
+    assert (root / "utterplan/document.utterplan.toml").is_file()
+    assert (root / "utterplan/compile-report.toml").is_file()
+    assert "Original content." in _plan_text(root / "utterplan/document.utterplan.toml")
+    assert manifest.read_bytes() == manifest_before
+    assert source.read_bytes() == source_before
+
+
 def test_compile_document_uses_dirty_current_content_without_refreshing_manifest(
     tmp_path: Path, capsys: pytest.CaptureFixture[str]
 ) -> None:

{utterplan-0.6.6 → utterplan-0.6.7}/tests/test_ssmd_bundle.py

@@ -111,6 +111,25 @@ def test_rejects_non_root_workspace_inputs(tmp_path: Path) -> None:
         resolve_ssmd_bundle_root(tmp_path / "legacy-workspace")
 
 
+@pytest.mark.parametrize(
+    ("working_directory", "path"),
+    [("root", "."), ("root", "./"), ("child", "..")],
+)
+def test_resolves_bundle_root_path_aliases(
+    tmp_path: Path,
+    monkeypatch: pytest.MonkeyPatch,
+    working_directory: str,
+    path: str,
+) -> None:
+    root = tmp_path / "story.ssmd-bundle"
+    _write_manifest(root, _document_manifest())
+    (root / "child").mkdir()
+    monkeypatch.chdir(root if working_directory == "root" else root / "child")
+
+    assert resolve_ssmd_bundle_root(path) == root.resolve()
+    assert load_ssmd_bundle(path).root == root.resolve()
+
+
 def test_rejects_bundle_root_without_manifest_or_regular_root_directory(tmp_path: Path) -> None:
     root = tmp_path / "empty.ssmd-bundle"
     root.mkdir()
@@ -207,5 +226,37 @@ def test_rejects_manifest_symlink_escape(tmp_path: Path) -> None:
     except (OSError, NotImplementedError) as exc:
         pytest.skip(f"symlinks unavailable: {exc}")
 
-    with pytest.raises(SsmdBundleError, match="cannot read bundle manifest"):
+    with pytest.raises(SsmdBundleError, match="regular file, not a symlink"):
         load_ssmd_bundle(root)
+
+
+def test_rejects_manifest_symlink_to_file_inside_bundle(tmp_path: Path) -> None:
+    root = tmp_path / "internal-manifest-link.ssmd-bundle"
+    root.mkdir()
+    target = root / "manifest-copy.json"
+    target.write_text(json.dumps(_book_manifest()), encoding="utf-8")
+    try:
+        (root / "manifest.json").symlink_to(target)
+    except (OSError, NotImplementedError) as exc:
+        pytest.skip(f"symlinks unavailable: {exc}")
+
+    with pytest.raises(SsmdBundleError, match="regular file, not a symlink"):
+        load_ssmd_bundle(root)
+
+
+def test_allows_item_symlink_target_inside_bundle(tmp_path: Path) -> None:
+    root = tmp_path / "item-link.ssmd-bundle"
+    _write_manifest(root, _book_manifest())
+    target = root / "chapter-source.ssmd.md"
+    target.write_text("chapter content", encoding="utf-8")
+    item_path = root / "chapters/chapter-0005.ssmd.md"
+    item_path.parent.mkdir()
+    try:
+        item_path.symlink_to(target)
+    except (OSError, NotImplementedError) as exc:
+        pytest.skip(f"symlinks unavailable: {exc}")
+
+    index = load_ssmd_bundle(root)
+    resolved_item = bundle_item_path(index, index.items[0], require_exists=True)
+    assert resolved_item == item_path
+    assert resolved_item.read_text(encoding="utf-8") == "chapter content"

{utterplan-0.6.6 → utterplan-0.6.7}/tests/test_ssmd_bundle_document.py

@@ -196,5 +196,5 @@ def test_rejects_manifest_symlink_escape(tmp_path: Path) -> None:
         (root / "manifest.json").symlink_to(outside)
     except (OSError, NotImplementedError) as exc:
         pytest.skip(f"symlinks unavailable: {exc}")
-    with pytest.raises(SsmdBundleError, match="cannot read bundle manifest"):
+    with pytest.raises(SsmdBundleError, match="regular file, not a symlink"):
         load_ssmd_bundle(root)

{utterplan-0.6.6 → utterplan-0.6.7}/utterplan/_book_replan.py

@@ -180,6 +180,7 @@ def replan_book(
     fail_fast: bool = False,
     on_progress: ReplanProgressCallback | None = None,
     on_start: BookReplanStartCallback | None = None,
+    _index: SsmdBundleIndex | None = None,
 ) -> BookReplanResult:
     """Refine selected active RenderPlans using their exact matching preflight reports.
 
@@ -197,7 +198,7 @@ def replan_book(
         dry_run=dry_run,
         fail_fast=fail_fast,
     )
-    context = _prepare_book(request)
+    context = _prepare_book(request, index=_index)
     selected_ids = tuple(chapter.id for chapter in context.chapters)
     _ensure_report_not_input(context)
     if on_start is not None:
@@ -275,9 +276,16 @@ def replan_book(
     )
 
 
-def _prepare_book(request: BookReplanRequest) -> _BookContext:
+def _prepare_book(
+    request: BookReplanRequest, *, index: SsmdBundleIndex | None = None
+) -> _BookContext:
     try:
-        index = load_ssmd_bundle(request.book)
+        index = index if index is not None else load_ssmd_bundle(request.book)
+        if index.kind != "book":
+            raise BookReplanError(
+                "bundle manifest format is not a book",
+                code="renderplan.replan.book.bundle_invalid",
+            )
         selected = select_bundle_items(index, request.chapters)
     except SsmdBundleError as exc:
         code = (

{utterplan-0.6.6 → utterplan-0.6.7}/utterplan/_book_service.py

@@ -29,6 +29,7 @@ from .renderplan_batch import RenderOutcome, RenderRequest, new_renderplan_set,
 from .role_coverage import profile_role_coverage
 from .ssmd_bundle import (
     SsmdBundleError,
+    SsmdBundleIndex,
     bundle_item_path,
     load_ssmd_bundle,
     select_bundle_items,
@@ -182,6 +183,7 @@ def compile_book(
     diagnostics: Literal["errors", "warnings", "all", "none"] = "errors",
     on_progress: BatchProgressCallback | None = None,
     on_start: BookCompileStartCallback | None = None,
+    _index: SsmdBundleIndex | None = None,
 ) -> BookCompileResult:
     """Compile selected chapters and atomically write schema-v7 UtterPlans.
 
@@ -201,7 +203,9 @@ def compile_book(
         planner_config=planner_config,
     )
     try:
-        index = load_ssmd_bundle(request.book)
+        index = _index if _index is not None else load_ssmd_bundle(request.book)
+        if index.kind != "book":
+            raise BookServiceError("bundle manifest format is not a book")
         chapters_selected = select_bundle_items(index, request.chapters)
         sources = [bundle_item_path(index, chapter) for chapter in chapters_selected]
     except SsmdBundleError as exc:
@@ -294,6 +298,7 @@ def render_book(
     fail_fast: bool = False,
     on_progress: RenderProgressCallback | None = None,
     on_start: BookRenderStartCallback | None = None,
+    _index: SsmdBundleIndex | None = None,
 ) -> BookRenderResult:
     """Project selected schema-v7 FlowPlans to a profile-specific RenderPlan set."""
     request = BookRenderRequest(
@@ -308,7 +313,9 @@ def render_book(
         fail_fast=fail_fast,
     )
     try:
-        index = load_ssmd_bundle(request.book)
+        index = _index if _index is not None else load_ssmd_bundle(request.book)
+        if index.kind != "book":
+            raise BookServiceError("bundle manifest format is not a book")
         chapters_selected = select_bundle_items(index, request.chapters)
         sources = [bundle_item_path(index, chapter) for chapter in chapters_selected]
     except SsmdBundleError as exc:

{utterplan-0.6.6 → utterplan-0.6.7}/utterplan/_document_service.py

@@ -17,7 +17,7 @@ from .model import FlowPlan
 from .renderplan_export import build_render_plan
 from .renderplan_workspace import profile_fingerprint, render_variant_label
 from .role_coverage import assert_profile_role_coverage
-from .ssmd_bundle import SsmdBundleError, bundle_item_path, load_ssmd_bundle
+from .ssmd_bundle import SsmdBundleError, SsmdBundleIndex, bundle_item_path, load_ssmd_bundle
 from .workspace_paths import renderplan_output_name, utterplan_output_name
 
 
@@ -94,6 +94,7 @@ def _compile_document_service(
     diagnostics: Literal["errors", "warnings", "all", "none"] = "errors",
     on_progress: BatchProgressCallback | None = None,
     on_start: DocumentCompileStartCallback | None = None,
+    bundle_index: SsmdBundleIndex | None = None,
 ) -> DocumentCompileResult:
     """Compile the current canonical SSMD document and write a one-item report."""
     request = DocumentCompileRequest(
@@ -106,7 +107,7 @@ def _compile_document_service(
         diagnostics=diagnostics,
     )
     try:
-        index = load_ssmd_bundle(request.workspace)
+        index = bundle_index if bundle_index is not None else load_ssmd_bundle(request.workspace)
         if index.kind != "document":
             raise _DocumentBundleServiceError("bundle manifest format is not a document")
         item = index.items[0]
@@ -170,17 +171,6 @@ def _compile_document_service(
     )
 
 
-@dataclass(frozen=True, slots=True)
-class DocumentRenderRequest:
-    workspace: Path
-    profile: Path
-    variant: str | None = None
-    utterplan_dir: Path | None = None
-    output_root: Path | None = None
-    report: Path | None = None
-    force: bool = False
-
-
 @dataclass(frozen=True, slots=True)
 class DocumentRenderStart:
     workspace: Path
@@ -230,10 +220,11 @@ def _render_document_service(
     report: str | Path | None = None,
     force: bool = False,
     on_start: DocumentRenderStartCallback | None = None,
+    bundle_index: SsmdBundleIndex | None = None,
 ) -> DocumentRenderResult:
     """Project the saved document FlowPlan to one profile-specific RenderPlan."""
     try:
-        index = load_ssmd_bundle(workspace)
+        index = bundle_index if bundle_index is not None else load_ssmd_bundle(workspace)
         if index.kind != "document":
             raise _DocumentBundleServiceError("bundle manifest format is not a document")
         item = index.items[0]

{utterplan-0.6.6 → utterplan-0.6.7}/utterplan/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.6.6'
-__version_tuple__ = version_tuple = (0, 6, 6)
+__version__ = version = '0.6.7'
+__version_tuple__ = version_tuple = (0, 6, 7)
 
-__commit_id__ = commit_id = 'ga70e4a166'
+__commit_id__ = commit_id = 'g5282696da'

{utterplan-0.6.6 → utterplan-0.6.7}/utterplan/bundle.py

@@ -119,6 +119,7 @@ def compile_bundle(
         try:
             book_result = compile_book(
                 index.root,
+                _index=index,
                 chapters=selector,
                 output_dir=output_dir,
                 report=report,
@@ -160,6 +161,7 @@ def compile_bundle(
     try:
         document_result = _compile_document_service(
             index.root,
+            bundle_index=index,
             output_dir=output_dir,
             report=report,
             language=language,
@@ -221,6 +223,7 @@ def render_bundle(
         try:
             book_result = render_book(
                 index.root,
+                _index=index,
                 profile=profile,
                 chapters=selector,
                 variant=variant,
@@ -273,6 +276,7 @@ def render_bundle(
     try:
         document_result = _render_document_service(
             index.root,
+            bundle_index=index,
             profile=profile,
             variant=variant,
             utterplan_dir=utterplan_dir,

{utterplan-0.6.6 → utterplan-0.6.7}/utterplan/bundle_replan.py

@@ -159,6 +159,7 @@ def replan_bundle(
             dry_run=dry_run,
             fail_fast=fail_fast,
             on_progress=on_progress,
+            _index=index,
             on_start=(
                 lambda start: (
                     on_start(

{utterplan-0.6.6 → utterplan-0.6.7}/utterplan/cli.py

@@ -186,7 +186,9 @@ def build_parser() -> argparse.ArgumentParser:
     bundle_commands = bundle_parser.add_subparsers(dest="bundle_command", required=True)
 
     bundle_compile = bundle_commands.add_parser("compile", help="compile a book or document bundle")
-    bundle_compile.add_argument("workspace", type=Path, help="canonical NAME.ssmd-bundle directory")
+    bundle_compile.add_argument(
+        "workspace", type=Path, help="path resolving to a canonical NAME.ssmd-bundle directory"
+    )
     bundle_compile.add_argument("--chapters", default="all", metavar="SELECTOR")
     bundle_compile.add_argument("--output-dir", type=Path)
     bundle_compile.add_argument("--language", "--lang", dest="language")
@@ -205,7 +207,9 @@ def build_parser() -> argparse.ArgumentParser:
     )
 
     bundle_render = bundle_commands.add_parser("render", help="render a book or document bundle")
-    bundle_render.add_argument("workspace", type=Path, help="canonical NAME.ssmd-bundle directory")
+    bundle_render.add_argument(
+        "workspace", type=Path, help="path resolving to a canonical NAME.ssmd-bundle directory"
+    )
     bundle_render.add_argument("--profile", type=Path, required=True)
     bundle_render.add_argument("--chapters", default="all", metavar="SELECTOR")
     bundle_render.add_argument("--variant")
@@ -216,7 +220,9 @@ def build_parser() -> argparse.ArgumentParser:
     bundle_render.add_argument("--fail-fast", action="store_true")
 
     bundle_replan = bundle_commands.add_parser("replan", help="refine active bundle RenderPlans")
-    bundle_replan.add_argument("workspace", type=Path, help="canonical NAME.ssmd-bundle directory")
+    bundle_replan.add_argument(
+        "workspace", type=Path, help="path resolving to a canonical NAME.ssmd-bundle directory"
+    )
     bundle_replan.add_argument("--variant", required=True, help="exact existing RenderPlan variant")
     bundle_replan.add_argument("--chapters", default="all", metavar="SELECTOR")
     bundle_replan.add_argument("--renderplan-root", type=Path)

{utterplan-0.6.6 → utterplan-0.6.7}/utterplan/codecs/v4_toml.py

@@ -218,20 +218,6 @@ def from_toml_data(data: Mapping[str, object]) -> UtterancePlan:
     return UtterancePlan.from_dict(_decode_toml_data(data))
 
 
-def _from_toml_data_draft(data: Mapping[str, object]) -> UtterancePlan:
-    """Decode a candidate while enforcing topology but not renderability or identity."""
-    from ..model import _check_shape, _from_current_dict, validate_plan_structure
-
-    semantic = _decode_toml_data(data)
-    try:
-        _check_shape(semantic)
-        plan = _from_current_dict(semantic)
-    except (KeyError, TypeError, ValueError, IndexError) as exc:
-        raise PlanFormatError(f"invalid draft candidate: {exc}", code="plan.value") from exc
-    validate_plan_structure(plan)
-    return plan
-
-
 def dumps_toml(plan: UtterancePlan) -> str:
     """Serialize a plan to deterministic, human-readable TOML text."""
     wire = to_toml_data(plan)