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
- Initialize a fresh repo with swamp.
- Create
extensions/models/random_status.tsexportingexport const modelwith type@tutorial/random-status. - Run
deno check extensions/models/random_status.tsand confirm it passes. - Run
swamp extension source add extensions/models --only models --json. - Run
swamp extension source list --jsonand confirm the source is valid andresolvedKindsincludesmodels. - Run
swamp extension trust add tutorial --json. - Run
swamp model type search --jsonorswamp model type search random-status --json. - 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 --jsonreturns onlycommand/shell.swamp model type search random-status --jsonreturns no matches.swamp model type describe @tutorial/random-status --jsonfails withModel type not found: @tutorial/random-status.swamp extension source list --jsonstill reports the source as valid.- The local extension catalog
.swamp/_extension_catalog.dbhaspopulated:model=truemetadata but no rows inbundle_typesfor model bundles.
Additional notes
- I also tested the documented minimal
@user/echoexample as a diagnostic; it was ignored the same way, so this does not appear specific to@tutorial/random-status. swamp repo upgrade --jsoncompleted 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 --jsonshowsextensions/modelsasstatus=validandresolvedKinds=[models]swamp model type search --jsononly showscommand/shellswamp model type describe @tutorial/random-status --jsonreportsModel type not found
Automoved by swampadmin from https://github.com/systeminit/swamp/issues/1231
Shipped
Click a lifecycle step above to view its details.
Sign in to post a ripple.