chronos-durability
Skill4 starsChanged yesterdayApache-2.0View on GitHub
Test AllSource Core event durability by writing events, restarting the container, and verifying all events survive. Proves WAL + Parquet persistence guarantees. Triggers on "test durability", "durability test", "restart test", "verify persistence", "crash recovery test", "prove events survive restart".
In this repository25 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- allsource-incident-statusSkill
- allsource-partnershipsSkill
- ritual-fullSkill
- ritualSkill
- semantic-isaSkill
- admin-healthSkill
- allsource-data-accessSkill
- allsource-debugSkill
- allsource-incident-statusSkill
- allsource-mcp-setupSkill
- allsource-onboardSkill
- chronos-data-flow-embeddedSkill
- chronos-data-flowSkill
- chronos-embedded-durabilitySkill
- chronos-releaseSkill
- fly-statusSkill
- mammoth-memorySkill
- ritual-fullSkill
- ritualSkill
- semantic-isaSkill
- seo-aeo-auditSkill
- allsource-customerSkill
- allsource-prime-memorySkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 15
Run the durability test script:
- Distinctive: line 27
Use appropriate flags based on context:
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Chronos Durability Test
Proves that events written to AllSource Core survive container restarts — the core durability guarantee of WAL + Parquet.
When invoked:
- Run the durability test script:
bash tooling/durability-test/test-durability.sh - Analyze the output and report:
- Whether all events were written successfully
- Pre-restart storage state (WAL, Parquet if available)
- Recovery time after restart
- Whether all events survived the restart (the money test)
- Post-restart storage state comparison
- Use appropriate flags based on context:
--target docker(default) — local Docker stack (Core on port 3280)--target compose— Docker compose with internal ports (Core on port 3900)--target fly— Fly.io deployment--count N— number of events to write (default: 10)--skip-restart— write and verify only, no restart cycle--json— machine-readable output
- For quick smoke tests (no restart needed):
bash tooling/durability-test/test-durability.sh --skip-restart
Test Phases
| Phase | What's Checked |
| Pre-flight | Core reachable, docker/fly CLI available, container exists |
| Baseline | Current event count via /api/v1/stats |
| Write | Ingest N events with unique durability-test-{timestamp} entity |
| Verify Write | Query back all events, confirm count matches |
| Storage Check | WAL status, storage stats, deep health (informational, may skip) |
| Restart | docker restart or fly machines restart |
| Recovery | Poll /health every 2s until back (timeout 60s) |
| Verify Durability | Query same events — ALL N must be present |
| Investigation | Post-restart stats, WAL status, deep health comparison |
Common Failure Patterns
- Events lost after restart: Volume not mounted or WAL disabled. Check
ALLSOURCE_WAL_ENABLED=trueand Docker volume mounts. - Partial recovery: WAL replay incomplete. May indicate crash during fsync interval. Check
ALLSOURCE_WAL_SYNC_INTERVAL_MS. - Recovery timeout: Container takes too long to start. Check Docker logs for WAL replay errors.
- Ops endpoints skip:
/api/v1/ops/*endpoints may not exist in all Core versions. This is informational only, not a failure.
Architecture Note
This test writes directly to Core (POST /api/v1/events) to eliminate the Query Service as a variable. Core IS the database — it has WAL (CRC32, fsync), Parquet (Snappy), and DashMap. Events are durable by design.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

