Detect declared config contract manifests

[fqjony]

Summary

• discover root YAML manifests from explicit top-level contract / contracts markers or typed kind + version metadata
• satisfy config contract detection from arbitrary filenames such as work-conf.yaml by combining typed manifest metadata with existing config.env / config.secrets shape detection
• remove the deprecated worker-deployment deploy.yml surface from this repo and from legacy test fixtures
• add env-interface.yaml as the explicit repo-owned dev.kit environment interface so config coverage comes from a declared contract
• bump the package to 0.20.0 as a milestone release for the manifest/interface shift after 0.14.0
• add release strategy/pre-action docs and lightweight workflow-manifest refs to the owning docs
• add regression coverage for typed root manifests, marker-only contract: root manifests, and source/header comments that should not promote ordinary YAML into a contract

Scope

Changed: repo context contract manifest discovery, manifest-root detection signals, release metadata/docs, generated context, env tool recommendations, docker test entrypoints, and test fixtures.
Not changed: no worker.yaml, Worker-specific filename, deprecated deploy.yml, or UDX repo-specific allowlist was added.

Validation

• bash tests/suite.sh --only repo-contract
• make test
• git diff --check
• temp-copy smoke: worker-php reports config: present from worker.yaml via generic typed manifest + config shape detection

[Copilot]

Pull request overview

This PR updates repo contract discovery to detect root YAML manifests that declare config contracts via contract/contracts metadata (instead of relying on filename-specific allowlists), and adds regression coverage ensuring config contract detection works with arbitrary filenames like work-conf.yaml.

Changes:

• Add scanning of root-level YAML files for explicit contract/contracts markers and include them as contract manifests.
• Add regression tests verifying filename-agnostic config contract detection and context.yaml manifest inventory.
• Update changelog and regenerate .rabbit/context.yaml timestamp.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
tests/suite.sh	Adds a new fixture repo (declared-config-repo) and assertions proving config contracts are detected from arbitrary root YAML filenames.
lib/modules/repo_scaffold.sh	Adds root YAML scanning for manifests that declare contract/contracts metadata and includes them in the manifest discovery surface.
changes.md	Documents the shift from filename allowlists to explicit contract metadata detection for config contracts.
.rabbit/context.yaml	Updates generated timestamp to reflect the new context generation.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 9 out of 10 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 23 out of 24 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 23 out of 24 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

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

[Copilot]

Pull request overview

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