docs: correct snapshot restore selector guidance

[miyoungc]

Summary

The snapshot restore guide previously described timestamp prefixes, but selector resolution accepts only exact timestamps.
This change tells readers to copy the exact timestamp from snapshot list and provides an exact-timestamp example.

Related Issue

Fixes #8217

Changes

• Correct the snapshot selector description to require an exact version, name, or timestamp.
• Replace the timestamp-prefix command with an exact timestamp from snapshot list.

Type of Change

• Code change (feature, bug fix, or refactor)
• Code change with doc updates
• Doc only (prose changes, no code sample modifications)
• Doc only (includes code sample changes)

Quality Gates

• Tests added or updated for changed behavior
• Existing tests cover changed behavior — justification:
• Tests not applicable — justification: This documentation-only change aligns the guide with existing exact-selector behavior and tests.
• Docs updated for user-facing behavior changes
• Docs not applicable — justification:
• Sensitive paths changed (security, policy, credentials, preflight, onboarding, inference, runner, sandbox, or messaging)
• Sensitive-path review completed or maintainer-approved waiver recorded — reviewer/approval link/justification:
• Non-success, skipped, or missing CI check accepted by maintainer — check name, approval link, and follow-up issue:

Documentation Writer Review

• Documentation writer subagent reviewed the completed changes
• Result: docs-updated
• Evidence: Updated docs/manage-sandboxes/backup-restore.mdx. Reviewed this documentation-only change at exact head 0bb2734b010f91ac7f0ef1ec0a57fca2f9351071 against base 5fe23192a6fe378537fc2730c081730bc3ff72b9 under the repository writing and documentation contracts. The exact-only timestamp claim matches src/lib/state/sandbox.ts and test/snapshot.test.ts; all three generated guide variants contain the corrected instruction and variant-specific CLI command. The external merge changed no effective documentation content; stable patch ID 1ec62081ec1d90f51545f4cdc7976ebfb9a0125d is unchanged. At this exact head, npm run docs passed with 0 errors and 2 known warnings, npm run validate:pr passed, and git diff --check passed.
• Agent: Codex Desktop

DGX Station Hardware Evidence

• Tested on DGX Station
• Tested commit:
• Station profile/scenario:
• Result:
• Supporting evidence:

Verification

• PR description includes a Signed-off-by: line and every commit appears as Verified in GitHub
• Normal pre-commit, commit-msg, and pre-push hooks passed, or npm run validate:pr passed after refreshing origin/main when hooks were skipped or unavailable
• Targeted behavior tests pass for the current change set, or tests are marked not applicable above — command/result or justification: Tests are not applicable to this documentation-only correction.
• Applicable broad gate passed — npm test for broad runtime/test-harness changes; npm run check for repo-wide validation/coverage changes — command/result:
• Quality Gates section completed with required justifications or waivers
• No secrets, API keys, or credentials committed
• npm run docs builds without warnings (doc changes only) — 0 errors and 2 baseline warnings.
• Doc pages follow the style guide (doc changes only)
• New doc pages include SPDX header and frontmatter (new pages only)

---

Signed-off-by: Miyoung Choi miyoungc@nvidia.com

Summary by CodeRabbit

• Documentation
  • Updated snapshot restore guidance to require an exact snapshot version, name, or timestamp.
  • Clarified that partial timestamp prefixes are no longer accepted.

[coderabbitai]

📝 Walkthrough

Walkthrough

The snapshot restore guide now requires an exact version, name, or complete timestamp. The timestamp-prefix example and wording were removed.

Changes

Snapshot restore documentation

Layer / File(s)	Summary
Document exact restore selectors docs/manage-sandboxes/backup-restore.mdx	The guide now documents exact version, name, or complete timestamp selectors. It no longer documents timestamp prefixes.

Estimated code review effort: 1 (Trivial) | ~2 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The documentation requires exact selectors and provides an exact-timestamp example, satisfying issue #8217.
Out of Scope Changes check	✅ Passed	The changes are limited to the snapshot restore documentation and align with issue #8217.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely describes the documentation change to snapshot restore selector guidance.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/docs-fix-8217

---

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

🌿 Preview your docs: https://nvidia-preview-pr-8254.docs.buildwithfern.com/nemoclaw

[github-actions]

PR Review Advisor — No blocking findings reported

Advisor assessment: No blocking advisor findings reported
Next action: No advisor follow-up needed.
Findings: 0 blockers · 0 warnings · 0 suggestions

Model lanes

• GPT-5.6 Terra (primary): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions
• Nemotron 3 Ultra (second opinion): Completed · high confidence · 0 blockers · 0 warnings · 0 suggestions
• Model comparison: normalized findings match; normalized terminology decisions differ; normalized E2E selections differ; severity counts match.

Second-opinion terminology and E2E selections are advisory. They do not change the primary assessment or E2E / PR Gate.

1 semantic terminology decision

Terminology decisions are advisory. They affect the assessment only when a separate finding identifies concrete semantic impact.

• established — exact timestamp at docs/manage-sandboxes/backup-restore.mdx:118: Use `exact timestamp` for this selector requirement.

E2E guidance

Advisory only. E2E / PR Gate selects and runs jobs independently.

Recommended E2E: None

2 optional E2E recommendations

• snapshot-commands
• state-backup-restore

Workflow run details

This automated review informs maintainers. Warnings and suggestions do not require a response. A maintainer decides whether to merge.

[senthilr-nv]

Reviewed at 0bb2734: the exact-selector guidance matches the implementation and regression coverage, focused validation passes, and required checks pass.