feat: allow required variadic flags

[bhouston]

Closes #20

A flag can now be both required: true and variadic: true, meaning it must be supplied at least once and accepts multiple values. This matches Yargs demandOption on array options, Commander mandatory variadic options, and oclif required + multiple. Arguments already allowed this combination.

Changes

• validate: remove the rule rejecting required on variadic flags.
• spec.schema.json (and the copies in validate/ and web/src/): document that required and variadic may be combined, and that minItems/maxItems constrain values when the flag is supplied.
• Tests: replaced the rejection case with a positive validation test, and added a yargs generator test confirming a required variadic flag emits type: "array" with demandOption: true.

No generator changes were needed. Yargs already demands required flags regardless of arity; cobra and urfave-cli do not currently enforce required flags at all, so they are unaffected.

go generate ./... and go test ./... pass.

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[Copilot]

Copilot review overview

🟡 Changes recommended

The Yargs test assertion does not reliably verify the required generated action contract.

Get a fresh assessment by requesting another Copilot review.

Review effort: Lite
Findings: 1

Open (1)

• Assert generated action items type is required · New

What changed in this PR

Allows flags to be both required and variadic, updating validation, schemas, and Yargs coverage.

Changes:

• Permit required variadic flags.
• Update all schema copies.
• Add validation and Yargs generator tests.

File	Summary
web/​src/​spec.schema.json	Documents required variadic flags.
validate/​validate.go	Removes the conflicting validation rule.
validate/​validate_test.go	Adds positive validation coverage.
validate/​spec.schema.json	Updates validator schema documentation.
spec.schema.json	Updates canonical schema documentation.
gen/​cli_yargs_variadic_test.go	Tests required variadic Yargs output; its assertion should verify the exact generated required contract.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[bcdxn]

merged. Thanks again @bhouston!