Enforces atomic writes, locking, validation and backups for JSON state files.
npx skills add https://github.com/calcosmic/Aether --skill state-safety
Please help me install this Agent Skill. Skill: state-safety Source: https://github.com/calcosmic/Aether/tree/main/.aether/skills-codex/colony/state-safety Command: npx skills add https://github.com/calcosmic/Aether --skill state-safety
State files used by the colony can become corrupted or lost during unexpected shutdowns or concurrent updates. This skill teaches safe handling of critical JSON state files to prevent data loss and ensure recoverability.
Enable atomic writes and locking across state files and perform a backup after every successful write.
High-intent search queries and answers about installing and using this skill.
To prevent JSON file corruption during concurrent writes, use file locking to acquire exclusive access before modifying state files, ensuring multiple processes do not overwrite each other's changes and avoiding race conditions.
JSON state files get truncated after unexpected shutdowns because standard writes save partial data. Atomic writes solve this by writing to a temporary file first, then renaming it to the target only after completion, preventing partial saves.
You can validate JSON state and restore from backups automatically by performing post-write validation immediately after saving. If the resulting JSON fails validation, the system restores the file from a single valid backup to ensure reliable recovery.
The best way to handle read-time corruption checks for state files is to verify files exist, are non-empty, and parse correctly before reading. If these checks fail, fall back to backups to maintain state integrity and ensure recoverability.
Atomic write file locking works across multiple processes by acquiring a lock before modifying shared JSON state files like COLONY_STATE.json or session.json. This guarded mutation approach prevents race conditions and ensures safe concurrent access.
tinkermonkeyDefine and validate object data structures using JSON Schema Draft 7.
calcosmicAnalyze failed colony workflows to produce forensic reports with root causes.
batuhanysvPersist agent progress to JSON and resume from saved checkpoints.
somachakIdentify race conditions, deadlocks, and concurrency bugs in backend code.
