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

{mirrorneuron_cli-1.1.4 → mirrorneuron_cli-1.2.5}/.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.2.5}/.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.4 → mirrorneuron_cli-1.2.5}/.gitignore

@@ -1,6 +1,9 @@
 # Environments
 .env
+.env.*
+!.env.example
 .venv
+.venv/
 env/
 venv/
 ENV/
@@ -30,5 +33,18 @@ __pycache__/
 *.py[cod]
 *$py.class
 .pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.pyre/
+.hypothesis/
+.tox/
+.nox/
 .coverage
-htmlcov/
+.coverage.*
+coverage.xml
+htmlcov/
+
+# Local editor and OS files
+.DS_Store
+.idea/
+.vscode/

mirrorneuron_cli-1.2.5/.python-version

@@ -0,0 +1 @@
+3.11.15

mirrorneuron_cli-1.2.5/AGENTS.md

@@ -0,0 +1,10 @@
+# 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.2.5/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: mirrorneuron-cli
+Version: 1.2.5
+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: jsonschema>=4.25
+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.11 -m venv .venv
+. .venv/bin/activate
+.venv/bin/python -m pip install -e .
+.venv/bin/python -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.2.5/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.11 -m venv .venv
+. .venv/bin/activate
+.venv/bin/python -m pip install -e .
+.venv/bin/python -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.2.5/mirrorneuron_cli.egg-info/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: mirrorneuron-cli
+Version: 1.2.5
+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: jsonschema>=4.25
+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.11 -m venv .venv
+. .venv/bin/activate
+.venv/bin/python -m pip install -e .
+.venv/bin/python -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.2.5}/mirrorneuron_cli.egg-info/SOURCES.txt

@@ -1,8 +1,11 @@
 .gitignore
+.python-version
+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,32 +15,69 @@ 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
 mn_cli/main.py
+mn_cli/runtime_mode.py
+mn_cli/runtime_state.py
+mn_cli/sdk_path.py
 mn_cli/server_cmds.py
 mn_cli/shared.py
+mn_cli/terminal.py
 mn_cli/update_cmds.py
 mn_cli/libs/__init__.py
+mn_cli/libs/artifacts.py
+mn_cli/libs/backup_cmds.py
 mn_cli/libs/blueprint_cmds.py
+mn_cli/libs/blueprint_models.py
 mn_cli/libs/blueprint_observability.py
 mn_cli/libs/blueprint_repository.py
+mn_cli/libs/blueprint_resources.py
+mn_cli/libs/bundles.py
+mn_cli/libs/deployment_cmds.py
+mn_cli/libs/event_relay.py
 mn_cli/libs/job_cmds.py
+mn_cli/libs/model_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/runtime_health.py
+mn_cli/libs/schedule_cmds.py
+mn_cli/libs/service_cmds.py
+mn_cli/libs/skill_runtime.py
 mn_cli/libs/sys_cmds.py
 mn_cli/libs/ui.py
+mn_cli/libs/workflow_progress.py
+mn_cli/libs/workflow_validation.py
+mn_cli/schemas/workflow_manifest.schema.json
 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_docker_network_integration.py
 tests/test_job_cmds.py
+tests/test_main.py
+tests/test_model_cmds.py
+tests/test_resource_cmds.py
 tests/test_run_cmds.py
 tests/test_run_helpers.py
+tests/test_runtime_health.py
+tests/test_runtime_mode.py
+tests/test_runtime_state.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
+tests/test_terminal.py
+tests/test_ui.py
+tests/test_update_cmds.py
+tests/test_workflow_validation.py

{mirrorneuron_cli-1.1.4 → mirrorneuron_cli-1.2.5}/mirrorneuron_cli.egg-info/requires.txt

@@ -1,3 +1,4 @@
 mirrorneuron-python-sdk
+jsonschema>=4.25
 typer>=0.9.0
 rich>=13.0.0

mirrorneuron_cli-1.2.5/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.2.5/mn_cli/config.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from pathlib import Path
+
+from mn_cli.sdk_path import add_local_sdk_path
+
+add_local_sdk_path("runtime_config.py")
+
+from mn_sdk.runtime_config import RuntimeConfig, default_logs_root
+
+
+@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 = default_logs_root() / "cli.log"
+    output_mode: str = "rich"
+
+    @classmethod
+    def from_env(cls) -> "CliConfig":
+        runtime_config = RuntimeConfig.from_env()
+        return cls(
+            grpc_target=runtime_config.grpc_target,
+            grpc_timeout_seconds=runtime_config.grpc_timeout_seconds,
+            grpc_auth_token=runtime_config.grpc_auth_token,
+            grpc_admin_token=runtime_config.grpc_admin_token,
+            log_path=Path(
+                os.getenv(
+                    "MN_CLI_LOG_PATH",
+                    str(default_logs_root() / "cli.log"),
+                )
+            ).expanduser(),
+            output_mode=os.getenv("MN_CLI_OUTPUT", "rich"),
+        )

{mirrorneuron_cli-1.1.4 → mirrorneuron_cli-1.2.5}/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",

mirrorneuron_cli-1.2.5/mn_cli/libs/artifacts.py

@@ -0,0 +1,139 @@
+from __future__ import annotations
+
+import hashlib
+import mimetypes
+import os
+import socket
+from pathlib import Path
+from typing import Any
+
+from mn_sdk.runtime_config import resolve_mn_home
+
+from mn_cli.runtime_state import read_env_file
+
+DEFAULT_INLINE_PAYLOAD_MAX_BYTES = 1_048_576
+DEFAULT_ARTIFACT_PORT = "55660"
+
+
+def promote_large_payloads_to_blob_refs(
+    manifest: dict[str, Any],
+    payloads: dict[str, bytes],
+    *,
+    runtime_env: dict[str, str] | None = None,
+) -> list[dict[str, Any]]:
+    threshold = _inline_payload_max_bytes()
+    if threshold < 0:
+        return []
+
+    env = _runtime_env_file_values()
+    env.update(os.environ)
+    env.update(runtime_env or {})
+    root = _host_blob_store_root(env)
+    promoted: list[dict[str, Any]] = []
+
+    for rel_path, contents in list(payloads.items()):
+        if len(contents) <= threshold:
+            continue
+
+        blob_ref = _store_payload_blob(root, rel_path, contents, env)
+        promoted.append(blob_ref)
+        del payloads[rel_path]
+
+    if promoted:
+        metadata = manifest.setdefault("metadata", {})
+        artifacts = metadata.setdefault("mn_artifacts", {})
+        artifacts.setdefault("blob_refs", []).extend(promoted)
+
+    return promoted
+
+
+def _store_payload_blob(
+    root: Path,
+    rel_path: str,
+    contents: bytes,
+    env: dict[str, str],
+) -> dict[str, Any]:
+    sha256 = hashlib.sha256(contents).hexdigest()
+    target = root / sha256[:2] / sha256
+    target.parent.mkdir(parents=True, exist_ok=True)
+
+    if not target.exists():
+        tmp = target.with_name(f"{target.name}.tmp-{os.getpid()}")
+        tmp.write_bytes(contents)
+        os.replace(tmp, target)
+
+    media_type, _encoding = mimetypes.guess_type(rel_path)
+    location = _blob_location(sha256, env)
+
+    blob_ref: dict[str, Any] = {
+        "type": "blob_ref",
+        "sha256": sha256,
+        "size_bytes": len(contents),
+        "media_type": media_type or "application/octet-stream",
+        "logical_name": Path(rel_path).name,
+        "scope": "job",
+        "payload_path": rel_path.replace("\\", "/"),
+    }
+
+    if location:
+        blob_ref["locations"] = [location]
+
+    return blob_ref
+
+
+def _blob_location(sha256: str, env: dict[str, str]) -> dict[str, str] | None:
+    base_url = str(env.get("MN_ARTIFACT_ADVERTISE_URL") or os.getenv("MN_ARTIFACT_ADVERTISE_URL") or "").strip()
+    if not base_url:
+        host = (
+            str(env.get("MN_NETWORK_ADVERTISE_HOST") or os.getenv("MN_NETWORK_ADVERTISE_HOST") or "").strip()
+            or _detect_lan_ip()
+        )
+        port = str(env.get("MN_ARTIFACT_PORT") or os.getenv("MN_ARTIFACT_PORT") or DEFAULT_ARTIFACT_PORT).strip()
+        if not host or not port:
+            return None
+        base_url = f"http://{host}:{port}"
+
+    location = {
+        "url": f"{base_url.rstrip('/')}/blobs/{sha256}",
+        "status": "available",
+    }
+    node = str(env.get("MN_NODE_NAME") or os.getenv("MN_NODE_NAME") or "").strip()
+    if node:
+        location["node"] = node
+    return location
+
+
+def _host_blob_store_root(env: dict[str, str]) -> Path:
+    configured = (
+        env.get("MN_HOST_BLOB_STORE_DIR")
+        or os.getenv("MN_HOST_BLOB_STORE_DIR")
+        or env.get("MN_BLOB_STORE_ROOT")
+        or os.getenv("MN_BLOB_STORE_ROOT")
+    )
+    if configured:
+        return Path(configured).expanduser()
+    return resolve_mn_home() / "blobs"
+
+
+def _runtime_env_file_values() -> dict[str, str]:
+    env_file = resolve_mn_home() / "docker-compose.env"
+    return {key.strip(): value.strip() for key, value in read_env_file(env_file).items()}
+
+
+def _inline_payload_max_bytes() -> int:
+    value = os.getenv("MN_INLINE_PAYLOAD_MAX_BYTES", str(DEFAULT_INLINE_PAYLOAD_MAX_BYTES))
+    try:
+        return int(value)
+    except (TypeError, ValueError):
+        return DEFAULT_INLINE_PAYLOAD_MAX_BYTES
+
+
+def _detect_lan_ip() -> str:
+    probe = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    try:
+        probe.connect(("8.8.8.8", 80))
+        return probe.getsockname()[0]
+    except OSError:
+        return "127.0.0.1"
+    finally:
+        probe.close()