Merge pull request #29 from udx/fix/declared-config-contracts

Detect declared config contract manifests

Author: fqjony

.github/workflows/npm-release-ops.yml

@@ -1,5 +1,10 @@
 name: Release
 
+# Release strategy and pre-actions:
+# - docs/release.md
+# Release probe and publication verification guidance:
+# - docs/real-repo-validation.md
+
 on:
   push:
   workflow_dispatch:

.rabbit/context.yaml

@@ -5,8 +5,8 @@ version: udx.dev/dev.kit/v1
 generator:
   tool: dev.kit
   repo: https://github.com/udx/dev.kit
-  version: 0.14.0
-  generated_at: 2026-07-05T18:19:05Z
+  version: 0.20.0
+  generated_at: 2026-07-08T15:15:15Z
   sources:
     homepage: https://udx.dev/kit
     repository: https://github.com/udx/dev.kit
@@ -27,13 +27,14 @@ refs:
   - ./changes.md
   - ./Makefile
   - ./docs/real-repo-validation.md
+  - ./docs/release.md
   - ./src/configs/archetypes.yaml
   - ./src/configs/audit-rules.yaml
   - ./src/configs/context-config.yaml
   - ./src/configs/detection-patterns.yaml
   - ./src/configs/detection-signals.yaml
   - ./src/configs/repo-validation.yaml
-  - ./deploy.yml
+  - ./env-interface.yaml
   - ./.github/workflows
   - ./docs
 
@@ -60,13 +61,6 @@ dependencies:
     used_by:
       - .github/workflows/context7-ops.yml
       - .github/workflows/npm-release-ops.yml
-  - repo: udx/worker
-    kind: manifest contract (deploy)
-    resolved: true
-    declared_as: udx.io/worker-v1/deploy
-    archetype: manifest-repo
-    used_by:
-      - deploy.yml
 
 # Manifests — YAML files that define repo-specific workflow, deploy, or contract behavior.
 # Note: Include custom config/manifests that materially shape repo behavior or contract understanding.
@@ -143,28 +137,12 @@ manifests:
       - path reference: docs/real-repo-validation.md
       - path reference: lib/modules/config_catalog.sh
       - path reference: tests/real-repos.sh
-  - path: deploy.yml
-    kind: workerDeployConfig
-    declared_as: udx.io/worker-v1/deploy
-    source_repo: udx/worker
+  - path: env-interface.yaml
+    kind: devKitEnvInterface
+    description: Environment variables that control dev.kit installation, command behavior, and test probes.
+    declared_as: udx.dev/dev.kit-v1/config
     used_by:
-      - Makefile
-      - docs/context-contract.md
-      - docs/references/command-surfaces.md
-      - docs/references/config-contract-surfaces.md
-      - docs/repo-contract-boundary.md
-      - lib/modules/repo_factors.sh
-      - src/configs/context-config.yaml
-      - src/configs/detection-signals.yaml
-      - tests/suite.sh
+      - changes.md
     evidence:
-      - version: udx.io/worker-v1/deploy
-      - path reference: Makefile
-      - path reference: docs/context-contract.md
-      - path reference: docs/references/command-surfaces.md
-      - path reference: docs/references/config-contract-surfaces.md
-      - path reference: docs/repo-contract-boundary.md
-      - path reference: lib/modules/repo_factors.sh
-      - path reference: src/configs/context-config.yaml
-      - path reference: src/configs/detection-signals.yaml
-      - path reference: tests/suite.sh
+      - version: udx.dev/dev.kit-v1/config
+      - path reference: changes.md

AGENTS.md

@@ -24,7 +24,7 @@ _Normalized repo-owned guidance for agents. Keep it aligned with `docs/reference
 
 ## Workflow
 
-- read: `README.md`, `changes.md`, `deploy.yml`, `.github/workflows/`, `docs/`
+- read: `README.md`, `changes.md`, `.github/workflows/`, `docs/`
 - verify: `make test`
 
 ## Notes

Makefile

@@ -10,15 +10,14 @@ test:
 test-real:
 	bash tests/real-repos.sh
 
-# Run tests inside the worker container via deploy.yml
-# Requires @udx/worker-deployment: npm install -g @udx/worker-deployment
+# Run tests inside the worker container without the deprecated worker-deployment manifest.
 test-docker:
-	worker run
+	docker run --rm -v "$(CURDIR):/workspace" -w /workspace $(WORKER_IMAGE) bash tests/suite.sh
 
 # Interactive shell inside the worker container for debugging
 test-shell:
-	worker run run-it
+	docker run --rm -it -v "$(CURDIR):/workspace" -w /workspace $(WORKER_IMAGE) bash
 
 # Pull the worker image explicitly
 test-docker-pull:
-	docker pull $(WORKER_IMAGE)
+	docker pull $(WORKER_IMAGE)

README.md

@@ -182,6 +182,7 @@ All commands support `--json`.
 - [Environment Config](docs/environment-config.md)
 - [Context Coverage](docs/context-coverage.md)
 - [Integration](docs/integration.md)
+- [Release](docs/release.md)
 - [Real Repo Validation](docs/real-repo-validation.md)
 - [Smart Dependency Detection](docs/smart-dependency-detection.md)
 - [Reference Docs](docs/references/README.md)

changes.md

@@ -1,5 +1,12 @@
 # Changes
 
+### 0.20.0
+
+- Discover root YAML config contracts from explicit top-level `contract` / `contracts` metadata or typed `kind` + `version` manifests instead of filename-specific allowlists.
+- Remove the deprecated worker-deployment `deploy.yml` surface and keep manifest discovery/dependency tracing covered by arbitrary typed root YAML such as `work-conf.yaml`.
+- Add an explicit `env-interface.yaml` for dev.kit's own environment contract so config coverage comes from a repo-owned interface declaration.
+- Document release strategy and pre-actions so PRs check the published version first, reserve the next version, update `changes.md`, regenerate context, and validate before merge.
+
 ### 0.14.0
 
 - Ignore command examples from `docs/references/` when generating repo command contracts, preventing reference docs from creating misleading `build` or `run` commands.

deploy.yml

@@ -12,7 +12,7 @@ The generated contract is `.rabbit/context.yaml`.
 - `AGENTS.md`, `CLAUDE.md`, and similar repo-owned instruction files
 - `README.md`, `changes.md`, and focused docs
 - `.github/workflows/`
-- manifests such as `deploy.yml`, package manifests, Docker files, and structured YAML configs
+- manifests such as typed YAML configs, package manifests, Docker files, and workflow contracts
 - scripts, Makefiles, tests, and checked-in examples that define runnable behavior
 
 Live services such as GitHub issues, PRs, reviews, and workflow runs can help a current task, but they should not become durable repo truth inside `.rabbit/context.yaml`.

docs/context-contract.md

@@ -25,7 +25,7 @@ Workflow and operational contracts are often packaged in:
 - `.github/workflows/*.yml` when the workflow expresses repo-specific execution contracts
 - reusable workflow refs
 - Docker build and runtime files
-- deploy manifests such as `deploy.yml`
+- typed runtime manifests and workflow files
 - repo docs that explain how those assets fit together
 
 Docs should explain execution behavior, tradeoffs, and decision points. The runnable contract should stay in scripts and manifests.
@@ -80,7 +80,7 @@ A repo may expose its main flow through a mix like:
 
 - `Makefile` for `make test`, `make build`, `make run`
 - `.github/workflows/` for CI/CD execution
-- `deploy.yml` for deploy contract details
+- typed runtime manifests or workflow files for deploy contract details
 - `docs/` for operator-facing explanation
 
 That is valid as long as the repo makes those surfaces clear and traceable.

docs/references/command-surfaces.md

@@ -10,7 +10,7 @@ Configuration is often declared through:
 
 - `.env.example`, `.env.sample`, or `.env.template`
 - focused repo docs such as `README.md` or `docs/config.md`
-- deploy manifests such as `deploy.yml`
+- typed YAML manifests with explicit config metadata
 - versioned YAML/JSON manifests with explicit config metadata or runtime config sections
 - checked-in example config files when the repo uses a custom format