feat(validator): add authoring contract metadata

[mikeylong]

Summary

• add generic, advisory-first authoring metadata to the canonical web contract schema
• validate referential integrity for components, slots, states, responsive rules, and web-only authoring fields
• document generator consumption order and add an annotated reference-target example fixture

Testing

• pnpm --filter @surfaces/interfacectl-validator build
• pnpm --filter @surfaces/interfacectl-validator test

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
interfacectl	Ready	Preview, Comment	Mar 12, 2026 9:24pm

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 180443b0d4

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Validate slotBehaviors even when no section slots are known

The knownSlotIds.size > 0 guard means sections[*].responsive.rules[*].slotBehaviors[*].slotId is never validated when a section omits anatomy.slots and has no resolvable defaultComponent, so contracts with completely unknown slot references are accepted as structurally valid. This undermines the new referential-integrity guarantees for responsive metadata and can surface later as generator/runtime failures when a slot behavior targets a slot that does not exist.

Useful? React with 👍 / 👎.