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

Relationships

#1198 `models.md` says the `latest` marker is a symlink but it's a plain text file now

Opened by stack72 · 7/17/2026· Shipped 7/17/2026

design/models.md still says:

There will be a symlink to the latest version at data/{normalized-type}/{model-id}/{data-name}/latest/.

That's stale. updateLatestMarker() in src/infrastructure/persistence/unified_data_repository.ts writes the version as plain text:

// Write version number as plain text
await atomicWriteTextFile(latestPath, version.toString());

and the integration test confirms it's deliberate:

// Verify latest marker file exists in filesystem (text file, not symlink)

integration/data_versioning_test.ts checks with Deno.lstat + isFile, which wouldn't pass on a symlink.

Looks like it changed in #669 (configurable datastores / S3), which tracks. A symlink stops meaning anything once data can live in S3 instead of on local disk. Doc just didn't follow.

Also stale in the same direction: the header comment near the top of unified_data_repository.ts still has latest/ # Symlink -> 2/ in its directory diagram.

Hope I'm not just adding noise as that isn't my intent. Really digging this work!

Automoved by swampadmin from https://github.com/swamp-club/swamp/issues/1875

02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 9 MOREREVIEW+ 4 MOREPR_MERGED+ 1 MORENOTIFICATION_SKIPPED

Shipped

7/17/2026, 1:53:18 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack727/17/2026, 12:02:44 AM

Sign in to post a ripple.