tcw-cli 2.6.3__tar.gz → 2.6.4__tar.gz

{tcw_cli-2.6.3 → tcw_cli-2.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tcw-cli
-Version: 2.6.3
+Version: 2.6.4
 Summary: Taxonomy · Capabilities · Work — a storage-abstracted framework for describing and evolving a software project.
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -1102,8 +1102,11 @@ that an agent read them. Running it starts real agent sessions and costs money;
 ### Releasing
 
 `python scripts/cut_version.py <patch|minor|major|X.Y.Z>` bumps the version in all
-five files that carry it, turns the `upcoming.md` changelog and release notes into
-that version's files, commits and tags. Pushing the tag publishes the release to
+five files that carry it, combines the waiting changelog and release-note entries
+into that version's files, commits and tags. Each change adds its entries as its
+own file in `docs/changelogs/upcoming/` and `docs/release-notes/upcoming/`, named
+after its work item, so changes finished on separate branches never edit the same
+file. Pushing the tag publishes the release to
 PyPI. Details, including the one-time PyPI setup, are in
 [`docs/releasing.md`](docs/releasing.md).
 

{tcw_cli-2.6.3 → tcw_cli-2.6.4}/README.md

@@ -886,8 +886,11 @@ that an agent read them. Running it starts real agent sessions and costs money;
 ### Releasing
 
 `python scripts/cut_version.py <patch|minor|major|X.Y.Z>` bumps the version in all
-five files that carry it, turns the `upcoming.md` changelog and release notes into
-that version's files, commits and tags. Pushing the tag publishes the release to
+five files that carry it, combines the waiting changelog and release-note entries
+into that version's files, commits and tags. Each change adds its entries as its
+own file in `docs/changelogs/upcoming/` and `docs/release-notes/upcoming/`, named
+after its work item, so changes finished on separate branches never edit the same
+file. Pushing the tag publishes the release to
 PyPI. Details, including the one-time PyPI setup, are in
 [`docs/releasing.md`](docs/releasing.md).
 

{tcw_cli-2.6.3 → tcw_cli-2.6.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tcw-cli"
-version = "2.6.3"
+version = "2.6.4"
 description = "Taxonomy · Capabilities · Work — a storage-abstracted framework for describing and evolving a software project."
 readme = "README.md"
 requires-python = ">=3.11"

tcw_cli-2.6.4/tcw/__init__.py

@@ -0,0 +1 @@
+__version__ = "2.6.4"

{tcw_cli-2.6.3 → tcw_cli-2.6.4}/tcw/work/procedures/documentation-sync.md

@@ -43,9 +43,9 @@ These workflows are deeper than the core trigger-evaluation loop and live as ref
 
 | Reference                                    | Load when                                                                                                                                                                                                        |
 | -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `references/release-notes-and-changelogs.md` | The project uses the opt-in `docs/release-notes/` + `docs/changelogs/` structure AND you're writing entries, rotating `upcoming.md`, running the version cross-check, or migrating an existing `CHANGELOG.md`.   |
+| `references/release-notes-and-changelogs.md` | The project uses the opt-in `docs/release-notes/` + `docs/changelogs/` structure AND you're adding an entry file to `upcoming/`, combining entries at a cut, running the version cross-check, or migrating an existing `CHANGELOG.md`. |
 | the `configure` skill's `docs-sync.md`   | The project's `CLAUDE.md` has no `## Documentation Sync` section and the user wants to add one, or you need to create tracked files that don't exist yet.                                                        |
-| `references/cut-version.md`                  | The user asked to cut a version and you're running it — choosing the bump size, bumping every version-bearing file, rotating, committing, tagging. See "When the user asks to cut a version" below. |
+| `references/cut-version.md`                  | The user asked to cut a version and you're running it — choosing the bump size, bumping every version-bearing file, combining the `upcoming/` entries, committing, tagging. See "When the user asks to cut a version" below. |
 
 ## When the user asks to cut a version
 
@@ -84,8 +84,8 @@ ritual only when the project has none.
 Updating the changelog files is **not** part of a version cut and does not wait
 for one. The release-note and developer-changelog working files among the
 project's documentation entries (`tcw work docs`, or its `## Documentation Sync`
-section when `source` is `agent-guide`) — such as `docs/release-notes/upcoming.md`
-and `docs/changelogs/upcoming.md` — are answered by the documentation gate at
+section when `source` is `agent-guide`) — such as `docs/release-notes/upcoming/<slug>.md`
+and `docs/changelogs/upcoming/<slug>.md`, one file per change — are answered by the documentation gate at
 the end of `implement`, like any other entry whose trigger fired. Work
 accumulates there until a cut is asked for.
 

{tcw_cli-2.6.3 → tcw_cli-2.6.4}/tcw/work/procedures/unattended-work.md

@@ -34,5 +34,5 @@ not let the run wait on the subagent alone.
 | Verify decision             | Yours. Green → `tcw work submit`. Red → rework and loop; the same criterion failing three loops is a hard blocker.       |
 | Hands-on QA                 | Drive the real thing yourself, however this project is run — see the `run` skill, or whatever the repo's own guidance says. Agent reports and green suites are testimony, not evidence. |
 | Capability reconciliation   | The `capabilities` sub-skill, unchanged.                                                                            |
-| Version cut                 | Not yours to make. Nobody is present to ask for one, so let changelog entries accumulate in `upcoming.md` and move on.   |
+| Version cut                 | Not yours to make. Nobody is present to ask for one, so let changelog entries accumulate in `upcoming/` and move on.       |
 | Closeout route              | `tcw work complete`, then merge the feature branch into main **locally**. Never `git push`.                             |

{tcw_cli-2.6.3 → tcw_cli-2.6.4}/tcw_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tcw-cli
-Version: 2.6.3
+Version: 2.6.4
 Summary: Taxonomy · Capabilities · Work — a storage-abstracted framework for describing and evolving a software project.
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -1102,8 +1102,11 @@ that an agent read them. Running it starts real agent sessions and costs money;
 ### Releasing
 
 `python scripts/cut_version.py <patch|minor|major|X.Y.Z>` bumps the version in all
-five files that carry it, turns the `upcoming.md` changelog and release notes into
-that version's files, commits and tags. Pushing the tag publishes the release to
+five files that carry it, combines the waiting changelog and release-note entries
+into that version's files, commits and tags. Each change adds its entries as its
+own file in `docs/changelogs/upcoming/` and `docs/release-notes/upcoming/`, named
+after its work item, so changes finished on separate branches never edit the same
+file. Pushing the tag publishes the release to
 PyPI. Details, including the one-time PyPI setup, are in
 [`docs/releasing.md`](docs/releasing.md).
 

tcw_cli-2.6.4/tests/test_cut_version.py

@@ -0,0 +1,236 @@
+import importlib.util
+import subprocess
+from pathlib import Path
+
+import pytest
+
+SCRIPT = Path(__file__).resolve().parent.parent / "scripts" / "cut_version.py"
+
+
+def _load():
+    spec = importlib.util.spec_from_file_location("cut_version", SCRIPT)
+    mod = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(mod)
+    return mod
+
+
+cv = _load()
+
+
+README = "# Upcoming entries\n\nDrafting guidance for whoever writes an entry.\n"
+
+
+def make_repo(tmp_path: Path, version: str = "0.2.2") -> Path:
+    root = tmp_path / "repo"
+    (root / ".claude-plugin").mkdir(parents=True)
+    (root / ".codex-plugin").mkdir(parents=True)
+    (root / "tcw").mkdir()
+    (root / "docs" / "changelogs" / "upcoming").mkdir(parents=True)
+    (root / "docs" / "release-notes" / "upcoming").mkdir(parents=True)
+    (root / "pyproject.toml").write_text(f'[project]\nname = "tcw"\nversion = "{version}"\n')
+    (root / "tcw" / "__init__.py").write_text(f'__version__ = "{version}"\n')
+    (root / ".claude-plugin" / "plugin.json").write_text(f'{{\n  "version": "{version}"\n}}\n')
+    (root / ".claude-plugin" / "marketplace.json").write_text(
+        f'{{\n  "plugins": [\n    {{\n      "version": "{version}"\n    }}\n  ]\n}}\n')
+    (root / ".codex-plugin" / "plugin.json").write_text(f'{{\n  "version": "{version}"\n}}\n')
+    for kind in ("changelogs", "release-notes"):
+        (root / f"docs/{kind}/upcoming/README.md").write_text(README)
+    (root / "docs/changelogs/upcoming/a.md").write_text("## Added\n\n- changelog entry\n")
+    (root / "docs/release-notes/upcoming/a.md").write_text("## Improvements\n\n- release note\n")
+    subprocess.run(["git", "init", "-q", str(root)], check=True)
+    subprocess.run(["git", "-C", str(root), "config", "user.email", "t@t"], check=True)
+    subprocess.run(["git", "-C", str(root), "config", "user.name", "t"], check=True)
+    subprocess.run(["git", "-C", str(root), "add", "-A"], check=True)
+    subprocess.run(["git", "-C", str(root), "commit", "-qm", "init"], check=True)
+    return root
+
+
+def test_next_version_increments():
+    assert cv.next_version("0.2.2", "patch") == "0.2.3"
+    assert cv.next_version("0.2.2", "minor") == "0.3.0"
+    assert cv.next_version("0.2.2", "major") == "1.0.0"
+    assert cv.next_version("0.2.2", "1.5.0") == "1.5.0"      # explicit passthrough
+
+
+def test_next_version_invalid():
+    with pytest.raises(SystemExit):
+        cv.next_version("0.2.2", "bogus")
+
+
+def test_current_version_reads_and_detects_drift(tmp_path):
+    root = make_repo(tmp_path, "0.2.2")
+    assert cv.current_version(root) == "0.2.2"
+    (root / "tcw" / "__init__.py").write_text('__version__ = "9.9.9"\n')   # introduce drift
+    with pytest.raises(SystemExit):
+        cv.current_version(root)
+
+
+def test_bump_files_updates_all_five(tmp_path):
+    root = make_repo(tmp_path, "0.2.2")
+    cv.bump_files(root, "0.2.2", "0.2.3")
+    assert cv.current_version(root) == "0.2.3"
+
+
+def _git_out(root: Path, *args: str) -> str:
+    return subprocess.run(["git", "-C", str(root), *args],
+                          capture_output=True, text=True, check=True).stdout
+
+
+def _entries(root: Path, kind: str, files: dict[str, str]) -> None:
+    """Replace the fixture's entry files in `docs/<kind>/upcoming/` with `files`."""
+    folder = root / "docs" / kind / "upcoming"
+    for p in folder.glob("*.md"):
+        if p.name != "README.md":
+            p.unlink()
+    for name, text in files.items():
+        (folder / name).write_text(text, encoding="utf-8")
+    subprocess.run(["git", "-C", str(root), "add", "-A"], check=True)
+    subprocess.run(["git", "-C", str(root), "commit", "-qm", "entries"], check=True)
+
+
+def _headings(text: str) -> list[str]:
+    return [line for line in text.splitlines() if line.startswith("## ")]
+
+
+def _assert_cut_is_clean(root: Path, version: str) -> None:
+    """Every entry file is gone, the guidance stays, and the cut is committed and tagged."""
+    for kind in ("changelogs", "release-notes"):
+        folder = root / "docs" / kind / "upcoming"
+        assert sorted(p.name for p in folder.iterdir()) == ["README.md"]
+        assert (folder / "README.md").read_text() == README
+    assert f"v{version}" in _git_out(root, "tag").split()
+    assert _git_out(root, "log", "-1", "--pretty=%s").strip() == f"chore(release): cut v{version}"
+    assert _git_out(root, "status", "--porcelain") == ""
+
+
+def test_main_end_to_end(tmp_path):
+    root = make_repo(tmp_path, "0.2.2")
+    cv.main(["patch"], root=root)
+    assert cv.current_version(root) == "0.2.3"
+    assert (root / "docs/changelogs/v0.2.3.md").read_text() == "# v0.2.3\n\n## Added\n\n- changelog entry\n"
+    assert (root / "docs/release-notes/v0.2.3.md").read_text() == "# v0.2.3\n\n## Improvements\n\n- release note\n"
+    _assert_cut_is_clean(root, "0.2.3")
+
+
+def test_combine_merges_sections_by_heading(tmp_path):
+    root = make_repo(tmp_path, "0.2.2")
+    _entries(root, "changelogs", {
+        "a.md": "## Fixed\n\n- a fixed\n\n## Added\n\n- a added\n",
+        "b.md": "## Added\n\n- b added\n\n## Security\n\n- b security\n",
+    })
+    cv.main(["patch"], root=root)
+    shipped = (root / "docs/changelogs/v0.2.3.md").read_text()
+    assert shipped.startswith("# v0.2.3\n")
+    assert _headings(shipped) == ["## Added", "## Fixed", "## Security"]
+    assert shipped.index("- a added") < shipped.index("- b added") < shipped.index("## Fixed")
+    assert "Drafting guidance" not in shipped
+    _assert_cut_is_clean(root, "0.2.3")
+
+
+def test_combine_with_no_entries_ships_only_the_title(tmp_path):
+    root = make_repo(tmp_path, "0.2.2")
+    _entries(root, "changelogs", {})
+    _entries(root, "release-notes", {})
+    cv.main(["patch"], root=root)
+    for kind in ("changelogs", "release-notes"):
+        assert (root / f"docs/{kind}/v0.2.3.md").read_text() == "# v0.2.3\n"
+    _assert_cut_is_clean(root, "0.2.3")
+
+
+def test_subheadings_stay_under_their_section(tmp_path):
+    root = make_repo(tmp_path, "0.2.2")
+    _entries(root, "changelogs", {
+        "a.md": "## Added\n\n- a added\n",
+        "b.md": "## Added\n\n- b added\n\n### Detail\n\n- b detail\n\n## Fixed\n\n- b fixed\n",
+    })
+    cv.main(["patch"], root=root)
+    shipped = (root / "docs/changelogs/v0.2.3.md").read_text()
+    assert shipped.index("- b added") < shipped.index("### Detail") < shipped.index("## Fixed")
+
+
+def test_release_notes_keep_first_appearance_order(tmp_path):
+    root = make_repo(tmp_path, "0.2.2")
+    _entries(root, "release-notes", {
+        "a.md": "## Zeta\n\n- a zeta\n",
+        "b.md": "## Alpha\n\n- b alpha\n\n## Zeta\n\n- b zeta\n",
+    })
+    cv.main(["patch"], root=root)
+    shipped = (root / "docs/release-notes/v0.2.3.md").read_text()
+    assert _headings(shipped) == ["## Zeta", "## Alpha"]
+    assert shipped.index("- a zeta") < shipped.index("- b zeta") < shipped.index("## Alpha")
+
+
+def test_text_before_the_first_heading_follows_the_title(tmp_path):
+    root = make_repo(tmp_path, "0.2.2")
+    _entries(root, "changelogs", {
+        "a.md": "## Added\n\n- a added\n",
+        "b.md": "A loose paragraph.\n",
+    })
+    cv.main(["patch"], root=root)
+    shipped = (root / "docs/changelogs/v0.2.3.md").read_text()
+    assert shipped.startswith("# v0.2.3\n\nA loose paragraph.\n")
+    assert shipped.index("A loose paragraph.") < shipped.index("## Added")
+
+
+def test_readme_guidance_never_ships(tmp_path):
+    """The folder's README.md is addressed to whoever writes an entry, not to
+    whoever reads the release, so the cut must neither ship nor consume it —
+    the same reason the old rotation dropped the `upcoming.md` preamble."""
+    root = make_repo(tmp_path, "0.2.2")
+    cv.main(["minor"], root=root)
+    for kind in ("changelogs", "release-notes"):
+        assert "Drafting guidance" not in (root / f"docs/{kind}/v0.3.0.md").read_text()
+    _assert_cut_is_clean(root, "0.3.0")
+
+
+def test_a_missing_upcoming_folder_aborts_before_anything_changes(tmp_path):
+    root = make_repo(tmp_path, "0.2.2")
+    subprocess.run(["git", "-C", str(root), "rm", "-rqf", "docs/release-notes/upcoming"], check=True)
+    subprocess.run(["git", "-C", str(root), "commit", "-qm", "drop"], check=True)
+    with pytest.raises(SystemExit, match="docs/release-notes/upcoming"):
+        cv.main(["patch"], root=root)
+    assert cv.current_version(root) == "0.2.2"
+    assert _git_out(root, "status", "--porcelain") == ""
+
+
+@pytest.mark.parametrize("state", ["edited", "untracked"])
+def test_an_uncommitted_entry_ships_rather_than_breaking_the_cut(tmp_path, state):
+    """`git rm` refuses a tracked file with local edits and an untracked one;
+    the cut used to fail after rewriting the version files, leaving no commit."""
+    root = make_repo(tmp_path, "0.2.2")
+    folder = root / "docs/changelogs/upcoming"
+    if state == "edited":
+        (folder / "a.md").write_text("## Added\n\n- changelog entry\n- edited late\n")
+    else:
+        (folder / "b.md").write_text("## Fixed\n\n- written late\n")
+    cv.main(["patch"], root=root)
+    shipped = (root / "docs/changelogs/v0.2.3.md").read_text()
+    assert ("- edited late" if state == "edited" else "- written late") in shipped
+    _assert_cut_is_clean(root, "0.2.3")
+
+
+def test_a_heading_with_no_entries_is_dropped(tmp_path):
+    root = make_repo(tmp_path, "0.2.2")
+    _entries(root, "changelogs", {
+        "a.md": "## Added\n\n- a added\n\n## Changed\n\n## Fixed\n",
+        "b.md": "## Fixed\n",
+    })
+    cv.main(["patch"], root=root)
+    shipped = (root / "docs/changelogs/v0.2.3.md").read_text()
+    assert _headings(shipped) == ["## Added"]
+
+
+def test_files_the_cut_does_not_combine_are_named(tmp_path, capsys):
+    root = make_repo(tmp_path, "0.2.2")
+    folder = root / "docs/changelogs/upcoming"
+    (folder / "note.txt").write_text("stray\n")
+    (folder / "sub").mkdir()
+    (folder / "sub" / "x.md").write_text("## Added\n\n- nested\n")
+    subprocess.run(["git", "-C", str(root), "add", "-A"], check=True)
+    subprocess.run(["git", "-C", str(root), "commit", "-qm", "strays"], check=True)
+    cv.main(["patch"], root=root)
+    err = capsys.readouterr().err
+    assert "docs/changelogs/upcoming/note.txt" in err
+    assert "docs/changelogs/upcoming/sub" in err
+    assert "- nested" not in (root / "docs/changelogs/v0.2.3.md").read_text()
+    assert (folder / "note.txt").exists() and (folder / "sub" / "x.md").exists()

{tcw_cli-2.6.3 → tcw_cli-2.6.4}/tests/test_repo_lifecycle.py

@@ -102,8 +102,8 @@ def test_this_repos_documentation_entries_parse():
         "README.md",
         "docs/guide/jira.md",
         "docs/guide/<topic>.md",
-        "docs/release-notes/upcoming.md",
-        "docs/changelogs/upcoming.md",
+        "docs/release-notes/upcoming/<slug>.md",
+        "docs/changelogs/upcoming/<slug>.md",
         "skills/<component>/SKILL.md",
         "skills/configure/references/<document>.md",
     ]

tcw_cli-2.6.3/tcw/__init__.py

@@ -1 +0,0 @@
-__version__ = "2.6.3"

tcw_cli-2.6.3/tests/test_cut_version.py

@@ -1,116 +0,0 @@
-import importlib.util
-import subprocess
-from pathlib import Path
-
-import pytest
-
-SCRIPT = Path(__file__).resolve().parent.parent / "scripts" / "cut_version.py"
-
-
-def _load():
-    spec = importlib.util.spec_from_file_location("cut_version", SCRIPT)
-    mod = importlib.util.module_from_spec(spec)
-    spec.loader.exec_module(mod)
-    return mod
-
-
-cv = _load()
-
-
-def make_repo(tmp_path: Path, version: str = "0.2.2") -> Path:
-    root = tmp_path / "repo"
-    (root / ".claude-plugin").mkdir(parents=True)
-    (root / ".codex-plugin").mkdir(parents=True)
-    (root / "tcw").mkdir()
-    (root / "docs" / "changelogs").mkdir(parents=True)
-    (root / "docs" / "release-notes").mkdir(parents=True)
-    (root / "pyproject.toml").write_text(f'[project]\nname = "tcw"\nversion = "{version}"\n')
-    (root / "tcw" / "__init__.py").write_text(f'__version__ = "{version}"\n')
-    (root / ".claude-plugin" / "plugin.json").write_text(f'{{\n  "version": "{version}"\n}}\n')
-    (root / ".claude-plugin" / "marketplace.json").write_text(
-        f'{{\n  "plugins": [\n    {{\n      "version": "{version}"\n    }}\n  ]\n}}\n')
-    (root / ".codex-plugin" / "plugin.json").write_text(f'{{\n  "version": "{version}"\n}}\n')
-    (root / "docs/changelogs/upcoming.md").write_text("# Upcoming\n\nchangelog entries here\n")
-    (root / "docs/release-notes/upcoming.md").write_text("# Upcoming\n\nrelease notes here\n")
-    subprocess.run(["git", "init", "-q", str(root)], check=True)
-    subprocess.run(["git", "-C", str(root), "config", "user.email", "t@t"], check=True)
-    subprocess.run(["git", "-C", str(root), "config", "user.name", "t"], check=True)
-    subprocess.run(["git", "-C", str(root), "add", "-A"], check=True)
-    subprocess.run(["git", "-C", str(root), "commit", "-qm", "init"], check=True)
-    return root
-
-
-def test_next_version_increments():
-    assert cv.next_version("0.2.2", "patch") == "0.2.3"
-    assert cv.next_version("0.2.2", "minor") == "0.3.0"
-    assert cv.next_version("0.2.2", "major") == "1.0.0"
-    assert cv.next_version("0.2.2", "1.5.0") == "1.5.0"      # explicit passthrough
-
-
-def test_next_version_invalid():
-    with pytest.raises(SystemExit):
-        cv.next_version("0.2.2", "bogus")
-
-
-def test_current_version_reads_and_detects_drift(tmp_path):
-    root = make_repo(tmp_path, "0.2.2")
-    assert cv.current_version(root) == "0.2.2"
-    (root / "tcw" / "__init__.py").write_text('__version__ = "9.9.9"\n')   # introduce drift
-    with pytest.raises(SystemExit):
-        cv.current_version(root)
-
-
-def test_bump_files_updates_all_five(tmp_path):
-    root = make_repo(tmp_path, "0.2.2")
-    cv.bump_files(root, "0.2.2", "0.2.3")
-    assert cv.current_version(root) == "0.2.3"
-
-
-def test_main_end_to_end(tmp_path):
-    root = make_repo(tmp_path, "0.2.2")
-    cv.main(["patch"], root=root)
-    assert cv.current_version(root) == "0.2.3"
-    # old upcoming content rotated into the versioned files, retitled to the
-    # version it shipped as. Rotation used to be a bare `git mv`, so a released
-    # document kept the `# Upcoming` placeholder it was drafted under.
-    assert (root / "docs/changelogs/v0.2.3.md").read_text() == "# v0.2.3\n\nchangelog entries here\n"
-    assert (root / "docs/release-notes/v0.2.3.md").read_text() == "# v0.2.3\n\nrelease notes here\n"
-    # fresh upcoming.md reset (header kept, old entries gone)
-    fresh = (root / "docs/changelogs/upcoming.md").read_text()
-    assert "# Upcoming" in fresh and "changelog entries here" not in fresh
-    # commit + tag
-    tags = subprocess.run(["git", "-C", str(root), "tag"], capture_output=True, text=True).stdout
-    assert "v0.2.3" in tags
-    msg = subprocess.run(["git", "-C", str(root), "log", "-1", "--pretty=%s"],
-                         capture_output=True, text=True).stdout.strip()
-    assert msg == "chore(release): cut v0.2.3"
-    # everything the cut touched is *in* the commit — the retitle above used to
-    # be left unstaged, so the tag pointed at a file still titled "# Upcoming".
-    dirty = subprocess.run(["git", "-C", str(root), "status", "--porcelain"],
-                           capture_output=True, text=True).stdout
-    assert dirty == "", f"cut left uncommitted changes:\n{dirty}"
-
-
-def test_rotation_drops_the_working_file_preamble(tmp_path):
-    """A shipped release note must not carry the drafting instructions.
-
-    The `upcoming.md` header says the file is "for the next version" and tells
-    its *author* to use plain language — text addressed to whoever writes the
-    notes, not to whoever reads the release. Retitling `# Upcoming` alone left
-    that preamble in every published file from v0.6.2 through v1.0.0.
-    """
-    root = make_repo(tmp_path, "0.2.2")
-    # The real templates the script recreates, not the fixture's short stand-in.
-    for rel, header in cv.UPCOMING.items():
-        (root / rel).write_text(header + "\n## Added\n\n- a thing\n", encoding="utf-8")
-    subprocess.run(["git", "-C", str(root), "commit", "-aqm", "real headers"], check=True)
-
-    cv.main(["minor"], root=root)
-
-    for rel in cv.UPCOMING:
-        shipped = (root / rel).with_name("v0.3.0.md").read_text(encoding="utf-8")
-        assert shipped.startswith("# v0.3.0\n"), shipped[:40]
-        assert "for the next version" not in shipped
-        assert "## Added" in shipped and "- a thing" in shipped
-        # the fresh working file keeps its preamble — it is drafting guidance
-        assert "for the next version" in (root / rel).read_text(encoding="utf-8")