Skip to main content
← Back to list
01Issue
BugShippedSwamp CLI
Assigneesstack72

Local extension models in extensions/models are not discovered in fresh repo tutorial flow

Opened by stack72 Β· 4/27/2026Β· Shipped 4/28/2026

Swap got stuck during the hello-world tutorial's 2nd prompt. Note I am using Codex (with default configuration). I asked it to report a bug, which didn't work fully automatically because "I need to run swamp auth login" but i haven't looked at swap authentication/signup yet, i'm just an anonymous user following the hello world tutorial. Anyway it helpfully prepared the content below.

===== Summary A fresh swamp repo initialized for the getting-started flow does not discover local extension model files placed in extensions/models, even when the directory is registered as a valid extension source and the TypeScript files pass deno check. This blocks the basic tutorial path of creating a simple local extension model and then creating a model instance from that type.

Environment

  • swamp version: 20260206.200442.0-sha.
  • repo initialized on 2026-04-27
  • tool: codex
  • not authenticated to swamp.club

Steps to reproduce

  1. Initialize a fresh repo with swamp.
  2. Create extensions/models/random_status.ts exporting export const model with type @tutorial/random-status.
  3. Run deno check extensions/models/random_status.ts and confirm it passes.
  4. Run swamp extension source add extensions/models --only models --json.
  5. Run swamp extension source list --json and confirm the source is valid and resolvedKinds includes models.
  6. Run swamp extension trust add tutorial --json.
  7. Run swamp model type search --json or swamp model type search random-status --json.
  8. Run swamp model type describe @tutorial/random-status --json.

Expected behavior The local extension model should be indexed and discoverable as a model type, so swamp model type search should include @tutorial/random-status and swamp model type describe @tutorial/random-status should succeed.

Actual behavior

  • swamp model type search --json returns only command/shell.
  • swamp model type search random-status --json returns no matches.
  • swamp model type describe @tutorial/random-status --json fails with Model type not found: @tutorial/random-status.
  • swamp extension source list --json still reports the source as valid.
  • The local extension catalog .swamp/_extension_catalog.db has populated:model=true metadata but no rows in bundle_types for model bundles.

Additional notes

  • I also tested the documented minimal @user/echo example as a diagnostic; it was ignored the same way, so this does not appear specific to @tutorial/random-status.
  • swamp repo upgrade --json completed successfully but did not change the behavior.
  • This is especially problematic in a tutorial / hello-world flow because it looks like the user is following the docs correctly but the local type never becomes available.

Files involved

  • extensions/models/random_status.ts
  • .swamp-sources.yaml
  • .swamp.yaml

Representative outputs

  • swamp extension source list --json shows extensions/models as status=valid and resolvedKinds=[models]
  • swamp model type search --json only shows command/shell
  • swamp model type describe @tutorial/random-status --json reports Model type not found

Automoved by swampadmin from https://github.com/systeminit/swamp/issues/1231

02Bog Flow
βœ“OPENβœ“TRIAGEDβœ“IN PROGRESSβœ“SHIPPED+ 1 MOREASSIGNED+ 8 MOREREVIEW+ 4 MOREPR_MERGEDSHIPPED

Shipped

4/28/2026, 2:15:41 PM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack724/28/2026, 7:18:05 AM

Sign in to post a ripple.