Add a non-normative hardware-contract TOML example for owner review

[swgiacomelli]

Summary

• Non-normative guidance only. This does not change Repository Standards, does not define an organization-wide schema, and does not require existing Markdown hardware contracts to migrate.
• Affected class: peripheral-driver repositories that already keep interpreted device or analog-front-end claims and need predictable owner-review state.
• Why: GitHub-flavored markdown [ ] cannot mean both "not yet reviewed" and "reviewed, sources silent," and an unchecked repository-owned decision looks non-binding even when the README has named it.
• What: add docs/peripheral-driver-resources/HARDWARE_CONTRACT.toml.example (synthetic EX1234 placeholders) and document the declared / provisional / confirmed / omission vocabulary in the existing source-registry resource pack and documentation guide, the same optional-adoption pattern as SOURCES.toml.example.
• Supporting experience: ph-temt6000-als Add portable device behavioral model skill #17 needed a binding named reference AFE while vendor-source rows stayed provisional; markdown checkboxes could not express that split.

Test plan

• Confirm the change is identified as non-normative in the PR, changelog, and resource-pack status line.
• Confirm no Repository Standards / auditor policy edits.
• HARDWARE_CONTRACT.toml.example parses as TOML and retains synthetic placeholders.
• Relative links from the documentation guide and resource-pack README resolve.

Made with Cursor

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 532e6c207a

ℹ️ 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".

[swgiacomelli]

Addressed the review findings in commit fe442fc:

• Replaced the duplicated top-level default identity with default_identity_row, so one declared row value is canonical.
• Defined the permitted review / provenance relationships and required every vendor-source row to resolve a stable source ID through either docs/SOURCES.toml or an inline [[source]] record.
• Scoped omission to its recorded source and search_scope; broader silence now requires one row per reviewed source or an explicitly documented local multi-source form.
• Expanded the adoption checks to cover unique IDs, default-row resolution, source resolution, reproducible evidence, and scoped omissions.
• Removed the stale example.invalid sentinel wording and updated the changelog.

Validation completed: the example parses as TOML, all five example rows satisfy the documented source/state invariants, relative links resolve, git diff --check passes, and all 21 repository tests pass.