[ben-kalmus]

Summary

• Compositions and rules commands pick the id from a list when it is omitted on a terminal.
• Breaking: upsert is replaced by insert <id> and update [id].
• --interactive suggests live values with Tab (indices, attributes, sort labels, filters). Shell completion covers composition and rule ids.

Prerequisite

• Based on feat(interactive): show SDK field help and examples on every prompt #295 (merge it first). It carries the TEMP replace the SDK commit, to drop once feat(go): expose field description and example metadata in generated models api-clients-automation#7180 is released.

Stacked PRs

• feat(interactive): show SDK field help and examples on every prompt #295
  • Interactive package uses SDK field metadata
• feat(compositions): id selectors, insert and update commands, live suggestions #296 <- this PR
  • Id selectors, insert / update, live suggestions

Changes

• insert / update (compositions and rules): insert creates under a typed id. update edits an existing one and shows a selector when the id is omitted.
  • Why the split: upsert took either a new or an existing id, so it could not offer a selector. A selector only fits editing, and creating needs a typed new id. Both still send the same PUT.
• Selectors: get, delete, sorting-strategy and rules get|delete|list also select the id when omitted on a terminal. Without a terminal, a missing id is still an error.
• Tab suggestions: index names, attributes of the in-scope index, filters templates (attribute:) and sortBy labels. An API error just means no suggestions.
• Completion: cmdutil.CompositionIDs and CompositionAndRuleIDs complete ids for the valid args.
• Helpers live in pkg/cmd/compositions/internal (select.go, suggest.go).

Notes

• With a suggestion list open, Enter submits the highlighted item. To extend a template such as CookTime:, type the rest instead.
• compositions search has no index prompt, so filters offers only the SDK example there.

Testing

go test ./pkg/... passes and each commit builds.

🤖 Generated with Claude Code

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

🟢 Metrics 105 complexity · 43 duplication

Metric	Results
Complexity	105
Duplication	43

View in Codacy

_{TIP This summary will be updated as you push new changes.}