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

Relationships

#3273 Docs: Layout Migration says repo upgrade deletes gen-2 files without re-pulling

Opened by stack72 · 10/12/2026· Shipped 10/14/2026

design/primitives/extensions.md, section Layout Migration, gen-2 bullet: it says repo upgrade deletes each gen-2 entry's tracked files and leaves the lockfile unchanged, and the next extension install re-pulls. The code no longer works that way. repoUpgrade in src/libswamp/repo/init.ts runs an extensionInstall pass that re-pulls any gen-1 or gen-2 entry into the per-extension subtree and then sweeps the legacy paths (needsInstallOrMigration and sweepLegacyPaths in src/libswamp/extensions/install.ts), the same as gen-1. Nothing in the repo-upgrade path deletes gen-2 files on its own. The PULLED_TYPE_DIRS doc comment in src/libswamp/extensions/layout.ts also still mentions a phase-two migration in RepoService that no longer uses it. Fix: rewrite the gen-2 bullet to describe the re-pull and sweep, and update the PULLED_TYPE_DIRS comment. Found while working on swamp-club#3271.

02Bog Flow
✓OPEN✓TRIAGED✓IN PROGRESS✓SHIPPED+ 1 MOREASSIGNED+ 5 MOREREVIEW+ 13 MOREPR_MERGED+ 2 MORESESSION_SUMMARIZED

Shipped

10/14/2026, 3:50:28 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack7210/14/2026, 3:19:30 AM

Sign in to post a ripple.