fix: data-set command adjustments

[SgtPooki]

A couple of quick comments:

1. It may just be me (and I'm certainly not up on modern command line conventions), but I actually like have to be explicit about with -ls rather than it just being implied just so it's more self documenting when someone looks at commands.
2. ls I think is more of a subcommand than an option, so I'm wondering if this should read as filecoin-pin data-set [optionalDataSetId] ls. (but I realize the original issue said --ls so I may be off here)
3. "Root CID" → "IPFS Root CID" to be consistent with the meta and drive home what this "root CID" is?
4. I assume we'll add piece size in future once we can get it. That would be an open remaining item for Add data-set subcommand with --ls #7

Originally posted by @BigLep in #50 (comment)

[rvagg]

Agreed regarding the ls smell here, not sure about the suggestions though. data-set implies singular, so we have some options:

• Make it data-sets
  • then introduce sub-commands like ls and show 1234; or
  • just accept that filecoin-pin data-sets is a list command and filecoin-pin data-sets 1234 is for showing specific one
• Introduce a new top-level command list-data-sets
• Rename it entirely, perhaps just data and require arguments or sub-commands

Viewing the existing hierarchy is interesting, I think we should be consistent with our pattern. payments is the most complete. So I think I'm leaning toward renaming to data and using list (simple view of all?) and show (detailed view of one?).

[SgtPooki]

I really like the idea of changing it to data and list/show.. since this is a reference implementation, we don't need to pipe through all the terminology.. but we could be confusing folks if we rename things.

I think some "naming sugar" from filecoin-pin would go a long way for new devs to understand things though.. they can dive in to what "data" is if they want, but they don't necessarily need to

[BigLep]

2025-10-30 conversation: we're going to discuss this in person at FDS-7. (This is something we'd want to do before v1.)