Quest Claim
@maphew/quest-claimv2026.09.29.2
01README
Manages quest tier claims for the Swamp Club genesis quests. Reads a schedule of claim windows, claims tiers via the Swamp Club API, and tracks claim status with daily lock files. Supports scheduled runs and immediate claims.
02Release Notes
Align local model source with the published copy (multi-candidate API key resolution plus auth probe), apply dprint formatting, and bump to 2026.09.29.2 so the two copies no longer collide on version. No functional change to claim/window logic.
03Models
@maphew/quest-claimv2026.09.29.2extensions/models/quest_claim.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| scheduleFile | string | Path to quest schedule JSON file (repo-relative or absolute) |
| apiKey? | string | Swamp Club API key. Can also be set via SWAMP_API_KEY env or ~/.config/swamp/auth.json |
| apiBaseUrl | string | Base URL for Swamp Club API |
| claimTimeoutMs | number | Timeout for claim API requests in milliseconds |
| dryRun | boolean | If true, simulate claims without calling the API |
| lockDir | string | Directory for daily claim lock files |
fn runScheduler()
Run the quest claim scheduler - checks schedule and claims tiers in their windows
fn claimTier(tier: number)
Claim a specific quest tier immediately
| Argument | Type | Description |
|---|---|---|
| tier | number | Quest tier number to claim |
fn validateSchedule()
Validate the quest schedule file and show which windows are currently active
Resources
scheduler-result(7d)— Result of the last scheduler run
single-claim-result(7d)— Result of a single tier claim
schedule-validation(7d)— Validation output for the quest schedule
Files
scheduler-report(text/markdown)— Markdown report of the last scheduler run
single-claim-report(text/markdown)— Markdown report of a single tier claim
schedule-validation-report(text/markdown)— Markdown validation report for the quest schedule
04Previous Versions
2026.09.29.1
05Stats
C
64 / 100
Downloads
14
Archive size
7.0 KB
- Has README or module doc0/2missing
- README has a code example0/1missing
- README is substantive0/1pending
- 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
- License declared0/1missing
- Verified public repository2/2earned
Repository
https://github.com/swamp-club/swamp06Platforms
07Labels