junkicide 0.1.0__tar.gz

junkicide-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        python: ["3.11", "3.14"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: ${{ matrix.python }}
+      - run: uv sync
+      - run: uv run ruff check src tests
+      - run: uv run pytest -q

junkicide-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+name: Publish to PyPI
+
+# Публикация по тегу вида v0.1.0. Без токенов: PyPI Trusted Publishing (OIDC).
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - name: Версия тега совпадает с версией пакета
+        run: |
+          v=$(uv run --no-project python -c "import tomllib;print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          test "v$v" = "${GITHUB_REF_NAME}" || { echo "тег ${GITHUB_REF_NAME} ≠ версия $v"; exit 1; }
+      - run: uv sync
+      - run: uv run pytest -q
+      - run: uv build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

junkicide-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+__pycache__/
+*.pyc
+dist/
+build/
+.pytest_cache/
+.ruff_cache/

junkicide-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 trapwalker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

junkicide-0.1.0/Makefile

@@ -0,0 +1,48 @@
+# junkicide — управление проектом
+.PHONY: help install run report report-quick test lint fmt build clean uvx journal config release
+
+help:            ## Показать команды
+	@grep -E '^[a-z-]+:.*##' $(MAKEFILE_LIST) | awk -F':.*## ' '{printf "  \033[36m%-14s\033[0m %s\n", $$1, $$2}'
+
+install:         ## Установить зависимости (uv sync)
+	uv sync
+
+run:             ## Запустить TUI из исходников
+	uv run junkicide
+
+report:          ## Текстовый отчёт без интерфейса (полный обход, до 2 минут)
+	uv run junkicide --report 120 -v
+
+report-quick:    ## Быстрый отчёт: процессы и известные места, без обхода диска
+	uv run junkicide --report 40 --no-walk
+
+test:            ## Тесты
+	uv run pytest -q
+
+lint:            ## Проверка стиля
+	uv run ruff check src tests
+
+fmt:             ## Автоисправление стиля
+	uv run ruff check --fix src tests
+
+build:           ## Собрать wheel/sdist в dist/
+	uv build
+
+uvx:             ## Запустить так, как это сделает пользователь (uvx из локальной папки)
+	uvx --from . junkicide
+
+journal:         ## Открыть журнал действий
+	open -R ~/Library/Logs/junkicide/journal.jsonl
+
+config:          ## Открыть файл настроек
+	@test -f ~/.config/junkicide/config.toml || uv run python -c "from junkicide.config import Config; Config.load().save()"
+	open ~/.config/junkicide/config.toml
+
+clean:           ## Удалить артефакты сборки и кэш прошлых сканирований
+	rm -rf dist build .pytest_cache .ruff_cache
+	rm -f ~/Library/Caches/junkicide/findings.json
+
+release:         ## Выпустить версию из pyproject.toml: тег vX.Y.Z → GitHub Actions публикует в PyPI
+	@v=$$(uv run python -c "import tomllib;print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])"); \
+	git diff --quiet && git diff --cached --quiet || { echo "есть незакоммиченные изменения"; exit 1; }; \
+	echo "Выпускаю v$$v"; git tag -a "v$$v" -m "v$$v" && git push origin main "v$$v"

junkicide-0.1.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.5
+Name: junkicide
+Version: 0.1.0
+Summary: TUI для macOS: найти и осознанно прибить забытые прожорливые процессы и ненужные гигабайты на диске
+Project-URL: Homepage, https://github.com/trapwalker/junkicide
+Project-URL: Issues, https://github.com/trapwalker/junkicide/issues
+Author: trapwalker
+License-Expression: MIT
+License-File: LICENSE
+Keywords: android-emulator,cleanup,disk-space,docker,macos,process-monitor,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Natural Language :: Russian
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: psutil>=6.0
+Requires-Dist: textual>=0.80
+Description-Content-Type: text/markdown
+
+# junkicide
+
+TUI для macOS: быстро найти и **осознанно** прибить то, что зря жрёт ресурсы, — забытые эмуляторы,
+Docker-контейнеры, dev-серверы, тяжёлые вкладки браузера — и то, что зря занимает диск: старые дистрибутивы,
+программы, которыми не пользуются, фильмы, записи видеорегистратора, кэши и артефакты сборки заброшенных
+проектов.
+
+```sh
+uv tool install --editable ~/projects/own/junkicide   # один раз; дальше просто:
+junkicide
+```
+
+Без установки: `uvx --from ~/projects/own/junkicide junkicide`; после публикации на PyPI — просто `uvx junkicide`.
+
+## Как работает
+
+1. **Сразу** — сводка (CPU, давление памяти, swap, свободное место, нагрев) и очевидные проблемы: процессы,
+   которые устойчиво грузят CPU или держат много памяти, известные «пожиратели» (эмулятор Android, Docker VM,
+   демоны Gradle, dev-серверы…), крупные файлы из индекса Spotlight.
+2. **Параллельно в фоне** — известные места на диске (кэши, Xcode, Android SDK/AVD, Homebrew, модели нейросетей…),
+   давно не используемые программы и полный обход домашней папки: артефакты сборки по проектам (с датой, когда
+   проект последний раз менялся), папки с видео (распознаются записи регистраторов), дубликаты, недокачанные
+   файлы, архивы, уже распакованные рядом.
+3. Для каждой находки — **что это, откуда взялось, чем грозит устранение**, факты (пути, даты, PID, порты,
+   рабочая папка, откуда скачан файл) и оценка, насколько вероятно это не нужно.
+4. Устранение — клавишей, с подтверждением. Файлы — **только в Корзину**; процессы — SIGTERM, SIGKILL по выбору;
+   для кэшей — штатные команды (`brew cleanup`, `docker builder prune`, `npm cache clean`…). Корзину можно
+   очистить отсюда же (`E`).
+
+Результаты сканирования диска кэшируются: при следующем запуске прошлая картина видна сразу (⏳), пока идёт
+перепроверка.
+
+## Клавиши
+
+`1`–`5` вкладки (Главное, CPU, Память, Диск, Журнал) · `Enter`/`a` действия · `k`/`K` завершить/убить ·
+`d` в Корзину · `пробел` отметить несколько · `o` Finder · `i` скрыть находку · `/` фильтр (`#dev`, `#cache`,
+`#забытое`…) · `s` сортировка по выгоде/размеру · `r` пересканировать · `E` очистить Корзину · `?` помощь
+
+## Без интерфейса
+
+```sh
+junkicide --report        # просканировать (до 2 мин) и вывести отчёт
+junkicide --report 40 --no-walk -v
+```
+
+## Файлы
+
+| | |
+|---|---|
+| `~/.config/junkicide/config.toml` | пороги и список скрытых находок (переносим между компьютерами) |
+| `~/Library/Logs/junkicide/journal.jsonl` | журнал: все действия и события сканирования |
+| `~/Library/Caches/junkicide/findings.json` | кэш прошлого сканирования диска (можно удалить) |
+
+Для полной картины (Корзина, Почта, данные некоторых программ) дайте терминалу
+«Полный доступ к диску»: Системные настройки → Конфиденциальность и безопасность.
+
+## Разработка
+
+`make help` — все команды: `make run`, `make test`, `make lint`, `make report`, `make uvx`.
+
+Устройство: `scanners/` — независимые сканеры в фоновых потоках, пишут находки в общее хранилище
+(`model.FindingStore`); `knowledge/` — база знаний (процессы, известные места, классификация файлов) с
+объяснениями; `actions.py` — исполнение действий с журналированием; `tui/` — интерфейс на Textual.

junkicide-0.1.0/README.md

@@ -0,0 +1,63 @@
+# junkicide
+
+TUI для macOS: быстро найти и **осознанно** прибить то, что зря жрёт ресурсы, — забытые эмуляторы,
+Docker-контейнеры, dev-серверы, тяжёлые вкладки браузера — и то, что зря занимает диск: старые дистрибутивы,
+программы, которыми не пользуются, фильмы, записи видеорегистратора, кэши и артефакты сборки заброшенных
+проектов.
+
+```sh
+uv tool install --editable ~/projects/own/junkicide   # один раз; дальше просто:
+junkicide
+```
+
+Без установки: `uvx --from ~/projects/own/junkicide junkicide`; после публикации на PyPI — просто `uvx junkicide`.
+
+## Как работает
+
+1. **Сразу** — сводка (CPU, давление памяти, swap, свободное место, нагрев) и очевидные проблемы: процессы,
+   которые устойчиво грузят CPU или держат много памяти, известные «пожиратели» (эмулятор Android, Docker VM,
+   демоны Gradle, dev-серверы…), крупные файлы из индекса Spotlight.
+2. **Параллельно в фоне** — известные места на диске (кэши, Xcode, Android SDK/AVD, Homebrew, модели нейросетей…),
+   давно не используемые программы и полный обход домашней папки: артефакты сборки по проектам (с датой, когда
+   проект последний раз менялся), папки с видео (распознаются записи регистраторов), дубликаты, недокачанные
+   файлы, архивы, уже распакованные рядом.
+3. Для каждой находки — **что это, откуда взялось, чем грозит устранение**, факты (пути, даты, PID, порты,
+   рабочая папка, откуда скачан файл) и оценка, насколько вероятно это не нужно.
+4. Устранение — клавишей, с подтверждением. Файлы — **только в Корзину**; процессы — SIGTERM, SIGKILL по выбору;
+   для кэшей — штатные команды (`brew cleanup`, `docker builder prune`, `npm cache clean`…). Корзину можно
+   очистить отсюда же (`E`).
+
+Результаты сканирования диска кэшируются: при следующем запуске прошлая картина видна сразу (⏳), пока идёт
+перепроверка.
+
+## Клавиши
+
+`1`–`5` вкладки (Главное, CPU, Память, Диск, Журнал) · `Enter`/`a` действия · `k`/`K` завершить/убить ·
+`d` в Корзину · `пробел` отметить несколько · `o` Finder · `i` скрыть находку · `/` фильтр (`#dev`, `#cache`,
+`#забытое`…) · `s` сортировка по выгоде/размеру · `r` пересканировать · `E` очистить Корзину · `?` помощь
+
+## Без интерфейса
+
+```sh
+junkicide --report        # просканировать (до 2 мин) и вывести отчёт
+junkicide --report 40 --no-walk -v
+```
+
+## Файлы
+
+| | |
+|---|---|
+| `~/.config/junkicide/config.toml` | пороги и список скрытых находок (переносим между компьютерами) |
+| `~/Library/Logs/junkicide/journal.jsonl` | журнал: все действия и события сканирования |
+| `~/Library/Caches/junkicide/findings.json` | кэш прошлого сканирования диска (можно удалить) |
+
+Для полной картины (Корзина, Почта, данные некоторых программ) дайте терминалу
+«Полный доступ к диску»: Системные настройки → Конфиденциальность и безопасность.
+
+## Разработка
+
+`make help` — все команды: `make run`, `make test`, `make lint`, `make report`, `make uvx`.
+
+Устройство: `scanners/` — независимые сканеры в фоновых потоках, пишут находки в общее хранилище
+(`model.FindingStore`); `knowledge/` — база знаний (процессы, известные места, классификация файлов) с
+объяснениями; `actions.py` — исполнение действий с журналированием; `tui/` — интерфейс на Textual.

junkicide-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "junkicide"
+version = "0.1.0"
+description = "TUI для macOS: найти и осознанно прибить забытые прожорливые процессы и ненужные гигабайты на диске"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "trapwalker" }]
+keywords = ["macos", "tui", "cleanup", "disk-space", "process-monitor", "docker", "android-emulator"]
+dependencies = [
+    "textual>=0.80",
+    "psutil>=6.0",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Natural Language :: Russian",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: System :: Monitoring",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/trapwalker/junkicide"
+Issues = "https://github.com/trapwalker/junkicide/issues"
+
+[project.scripts]
+junkicide = "junkicide.__main__:main"
+
+[build-system]
+requires = ["hatchling>=1.27"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/junkicide"]
+
+[dependency-groups]
+dev = ["pytest>=8", "pytest-asyncio>=0.23", "ruff>=0.5"]
+
+[tool.ruff]
+line-length = 110
+target-version = "py311"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP", "RUF100"]
+ignore = ["E731", "B023", "E501"]  # длину держим ~110, но эмодзи и русские тексты ruff считает неточно

junkicide-0.1.0/src/junkicide/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

junkicide-0.1.0/src/junkicide/__main__.py

@@ -0,0 +1,101 @@
+"""Точка входа: `junkicide` (TUI) или `junkicide --report` (текстовый отчёт для терминала/скриптов)."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+import time
+
+from . import __version__
+from .config import Config
+from .journal import Journal
+
+
+def make_scanners(args) -> list:
+    from .scanners.apps_unused import UnusedAppsScanner
+    from .scanners.disk_known import KnownPathsScanner
+    from .scanners.disk_walk import HomeWalkScanner, SpotlightBigFiles
+    from .scanners.docker import DockerScanner
+    from .scanners.processes import ProcessScanner
+    from .scanners.system import SystemScanner
+
+    scanners = [SystemScanner(), ProcessScanner(), DockerScanner()]
+    if not args.no_disk:
+        scanners += [SpotlightBigFiles(), KnownPathsScanner(), UnusedAppsScanner()]
+        if not args.no_walk:
+            scanners.append(HomeWalkScanner())
+    return scanners
+
+
+def report(args, config: Config, journal: Journal) -> int:
+    from .model import RISK_META, FindingStore, Resource
+    from .scanners.base import Runner, ScanContext
+    from .util import human_bytes
+
+    store = FindingStore()
+    store.set_ignored(set(config.ignore_ids))
+    ctx = ScanContext(store, journal, config)
+    runner = Runner(ctx, make_scanners(args))
+    runner.start()
+    deadline = time.time() + args.report
+    once = [n for n, st in ctx.status.items() if n not in ("system", "processes", "docker")]
+    while time.time() < deadline:
+        time.sleep(0.5)
+        if time.time() > deadline - args.report + 5 and all(ctx.status[n].runs > 0 for n in once):
+            break
+        if sys.stderr.isatty():
+            busy = [f"{st.title}: {st.message}" for st in ctx.status.values() if st.state == "идёт"]
+            print("\r\033[K⟳ " + "; ".join(busy)[:150], end="", file=sys.stderr, flush=True)
+    if sys.stderr.isatty():
+        print("\r\033[K", end="", file=sys.stderr)
+    runner.stop()
+    items = sorted(store.snapshot(), key=lambda f: -f.score)
+    sections = [
+        ("🔥 Нагрузка на CPU и 🧠 память", [f for f in items if f.resource in (Resource.CPU, Resource.MEMORY)]),
+        ("💾 Диск", [f for f in items if f.resource == Resource.DISK]),
+        ("ℹ️  Сведения", [f for f in items if f.resource == Resource.INFO]),
+    ]
+    for title, fs in sections:
+        print(f"\n{title}")
+        for f in fs[: args.top]:
+            cpu = f" CPU {f.cpu:.0f}%" if f.cpu >= 1 else ""
+            size = human_bytes(f.bytes) if f.bytes else ""
+            print(f"  {RISK_META[f.risk][0]} {size:>9}{cpu:>10}  {f.confidence * 100:3.0f}%  {f.title}")
+            if f.location and args.verbose:
+                print(f"{'':30}{f.location}")
+    print()
+    not_done = [st.title for st in ctx.status.values() if st.runs == 0]
+    if not_done:
+        print(f"(не успели за {args.report} с: {', '.join(not_done)} — увеличьте --report)")
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    p = argparse.ArgumentParser(
+        prog="junkicide",
+        description="Найти и осознанно прибить забытые прожорливые процессы и ненужные гигабайты на macOS.",
+    )
+    p.add_argument("--report", type=int, metavar="СЕК", nargs="?", const=120,
+                   help="не открывать интерфейс: просканировать (до СЕК секунд, по умолчанию 120) и вывести отчёт")
+    p.add_argument("--top", type=int, default=15, help="сколько строк в каждом разделе отчёта")
+    p.add_argument("-v", "--verbose", action="store_true", help="в отчёте показывать пути")
+    p.add_argument("--no-walk", action="store_true", help="не делать полный обход домашней папки (быстрее)")
+    p.add_argument("--no-disk", action="store_true", help="только процессы, без анализа диска")
+    p.add_argument("--version", action="version", version=f"junkicide {__version__}")
+    args = p.parse_args(argv)
+
+    if sys.platform != "darwin":
+        print("junkicide рассчитан на macOS.", file=sys.stderr)
+    config = Config.load()
+    journal = Journal()
+    if args.report is not None:
+        return report(args, config, journal)
+
+    from .tui.app import JunkicideApp
+
+    JunkicideApp(config, journal, make_scanners(args)).run()
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

junkicide-0.1.0/src/junkicide/actions.py

@@ -0,0 +1,183 @@
+"""Исполнение действий. Каждое действие журналируется; удаление — только в Корзину."""
+
+from __future__ import annotations
+
+import os
+import shutil
+import signal
+import time
+from dataclasses import dataclass
+
+import psutil
+
+from .journal import Journal
+from .model import Action, ActionKind, Finding
+from .util import du_bytes, human_bytes, run, short_path
+
+
+@dataclass
+class Result:
+    ok: bool
+    message: str
+    output: str = ""
+    freed: int = 0
+    resolved: bool = False  # находку можно считать устранённой
+
+
+def _same_process(pid: int, ctime: float) -> psutil.Process | None:
+    try:
+        p = psutil.Process(pid)
+        if ctime and abs(p.create_time() - ctime) > 1:
+            return None  # pid уже занят другим процессом
+        return p
+    except psutil.Error:
+        return None
+
+
+def kill(pids: list[tuple[int, float]], force: bool, wait: float = 5.0) -> Result:
+    procs = [p for pid, ct in pids if (p := _same_process(pid, ct))]
+    if not procs:
+        return Result(True, "Процесс уже завершён (если его PID занят новым процессом — тот не тронут)",
+                      resolved=True)
+    sig = signal.SIGKILL if force else signal.SIGTERM
+    errors = []
+    for p in procs:
+        try:
+            p.send_signal(sig)
+        except psutil.NoSuchProcess:
+            pass
+        except psutil.AccessDenied:
+            errors.append(f"{p.pid}: нет прав (процесс другого пользователя или системный)")
+    _, alive = psutil.wait_procs(procs, timeout=wait)
+    if errors:
+        return Result(False, "; ".join(errors))
+    if alive:
+        names = ", ".join(str(p.pid) for p in alive)
+        return Result(
+            False,
+            f"Ещё живы: {names}. Процесс не ответил на SIGTERM за {wait:.0f} с — "
+            "можно завершить принудительно (SIGKILL).",
+        )
+    return Result(True, f"Завершено процессов: {len(procs)} ({sig.name})", resolved=True)
+
+
+def quit_app(app_name: str, wait: float = 10.0) -> Result:
+    code, out, err = run(["osascript", "-e", f'tell application "{app_name}" to quit'], timeout=wait + 20)
+    if code != 0:
+        return Result(False, f"Приложение не закрылось: {err.strip() or out.strip()}")
+    return Result(True, f"{app_name}: отправлена команда выхода", resolved=True)
+
+
+def _trash_one(path: str) -> tuple[bool, str]:
+    if not os.path.lexists(path):
+        return True, "уже нет"
+    trash_bin = shutil.which("trash") or ("/usr/bin/trash" if os.path.exists("/usr/bin/trash") else None)
+    if trash_bin:
+        code, out, err = run([trash_bin, path], timeout=600)
+        if code == 0 and not os.path.lexists(path):
+            return True, ""
+    # Запасной путь — Finder (он же умеет «Вернуть» из Корзины)
+    escaped = path.replace("\\", "\\\\").replace('"', '\\"')
+    code, out, err = run(
+        ["osascript", "-e", f'tell application "Finder" to delete (POSIX file "{escaped}" as alias)'], timeout=600
+    )
+    if code == 0 and not os.path.lexists(path):
+        return True, ""
+    return False, (err or out).strip() or "не удалось"
+
+
+def trash(paths: list[str]) -> Result:
+    freed = 0
+    failed = []
+    for p in paths:
+        size = du_bytes(p) if os.path.isdir(p) else (os.lstat(p).st_blocks * 512 if os.path.lexists(p) else 0)
+        ok, msg = _trash_one(p)
+        if ok:
+            freed += size
+        else:
+            failed.append(f"{short_path(p)}: {msg}")
+    if failed:
+        return Result(bool(freed), "Не всё удалось переместить: " + "; ".join(failed), freed=freed,
+                      resolved=False)
+    return Result(True, f"В Корзину: {human_bytes(freed)}. Место освободится после очистки Корзины.",
+                  freed=freed, resolved=True)
+
+
+def command(argv: list[str], cwd: str | None = None, timeout: float = 1800) -> Result:
+    code, out, err = run(argv, timeout=timeout, cwd=cwd)
+    text = (out + ("\n" + err if err else "")).strip()
+    if code == 0:
+        return Result(True, "Готово: " + " ".join(argv), output=text, resolved=True)
+    return Result(False, f"Команда завершилась с кодом {code}: {' '.join(argv)}", output=text)
+
+
+def trash_size() -> tuple[int, int | None]:
+    """(байт, количество объектов или None, если нет доступа)."""
+    from .util import HOME
+
+    tpath = HOME / ".Trash"
+    try:
+        n = len(os.listdir(tpath))
+        return du_bytes(tpath), n
+    except PermissionError:
+        # Без Full Disk Access каталог закрыт — спросим Finder
+        code, out, _ = run(["osascript", "-e", 'tell application "Finder" to count items of trash'], timeout=20)
+        try:
+            n = int(out.strip())
+        except ValueError:
+            n = None
+        return 0, n
+    except OSError:
+        return 0, 0
+
+
+def empty_trash() -> Result:
+    before = psutil.disk_usage("/").free
+    code, out, err = run(
+        ["osascript", "-e", 'tell application "Finder" to empty trash'], timeout=3600
+    )
+    time.sleep(1)
+    freed = max(psutil.disk_usage("/").free - before, 0)
+    if code != 0:
+        return Result(False, f"Не удалось очистить Корзину: {(err or out).strip()}")
+    return Result(True, f"Корзина очищена, освобождено ≈ {human_bytes(freed)}", freed=freed, resolved=True)
+
+
+def execute(action: Action, finding: Finding | None, journal: Journal) -> Result:
+    target = finding.title if finding else ""
+    k = action.kind
+    try:
+        if k == ActionKind.KILL:
+            res = kill(action.pids, action.force)
+        elif k == ActionKind.QUIT_APP:
+            res = quit_app(action.app_name or "")
+        elif k == ActionKind.TRASH:
+            res = trash(action.paths)
+        elif k in (ActionKind.COMMAND, ActionKind.SHOW):
+            res = command(action.argv, action.cwd)
+            if k == ActionKind.SHOW:
+                res.resolved = False
+        elif k == ActionKind.EMPTY_TRASH:
+            res = empty_trash()
+        elif k == ActionKind.REVEAL:
+            path = action.paths[0] if action.paths else ""
+            # Корзину открываем как папку, остальное — выделяем в Finder
+            code, _, err = run(["open", path] if path.endswith("/.Trash") else ["open", "-R", path])
+            res = Result(code == 0, "Показано в Finder" if code == 0 else err.strip())
+        else:
+            res = Result(False, f"Неизвестное действие {k}")
+    except Exception as e:  # действие не должно ронять интерфейс
+        res = Result(False, f"Ошибка: {e!r}")
+    if k not in (ActionKind.REVEAL, ActionKind.SHOW):
+        journal.log(
+            "action" if res.ok else "error",
+            f"action.{k}",
+            f"{action.label} — {target}: {res.message}",
+            finding=finding.id if finding else None,
+            paths=action.paths,
+            pids=[p for p, _ in action.pids],
+            argv=action.argv,
+            freed=res.freed,
+            ok=res.ok,
+        )
+    return res