Fiw-Gentoo-Dots/docs/reports.md

Restoration reports

Every TUI apply action ends with one combined report, including failure and cancellation paths. It correlates the user's and root's steps by a generated run ID and the saved selection. Reports from other runs are kept separate.

The report includes:

• Completed, partial, failed, cancelled and not attempted steps.
• Confirmed present Portage packages and skipped or missing packages.
• Installed, existing, skipped or failed user Flatpaks.
• Enabled, missing or skipped service units.
• Applied configs, preserved conflicts and pending .new proposals.
• Boot deployment, backup restoration or config proposal acceptance outcome.
• Missing config requirements and selected manual setup steps.

A cancelled operation stops the full restore sequence. Completed earlier steps remain recorded; it does not undo their changes.

Combined reports live in ~/.local/state/Fiw-Gentoo-Dots/summary-RUN_ID.json. Each step also keeps its own local report. Existing detailed package and boot reports remain in /var/lib/Fiw-Gentoo-Dots.

Show a summary for the latest run matching a saved selection:

./install --selection local/selection.json --summary

For a command-line sequence, use the same explicit run ID for all steps:

sudo ./install --selection local/selection.json --run-id my-restore --install-packages
./install --selection local/selection.json --run-id my-restore --install-flatpaks
./install --selection local/selection.json --run-id my-restore --apply-configs
./install --selection local/selection.json --run-id my-restore --summary

Run the combined summary as your regular user. --workflow configs, packages, flatpaks, services, boot, backup or proposal limits the expected steps when summarizing one action. Full restoration is the default. Without an explicit ID, separate CLI apply commands are separate runs.