cyclo-manager 1.0.0.dev10__tar.gz → 1.1.0.dev1__tar.gz

{cyclo_manager-1.0.0.dev10 → cyclo_manager-1.1.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cyclo-manager
-Version: 1.0.0.dev10
+Version: 1.1.0.dev1
 Summary: cyclo_manager CLI: pip-installable launcher for cyclo_manager server and UI containers. Run 'cyclo_manager up' to start Docker stack.
 License-Expression: Apache-2.0
 Requires-Python: >=3.10
@@ -18,7 +18,7 @@ Requires-Dist: ruff; extra == "dev"
 **Console commands:** `cyclo_manager` (underscore), `cyclo-manager` (hyphen)  
 **Host agent:** `cyclo_host_agent` (installed by the package, run via systemd)
 
-This package is the **pip-installable launcher** for the cyclo_manager stack on a robot host. It:
+This package is the **pip-installable launcher** for the cyclo_manager stack on a robot host. It is intended for production robots that run the pre-built Docker images. It:
 
 1. Runs **`docker compose`** against a **bundled** [`cyclo_manager_cli/docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml) to start the **API** and **web UI** containers.
 2. Installs and maintains **`cyclo_host_agent`** as a **systemd** service for host-level operations (git repo updates, `cyclo_manager` package update from the UI).
@@ -50,11 +50,12 @@ For the full monorepo (API source, UI source, dev compose), see the [repository
 
 ## Prerequisites
 
-- **Docker** with **Compose v2** (`docker compose` — the legacy `docker-compose` binary alone is not enough)
+- **Docker** with **Compose v2** (`docker compose`; the legacy `docker-compose` binary alone is not enough)
 - **Python 3.10+**
+- **systemd**: required for the managed `cyclo_host_agent.service`
 - **`sudo`** — required on normal-user hosts to install the host agent systemd unit, socket directory permissions, and sudoers rules
 - For **`cyclo_manager update`:** **`pip`** or **`pip3`** on `PATH`
-- **Root shell handling** — root is rejected when a normal login user exists. On root-only devices, the host agent is installed as root.
+- **Root shell handling** — `cyclo_manager up` rejects direct root execution when a normal login user exists. On root-only devices, the host agent is installed as root.
 - **Agent sockets** on the host under `/var/run/robotis/agent_sockets/` (robot containers and host agent). The bundled Compose file bind-mounts this tree into the API container as `/agents/`.
 
 ---
@@ -94,6 +95,8 @@ python3 -m cyclo_manager_cli.cli up
 | `cyclo_manager update --no-pull` | Same as `update`, but skip image pull (use locally cached images). |
 | `cyclo_manager --help` | Subcommand overview |
 
+The CLI also has an internal `refresh-host-agent` subcommand. It is used by the sudoers rule and should normally not be invoked by users directly.
+
 **`down` vs `update`:** `down` removes the host agent entirely. `update` only stops Docker containers, upgrades the pip package, restarts the stack, and refreshes the host agent — it does **not** call `cyclo_manager down`.
 
 ---
@@ -120,18 +123,21 @@ The pip package installs a small **FastAPI** server that listens on a **Unix dom
 |------|------|
 | Socket | `/var/run/robotis/agent_sockets/host/host_agent.sock` |
 | systemd unit | `cyclo_host_agent.service` |
-| sudoers | `/etc/sudoers.d/cyclo_manager` (`cp`, `udevadm` for container setup scripts; `refresh-host-agent` CLI subcommand for UI updates; skipped on root-only devices) |
+| sudoers | `/etc/sudoers.d/cyclo_manager` (`cp`, `udevadm` for container setup scripts; `refresh-host-agent` CLI subcommand for package-update refresh; skipped on root-only devices) |
 
 The API container reaches it at `/agents/host/host_agent.sock` (see bundled `config.yml`).
 
 **Responsibilities:**
 
-- List and update **`~/ROBOTIS-GIT/*`** git repositories (Version Management in the UI)
-- Run Cyclo Manager package updates from the UI by delegating to `cyclo_manager update`
+- List managed **ROBOTIS-GIT** git repositories in the configured workspace.
+- Check update availability from remote tags and local `package.xml` versions.
+- Update repos on allowed branches (`main`, `jazzy`) using stash or reset workflows.
+- Stop/start a repo's `docker/container.sh` helper during an update when requested by the UI.
+- Run Cyclo Manager package updates from the UI by delegating to `cyclo_manager update`.
 
 `cyclo_manager up` installs the `refresh-host-agent` CLI subcommand into sudoers. It is registered as `sys.executable -m cyclo_manager_cli.cli refresh-host-agent` with `SETENV`, so UI-triggered updates can pass the current `PYTHONPATH` to sudo and do not depend on `PATH`. The command is idempotent and refreshes the socket directory, sudoers file, systemd unit, and service state after package upgrades.
 
-Repository scanning uses `CYCLO_HOST_AGENT_WORKSPACE` when set. Otherwise it uses the service user's home directory, except root-only devices with `/data/docker`, where `/data/docker` is used automatically.
+Repository scanning uses `CYCLO_HOST_AGENT_WORKSPACE` when set. Otherwise it uses the service user's home directory, except root-only devices with `/data/docker`, where `/data/docker` is used automatically. Only repositories whose `origin` remote belongs to `ROBOTIS-GIT` are returned by the repo list/update endpoints.
 
 ---
 
@@ -211,6 +217,8 @@ So `/agents/ai_worker/s6_agent.sock` in config corresponds to the host path abov
 | Variable | Set by | Purpose |
 |----------|--------|---------|
 | **`CYCLO_MANAGER_CONFIG_FILE`** | CLI (`up`, `down`, `update`) | Absolute path to bundled `config.yml` on the host; mounted into the API container |
+| **`CYCLO_HOST_AGENT_WORKSPACE`** | User or CLI-generated systemd unit | Workspace scanned by `cyclo_host_agent` for managed git repositories |
+| **`CYCLO_HOST_AGENT_FILE_ROOT`** | User (optional) | Root directory for the Files UI/API. Defaults to the host agent service user's home (`$HOME`, e.g. `/root` when running as root) |
 | **`HOSTNAME`** | CLI (default: machine hostname) | Passed to API as `HOST_HOSTNAME` |
 | **`CONFIG_FILE`** | Compose (`/app/config.yml`) | Path inside the API container |
 | **`ROS_DOMAIN_ID`** | **Not** set by CLI | Set inside robot containers (e.g. `~/.bashrc`) so DDS matches your fleet |
@@ -252,7 +260,7 @@ Python dependencies declared in [`pyproject.toml`](pyproject.toml):
 |---------|---------|
 | **fastapi** | `cyclo_host_agent` HTTP API |
 | **uvicorn** | `cyclo_host_agent` server |
-| **psutil** | Host agent / system utilities |
+| **psutil** | Declared package dependency for host/system utility support |
 
 The **`cyclo_manager`** CLI itself uses only the Python standard library plus **`subprocess`** calls to **`docker compose`**, **`pip`**, **`systemctl`**, and **`sudo`**.
 

{cyclo_manager-1.0.0.dev10 → cyclo_manager-1.1.0.dev1}/README.md

@@ -4,7 +4,7 @@
 **Console commands:** `cyclo_manager` (underscore), `cyclo-manager` (hyphen)  
 **Host agent:** `cyclo_host_agent` (installed by the package, run via systemd)
 
-This package is the **pip-installable launcher** for the cyclo_manager stack on a robot host. It:
+This package is the **pip-installable launcher** for the cyclo_manager stack on a robot host. It is intended for production robots that run the pre-built Docker images. It:
 
 1. Runs **`docker compose`** against a **bundled** [`cyclo_manager_cli/docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml) to start the **API** and **web UI** containers.
 2. Installs and maintains **`cyclo_host_agent`** as a **systemd** service for host-level operations (git repo updates, `cyclo_manager` package update from the UI).
@@ -36,11 +36,12 @@ For the full monorepo (API source, UI source, dev compose), see the [repository
 
 ## Prerequisites
 
-- **Docker** with **Compose v2** (`docker compose` — the legacy `docker-compose` binary alone is not enough)
+- **Docker** with **Compose v2** (`docker compose`; the legacy `docker-compose` binary alone is not enough)
 - **Python 3.10+**
+- **systemd**: required for the managed `cyclo_host_agent.service`
 - **`sudo`** — required on normal-user hosts to install the host agent systemd unit, socket directory permissions, and sudoers rules
 - For **`cyclo_manager update`:** **`pip`** or **`pip3`** on `PATH`
-- **Root shell handling** — root is rejected when a normal login user exists. On root-only devices, the host agent is installed as root.
+- **Root shell handling** — `cyclo_manager up` rejects direct root execution when a normal login user exists. On root-only devices, the host agent is installed as root.
 - **Agent sockets** on the host under `/var/run/robotis/agent_sockets/` (robot containers and host agent). The bundled Compose file bind-mounts this tree into the API container as `/agents/`.
 
 ---
@@ -80,6 +81,8 @@ python3 -m cyclo_manager_cli.cli up
 | `cyclo_manager update --no-pull` | Same as `update`, but skip image pull (use locally cached images). |
 | `cyclo_manager --help` | Subcommand overview |
 
+The CLI also has an internal `refresh-host-agent` subcommand. It is used by the sudoers rule and should normally not be invoked by users directly.
+
 **`down` vs `update`:** `down` removes the host agent entirely. `update` only stops Docker containers, upgrades the pip package, restarts the stack, and refreshes the host agent — it does **not** call `cyclo_manager down`.
 
 ---
@@ -106,18 +109,21 @@ The pip package installs a small **FastAPI** server that listens on a **Unix dom
 |------|------|
 | Socket | `/var/run/robotis/agent_sockets/host/host_agent.sock` |
 | systemd unit | `cyclo_host_agent.service` |
-| sudoers | `/etc/sudoers.d/cyclo_manager` (`cp`, `udevadm` for container setup scripts; `refresh-host-agent` CLI subcommand for UI updates; skipped on root-only devices) |
+| sudoers | `/etc/sudoers.d/cyclo_manager` (`cp`, `udevadm` for container setup scripts; `refresh-host-agent` CLI subcommand for package-update refresh; skipped on root-only devices) |
 
 The API container reaches it at `/agents/host/host_agent.sock` (see bundled `config.yml`).
 
 **Responsibilities:**
 
-- List and update **`~/ROBOTIS-GIT/*`** git repositories (Version Management in the UI)
-- Run Cyclo Manager package updates from the UI by delegating to `cyclo_manager update`
+- List managed **ROBOTIS-GIT** git repositories in the configured workspace.
+- Check update availability from remote tags and local `package.xml` versions.
+- Update repos on allowed branches (`main`, `jazzy`) using stash or reset workflows.
+- Stop/start a repo's `docker/container.sh` helper during an update when requested by the UI.
+- Run Cyclo Manager package updates from the UI by delegating to `cyclo_manager update`.
 
 `cyclo_manager up` installs the `refresh-host-agent` CLI subcommand into sudoers. It is registered as `sys.executable -m cyclo_manager_cli.cli refresh-host-agent` with `SETENV`, so UI-triggered updates can pass the current `PYTHONPATH` to sudo and do not depend on `PATH`. The command is idempotent and refreshes the socket directory, sudoers file, systemd unit, and service state after package upgrades.
 
-Repository scanning uses `CYCLO_HOST_AGENT_WORKSPACE` when set. Otherwise it uses the service user's home directory, except root-only devices with `/data/docker`, where `/data/docker` is used automatically.
+Repository scanning uses `CYCLO_HOST_AGENT_WORKSPACE` when set. Otherwise it uses the service user's home directory, except root-only devices with `/data/docker`, where `/data/docker` is used automatically. Only repositories whose `origin` remote belongs to `ROBOTIS-GIT` are returned by the repo list/update endpoints.
 
 ---
 
@@ -197,6 +203,8 @@ So `/agents/ai_worker/s6_agent.sock` in config corresponds to the host path abov
 | Variable | Set by | Purpose |
 |----------|--------|---------|
 | **`CYCLO_MANAGER_CONFIG_FILE`** | CLI (`up`, `down`, `update`) | Absolute path to bundled `config.yml` on the host; mounted into the API container |
+| **`CYCLO_HOST_AGENT_WORKSPACE`** | User or CLI-generated systemd unit | Workspace scanned by `cyclo_host_agent` for managed git repositories |
+| **`CYCLO_HOST_AGENT_FILE_ROOT`** | User (optional) | Root directory for the Files UI/API. Defaults to the host agent service user's home (`$HOME`, e.g. `/root` when running as root) |
 | **`HOSTNAME`** | CLI (default: machine hostname) | Passed to API as `HOST_HOSTNAME` |
 | **`CONFIG_FILE`** | Compose (`/app/config.yml`) | Path inside the API container |
 | **`ROS_DOMAIN_ID`** | **Not** set by CLI | Set inside robot containers (e.g. `~/.bashrc`) so DDS matches your fleet |
@@ -238,7 +246,7 @@ Python dependencies declared in [`pyproject.toml`](pyproject.toml):
 |---------|---------|
 | **fastapi** | `cyclo_host_agent` HTTP API |
 | **uvicorn** | `cyclo_host_agent` server |
-| **psutil** | Host agent / system utilities |
+| **psutil** | Declared package dependency for host/system utility support |
 
 The **`cyclo_manager`** CLI itself uses only the Python standard library plus **`subprocess`** calls to **`docker compose`**, **`pip`**, **`systemctl`**, and **`sudo`**.
 

{cyclo_manager-1.0.0.dev10 → cyclo_manager-1.1.0.dev1}/cyclo_host_agent/main.py

@@ -21,7 +21,7 @@
 import logging
 from pathlib import Path
 
-from cyclo_host_agent.routers import repos, update
+from cyclo_host_agent.routers import files, repos, system_stats, update
 from cyclo_manager_cli import __version__
 from fastapi import FastAPI
 import uvicorn
@@ -41,6 +41,8 @@ app = FastAPI(
 )
 
 app.include_router(repos.router)
+app.include_router(files.router)
+app.include_router(system_stats.router)
 app.include_router(update.router)
 
 

{cyclo_manager-1.0.0.dev10 → cyclo_manager-1.1.0.dev1}/cyclo_host_agent/models.py

@@ -103,3 +103,109 @@ class ContainerScriptResponse(BaseModel):
     action: str
     success: bool
     output: str
+
+
+class ContainerStartStatusResponse(BaseModel):
+    """Current output/status for a container start operation."""
+
+    running: bool
+    output: str
+    success: bool | None = None
+    error: str = ''
+
+
+class HostSystemStatsResponse(BaseModel):
+    """Host CPU/memory/disk/uptime/temperature status."""
+
+    cpu_percent: float
+    memory_used_mb: int
+    memory_total_mb: int
+    disk_used_gb: float
+    disk_total_gb: float
+    ssd_used_gb: float | None = None
+    ssd_total_gb: float | None = None
+    ssd_mount_path: str | None = None
+    uptime_seconds: int
+    temperature_celsius: float | None = None
+
+
+class HostProcessInfo(BaseModel):
+    """Single host process CPU/memory usage sample."""
+
+    pid: int
+    user: str
+    cpu_percent: float
+    memory_percent: float
+    rss_kb: int | None = None
+    command: str
+
+
+class HostProcessesResponse(BaseModel):
+    """Host process list with aggregate resource summary."""
+
+    cpu_percent: float
+    memory_used_mb: int
+    memory_total_mb: int
+    processes: list[HostProcessInfo]
+
+
+class FileTreeEntry(BaseModel):
+    """Single file browser entry."""
+
+    name: str
+    path: str
+    type: str
+    size: int | None = None
+    modified: float | None = None
+    readonly: bool = False
+    hidden: bool = False
+    symlink: bool = False
+
+
+class FileTreeResponse(BaseModel):
+    """Response for GET /files/tree."""
+
+    root_path: str
+    path: str
+    entries: list[FileTreeEntry]
+
+
+class FileReadResponse(BaseModel):
+    """Response for GET /files/read."""
+
+    path: str
+    content: str
+    size: int
+    modified: float
+    readonly: bool = False
+
+
+class FileWriteRequest(BaseModel):
+    """Request body for POST /files/write."""
+
+    path: str
+    content: str
+    expected_modified: float | None = None
+
+
+class FileCreateRequest(BaseModel):
+    """Request body for POST /files/create."""
+
+    path: str
+    type: str
+    content: str = ''
+
+
+class FileRenameRequest(BaseModel):
+    """Request body for POST /files/rename."""
+
+    path: str
+    new_name: str
+
+
+class FileOperationResponse(BaseModel):
+    """Generic file operation response."""
+
+    path: str
+    success: bool
+    message: str

cyclo_manager-1.1.0.dev1/cyclo_host_agent/routers/files.py

@@ -0,0 +1,216 @@
+#!/usr/bin/env python3
+#
+# Copyright 2026 ROBOTIS CO., LTD.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Author: Hyungyu Kim
+
+"""Host file browser and editor endpoints."""
+
+import os
+import shutil
+from pathlib import Path
+
+from cyclo_host_agent.models import (
+    FileCreateRequest,
+    FileOperationResponse,
+    FileReadResponse,
+    FileRenameRequest,
+    FileTreeEntry,
+    FileTreeResponse,
+    FileWriteRequest,
+)
+from fastapi import APIRouter, HTTPException, Query, status
+
+router = APIRouter(prefix='/files', tags=['files'])
+
+MAX_READ_BYTES = 2 * 1024 * 1024
+MAX_WRITE_BYTES = 4 * 1024 * 1024
+
+
+def _resolve_file_root() -> Path:
+    configured_root = os.environ.get('CYCLO_HOST_AGENT_FILE_ROOT')
+    if configured_root:
+        return Path(configured_root).expanduser().resolve()
+    sudo_user = os.environ.get('SUDO_USER')
+    if sudo_user:
+        return Path(f'/home/{sudo_user}').resolve()
+    return Path.home().resolve()
+
+
+FILE_ROOT_PATH = _resolve_file_root()
+
+
+def _safe_path(relative_path: str = '') -> tuple[Path, str]:
+    target = (FILE_ROOT_PATH / relative_path).resolve()
+    if target != FILE_ROOT_PATH and FILE_ROOT_PATH not in target.parents:
+        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail='Path escapes file root')
+    rel = '' if target == FILE_ROOT_PATH else target.relative_to(FILE_ROOT_PATH).as_posix()
+    return target, rel
+
+
+def _is_binary(path: Path) -> bool:
+    try:
+        return b'\x00' in path.read_bytes()[:8192]
+    except OSError:
+        return True
+
+
+def _entry(path: Path) -> FileTreeEntry:
+    stat = path.lstat()
+    return FileTreeEntry(
+        name=path.name,
+        path='' if path == FILE_ROOT_PATH else path.relative_to(FILE_ROOT_PATH).as_posix(),
+        type='directory' if path.is_dir() else 'file',
+        size=None if path.is_dir() else stat.st_size,
+        modified=stat.st_mtime,
+        readonly=not os.access(path, os.W_OK),
+        hidden=path.name.startswith('.'),
+        symlink=path.is_symlink(),
+    )
+
+
+@router.get('/tree', response_model=FileTreeResponse)
+async def list_directory(
+    path: str = '',
+    show_hidden: bool = Query(False),
+) -> FileTreeResponse:
+    """Return one directory level under the configured file root."""
+    target, rel = _safe_path(path)
+    if not target.is_dir():
+        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail='Path is not a directory')
+
+    entries: list[FileTreeEntry] = []
+    for child in sorted(target.iterdir(), key=lambda item: (not item.is_dir(), item.name.lower())):
+        if not show_hidden and child.name.startswith('.'):
+            continue
+        try:
+            entries.append(_entry(child))
+        except OSError:
+            continue
+    return FileTreeResponse(root_path=str(FILE_ROOT_PATH), path=rel, entries=entries)
+
+
+@router.get('/read', response_model=FileReadResponse)
+async def read_file(
+    path: str,
+) -> FileReadResponse:
+    """Read a UTF-8 text file under the configured file root."""
+    target, rel = _safe_path(path)
+    if not target.is_file():
+        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail='Path is not a file')
+    stat = target.stat()
+    if stat.st_size > MAX_READ_BYTES:
+        raise HTTPException(status_code=status.HTTP_413_REQUEST_ENTITY_TOO_LARGE, detail='File is too large to edit')
+    if _is_binary(target):
+        raise HTTPException(status_code=status.HTTP_415_UNSUPPORTED_MEDIA_TYPE, detail='Binary files are not editable')
+    try:
+        content = target.read_text(encoding='utf-8', errors='replace')
+    except OSError as exc:
+        raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=str(exc))
+    return FileReadResponse(
+        path=rel,
+        content=content,
+        size=stat.st_size,
+        modified=stat.st_mtime,
+        readonly=not os.access(target, os.W_OK),
+    )
+
+
+@router.post('/write', response_model=FileOperationResponse)
+async def write_file(req: FileWriteRequest) -> FileOperationResponse:
+    """Write a UTF-8 text file under the configured file root."""
+    target, rel = _safe_path(req.path)
+    if target.exists() and not target.is_file():
+        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail='Path is not a file')
+    if len(req.content.encode('utf-8')) > MAX_WRITE_BYTES:
+        raise HTTPException(status_code=status.HTTP_413_REQUEST_ENTITY_TOO_LARGE, detail='Content is too large')
+    if req.expected_modified is not None and target.exists():
+        current_modified = target.stat().st_mtime
+        if abs(current_modified - req.expected_modified) > 0.001:
+            raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail='File changed on disk')
+    try:
+        target.parent.mkdir(parents=True, exist_ok=True)
+        target.write_text(req.content, encoding='utf-8')
+    except OSError as exc:
+        raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=str(exc))
+    return FileOperationResponse(path=rel, success=True, message='Saved')
+
+
+@router.post('/create', response_model=FileOperationResponse)
+async def create_path(req: FileCreateRequest) -> FileOperationResponse:
+    """Create a file or folder under the configured file root."""
+    target, rel = _safe_path(req.path)
+    if target.exists():
+        raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail='Path already exists')
+    try:
+        if req.type == 'directory':
+            target.mkdir(parents=True)
+            message = 'Folder created'
+        elif req.type == 'file':
+            if len(req.content.encode('utf-8')) > MAX_WRITE_BYTES:
+                raise HTTPException(status_code=status.HTTP_413_REQUEST_ENTITY_TOO_LARGE, detail='Content is too large')
+            target.parent.mkdir(parents=True, exist_ok=True)
+            target.write_text(req.content, encoding='utf-8')
+            message = 'File created'
+        else:
+            raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail='Type must be file or directory')
+    except OSError as exc:
+        raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=str(exc))
+    return FileOperationResponse(path=rel, success=True, message=message)
+
+
+@router.post('/rename', response_model=FileOperationResponse)
+async def rename_path(req: FileRenameRequest) -> FileOperationResponse:
+    """Rename a file or folder under the configured file root."""
+    target, _ = _safe_path(req.path)
+    if not target.exists():
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail='Path not found')
+    if '/' in req.new_name or '\\' in req.new_name or req.new_name in {'', '.', '..'}:
+        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail='Invalid name')
+    destination = (target.parent / req.new_name).resolve()
+    if destination != FILE_ROOT_PATH and FILE_ROOT_PATH not in destination.parents:
+        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail='Path escapes file root')
+    if destination.exists():
+        raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail='Destination already exists')
+    try:
+        target.rename(destination)
+    except OSError as exc:
+        raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=str(exc))
+    rel = '' if destination == FILE_ROOT_PATH else destination.relative_to(FILE_ROOT_PATH).as_posix()
+    return FileOperationResponse(path=rel, success=True, message='Renamed')
+
+
+@router.delete('', response_model=FileOperationResponse)
+async def delete_path(
+    path: str,
+    recursive: bool = Query(False),
+) -> FileOperationResponse:
+    """Delete a file or folder under the configured file root."""
+    target, rel = _safe_path(path)
+    if target == FILE_ROOT_PATH:
+        raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail='Cannot delete file root')
+    if not target.exists():
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail='Path not found')
+    try:
+        if target.is_dir():
+            if recursive:
+                shutil.rmtree(target)
+            else:
+                target.rmdir()
+        else:
+            target.unlink()
+    except OSError as exc:
+        raise HTTPException(status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, detail=str(exc))
+    return FileOperationResponse(path=rel, success=True, message='Deleted')

{cyclo_manager-1.0.0.dev10 → cyclo_manager-1.1.0.dev1}/cyclo_host_agent/routers/repos.py

@@ -22,9 +22,11 @@ import asyncio
 import os
 from pathlib import Path
 import re
+import time
 from typing import Optional
 
 from cyclo_host_agent.models import (
+    ContainerStartStatusResponse,
     ContainerScriptResponse,
     FileChange,
     RepoBranchCheckResponse,
@@ -42,6 +44,9 @@ router = APIRouter(prefix='/repos', tags=['repos'])
 
 GIT_TIMEOUT = 120.0
 GIT_REMOTE_TIMEOUT = 5.0
+CONTAINER_SCRIPT_TIMEOUT = 600.0
+CONTAINER_JOB_RETENTION_SECONDS = 3600.0
+CONTAINER_JOB_OUTPUT_LIMIT = 40000
 
 
 def _resolve_workspace() -> Path:
@@ -337,6 +342,88 @@ async def _update_reset(repo_path: Path, preserve_files: list[str]) -> UpdateRes
 
 # ── container helper ───────────────────────────────────────────────────────────
 
+_container_start_status_by_repo: dict[str, dict] = {}
+
+
+def _prune_container_start_jobs() -> None:
+    now = time.time()
+    stale = [
+        name
+        for name, status_entry in _container_start_status_by_repo.items()
+        if now - float(status_entry.get('updated_at') or 0) > CONTAINER_JOB_RETENTION_SECONDS
+    ]
+    for name in stale:
+        _container_start_status_by_repo.pop(name, None)
+
+
+def _new_container_start_status(name: str) -> dict:
+    _prune_container_start_jobs()
+    now = time.time()
+    status_entry = {
+        'name': name,
+        'running': True,
+        'output': '',
+        'success': None,
+        'error': '',
+        'started_at': now,
+        'updated_at': now,
+    }
+    _container_start_status_by_repo[name] = status_entry
+    return status_entry
+
+
+def _append_container_job_output(job: dict, line: str) -> None:
+    if not line:
+        return
+    output = f"{job.get('output') or ''}{line}\n"
+    if len(output) > CONTAINER_JOB_OUTPUT_LIMIT:
+        output = output[-CONTAINER_JOB_OUTPUT_LIMIT:]
+    job['output'] = output
+    job['updated_at'] = time.time()
+
+
+def _set_container_job_status(
+    job: dict,
+    *,
+    running: Optional[bool] = None,
+    success: Optional[bool] = None,
+    error: Optional[str] = None,
+) -> None:
+    if running is not None:
+        job['running'] = running
+    if success is not None:
+        job['success'] = success
+    if error is not None:
+        job['error'] = error
+    job['updated_at'] = time.time()
+
+
+def _update_container_job_from_line(job: dict, line: str) -> None:
+    line = line.strip()
+    if not line:
+        return
+    _append_container_job_output(job, line)
+
+
+def _build_container_start_status_response(job: dict) -> ContainerStartStatusResponse:
+    return ContainerStartStatusResponse(
+        running=bool(job.get('running')),
+        output=job.get('output') or '',
+        success=job.get('success'),
+        error=job.get('error') or '',
+    )
+
+
+async def _read_container_job_stream(stream: asyncio.StreamReader, job: dict) -> None:
+    while True:
+        raw = await stream.readline()
+        if not raw:
+            break
+        text = raw.decode(errors='replace').replace('\r', '\n')
+        for line in text.splitlines():
+            _update_container_job_from_line(job, line)
+
+
 async def _run_container_sh(repo_path: Path, action: str) -> tuple[bool, str]:
     script = repo_path / 'docker' / 'container.sh'
     if not script.exists():
@@ -357,6 +444,71 @@ async def _run_container_sh(repo_path: Path, action: str) -> tuple[bool, str]:
     return proc.returncode == 0, (stdout.decode() + stderr.decode()).strip()
 
 
+async def _run_container_start(repo_path: Path, name: str) -> None:
+    job = _container_start_status_by_repo.get(name)
+    if job is None:
+        return
+    script = repo_path / 'docker' / 'container.sh'
+    if not script.exists():
+        _set_container_job_status(
+            job,
+            running=False,
+            success=False,
+            error=f'container.sh not found at {script}',
+        )
+        return
+
+    env = os.environ.copy()
+    env['COMPOSE_PROGRESS'] = 'plain'
+    env['COMPOSE_ANSI'] = 'never'
+    proc = await asyncio.create_subprocess_exec(
+        'bash', str(script), 'start',
+        cwd=str(repo_path / 'docker'),
+        env=env,
+        stdin=asyncio.subprocess.PIPE,
+        stdout=asyncio.subprocess.PIPE,
+        stderr=asyncio.subprocess.PIPE,
+    )
+    if proc.stdin is not None:
+        proc.stdin.write(b'y\n')
+        await proc.stdin.drain()
+        proc.stdin.close()
+
+    readers = [
+        asyncio.create_task(_read_container_job_stream(proc.stdout, job)),
+        asyncio.create_task(_read_container_job_stream(proc.stderr, job)),
+    ]
+    try:
+        await asyncio.wait_for(proc.wait(), timeout=CONTAINER_SCRIPT_TIMEOUT)
+        await asyncio.gather(*readers)
+    except asyncio.TimeoutError:
+        proc.kill()
+        await proc.wait()
+        await asyncio.gather(*readers, return_exceptions=True)
+        _append_container_job_output(job, 'Timeout waiting for container.sh')
+        _set_container_job_status(
+            job,
+            running=False,
+            success=False,
+            error='Timeout waiting for container.sh',
+        )
+        return
+
+    if proc.returncode == 0:
+        _set_container_job_status(
+            job,
+            running=False,
+            success=True,
+        )
+    else:
+        _set_container_job_status(
+            job,
+            running=False,
+            success=False,
+            error=f'container.sh exited with code {proc.returncode}',
+        )
+
+
 # ── endpoints ──────────────────────────────────────────────────────────────────
 
 @router.get('/updates', response_model=RepoUpdatesResponse)
@@ -409,11 +561,33 @@ async def stop_repo_container(name: str) -> ContainerScriptResponse:
     return ContainerScriptResponse(name=name, action='stop', success=success, output=output)
 
 
-@router.post('/{name}/container/start', response_model=ContainerScriptResponse)
-async def start_repo_container(name: str) -> ContainerScriptResponse:
+@router.post('/{name}/container/start', response_model=ContainerStartStatusResponse)
+async def start_repo_container(name: str) -> ContainerStartStatusResponse:
     repo_path = _get_repo(name)
-    success, output = await _run_container_sh(repo_path, 'start')
-    return ContainerScriptResponse(name=name, action='start', success=success, output=output)
+    existing = _container_start_status_by_repo.get(name)
+    if existing and existing.get('running'):
+        return _build_container_start_status_response(existing)
+
+    job = _new_container_start_status(name)
+    asyncio.create_task(_run_container_start(repo_path, name))
+    return _build_container_start_status_response(job)
+
+
+@router.get(
+    '/{name}/container/start/status',
+    response_model=ContainerStartStatusResponse,
+)
+async def get_start_repo_container_status(
+    name: str,
+) -> ContainerStartStatusResponse:
+    _get_repo(name)
+    job = _container_start_status_by_repo.get(name)
+    if job is None:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Container start status for '{name}' not found",
+        )
+    return _build_container_start_status_response(job)
 
 
 @router.post('/{name}/update', response_model=UpdateResponse)

cyclo_manager-1.1.0.dev1/cyclo_host_agent/routers/system_stats.py

@@ -0,0 +1,156 @@
+#!/usr/bin/env python3
+#
+# Copyright 2026 ROBOTIS CO., LTD.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Author: Hyungyu Kim
+
+"""Host system status and process endpoints."""
+
+import time
+from pathlib import Path
+
+from cyclo_host_agent.models import (
+    HostProcessesResponse,
+    HostProcessInfo,
+    HostSystemStatsResponse,
+)
+from fastapi import APIRouter, Query
+import psutil
+
+router = APIRouter(prefix='/system', tags=['system'])
+
+PROCESS_SAMPLE_INTERVAL_SECONDS = 0.2
+PROCESS_DEFAULT_LIMIT = 80
+EXTRA_STORAGE_MOUNT_PATHS = ('/mnt/ssd', '/data')
+
+
+def _temperature() -> float | None:
+    try:
+        sensors = psutil.sensors_temperatures()
+        if not sensors:
+            return None
+        for readings in sensors.values():
+            if readings:
+                return round(float(readings[0].current), 1)
+    except (AttributeError, Exception):
+        pass
+    return None
+
+
+def _mounted_disk_usage(path: str):
+    path_obj = Path(path)
+    if not path_obj.is_mount():
+        return None
+    try:
+        return psutil.disk_usage(path)
+    except OSError:
+        return None
+
+
+def _extra_storage_disk_usage():
+    for mount_path in EXTRA_STORAGE_MOUNT_PATHS:
+        usage = _mounted_disk_usage(mount_path)
+        if usage:
+            return mount_path, usage
+    return None, None
+
+
+def _command_for_process(process: psutil.Process, info: dict) -> str:
+    cmdline = info.get('cmdline') or []
+    if cmdline:
+        return ' '.join(str(part) for part in cmdline)
+    return str(info.get('name') or process.pid)
+
+
+def _sample_processes(limit: int = PROCESS_DEFAULT_LIMIT) -> HostProcessesResponse:
+    tracked: list[psutil.Process] = []
+    cpu_count = psutil.cpu_count() or 1
+    for process in psutil.process_iter(['pid']):
+        try:
+            process.cpu_percent(None)
+            tracked.append(process)
+        except (psutil.NoSuchProcess, psutil.AccessDenied):
+            continue
+
+    overall_cpu_percent = psutil.cpu_percent(interval=PROCESS_SAMPLE_INTERVAL_SECONDS)
+    mem = psutil.virtual_memory()
+
+    processes: list[HostProcessInfo] = []
+    for process in tracked:
+        try:
+            info = process.as_dict(
+                attrs=['pid', 'username', 'cpu_percent', 'memory_percent', 'memory_info', 'cmdline', 'name']
+            )
+            memory_info = info.get('memory_info')
+            rss_kb = int(memory_info.rss // 1024) if memory_info else None
+            process_cpu_percent = float(info.get('cpu_percent') or 0.0) / cpu_count
+            processes.append(
+                HostProcessInfo(
+                    pid=int(info['pid']),
+                    user=str(info.get('username') or ''),
+                    cpu_percent=round(process_cpu_percent, 1),
+                    memory_percent=round(float(info.get('memory_percent') or 0.0), 1),
+                    rss_kb=rss_kb,
+                    command=_command_for_process(process, info),
+                )
+            )
+        except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess):
+            continue
+
+    processes.sort(key=lambda item: item.cpu_percent, reverse=True)
+    return HostProcessesResponse(
+        cpu_percent=round(float(overall_cpu_percent), 1),
+        memory_used_mb=int(mem.used // (1024 * 1024)),
+        memory_total_mb=int(mem.total // (1024 * 1024)),
+        processes=processes[:max(1, min(limit, 500))],
+    )
+
+
+@router.get('/status', response_model=HostSystemStatsResponse)
+async def get_system_stats() -> HostSystemStatsResponse:
+    """Return host CPU, memory, disk, and uptime stats."""
+    cpu_percent = psutil.cpu_percent(interval=PROCESS_SAMPLE_INTERVAL_SECONDS)
+    mem = psutil.virtual_memory()
+    disk = psutil.disk_usage('/')
+    extra_storage_path, extra_storage_disk = _extra_storage_disk_usage()
+    uptime_seconds = int(time.time() - psutil.boot_time())
+    return HostSystemStatsResponse(
+        cpu_percent=round(float(cpu_percent), 1),
+        memory_used_mb=int(mem.used // (1024 * 1024)),
+        memory_total_mb=int(mem.total // (1024 * 1024)),
+        disk_used_gb=round(float(disk.used / (1024 ** 3)), 1),
+        disk_total_gb=round(float(disk.total / (1024 ** 3)), 1),
+        ssd_used_gb=(
+            round(float(extra_storage_disk.used / (1024 ** 3)), 1)
+            if extra_storage_disk
+            else None
+        ),
+        ssd_total_gb=(
+            round(float(extra_storage_disk.total / (1024 ** 3)), 1)
+            if extra_storage_disk
+            else None
+        ),
+        ssd_mount_path=extra_storage_path,
+        uptime_seconds=uptime_seconds,
+        temperature_celsius=_temperature(),
+    )
+
+
+@router.get('/processes', response_model=HostProcessesResponse)
+async def get_system_processes(
+    limit: int = Query(PROCESS_DEFAULT_LIMIT, ge=1, le=500),
+) -> HostProcessesResponse:
+    """Return host process CPU/memory usage sorted by CPU usage."""
+    return _sample_processes(limit)

{cyclo_manager-1.0.0.dev10 → cyclo_manager-1.1.0.dev1}/cyclo_manager.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cyclo-manager
-Version: 1.0.0.dev10
+Version: 1.1.0.dev1
 Summary: cyclo_manager CLI: pip-installable launcher for cyclo_manager server and UI containers. Run 'cyclo_manager up' to start Docker stack.
 License-Expression: Apache-2.0
 Requires-Python: >=3.10
@@ -18,7 +18,7 @@ Requires-Dist: ruff; extra == "dev"
 **Console commands:** `cyclo_manager` (underscore), `cyclo-manager` (hyphen)  
 **Host agent:** `cyclo_host_agent` (installed by the package, run via systemd)
 
-This package is the **pip-installable launcher** for the cyclo_manager stack on a robot host. It:
+This package is the **pip-installable launcher** for the cyclo_manager stack on a robot host. It is intended for production robots that run the pre-built Docker images. It:
 
 1. Runs **`docker compose`** against a **bundled** [`cyclo_manager_cli/docker/docker-compose.yml`](cyclo_manager_cli/docker/docker-compose.yml) to start the **API** and **web UI** containers.
 2. Installs and maintains **`cyclo_host_agent`** as a **systemd** service for host-level operations (git repo updates, `cyclo_manager` package update from the UI).
@@ -50,11 +50,12 @@ For the full monorepo (API source, UI source, dev compose), see the [repository
 
 ## Prerequisites
 
-- **Docker** with **Compose v2** (`docker compose` — the legacy `docker-compose` binary alone is not enough)
+- **Docker** with **Compose v2** (`docker compose`; the legacy `docker-compose` binary alone is not enough)
 - **Python 3.10+**
+- **systemd**: required for the managed `cyclo_host_agent.service`
 - **`sudo`** — required on normal-user hosts to install the host agent systemd unit, socket directory permissions, and sudoers rules
 - For **`cyclo_manager update`:** **`pip`** or **`pip3`** on `PATH`
-- **Root shell handling** — root is rejected when a normal login user exists. On root-only devices, the host agent is installed as root.
+- **Root shell handling** — `cyclo_manager up` rejects direct root execution when a normal login user exists. On root-only devices, the host agent is installed as root.
 - **Agent sockets** on the host under `/var/run/robotis/agent_sockets/` (robot containers and host agent). The bundled Compose file bind-mounts this tree into the API container as `/agents/`.
 
 ---
@@ -94,6 +95,8 @@ python3 -m cyclo_manager_cli.cli up
 | `cyclo_manager update --no-pull` | Same as `update`, but skip image pull (use locally cached images). |
 | `cyclo_manager --help` | Subcommand overview |
 
+The CLI also has an internal `refresh-host-agent` subcommand. It is used by the sudoers rule and should normally not be invoked by users directly.
+
 **`down` vs `update`:** `down` removes the host agent entirely. `update` only stops Docker containers, upgrades the pip package, restarts the stack, and refreshes the host agent — it does **not** call `cyclo_manager down`.
 
 ---
@@ -120,18 +123,21 @@ The pip package installs a small **FastAPI** server that listens on a **Unix dom
 |------|------|
 | Socket | `/var/run/robotis/agent_sockets/host/host_agent.sock` |
 | systemd unit | `cyclo_host_agent.service` |
-| sudoers | `/etc/sudoers.d/cyclo_manager` (`cp`, `udevadm` for container setup scripts; `refresh-host-agent` CLI subcommand for UI updates; skipped on root-only devices) |
+| sudoers | `/etc/sudoers.d/cyclo_manager` (`cp`, `udevadm` for container setup scripts; `refresh-host-agent` CLI subcommand for package-update refresh; skipped on root-only devices) |
 
 The API container reaches it at `/agents/host/host_agent.sock` (see bundled `config.yml`).
 
 **Responsibilities:**
 
-- List and update **`~/ROBOTIS-GIT/*`** git repositories (Version Management in the UI)
-- Run Cyclo Manager package updates from the UI by delegating to `cyclo_manager update`
+- List managed **ROBOTIS-GIT** git repositories in the configured workspace.
+- Check update availability from remote tags and local `package.xml` versions.
+- Update repos on allowed branches (`main`, `jazzy`) using stash or reset workflows.
+- Stop/start a repo's `docker/container.sh` helper during an update when requested by the UI.
+- Run Cyclo Manager package updates from the UI by delegating to `cyclo_manager update`.
 
 `cyclo_manager up` installs the `refresh-host-agent` CLI subcommand into sudoers. It is registered as `sys.executable -m cyclo_manager_cli.cli refresh-host-agent` with `SETENV`, so UI-triggered updates can pass the current `PYTHONPATH` to sudo and do not depend on `PATH`. The command is idempotent and refreshes the socket directory, sudoers file, systemd unit, and service state after package upgrades.
 
-Repository scanning uses `CYCLO_HOST_AGENT_WORKSPACE` when set. Otherwise it uses the service user's home directory, except root-only devices with `/data/docker`, where `/data/docker` is used automatically.
+Repository scanning uses `CYCLO_HOST_AGENT_WORKSPACE` when set. Otherwise it uses the service user's home directory, except root-only devices with `/data/docker`, where `/data/docker` is used automatically. Only repositories whose `origin` remote belongs to `ROBOTIS-GIT` are returned by the repo list/update endpoints.
 
 ---
 
@@ -211,6 +217,8 @@ So `/agents/ai_worker/s6_agent.sock` in config corresponds to the host path abov
 | Variable | Set by | Purpose |
 |----------|--------|---------|
 | **`CYCLO_MANAGER_CONFIG_FILE`** | CLI (`up`, `down`, `update`) | Absolute path to bundled `config.yml` on the host; mounted into the API container |
+| **`CYCLO_HOST_AGENT_WORKSPACE`** | User or CLI-generated systemd unit | Workspace scanned by `cyclo_host_agent` for managed git repositories |
+| **`CYCLO_HOST_AGENT_FILE_ROOT`** | User (optional) | Root directory for the Files UI/API. Defaults to the host agent service user's home (`$HOME`, e.g. `/root` when running as root) |
 | **`HOSTNAME`** | CLI (default: machine hostname) | Passed to API as `HOST_HOSTNAME` |
 | **`CONFIG_FILE`** | Compose (`/app/config.yml`) | Path inside the API container |
 | **`ROS_DOMAIN_ID`** | **Not** set by CLI | Set inside robot containers (e.g. `~/.bashrc`) so DDS matches your fleet |
@@ -252,7 +260,7 @@ Python dependencies declared in [`pyproject.toml`](pyproject.toml):
 |---------|---------|
 | **fastapi** | `cyclo_host_agent` HTTP API |
 | **uvicorn** | `cyclo_host_agent` server |
-| **psutil** | Host agent / system utilities |
+| **psutil** | Declared package dependency for host/system utility support |
 
 The **`cyclo_manager`** CLI itself uses only the Python standard library plus **`subprocess`** calls to **`docker compose`**, **`pip`**, **`systemctl`**, and **`sudo`**.
 

{cyclo_manager-1.0.0.dev10 → cyclo_manager-1.1.0.dev1}/cyclo_manager.egg-info/SOURCES.txt

@@ -5,7 +5,9 @@ cyclo_host_agent/__init__.py
 cyclo_host_agent/main.py
 cyclo_host_agent/models.py
 cyclo_host_agent/routers/__init__.py
+cyclo_host_agent/routers/files.py
 cyclo_host_agent/routers/repos.py
+cyclo_host_agent/routers/system_stats.py
 cyclo_host_agent/routers/update.py
 cyclo_manager.egg-info/PKG-INFO
 cyclo_manager.egg-info/SOURCES.txt

{cyclo_manager-1.0.0.dev10 → cyclo_manager-1.1.0.dev1}/cyclo_manager_cli/docker/docker-compose.yml

@@ -11,7 +11,7 @@ services:
 
   cyclo_manager:
     container_name: cyclo_manager
-    image: robotis/cyclo-manager:1.0.0
+    image: robotis/cyclo-manager:1.1.0
     restart: always
     network_mode: host
     volumes:
@@ -27,7 +27,7 @@ services:
 
   ui:
     container_name: cyclo_manager_ui
-    image: robotis/cyclo-manager-ui:1.0.0
+    image: robotis/cyclo-manager-ui:1.1.0
     restart: always
     network_mode: host
     environment:

{cyclo_manager-1.0.0.dev10 → cyclo_manager-1.1.0.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cyclo-manager"
-version = "1.0.0.dev10"
+version = "1.1.0.dev1"
 description = "cyclo_manager CLI: pip-installable launcher for cyclo_manager server and UI containers. Run 'cyclo_manager up' to start Docker stack."
 readme = "README.md"
 license = "Apache-2.0"