Swamp Training
@taylor/swamp-trainingv2026.10.22.2
01README
Retest the swamp-training Slidev deck when swamp ships a new release: every swamp command in the deck is checked against the release's CLI, the deck's @training/file-check lab is rebuilt from the slides and run, and the skills, CLAUDE.md and allowlist that swamp repo init installs are diffed against the last tested release. The release binary runs in a throwaway sandbox, so your installed swamp is left alone.
02Behaviors
@taylor/swamp-training/deckv2026.10.22.2swamp_training_deck.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| deckDir | string | Deck directory; relative paths resolve from the swamp repo |
| slidesFile? | string | Deck markdown file, relative to deckDir |
| upstream? | string | GitHub repository whose releases are watched |
| ghPath? | string | GitHub CLI binary |
| swampConfigDir? | string | Swamp config directory holding your sign-in, shared with the sandbox (default ~/.config/swamp) |
| ignore? | array | Regular expressions for deck commands that aren't real commands, such as a joke |
| installedSwamp? | string | Installed swamp binary; tested instead of the latest release when it is a newer build. Empty to test releases only |
fn watch()
Check for a swamp release newer than the one the deck was last tested against
fn retest(version?: string, force?: boolean, keepSandbox?: boolean)
Retest the deck against the latest swamp release, the installed swamp when it is newer, or `version`, unless that build was already tested
| Argument | Type | Description |
|---|---|---|
| version? | string | Release to test, e.g. v20261014.205128.0-sha.17edd435 (default: the latest) |
| force? | boolean | Retest even when this release was already tested |
| keepSandbox? | boolean | Keep the sandbox directory for debugging; its path is in the report |
Resources
upstream(infinite)— The latest swamp release and the commits since the last tested one (instance upstream)
report(infinite)— One retest: commands, lab steps and skill changes (instance report)
Files
snapshot(application/json)— Skills, CLAUDE.md and allowlist the tested release installs, to diff the next retest against (instance snapshot)
03Previous Versions
2026.10.22.1AGPL-3.0-or-later(was AGPL-3.0-only)
2026.10.14.2AGPL-3.0-only(was none)
Declares license AGPL-3.0-only in the manifest. No behavior changes.
2026.10.14.1
04Stats
A
100 / 100
Downloads
15
Archive size
42.5 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License2/2earned
- Verified public repository2/2earned
Repository
https://github.com/taylorific/swampworksdeno-command3 accepted
Spawns a subprocess with Deno.Command().
- models/swamp_training_deck.ts:189 — runs gh api and gh release download; argument lists are built in this file, see README What it runs
- models/swamp_training_deck.ts:336 — runs only version --json on the installed swamp, see README What it runs
- models/swamp_training_deck.ts:473 — runs the downloaded swamp release and its bundled deno in a sandbox; commands come from the deck, see README What it runs
behavior-spelling1 accepted
- (extension) — retests the deck against the latest swamp release, which reads the behavior spelling
06Platforms
07Labels