Fix release progress panel truncating failed commands (#7)

* Fix release progress panel truncating failed commands

The release progress panel could truncate long commands due to
panel width constraints. Now the full failed command is printed
below the panel using soft_wrap=True for user reference and
retry purposes.

Changes:
- Add update_command() method to StepTracker to update command
  strings after initial registration
- In publish_release(), update the "publish" step with the full
  gh command using shlex.join() after it's fully constructed
- In _render_release_progress(), print the full failed command
  below the panel with soft_wrap=True to prevent truncation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Add changelog entry for release progress panel fix

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Fix release retry command rendering with bracketed args

* Remove stale DEVELOPMENT.md package reference

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: mavam

changelog/unreleased/fix-release-progress-panel-truncating-failed-commands.md

@@ -0,0 +1,13 @@
+---
+title: Fix release progress panel truncating failed commands
+type: bugfix
+authors:
+  - mavam
+  - claude
+pr: 7
+created: 2026-02-15T10:29:09.765161Z
+---
+
+When a release step fails, the full command now prints below the progress panel so you can copy-paste it for manual recovery.
+
+Previously, long commands would get truncated in the release progress panel, making it difficult to reproduce the failure manually. Now when a step fails, the complete command is displayed in full below the panel, giving you what you need to debug and retry the operation.

pyproject.toml

@@ -52,7 +52,6 @@ include = [
   "/src/**/*",
   "/tests",
   "/README.md",
-  "/DEVELOPMENT.md",
   "/LICENSE",
   "/changelog",
   "/pyproject.toml",

src/tenzir_ship/cli/_release.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import shlex
 import shutil
 import subprocess
 from dataclasses import dataclass, field
@@ -13,6 +14,7 @@
 import click
 from click.core import ParameterSource
 from packaging.version import InvalidVersion, Version
+from rich.markup import escape
 from rich.panel import Panel
 from rich.table import Table
 from rich.text import Text
@@ -30,6 +32,7 @@
 )
 from ..utils import (
     abort_on_user_interrupt,
+    console,
     create_annotated_git_tag,
     create_git_commit,
     emit_output,
@@ -109,6 +112,12 @@ def fail(self, name: str) -> None:
             if step.name == name:
                 step.status = StepStatus.FAILED
 
+    def update_command(self, name: str, command: str) -> None:
+        """Update the command string for a step."""
+        for step in self.steps:
+            if step.name == name:
+                step.command = command
+
 
 def _render_release_progress(tracker: StepTracker) -> None:
     """Render release progress summary to stderr on failure."""
@@ -120,22 +129,28 @@ def _render_release_progress(tracker: StepTracker) -> None:
     for step in tracker.steps:
         if step.status == StepStatus.COMPLETED:
             icon = "[green]\u2714[/green]"
-            cmd = f"[dim]{step.command}[/dim]"
+            cmd = f"[dim]{escape(step.command)}[/dim]"
         elif step.status == StepStatus.FAILED:
             icon = "[red]\u2718[/red]"
-            cmd = f"[red]{step.command}[/red]"
+            cmd = f"[red]{escape(step.command)}[/red]"
         elif step.status == StepStatus.SKIPPED:
             continue  # Don't show skipped steps
         else:  # PENDING
             icon = "[dim]\u25cb[/dim]"
-            cmd = f"[dim]{step.command}[/dim]"
+            cmd = f"[dim]{escape(step.command)}[/dim]"
         lines.append(f"{icon} {cmd}")
 
     if lines:
         content = Text.from_markup("\n".join(lines))
         title = f"Release Progress ({progress})"
         _print_renderable(Panel(content, title=title, border_style="red"))
 
+    for step in tracker.steps:
+        if step.status == StepStatus.FAILED:
+            console.print()
+            console.print("[bold]To retry the failed step, run:[/bold]", highlight=False)
+            console.print(f"  {step.command}", highlight=False, markup=False, soft_wrap=True)
+
 
 __all__ = [
     "create_release",
@@ -671,6 +686,8 @@ def _fail_step_and_raise(step_name: str, exc: Exception) -> NoReturn:
             command.append("--latest=false")
         confirmation_action = "gh release create"
 
+    tracker.update_command("publish", shlex.join(command))
+
     if not assume_yes:
         prompt_question = f"Publish {manifest.version} to GitHub repository {config.repository}?"
         log_info(prompt_question.lower())

tests/test_cli.py

@@ -1883,6 +1883,84 @@ def fake_run(
     assert commands[0][:3] == ["/usr/bin/gh", "release", "view"]
 
 
+def test_release_publish_retry_hint_preserves_bracketed_title(
+    monkeypatch: pytest.MonkeyPatch, tmp_path: Path
+) -> None:
+    runner = CliRunner()
+    project_dir = tmp_path / "project"
+    project_dir.mkdir()
+
+    add_entry = runner.invoke(
+        cli,
+        [
+            "--root",
+            str(project_dir),
+            "add",
+            "--title",
+            "Retry Hint Test",
+            "--type",
+            "feature",
+            "--description",
+            "Ensures retry hint output is copy-paste safe.",
+            "--author",
+            "codex",
+        ],
+    )
+    assert add_entry.exit_code == 0, add_entry.output
+
+    create_release = runner.invoke(
+        cli,
+        [
+            "--root",
+            str(project_dir),
+            "release",
+            "create",
+            "v3.1.0",
+            "--title",
+            "[LTS] Stable",
+            "--yes",
+        ],
+    )
+    assert create_release.exit_code == 0, create_release.output
+
+    config_path = project_dir / "config.yaml"
+    config_data = yaml.safe_load(config_path.read_text(encoding="utf-8"))
+    config_data["repository"] = "tenzir/example"
+    config_path.write_text(yaml.safe_dump(config_data, sort_keys=False), encoding="utf-8")
+
+    def fake_which(command: str) -> str:
+        assert command == "gh"
+        return "/usr/bin/gh"
+
+    def fake_run(
+        args: list[str], *, check: bool, stdout: object = None, stderr: object = None
+    ) -> None:
+        if len(args) >= 3 and args[1:3] == ["release", "view"]:
+            raise subprocess.CalledProcessError(returncode=1, cmd=args)
+        if len(args) >= 3 and args[1:3] == ["release", "create"]:
+            raise subprocess.CalledProcessError(returncode=23, cmd=args)
+        raise AssertionError(f"Unexpected command: {args}")
+
+    monkeypatch.setattr("tenzir_ship.cli._release.shutil.which", fake_which)
+    monkeypatch.setattr("tenzir_ship.cli._release.subprocess.run", fake_run)
+
+    publish_result = runner.invoke(
+        cli,
+        [
+            "--root",
+            str(project_dir),
+            "release",
+            "publish",
+            "v3.1.0",
+            "--yes",
+        ],
+    )
+    assert publish_result.exit_code != 0
+    plain_output = click.utils.strip_ansi(publish_result.output)
+    assert "To retry the failed step, run:" in plain_output
+    assert "--title '[LTS] Stable'" in plain_output
+
+
 def test_release_publish_updates_existing_release(
     monkeypatch: pytest.MonkeyPatch, tmp_path: Path
 ) -> None: