enhancement: sort pidrift list output alphabetically

[tanmayjoddar]

Why

listSnapshots() currently returns whatever order the OS provides. Sorting makes output stable and easier to scan.

Where

• src/storage/snapshotStore.js
• src/commands/list.js

Acceptance Criteria

• Snapshot tags are sorted A→Z before printing
• No behavior changes beyond ordering
• npm test passes

[zxan]

Hey @tanmayjoddar , I would like to claim this issue under GSSoC , please assign it to me.

[vivekyadav-3]

Hi! I have submitted a pull request that fixes this issue. The code has no conflicts and is clean. Please review and merge when you get a chance! Thanks!

[basantnema31]

Hi @tanmayjoddar! I'd love to implement this enhancement under GSSoC '26.

My proposed implementation:
Inside the list command handler, right before the endpoints/snapshots are mapped to the console output, I will apply a .sort() method on the array based on the alphabetical order of the endpoint names or IDs. This will make the CLI output much easier to read for users with large workspaces.

Could you assign this to me?

[amankumar092]

🔍 Problem

apidrift list currently outputs snapshots in the order the OS provides them, which varies by filesystem and makes it hard to visually scan or compare snapshot names — especially in workspaces with many entries.

✅ Solution

Apply a .sort() call on the snapshot array in src/commands/list.js before rendering the console output, ensuring alphabetically stable, predictable output on every run.

✨ Features I Will Implement

• Locate the array population in src/storage/snapshotStore.js or src/commands/list.js
• Apply .sort((a, b) => a.localeCompare(b)) to sort snapshot tags alphabetically
• Ensure the sort does not mutate the original stored data — only the display copy
• Add a unit test verifying sorted output across an unsorted input array

🚀 Ways to Further Improve

• Add a --sort flag (default: alphabetical) with options like --sort=date for creation-time sorting
• Show a column header in the list output for better readability
• Support reverse sorting with --sort=alpha-desc

/claim

Happy to work on this as part of GSSoC 2026. Please assign this issue to me! 🙏