Session-start 'swamp model search --json' in the AGENTS.md template is unfulfillable - wire it to a hook or drop it

7h ago

#3124

Flaky property test: analyzeExpression dot/bracket agreement fails when the generated model name is a CEL keyword

12h ago

#3123

Accept usernames for user subjects in grant files

13h ago

#3122

Docs: enable-managed-config should say to re-run config migrate when its push fails

13h ago

#3121

Docs: grant file reference shows a stale format and omits resources and subjects

13h ago

#3120

Flaky property test: analyzeExpression hyphenated dot access fails when modelName generates a CEL keyword ("in")

14h ago

#3119

extension quality and push crash with IsADirectory when additionalFiles lists a directory

14h ago

#3118

extension push: a required global argument renders with a stray "" ("text": "string""")

14h ago

#3116

Docs: extension publishing reference is stale on bare specifiers, quality output and fmt config (swamp-club#3022)

14h ago

#3114

swamp-extensions: replace bare import specifiers with npm:/jsr: specifiers in first-party extensions

15h ago

#3112

extension push: 'Requested visibility' line prints to stdout without the logger prefix, twice per run

15h ago

#3111

A nested structural swamp that outlives the run that started it keeps skipping that run's lock while the holder writes

15h ago

#3110

extension push/quality: structured acceptances for agents, a clearer title than For next time, and an optional reason

15h ago

#3104

extension push: the undecided private-entitlement verdict still says the registry may start a trial at publish

16h ago

#3103

seed:collective cannot produce a superseded personal trial or a returned trial, so the UAT cannot cover them

16h ago

#3102

Replayable state fragments: Git-reviewable desired state for resources changed by model methods

16h ago

#3100

extension push: registry metadata and content hash label files relative to the repo dir, so a push with --extensions-dir records ../ paths

17h ago

#3095

registry: store and show declared acceptances sent in contentMetadata.acceptances at confirm (swamp-club#3021)

18h ago

#3088

extension push --dry-run: authentication verdict prints 'Signed in as .' when the credential is an API key with no username

19h ago

#3080

serve --remote-only: step output from workers is never persisted to the run log (history logs always empty)

21h ago

#3074

serve HA: worker enrollment on a replica that lacks the enrollment token's definition may create a second definition (unverified)

21h ago

#3073

serve HA: pull a token's definition on an auth miss so a peer accepts a new token at once

21h ago

#3069

extension push: version-drift check reports 'no previously published version found' when the registry call failed

22h ago

#3067

Search and list output follows directory iteration order in the definition, workflow, vault and output repositories

22h ago

#3065

extension push: accept attestation-backed adversarial-review evidence (lookup by extension and content hash), generated provenance, and carry the evidence to the registry at confirm (design: Lab #3023)

23h ago

#3062

Workflow load errors print the raw Zod issue dump instead of a readable message

1d ago

#3060

Decide a stricter naming rule for workflow step and job names

15h ago

#3046

serve: run scheduled workflows concurrently (per-workflow serialization), and report queue delay

1d ago

#3045

Show expired approval gates as expired, with a Cancel action in the dashboard

1d ago

#3041

digitalocean codegen leaves an orphaned security_secret.ts model file after its endpoint left the spec

1d ago

#3040

extension promote accepts a yanked version and reports it promoted

1d ago

#3036

Docs: doctor install reports a stale or failing autoupdate scheduler

1d ago

#3017

extension push output: double-quoted adjacent interpolations, repo-relative paths, and --json emits three JSON documents

1d ago

#3013

auto-resolve: the Installing line prints the extension's entire multi-line description

1d ago

#3010

s3-datastore/serve: readResource without a version returns an older version; the latest marker is rewritten backwards

2d ago

#3004

Publish agent-facing projections of the manual: /llms.txt, .md pages, and llms-full.txt

Team3d ago

#3000

Let agent-runner drive more agent CLIs (Kilo Code and others)

4d ago

#2998

s3-datastore: every fast-path miss re-downloads every _index shard, so a busy serve pulls the whole index every poll (~230 GB/day S3 egress)

4d ago

#2993

Feedback: Swamp as an approval-gated control plane for a small fleet

1d ago

#2965

extension safety analyzer's Deno.Command( warning is a plain substring match

4d ago

#2922

Tell timeouts apart from cancels in method-run records, and review the hidden 30 s fallback timer for step-called model methods

5d ago

#2908

Run from a git worktree: definitions from the worktree, state from the shared repo

5d ago

#2907

S3/GCS datastore: a push that fails after uploading drops its recorded deletes, so the retry brings deleted data back

5d ago

#2906

Tests: bring the in-memory remote's default semantics up to @swamp/s3-datastore and @swamp/gcs-datastore 2026.10.01.1

5d ago

#2900

Tell the pushing client when its extension contentMetadata fails validation

5d ago

#2892

Extension datastore: query still returns an item after its delete is pulled

5d ago

#2867

Cancel, reject and supersede of a parent run should settle its suspended nested child runs

6d ago

#2865

Tracking: test baseline required before the datastore refactor (commit-log design)

4d ago

#2863

Tests: serve pollers make a peer's writes, deletes and grants visible with a real catalog (before Phase 5)

6d ago

#2844

datastore setup can overwrite an existing remote config tier when it moves an in-repo tier into an extension datastore

6d ago

#2754

serve: define and supply the collective and owner grant condition variables

7d ago

#2749

No first-class workflow primitive for spawning a permission-scoped agent session

7d ago

#2746

A pulled extension can shadow a built-in type, and removing it leaves serve without the built-in

7d ago

#2727

Decorative animations outside the Lab still repaint on the main thread

7d ago

#2683

s3/gcs datastore: pullChanged overwrites dirty, unpushed cache files

7d ago

#2671

Concurrent first runs in a fresh repo log 'Catalog migration to per-extension-aggregate-v3 failed (database is locked)'

8d ago

#2643

Codegen/DigitalOcean: create-only required fields block list/get/delete in generated DigitalOcean models

8d ago

#2623

Codegen/AWS: create-only required fields block list/get/delete in generated AWS models

8d ago

#2618

End a collective's trial when it begins a paid subscription

8d ago

#2606

A collective that cancels inside its 30-day trial window regains trial access to private extensions

8d ago

#2592

s3-datastore: SWAMP_S3_REQUEST_TIMEOUT_MS does not appear to apply to ListObjectsV2 during pull

8d ago

#2591

s3-datastore: S3Lock.acquire overshoots maxWaitMs by up to a full backoff interval

8d ago

#2590

s3-datastore: a model-scoped pull still lists, walks and indexes the whole namespace

8d ago

#2586

Run the web dashboard locally from the CLI without swamp serve

s8d ago

#2583

verify-reviews: adversarial review path guard is a hand-kept list, so new extensions silently skip it

6d ago

#2582

issue-lifecycle skill: prepare-to-ship documents a fast_forward method that does not exist

8d ago

#2573

S3 datastore rejects valid cache paths as traversal on Windows

Team5d ago

#2564

swamp-club: unknown collective API token returns 422 instead of the documented 404

11d ago

#2563

Partial extension catalog saves delete rows for sources mounted from outside the repo

11d ago

#2560

extensions: cold-path catalog rebuild skips sources whose type is not a string literal, dropping them for one process lifetime

11d ago

#2540

serve: rotate the external token-secrets key

11d ago

#2535

serve: server token GC follow-ups (upgrade backlog holds the sync gate, not-found matching, owner lookup, UX)

11d ago

← Back to list

01Issue

FeatureClosedSwamp ClubPublic

AssigneesNone

Relationships

#2866 Docs: SWAMP_API_KEY_FILE and serve --club-api-key-file

Opened by stack72 · 9/30/2026

swamp-club#2790 adds two ways to supply the collective API key from a file instead of the SWAMP_API_KEY env var:

SWAMP_API_KEY_FILE: an env var holding a path to a file that contains the key. It works for every command that uses SWAMP_API_KEY today (auth whoami, extension push/pull, issue commands, telemetry, serve).
--club-api-key-file : a flag on swamp serve and swamp serve check-config (forwarded by swamp serve daemon enable). The key serve uses for OAuth client registration, admin/allowed-user name lookup, instance registration and the club heartbeat is read from this file, and the same key is used for extension trust, pulls and telemetry in that process.

Precedence: --club-api-key-file, then SWAMP_API_KEY_FILE, then SWAMP_API_KEY. Setting both SWAMP_API_KEY and SWAMP_API_KEY_FILE is an error. One trailing newline in the file is stripped, and a missing, unreadable or empty file is an error naming the source. Serve reads the key once per boot, so a rotated file needs a restart.

Pages to update in content/manual/reference:

api-key-authentication.md: add SWAMP_API_KEY_FILE next to SWAMP_API_KEY, with the precedence and the mutual-exclusivity rule.
swamp-serve.md: document --club-api-key-file for headless OAuth registration, with a container/Kubernetes secret-mount example, and note that daemon enable stores only the path.

02Bog Flow

Closed

10/2/2026, 1:46:23 AM

No activity in this phase yet.

03Sludge Pulse

stack72 commented 10/2/2026, 1:46:23 AM

Documented in https://github.com/swamp-club/swamp-club/pull/1281. api-key-authentication.md already covered SWAMP_API_KEY_FILE, the precedence and the mutual-exclusion error. swamp-serve.md is only an index page, so the flag went into reference/swamp-serve/serve-flags.md (a --club-api-key-file row and a SWAMP_API_KEY_FILE env row) and reference/swamp-serve/daemon.md, which notes that daemon enable stores only the path. how-to/swamp-serve/deploy-headless-oauth.md gains a Kubernetes secret-volume example, the restart-on-rotation note, and the missing-file error. One correction to the issue text: the key file is trimmed of all surrounding whitespace, not just one trailing newline (api_key_source.ts).

Session-start 'swamp model search --json' in the AGENTS.md template is unfulfillable - wire it to a hook or drop it

Flaky property test: analyzeExpression dot/bracket agreement fails when the generated model name is a CEL keyword

Accept usernames for user subjects in grant files

Docs: enable-managed-config should say to re-run config migrate when its push fails

Docs: grant file reference shows a stale format and omits resources and subjects

Flaky property test: analyzeExpression hyphenated dot access fails when modelName generates a CEL keyword ("in")

extension quality and push crash with IsADirectory when additionalFiles lists a directory

extension push: a required global argument renders with a stray "" ("text": "string""")

Docs: extension publishing reference is stale on bare specifiers, quality output and fmt config (swamp-club#3022)

swamp-extensions: replace bare import specifiers with npm:/jsr: specifiers in first-party extensions

extension push: 'Requested visibility' line prints to stdout without the logger prefix, twice per run

A nested structural swamp that outlives the run that started it keeps skipping that run's lock while the holder writes

Show signal waits to remote clients and the dashboard

Settle expired signal waits from swamp serve

Resume signalled workflow runs automatically under swamp serve

extension push/quality: structured acceptances for agents, a clearer title than For next time, and an optional reason

extension push: the undecided private-entitlement verdict still says the registry may start a trial at publish

seed:collective cannot produce a superseded personal trial or a returned trial, so the UAT cannot cover them

Replayable state fragments: Git-reviewable desired state for resources changed by model methods

extension push: registry metadata and content hash label files relative to the repo dir, so a push with --extensions-dir records ../ paths

registry: store and show declared acceptances sent in contentMetadata.acceptances at confirm (swamp-club#3021)

extension push --dry-run: authentication verdict prints 'Signed in as .' when the credential is an API key with no username

serve --remote-only: step output from workers is never persisted to the run log (history logs always empty)

serve HA: worker enrollment on a replica that lacks the enrollment token's definition may create a second definition (unverified)

serve HA: pull a token's definition on an auth miss so a peer accepts a new token at once

extension push: version-drift check reports 'no previously published version found' when the registry call failed

Search and list output follows directory iteration order in the definition, workflow, vault and output repositories

extension push: accept attestation-backed adversarial-review evidence (lookup by extension and content hash), generated provenance, and carry the evidence to the registry at confirm (design: Lab #3023)

Workflow load errors print the raw Zod issue dump instead of a readable message

Decide a stricter naming rule for workflow step and job names

serve: run scheduled workflows concurrently (per-workflow serialization), and report queue delay

Show expired approval gates as expired, with a Cancel action in the dashboard

digitalocean codegen leaves an orphaned security_secret.ts model file after its endpoint left the spec

extension promote accepts a yanked version and reports it promoted

Docs: doctor install reports a stale or failing autoupdate scheduler

extension push output: double-quoted adjacent interpolations, repo-relative paths, and --json emits three JSON documents

auto-resolve: the Installing line prints the extension's entire multi-line description

s3-datastore/serve: readResource without a version returns an older version; the latest marker is rewritten backwards

Publish agent-facing projections of the manual: /llms.txt, .md pages, and llms-full.txt

Let agent-runner drive more agent CLIs (Kilo Code and others)

s3-datastore: every fast-path miss re-downloads every _index shard, so a busy serve pulls the whole index every poll (~230 GB/day S3 egress)

Feedback: Swamp as an approval-gated control plane for a small fleet

extension safety analyzer's Deno.Command( warning is a plain substring match

Tell timeouts apart from cancels in method-run records, and review the hidden 30 s fallback timer for step-called model methods

Run from a git worktree: definitions from the worktree, state from the shared repo

S3/GCS datastore: a push that fails after uploading drops its recorded deletes, so the retry brings deleted data back

Tests: bring the in-memory remote's default semantics up to @swamp/s3-datastore and @swamp/gcs-datastore 2026.10.01.1

Tell the pushing client when its extension contentMetadata fails validation

Extension datastore: query still returns an item after its delete is pulled

Cancel, reject and supersede of a parent run should settle its suspended nested child runs

Tracking: test baseline required before the datastore refactor (commit-log design)

Tests: serve pollers make a peer's writes, deletes and grants visible with a real catalog (before Phase 5)

datastore setup can overwrite an existing remote config tier when it moves an in-repo tier into an extension datastore

serve: define and supply the collective and owner grant condition variables

No first-class workflow primitive for spawning a permission-scoped agent session

A pulled extension can shadow a built-in type, and removing it leaves serve without the built-in

Decorative animations outside the Lab still repaint on the main thread

s3/gcs datastore: pullChanged overwrites dirty, unpushed cache files

Concurrent first runs in a fresh repo log 'Catalog migration to per-extension-aggregate-v3 failed (database is locked)'

Codegen/DigitalOcean: create-only required fields block list/get/delete in generated DigitalOcean models

Codegen/AWS: create-only required fields block list/get/delete in generated AWS models

End a collective's trial when it begins a paid subscription

A collective that cancels inside its 30-day trial window regains trial access to private extensions

s3-datastore: SWAMP_S3_REQUEST_TIMEOUT_MS does not appear to apply to ListObjectsV2 during pull

s3-datastore: S3Lock.acquire overshoots maxWaitMs by up to a full backoff interval

s3-datastore: a model-scoped pull still lists, walks and indexes the whole namespace

Run the web dashboard locally from the CLI without swamp serve

verify-reviews: adversarial review path guard is a hand-kept list, so new extensions silently skip it

issue-lifecycle skill: prepare-to-ship documents a fast_forward method that does not exist

S3 datastore rejects valid cache paths as traversal on Windows

swamp-club: unknown collective API token returns 422 instead of the documented 404

Partial extension catalog saves delete rows for sources mounted from outside the repo

extensions: cold-path catalog rebuild skips sources whose type is not a string literal, dropping them for one process lifetime

serve: rotate the external token-secrets key

serve: server token GC follow-ups (upgrade backlog holds the sync gate, not-found matching, owner lookup, UX)

Relationships

#2866 Docs: SWAMP_API_KEY_FILE and serve --club-api-key-file

Closed