astraform-remote-domain-conformance 0.1.0

Schema-backed conformance runner for Astraform remote-domain.v1 services

astraform-remote-domain-conformance

This is the reusable Python conformance harness for remote-domain.v1.

Brutal truth: if every partner team needs a platform engineer on Zoom to prove their service is valid, you do not have a platform. You have consultancy with a protocol document attached.

This package exercises the real lifecycle:

• manifest
• prepare
• status
• execute-work
• inspection
• shutdown

And it validates payloads against the versioned schema, not just happy-path demo assertions.

Install

Current status: this package has Python packaging metadata and a PyPI release workflow, but no public release has been proven yet. The command below is the intended consumer install shape after the first PyPI publish.

pip install astraform-remote-domain-conformance

Repo-local development:

pip install -e './remote-domain-conformance-python[test]'

Run Against A Live Service

remote-domain-conformance \
  --base-url http://localhost:8092 \
  --domain-id stub-remote

Run Against A Local ASGI App

remote-domain-conformance \
  --app stub_remote_python.main:app \
  --domain-id stub-remote

Python Usage

import asyncio

from astraform.remote_domain.conformance.runner import ConformanceScenario
from astraform.remote_domain.conformance.runner import run_conformance


report = asyncio.run(
    run_conformance(
        base_url="http://localhost:8092",
        scenario=ConformanceScenario(domain_id="stub-remote"),
    )
)

print(report.to_dict())

Publishing Status

This package should be released through the shared Python + Java SDK publishing process documented in docs/platform/remote-domain-sdk-publishing.md.

Release guardrail:

SDK_VERSION=0.1.0 scripts/check-remote-domain-sdk-release-gates.sh

Do not treat it as a partner-ready SDK artifact until a clean external consumer project installs it from PyPI and runs the conformance command outside this monorepo.

Public package note: PyPI distributions expose this SDK implementation. Keep host runtime internals and domain-private logic out of this package.