fixos 2.2.35__tar.gz → 2.2.36__tar.gz

{fixos-2.2.35 → fixos-2.2.36}/CHANGELOG.md

@@ -150,6 +150,29 @@ fix(goal): code analysis engine
 - **refactor(cli):** Usunięto zduplikowany kod ujednolicając funkcje analizy dysku do wspólnego helpera `_run_disk_analysis`.
 - **refactor(ui):** Usunięto ikony Unicode z CLI i sformatowano wyjście `stderr` oraz standardowego logowania na czysty kod Markdown dla poprawy czytelności w oknach terminalowych.
 
+## [2.2.36] - 2026-07-15
+
+### Docs
+- Update project/README.md
+- Update project/context.md
+
+### Test
+- Update tests/unit/test_service_cleanup.py
+- Update tests/unit/test_service_scanner.py
+
+### Other
+- Update fixos/cli/cleanup_cmd.py
+- Update fixos/diagnostics/cache_discovery.py
+- Update fixos/diagnostics/service_cleanup.py
+- Update fixos/diagnostics/service_scanner.py
+- Update project.sh
+- Update project/analysis.toon.yaml
+- Update project/calls.mmd
+- Update project/calls.png
+- Update project/calls.toon.yaml
+- Update project/calls.yaml
+- ... and 13 more files
+
 ## [2.2.35] - 2026-06-16
 
 ### Other

{fixos-2.2.35 → fixos-2.2.36}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fixos
-Version: 2.2.35
+Version: 2.2.36
 Summary: AI-powered Linux/Windows diagnostics and repair – audio, hardware, system issues
 Home-page: https://github.com/wronai/fixos
 Author: fixos contributors
@@ -63,13 +63,13 @@ AI-powered OS Diagnostics
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-2.2.35-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$3.66-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-30.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-2.2.36-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$4.00-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-32.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $3.6649 (131 commits)
-- 👤 **Human dev:** ~$3047 (30.5h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $3.9985 (137 commits)
+- 👤 **Human dev:** ~$3270 (32.7h @ $100/h, 30min dedup)
 
-Generated on 2026-06-16 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-07-06 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 

{fixos-2.2.35 → fixos-2.2.36}/README.md

@@ -19,13 +19,13 @@ AI-powered OS Diagnostics
 
 ## AI Cost Tracking
 
-![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-2.2.35-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
-![AI Cost](https://img.shields.io/badge/AI%20Cost-$3.66-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-30.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![PyPI](https://img.shields.io/badge/pypi-costs-blue) ![Version](https://img.shields.io/badge/version-2.2.36-blue) ![Python](https://img.shields.io/badge/python-3.9+-blue) ![License](https://img.shields.io/badge/license-Apache--2.0-green)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$4.00-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-32.7h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
 
-- 🤖 **LLM usage:** $3.6649 (131 commits)
-- 👤 **Human dev:** ~$3047 (30.5h @ $100/h, 30min dedup)
+- 🤖 **LLM usage:** $3.9985 (137 commits)
+- 👤 **Human dev:** ~$3270 (32.7h @ $100/h, 30min dedup)
 
-Generated on 2026-06-16 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-07-06 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
 
 ---
 

{fixos-2.2.35 → fixos-2.2.36}/fixos/__init__.py

@@ -1,3 +1,3 @@
 """fixos – AI-powered Linux/Windows diagnostics and repair."""
 
-__version__ = "2.2.35"
+__version__ = "2.2.36"

{fixos-2.2.35 → fixos-2.2.36}/fixos/cli/cleanup_cmd.py

@@ -33,11 +33,34 @@ def _display_cleanup_summary(plan: dict, threshold: int) -> None:
 
     click.echo(f"Znaleziono {plan['services_found']} usług:")
     click.echo(f"  Całkowity rozmiar: {plan['total_size_gb']:.2f} GB")
-    click.echo(f"  Bezpieczne do usunięcia: {plan['safe_cleanup_gb']:.2f} GB")
-    click.echo(f"  Wymaga przeglądu: {plan['requires_review_gb']:.2f} GB")
+    click.echo(
+        click.style(
+            f"  Bezpieczne do usunięcia: {plan['safe_cleanup_gb']:.2f} GB", fg="green"
+        )
+    )
+    click.echo(
+        click.style(
+            f"  Do rozważenia: {plan['requires_review_gb']:.2f} GB", fg="yellow"
+        )
+    )
+    click.echo(
+        click.style(
+            f"  Niebezpieczne (rzeczywiste dane, nie cache): "
+            f"{plan.get('dangerous_gb', 0):.2f} GB",
+            fg="red",
+            bold=True,
+        )
+    )
     click.echo()
 
 
+_RISK_LABELS = {
+    "safe": ("(bezpieczne)", "green"),
+    "review": ("(do rozważenia)", "yellow"),
+    "dangerous": ("(NIEBEZPIECZNE — realne dane, nie cache)", "red"),
+}
+
+
 def _display_service_item(svc: dict) -> None:
     """Display a single service item with details."""
     size_str = (
@@ -45,11 +68,11 @@ def _display_service_item(svc: dict) -> None:
         if svc["size_gb"] >= 1
         else f"{svc['size_mb']:.0f} MB"
     )
-    safe_icon = " " if svc["safe_to_cleanup"] else " "
-    safe_text = "(bezpieczne)" if svc["safe_to_cleanup"] else "(wymaga przeglądu)"
+    risk = svc.get("risk_level") or ("safe" if svc["safe_to_cleanup"] else "review")
+    safe_text, safe_color = _RISK_LABELS.get(risk, _RISK_LABELS["review"])
 
     click.echo(
-        f"{safe_icon} {click.style(svc['name'], fg='yellow', bold=True)} - {size_str}"
+        f"  {click.style(svc['name'], fg='yellow', bold=True)} - {size_str}"
     )
     click.echo(f"   {svc['description']}")
     paths = svc.get("details", {}).get("paths") or [svc["path"]]
@@ -59,7 +82,7 @@ def _display_service_item(svc: dict) -> None:
             click.echo(f"     • {path}")
     else:
         click.echo(f"   Ścieżka: {svc['path']}")
-    click.echo(f"   {safe_text}")
+    click.echo(f"   {click.style(safe_text, fg=safe_color, bold=(risk == 'dangerous'))}")
 
     # Show details for specific services
     if svc.get("details"):
@@ -130,42 +153,113 @@ def _display_service_group(service_type: str, svcs: list, type_map: dict) -> Non
                 _format_hint_line(hint)
 
 
+def _group_by_service_type(services: list) -> dict:
+    groups: dict = {}
+    for svc in services:
+        service_type = svc.get("service_type", "unknown")
+        groups.setdefault(service_type, []).append(svc)
+    return groups
+
+
 def _display_unsafe_services(services: list) -> None:
-    """Display services that require manual review."""
+    """Display services that are worth a look before deleting (reinstallable
+    apps, long-unused tool data, unrecognized cache directories)."""
     from fixos.diagnostics.service_scanner import ServiceType
 
     click.echo()
-    click.echo(click.style("Usługi wymagające przeglądu:", fg="yellow"))
-
-    service_groups: dict = {}
-    for svc in services:
-        service_type = svc.get("service_type", "unknown")
-        if service_type not in service_groups:
-            service_groups[service_type] = []
-        service_groups[service_type].append(svc)
+    click.echo(click.style("Do rozważenia (nie usuwane automatycznie):", fg="yellow"))
 
     type_map = {
         "flatpak": ServiceType.FLATPAK,
+        "generic_cache": ServiceType.GENERIC_CACHE,
+    }
+
+    for service_type, svcs in _group_by_service_type(services).items():
+        _display_service_group(service_type, svcs, type_map)
+
+    click.echo()
+    click.echo(
+        click.style(
+            "💡 Wskazówki: Powyższe komendy są zwykle bezpieczne (usuwają nieużywane "
+            "wersje/runtime) i mogą odzyskać dużo miejsca — warto jednak zerknąć "
+            "zanim je uruchomisz",
+            fg="green",
+        )
+    )
+
+
+def _display_dangerous_services(services: list) -> None:
+    """Display services holding real installed application data (models,
+    containers/volumes, editor extensions, VM disks) rather than a cache.
+
+    Never auto-cleaned in bulk. Shown separately with an explicit warning so
+    it can't be mistaken for one of the "safe" cache entries.
+    """
+    from fixos.diagnostics.service_scanner import ServiceType
+
+    if not services:
+        return
+
+    click.echo()
+    click.echo(
+        click.style(
+            "⚠️  Niebezpieczne — realne dane, nie cache (wymaga ręcznej, świadomej akcji):",
+            fg="red",
+            bold=True,
+        )
+    )
+    click.echo(
+        click.style(
+            "   To nie jest cache do odtworzenia jednym poleceniem — to np. "
+            "zainstalowane modele AI, kontenery/woluminy, dyski maszyn "
+            "wirtualnych albo zainstalowane rozszerzenia edytora. Usunięcie "
+            "może oznaczać realną utratę danych lub długi re-download.",
+            fg="red",
+        )
+    )
+
+    type_map = {
         "docker": ServiceType.DOCKER,
+        "containerd": ServiceType.CONTAINERD,
+        "podman": ServiceType.PODMAN,
         "ollama": ServiceType.OLLAMA,
-        "steam": ServiceType.STEAM,
-        "minikube": ServiceType.MINIKUBE,
         "lmstudio": ServiceType.LMSTUDIO,
-        "generic_cache": ServiceType.GENERIC_CACHE,
+        "huggingface": ServiceType.HUGGINGFACE,
+        "jupyter": ServiceType.JUPYTER,
+        "minikube": ServiceType.MINIKUBE,
+        "appimage": ServiceType.APPIMAGE,
+        "virtualbox": ServiceType.VBOX,
+        "vmware": ServiceType.VMWARE,
+        "steam": ServiceType.STEAM,
+        "cursor": ServiceType.CURSOR,
+        "vscode": ServiceType.VSCODE,
     }
 
-    for service_type, svcs in service_groups.items():
+    for service_type, svcs in _group_by_service_type(services).items():
         _display_service_group(service_type, svcs, type_map)
 
     click.echo()
     click.echo(
         click.style(
-            "💡 Wskazówki: Powyższe komendy są bezpieczne i często odzyskują dużo miejsca",
-            fg="green",
+            "   Aby usunąć pojedynczą usługę świadomie: "
+            "fixos cleanup -c <usluga> (poprzedź --dry-run, by zobaczyć co zrobi)",
+            fg="yellow",
         )
     )
 
 
+def _service_has_dangerous_data(service_name: str, scanner) -> bool:
+    """True if any currently-scanned path for this service is 'dangerous'."""
+    from fixos.diagnostics.service_scanner import RiskLevel, ServiceType
+
+    try:
+        service_enum = ServiceType(service_name)
+    except ValueError:
+        return False
+    scanned = scanner.scan_service(service_enum)
+    return any(s.risk_level == RiskLevel.DANGEROUS.value for s in scanned)
+
+
 def _cleanup_single_service(
     service_name: str, scanner, json_output: bool, dry_run: bool
 ) -> None:
@@ -177,6 +271,21 @@ def _cleanup_single_service(
         click.echo(json.dumps(result, indent=2, default=str))
         return
 
+    if not dry_run and _service_has_dangerous_data(service_name, scanner):
+        click.echo(
+            click.style(
+                f"⚠️  {service_name} zawiera realne dane (nie tylko cache) — np. "
+                "zainstalowane modele/rozszerzenia/kontenery. Tej operacji nie "
+                "da się cofnąć.",
+                fg="red",
+                bold=True,
+            )
+        )
+        click.echo(f"   Podgląd bez usuwania: fixos cleanup -c {service_name} --dry-run")
+        if not click.confirm(f"Na pewno usunąć dane usługi {service_name}?"):
+            click.echo("Anulowano.")
+            return
+
     click.echo(click.style(f"Czyszczenie usługi: {service_name}", fg="yellow"))
     if dry_run:
         click.echo(click.style("[TRYB DRY-RUN] - brak faktycznych zmian", fg="cyan"))
@@ -215,6 +324,8 @@ def _run_interactive_cleanup(plan: dict, list_only: bool, scanner) -> None:
             _execute_safe_cleanup(plan["safe_to_cleanup"], scanner)
     if plan["requires_review"] and not list_only:
         _display_unsafe_services(plan["requires_review"])
+    if plan.get("dangerous") and not list_only:
+        _display_dangerous_services(plan["dangerous"])
 
 
 # ── Main CLI command ──────────────────────────────────────────────────────

{fixos-2.2.35 → fixos-2.2.36}/fixos/diagnostics/cache_discovery.py

@@ -229,12 +229,16 @@ def _build_generic_entry(
     service_type: "ServiceType" = None,
 ) -> "ServiceDataInfo":
     from .service_cleanup import ServiceCleaner
-    from .service_scanner import ServiceDataInfo, ServiceType
+    from .service_scanner import RiskLevel, ServiceDataInfo, ServiceType
 
     if service_type is None:
         service_type = ServiceType.GENERIC_CACHE
     size_gb = size_mb / 1024
     cleanup_command = ServiceCleaner.get_cleanup_command(service_type, path)
+    # Discovered dirs are only ever "safe" (recognized cache name pattern) or
+    # "review" (unrecognized, look before deleting) — never "dangerous",
+    # since we have no basis to claim it's real installed-app data.
+    risk_level = RiskLevel.SAFE.value if safe else RiskLevel.REVIEW.value
     return ServiceDataInfo(
         service_type=service_type,
         name=label,
@@ -248,4 +252,5 @@ def _build_generic_entry(
         safe_to_cleanup=safe,
         impact="high" if size_gb > 1.0 else "medium",
         details={"discovered": True, "source": "cache_discovery"},
+        risk_level=risk_level,
     )

{fixos-2.2.35 → fixos-2.2.36}/fixos/diagnostics/service_cleanup.py

@@ -20,7 +20,9 @@ class ServiceCleaner:
         self.scanner = scanner
 
     def get_cleanup_plan(self, selected_services: List[str] = None) -> Dict[str, Any]:
-        """Generate cleanup plan for services."""
+        """Generate cleanup plan for services, split into 3 risk tiers."""
+        from .service_scanner import RiskLevel
+
         services = self.scanner.scan_all_services()
 
         if selected_services:
@@ -29,18 +31,25 @@ class ServiceCleaner:
             ]
 
         total_size_gb = sum(s.size_gb for s in services)
-        safe_services = [s for s in services if s.safe_to_cleanup]
-        unsafe_services = [s for s in services if not s.safe_to_cleanup]
+        safe_services = [s for s in services if s.risk_level == RiskLevel.SAFE.value]
+        review_services = [
+            s for s in services if s.risk_level == RiskLevel.REVIEW.value
+        ]
+        dangerous_services = [
+            s for s in services if s.risk_level == RiskLevel.DANGEROUS.value
+        ]
 
         plan = {
             "threshold_mb": self.scanner.threshold_mb,
             "services_found": len(services),
             "total_size_gb": round(total_size_gb, 2),
             "safe_cleanup_gb": round(sum(s.size_gb for s in safe_services), 2),
-            "requires_review_gb": round(sum(s.size_gb for s in unsafe_services), 2),
+            "requires_review_gb": round(sum(s.size_gb for s in review_services), 2),
+            "dangerous_gb": round(sum(s.size_gb for s in dangerous_services), 2),
             "services": [self._service_to_dict(s) for s in services],
             "safe_to_cleanup": [self._service_to_dict(s) for s in safe_services],
-            "requires_review": [self._service_to_dict(s) for s in unsafe_services],
+            "requires_review": [self._service_to_dict(s) for s in review_services],
+            "dangerous": [self._service_to_dict(s) for s in dangerous_services],
         }
 
         return plan
@@ -117,18 +126,32 @@ class ServiceCleaner:
             "cleanup_command": service.cleanup_command,
             "preview_command": service.preview_command,
             "safe_to_cleanup": service.safe_to_cleanup,
+            "risk_level": service.risk_level,
             "impact": service.impact,
             "items_count": service.items_count,
             "details": service.details,
         }
 
     @staticmethod
-    def is_safe_cleanup(service_type, path: str | None = None) -> bool:
-        """Determine if cleanup is generally safe (cache-only, not user data)."""
-        from .service_scanner import ServiceType
+    def get_risk_level(service_type, path: str | None = None) -> str:
+        """Classify cleanup risk for a service path.
+
+        Returns one of ``RiskLevel.SAFE`` / ``REVIEW`` / ``DANGEROUS``
+        (as their string values):
+
+        - safe: rebuildable cache — re-downloads or regenerates itself
+          (package/build caches, browser caches, system package caches).
+        - review: recoverable but worth a look before deleting — reinstallable
+          apps, long-unused tool data, or unrecognized cache directories.
+        - dangerous: real installed application data that is not a simple
+          cache (AI models, containers/volumes, VM disks, editor extensions)
+          and may not be trivially recoverable.
+        """
+        from .service_scanner import RiskLevel, ServiceType
+
+        normalized_path = os.path.expanduser(path or "").rstrip("/")
 
         if service_type == ServiceType.CHROME:
-            normalized_path = os.path.expanduser(path or "").rstrip("/")
             chrome_cache_root = os.path.expanduser("~/.cache/google-chrome").rstrip("/")
             chrome_cache_names = {
                 "Cache",
@@ -143,34 +166,70 @@ class ServiceCleaner:
             if normalized_path == chrome_cache_root or normalized_path.startswith(
                 f"{chrome_cache_root}/"
             ):
-                return True
+                return RiskLevel.SAFE.value
 
             if os.path.basename(normalized_path) in chrome_cache_names:
-                return True
+                return RiskLevel.SAFE.value
 
-            return False
+            return RiskLevel.REVIEW.value
 
         if service_type == ServiceType.BRAVE:
-            normalized_path = os.path.expanduser(path or "").rstrip("/")
             if "/Cache" in normalized_path or normalized_path.endswith(
                 ("GPUCache", "Code Cache")
             ):
-                return True
-            return normalized_path.endswith("BraveSoftware") or "/BraveSoftware/" in (
+                return RiskLevel.SAFE.value
+            if normalized_path.endswith("BraveSoftware") or "/BraveSoftware/" in (
                 normalized_path
-            )
+            ):
+                return RiskLevel.SAFE.value
+            return RiskLevel.REVIEW.value
 
         if service_type == ServiceType.STEAM:
-            normalized_path = os.path.expanduser(path or "").rstrip("/")
             safe_suffixes = ("shadercache", "appcache")
-            return any(normalized_path.endswith(suffix) for suffix in safe_suffixes)
+            if any(normalized_path.endswith(suffix) for suffix in safe_suffixes):
+                return RiskLevel.SAFE.value
+            # Anything else is the actual Steam library/client: installed
+            # games and their save data, not a cache.
+            return RiskLevel.DANGEROUS.value
+
+        if service_type in (ServiceType.CURSOR, ServiceType.VSCODE):
+            # The extensions directory holds real installed extensions (and
+            # any local-only extension data), not a cache — reinstalling
+            # each one by hand is real work and some local state won't come
+            # back. Everything else these two scan (Cache/CachedData/logs)
+            # is a plain, rebuildable cache.
+            if os.path.basename(normalized_path) == "extensions":
+                return RiskLevel.DANGEROUS.value
+            return RiskLevel.SAFE.value
 
         if service_type in (ServiceType.GENERIC_CACHE, ServiceType.ELECTRON):
-            base = os.path.basename(os.path.expanduser(path or "").rstrip("/")).lower()
-            return any(
+            base = os.path.basename(normalized_path).lower()
+            if any(
                 hint in base
                 for hint in ("cache", "shader", "tmp", "temp", "log", "crash", "thumb")
-            )
+            ):
+                return RiskLevel.SAFE.value
+            return RiskLevel.REVIEW.value
+
+        dangerous_services = {
+            # Bulk-wipe commands that remove every installed model/container,
+            # not just unused/old ones.
+            ServiceType.DOCKER,
+            ServiceType.CONTAINERD,
+            ServiceType.PODMAN,
+            ServiceType.OLLAMA,
+            ServiceType.LMSTUDIO,
+            ServiceType.HUGGINGFACE,
+            ServiceType.JUPYTER,
+            ServiceType.MINIKUBE,
+            # Actual installed apps, not a cache directory.
+            ServiceType.APPIMAGE,
+            # VM disks/snapshots: unique state, not redownloadable.
+            ServiceType.VBOX,
+            ServiceType.VMWARE,
+        }
+        if service_type in dangerous_services:
+            return RiskLevel.DANGEROUS.value
 
         safe_services = {
             # Package caches (can be re-downloaded)
@@ -178,6 +237,7 @@ class ServiceCleaner:
             ServiceType.YARN,
             ServiceType.PNPM,
             ServiceType.PIP,
+            ServiceType.CONDA,
             ServiceType.POETRY,
             ServiceType.GRADLE,
             ServiceType.MAVEN,
@@ -196,6 +256,8 @@ class ServiceCleaner:
             ServiceType.SLACK,
             ServiceType.SPOTIFY,
             ServiceType.BRAVE,
+            ServiceType.NIX,
+            ServiceType.BREW,
             # System caches
             ServiceType.APT,
             ServiceType.DNF,
@@ -216,7 +278,20 @@ class ServiceCleaner:
             ServiceType.TERRAFORM,
             ServiceType.PULUMI,
         }
-        return service_type in safe_services
+        if service_type in safe_services:
+            return RiskLevel.SAFE.value
+
+        # Default: reinstallable apps / long-unused tool data / unclassified
+        # (Flatpak, Snap, Android SDK, JetBrains, Vagrant, Unity, ...) —
+        # worth a look before deleting, but not flagged as high-risk.
+        return RiskLevel.REVIEW.value
+
+    @staticmethod
+    def is_safe_cleanup(service_type, path: str | None = None) -> bool:
+        """Backward-compatible bool view of get_risk_level() == SAFE."""
+        from .service_scanner import RiskLevel
+
+        return ServiceCleaner.get_risk_level(service_type, path) == RiskLevel.SAFE.value
 
     @staticmethod
     def get_cleanup_hints(service_type, size_gb: float) -> List[str]: