steam-backlog-enforcer/steam_backlog_enforcer/main/repair_ghosts.py
Krzysztof kuhy Rudnicki 94a0e8a1c3 Add map-installed Proton map view and apply job
GET /api/compat serves every installed game's compat-tool decision as
rows from the installer's own code (steam_installer/compat_rows.py, the
rows --map-installed now logs from), cached by file stats. The Library
page gets a Proton map view (sortable, filterable, fuzzy search, hash
state, 30 s poll) and a map-installed job: POST checks the ids, the
phrase "map N games" and the game-running guard; the job re-checks
them and streams --map-installed --apply --yes --appids.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WzxdWZCxnNWLtpVwFLVk9w
2026-11-22 21:43:23 +01:00

53 lines
2.0 KiB
Python

"""``repair-ghosts``: the installer's ``--repair-ghosts``, behind friction.
The installer renames each cold ghost manifest (one that claims "installed"
with nothing on disk) and removes its empty folder; a ghost with staged bytes
is reported and kept. It does not close Steam itself, but it rewrites the
library under a client that may be reading it, so it waits like ``install``
does until no game is running. The web server checks the phrase and the guard
before a job exists (``_web_jobs``); this re-checks both inside the job.
"""
from __future__ import annotations
from typing import TYPE_CHECKING
from steam_backlog_enforcer._desktop_env import resolve_desktop_user
from steam_backlog_enforcer._fast_install_cmd import (
build_repair_ghosts_cmd,
installer_path,
)
from steam_backlog_enforcer._prompter import PromptAbortedError, confirm_phrase
from steam_backlog_enforcer._steam_restart_guard import (
GAME_RUNNING_JOB_MSG,
game_is_running,
)
from steam_backlog_enforcer.jobs._errors import JobError
from steam_backlog_enforcer.main._install_target import (
relay_installer,
require_installer,
)
if TYPE_CHECKING:
from steam_backlog_enforcer.config import Config, State
def cmd_repair_ghosts(_config: Config, _state: State) -> None:
"""Delete the ghost manifests, after the guard and the typed phrase.
Raises:
JobError: ``game_running`` while a game runs; ``op_failed`` when the
installer is missing or exits non-zero.
PromptAbortedError: The phrase was not typed exactly.
"""
if game_is_running():
raise JobError(GAME_RUNNING_JOB_MSG, code="game_running")
if not confirm_phrase("repair-ghosts", "Delete the ghost install manifests?"):
msg = "Aborted."
raise PromptAbortedError(msg)
installer = require_installer(installer_path())
code = relay_installer(build_repair_ghosts_cmd(installer, resolve_desktop_user()))
if code:
msg = f"repair-ghosts failed (installer exit {code})."
raise JobError(msg, code="op_failed")