mirrorneuron-cli 1.1.0__tar.gz → 1.1.2__tar.gz

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/.github/workflows/ci.yml

@@ -102,7 +102,7 @@ jobs:
           if [[ "$GITHUB_REPOSITORY" == "MirrorNeuronLab/mn-system-tests" ]]; then
             python -m pip install pytest pytest-cov requests
             python -m pip install "mirrorneuron-python-sdk @ git+https://github.com/MirrorNeuronLab/mn-python-sdk.git"
-            python -m pip install "mn-cli @ git+https://github.com/MirrorNeuronLab/mn-cli.git"
+            python -m pip install "mirrorneuron-cli @ git+https://github.com/MirrorNeuronLab/mn-cli.git"
           elif [[ -f requirements.txt && "${{ steps.detect.outputs.has_python_package }}" != "true" ]]; then
             python -m pip install -r requirements.txt
           fi

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/.github/workflows/release.yml

@@ -128,7 +128,7 @@ jobs:
           if [[ "$GITHUB_REPOSITORY" == "MirrorNeuronLab/mn-system-tests" ]]; then
             python -m pip install pytest pytest-cov requests
             python -m pip install "mirrorneuron-python-sdk @ git+https://github.com/MirrorNeuronLab/mn-python-sdk.git"
-            python -m pip install "mn-cli @ git+https://github.com/MirrorNeuronLab/mn-cli.git"
+            python -m pip install "mirrorneuron-cli @ git+https://github.com/MirrorNeuronLab/mn-cli.git"
           elif [[ -f requirements.txt && "${{ steps.detect.outputs.has_python_package }}" != "true" ]]; then
             python -m pip install -r requirements.txt
           fi
@@ -345,7 +345,7 @@ jobs:
         run: |
           set -euo pipefail
 
-          if gh release view "$TAG_NAME" >/dev/null 2>&1; then
+          if gh release view "$TAG_NAME" --repo "$GITHUB_REPOSITORY" >/dev/null 2>&1; then
             echo "Release $TAG_NAME already exists; refusing to overwrite it." >&2
             exit 1
           fi
@@ -356,7 +356,7 @@ jobs:
             exit 1
           fi
 
-          release_args=(release create "$TAG_NAME")
+          release_args=(release create "$TAG_NAME" --repo "$GITHUB_REPOSITORY")
           release_args+=("${assets[@]}")
           release_args+=(--title "$TAG_NAME" --verify-tag --generate-notes)
 

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: mirrorneuron-cli
-Version: 1.1.0
+Version: 1.1.2
 Summary: MirrorNeuron CLI
 License-Expression: MIT
 Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.9
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: mirrorneuron-python-sdk
@@ -31,7 +31,7 @@ The CLI submits workflow bundles, monitors jobs, manages the local runtime servi
 
 | Area | Tooling |
 | --- | --- |
-| Runtime | Python 3.9+ |
+| Runtime | Python 3.11+ |
 | CLI framework | Typer |
 | Terminal rendering | Rich |
 | Core client | `mirrorneuron-python-sdk` |
@@ -39,7 +39,7 @@ The CLI submits workflow bundles, monitors jobs, manages the local runtime servi
 
 ## Prerequisites
 
-- Python 3.9 or newer.
+- Python 3.11 or newer.
 - A MirrorNeuron core reachable over gRPC.
 - Docker for the default local core and Redis workflow.
 - Optional: the released-package installer from `mn-deploy`, which installs and wires the CLI automatically.
@@ -91,6 +91,7 @@ Submit and inspect a workflow:
 mn validate ./bundle
 mn run ./bundle
 mn list
+mn unfinished
 mn status <job_id>
 mn monitor <job_id>
 ```

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/README.md

@@ -17,7 +17,7 @@ The CLI submits workflow bundles, monitors jobs, manages the local runtime servi
 
 | Area | Tooling |
 | --- | --- |
-| Runtime | Python 3.9+ |
+| Runtime | Python 3.11+ |
 | CLI framework | Typer |
 | Terminal rendering | Rich |
 | Core client | `mirrorneuron-python-sdk` |
@@ -25,7 +25,7 @@ The CLI submits workflow bundles, monitors jobs, manages the local runtime servi
 
 ## Prerequisites
 
-- Python 3.9 or newer.
+- Python 3.11 or newer.
 - A MirrorNeuron core reachable over gRPC.
 - Docker for the default local core and Redis workflow.
 - Optional: the released-package installer from `mn-deploy`, which installs and wires the CLI automatically.
@@ -77,6 +77,7 @@ Submit and inspect a workflow:
 mn validate ./bundle
 mn run ./bundle
 mn list
+mn unfinished
 mn status <job_id>
 mn monitor <job_id>
 ```

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/mirrorneuron_cli.egg-info/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: mirrorneuron-cli
-Version: 1.1.0
+Version: 1.1.2
 Summary: MirrorNeuron CLI
 License-Expression: MIT
 Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.9
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: mirrorneuron-python-sdk
@@ -31,7 +31,7 @@ The CLI submits workflow bundles, monitors jobs, manages the local runtime servi
 
 | Area | Tooling |
 | --- | --- |
-| Runtime | Python 3.9+ |
+| Runtime | Python 3.11+ |
 | CLI framework | Typer |
 | Terminal rendering | Rich |
 | Core client | `mirrorneuron-python-sdk` |
@@ -39,7 +39,7 @@ The CLI submits workflow bundles, monitors jobs, manages the local runtime servi
 
 ## Prerequisites
 
-- Python 3.9 or newer.
+- Python 3.11 or newer.
 - A MirrorNeuron core reachable over gRPC.
 - Docker for the default local core and Redis workflow.
 - Optional: the released-package installer from `mn-deploy`, which installs and wires the CLI automatically.
@@ -91,6 +91,7 @@ Submit and inspect a workflow:
 mn validate ./bundle
 mn run ./bundle
 mn list
+mn unfinished
 mn status <job_id>
 mn monitor <job_id>
 ```

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/mn_cli/error_handler.py

@@ -1,4 +1,3 @@
-import sys
 import grpc
 from rich.console import Console
 from mn_cli.config import CliConfig
@@ -38,7 +37,7 @@ def handle_cli_error(e: Exception, console: Console, context: str = ""):
         elif code == grpc.StatusCode.INTERNAL and "not found" in str(details).lower():
             console.print(f"[red]Error: Cannot find the job by ID. ({details})[/red]")
         elif code == grpc.StatusCode.INTERNAL and "terminal state" in str(details).lower():
-            console.print(f"[red]Error: Job is already in a terminal state and cannot be modified.[/red]")
+            console.print("[red]Error: Job is already in a terminal state and cannot be modified.[/red]")
         elif code == grpc.StatusCode.RESOURCE_EXHAUSTED:
             console.print("[yellow]Runtime is under CPU/GPU/memory pressure and is not accepting new jobs.[/yellow]")
             console.print(f"[dim]{details}[/dim]")

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/mn_cli/libs/job_cmds.py

@@ -34,16 +34,18 @@ def list_jobs(running_only: bool = typer.Option(False, "--running-only", help="O
         jobs_json = client.list_jobs()
         data = json.loads(jobs_json)
 
-        table = Table("Job ID", "Graph ID", "Status", "Submitted At")
+        table = recovery_table("Submitted At")
         for job in data.get("data", []):
             status = job.get("status", "N/A")
-            if running_only and status not in ["running", "pending", "scheduled", "validated", "paused"]:
+            live_statuses = ["running", "pending", "scheduled", "validated", "paused"]
+            if running_only and status not in live_statuses:
                 continue
-                
+
             table.add_row(
                 job.get("job_id", "N/A"),
                 job.get("graph_id", "N/A"),
                 status,
+                recovery_label(job),
                 job.get("submitted_at", "N/A"),
             )
         console.print(table)
@@ -60,6 +62,7 @@ def clear():
     except Exception as e:
         handle_cli_error(e, console, 'clear')
 
+
 def cancel(job_id: str):
     """Cancel a running job"""
     try:
@@ -87,6 +90,68 @@ def resume(job_id: str):
         handle_cli_error(e, console, 'resume')
 
 
+def unfinished():
+    """List unfinished jobs that may need recovery or manual resume"""
+    try:
+        jobs_json = client.list_jobs(include_terminal=False)
+        data = json.loads(jobs_json)
+        jobs = data.get("data", [])
+
+        if not jobs:
+            console.print("[green]No unfinished jobs.[/green]")
+            return
+
+        table = recovery_table("Updated At", include_review=True)
+        for job in jobs:
+            table.add_row(
+                job.get("job_id", "N/A"),
+                job.get("graph_id", "N/A"),
+                job.get("status", "N/A"),
+                recovery_label(job),
+                "yes" if recovery_requires_review(job) else "no",
+                job.get("updated_at") or job.get("submitted_at", "N/A"),
+            )
+
+        console.print(table)
+        for job in jobs:
+            review = "yes" if recovery_requires_review(job) else "no"
+            console.print(
+                f"{job.get('job_id', 'N/A')} recovery={recovery_label(job)} review={review}"
+            )
+        console.print(
+            "Use [bold]mn status <job_id>[/bold] to inspect and "
+            "[bold]mn resume <job_id>[/bold] to continue a paused run."
+        )
+    except Exception as e:
+        handle_cli_error(e, console, 'list_jobs')
+
+
+def recovery_label(job: dict) -> str:
+    recovery = job.get("recovery") or {}
+    return (
+        job.get("recovery_status")
+        or recovery.get("status")
+        or "normal"
+    )
+
+
+def recovery_requires_review(job: dict) -> bool:
+    recovery = job.get("recovery") or {}
+    return bool(job.get("recovery_requires_review") or recovery.get("requires_review"))
+
+
+def recovery_table(time_column: str, include_review: bool = False) -> Table:
+    table = Table()
+    table.add_column("Job ID", no_wrap=True)
+    table.add_column("Graph ID", no_wrap=True)
+    table.add_column("Status", no_wrap=True)
+    table.add_column("Recovery", no_wrap=True)
+    if include_review:
+        table.add_column("Review", no_wrap=True)
+    table.add_column(time_column, no_wrap=True)
+    return table
+
+
 def nodes():
     """Get system summary and nodes"""
     try:

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/mn_cli/libs/run_cmds.py

@@ -224,7 +224,6 @@ def _stream_and_format_events(
     )
     
     status_text = "Unknown / Detached"
-    status_color = "yellow"
     msg_count = 0
     
     try:
@@ -284,12 +283,10 @@ def _stream_and_format_events(
                             description="[green]Completed successfully.",
                         )
                         status_text = "Success"
-                        status_color = "green"
                         break
                     elif event_type == "job_failed":
                         progress.update(job_task, description="[red]Job failed.")
                         status_text = "Failed"
-                        status_color = "red"
                         break
                     else:
                         progress.update(
@@ -706,7 +703,7 @@ def _live_monitor(job_id: str):
     view = MonitorView()
     
     try:
-        with Live(view, refresh_per_second=12, console=console) as live:
+        with Live(view, refresh_per_second=12, console=console):
             while True:
                 try:
                     job_json = client.get_job(job_id)
@@ -771,7 +768,7 @@ def result(job_id: str):
         if res_file.exists():
             console.print(f"[green]Final result saved to: {res_file}[/green]")
         else:
-            console.print(f"[yellow]No final result found (job might not be completed).[/yellow]")
+            console.print("[yellow]No final result found (job might not be completed).[/yellow]")
             
         if stream_file.exists():
             console.print(f"[green]Stream results saved to: {stream_file}[/green]")

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/mn_cli/libs/sys_cmds.py

@@ -1,4 +1,3 @@
-import typer
 import subprocess
 import os
 import time

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/mn_cli/libs/ui.py

@@ -25,7 +25,7 @@ def generate_live_layout(job_id: str, data: Dict[str, Any]) -> Group:
         frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
         idx = int(time.time() * 12.5) % len(frames)
         spinner_str = f"[cyan]{frames[idx]}[/cyan]"
-    except:
+    except Exception:
         pass
 
     info_text = (

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/mn_cli/main.py

@@ -24,6 +24,7 @@ app.command(name="clear")(job_cmds.clear)
 app.command(name="cancel")(job_cmds.cancel)
 app.command(name="pause")(job_cmds.pause)
 app.command(name="resume")(job_cmds.resume)
+app.command(name="unfinished")(job_cmds.unfinished)
 app.command(name="nodes")(job_cmds.nodes)
 app.command(name="metrics")(job_cmds.metrics)
 app.command(name="dead-letters")(job_cmds.dead_letters)

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/mn_cli/update_cmds.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import json
 import os
 import subprocess
@@ -13,7 +15,7 @@ from typing import Optional
 import typer
 from rich.console import Console
 
-from mn_cli.server_cmds import DIR, VENV_DIR, WEB_UI_DIRS, _start_server
+from mn_cli.server_cmds import DIR, WEB_UI_DIRS, _start_server
 
 console = Console()
 

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/pyproject.toml

@@ -3,7 +3,7 @@ name = "mirrorneuron-cli"
 dynamic = ["version"]
 description = "MirrorNeuron CLI"
 readme = "README.md"
-requires-python = ">=3.9"
+requires-python = ">=3.11"
 license = "MIT"
 classifiers = [
     "Programming Language :: Python :: 3",

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/tests/test_blueprint_cmds.py

@@ -1,11 +1,8 @@
 import pytest
 import importlib.util
 import json
-import subprocess
 from typer.testing import CliRunner
 from mn_cli.main import app
-import os
-from pathlib import Path
 
 runner = CliRunner()
 requires_blueprint_support = pytest.mark.skipif(

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/tests/test_job_cmds.py

@@ -1,4 +1,3 @@
-import pytest
 from typer.testing import CliRunner
 import json
 
@@ -47,11 +46,12 @@ def test_status_error(mocker):
 def test_list_jobs_success(mocker):
     mock_list = mocker.patch(
         'mn_cli.libs.job_cmds.client.list_jobs',
-        return_value=json.dumps({"data": [{"job_id": "job-1", "graph_id": "g-1", "status": "completed", "submitted_at": "2023-10-01"}]})
+        return_value=json.dumps({"data": [{"job_id": "job-1", "graph_id": "g-1", "status": "completed", "submitted_at": "2023-10-01", "recovery_status": "normal"}]})
     )
     result = runner.invoke(app, ["list"])
     assert result.exit_code == 0
     assert "job-1" in result.stdout
+    assert "normal" in result.stdout
     mock_list.assert_called_once()
 
 def test_list_jobs_running_only_success(mocker):
@@ -126,6 +126,68 @@ def test_resume_error(mocker):
     assert result.exit_code == 0
     assert "Error resuming job: Fail" in result.stdout
 
+
+def test_unfinished_jobs_shows_recovery_review_state(mocker):
+    mock_list = mocker.patch(
+        'mn_cli.libs.job_cmds.client.list_jobs',
+        return_value=json.dumps({"data": [
+            {
+                "job_id": "job-review",
+                "graph_id": "g-review",
+                "status": "paused",
+                "updated_at": "2026-05-05T00:00:00Z",
+                "recovery_status": "paused_for_review",
+                "recovery_requires_review": True,
+            }
+        ]})
+    )
+
+    result = runner.invoke(app, ["unfinished"])
+
+    assert result.exit_code == 0
+    assert "job-review" in result.stdout
+    assert "paused_for_review" in result.stdout
+    assert "yes" in result.stdout
+    assert "mn resume <job_id>" in result.stdout
+    mock_list.assert_called_once_with(include_terminal=False)
+
+
+def test_unfinished_jobs_empty(mocker):
+    mocker.patch(
+        'mn_cli.libs.job_cmds.client.list_jobs',
+        return_value=json.dumps({"data": []})
+    )
+
+    result = runner.invoke(app, ["unfinished"])
+
+    assert result.exit_code == 0
+    assert "No unfinished jobs" in result.stdout
+
+
+def test_unfinished_jobs_accepts_nested_recovery_summary(mocker):
+    mocker.patch(
+        'mn_cli.libs.job_cmds.client.list_jobs',
+        return_value=json.dumps({"data": [
+            {
+                "job_id": "job-nested",
+                "graph_id": "g-nested",
+                "status": "paused",
+                "submitted_at": "2026-05-05T00:00:00Z",
+                "recovery": {
+                    "status": "paused_for_review",
+                    "requires_review": True,
+                },
+            }
+        ]})
+    )
+
+    result = runner.invoke(app, ["unfinished"])
+
+    assert result.exit_code == 0
+    assert "job-nested" in result.stdout
+    assert "paused_for_review" in result.stdout
+    assert "review=yes" in result.stdout
+
 def test_nodes_success(mocker):
     mock_nodes = mocker.patch('mn_cli.libs.job_cmds.client.get_system_summary', return_value='{"nodes": ["node1"]}')
     result = runner.invoke(app, ["nodes"])

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/tests/test_run_cmds.py

@@ -1,4 +1,3 @@
-import pytest
 import json
 import logging
 import re
@@ -287,7 +286,7 @@ def test_job_log_writer_extracts_web_ui_url_once():
     assert writer.record_web_ui_url(event) is None
 
 def test_run_error_submitting(mocker, tmp_path):
-    mock_submit = mocker.patch('mn_cli.libs.run_cmds.client.submit_job', side_effect=Exception("API failure"))
+    mocker.patch('mn_cli.libs.run_cmds.client.submit_job', side_effect=Exception("API failure"))
     
     bundle_dir = tmp_path / "run_bundle"
     bundle_dir.mkdir()
@@ -300,8 +299,8 @@ def test_run_error_submitting(mocker, tmp_path):
     assert "Error running bundle: API failure" in result.stdout
 
 def test_run_keyboard_interrupt(mocker, tmp_path):
-    mock_submit = mocker.patch('mn_cli.libs.run_cmds.client.submit_job', return_value="job-123")
-    mock_stream = mocker.patch('mn_cli.libs.run_cmds.client.stream_events', side_effect=KeyboardInterrupt)
+    mocker.patch('mn_cli.libs.run_cmds.client.submit_job', return_value="job-123")
+    mocker.patch('mn_cli.libs.run_cmds.client.stream_events', side_effect=KeyboardInterrupt)
     
     bundle_dir = tmp_path / "run_bundle"
     bundle_dir.mkdir()
@@ -343,7 +342,7 @@ def test_monitor_error(mocker):
     assert result.exit_code == 0
     assert "Error fetching job: Network fail" in result.stdout
 def test_result_success(mocker, tmp_path):
-    mock_get = mocker.patch('mn_cli.libs.run_cmds.client.get_job', return_value=json.dumps({
+    mocker.patch('mn_cli.libs.run_cmds.client.get_job', return_value=json.dumps({
         "job": {"status": "completed", "result": {"test": "result"}},
         "recent_events": []
     }))
@@ -378,7 +377,7 @@ def test_result_error(mocker):
     assert "Error fetching results: DB Error" in result.stdout
 
 def test_stream_bad_json(mocker, tmp_path):
-    mock_stream = mocker.patch('mn_cli.libs.run_cmds.client.stream_events', return_value=[
+    mocker.patch('mn_cli.libs.run_cmds.client.stream_events', return_value=[
         "invalid json format",
         json.dumps({"type": "job_failed"})
     ])
@@ -415,7 +414,7 @@ def test_stream_all_events(mocker, tmp_path):
         json.dumps({"type": "custom_progressive", "payload": {"foo": "progressive"}}),
         json.dumps({"type": "job_completed", "result": {"foo": "bar"}})
     ]
-    mock_stream = mocker.patch('mn_cli.libs.run_cmds.client.stream_events', return_value=events)
+    mocker.patch('mn_cli.libs.run_cmds.client.stream_events', return_value=events)
     mocker.patch('mn_cli.libs.run_cmds.client.submit_job', return_value="job-123")
     
     bundle_dir = tmp_path / "run_bundle"
@@ -430,7 +429,7 @@ def test_stream_all_events(mocker, tmp_path):
     assert "result_stream.txt" in result.stdout
 
 def test_stream_keyboard_interrupt(mocker, tmp_path):
-    mock_stream = mocker.patch('mn_cli.libs.run_cmds.client.stream_events', side_effect=KeyboardInterrupt)
+    mocker.patch('mn_cli.libs.run_cmds.client.stream_events', side_effect=KeyboardInterrupt)
     mocker.patch('mn_cli.libs.run_cmds.client.submit_job', return_value="job-123")
     
     bundle_dir = tmp_path / "run_bundle"

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/tests/test_server_cmds.py

@@ -1,9 +1,6 @@
 import pytest
-import os
-import signal
 import subprocess
 from io import StringIO
-from pathlib import Path
 from rich.console import Console
 from mn_cli.server_cmds import check_status, kill_tree, _start_server, find_web_ui_dir, _start_web_ui_if_installed, _print_service_endpoints
 import typer
@@ -34,7 +31,7 @@ def test_kill_tree(mocker):
     mock_kill = mocker.patch('mn_cli.server_cmds.os.kill')
     
     # Mock pgrep to return children
-    mock_check_output = mocker.patch('mn_cli.server_cmds.subprocess.check_output', side_effect=[
+    mocker.patch('mn_cli.server_cmds.subprocess.check_output', side_effect=[
         b" 1235 \n 1236 \n", # First call for parent 1234
         subprocess.CalledProcessError(1, "pgrep"), # Second call for child 1235
         subprocess.CalledProcessError(1, "pgrep")  # Third call for child 1236

{mirrorneuron_cli-1.1.0 → mirrorneuron_cli-1.1.2}/tests/test_sys_cmds.py

@@ -1,8 +1,5 @@
-import pytest
 from typer.testing import CliRunner
 from mn_cli.main import app
-import os
-from pathlib import Path
 
 runner = CliRunner()
 
@@ -28,7 +25,7 @@ def test_leave_success(mocker):
 
 def test_leave_error(mocker):
     import mn_cli.shared
-    mock_remove = mocker.patch.object(mn_cli.shared.client, 'remove_node', side_effect=Exception("Timeout"))
+    mocker.patch.object(mn_cli.shared.client, 'remove_node', side_effect=Exception("Timeout"))
     result = runner.invoke(app, ["leave", "mirror_neuron@1.2.3.4"])
     assert result.exit_code == 0
     assert "Error removing node: Timeout" in result.stdout