Add 'pipelinerun list' command to CLI

[SharangC96]

Summary

Adds a new clarifai pipelinerun list (alias clarifai pr ls) command that lists runs for a pipeline version, completing the pipeline-run CLI alongside the existing pause, cancel, resume, and monitor subcommands.

Changes

Client (clarifai/client/pipeline.py)

• New Pipeline.list_pipeline_version_runs(pipeline_version_id=None, filter_by=None, page_no=None, per_page=None) method.
• Wraps the existing STUB.ListPipelineVersionRuns gRPC endpoint via list_pages_generator.
• Accepts pipeline_version_id as an explicit argument; falls back to self.pipeline_version_id.
• Raises UserError if neither is set.

CLI (clarifai/cli/pipeline_run.py)

• New pipelinerun list / pr ls command.
• Options: --user_id, --app_id, --pipeline_id, --pipeline_version_id, --page_no (default 1), --per_page (default 16).
• Reuses _load_pipeline_params_from_config so missing IDs are loaded from config-lock.yaml when run inside a pipeline workspace (consistent with the rest of the pipelinerun group).
• Enforces all four IDs via _validate_pipeline_params after lockfile resolution — matches the backend's ListPipelineVersionRunsRequest validator.
• Renders results with display_co_resources as a plain-text table.
  • Columns: ID, USER_ID, APP_ID, PIPELINE_VERSION_ID, STATUS, CREATED_AT, MODIFIED_AT, STARTED_AT, ENDED_AT.
  • Sorted by CREATED_AT desc.

Tests (tests/cli/test_pipeline_run.py)

• test_list_with_flags — explicit flag invocation.
• test_list_with_config_lock — lockfile fallback.
• test_list_without_required_params — errors when nothing is supplied.
• test_list_without_pipeline_version_id — errors when version is missing.

All 17 tests in tests/cli/test_pipeline_run.py pass.

Example usage

# Inside a pipeline workspace (uses config-lock.yaml):
clarifai pr ls

# Explicit IDs:
clarifai pr ls \
  --user_id=USER_ID \
  --app_id=APP_ID \
  --pipeline_id=PIPELINE_ID \
  --pipeline_version_id=VERSION_ID

Notes

• No .proto or gRPC stub changes — ListPipelineVersionRuns already exists in clarifai_grpc.
• The backend currently requires pipeline_version_id; if that constraint is relaxed in the future, we can revisit adding an "all versions" mode.

[github-actions]

Package	Line Rate	Health
clarifai	45%	❌
clarifai.cli	63%	➖
clarifai.cli.templates	67%	➖
clarifai.cli.templates.toolkits	100%	✔
clarifai.client	64%	➖
clarifai.client.auth	67%	➖
clarifai.constants	100%	✔
clarifai.datasets	100%	✔
clarifai.datasets.export	69%	➖
clarifai.datasets.upload	75%	➖
clarifai.datasets.upload.loaders	37%	❌
clarifai.models	100%	✔
clarifai.rag	0%	❌
clarifai.runners	52%	➖
clarifai.runners.models	62%	➖
clarifai.runners.pipeline_steps	45%	❌
clarifai.runners.pipelines	78%	➖
clarifai.runners.utils	61%	➖
clarifai.runners.utils.data_types	72%	➖
clarifai.schema	100%	✔
clarifai.urls	56%	➖
clarifai.utils	62%	➖
clarifai.utils.evaluation	16%	❌
clarifai.workflows	95%	✔
examples	50%	➖
Summary	61% (12738 / 20848)	➖

Minimum allowed line rate is 50%