Skip to content

Clarify registryctl's 1.0 adopter contract#463

Closed
jeremi wants to merge 5 commits into
mainfrom
agent/registryctl-adopter-contract
Closed

Clarify registryctl's 1.0 adopter contract#463
jeremi wants to merge 5 commits into
mainfrom
agent/registryctl-adopter-contract

Conversation

@jeremi

@jeremi jeremi commented Jul 23, 2026

Copy link
Copy Markdown
Member

What changed

  • Preserve the current v0.12.2 project starters while making the evidence-versus-programme-decision boundary explicit across DHIS2, snapshot, and custom integration journeys.
  • Remove the hidden init relay and init spreadsheet-api aliases so the supported project-authoring workflow is the single canonical setup path.
  • Define a strict, versioned registryctl smoke report and deterministic exit-status contract with matching schema, tests, reference documentation, and integration fixtures.

Why

The pre-1.0 surface mixed evidence production with downstream programme decisions and retained setup aliases outside the documented workflow. That made the product harder to learn and left automation without a stable smoke contract.

Implementer impact

Implementers get one supported authoring path, clearer responsibility boundaries, and a machine-readable smoke result suitable for CI without scraping prose.

Validation

  • cargo fmt --check
  • cargo test --locked -p registryctl (262 passed)
  • python3 -m unittest release/scripts/test_integration_e2_runner.py (37 passed)
  • npm test (117 passed)
  • npm run check:content
  • npm run check:markdown (0 errors)
  • prohibited-pattern scan and git diff --check

Review note

This touches Tier-C security/privacy documentation. Maintainer source-pack sign-off is required before merge.

Closes #417.
Closes #238.

jeremi added 2 commits July 23, 2026 15:51
Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
@jeremi
jeremi marked this pull request as ready for review July 23, 2026 13:58
jeremi added 3 commits July 23, 2026 21:56
Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>

jeremi commented Jul 24, 2026

Copy link
Copy Markdown
Member Author

Superseded by #469, the single ready integration PR for this reviewed 1.0 batch. This PR's exact head is preserved as an ancestor of #469, so its implementation and commit history are retained; only the merge path has been consolidated.

@jeremi jeremi closed this Jul 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Make the Relay → Notary → programme decision boundary normative for 1.0 Spec: author the registryctl adopter contract

1 participant