[codex] Add session-scoped backup layout#139
Merged
Merged
Conversation
5f2e735 to
c9d4b7d
Compare
- add session-scoped backup mirroring for pipeline, A2A, and REPL state - harden recovery paths and trusted read/session-owned directories - add real backup validation guide, translations, and coverage
c9d4b7d to
be65166
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds a session-scoped backup layout for durable
iac-coderuntime state. It consolidates session-owned artifacts under the v2 session directory and mirrors recoverable session state intoIAC_CODE_CONFIG_BACKUP_DIRat explicit key points, while keeping global credentials, settings, telemetry, logs, and shared A2A indexes out of the session backup path.Motivation
Pipeline, A2A, ACP, headless, and REPL flows can produce recoverable state in several places: transcripts, usage files, permission audit logs, tool results, image caches, pipeline sidecars, A2A snapshots, and artifacts. When the config directory is backed by a slow or remote filesystem, continuously writing everything to that mount is expensive. The new design keeps the active config local and copies only session-owned recoverable data to the configured backup directory at important durability boundaries.
What Changed
SessionBackupServiceto mirror recoverable session state intoIAC_CODE_CONFIG_BACKUP_DIR.Compatibility and Safety Notes
settings.yml,.credentials.yml,.cloud-credentials.yml, logs, telemetry, and shared A2A task/context indexes are not mirrored by session backup.Validation
Ran the full requested local validation sequence:
make format make lint make translate make testResults:
make format: completed successfullymake lint: ruff and ty passedmake translate: extraction, update, and compile passed for zh/es/fr/de/ja/ptmake test:7845 passed, 1 skipped, 307 warnings