Normalize --index-name flag and shorthand conventions

[austin-denoble]

Problem

The CLI had two different flag names for the same concept depending on context. Core index lifecycle commands (describe, delete, configure) used --name to identify the index, while every other command that operated on an index (vector ops, imports, namespaces, backups, stats) used --index-name. This meant users had to remember which "mode" they were in, and made scripting inconsistent.

A secondary issue: --index-name had -n as its shorthand on most commands, which doesn't correspond to the first letter of either word in the flag name and conflicted with the mental model that -n = --name.

Solution

Introduce a clear semantic split enforced uniformly across all index subcommands:

• --index-name (-i) — always refers to an existing index being operated on
• --name (-n) — always names a resource being created or labeled (new index, backup name, namespace name, etc.)

Changes by group

index describe, index delete, index configure (breaking for these three):

• Primary flag renamed from --name to --index-name with shorthand -i
• --name / -n kept as a deprecated alias via MarkDeprecated — prints a warning but continues to work, validated via PreRunE so either flag satisfies the required check
• Example strings and post-success hints updated to use --index-name

All other --index-name commands (stats, vector/*, record/*, import/*, namespace/*, backup/*):

• Shorthand changed from -n to -i to match the new convention

--id on vector query, import cancel, import describe:

• Shorthand -i removed to free it up for --index-name; these flags take UUIDs that are always pasted, not typed, so the shorthand had no ergonomic value, alongside being 2 fewer characters than the full flag.

Type of Change

• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

Test Plan

• just test-unit passes
• Manually verify deprecated alias: pc index describe --name <idx> should print a deprecation warning and still return results
• Manually verify new flag: pc index describe --index-name <idx> and pc index describe -i <idx> work as expected
• e2e suite updated to use --index-name on all describe/delete calls

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 91d709d. Configure here.}