orchestrata_ultimate.promotion

Reference › orchestrata_ultimate › promotion › init

Package marker for deployment. It re-exports the result types from models and the project discovery helpers from projects; a test checks these re-exports against the promote_env script. See the package page.

At a glance

Class diagram

No classes; see Functions.

Dependency diagram

API

No public API: the module defines no classes, functions or constants.

Source

Permalink: https://gitlab.com/MSamy/orchestrata-ultimate-architecture/-/blob/a4cbc2bdf/src/orchestrata_ultimate/promotion/__init__.py

"""Deployment — what ``promote`` has to mean.

``promote_env.py`` used to record a receipt: gate satisfied, target reachable,
timestamp written. It moved no code, restarted nothing, and verified nothing
afterward. That made ``PROMOTED`` a claim with no referent — measured
2026-08-10, the ledger read ``PROMOTED`` while prod ran a tree 76 commits
behind, and both statements were "true" under that definition.

This package makes promotion mean deployment: pin a commit, put it on the
target, restart what runs it, PROVE the result, and record the sha so the
question "what is in prod?" has an answer. Verification is the load-bearing
part — a deploy that does not verify is a hopeful restart, the runtime twin of
a suite run that skips the kernel.

Every stage is idempotent (re-running a completed deploy is a no-op) and
supports ``execute=False``, which returns what it WOULD do without touching
anything. That is not a testing affordance bolted on: it is the ``--dry-run``
the operator needs before restarting a live system, and it is what lets the
tests assert real decisions without bouncing prod.
"""

from orchestrata_ultimate.promotion.models import (
    DeployReport,
    StageResult,
    StageStatus,
)
from orchestrata_ultimate.promotion.projects import (
    Project,
    discover_projects,
    is_worktree,
)

__all__ = [
    "DeployReport",
    "Project",
    "StageResult",
    "StageStatus",
    "discover_projects",
    "is_worktree",
]