mainsequence 6.0.22__tar.gz → 6.0.24__tar.gz

{mainsequence-6.0.22/mainsequence.egg-info → mainsequence-6.0.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 6.0.22
+Version: 6.0.24
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: LicenseRef-MainSequence-Proprietary

{mainsequence-6.0.22 → mainsequence-6.0.24}/agent_scaffold/skills/platform_operations/orchestration_and_releases/SKILL.md

@@ -209,14 +209,14 @@ Validate the deployment path, not the Streamlit design.
 
 `automatic_deployment` is the automated deployment opt-in flag on a `ResourceRelease`. It means repository synchronization can rotate an existing release to the latest synced project commit for the same resource path.
 
-When `automatic_deployment=True`, repository-sync events may create a `ResourceReleaseAutomaticDeploymentRun` with source `repository_event`. That run:
+When `automatic_deployment=True`, repository-sync events may create a unified `DeploymentRun` with `target_type="resource_release"` and source `repository_event`. That run:
 
 - reads the project's current synced commit
 - resolves the current project resource at the release's existing resource path
 - resolves the current adjacent `README.md` when the release kind requires one, such as Streamlit dashboards
 - creates or resolves the project image for that commit
 - redeploys the existing release to the current resource, README, and project image
-- records status, current step, revision context, image/resource context, result, and errors on the deployment run
+- records state, phase, outcome, revision context, artifact context, steps, logs, result, and errors on the deployment run
 
 This is not a local development shortcut. It does not deploy unpushed local files. The repository must be pushed, the project repository must be synced, and project resource discovery must find the resource at the same path for the current commit.
 
@@ -247,28 +247,12 @@ The SDK surface also accepts:
 - `ProjectResource.create_dashboard(..., automatic_deployment=True)`
 - `ProjectResource.create_fastapi(..., automatic_deployment=True)`
 - `ResourceRelease.create(..., automatic_deployment=True)`
-- `ResourceRelease.deploy_current_version()` for an SDK-triggered manual deployment run
+- `ResourceRelease.deploy_current_version()` for an SDK-triggered manual deployment run; it returns `DeploymentRun`
+- `DeploymentRun.filter(target_type="resource_release", target_uid=release.uid)` to inspect runs for one release
 
 Do not claim there is a CLI command for `deploy_current_version` unless the local CLI actually exposes one. In this SDK, the manual detail action is available through the client model.
 
-Automatic deployment runs can have these statuses:
-
-- `pending`
-- `running`
-- `waiting_project_image`
-- `waiting_runtime_ready`
-- `no_action`
-- `deployed`
-- `skipped`
-- `blocked`
-- `failed`
-
-Important blocked/skipped cases include:
-
-- `automatic_deployment_disabled`: repository-event rotation skipped because the release is not opted in
-- `project_current_version_missing`: the project has no current synced version
-- `resource_missing_for_current_commit`: no resource exists at the release path for the latest synced commit
-- `readme_missing_for_current_commit`: a dashboard-style release needs an adjacent README for the current commit
+Inspect the unified run's `state`, `phase`, `outcome`, `steps`, `logs`, and `error` fields. Do not use legacy resource-release deployment status fields or filters.
 
 ## Review Rules
 

{mainsequence-6.0.22 → mainsequence-6.0.24}/mainsequence/client/base.py

@@ -100,7 +100,6 @@ class BaseObjectOrm:
         "GithubOrganization": "github-organizations",
         "ProjectResource": "project-resources",
         "ResourceRelease": "resource-releases",
-        "ResourceReleaseAutomaticDeploymentRun": "deployment-runs",
         "DeploymentRun": "deployment-runs",
         "Bucket": "buckets",
     }

{mainsequence-6.0.22 → mainsequence-6.0.24}/mainsequence/client/models_helpers.py

@@ -963,6 +963,24 @@ class ResourceReleaseKind(str, Enum):
     STATIC_SITE = "static_site"
 
 
+class AutomaticRedeploymentPolicy(BaseModel):
+    tag_regex: str | None = Field(
+        ...,
+        title="Tag Regex",
+        description=(
+            "Regular expression matched against immutable repository tags. "
+            "Null enables redeployment for every commit."
+        ),
+        examples=[None, r"^v(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)$"],
+    )
+    policy_revision: PositiveInt = Field(
+        ...,
+        title="Policy Revision",
+        description="Immutable revision of the current automatic redeployment policy.",
+        examples=[1, 3],
+    )
+
+
 class ResourceRelease(ShareableObjectMixin, BaseObjectOrm, BasePydanticModel):
     FILTERSET_FIELDS: ClassVar[dict[str, list[str]]] = {
         "uid": ["exact", "in"],
@@ -1065,6 +1083,14 @@ class ResourceRelease(ShareableObjectMixin, BaseObjectOrm, BasePydanticModel):
         ),
         examples=[False, True],
     )
+    automatic_redeployment_policy: AutomaticRedeploymentPolicy | None = Field(
+        default=None,
+        title="Automatic Redeployment Policy",
+        description=(
+            "Backend-owned tag matching policy and its current immutable revision. "
+            "The revision is returned by the API and is not part of create requests."
+        ),
+    )
 
     @classmethod
     def create(
@@ -1148,7 +1174,7 @@ class ResourceRelease(ShareableObjectMixin, BaseObjectOrm, BasePydanticModel):
         self,
         *,
         timeout: int | float | tuple[float, float] | None = None,
-    ) -> ResourceReleaseAutomaticDeploymentRun:
+    ) -> DeploymentRun:
         data = self._request_detail_action(
             r_type="POST",
             action_name="deploy-current-version",
@@ -1156,116 +1182,7 @@ class ResourceRelease(ShareableObjectMixin, BaseObjectOrm, BasePydanticModel):
             timeout=timeout,
             expected_statuses=(200, 202),
         )
-        return ResourceReleaseAutomaticDeploymentRun(**data)
-
-
-class ResourceReleaseAutomaticDeploymentRun(BaseObjectOrm, BasePydanticModel):
-    FILTERSET_FIELDS: ClassVar[dict[str, list[str]]] = {
-        "resource_release__uid": ["exact", "in"],
-        "status": ["exact", "in"],
-        "release_kind": ["exact", "in"],
-        "automatic_deployment_source": ["exact", "in"],
-    }
-    FILTER_VALUE_NORMALIZERS: ClassVar[dict[str, str]] = {
-        "resource_release__uid": "uid",
-        "status": "str",
-        "release_kind": "str",
-        "automatic_deployment_source": "str",
-    }
-
-    STATUS_PENDING: ClassVar[str] = "pending"
-    STATUS_RUNNING: ClassVar[str] = "running"
-    STATUS_WAITING_PROJECT_IMAGE: ClassVar[str] = "waiting_project_image"
-    STATUS_WAITING_RUNTIME_READY: ClassVar[str] = "waiting_runtime_ready"
-    STATUS_NO_ACTION: ClassVar[str] = "no_action"
-    STATUS_DEPLOYED: ClassVar[str] = "deployed"
-    STATUS_SKIPPED: ClassVar[str] = "skipped"
-    STATUS_BLOCKED: ClassVar[str] = "blocked"
-    STATUS_FAILED: ClassVar[str] = "failed"
-
-    SOURCE_MANUAL: ClassVar[str] = "manual"
-    SOURCE_REPOSITORY_EVENT: ClassVar[str] = "repository_event"
-
-    uid: str | None = Field(
-        None,
-        title="Resource Release Automatic Deployment Run UID",
-        description="Public UID of the automatic deployment run.",
-    )
-    resource_release_uid: str | None = Field(
-        None,
-        title="Resource Release UID",
-        description="Public UID snapshot of the resource release targeted by this run.",
-    )
-    resource_release_name: str = Field(
-        default="",
-        title="Resource Release Name",
-        description="Display-name snapshot of the targeted resource release.",
-    )
-    release_kind: ResourceReleaseKind | str | None = Field(
-        None,
-        title="Release Kind",
-        description="Resource release kind targeted by this run.",
-    )
-    status: str | None = Field(
-        None,
-        title="Status",
-        description="Deployment run status.",
-    )
-    current_step: str = Field(
-        default="",
-        title="Current Step",
-        description="Current orchestration step key.",
-    )
-    automatic_deployment_source: str | None = Field(
-        None,
-        title="Automatic Deployment Source",
-        description="Run trigger source, for example manual or repository_event.",
-    )
-    revision_context: dict[str, Any] = Field(
-        default_factory=dict,
-        title="Revision Context",
-        description="Stable project/revision/resource context for the run.",
-    )
-    trigger_context: dict[str, Any] = Field(
-        default_factory=dict,
-        title="Trigger Context",
-        description="Repository event or manual trigger correlation metadata.",
-    )
-    image_artifact_context: dict[str, Any] = Field(
-        default_factory=dict,
-        title="Image Artifact Context",
-        description="Project image and resource snapshots captured by the run.",
-    )
-    cleanup_context: dict[str, Any] = Field(
-        default_factory=dict,
-        title="Cleanup Context",
-        description="Cleanup outcomes captured by the run.",
-    )
-    started_at: datetime.datetime | None = Field(
-        None,
-        title="Started At",
-        description="Timestamp when execution started.",
-    )
-    finished_at: datetime.datetime | None = Field(
-        None,
-        title="Finished At",
-        description="Timestamp when execution finished.",
-    )
-    result: dict[str, Any] = Field(
-        default_factory=dict,
-        title="Result",
-        description="Terminal or intermediate deployment result payload.",
-    )
-    error_code: str = Field(
-        default="",
-        title="Error Code",
-        description="Machine-readable error code when the run failed or was blocked.",
-    )
-    error_detail: str = Field(
-        default="",
-        title="Error Detail",
-        description="Human-readable error detail when the run failed or was blocked.",
-    )
+        return DeploymentRun(**data)
 
 
 class DeploymentRunTarget(BaseModel):

{mainsequence-6.0.22 → mainsequence-6.0.24/mainsequence.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 6.0.22
+Version: 6.0.24
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: LicenseRef-MainSequence-Proprietary

{mainsequence-6.0.22 → mainsequence-6.0.24}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mainsequence"
-version = "6.0.22"
+version = "6.0.24"
 description = "Main Sequence SDK "
 readme = "README.md"
 requires-python = ">=3.13"

{mainsequence-6.0.22 → mainsequence-6.0.24}/tests/test_filter_normalization.py

@@ -2041,7 +2041,7 @@ def test_resource_release_model_accepts_collection_payload_without_runtime_child
     assert release.related_job_uid is None
 
 
-def test_resource_release_models_support_automatic_deployment_payloads():
+def test_resource_release_model_supports_automatic_deployment_payloads():
     release_uid = "2f4c4c3d-5669-4da5-9d86-b84633c1e6ed"
     resource_uid = "857bec7b-dd77-4272-aecd-13fc2138eacc"
     job_uid = "7d0ab07c-d1c0-4b7f-9c69-3c1a41c0a4da"
@@ -2055,40 +2055,30 @@ def test_resource_release_models_support_automatic_deployment_payloads():
             "related_job_uid": job_uid,
             "release_kind": "fastapi",
             "automatic_deployment": True,
+            "automatic_redeployment_policy": {
+                "tag_regex": None,
+                "policy_revision": 3,
+            },
         }
     )
 
     assert release.uid == release_uid
     assert release.release_kind == models_helpers_mod.ResourceReleaseKind.FAST_API
     assert release.automatic_deployment is True
+    assert release.automatic_redeployment_policy is not None
+    assert release.automatic_redeployment_policy.tag_regex is None
+    assert release.automatic_redeployment_policy.policy_revision == 3
 
-    run = models_helpers_mod.ResourceReleaseAutomaticDeploymentRun.model_validate(
-        {
-            "uid": "11111111-1111-4111-8111-111111111111",
-            "resource_release_uid": release_uid,
-            "resource_release_name": "analytics-123",
-            "release_kind": "fastapi",
-            "status": "waiting_project_image",
-            "current_step": "wait_project_image",
-            "automatic_deployment_source": "manual",
-            "revision_context": {"current_commit_sha": "abc123"},
-            "trigger_context": {},
-            "image_artifact_context": {"project_image": {"state": "waiting"}},
-            "cleanup_context": {},
-            "started_at": "2026-01-01T00:00:00Z",
-            "finished_at": None,
-            "result": {},
-            "error_code": "",
-            "error_detail": "",
-        }
-    )
 
-    assert run.resource_release_uid == release_uid
-    assert (
-        run.status
-        == models_helpers_mod.ResourceReleaseAutomaticDeploymentRun.STATUS_WAITING_PROJECT_IMAGE
-    )
-    assert run.revision_context["current_commit_sha"] == "abc123"
+def test_legacy_resource_release_deployment_run_model_is_not_exported():
+    import mainsequence.client as client_package
+
+    legacy_name = "ResourceReleaseAutomaticDeploymentRun"
+
+    assert not hasattr(models_helpers_mod, legacy_name)
+    assert not hasattr(client_package, legacy_name)
+    with pytest.raises(KeyError, match=legacy_name):
+        models_helpers_mod.get_model_class(legacy_name)
 
 
 def test_resource_release_create_sends_automatic_deployment(monkeypatch):
@@ -2110,6 +2100,10 @@ def test_resource_release_create_sends_automatic_deployment(monkeypatch):
                 "related_job_uid": "7d0ab07c-d1c0-4b7f-9c69-3c1a41c0a4da",
                 "release_kind": "fastapi",
                 "automatic_deployment": True,
+                "automatic_redeployment_policy": {
+                    "tag_regex": "^v[0-9]+\\.[0-9]+\\.[0-9]+$",
+                    "policy_revision": 1,
+                },
             }
 
     def _fake_make_request(*, s, loaders, r_type, url, payload, time_out=None):
@@ -2132,6 +2126,9 @@ def test_resource_release_create_sends_automatic_deployment(monkeypatch):
     )
 
     assert release.automatic_deployment is True
+    assert release.automatic_redeployment_policy is not None
+    assert release.automatic_redeployment_policy.tag_regex == "^v[0-9]+\\.[0-9]+\\.[0-9]+$"
+    assert release.automatic_redeployment_policy.policy_revision == 1
     assert captured["r_type"] == "POST"
     assert str(captured["url"]).endswith("/api/v1/resource-releases/")
     assert captured["payload"]["json"]["automatic_deployment"] is True
@@ -2209,21 +2206,31 @@ def test_resource_release_deploy_current_version_posts_detail_action(monkeypatch
         def json():
             return {
                 "uid": run_uid,
-                "resource_release_uid": release_uid,
-                "resource_release_name": "analytics-123",
-                "release_kind": "fastapi",
-                "status": "pending",
-                "current_step": "resolve_eligibility",
-                "automatic_deployment_source": "manual",
+                "target_type": "resource_release",
+                "target": {"uid": release_uid, "name": "analytics-123", "kind": "fastapi"},
+                "project_branch_uid": "33333333-3333-4333-8333-333333333333",
+                "operation": "build_and_deploy",
+                "source": "manual",
+                "commit_sha": "a" * 40,
+                "configuration_revision": 4,
+                "state": "succeeded",
+                "phase": "completed",
+                "outcome": "deployed",
+                "created_at": "2026-07-19T12:00:00Z",
+                "started_at": "2026-07-19T12:00:01Z",
+                "finished_at": "2026-07-19T12:00:05Z",
                 "revision_context": {},
                 "trigger_context": {},
-                "image_artifact_context": {},
+                "artifact_context": {},
                 "cleanup_context": {},
-                "started_at": None,
-                "finished_at": None,
                 "result": {},
-                "error_code": "",
-                "error_detail": "",
+                "steps": [],
+                "logs": {
+                    "state": "available",
+                    "url": f"/api/v1/deployment-runs/{run_uid}/logs/",
+                    "retention_expires_at": None,
+                },
+                "error": None,
             }
 
     def _fake_make_request(*, s, loaders, r_type, url, payload, time_out=None):
@@ -2238,7 +2245,13 @@ def test_resource_release_deploy_current_version_posts_detail_action(monkeypatch
     run = release.deploy_current_version(timeout=9)
 
     assert run.uid == run_uid
-    assert run.status == models_helpers_mod.ResourceReleaseAutomaticDeploymentRun.STATUS_PENDING
+    assert isinstance(run, models_helpers_mod.DeploymentRun)
+    assert run.target.uid == release_uid
+    assert run.state == "succeeded"
+    assert run.phase == "completed"
+    assert run.outcome == "deployed"
+    assert run.logs.state == "available"
+    assert run.error is None
     assert captured == {
         "r_type": "POST",
         "url": (
@@ -2250,24 +2263,78 @@ def test_resource_release_deploy_current_version_posts_detail_action(monkeypatch
     }
 
 
-def test_resource_release_automatic_deployment_run_filters_are_uid_based():
-    release_uid = " 2f4c4c3d-5669-4da5-9d86-b84633c1e6ed "
+def test_deployment_run_collection_and_detail_use_unified_resource_release_contract(monkeypatch):
+    captured = []
+    run_uid = "11111111-1111-4111-8111-111111111111"
+    release_uid = "2f4c4c3d-5669-4da5-9d86-b84633c1e6ed"
+    response_payload = {
+        "uid": run_uid,
+        "target_type": "resource_release",
+        "target": {"uid": release_uid, "name": "analytics-123", "kind": "fastapi"},
+        "project_branch_uid": "33333333-3333-4333-8333-333333333333",
+        "operation": "build_and_deploy",
+        "source": "repository_event",
+        "commit_sha": "a" * 40,
+        "configuration_revision": 4,
+        "state": "succeeded",
+        "phase": "completed",
+        "outcome": "deployed",
+        "created_at": "2026-07-19T12:00:00Z",
+        "started_at": "2026-07-19T12:00:01Z",
+        "finished_at": "2026-07-19T12:00:05Z",
+        "revision_context": {},
+        "trigger_context": {},
+        "artifact_context": {},
+        "cleanup_context": {},
+        "result": {},
+        "steps": [],
+        "logs": {
+            "state": "available",
+            "url": f"/api/v1/deployment-runs/{run_uid}/logs/",
+            "retention_expires_at": None,
+        },
+        "error": None,
+    }
+
+    class FakeResponse:
+        status_code = 200
+
+        def __init__(self, payload):
+            self.payload = payload
 
-    normalized = models_helpers_mod.ResourceReleaseAutomaticDeploymentRun._normalize_filter_kwargs(
-        {
-            "resource_release__uid": release_uid,
-            "status__in": [" deployed ", " failed "],
-            "release_kind": " fastapi ",
-            "automatic_deployment_source": " manual ",
-        }
+        def json(self):
+            return self.payload
+
+    def _fake_make_request(*, s, loaders, r_type, url, payload, time_out=None):
+        captured.append({"r_type": r_type, "url": url, "payload": payload})
+        if url.rstrip("/") == models_helpers_mod.DeploymentRun.get_object_url():
+            return FakeResponse({"results": [dict(response_payload)], "next": None})
+        return FakeResponse(dict(response_payload))
+
+    monkeypatch.setattr(
+        models_helpers_mod.DeploymentRun,
+        "build_session",
+        classmethod(lambda cls: object()),
     )
+    monkeypatch.setattr(base_mod, "make_request", _fake_make_request)
 
-    assert normalized == {
-        "resource_release__uid": release_uid.strip(),
-        "status__in": ["deployed", "failed"],
-        "release_kind": "fastapi",
-        "automatic_deployment_source": "manual",
+    runs = models_helpers_mod.DeploymentRun.filter(
+        target_type="resource_release",
+        target_uid=release_uid,
+    )
+    detail = models_helpers_mod.DeploymentRun.get(pk=run_uid)
+
+    assert len(runs) == 1
+    assert runs[0].target.uid == release_uid
+    assert detail.state == "succeeded"
+    assert detail.phase == "completed"
+    assert detail.outcome == "deployed"
+    assert detail.logs.state == "available"
+    assert detail.error is None
+    assert captured[0]["payload"] == {
+        "params": {"target_type": "resource_release", "target_uid": release_uid}
     }
+    assert captured[1]["url"].endswith(f"/deployment-runs/{run_uid}/")
 
 
 def test_unified_deployment_run_models_and_filters(monkeypatch):