github/spec-kit · error · RuntimeError

Command rollback backup is missing for '{original_file}'

Error message

Command rollback backup is missing for '{original_file}'

What it means

Error "Command rollback backup is missing for '{original_file}'" thrown in github/spec-kit.

Source

Thrown at src/specify_cli/extensions/_commands.py:1702

                backup_file = Path(backup_path)
                symlink_state = backed_up_command_symlinks.get(
                    original_key
                )

                if symlink_state is not None:
                    if original_file.is_symlink() or original_file.is_file():
                        original_file.unlink()
                    elif original_file.exists():
                        raise RuntimeError(
                            "Command rollback found an unexpected directory "
                            f"at '{original_file}'"
                        )
                    original_file.parent.mkdir(parents=True, exist_ok=True)
                    os.symlink(symlink_state, original_file)
                    return

                if not backup_file.is_file() or backup_file.is_symlink():
                    raise RuntimeError(
                        "Command rollback backup is missing for "
                        f"'{original_file}'"
                    )
                if original_file.is_symlink() or original_file.is_file():
                    original_file.unlink()
                elif original_file.exists():
                    raise RuntimeError(
                        "Command rollback found an unexpected directory "
                        f"at '{original_file}'"
                    )
                original_file.parent.mkdir(parents=True, exist_ok=True)
                shutil.copy2(backup_file, original_file)

            def remember_absent_parent_dirs(artifact_path, root_dir):
                """Remember absent parents a failed renderer may create."""
                boundary = root_dir.parent
                if root_dir.is_relative_to(project_root):
                    boundary = project_root

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Restore the missing rollback backup for the file, or reinstall the extension to regenerate artifacts.

When it happens

Trigger: Thrown at src/specify_cli/extensions/_commands.py:1702 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of github/spec-kit@bf88c9f9a8 (2026-08-14). Data as JSON: /api/errors/516ccd5d181127ec. Report an issue: GitHub.