chore(openspec): migrate specs to v4 structure and enforce validation

[cleithner-comcast]

All 35 specs under openspec/specs/ were authored in the older delta format and failed openspec validate --specs --strict. Flatten them to the v4 main-spec structure (title + Purpose + Requirements) with no change to requirement meaning, and enforce that structure going forward:

• install a pinned openspec CLI in the builder image (version bump 2.14 -> 2.17)
• add .github/workflows/validate-openspec.yaml running strict validation
• add a pre-commit hook running the same strict validation
• vendor the gh-stack agent skill (gh skill install is unavailable here)

Adds the migrate-specs-to-v4 OpenSpec change (proposal, design, specs, tasks). All 35 specs now pass strict validation.

---

_{Stack created with GitHub Stacks CLI • Give Feedback 💬}

[Copilot]

Pull request overview

Migrates the repository’s OpenSpec main specs to the v4 “main-spec” structure (Title + Purpose + Requirements) and adds enforcement so openspec validate --specs --strict becomes a consistently green, CI-gated invariant going forward. It also introduces a documented OpenSpec change (“migrate-specs-to-v4”) capturing the rationale/design/tasks for the migration and enforcement.

Changes:

• Flatten all openspec/specs/**/spec.md documents from delta headers into v4 main-spec structure (and add per-spec Purpose sections).
• Provision and enforce strict spec validation via a pinned openspec CLI in the builder image, a new GitHub Actions workflow, and a pre-commit hook.
• Vendor the gh-stack agent skill into .github/skills/gh-stack/ and add the OpenSpec change artifacts for traceability.

Reviewed changes

Copilot reviewed 48 out of 48 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
openspec/specs/zigbee-subsystem/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/vendor-product-claiming/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/thread-subsystem/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/temperature-humidity-sbmd-drivers/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/sbmd-v4-runtime/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/sbmd-v4-light-driver/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/sbmd-system/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/sbmd-seed-from-attribute/spec.md	Add v4 title/purpose/requirements header for the spec.
openspec/specs/sbmd-script-execution-limits/spec.md	Flatten delta sections into v4 requirements section; remove leftover delta header.
openspec/specs/sbmd-runtime-observability/spec.md	Reword one requirement to be normative (SHALL) for strict validation.
openspec/specs/sbmd-resource-prerequisites/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/resource-model/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/release-workflow/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/python-sideband-client/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/public-api/spec.md	Convert to v4 structure; add scenarios needed for strict validation.
openspec/specs/observability-metrics/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/matterjs-virtual-device-framework/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/matterjs-door-lock-device/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/matter-thermostat-testing/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/matter-thermostat-sbmd/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/matter-test-infrastructure/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/matter-subsystem/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/endpoint-cluster-fallback/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/device-type-endpoint-resolution/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/device-drivers/spec.md	Convert to v4 structure; reword non-normative language and add scenarios.
openspec/specs/core-services/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/changelog-generation/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/build-system/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/agent-skill-validate-sbmd/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/agent-skill-unit-tests/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/agent-skill-matter-devices/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/agent-skill-integration-tests/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/agent-skill-format-code/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/agent-skill-debug/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/specs/agent-skill-build/spec.md	Convert to v4 main-spec structure (title/purpose/requirements).
openspec/changes/migrate-specs-to-v4/tasks.md	Add implementation task list for the migration/enforcement change.
openspec/changes/migrate-specs-to-v4/specs/spec-validation/spec.md	Add delta spec capturing new validation/enforcement requirements.
openspec/changes/migrate-specs-to-v4/proposal.md	Add change proposal documenting motivation/scope/impact.
openspec/changes/migrate-specs-to-v4/design.md	Add design decisions/risks/migration plan for the change.
openspec/changes/migrate-specs-to-v4/.openspec.yaml	Declare change schema and creation date.
hooks/pre-commit	Add local strict OpenSpec validation to pre-commit.
docker/version	Bump builder image version to reflect new tooling.
docker/Dockerfile	Install pinned openspec CLI (via npm) into the builder image.
.github/workflows/validate-openspec.yaml	Add CI gate that runs strict OpenSpec validation in PRs.
.github/skills/gh-stack/SKILL.md	Vendor gh-stack agent skill documentation.
.github/skills/gh-stack/references/troubleshooting.md	Vendor gh-stack troubleshooting reference.
.github/skills/gh-stack/references/stack-design.md	Vendor gh-stack stack design reference.
.github/skills/gh-stack/references/commands.md	Vendor gh-stack command behavior reference.

[Copilot]

Pull request overview

Copilot reviewed 48 out of 48 changed files in this pull request and generated no new comments.

Suppressed comments (4)

openspec/changes/migrate-specs-to-v4/proposal.md:26

• This states the builder image version bump is 2.14 → 2.17, but the actual docker/version change in this PR is 2.15 → 2.17. Update the proposal to match the repository’s current prior version so the change record stays accurate.

- **Build image**: `docker/Dockerfile` gains a pinned `openspec` install (Node.js 22 is already present); `docker/version` bumped (2.14 → 2.17, chosen to avoid collision with in-flight builder bumps on parallel branches). Consumers must repull the builder image.

openspec/changes/migrate-specs-to-v4/design.md:24

• The design doc claims docker/version is currently 2.14 and references a 2.14 → 2.17 bump, but the repo’s prior version is 2.15 (per the docker/version diff). Please update these numbers to keep the design document consistent with the actual history.

Node.js 22 is already installed in the builder image, so the `openspec` npm CLI can be added there. `docker/version` is currently `2.14`.

openspec/changes/migrate-specs-to-v4/design.md:54

• The design doc claims docker/version is currently 2.14 and references a 2.14 → 2.17 bump, but the repo’s prior version is 2.15 (per the docker/version diff). Please update these numbers to keep the design document consistent with the actual history.

   docker/version:  2.14 → 2.17   (2.15/2.16 taken by parallel branches)

openspec/changes/migrate-specs-to-v4/tasks.md:17

• This task item indicates docker/version was bumped 2.14 → 2.17, but the actual change shown in docker/version is 2.15 → 2.17. Update the task text to reflect the real before/after versions so the checklist remains an accurate audit trail.

- [x] 3.2 Bump `docker/version` (2.14 → 2.17)

[rdkcmf-jenkins]

b'## Blackduck scan failure details

Summary: 0 violations, 0 files pending approval, 1 file pending identification.

• Protex Server Path: /home/blackduck/github/BartonCore/258/rdkcentral/BartonCore

• Commit: 9efb5ea

Report detail: gist'

[Copilot]

Pull request overview

Copilot reviewed 49 out of 49 changed files in this pull request and generated no new comments.

Suppressed comments (5)

openspec/changes/migrate-specs-to-v4/design.md:54

• This example still shows docker/version: 2.14 → 2.17 and mentions 2.15/2.16 as taken. Since this PR bumps docker/version from 2.15 to 2.17, the example (and collision note) should be updated to match.

   docker/version:  2.14 → 2.17   (2.15/2.16 taken by parallel branches)

openspec/changes/migrate-specs-to-v4/design.md:69

• This risk note references a collision with version 2.15, but docker/version is already 2.15 in this PR's base (and is being bumped to 2.17). Consider updating the referenced conflicting versions so the rationale matches the version history.

- **Builder image version collision with parallel branches (2.15 webrtc, 2.16 testSpeedup).** → Bump to 2.17; reconcile at merge time if another branch also claims it.

openspec/changes/migrate-specs-to-v4/proposal.md:26

• This Impact bullet says docker/version was bumped 2.14 → 2.17, but the actual version file change in this PR is 2.15 → 2.17. Please align the numbers so the change record stays accurate.

- **Build image**: `docker/Dockerfile` gains a pinned `openspec` install (Node.js 22 is already present); `docker/version` bumped (2.14 → 2.17, chosen to avoid collision with in-flight builder bumps on parallel branches). Consumers must repull the builder image.

openspec/changes/migrate-specs-to-v4/tasks.md:17

• The noted docker image version bump here is out of sync with the actual docker/version change in this PR (2.15 → 2.17). Updating the task entry avoids confusion when cross-checking the bump.

- [x] 3.2 Bump `docker/version` (2.14 → 2.17)

openspec/changes/migrate-specs-to-v4/design.md:24

• docker/version is described here as currently 2.14, but in this PR the file changes from 2.15 to 2.17. Aligning the stated current version keeps the design doc consistent with the repo state.

This issue also appears in the following locations of the same file:

• line 54
• line 69

Node.js 22 is already installed in the builder image, so the `openspec` npm CLI can be added there. `docker/version` is currently `2.14`.