yellowjacket/.planning/quick/002-auto-rename-duplicate-playlists-on-import/002-PLAN.md

phase, plan, type, wave, depends_on, files_modified, autonomous, requirements, must_haves

phase	plan	type	wave	depends_on	files_modified	autonomous	requirements	must_haves
quick	002	execute	1		backend/database/sql/queries/playlists.sql backend/database/sql/sqlcgen/playlists.sql.go backend/playlist/playlist.go	true	QUICK-002	truths artifacts key_links Importing an M3U whose name matches an existing playlist auto-renames to Name (1) Importing again produces Name (2), Name (3), etc. CreatePlaylist and CreatePlaylistWithTracks do NOT auto-rename (only import) path provides contains backend/database/sql/queries/playlists.sql CountPlaylistsByName query CountPlaylistsByName path provides contains backend/database/sql/sqlcgen/playlists.sql.go Generated CountPlaylistsByName function CountPlaylistsByName path provides contains backend/playlist/playlist.go uniquePlaylistName helper and ImportPlaylist integration uniquePlaylistName from to via pattern backend/playlist/playlist.go backend/database/sql/sqlcgen/playlists.sql.go s.db.Queries.CountPlaylistsByName CountPlaylistsByName

Auto-rename duplicate playlists on import — when importing an M3U/M3U8 file whose derived name matches an existing playlist, automatically append (1), (2), etc. instead of creating a duplicate. Only applies to import, not manual CreatePlaylist.

Purpose: Prevent confusing duplicate playlist names when importing the same file multiple times. Output: Modified playlist SQL queries (+ regenerated sqlc), updated ImportPlaylist flow.

<execution_context> @/home/caleb/.config/Claude/get-shit-done/workflows/execute-plan.md @/home/caleb/.config/Claude/get-shit-done/templates/summary.md </execution_context>

@backend/database/sql/queries/playlists.sql @backend/database/sql/sqlcgen/playlists.sql.go @backend/playlist/playlist.go @backend/database/sqlc.yaml Task 1: Add CountPlaylistsByName SQL query and regenerate sqlc backend/database/sql/queries/playlists.sql backend/database/sql/sqlcgen/playlists.sql.go Add a new sqlc query to `backend/database/sql/queries/playlists.sql` at the end of the existing playlist queries (after `CreatePlaylist`, before track queries):

```sql
-- name: CountPlaylistsByName :one
SELECT COUNT(*) AS count FROM playlists WHERE name = ?;
```

Then regenerate sqlc from `backend/database`:
```bash
cd backend/database && sqlc generate
```

This produces a `CountPlaylistsByName(ctx, name string) (int64, error)` function in
`playlists.sql.go`. Verify the generated function exists and compiles.

`grep -q "CountPlaylistsByName" backend/database/sql/sqlcgen/playlists.sql.go` succeeds AND `go build ./backend/database/sql/sqlcgen/` compiles cleanly. CountPlaylistsByName query exists in SQL and generated Go code compiles. Task 2: Add uniquePlaylistName helper and wire into ImportPlaylist backend/playlist/playlist.go **Add helper method** to `backend/playlist/playlist.go` (place it just above ImportPlaylist, around line 684):

```go
// uniquePlaylistName returns a name that doesn't collide with existing
// playlists. If "Chill Vibes" exists, returns "Chill Vibes (1)".
// If that also exists, returns "Chill Vibes (2)", etc.
func (s *Service) uniquePlaylistName(name string) string {
    count, err := s.db.Queries.CountPlaylistsByName(s.db.Ctx, name)
    if err != nil || count == 0 {
        return name
    }
    for i := 1; ; i++ {
        candidate := fmt.Sprintf("%s (%d)", name, i)
        c, err := s.db.Queries.CountPlaylistsByName(s.db.Ctx, candidate)
        if err != nil || c == 0 {
            return candidate
        }
    }
}
```

**Wire into ImportPlaylist** — after the `playlistName` derivation block (after the
closing brace of the `if playlistName == ""` block, around line 715) and BEFORE the
`s.db.Queries.CreatePlaylist` call (line 718), add:

```go
playlistName = s.uniquePlaylistName(playlistName)
```

**Important:** Do NOT add this call to `CreatePlaylist`, `CreatePlaylistWithTracks`, or
any other method. Only `ImportPlaylist` gets auto-rename behavior.

Verify the full package compiles: `go build ./backend/playlist/`

`go build ./backend/playlist/` compiles cleanly AND `grep -q "uniquePlaylistName" backend/playlist/playlist.go` succeeds AND `grep -c "uniquePlaylistName" backend/playlist/playlist.go` returns 3 (definition + method body call to self isn't counted — should be: func signature, call in ImportPlaylist, plus the function body references = at least 2-3 occurrences). uniquePlaylistName helper exists and is called from ImportPlaylist (and ONLY ImportPlaylist). `go build ./backend/...` compiles. `go vet ./backend/...` passes. ```bash # Full backend build go build ./backend/...

Vet check

go vet ./backend/...

Verify CountPlaylistsByName exists in generated code

grep "CountPlaylistsByName" backend/database/sql/sqlcgen/playlists.sql.go

Verify uniquePlaylistName is ONLY called from ImportPlaylist, not CreatePlaylist

This grep should show the function definition and one call site in ImportPlaylist

grep -n "uniquePlaylistName" backend/playlist/playlist.go

Verify CreatePlaylist method does NOT reference uniquePlaylistName

(manual scan — the grep above should show it's only in ImportPlaylist context)

</verification>

<success_criteria>
- `go build ./backend/...` passes
- `go vet ./backend/...` passes
- CountPlaylistsByName query exists in SQL and generated Go
- uniquePlaylistName helper exists and is called only from ImportPlaylist
- CreatePlaylist / CreatePlaylistWithTracks unchanged
</success_criteria>

<output>
After completion, create `.planning/quick/002-auto-rename-duplicate-playlists-on-import/002-SUMMARY.md`
</output>