Ciridae

Public Python clients, models, and project utilities consumed by Ciridae services, standalone projects, and templates.

The domain libraries remain the source owners in libs/auth-client, libs/mcp-access, and libs/project-yaml. This directory only assembles their ciridae.* namespaces into one public distribution. The owner directories are virtual uv projects for scoped tests and tooling; they do not build separate distributions. Internal consumers resolve ciridae from the workspace, whose editable install links directly to those owner files.

public-package-files.txt is the reviewed artifact boundary. It approves the three owned namespaces as public; sources outside those namespace patterns fail the build.

The PyPI distribution is ciridae. Import from the relevant domain namespace:

from ciridae.auth import AuthServiceAccessResponse, AuthServiceClient
from ciridae.mcp import CiridaeMcpClient, ProjectToolInventoryResponse
from ciridae.project import ProjectDefinition

Validate a project.yaml file with the same packaged contract:

ciridae validate-project project.yaml

Releasing

1. Update version in pyproject.toml.
2. Merge the change to main.
3. Push the matching tag, for example ciridae-v0.1.0.

Before 1.0, use a patch bump for backward-compatible changes, including additive APIs and project.yaml contract or bundled-default updates. Use a minor bump for breaking changes. After 1.0, use patch for fixes, minor for backward-compatible additions, and major for breaking changes.

The tag publishes through PyPI Trusted Publishing. Releases are immutable; change the version rather than replacing an existing artifact.