orchestra-cli 0.3.2__tar.gz → 0.3.4__tar.gz

{orchestra_cli-0.3.2 → orchestra_cli-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orchestra-cli
-Version: 0.3.2
+Version: 0.3.4
 Summary: Orchestra CLI. Perform operations with Orchestra locally.
 Author-email: Orchestra Technologies <support@getorchestra.io>
 Requires-Python: >=3.10
@@ -9,6 +9,7 @@ Requires-Dist: click
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: pydantic>=2.13.4
 Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: rich>=14.0.0
 Requires-Dist: typer>=0.16.0
 
 # orchestra-cli
@@ -50,7 +51,7 @@ Commands follow a `noun verb` shape. The current nouns are `pipeline` and `task`
 | `orchestra pipeline update`          | Update an existing Orchestra-backed pipeline from a local YAML file.                        |
 | `orchestra pipeline migrate`         | Migrate an Orchestra-backed pipeline to git-backed storage.                                 |
 | `orchestra pipeline delete`          | Delete an existing pipeline by alias.                                                       |
-| `orchestra pipeline run`             | Start a pipeline run by alias, optionally pinning branch/commit and waiting for completion. |
+| `orchestra pipeline run`             | Start a pipeline run by selector, optionally pinning branch/commit and waiting.             |
 | `orchestra pipeline build`           | Validate local YAML, create or update a draft pipeline, and start that draft version.       |
 | `orchestra task logs`                | Fetch or follow logs for a single task run.                                                 |
 
@@ -312,7 +313,7 @@ Behavior
 
 ## pipeline run
 
-Start a pipeline run by alias. Optionally specify a branch and/or commit. By default, the command waits and polls the run status until completion.
+Start a pipeline run by alias, pipeline ID, or path. Optionally specify a branch and/or commit. By default, the command waits and polls the run status until completion.
 
 ```bash
 export ORCHESTRA_API_KEY=...
@@ -329,15 +330,21 @@ orchestra pipeline run -a my-pipeline -b feature/my-change -c 0123abc
 
 Options
 
-- `-a, --alias` (required): Pipeline alias to run.
+- `-a, --alias` (optional): Pipeline alias to run.
+- `-i, --pipeline-id` (optional): Pipeline ID to run.
+- `-p, --path` (optional): Path to a local pipeline YAML file. When this points to a pipeline inside a git repository, the CLI resolves the pipeline from `repository` + `yaml_path` before starting the run.
 - `-b, --branch` (optional): Git branch name to associate with this run.
 - `-c, --commit` (optional): Commit SHA to associate with this run.
+- `-t, --task` (optional): Task ID, task name, task-group ID, or task-group name to run. With `--path`, selectors resolve from the local YAML; otherwise the CLI loads pipeline data from Orchestra and resolves them there.
 - `--wait/--no-wait` (default: `--wait`): Poll until the run ends.
 - `--force/--no-force` (default: `--no-force`): Skip confirmation if local git warnings are detected.
+- Provide exactly one selector mode: `--alias`, `--pipeline-id`, or `--path`. These selector flags are mutually exclusive.
 
 Behavior
 
 - Prints the run ID when known and a link to the run lineage page.
+- Rejects mixed selector modes.
+- When `--path` is used for a repository-backed pipeline, the CLI must find an existing Orchestra pipeline for that `repository` + `yaml_path` selector before it can start the run.
 - When waiting, polls status every ~5s until a terminal state:
   - `SUCCEEDED` (exit `0`), `WARNING` (exit `0`), `SKIPPED` (exit `0`)
   - `FAILED` or `CANCELLED` (exit `1`)

{orchestra_cli-0.3.2 → orchestra_cli-0.3.4}/README.md

@@ -37,7 +37,7 @@ Commands follow a `noun verb` shape. The current nouns are `pipeline` and `task`
 | `orchestra pipeline update`          | Update an existing Orchestra-backed pipeline from a local YAML file.                        |
 | `orchestra pipeline migrate`         | Migrate an Orchestra-backed pipeline to git-backed storage.                                 |
 | `orchestra pipeline delete`          | Delete an existing pipeline by alias.                                                       |
-| `orchestra pipeline run`             | Start a pipeline run by alias, optionally pinning branch/commit and waiting for completion. |
+| `orchestra pipeline run`             | Start a pipeline run by selector, optionally pinning branch/commit and waiting.             |
 | `orchestra pipeline build`           | Validate local YAML, create or update a draft pipeline, and start that draft version.       |
 | `orchestra task logs`                | Fetch or follow logs for a single task run.                                                 |
 
@@ -299,7 +299,7 @@ Behavior
 
 ## pipeline run
 
-Start a pipeline run by alias. Optionally specify a branch and/or commit. By default, the command waits and polls the run status until completion.
+Start a pipeline run by alias, pipeline ID, or path. Optionally specify a branch and/or commit. By default, the command waits and polls the run status until completion.
 
 ```bash
 export ORCHESTRA_API_KEY=...
@@ -316,15 +316,21 @@ orchestra pipeline run -a my-pipeline -b feature/my-change -c 0123abc
 
 Options
 
-- `-a, --alias` (required): Pipeline alias to run.
+- `-a, --alias` (optional): Pipeline alias to run.
+- `-i, --pipeline-id` (optional): Pipeline ID to run.
+- `-p, --path` (optional): Path to a local pipeline YAML file. When this points to a pipeline inside a git repository, the CLI resolves the pipeline from `repository` + `yaml_path` before starting the run.
 - `-b, --branch` (optional): Git branch name to associate with this run.
 - `-c, --commit` (optional): Commit SHA to associate with this run.
+- `-t, --task` (optional): Task ID, task name, task-group ID, or task-group name to run. With `--path`, selectors resolve from the local YAML; otherwise the CLI loads pipeline data from Orchestra and resolves them there.
 - `--wait/--no-wait` (default: `--wait`): Poll until the run ends.
 - `--force/--no-force` (default: `--no-force`): Skip confirmation if local git warnings are detected.
+- Provide exactly one selector mode: `--alias`, `--pipeline-id`, or `--path`. These selector flags are mutually exclusive.
 
 Behavior
 
 - Prints the run ID when known and a link to the run lineage page.
+- Rejects mixed selector modes.
+- When `--path` is used for a repository-backed pipeline, the CLI must find an existing Orchestra pipeline for that `repository` + `yaml_path` selector before it can start the run.
 - When waiting, polls status every ~5s until a terminal state:
   - `SUCCEEDED` (exit `0`), `WARNING` (exit `0`), `SKIPPED` (exit `0`)
   - `FAILED` or `CANCELLED` (exit `1`)

{orchestra_cli-0.3.2 → orchestra_cli-0.3.4}/orchestra_cli/src/build_pipeline.py

@@ -4,8 +4,9 @@ import httpx
 import typer
 
 from ..utils.api import auth_headers, fail_with_response, request_or_exit, require_api_key
-from ..utils.constants import get_create_pipeline_url, get_pipeline_url, get_update_pipeline_url
+from ..utils.constants import get_create_pipeline_url, get_update_pipeline_url
 from ..utils.git import confirm_git_warnings_or_exit, prepare_git_backed_run_target
+from ..utils.pipeline_lookup import lookup_existing_pipeline
 from ..utils.pipeline_selector import (
     PipelineSelector,
     pipeline_alias_option,
@@ -45,26 +46,6 @@ def _extract_upsert_result(response: httpx.Response, action: str) -> tuple[str,
     )
 
 
-def _lookup_existing_pipeline(
-    selector: PipelineSelector,
-    api_key: str,
-) -> dict[str, object] | None:
-    response = request_or_exit(
-        httpx.get,
-        get_pipeline_url(),
-        params=selector.to_payload(),
-        timeout=30,
-        headers=auth_headers(api_key),
-    )
-
-    if response.status_code == 404:
-        return None
-    if response.status_code != 200:
-        raise fail_with_response("Build", response)
-
-    return require_pipeline_body_from_success_response(response, "Build")
-
-
 def _build_create_selector(
     path: Path,
     lookup_selector: PipelineSelector,
@@ -174,7 +155,7 @@ def build_pipeline(
 
     confirm_git_warnings_or_exit(force, path)
     pipeline_data = load_validated_pipeline_data(path)
-    existing_pipeline = _lookup_existing_pipeline(lookup_selector, api_key)
+    existing_pipeline = lookup_existing_pipeline(lookup_selector, api_key, "Build", allow_404=True)
 
     if existing_pipeline is None:
         run_selector, version_number = _create_draft_pipeline(
@@ -188,7 +169,6 @@ def build_pipeline(
             selector=run_selector,
             api_key=api_key,
             payload=build_run_payload(
-                run_selector,
                 branch=branch,
                 commit=commit,
                 version_number=version_number,
@@ -210,7 +190,6 @@ def build_pipeline(
             selector=run_selector,
             api_key=api_key,
             payload=build_run_payload(
-                run_selector,
                 branch=branch,
                 commit=commit,
                 version_number=version_number,
@@ -245,7 +224,6 @@ def build_pipeline(
         selector=run_selector,
         api_key=api_key,
         payload=build_run_payload(
-            run_selector,
             branch=git_branch,
             commit=git_commit,
         ),

{orchestra_cli-0.3.2 → orchestra_cli-0.3.4}/orchestra_cli/src/migrate_pipeline.py

@@ -23,10 +23,10 @@ from ..utils.git import (
     stage_and_commit_file_if_needed,
     suggest_migration_branch_name,
 )
+from ..utils.pipeline_lookup import lookup_existing_pipeline
 from ..utils.pipeline_selector import PipelineSelector, pipeline_alias_option, pipeline_id_option
 from ..utils.pipeline_update import storage_provider
 from ..utils.styling import bold, green, red, yellow
-from .pipeline_upsert import require_pipeline_body_from_success_response
 
 
 def migrate_path_option() -> Any:
@@ -51,19 +51,6 @@ def _resolve_migrate_selector(alias: str | None, pipeline_id: str | None) -> Pip
     raise typer.Exit(code=1)
 
 
-def _lookup_pipeline(selector: PipelineSelector, api_key: str) -> dict[str, object]:
-    response = request_or_exit(
-        httpx.get,
-        get_api_url("pipeline"),
-        params=selector.to_payload(),
-        timeout=30,
-        headers=auth_headers(api_key),
-    )
-    if response.status_code != 200:
-        raise fail_with_response("Migrate", response)
-    return require_pipeline_body_from_success_response(response, "Migrate")
-
-
 def _extract_int(value: object) -> int | None:
     if isinstance(value, bool):
         return None
@@ -383,7 +370,10 @@ def migrate_pipeline(
         typer.echo(red("Could not detect current branch from git"))
         raise typer.Exit(code=1)
 
-    existing_pipeline = _lookup_pipeline(selector, api_key)
+    existing_pipeline = lookup_existing_pipeline(selector, api_key, "Migrate")
+    if existing_pipeline is None:
+        typer.echo(red("❌ Migrate failed: pipeline lookup returned no pipeline"))
+        raise typer.Exit(code=1)
     provider = (storage_provider(existing_pipeline) or "ORCHESTRA").upper()
     if provider != "ORCHESTRA":
         typer.echo(