orchestra-cli 0.1.2__tar.gz → 0.2.0__tar.gz

{orchestra_cli-0.1.2 → orchestra_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orchestra-cli
-Version: 0.1.2
+Version: 0.2.0
 Summary: Orchestra CLI. Perform operations with Orchestra locally.
 Author-email: Orchestra Technologies <support@getorchestra.io>
 Requires-Python: >=3.10
@@ -15,6 +15,8 @@ Orchestra CLI for working with Orchestra pipelines from your terminal.
 
 Two entrypoints are available: `orchestra` and `orchestra-cli` (they are equivalent).
 
+See [`AGENTS.md`](AGENTS.md) for contributor and AI agent guidance (environment setup, code conventions, testing).
+
 ## Installation
 
 ```bash
@@ -30,13 +32,14 @@ pipx install orchestra-cli
 ## Environment variables
 
 - `ORCHESTRA_API_KEY`: Required for actions that call the API (`import`, `run`).
-- `BASE_URL`: Optional. Override the default API base
-  (`https://app.getorchestra.io/api/engine/public/pipelines/{}`) for non‑production/testing.
+- `BASE_URL`: Optional. Override the default Orchestra host (`https://app.getorchestra.io`) for non‑production/testing.
 
 ## Commands overview
 
 - `validate`: Validate a pipeline YAML locally against the Orchestra API schema.
 - `import`: Register a pipeline YAML (from a git repo) with Orchestra under an alias.
+- `create-pipeline`: Create an Orchestra-backed pipeline from a local YAML file.
+- `update-pipeline`: Update an existing Orchestra-backed pipeline from a local YAML file.
 - `run`: Start a pipeline run by alias, optionally pinning branch/commit and waiting for completion.
 
 Use `orchestra --help` or `orchestra <command> --help` for built-in help.
@@ -118,6 +121,63 @@ Common errors
 
 ---
 
+## create-pipeline
+
+Create an Orchestra-backed pipeline directly from a local YAML file.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra create-pipeline \
+  --alias my-pipeline \
+  --path ./pipelines/pipeline.yaml \
+  --publish            # optional, defaults to --no-publish
+```
+
+Options
+
+- `-a, --alias` (required): Pipeline alias.
+- `-p, --path` (required): Path to pipeline YAML file.
+- `--publish/--no-publish` (optional, default `--no-publish`): Whether the pipeline is published.
+
+Behavior
+
+- Validates YAML against the Orchestra schema endpoint before creating.
+- Sends pipeline data to `POST /pipelines` with `storage_provider=ORCHESTRA`.
+- On success, prints the pipeline edit URL (`/pipelines/{pipeline_id}/edit`) when an ID is returned.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
+## update-pipeline
+
+Update an existing Orchestra-backed pipeline from a local YAML file.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra update-pipeline \
+  --alias my-pipeline \
+  --path ./pipelines/pipeline.yaml \
+  --no-publish         # default
+```
+
+Options
+
+- `-a, --alias` (required): Pipeline alias to update.
+- `-p, --path` (required): Path to pipeline YAML file.
+- `--publish/--no-publish` (optional, default `--no-publish`): Whether the pipeline is published.
+
+Behavior
+
+- Validates YAML against the Orchestra schema endpoint before updating.
+- Sends pipeline data to `PUT /pipelines/{alias}` with `storage_provider=ORCHESTRA`.
+- Only Orchestra-backed pipelines can be updated via this endpoint (Git-backed pipelines are rejected).
+- On success, prints the pipeline edit URL (`/pipelines/{pipeline_id}/edit`) when an ID is returned.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
 ## 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.

{orchestra_cli-0.1.2 → orchestra_cli-0.2.0}/README.md

@@ -4,6 +4,8 @@ Orchestra CLI for working with Orchestra pipelines from your terminal.
 
 Two entrypoints are available: `orchestra` and `orchestra-cli` (they are equivalent).
 
+See [`AGENTS.md`](AGENTS.md) for contributor and AI agent guidance (environment setup, code conventions, testing).
+
 ## Installation
 
 ```bash
@@ -19,13 +21,14 @@ pipx install orchestra-cli
 ## Environment variables
 
 - `ORCHESTRA_API_KEY`: Required for actions that call the API (`import`, `run`).
-- `BASE_URL`: Optional. Override the default API base
-  (`https://app.getorchestra.io/api/engine/public/pipelines/{}`) for non‑production/testing.
+- `BASE_URL`: Optional. Override the default Orchestra host (`https://app.getorchestra.io`) for non‑production/testing.
 
 ## Commands overview
 
 - `validate`: Validate a pipeline YAML locally against the Orchestra API schema.
 - `import`: Register a pipeline YAML (from a git repo) with Orchestra under an alias.
+- `create-pipeline`: Create an Orchestra-backed pipeline from a local YAML file.
+- `update-pipeline`: Update an existing Orchestra-backed pipeline from a local YAML file.
 - `run`: Start a pipeline run by alias, optionally pinning branch/commit and waiting for completion.
 
 Use `orchestra --help` or `orchestra <command> --help` for built-in help.
@@ -107,6 +110,63 @@ Common errors
 
 ---
 
+## create-pipeline
+
+Create an Orchestra-backed pipeline directly from a local YAML file.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra create-pipeline \
+  --alias my-pipeline \
+  --path ./pipelines/pipeline.yaml \
+  --publish            # optional, defaults to --no-publish
+```
+
+Options
+
+- `-a, --alias` (required): Pipeline alias.
+- `-p, --path` (required): Path to pipeline YAML file.
+- `--publish/--no-publish` (optional, default `--no-publish`): Whether the pipeline is published.
+
+Behavior
+
+- Validates YAML against the Orchestra schema endpoint before creating.
+- Sends pipeline data to `POST /pipelines` with `storage_provider=ORCHESTRA`.
+- On success, prints the pipeline edit URL (`/pipelines/{pipeline_id}/edit`) when an ID is returned.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
+## update-pipeline
+
+Update an existing Orchestra-backed pipeline from a local YAML file.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra update-pipeline \
+  --alias my-pipeline \
+  --path ./pipelines/pipeline.yaml \
+  --no-publish         # default
+```
+
+Options
+
+- `-a, --alias` (required): Pipeline alias to update.
+- `-p, --path` (required): Path to pipeline YAML file.
+- `--publish/--no-publish` (optional, default `--no-publish`): Whether the pipeline is published.
+
+Behavior
+
+- Validates YAML against the Orchestra schema endpoint before updating.
+- Sends pipeline data to `PUT /pipelines/{alias}` with `storage_provider=ORCHESTRA`.
+- Only Orchestra-backed pipelines can be updated via this endpoint (Git-backed pipelines are rejected).
+- On success, prints the pipeline edit URL (`/pipelines/{pipeline_id}/edit`) when an ID is returned.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
 ## 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.

{orchestra_cli-0.1.2 → orchestra_cli-0.2.0}/orchestra_cli/src/cli.py

@@ -1,7 +1,9 @@
 import typer
 
+from .create_pipeline import create_pipeline
 from .import_pipeline import import_pipeline
 from .run_pipeline import run_pipeline
+from .update_pipeline import update_pipeline
 from .validate_pipeline import validate
 
 app = typer.Typer(help="Orchestra CLI – perform operations with Orchestra locally.")
@@ -10,3 +12,5 @@ app = typer.Typer(help="Orchestra CLI – perform operations with Orchestra loca
 app.command(name="validate")(validate)
 app.command(name="import")(import_pipeline)
 app.command(name="run")(run_pipeline)
+app.command(name="create-pipeline")(create_pipeline)
+app.command(name="update-pipeline")(update_pipeline)

orchestra_cli-0.2.0/orchestra_cli/src/create_pipeline.py

@@ -0,0 +1,65 @@
+import json
+from pathlib import Path
+
+import httpx
+import typer
+
+from ..utils.constants import get_create_pipeline_url
+from ..utils.styling import indent_message, red, yellow
+from .pipeline_upsert import (
+    build_upsert_payload,
+    emit_success_with_edit_url,
+    load_validated_pipeline_data,
+    require_api_key,
+    require_pipeline_id_from_success_response,
+)
+
+
+def create_pipeline(
+    alias: str = typer.Option(..., "--alias", "-a", help="Pipeline alias"),
+    path: Path = typer.Option(
+        ...,
+        "--path",
+        "-p",
+        exists=True,
+        file_okay=True,
+        dir_okay=False,
+        readable=True,
+        resolve_path=True,
+        help="Path to pipeline YAML",
+    ),
+    publish: bool = typer.Option(
+        False,
+        "--publish/--no-publish",
+        help="Whether the pipeline is published and can be triggered",
+    ),
+):
+    """
+    Create an Orchestra-backed pipeline from a local YAML file.
+    """
+    api_key = require_api_key()
+    data = load_validated_pipeline_data(path)
+    payload = build_upsert_payload(data, publish, alias=alias)
+
+    try:
+        response = httpx.post(
+            get_create_pipeline_url(),
+            json=payload,
+            timeout=30,
+            headers={"Authorization": f"Bearer {api_key}"},
+        )
+    except Exception as e:
+        typer.echo(red(f"HTTP request failed: {e}"))
+        raise typer.Exit(code=1)
+
+    if response.status_code == 201:
+        pipeline_id = require_pipeline_id_from_success_response(response, "Create")
+        emit_success_with_edit_url(alias, "created", pipeline_id)
+        raise typer.Exit(code=0)
+
+    typer.echo(red(f"❌ Create failed with status {response.status_code}"))
+    try:
+        typer.echo(yellow(indent_message(json.dumps(response.json(), indent=2))))
+    except Exception:
+        typer.echo(yellow(indent_message(response.text)))
+    raise typer.Exit(code=1)

orchestra_cli-0.2.0/orchestra_cli/src/pipeline_upsert.py

@@ -0,0 +1,74 @@
+import json
+import os
+from pathlib import Path
+
+import httpx
+import typer
+
+from ..utils.constants import get_pipeline_edit_url
+from ..utils.styling import green, indent_message, red, yellow
+from .import_pipeline import _load_yaml, _validate_yaml_with_api
+
+
+def require_api_key() -> str:
+    api_key = os.getenv("ORCHESTRA_API_KEY")
+    if not api_key:
+        typer.echo(red("ORCHESTRA_API_KEY is not set"))
+        raise typer.Exit(code=1)
+    return api_key
+
+
+def load_validated_pipeline_data(path: Path) -> dict:
+    if not path.exists():
+        typer.echo(red(f"File not found: {path}"))
+        raise typer.Exit(code=1)
+
+    data, err = _load_yaml(path)
+    if err is not None:
+        typer.echo(red(f"Invalid YAML: {err}"))
+        raise typer.Exit(code=1)
+
+    ok, err_msg = _validate_yaml_with_api(data or {})
+    if not ok:
+        typer.echo(red("❌ Validation failed"))
+        if err_msg:
+            typer.echo(yellow(indent_message(err_msg)))
+        raise typer.Exit(code=1)
+
+    return data or {}
+
+
+def build_upsert_payload(data: dict, publish: bool, alias: str | None = None) -> dict:
+    payload: dict[str, object] = {
+        "data": data,
+        "published": publish,
+        "storage_provider": "ORCHESTRA",
+    }
+    if alias is not None:
+        payload["alias"] = alias
+    return payload
+
+
+def require_pipeline_id_from_success_response(
+    response: httpx.Response,
+    action: str,
+) -> str:
+    try:
+        body = response.json()
+    except Exception:
+        typer.echo(red(f"❌ {action} failed: success response was not valid JSON"))
+        typer.echo(yellow(indent_message(response.text)))
+        raise typer.Exit(code=1)
+
+    pipeline_id = body.get("id")
+    if not pipeline_id:
+        typer.echo(red(f"❌ {action} failed: success response did not include pipeline id"))
+        typer.echo(yellow(indent_message(json.dumps(body, indent=2))))
+        raise typer.Exit(code=1)
+
+    return str(pipeline_id)
+
+
+def emit_success_with_edit_url(alias: str, action: str, pipeline_id: str) -> None:
+    typer.echo(green(f"✅ Pipeline '{alias}' {action} successfully: {pipeline_id}"))
+    typer.echo(yellow(f"Edit URL: {get_pipeline_edit_url(pipeline_id)}"))

{orchestra_cli-0.1.2 → orchestra_cli-0.2.0}/orchestra_cli/src/run_pipeline.py

@@ -106,6 +106,7 @@ def run_pipeline(
         poll_interval_seconds = 5
         headers = {"Authorization": f"Bearer {api_key}"}
         status_url = f"{api_prefix}/pipeline_runs/{pipeline_run_id}/status"
+        in_progress_statuses = {"RUNNING", "QUEUED", "CREATED"}
 
         while True:
             time.sleep(poll_interval_seconds)
@@ -158,6 +159,9 @@ def run_pipeline(
                 typer.echo(yellow(lineage_url))
                 raise typer.Exit(code=1)
 
+            if status_value in in_progress_statuses:
+                continue
+
             typer.echo(
                 red(f"❌ Invalid status value: {status_value}\nResponse body: {status_body}"),
             )

orchestra_cli-0.2.0/orchestra_cli/src/update_pipeline.py

@@ -0,0 +1,65 @@
+import json
+from pathlib import Path
+
+import httpx
+import typer
+
+from ..utils.constants import get_update_pipeline_url
+from ..utils.styling import indent_message, red, yellow
+from .pipeline_upsert import (
+    build_upsert_payload,
+    emit_success_with_edit_url,
+    load_validated_pipeline_data,
+    require_api_key,
+    require_pipeline_id_from_success_response,
+)
+
+
+def update_pipeline(
+    alias: str = typer.Option(..., "--alias", "-a", help="Pipeline alias"),
+    path: Path = typer.Option(
+        ...,
+        "--path",
+        "-p",
+        exists=True,
+        file_okay=True,
+        dir_okay=False,
+        readable=True,
+        resolve_path=True,
+        help="Path to pipeline YAML",
+    ),
+    publish: bool = typer.Option(
+        False,
+        "--publish/--no-publish",
+        help="Whether the pipeline is published and can be triggered",
+    ),
+):
+    """
+    Update an Orchestra-backed pipeline from a local YAML file.
+    """
+    api_key = require_api_key()
+    data = load_validated_pipeline_data(path)
+    payload = build_upsert_payload(data, publish)
+
+    try:
+        response = httpx.put(
+            get_update_pipeline_url(alias),
+            json=payload,
+            timeout=30,
+            headers={"Authorization": f"Bearer {api_key}"},
+        )
+    except Exception as e:
+        typer.echo(red(f"HTTP request failed: {e}"))
+        raise typer.Exit(code=1)
+
+    if response.status_code == 200:
+        pipeline_id = require_pipeline_id_from_success_response(response, "Update")
+        emit_success_with_edit_url(alias, "updated", pipeline_id)
+        raise typer.Exit(code=0)
+
+    typer.echo(red(f"❌ Update failed with status {response.status_code}"))
+    try:
+        typer.echo(yellow(indent_message(json.dumps(response.json(), indent=2))))
+    except Exception:
+        typer.echo(yellow(indent_message(response.text)))
+    raise typer.Exit(code=1)

{orchestra_cli-0.1.2 → orchestra_cli-0.2.0}/orchestra_cli/tests/test_cli.py

@@ -10,3 +10,5 @@ def test_help():
     assert result.exit_code == 0
     assert "Orchestra CLI" in result.output
     assert "validate" in result.output
+    assert "create-pipeline" in result.output
+    assert "update-pipeline" in result.output

orchestra_cli-0.2.0/orchestra_cli/tests/test_create_pipeline.py

@@ -0,0 +1,177 @@
+from pathlib import Path
+
+import pytest
+from pytest_httpx import HTTPXMock
+from typer.testing import CliRunner
+
+from orchestra_cli.src.cli import app
+
+runner = CliRunner()
+
+
+@pytest.fixture(autouse=True)
+def mock_env(monkeypatch):
+    monkeypatch.setenv("ORCHESTRA_API_KEY", "fake-key")
+    monkeypatch.setenv("BASE_URL", "")
+
+
+def test_create_success_default_no_publish(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"ok": True},
+        status_code=200,
+    )
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines",
+        json={"id": "pipeline-id"},
+        status_code=201,
+        match_json={
+            "alias": "demo",
+            "data": {"name": "demo", "version": 1},
+            "published": False,
+            "storage_provider": "ORCHESTRA",
+        },
+    )
+
+    result = runner.invoke(app, ["create-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 0
+    assert "created successfully" in result.output
+    assert "https://app.getorchestra.io/pipelines/pipeline-id/edit" in result.output
+
+
+def test_create_publish_flag(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"ok": True},
+        status_code=200,
+    )
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines",
+        json={"id": "pipeline-id"},
+        status_code=201,
+        match_json={
+            "alias": "demo",
+            "data": {"name": "demo", "version": 1},
+            "published": True,
+            "storage_provider": "ORCHESTRA",
+        },
+    )
+
+    result = runner.invoke(
+        app,
+        ["create-pipeline", "--alias", "demo", "--path", str(yaml_file), "--publish"],
+    )
+    assert result.exit_code == 0
+    assert "created successfully" in result.output
+    assert "https://app.getorchestra.io/pipelines/pipeline-id/edit" in result.output
+
+
+def test_create_missing_api_key(monkeypatch, tmp_path: Path):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\n")
+
+    monkeypatch.delenv("ORCHESTRA_API_KEY", raising=False)
+    result = runner.invoke(app, ["create-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 1
+    assert "ORCHESTRA_API_KEY is not set" in result.output
+
+
+def test_create_invalid_yaml(tmp_path: Path):
+    bad = tmp_path / "bad.yaml"
+    bad.write_text("name: [oops\n")
+
+    result = runner.invoke(app, ["create-pipeline", "--alias", "demo", "--path", str(bad)])
+    assert result.exit_code == 1
+    assert "Invalid YAML" in result.output
+
+
+def test_create_schema_validation_error(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"detail": [{"loc": ["root"], "msg": "bad"}]},
+        status_code=400,
+    )
+
+    result = runner.invoke(app, ["create-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 1
+    assert "Validation failed" in result.output
+
+
+def test_create_api_error(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"ok": True},
+        status_code=200,
+    )
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines",
+        json={"detail": "bad"},
+        status_code=400,
+    )
+
+    result = runner.invoke(app, ["create-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 1
+    assert "Create failed" in result.output
+
+
+def test_create_success_without_pipeline_id_fails(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"ok": True},
+        status_code=200,
+    )
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines",
+        json={"alias": "demo"},
+        status_code=201,
+    )
+
+    result = runner.invoke(app, ["create-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 1
+    assert "success response did not include pipeline id" in result.output
+
+
+def test_create_success_with_invalid_json_fails(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"ok": True},
+        status_code=200,
+    )
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines",
+        text="ok",
+        status_code=201,
+    )
+
+    result = runner.invoke(app, ["create-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 1
+    assert "success response was not valid JSON" in result.output

{orchestra_cli-0.1.2 → orchestra_cli-0.2.0}/orchestra_cli/tests/test_run_pipeline.py

@@ -187,6 +187,7 @@ def test_run_wait_success(httpx_mock: HTTPXMock, monkeypatch, tmp_path: Path):
         result.output.strip().splitlines()[1]
         == f"Started pipeline (alias: demo), run id: {mock_pipeline_run_id}"
     )  # noqa: E501
+    assert "Invalid status value: RUNNING" not in result.output
     assert result.output.strip().splitlines()[-2] == "✅ Pipeline succeeded"
     assert result.output.strip().splitlines()[-1] == mock_pipeline_run_id
 
@@ -225,6 +226,7 @@ def test_run_wait_failed(httpx_mock: HTTPXMock, monkeypatch, tmp_path: Path):
 
     result = runner.invoke(app, ["run", "--alias", "demo", "--wait"])
     assert result.exit_code == 1
+    assert "Invalid status value: RUNNING" not in result.output
     assert "status FAILED" in result.output
     assert "/pipeline-runs/run-xyz/lineage" in result.output
 

orchestra_cli-0.2.0/orchestra_cli/tests/test_update_pipeline.py

@@ -0,0 +1,176 @@
+from pathlib import Path
+
+import pytest
+from pytest_httpx import HTTPXMock
+from typer.testing import CliRunner
+
+from orchestra_cli.src.cli import app
+
+runner = CliRunner()
+
+
+@pytest.fixture(autouse=True)
+def mock_env(monkeypatch):
+    monkeypatch.setenv("ORCHESTRA_API_KEY", "fake-key")
+    monkeypatch.setenv("BASE_URL", "")
+
+
+def test_update_success_default_no_publish(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"ok": True},
+        status_code=200,
+    )
+    httpx_mock.add_response(
+        method="PUT",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/demo",
+        json={"id": "pipeline-id"},
+        status_code=200,
+        match_json={
+            "data": {"name": "demo", "version": 1},
+            "published": False,
+            "storage_provider": "ORCHESTRA",
+        },
+    )
+
+    result = runner.invoke(app, ["update-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 0
+    assert "updated successfully" in result.output
+    assert "https://app.getorchestra.io/pipelines/pipeline-id/edit" in result.output
+
+
+def test_update_publish_flag(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"ok": True},
+        status_code=200,
+    )
+    httpx_mock.add_response(
+        method="PUT",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/demo",
+        json={"id": "pipeline-id"},
+        status_code=200,
+        match_json={
+            "data": {"name": "demo", "version": 1},
+            "published": True,
+            "storage_provider": "ORCHESTRA",
+        },
+    )
+
+    result = runner.invoke(
+        app,
+        ["update-pipeline", "--alias", "demo", "--path", str(yaml_file), "--publish"],
+    )
+    assert result.exit_code == 0
+    assert "updated successfully" in result.output
+    assert "https://app.getorchestra.io/pipelines/pipeline-id/edit" in result.output
+
+
+def test_update_missing_api_key(monkeypatch, tmp_path: Path):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\n")
+
+    monkeypatch.delenv("ORCHESTRA_API_KEY", raising=False)
+    result = runner.invoke(app, ["update-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 1
+    assert "ORCHESTRA_API_KEY is not set" in result.output
+
+
+def test_update_invalid_yaml(tmp_path: Path):
+    bad = tmp_path / "bad.yaml"
+    bad.write_text("name: [oops\n")
+
+    result = runner.invoke(app, ["update-pipeline", "--alias", "demo", "--path", str(bad)])
+    assert result.exit_code == 1
+    assert "Invalid YAML" in result.output
+
+
+def test_update_schema_validation_error(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"detail": [{"loc": ["root"], "msg": "bad"}]},
+        status_code=400,
+    )
+
+    result = runner.invoke(app, ["update-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 1
+    assert "Validation failed" in result.output
+
+
+def test_update_api_error_orchestra_backed_only(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"ok": True},
+        status_code=200,
+    )
+    httpx_mock.add_response(
+        method="PUT",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/demo",
+        json={"detail": "Only orchestra-backed pipelines can be updated via this endpoint."},
+        status_code=400,
+    )
+
+    result = runner.invoke(app, ["update-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 1
+    assert "Update failed" in result.output
+    assert "Only orchestra-backed pipelines can be updated via this endpoint." in result.output
+
+
+def test_update_success_without_pipeline_id_fails(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"ok": True},
+        status_code=200,
+    )
+    httpx_mock.add_response(
+        method="PUT",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/demo",
+        json={"alias": "demo"},
+        status_code=200,
+    )
+
+    result = runner.invoke(app, ["update-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 1
+    assert "success response did not include pipeline id" in result.output
+
+
+def test_update_success_with_invalid_json_fails(tmp_path: Path, httpx_mock: HTTPXMock):
+    yaml_file = tmp_path / "pipe.yaml"
+    yaml_file.write_text("name: demo\nversion: 1\n")
+
+    httpx_mock.add_response(
+        method="POST",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/schema",
+        json={"ok": True},
+        status_code=200,
+    )
+    httpx_mock.add_response(
+        method="PUT",
+        url="https://app.getorchestra.io/api/engine/public/pipelines/demo",
+        text="ok",
+        status_code=200,
+    )
+
+    result = runner.invoke(app, ["update-pipeline", "--alias", "demo", "--path", str(yaml_file)])
+    assert result.exit_code == 1
+    assert "success response was not valid JSON" in result.output

orchestra_cli-0.2.0/orchestra_cli/utils/constants.py

@@ -0,0 +1,28 @@
+import os
+
+_PROD_BASE_URL = "https://app.getorchestra.io"
+
+
+def get_api_url(path: str) -> str:
+    suffix = f"/{path.lstrip('/')}" if path else ""
+    return f"{get_base_url()}/api/engine/public/pipelines{suffix}"
+
+
+def get_base_url() -> str:
+    return (os.getenv("BASE_URL") or _PROD_BASE_URL).strip().rstrip("/")
+
+
+def get_public_api_url(path: str) -> str:
+    return f"{get_base_url()}/api/engine/public/{path.lstrip('/')}"
+
+
+def get_create_pipeline_url() -> str:
+    return get_api_url("")
+
+
+def get_update_pipeline_url(alias: str) -> str:
+    return get_api_url(alias)
+
+
+def get_pipeline_edit_url(pipeline_id: str) -> str:
+    return f"{get_base_url()}/pipelines/{pipeline_id}/edit"

{orchestra_cli-0.1.2 → orchestra_cli-0.2.0}/orchestra_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orchestra-cli
-Version: 0.1.2
+Version: 0.2.0
 Summary: Orchestra CLI. Perform operations with Orchestra locally.
 Author-email: Orchestra Technologies <support@getorchestra.io>
 Requires-Python: >=3.10
@@ -15,6 +15,8 @@ Orchestra CLI for working with Orchestra pipelines from your terminal.
 
 Two entrypoints are available: `orchestra` and `orchestra-cli` (they are equivalent).
 
+See [`AGENTS.md`](AGENTS.md) for contributor and AI agent guidance (environment setup, code conventions, testing).
+
 ## Installation
 
 ```bash
@@ -30,13 +32,14 @@ pipx install orchestra-cli
 ## Environment variables
 
 - `ORCHESTRA_API_KEY`: Required for actions that call the API (`import`, `run`).
-- `BASE_URL`: Optional. Override the default API base
-  (`https://app.getorchestra.io/api/engine/public/pipelines/{}`) for non‑production/testing.
+- `BASE_URL`: Optional. Override the default Orchestra host (`https://app.getorchestra.io`) for non‑production/testing.
 
 ## Commands overview
 
 - `validate`: Validate a pipeline YAML locally against the Orchestra API schema.
 - `import`: Register a pipeline YAML (from a git repo) with Orchestra under an alias.
+- `create-pipeline`: Create an Orchestra-backed pipeline from a local YAML file.
+- `update-pipeline`: Update an existing Orchestra-backed pipeline from a local YAML file.
 - `run`: Start a pipeline run by alias, optionally pinning branch/commit and waiting for completion.
 
 Use `orchestra --help` or `orchestra <command> --help` for built-in help.
@@ -118,6 +121,63 @@ Common errors
 
 ---
 
+## create-pipeline
+
+Create an Orchestra-backed pipeline directly from a local YAML file.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra create-pipeline \
+  --alias my-pipeline \
+  --path ./pipelines/pipeline.yaml \
+  --publish            # optional, defaults to --no-publish
+```
+
+Options
+
+- `-a, --alias` (required): Pipeline alias.
+- `-p, --path` (required): Path to pipeline YAML file.
+- `--publish/--no-publish` (optional, default `--no-publish`): Whether the pipeline is published.
+
+Behavior
+
+- Validates YAML against the Orchestra schema endpoint before creating.
+- Sends pipeline data to `POST /pipelines` with `storage_provider=ORCHESTRA`.
+- On success, prints the pipeline edit URL (`/pipelines/{pipeline_id}/edit`) when an ID is returned.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
+## update-pipeline
+
+Update an existing Orchestra-backed pipeline from a local YAML file.
+
+```bash
+export ORCHESTRA_API_KEY=...
+
+orchestra update-pipeline \
+  --alias my-pipeline \
+  --path ./pipelines/pipeline.yaml \
+  --no-publish         # default
+```
+
+Options
+
+- `-a, --alias` (required): Pipeline alias to update.
+- `-p, --path` (required): Path to pipeline YAML file.
+- `--publish/--no-publish` (optional, default `--no-publish`): Whether the pipeline is published.
+
+Behavior
+
+- Validates YAML against the Orchestra schema endpoint before updating.
+- Sends pipeline data to `PUT /pipelines/{alias}` with `storage_provider=ORCHESTRA`.
+- Only Orchestra-backed pipelines can be updated via this endpoint (Git-backed pipelines are rejected).
+- On success, prints the pipeline edit URL (`/pipelines/{pipeline_id}/edit`) when an ID is returned.
+- Exit codes: `0` on success, `1` on failure.
+
+---
+
 ## 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.

{orchestra_cli-0.1.2 → orchestra_cli-0.2.0}/orchestra_cli.egg-info/SOURCES.txt

@@ -8,14 +8,19 @@ orchestra_cli.egg-info/requires.txt
 orchestra_cli.egg-info/top_level.txt
 orchestra_cli/src/__init__.py
 orchestra_cli/src/cli.py
+orchestra_cli/src/create_pipeline.py
 orchestra_cli/src/import_pipeline.py
+orchestra_cli/src/pipeline_upsert.py
 orchestra_cli/src/run_pipeline.py
+orchestra_cli/src/update_pipeline.py
 orchestra_cli/src/validate_pipeline.py
 orchestra_cli/tests/__init__.py
 orchestra_cli/tests/conftest.py
 orchestra_cli/tests/test_cli.py
+orchestra_cli/tests/test_create_pipeline.py
 orchestra_cli/tests/test_import_pipeline.py
 orchestra_cli/tests/test_run_pipeline.py
+orchestra_cli/tests/test_update_pipeline.py
 orchestra_cli/tests/test_validate_pipeline.py
 orchestra_cli/utils/constants.py
 orchestra_cli/utils/git.py

{orchestra_cli-0.1.2 → orchestra_cli-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "orchestra-cli"
-version = "0.1.2"
+version = "0.2.0"
 description = "Orchestra CLI. Perform operations with Orchestra locally."
 readme = "README.md"
 authors = [

orchestra_cli-0.1.2/orchestra_cli/utils/constants.py

@@ -1,7 +0,0 @@
-import os
-
-_PROD_BASE_URL = "https://app.getorchestra.io/api/engine/public/pipelines/{}"
-
-
-def get_api_url(path: str) -> str:
-    return (os.getenv("BASE_URL") or _PROD_BASE_URL).format(path)