Purpose
-------
Integration tests for ``oct git restore`` (L3).
Responsibilities
----------------
- Verify ``oct git restore <path>`` reverts unstaged working-tree
edits.
- Verify ``oct git restore --staged <path>`` unstages from the index
without touching the working tree.
- Verify ``--all`` enumerates in-scope paths.
- Verify the confirmation prompt for ``--staged --all`` (and
``--yes`` bypass).
- Verify path-scope filtering (paths outside the project root are
skipped) and JSON output.
Diagnostics
-----------
Domain: GIT-TESTS
Levels:
L2 -- test lifecycle
L3 -- assertion details
Contracts
---------
- All tests use subprocess invocation against ``oct.cli``.
- All tests use tmp_path fixtures so they are automatically cleaned up.