standkit 0.5.1__tar.gz → 0.5.2__tar.gz

{standkit-0.5.1/standkit.egg-info → standkit-0.5.2}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: standkit
-Version: 0.5.1
+Version: 0.5.2
 Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
 Author: standkit contributors
-License: MIT
+License-Expression: MIT
 Project-URL: Homepage, https://github.com/thinkquattro/BPMkitStand
 Project-URL: Экосистема BPMkit, https://github.com/thinkquattro/BPMkit-dev
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Operating System :: OS Independent

{standkit-0.5.1 → standkit-0.5.2}/docs/HOSTING.md

@@ -113,12 +113,23 @@
 - **kestrel** — без изменений: `dotnet <stand_dll>` + pidfile
   (`standkit.lifecycle`/`standkit.platform`).
 - **iis** — через `appcmd.exe`
-  (`%windir%\system32\inetsrv\appcmd.exe`):
-  - старт: `start apppool /apppool.name:<pool>` и/или `start site /site.name:<site>`;
-  - стоп: `stop apppool` / `stop site`;
-  - рестарт: `recycle apppool /apppool.name:<pool>` (graceful) либо stop+start сайта;
-  - проверка «жив»: `list apppool <pool> /text:state` → `Started`; иначе по сайту;
-    фолбэк — открытый TCP-порт стенда.
+  (`%windir%\system32\inetsrv\appcmd.exe`). ⚠️ **Требует запуска диспетчера
+  «от имени администратора»** — см. раздел «Требования».
+  «Стенд в IIS» = его **Site**: диспетчер управляет сайтом и намеренно **не
+  трогает App Pool** (пул может быть общим с другими приложениями, его остановка
+  положила бы и их). App Pool задействуется только когда `iis_site` не задан
+  вовсе (единственный хэндл стенда).
+  - старт: `start apppool /apppool.name:<pool>` (если задан, чтобы сайт мог
+    обслуживаться) + `start site /site.name:<site>`;
+  - стоп: `stop site /site.name:<site>` (**только сайт**; при отсутствии
+    `iis_site` — `stop apppool`);
+  - рестарт: `stop site` + `start site` (**App Pool не рециклится**; recycle
+    пула — только когда сайт не задан);
+  - проверка «жив»: состояние **сайта** `list site <site> /text:state` →
+    `Started` (при отсутствии `iis_site` — состояние пула); фолбэк на открытый
+    TCP-порт — только если `appcmd` не дал определённого состояния (порт держит
+    http.sys даже у остановленного сайта, поэтому открытый порт сам по себе
+    «живым» не считается).
 - **docker** — через CLI `docker` / `docker compose`:
   - одиночный контейнер: `docker start|stop|restart <container>`,
     `docker inspect -f "{{.State.Running}}" <container>`,
@@ -144,10 +155,17 @@ Health-проба «процесс» (`standkit.health.check_stand`) для `iis
 
 ## Требования
 
-- **IIS**: платформа — только Windows; агент/служба standkit должна иметь
-  права на управление IIS (обычно — членство в группе `IIS_IUSRS` недостаточно,
-  нужны права на `appcmd.exe`/WAS, см. документацию IIS по правам на удалённое
-  администрирование). Живая приёмка — на стенде с реальным IIS.
+- **IIS**: платформа — только Windows. ⚠️ **Диспетчер (`standkit-hub`) должен
+  быть запущен «от имени администратора» (elevated).** `appcmd.exe` управляет
+  конфигурацией IIS и читает `%windir%\system32\inetsrv\config\redirection.config`,
+  что требует прав администратора; без elevation любая IIS-операция падает с
+  ошибкой прав (например, `код 1168` / «не удалось открыть файл конфигурации
+  из-за отсутствия необходимых разрешений»). Членства в группе `IIS_IUSRS`
+  **недостаточно**. Как запускать elevated: ярлык/консоль → правый клик →
+  «Запуск от имени администратора», либо из уже поднятой административной
+  консоли `standkit-hub`. Диспетчер в такой ситуации отдаёт понятную подсказку
+  «запустите от имени администратора» в тексте ошибки. Живая приёмка — на
+  стенде с реальным IIS.
 - **Docker**: установленный Docker Engine (`docker` в PATH процесса
   standkit); для compose-режима — плагин `docker compose` (Compose V2).
 - **Kubernetes**: установленный `kubectl` в PATH процесса standkit и

{standkit-0.5.1 → standkit-0.5.2}/pyproject.toml

@@ -1,17 +1,17 @@
 [build-system]
-requires = ["setuptools>=68", "wheel"]
+requires = ["setuptools>=77"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "standkit"
-version = "0.5.1"
+version = "0.5.2"
 description = "Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit."
 readme = "README.md"
-license = { text = "MIT" }
+license = "MIT"
+license-files = ["LICENSE"]
 authors = [{ name = "standkit contributors" }]
 requires-python = ">=3.10"
 classifiers = [
-    "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.10",
     "Operating System :: OS Independent",

{standkit-0.5.1 → standkit-0.5.2}/standkit/__init__.py

@@ -6,6 +6,6 @@ standkit — свободное (MIT) ядро управления жизнен
 и docs/ARCHITECTURE.md в корне репозитория.
 """
 
-__version__ = "0.5.1"
+__version__ = "0.5.2"
 
 __all__ = ["__version__"]

{standkit-0.5.1 → standkit-0.5.2}/standkit/hosting.py

@@ -83,19 +83,66 @@ def get_backend(stand: Stand) -> HostingBackend:
     raise HostingError(f"host_kind={stand.host_kind.value!r} не поддерживается ядром standkit")
 
 
+def _oem_encoding() -> str:
+    """Кодировка вывода консольных утилит Windows (appcmd и т.п. пишут в OEM,
+    не в UTF-8/ANSI). Вне Windows — utf-8."""
+    if sys.platform == "win32":
+        try:
+            import ctypes
+
+            return f"cp{ctypes.windll.kernel32.GetOEMCP()}"  # обычно cp866 (RU)
+        except Exception:
+            return "cp866"
+    return "utf-8"
+
+
+def _decode_console(data) -> str:
+    """Декодирует вывод внешней команды. Принимает bytes (реальный запуск) или
+    str (замоканный в тестах — отдаётся как есть). Для bytes перебирает
+    utf-8 → OEM (cp866) → cp1251, чтобы не превращать кириллицу appcmd в
+    кракозябры (баг «остановка IIS: непонятный текст ошибки»)."""
+    if data is None:
+        return ""
+    if isinstance(data, str):
+        return data
+    for enc in ("utf-8", _oem_encoding(), "cp1251"):
+        try:
+            return data.decode(enc)
+        except (UnicodeDecodeError, LookupError):
+            continue
+    return data.decode("utf-8", errors="replace")
+
+
 def _run(cmd: list[str], *, timeout: float = _DEFAULT_TIMEOUT) -> subprocess.CompletedProcess:
-    """Выполняет внешнюю команду, оборачивая ошибки спавна/таймаута в ``HostingError``."""
+    """Выполняет внешнюю команду, оборачивая ошибки спавна/таймаута в ``HostingError``.
+    Захватывает вывод БАЙТАМИ и декодирует (см. ``_decode_console``) — надёжнее,
+    чем ``text=True, encoding='utf-8'``, для консольных утилит в OEM-кодировке."""
     try:
-        return subprocess.run(
-            cmd,
-            capture_output=True,
-            text=True,
-            encoding="utf-8",
-            errors="replace",
-            timeout=timeout,
-        )
+        proc = subprocess.run(cmd, capture_output=True, timeout=timeout)
     except (OSError, subprocess.SubprocessError) as exc:
         raise HostingError(f"Не удалось выполнить команду {cmd!r}: {exc}") from exc
+    return subprocess.CompletedProcess(
+        cmd, proc.returncode, _decode_console(proc.stdout), _decode_console(proc.stderr)
+    )
+
+
+# Признаки того, что внешняя команда упала из-за НЕХВАТКИ ПРАВ (нужен запуск
+# «от имени администратора»). Для appcmd это типично: чтение config/
+# redirection.config в %windir%\system32\inetsrv требует elevation.
+_ELEVATION_MARKERS = (
+    "redirection.config",
+    "access is denied",
+    "отказано в доступе",
+    "разрешени",       # «…необходимых разрешений»
+    "0x80070005",
+    "(код 1168)",
+    "error ( message:",  # общий appcmd-ERROR при неудачном открытии config
+)
+
+
+def _looks_like_elevation_error(text: str) -> bool:
+    low = text.lower()
+    return any(m in low for m in _ELEVATION_MARKERS)
 
 
 def _run_checked(cmd: list[str], *, timeout: float = _DEFAULT_TIMEOUT) -> subprocess.CompletedProcess:
@@ -107,6 +154,22 @@ def _run_checked(cmd: list[str], *, timeout: float = _DEFAULT_TIMEOUT) -> subpro
     return result
 
 
+def _appcmd_checked(cmd: list[str], *, timeout: float = _DEFAULT_TIMEOUT) -> subprocess.CompletedProcess:
+    """``_run_checked`` для appcmd: при ошибке нехватки прав добавляет к тексту
+    понятную IIS-подсказку «запустите от имени администратора»."""
+    try:
+        return _run_checked(cmd, timeout=timeout)
+    except HostingError as exc:
+        if _looks_like_elevation_error(str(exc)):
+            raise HostingError(
+                str(exc)
+                + "\n\nПохоже, не хватает прав администратора: управление IIS через appcmd.exe "
+                "требует запуска диспетчера «от имени администратора» (elevated). Запустите "
+                "standkit-hub с правами администратора и повторите операцию."
+            ) from exc
+        raise
+
+
 def _tcp_fallback(stand: Stand) -> bool:
     """Фолбэк-проба «жив ли стенд» по открытому TCP-порту (см. ADR-0001)."""
     from standkit import health as _health  # локальный импорт — избегаем цикла
@@ -209,9 +272,9 @@ class IisBackend:
                 f"стенд '{stand.name}': host_kind=iis требует iis_site и/или iis_app_pool"
             )
         if stand.iis_app_pool:
-            _run_checked([appcmd, "start", "apppool", f"/apppool.name:{stand.iis_app_pool}"])
+            _appcmd_checked([appcmd, "start", "apppool", f"/apppool.name:{stand.iis_app_pool}"])
         if stand.iis_site:
-            _run_checked([appcmd, "start", "site", f"/site.name:{stand.iis_site}"])
+            _appcmd_checked([appcmd, "start", "site", f"/site.name:{stand.iis_site}"])
         return None
 
     def stop(self, stand: Stand, *, run_dir: Optional[Path] = None) -> bool:
@@ -225,9 +288,9 @@ class IisBackend:
         # положила бы и их (решение Владимира — гасить только стенд). App Pool
         # гасим лишь как единственный хэндл, когда сайт вообще не задан.
         if stand.iis_site:
-            _run_checked([appcmd, "stop", "site", f"/site.name:{stand.iis_site}"])
+            _appcmd_checked([appcmd, "stop", "site", f"/site.name:{stand.iis_site}"])
             return True
-        _run_checked([appcmd, "stop", "apppool", f"/apppool.name:{stand.iis_app_pool}"])
+        _appcmd_checked([appcmd, "stop", "apppool", f"/apppool.name:{stand.iis_app_pool}"])
         return True
 
     def restart(
@@ -238,10 +301,10 @@ class IisBackend:
         # трогаем/не рециклим — он может быть общим (см. stop). Recycle пула —
         # только когда сайт не задан (пул — единственный хэндл стенда).
         if stand.iis_site:
-            _run_checked([appcmd, "stop", "site", f"/site.name:{stand.iis_site}"])
-            _run_checked([appcmd, "start", "site", f"/site.name:{stand.iis_site}"])
+            _appcmd_checked([appcmd, "stop", "site", f"/site.name:{stand.iis_site}"])
+            _appcmd_checked([appcmd, "start", "site", f"/site.name:{stand.iis_site}"])
         elif stand.iis_app_pool:
-            _run_checked([appcmd, "recycle", "apppool", f"/apppool.name:{stand.iis_app_pool}"])
+            _appcmd_checked([appcmd, "recycle", "apppool", f"/apppool.name:{stand.iis_app_pool}"])
         else:
             raise HostingError(
                 f"стенд '{stand.name}': host_kind=iis требует iis_site и/или iis_app_pool"

{standkit-0.5.1 → standkit-0.5.2}/standkit/logs.py

@@ -109,7 +109,7 @@ def _decode_bytes(data: bytes) -> str:
         return data.decode("utf-8", errors="replace")
 
 
-def tail(log_path: Path, n: int = 100) -> list[str]:
+def tail(log_path: Path, n: int = 100, *, max_bytes: Optional[int] = None) -> list[str]:
     """
     Возвращает последние ``n`` строк файла лога (без завершающих переводов строк).
 
@@ -117,14 +117,29 @@ def tail(log_path: Path, n: int = 100) -> list[str]:
     а не бросает исключение: отсутствие лога — обычное состояние свежей записи
     реестра.
 
-    Реализация читает файл целиком (байтами, с "умным" декодом — см.
-    ``_decode_bytes``) — для типичных per-stand логов (десятки МБ) этого
-    достаточно; постраничное чтение с конца файла для очень больших логов
-    (сотни МБ+) — бэклог, см. docs/ARCHITECTURE.md.
+    ``max_bytes`` (опц.) — для ОЧЕНЬ больших логов (IIS/.NET-хосты могут писать
+    сотни МБ в день) читать не весь файл, а только последние ``max_bytes`` байт
+    (с конца, через seek). Первая строка такого хвоста почти наверняка обрезана
+    посередине — она отбрасывается. Без ``max_bytes`` — прежнее поведение (файл
+    целиком).
     """
     p = Path(log_path)
     if not p.exists():
         return []
+    if max_bytes is not None and max_bytes > 0:
+        try:
+            size = p.stat().st_size
+        except OSError:
+            size = 0
+        if size > max_bytes:
+            with p.open("rb") as f:
+                f.seek(size - max_bytes)
+                data = f.read()
+            text = _decode_bytes(data)
+            lines = text.splitlines()
+            if lines:
+                lines = lines[1:]  # обрезанная «половинка» первой строки
+            return lines[-n:] if n > 0 else lines
     data = p.read_bytes()
     text = _decode_bytes(data)
     lines = text.splitlines()

{standkit-0.5.1 → standkit-0.5.2/standkit.egg-info}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: standkit
-Version: 0.5.1
+Version: 0.5.2
 Summary: Свободное ядро (MIT) для управления жизненным циклом локальных и удалённых стендов BPMSoft: headless start/stop/restart, health-пробы, логи, реестр стендов. Часть экосистемы BPMkit.
 Author: standkit contributors
-License: MIT
+License-Expression: MIT
 Project-URL: Homepage, https://github.com/thinkquattro/BPMkitStand
 Project-URL: Экосистема BPMkit, https://github.com/thinkquattro/BPMkit-dev
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Operating System :: OS Independent

{standkit-0.5.1 → standkit-0.5.2}/standkit_hub/logs_browser.py

@@ -90,13 +90,26 @@ def resolve_logs_dir(stand: Stand, source: str = DEFAULT_LOG_SOURCE) -> Optional
     return p
 
 
-def list_log_files(logs_dir: Path) -> list[dict]:
+def start_of_today_ts() -> float:
+    """Unix-timestamp локальной полуночи сегодняшнего дня (для отсечения
+    старых логов «старше сегодня» — логи IIS/.NET по дням бывают очень тяжёлыми)."""
+    import datetime as _dt
+
+    now = _dt.datetime.now()
+    return now.replace(hour=0, minute=0, second=0, microsecond=0).timestamp()
+
+
+def list_log_files(logs_dir: Path, *, since_mtime: Optional[float] = None) -> list[dict]:
     """
     Список лог-файлов каталога, ВКЛЮЧАЯ вложенные подкаталоги: стенды BPMSoft
     (и .NET-хосты вообще) часто пишут логи не плоско, а в подпапки по датам,
     например ``logs/2026-07-24/*.log``. Без рекурсии верхний уровень содержал
     бы только папки, и хаб ошибочно сообщал «в каталоге нет файлов».
 
+    ``since_mtime`` (опц.) — не включать файлы, изменённые РАНЬШЕ этого unix-ts
+    (напр. ``start_of_today_ts()`` — «только за сегодня»): у IIS/.NET накапливаются
+    сотни тяжёлых дневных файлов, перечислять/читать всё — дорого.
+
     ``name`` — путь файла ОТНОСИТЕЛЬНО ``logs_dir`` в POSIX-форме (с прямыми
     слэшами, напр. ``2026-07-24/app.log``), совместимый с
     ``sanitize_log_filename`` на любой ОС. Размер в байтах, mtime (unix
@@ -110,15 +123,18 @@ def list_log_files(logs_dir: Path) -> list[dict]:
             st = child.stat()
         except OSError:
             continue
+        if since_mtime is not None and st.st_mtime < since_mtime:
+            continue
         rel = child.relative_to(logs_dir).as_posix()
         entries.append({"name": rel, "size": st.st_size, "mtime": st.st_mtime})
     entries.sort(key=lambda e: e["mtime"], reverse=True)
     return entries
 
 
-def pick_primary_log(logs_dir: Path) -> Optional[Path]:
-    """Выбирает "основной" лог каталога — самый свежий по mtime файл."""
-    files = list_log_files(logs_dir)
+def pick_primary_log(logs_dir: Path, *, since_mtime: Optional[float] = None) -> Optional[Path]:
+    """Выбирает "основной" лог каталога — самый свежий по mtime файл. С
+    ``since_mtime`` учитывает только файлы не старше указанного момента."""
+    files = list_log_files(logs_dir, since_mtime=since_mtime)
     if not files:
         return None
     return logs_dir / files[0]["name"]

{standkit-0.5.1 → standkit-0.5.2}/standkit_hub/server.py

@@ -511,7 +511,15 @@ def make_handler(
                     },
                 )
                 return
-            primary = logs_browser.pick_primary_log(logs_dir)
+            # «Отрезаем всё старше сегодня»: логи IIS/.NET по дням бывают очень
+            # тяжёлыми — сначала берём самый свежий файл ЗА СЕГОДНЯ. Если сегодня
+            # логов нет (стенд не писал сегодня) — фолбэк на самый свежий вообще,
+            # чтобы всегда показать последнюю сессию.
+            primary = logs_browser.pick_primary_log(
+                logs_dir, since_mtime=logs_browser.start_of_today_ts()
+            )
+            if primary is None:
+                primary = logs_browser.pick_primary_log(logs_dir)
             if primary is None:
                 self._send_json(
                     200,
@@ -528,7 +536,9 @@ def make_handler(
             # до конца файла), даже если она сама по себе длинная — затем
             # extract_current_session() отрезает всё, что относится к прошлым
             # запускам, и уже результат капается до разумного размера для UI.
-            raw_lines = _logs.tail(primary, 4000)
+            # Читаем только хвост файла (до 4 МБ) — даже дневной IIS-лог в сотни
+            # МБ не грузим целиком в память ради последних строк.
+            raw_lines = _logs.tail(primary, 4000, max_bytes=4_000_000)
             raw_text = "\n".join(raw_lines)
             session_text = _logs.extract_current_session(raw_text) if raw_text else ""
             if session_text:

{standkit-0.5.1 → standkit-0.5.2}/standkit_hub/web/app.js

@@ -553,6 +553,26 @@
     }
   }
 
+  // Ручное обновление по кнопке — с видимой обратной связью: кнопка
+  // блокируется и меняет подпись на «Обновление…», по завершении показывается
+  // подтверждение со временем (у автообновления по таймеру этого нет, чтобы не
+  // мигать постоянно).
+  async function refreshStandsWithFeedback() {
+    const btn = document.getElementById("refresh-stands-btn");
+    const orig = btn.textContent;
+    btn.disabled = true;
+    btn.textContent = "Обновление…";
+    try {
+      await refreshStands();
+      if (!document.getElementById("stands-error").textContent) {
+        showActionStatus(`Список обновлён • ${new Date().toLocaleTimeString()}`, false);
+      }
+    } finally {
+      btn.textContent = orig;
+      btn.disabled = false;
+    }
+  }
+
   function renderStands(stands) {
     const tbody = document.getElementById("stands-tbody");
     tbody.innerHTML = "";
@@ -952,7 +972,7 @@
     setupAgentTab();
     setupSettingsForm();
     setupStatePanel();
-    document.getElementById("refresh-stands-btn").addEventListener("click", refreshStands);
+    document.getElementById("refresh-stands-btn").addEventListener("click", refreshStandsWithFeedback);
 
     refreshStands();
     refreshAgentStatus();

{standkit-0.5.1 → standkit-0.5.2}/standkit_hub/web/style.css

@@ -421,6 +421,7 @@ body {
 .modal-footer {
   display: flex;
   justify-content: flex-end;
+  gap: 8px; /* кнопки не должны слипаться */
   padding: 12px 18px;
   border-top: 1px solid var(--bpmkit-border);
 }

{standkit-0.5.1 → standkit-0.5.2}/tests/test_hosting.py

@@ -40,6 +40,39 @@ def _completed(cmd, returncode=0, stdout="", stderr=""):
     return subprocess.CompletedProcess(args=cmd, returncode=returncode, stdout=stdout, stderr=stderr)
 
 
+# --------------------------------------------------------------------------
+# Декодирование вывода консольных утилит + подсказка о правах администратора
+# --------------------------------------------------------------------------
+
+
+def test_decode_console_handles_str_bytes_and_oem(monkeypatch):
+    # str (замоканный вывод в тестах) и None — как есть; bytes декодируются.
+    assert hosting._decode_console("Started") == "Started"
+    assert hosting._decode_console(None) == ""
+    assert hosting._decode_console("Привет".encode("utf-8")) == "Привет"
+    # OEM-байты (cp866 у appcmd на RU-Windows) не превращаются в кракозябры.
+    monkeypatch.setattr(hosting, "_oem_encoding", lambda: "cp866")
+    assert hosting._decode_console("Ошибка".encode("cp866")) == "Ошибка"
+
+
+def test_iis_stop_appcmd_permission_error_adds_admin_hint(monkeypatch, tmp_path):
+    # appcmd падает из-за нехватки прав (redirection.config) → к тексту ошибки
+    # добавляется понятная подсказка «запустите от имени администратора».
+    _prep_iis_windows(monkeypatch, tmp_path)
+
+    def _fake_run(cmd, **kw):
+        return _completed(
+            cmd,
+            returncode=1,
+            stderr="ERROR ( message: redirection.config ... необходимых разрешений )",
+        )
+
+    monkeypatch.setattr(subprocess, "run", _fake_run)
+    stand = _make_stand(host_kind=HostKind.IIS, iis_site="site1")
+    with pytest.raises(HostingError, match="администратор"):
+        IisBackend().stop(stand)
+
+
 # --------------------------------------------------------------------------
 # get_backend
 # --------------------------------------------------------------------------

{standkit-0.5.1 → standkit-0.5.2}/tests/test_hub_logs_browser.py

@@ -266,3 +266,36 @@ def test_open_folder_uses_os_startfile_on_windows(tmp_path, monkeypatch):
     result = open_folder(tmp_path)
     assert result.ok is True
     assert calls["path"] == str(tmp_path)
+
+
+def test_list_log_files_since_mtime_filters_older(tmp_path):
+    import os
+    import time
+
+    old = tmp_path / "old.log"
+    old.write_text("o", encoding="utf-8")
+    new = tmp_path / "new.log"
+    new.write_text("n", encoding="utf-8")
+    day_ago = time.time() - 86400
+    os.utime(old, (day_ago, day_ago))
+
+    cutoff = time.time() - 3600  # час назад
+    assert [f["name"] for f in list_log_files(tmp_path, since_mtime=cutoff)] == ["new.log"]
+    # без cutoff — оба
+    assert {f["name"] for f in list_log_files(tmp_path)} == {"old.log", "new.log"}
+
+
+def test_pick_primary_log_since_mtime_ignores_old(tmp_path):
+    import os
+    import time
+
+    day = tmp_path / "2026-01-01"
+    day.mkdir()
+    old = day / "a.log"
+    old.write_text("o", encoding="utf-8")
+    day_ago = time.time() - 86400
+    os.utime(old, (day_ago, day_ago))
+
+    # только старый файл: с cutoff «за сегодня» → None; без cutoff → он.
+    assert pick_primary_log(tmp_path, since_mtime=time.time() - 3600) is None
+    assert pick_primary_log(tmp_path) == old

{standkit-0.5.1 → standkit-0.5.2}/tests/test_logs.py

@@ -203,3 +203,18 @@ def test_extract_current_session_start_marker_wins_over_application_starting():
     result = extract_current_session(text)
     assert result.startswith("=== START pid=555")
     assert "старый запуск без маркера START" not in result
+
+
+def test_tail_max_bytes_reads_only_end_and_drops_partial_first_line(tmp_path):
+    # Огромный лог (IIS/.NET) не читаем целиком: с max_bytes берём только хвост,
+    # обрезанную «половинку» первой строки выбрасываем.
+    from standkit.logs import tail
+
+    p = tmp_path / "big.log"
+    lines = [f"line{i:03d}" for i in range(100)]
+    p.write_text("\n".join(lines) + "\n", encoding="utf-8")
+    size = p.stat().st_size
+
+    assert tail(p, n=5, max_bytes=size // 2) == lines[-5:]
+    assert tail(p, n=3) == lines[-3:]              # без max_bytes — как раньше
+    assert tail(p, n=2, max_bytes=size * 2) == lines[-2:]  # лимит больше файла