mirrorneuron-cli 1.1.4__tar.gz → 1.1.9__tar.gz

{mirrorneuron_cli-1.1.4 → mirrorneuron_cli-1.1.9}/.github/workflows/ci.yml

@@ -1,10 +1,9 @@
 name: CI
 
 on:
-  pull_request:
   push:
-    branches:
-      - main
+    tags:
+      - "v[0-9]*.[0-9]*.[0-9]*"
 
 permissions:
   contents: read

{mirrorneuron_cli-1.1.4 → mirrorneuron_cli-1.1.9}/.github/workflows/release.yml

@@ -3,13 +3,7 @@ name: Release
 on:
   push:
     tags:
-      - "v*.*.*"
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: "Existing release tag to publish, such as v1.0.1 or v1.0.1-rc.1"
-        required: true
-        type: string
+      - "v[0-9]*.[0-9]*.[0-9]*"
 
 permissions:
   contents: read
@@ -31,19 +25,14 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-          ref: ${{ github.event_name == 'workflow_dispatch' && inputs.tag || github.ref }}
+          ref: ${{ github.ref }}
 
       - name: Validate release tag
         id: version
         shell: bash
-        env:
-          INPUT_TAG: ${{ inputs.tag }}
         run: |
           set -euo pipefail
           tag="$GITHUB_REF_NAME"
-          if [[ "$GITHUB_EVENT_NAME" == "workflow_dispatch" ]]; then
-            tag="$INPUT_TAG"
-          fi
           scripts/validate-version-tag.sh "$tag"
 
       - name: Detect project type

mirrorneuron_cli-1.1.9/AGENTS.md

@@ -0,0 +1,9 @@
+# AGENTS.md
+
+Guidance for future coding agents working in this repository.
+
+## Issue Fixing Policy
+
+- Unless the user explicitly asks for a temporary workaround, fix the root cause in the intended layer or contract.
+- Avoid adding fallback paths, compatibility shims, feature flags, or temp solutions that mask a broken primary path.
+- If fallback behavior is already product-specified, keep it narrow, documented, and tested; do not use it to avoid fixing the primary path.

mirrorneuron_cli-1.1.9/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: mirrorneuron-cli
+Version: 1.1.9
+Summary: MirrorNeuron CLI
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mirrorneuron-python-sdk
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Dynamic: license-file
+
+# MirrorNeuron CLI
+
+`mn-cli` provides the `mn` command for validating and running blueprints,
+inspecting runtime state, managing jobs, exporting artifacts, and starting local
+services installed by `mn-deploy`.
+
+## Quick Start
+
+Install locally and run tests:
+
+```bash
+python3 -m venv .venv
+. .venv/bin/activate
+python3 -m pip install -e .
+python3 -m pytest -q
+```
+
+Try the CLI:
+
+```bash
+mn --version
+mn node list
+mn blueprint run message_routing_trace
+```
+
+## Details
+
+- [MirrorNeuron Component Guide](../mn-docs/component-guide.md#cli)
+- [CLI Reference](../mn-docs/cli.md)
+- [Environment Variables](../mn-docs/env_variables.md)
+- [Monitor Guide](../mn-docs/monitor.md)
+
+## Notes
+
+- A running MirrorNeuron core is required for live runtime commands.
+- The default gRPC target comes from `MN_GRPC_TARGET`, then local deployment
+  settings, then `localhost:55051`.
+- Use `mn blueprint validate` before `mn blueprint run --folder` when checking a local bundle.

mirrorneuron_cli-1.1.9/README.md

@@ -0,0 +1,38 @@
+# MirrorNeuron CLI
+
+`mn-cli` provides the `mn` command for validating and running blueprints,
+inspecting runtime state, managing jobs, exporting artifacts, and starting local
+services installed by `mn-deploy`.
+
+## Quick Start
+
+Install locally and run tests:
+
+```bash
+python3 -m venv .venv
+. .venv/bin/activate
+python3 -m pip install -e .
+python3 -m pytest -q
+```
+
+Try the CLI:
+
+```bash
+mn --version
+mn node list
+mn blueprint run message_routing_trace
+```
+
+## Details
+
+- [MirrorNeuron Component Guide](../mn-docs/component-guide.md#cli)
+- [CLI Reference](../mn-docs/cli.md)
+- [Environment Variables](../mn-docs/env_variables.md)
+- [Monitor Guide](../mn-docs/monitor.md)
+
+## Notes
+
+- A running MirrorNeuron core is required for live runtime commands.
+- The default gRPC target comes from `MN_GRPC_TARGET`, then local deployment
+  settings, then `localhost:55051`.
+- Use `mn blueprint validate` before `mn blueprint run --folder` when checking a local bundle.

mirrorneuron_cli-1.1.9/mirrorneuron_cli.egg-info/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: mirrorneuron-cli
+Version: 1.1.9
+Summary: MirrorNeuron CLI
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mirrorneuron-python-sdk
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Dynamic: license-file
+
+# MirrorNeuron CLI
+
+`mn-cli` provides the `mn` command for validating and running blueprints,
+inspecting runtime state, managing jobs, exporting artifacts, and starting local
+services installed by `mn-deploy`.
+
+## Quick Start
+
+Install locally and run tests:
+
+```bash
+python3 -m venv .venv
+. .venv/bin/activate
+python3 -m pip install -e .
+python3 -m pytest -q
+```
+
+Try the CLI:
+
+```bash
+mn --version
+mn node list
+mn blueprint run message_routing_trace
+```
+
+## Details
+
+- [MirrorNeuron Component Guide](../mn-docs/component-guide.md#cli)
+- [CLI Reference](../mn-docs/cli.md)
+- [Environment Variables](../mn-docs/env_variables.md)
+- [Monitor Guide](../mn-docs/monitor.md)
+
+## Notes
+
+- A running MirrorNeuron core is required for live runtime commands.
+- The default gRPC target comes from `MN_GRPC_TARGET`, then local deployment
+  settings, then `localhost:55051`.
+- Use `mn blueprint validate` before `mn blueprint run --folder` when checking a local bundle.

{mirrorneuron_cli-1.1.4 → mirrorneuron_cli-1.1.9}/mirrorneuron_cli.egg-info/SOURCES.txt

@@ -1,8 +1,10 @@
 .gitignore
+AGENTS.md
 LICENSE
 README.md
 RELEASE.md
 pyproject.toml
+uv.lock
 .github/workflows/ci.yml
 .github/workflows/release.yml
 mirrorneuron_cli.egg-info/PKG-INFO
@@ -12,6 +14,7 @@ mirrorneuron_cli.egg-info/entry_points.txt
 mirrorneuron_cli.egg-info/requires.txt
 mirrorneuron_cli.egg-info/top_level.txt
 mn_cli/__init__.py
+mn_cli/banner.py
 mn_cli/config.py
 mn_cli/error_handler.py
 mn_cli/logging_config.py
@@ -20,24 +23,39 @@ mn_cli/server_cmds.py
 mn_cli/shared.py
 mn_cli/update_cmds.py
 mn_cli/libs/__init__.py
+mn_cli/libs/backup_cmds.py
 mn_cli/libs/blueprint_cmds.py
 mn_cli/libs/blueprint_observability.py
 mn_cli/libs/blueprint_repository.py
+mn_cli/libs/blueprint_resources.py
+mn_cli/libs/deployment_cmds.py
+mn_cli/libs/event_relay.py
 mn_cli/libs/job_cmds.py
+mn_cli/libs/resource_cmds.py
 mn_cli/libs/run_cmds.py
 mn_cli/libs/run_logs.py
 mn_cli/libs/run_manifest.py
+mn_cli/libs/schedule_cmds.py
+mn_cli/libs/service_cmds.py
 mn_cli/libs/sys_cmds.py
 mn_cli/libs/ui.py
+mn_cli/libs/workflow_progress.py
 scripts/check-release-artifacts.sh
 scripts/make-release-zip.sh
 scripts/validate-version-tag.sh
 tests/conftest.py
+tests/test_backup_cmds.py
 tests/test_blueprint_cmds.py
 tests/test_blueprint_repository.py
+tests/test_blueprint_resources.py
+tests/test_deployment_cmds.py
 tests/test_job_cmds.py
+tests/test_main.py
 tests/test_run_cmds.py
 tests/test_run_helpers.py
+tests/test_schedule_cmds.py
 tests/test_server_cmds.py
+tests/test_service_cmds.py
+tests/test_shared.py
 tests/test_sys_cmds.py
 tests/test_update_cmds.py

mirrorneuron_cli-1.1.9/mn_cli/banner.py

@@ -0,0 +1,13 @@
+MN_ASCII_ART = r"""
+  __  __ _                     _   _                           
+ |  \/  (_)_ __ _ __ ___  _ __| \ | | ___ _   _ _ __ ___  _ __ 
+ | |\/| | | '__| '__/ _ \| '__|  \| |/ _ \ | | | '__/ _ \| '_ \
+ | |  | | | |  | | | (_) | |  | |\  |  __/ |_| | | | (_) | | | |
+ |_|  |_|_|_|  |_|  \___/|_|  |_| \_|\___|\__,_|_|  \___/|_| |_|
+""".strip("\n")
+
+
+def format_banner(title: str | None = None) -> str:
+    if not title:
+        return MN_ASCII_ART
+    return f"{MN_ASCII_ART}\n\n => {title}"

mirrorneuron_cli-1.1.9/mn_cli/config.py

@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass(frozen=True)
+class CliConfig:
+    grpc_target: str = "localhost:55051"
+    grpc_timeout_seconds: float | None = 10.0
+    grpc_auth_token: str = ""
+    grpc_admin_token: str = ""
+    log_path: Path = Path.home() / ".mn" / "logs" / "cli.log"
+    output_mode: str = "rich"
+
+    @classmethod
+    def from_env(cls) -> "CliConfig":
+        runtime_env = _read_env_file(_mn_home() / "docker-compose.env")
+        core_host = os.getenv("MN_CORE_HOST") or runtime_env.get("MN_CORE_HOST") or "localhost"
+        grpc_port = os.getenv("MN_GRPC_PORT") or runtime_env.get("MN_GRPC_PORT") or "55051"
+        return cls(
+            grpc_target=os.getenv(
+                "MN_GRPC_TARGET",
+                os.getenv(
+                    "MN_CORE_GRPC_TARGET",
+                    runtime_env.get("MN_GRPC_TARGET")
+                    or runtime_env.get("MN_CORE_GRPC_TARGET")
+                    or f"{core_host}:{grpc_port}",
+                ),
+            ),
+            grpc_timeout_seconds=_timeout(),
+            grpc_auth_token=_grpc_auth_token(runtime_env),
+            grpc_admin_token=_grpc_admin_token(runtime_env),
+            log_path=Path(
+                os.getenv(
+                    "MN_CLI_LOG_PATH",
+                    str(Path.home() / ".mn" / "logs" / "cli.log"),
+                )
+            ).expanduser(),
+            output_mode=os.getenv("MN_CLI_OUTPUT", "rich"),
+        )
+
+
+def _mn_home() -> Path:
+    configured_home = os.getenv("MN_HOME") or os.getenv("MIRROR_NEURON_HOME")
+    return Path(configured_home).expanduser() if configured_home else Path.home() / ".mn"
+
+
+def _read_env_file(path: Path) -> dict[str, str]:
+    try:
+        lines = path.read_text(encoding="utf-8").splitlines()
+    except OSError:
+        return {}
+
+    values: dict[str, str] = {}
+    for line in lines:
+        stripped = line.strip()
+        if not stripped or stripped.startswith("#") or "=" not in stripped:
+            continue
+        key, value = stripped.split("=", 1)
+        values[key] = value
+    return values
+
+
+def _timeout() -> float | None:
+    value = os.getenv("MN_GRPC_TIMEOUT_SECONDS", "10")
+    if value.lower() in {"", "none", "0"}:
+        return None
+    try:
+        return float(value)
+    except ValueError as exc:
+        raise ValueError("MN_GRPC_TIMEOUT_SECONDS must be a number, 0, or none") from exc
+
+
+def _grpc_auth_token(runtime_env: dict[str, str] | None = None) -> str:
+    token = os.getenv("MN_GRPC_AUTH_TOKEN")
+    if token:
+        return token
+    token = (runtime_env or {}).get("MN_GRPC_AUTH_TOKEN", "")
+    if token:
+        return token
+
+    return _read_token_file("grpc_auth.token")
+
+
+def _grpc_admin_token(runtime_env: dict[str, str] | None = None) -> str:
+    token = os.getenv("MN_MIRROR_NEURON_GRPC_ADMIN_TOKEN")
+    if token:
+        return token
+    token = (runtime_env or {}).get("MN_MIRROR_NEURON_GRPC_ADMIN_TOKEN", "")
+    if token:
+        return token
+
+    return _read_token_file("grpc_admin.token")
+
+
+def _read_token_file(name: str) -> str:
+    for token_file in (_mn_home() / name, Path.home() / ".mirror_neuron" / name):
+        try:
+            token = token_file.read_text().strip()
+        except OSError:
+            continue
+        if token:
+            return token
+    return ""

{mirrorneuron_cli-1.1.4 → mirrorneuron_cli-1.1.9}/mn_cli/error_handler.py

@@ -14,8 +14,27 @@ CONTEXT_MESSAGES = {
     "cancel": "Error cancelling job",
     "pause": "Error pausing job",
     "resume": "Error resuming job",
+    "backup": "Error backing up job",
+    "restore": "Error restoring job",
     "nodes": "Error fetching nodes",
+    "reconcile-node": "Error reconciling node",
+    "drain-node": "Error draining node",
+    "undrain-node": "Error cancelling node drain",
+    "maintenance-node": "Error changing node maintenance",
     "metrics": "Error fetching metrics",
+    "resource list": "Error fetching resources",
+    "resource set": "Error setting resource limits",
+    "service list": "Error listing services",
+    "service resolve": "Error resolving service",
+    "service check": "Service validation failed",
+    "deploy": "Error deploying bundle",
+    "deployment list": "Error listing deployments",
+    "deployment status": "Error fetching deployment",
+    "deployment promote": "Error promoting deployment",
+    "deployment rollback": "Error rolling back deployment",
+    "deployment pause": "Error pausing deployment",
+    "deployment resume": "Error resuming deployment",
+    "deployment fail": "Error failing deployment",
     "dead_letters": "Error listing dead letters",
     "run bundle": "Error running bundle",
     "monitor stream": "Error fetching job",