sx4im · Aug 9, 2026 · Aug 9, 2026
diff --git a/PROGRESS.md b/PROGRESS.md
@@ -72,3 +72,7 @@ All components of the monorepo are fully operational and verified:
 - **Typecheck**: Zero TypeScript compile errors (`tsc --noEmit` is clean).
 - **Lint**: Zero ESLint warnings or errors.
 - **Tests**: All 256 tests are passing.
+
+## Outreach (awesome lists)
+
+Ready-to-submit listing kit lives in [`docs/outreach/`](./docs/outreach/README.md) (entries, patches, PR bodies). Suggestion issues filed on the best-fit lists; external listing PRs need a human fork (GitHub App cannot fork).
diff --git a/REMAINING.md b/REMAINING.md
@@ -4,7 +4,8 @@ This document tracks any outstanding bugs, tasks, or issues remaining in the **C
 
 ## Outstanding Issues
 
-- **None.** No failing tests, compilation errors, lint findings, or outstanding `TODO`/`FIXME` comments.
+- **None** for code quality (tests/typecheck/lint/build).
+- **Outreach follow-ups (human):** from a personal GitHub account, open listing PRs using [`docs/outreach/`](./docs/outreach/README.md) patches (or wait for maintainers on the suggestion issues). Close accidental probe [dastergon/awesome-chaos-engineering#205](https://github.com/dastergon/awesome-chaos-engineering/issues/205). Wait for ~100 stars before Best of JS / awesome-nodejs.
 
 ## Code Quality Status
 

diff --git a/docs/outreach/README.md b/docs/outreach/README.md
@@ -0,0 +1,58 @@
+# Awesome-list & directory outreach
+
+Chronos visibility kit: ready-made entries, patches, and issue/PR copy for curated lists that fit Deterministic Simulation Testing, chaos/network simulation, and Vitest.
+
+The cloud agent GitHub App **cannot fork external repos**, so listing PRs must be opened from a personal account (`sx4im` or a maintainer). Use the patches below, or point maintainers at the suggestion issues.
+
+## Status (2026-08-09)
+
+| Target | Stars | Fit | Suggestion issue | Notes |
+|--------|------:|-----|------------------|-------|
+| [ivanyu/awesome-deterministic-simulation-testing](https://github.com/ivanyu/awesome-deterministic-simulation-testing) | ~370 | Best | [#9](https://github.com/ivanyu/awesome-deterministic-simulation-testing/issues/9) | Software section (after Antithesis alphabetically) |
+| [asatarin/testing-distributed-systems](https://github.com/asatarin/testing-distributed-systems) | ~2.6k | Excellent | [#24](https://github.com/asatarin/testing-distributed-systems/issues/24) | Tools / Deterministic Simulation |
+| [dastergon/awesome-chaos-engineering](https://github.com/dastergon/awesome-chaos-engineering) | ~6.6k | Strong | [#206](https://github.com/dastergon/awesome-chaos-engineering/issues/206) | Notable Tools (bottom of category). Please also close accidental probe [#205](https://github.com/dastergon/awesome-chaos-engineering/issues/205). |
+| [theanalyst/awesome-distributed-systems](https://github.com/theanalyst/awesome-distributed-systems) | ~12k | Good | [#69](https://github.com/theanalyst/awesome-distributed-systems/issues/69) | Verification of Distributed Systems |
+| [porada/awesome-vitest](https://github.com/porada/awesome-vitest) | ~36 | Good | [#44](https://github.com/porada/awesome-vitest/issues/44) | Integrations, alphabetical `@sx4im/chronos-vitest` |
+
+### Wait until ~100 stars
+
+| Target | Why wait |
+|--------|----------|
+| [sindresorhus/awesome-nodejs](https://github.com/sindresorhus/awesome-nodejs) | Requires **100+ stars** and 30+ days |
+| [michaelrambeau/bestofjs](https://github.com/michaelrambeau/bestofjs) (Best of JS) | Requires **100+ stars** |
+| [aharris88/awesome-cli-apps](https://github.com/aharris88/awesome-cli-apps) | Requires **20+ stars** + 3 months; AI PRs unwelcome |
+
+### Do not submit
+
+| Target | Why |
+|--------|-----|
+| [dzharii/awesome-typescript](https://github.com/dzharii/awesome-typescript) | Explicit ban on LLM/AI-generated PRs |
+
+## Canonical Chronos blurb
+
+- **Repo:** https://github.com/sx4im/chronos
+- **Docs:** https://docs-site-chronos.vercel.app/
+- **npm:** `@sx4im/chronos-core`, `@sx4im/chronos-vitest`, `@sx4im/chronos-cli`
+- **One-liner:** Deterministic Simulation Testing for Node.js and TypeScript — seeded PRNG, virtual clock, simulated network chaos, Vitest integration, bit-identical replay from a single seed.
+
+## How to open the PRs (human, ~10 minutes)
+
+```bash
+# Example: DST awesome list
+gh repo fork ivanyu/awesome-deterministic-simulation-testing --clone
+cd awesome-deterministic-simulation-testing
+git checkout -b add-chronos
+# apply patch from patches/ or edit README by hand using entries.md
+git add README.md
+git commit -m "Add Chronos to Software section"
+git push -u origin add-chronos
+gh pr create --title "Add Chronos (DST for Node.js/TypeScript)" --body-file ../chronos/docs/outreach/pr-bodies/ivanyu.md
+```
+
+Repeat for the other repos using files under `patches/` and `pr-bodies/`.
+
+## Contributor magnets (after listings land)
+
+1. Keep `good first issue` / `help wanted` labels on Chronos issues.
+2. Add Chronos to [Up For Grabs](https://up-for-grabs.net/) / [First Timers Only](https://www.firsttimersonly.com/) once labeled issues exist.
+3. At 100 stars: submit Best of JS + awesome-nodejs (Testing / Mad science as appropriate).
diff --git a/docs/outreach/entries.md b/docs/outreach/entries.md
@@ -0,0 +1,54 @@
+# Ready-to-paste entries
+
+Copy the block that matches each list’s format. Descriptions avoid marketing taglines.
+
+## ivanyu/awesome-deterministic-simulation-testing — Software
+
+Insert alphabetically after Antithesis (before MadSim):
+
+```markdown
+### [Chronos](https://github.com/sx4im/chronos)
+
+Deterministic Simulation Testing framework for Node.js and TypeScript. Virtual clock, seeded PRNG, simulated network (latency/drop/dup/partition), crash/restart, Vitest integration, and bit-identical replay from a single seed.
+```
+
+## asatarin/testing-distributed-systems — Tools
+
+Preferred: new subsection under `## Tools` (after Network Simulation or at end of Tools list intro). Alternative: one bullet under Deterministic Simulation.
+
+```markdown
+### Deterministic Simulation Testing
+
+* [Chronos](https://github.com/sx4im/chronos) — Deterministic Simulation Testing framework for Node.js and TypeScript.
+  Virtual clock, seeded PRNG, simulated network chaos (latency, drop, duplication, partitions), node crash/restart,
+  Vitest integration, and bit-identical replay from a single seed. Docs: https://docs-site-chronos.vercel.app/
+```
+
+Shorter alternative for Deterministic Simulation section:
+
+```markdown
+* [Chronos](https://github.com/sx4im/chronos) — Deterministic Simulation Testing framework for Node.js and TypeScript
+  (virtual clock, seeded PRNG, simulated network, Vitest integration, seed-reproducible replay).
+```
+
+## dastergon/awesome-chaos-engineering — Notable Tools
+
+Add at the **bottom** of Notable Tools (per their guidelines):
+
+```markdown
+* [Chronos](https://github.com/sx4im/chronos) - Deterministic simulation testing for Node.js and TypeScript with seeded network chaos, partitions, and crash injection; bit-identical replay from a single seed.
+```
+
+## theanalyst/awesome-distributed-systems — Verification
+
+```markdown
+- [Chronos](https://github.com/sx4im/chronos) Deterministic Simulation Testing for Node.js and TypeScript: virtual clock, seeded PRNG, simulated network faults, and bit-identical replay from a single seed.
+```
+
+## porada/awesome-vitest — Integrations
+
+Alphabetical after `@storybook/addon-vitest`, before `eslint-vitest-rule-tester`:
+
+```markdown
+- [**@sx4im/chronos-vitest**](https://github.com/sx4im/chronos) — Deterministic simulation testing with seeded PRNG, virtual clock, network chaos, and bit-identical replay.
+```
diff --git a/docs/outreach/issue-bodies/asatarin.md b/docs/outreach/issue-bodies/asatarin.md
@@ -0,0 +1,17 @@
+## Suggestion: add Chronos (DST for Node.js/TypeScript)
+
+Hi — suggestion to list **[Chronos](https://github.com/sx4im/chronos)** under Tools (new **Deterministic Simulation Testing** subsection) or under the Deterministic Simulation overview.
+
+Chronos is an open-source DST framework for Node.js/TypeScript: virtual clock, seeded PRNG, simulated network chaos, Vitest `simTest`, and seed-reproducible replay (FoundationDB / TigerBeetle style).
+
+**Proposed entry:**
+
+```markdown
+### Deterministic Simulation Testing
+
+* [Chronos](https://github.com/sx4im/chronos) — Deterministic Simulation Testing framework for Node.js and TypeScript.
+  Virtual clock, seeded PRNG, simulated network chaos (latency, drop, duplication, partitions), node crash/restart,
+  Vitest integration, and bit-identical replay from a single seed. Docs: https://docs-site-chronos.vercel.app/
+```
+
+Happy to open a PR from a personal fork if that's easier — the account filing this cannot fork.
diff --git a/docs/outreach/issue-bodies/dastergon.md b/docs/outreach/issue-bodies/dastergon.md
@@ -0,0 +1,15 @@
+## Suggestion: add Chronos to Notable Tools
+
+Hi — I'd like to suggest adding **[Chronos](https://github.com/sx4im/chronos)** to Notable Tools.
+
+Chronos is Deterministic Simulation Testing for Node.js/TypeScript with seeded network chaos (latency, drop, duplication, partitions) and crash injection. Failures replay bit-for-bit from a single seed.
+
+**Proposed entry** (bottom of Notable Tools):
+
+```markdown
+* [Chronos](https://github.com/sx4im/chronos) - Deterministic simulation testing for Node.js and TypeScript with seeded network chaos, partitions, and crash injection; bit-identical replay from a single seed.
+```
+
+Docs: https://docs-site-chronos.vercel.app/
+
+Happy to open a PR if preferred.
diff --git a/docs/outreach/issue-bodies/ivanyu.md b/docs/outreach/issue-bodies/ivanyu.md
@@ -0,0 +1,17 @@
+## Suggestion: add Chronos to Software
+
+Hi — I'd like to suggest adding **[Chronos](https://github.com/sx4im/chronos)** to the Software section.
+
+Chronos is a Deterministic Simulation Testing framework for **Node.js and TypeScript** (same niche as MadSim / Turmoil / Tickloom, for the JS ecosystem): virtual clock, seeded PRNG, simulated network (latency/drop/dup/partition), crash/restart, Vitest integration, and bit-identical replay from a single seed.
+
+**Proposed entry** (alphabetically after Antithesis):
+
+```markdown
+### [Chronos](https://github.com/sx4im/chronos)
+
+Deterministic Simulation Testing framework for Node.js and TypeScript. Virtual clock, seeded PRNG, simulated network (latency/drop/dup/partition), crash/restart, Vitest integration, and bit-identical replay from a single seed.
+```
+
+Docs: https://docs-site-chronos.vercel.app/
+
+Happy to open a PR if you prefer that — the cloud bot opening this issue cannot fork external repos.
diff --git a/docs/outreach/issue-bodies/porada.md b/docs/outreach/issue-bodies/porada.md
@@ -0,0 +1,15 @@
+## Suggestion: add @sx4im/chronos-vitest under Integrations
+
+Hi — I'd like to suggest **[`@sx4im/chronos-vitest`](https://www.npmjs.com/package/@sx4im/chronos-vitest)** for the Integrations section.
+
+Native Vitest helpers (`simTest`, `expectInvariant`, `replayTest`) for Deterministic Simulation Testing: seeded PRNG, virtual clock, network chaos, bit-identical replay.
+
+**Proposed entry** (alphabetical after `@storybook/addon-vitest`):
+
+```markdown
+- [**@sx4im/chronos-vitest**](https://github.com/sx4im/chronos) — Deterministic simulation testing with seeded PRNG, virtual clock, network chaos, and bit-identical replay.
+```
+
+Repo: https://github.com/sx4im/chronos
+
+Happy to open a PR if you prefer.
diff --git a/docs/outreach/issue-bodies/theanalyst.md b/docs/outreach/issue-bodies/theanalyst.md
@@ -0,0 +1,15 @@
+## Suggestion: add Chronos under Verification
+
+Hi — suggestion to add **[Chronos](https://github.com/sx4im/chronos)** under **Verification of Distributed Systems**.
+
+Chronos is Deterministic Simulation Testing for Node.js and TypeScript: virtual clock, seeded PRNG, simulated network faults, and bit-identical replay from a single seed.
+
+**Proposed entry:**
+
+```markdown
+- [Chronos](https://github.com/sx4im/chronos) Deterministic Simulation Testing for Node.js and TypeScript: virtual clock, seeded PRNG, simulated network faults, and bit-identical replay from a single seed.
+```
+
+Docs: https://docs-site-chronos.vercel.app/
+
+Happy to open a PR if that's the preferred path.
diff --git a/docs/outreach/patches/asatarin.patch b/docs/outreach/patches/asatarin.patch
@@ -0,0 +1,15 @@
+--- a/README.md	2026-08-09 10:35:48.967515725 +0000
++++ b/README.md	2026-08-09 10:35:49.695513000 +0000
+@@ -931,6 +931,12 @@
+ * [Chaos Mesh](https://chaos-mesh.org/) — [chaos engineering](#chaos-engineering) platform for Kubernetes. See
+   also [PingCap](#pingcap-tidb), company behind Chaos Mesh.
+
++### Deterministic Simulation Testing
++
++* [Chronos](https://github.com/sx4im/chronos) — Deterministic Simulation Testing framework for Node.js and TypeScript.
++  Virtual clock, seeded PRNG, simulated network chaos (latency, drop, duplication, partitions), node crash/restart,
++  Vitest integration, and bit-identical replay from a single seed. Docs: https://docs-site-chronos.vercel.app/
++
+ ### QuickCheck
+
+ * [PolyConf 14: Testing the Hard Stuff and Staying Sane / John Hughes](https://youtu.be/F6LzB6SdFKA)
diff --git a/docs/outreach/patches/dastergon.patch b/docs/outreach/patches/dastergon.patch
@@ -0,0 +1,10 @@
+--- a/README.md	2026-08-09 10:35:49.211514812 +0000
++++ b/README.md	2026-08-09 10:35:49.711512940 +0000
+@@ -196,6 +196,7 @@
+ * [gorm-sqlchaos](https://github.com/u2386/gorm-sqlchaos) - A runtime SQL manipulator for your Golang applications based on gorm.
+ * [Chaos Frontend Toolkit](https://chaos-frontend-toolkit.web.app/) - A set of tools to apply Chaos Engineering to frontend
+ * [Mitigant](https://mitigant.io/) - The Continuos Security Verification Platform, enables confidence in cloud security posture by leveraging security chaos engineering.
++* [Chronos](https://github.com/sx4im/chronos) - Deterministic simulation testing for Node.js and TypeScript with seeded network chaos, partitions, and crash injection; bit-identical replay from a single seed.
+
+ ## Retired tools
+ * [The Simian Army](https://github.com/Netflix/SimianArmy) - A suite of tools for keeping your cloud operating in top form.
diff --git a/docs/outreach/patches/ivanyu.patch b/docs/outreach/patches/ivanyu.patch
@@ -0,0 +1,13 @@
+--- a/README.md	2026-08-09 10:35:48.751516531 +0000
++++ b/README.md	2026-08-09 10:35:49.675513074 +0000
+@@ -69,6 +69,10 @@
+
+ > Antithesis is a continuous reliability platform that autonomously searches for problems in your software within a simulated environment. Every problem we find can be perfectly reproduced, allowing for efficient debugging of even the most complex problems.
+
++### [Chronos](https://github.com/sx4im/chronos)
++
++Deterministic Simulation Testing framework for Node.js and TypeScript. Virtual clock, seeded PRNG, simulated network (latency/drop/dup/partition), crash/restart, Vitest integration, and bit-identical replay from a single seed.
++
+ ### [MadSim](https://github.com/madsim-rs/madsim)
+
+ A deterministic simulator for distributed systems in Rust.
diff --git a/docs/outreach/patches/porada.patch b/docs/outreach/patches/porada.patch
@@ -0,0 +1,10 @@
+--- a/README.md	2026-08-09 10:35:49.651513163 +0000
++++ b/README.md	2026-08-09 10:35:49.747512806 +0000
+@@ -129,6 +129,7 @@
+ - [**@cloudflare/vitest-pool-workers**](https://developers.cloudflare.com/workers/testing/vitest-integration/) — Run tests in a Cloudflare Workers runtime.
+ - [**@logtape/testing-vitest**](https://github.com/dahlia/logtape/tree/main/packages/testing-vitest) — Report LogTape logs when tests fail.
+ - [**@storybook/addon-vitest**](https://storybook.js.org/docs/writing-tests/integrations/vitest-addon) — Run Storybook stories as Vitest tests.
++- [**@sx4im/chronos-vitest**](https://github.com/sx4im/chronos) — Deterministic simulation testing with seeded PRNG, virtual clock, network chaos, and bit-identical replay.
+ - [**eslint-vitest-rule-tester**](https://github.com/antfu-collective/eslint-vitest-rule-tester) — Test ESLint rules using Vitest.
+ - [**neon-testing**](https://github.com/starmode-base/neon-testing) — Test projects that rely on Neon Postgres databases.
+ - [**rescript-vitest**](https://github.com/cometkim/rescript-vitest) — Write tests in ReScript.
diff --git a/docs/outreach/patches/theanalyst.patch b/docs/outreach/patches/theanalyst.patch
@@ -0,0 +1,10 @@
+--- a/README.md	2026-08-09 10:35:49.431513988 +0000
++++ b/README.md	2026-08-09 10:35:49.731512865 +0000
+@@ -73,6 +73,7 @@
+ - Curated list of resources on [testing distributed systems](https://asatarin.github.io/testing-distributed-systems/) includes links to materials on testing by various companies (Google, Amazon, Netflix, Microsoft, Dropbox, etc) and research papers.
+ - [Jepsen](https://github.com/jepsen-io/jepsen) A framework for distributed systems verification, with fault injection
+   @aphyr has featured enough times in this list already, but Jepsen and the blog posts that go with are a quintessntial addition to any distributed systems reading list.
++- [Chronos](https://github.com/sx4im/chronos) Deterministic Simulation Testing for Node.js and TypeScript: virtual clock, seeded PRNG, simulated network faults, and bit-identical replay from a single seed.
+ - [Verdi](http://verdi.uwplse.org/) A Framework for Implementing and Formally Verifying Distributed Systems [Paper](http://verdi.uwplse.org/verdi.pdf)
+
+ ## Videos
diff --git a/docs/outreach/pr-bodies/asatarin.md b/docs/outreach/pr-bodies/asatarin.md
@@ -0,0 +1,8 @@
+## Summary
+
+Add [Chronos](https://github.com/sx4im/chronos) under **Tools → Deterministic Simulation Testing**.
+
+Chronos is an open-source DST framework for Node.js and TypeScript (FoundationDB / TigerBeetle-style): virtual clock, seeded PRNG, simulated network chaos, Vitest `simTest`, and seed-reproducible replay. Happy to move the entry if you prefer it under the Deterministic Simulation overview section instead.
+
+- Repo: https://github.com/sx4im/chronos
+- Docs: https://docs-site-chronos.vercel.app/
diff --git a/docs/outreach/pr-bodies/dastergon.md b/docs/outreach/pr-bodies/dastergon.md
@@ -0,0 +1,8 @@
+## Summary
+
+Add [Chronos](https://github.com/sx4im/chronos) to **Notable Tools** (bottom of the category per contributing guidelines).
+
+Chronos is a Deterministic Simulation Testing framework for Node.js/TypeScript with seeded network chaos (latency, drop, duplication, partitions) and crash injection. Failures replay bit-for-bit from a single seed — useful for chaos-style fault injection in simulated environments before production.
+
+- Repo: https://github.com/sx4im/chronos
+- Docs: https://docs-site-chronos.vercel.app/
diff --git a/docs/outreach/pr-bodies/ivanyu.md b/docs/outreach/pr-bodies/ivanyu.md
@@ -0,0 +1,8 @@
+## Summary
+
+Add [Chronos](https://github.com/sx4im/chronos) to the **Software** section (alphabetically after Antithesis).
+
+Chronos is a Deterministic Simulation Testing framework for **Node.js / TypeScript** — the JS/TS counterpart to MadSim / Turmoil / Tickloom. It provides a virtual clock, seeded PRNG, simulated network (latency / drop / dup / partition), crash/restart, Vitest integration, and bit-identical replay from a single seed.
+
+- Repo: https://github.com/sx4im/chronos
+- Docs: https://docs-site-chronos.vercel.app/
diff --git a/docs/outreach/pr-bodies/porada.md b/docs/outreach/pr-bodies/porada.md
@@ -0,0 +1,8 @@
+## Summary
+
+Add [`@sx4im/chronos-vitest`](https://github.com/sx4im/chronos) under **Integrations** (alphabetical).
+
+Native Vitest helpers (`simTest`, `expectInvariant`, `replayTest`) for Deterministic Simulation Testing: seeded PRNG, virtual clock, network chaos, bit-identical replay.
+
+- Package: https://www.npmjs.com/package/@sx4im/chronos-vitest
+- Repo: https://github.com/sx4im/chronos
diff --git a/docs/outreach/pr-bodies/theanalyst.md b/docs/outreach/pr-bodies/theanalyst.md
@@ -0,0 +1,8 @@
+## Summary
+
+Add [Chronos](https://github.com/sx4im/chronos) under **Verification of Distributed Systems**.
+
+Chronos brings FoundationDB/TigerBeetle-style Deterministic Simulation Testing to Node.js and TypeScript: controlled time, seeded randomness, simulated network faults, and bit-identical replay from a single seed.
+
+- Repo: https://github.com/sx4im/chronos
+- Docs: https://docs-site-chronos.vercel.app/