[aceforeverd]

A generic inputs fields to declare what's missing in this model variant but required at deploy time. This is the part of modelsphere/modelsphere#57

Both requires and inputs are cluster-specific values, but slightly different on how they works:

• .requires: high-level abstraction, helm chart non-aware, swiss fill the gap
• .inputs: much low level, no abstraction, helm chart aware, swiss just fill

Adds inputs to the variant schema, beside requires: chart values every deploy must answer, such as a Mooncake master address. Each input has a key (the chart value's dotted key, as helm --set takes it), a title, type, pattern, example and an optional default.

They're separate from requires because swiss treats them differently. A require is an abstraction swiss interprets and checks against the cluster. An input names one chart value by its key, and swiss only relays its answer.

Swiss puts the answer in the derived layer: the site profile's inputs, else the input's default. The deployer's override goes over it. Every input is required, so swiss refuses a plan that ends without a valid answer for one.

requires:
  gpus: 8
inputs:
  - key: storageKVOffload.mooncake.device
    title: Storage HCAs
    example: mlx5_0
    default: mlx5_3,mlx5_4   # the cluster this variant was tuned on

• Schema: inputs sits at the variant's top level, in v1 version files and v2 variant files alike. The v2 index doesn't carry it, since nothing lists or picks a variant by inputs.
• validate:schema:
  • each key is declared once, and values sets nothing at an input's key or under it;
  • the pattern must compile and is only allowed on a string input;
  • the example and the default must match the type and pattern;
  • model.localPath can never be an input.
• validate:helm: renders each input with its default, else its example.

No rule yet keeps an input off a key swiss derives from requires. The schema can add one later.

No variant uses inputs yet. Converting the Mooncake variants waits until modelsphere/swiss#54 and modelsphere/console#125 are deployed, because an older swissd refuses the unknown key.