github/spec-kit · error · OSError

Failed to write staged workflow file

Error message

Failed to write staged workflow file

What it means

Error "Failed to write staged workflow file" thrown in github/spec-kit.

Source

Thrown at src/specify_cli/workflows/_commands.py:578

    return dest_dir


class _StagedWorkflowFile:
    """Exclusive staging inode kept open until its atomic commit."""

    def __init__(self, path: Path, fd: int) -> None:
        self.path = path
        self.fd = fd

    def _write(self, chunks) -> None:
        os.lseek(self.fd, 0, os.SEEK_SET)
        os.ftruncate(self.fd, 0)
        for chunk in chunks:
            view = memoryview(chunk)
            while view:
                written = os.write(self.fd, view)
                if written <= 0:
                    raise OSError("Failed to write staged workflow file")
                view = view[written:]

    def write_bytes(self, data: bytes) -> None:
        self._write((data,))

    def verify_path(self) -> None:
        import stat

        try:
            path_stat = self.path.stat(follow_symlinks=False)
            open_stat = os.fstat(self.fd)
        except OSError as exc:
            raise OSError(
                "Staged workflow file changed before commit"
            ) from exc
        if (
            not stat.S_ISREG(path_stat.st_mode)
            or path_stat.st_dev != open_stat.st_dev

View on GitHub (pinned to bf88c9f9a8)

Solutions

1. Check filesystem permissions and free space on the staging directory, then retry.

When it happens

Trigger: Thrown at src/specify_cli/workflows/_commands.py:578 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/73bc6d6712e62d14. Report an issue: GitHub.