fixos 2.2.28__tar.gz → 2.2.29__tar.gz

{fixos-2.2.28 → fixos-2.2.29}/CHANGELOG.md

@@ -150,6 +150,32 @@ 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.29] - 2026-05-08
+
+### Docs
+- Update README.md
+- Update SUMD.md
+- Update SUMR.md
+- Update project/README.md
+- Update project/context.md
+
+### Test
+- Update tests/e2e/test_diagnostics_integration.py
+- Update tests/unit/test_core.py
+
+### Other
+- Update app.doql.less
+- Update fixos/agent/session_core.py
+- Update fixos/cli/_cleanup_flatpak.py
+- Update fixos/cli/_cleanup_home.py
+- Update fixos/cli/_cleanup_snap.py
+- Update fixos/cli/_cleanup_system.py
+- Update fixos/cli/_cleanup_utils.py
+- Update fixos/cli/cleanup_cmd.py
+- Update fixos/cli/config_cmd.py
+- Update fixos/cli/scan_cmd.py
+- ... and 36 more files
+
 ## [2.2.28] - 2026-05-06
 
 ### Docs

{fixos-2.2.28 → fixos-2.2.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fixos
-Version: 2.2.28
+Version: 2.2.29
 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,11 @@ 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.28-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-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-26.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-yellow) ![AI Model](https://img.shields.io/badge/AI%20Model-openrouter%2Fqwen%2Fqwen3-coder-next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (127 commits)
-- 👤 **Human dev:** ~$2647 (26.5h @ $100/h, 30min dedup)
+This project uses AI-generated code. Total cost: **$7.5000** with **128** AI commits.
 
-Generated on 2026-05-06 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-05-08 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/models/openrouter/qwen/qwen3-coder-next)
 
 ---
 

{fixos-2.2.28 → fixos-2.2.29}/README.md

@@ -19,13 +19,11 @@ 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.28-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-$7.50-orange) ![Human Time](https://img.shields.io/badge/Human%20Time-26.5h-blue) ![Model](https://img.shields.io/badge/Model-openrouter%2Fqwen%2Fqwen3--coder--next-lightgrey)
+![AI Cost](https://img.shields.io/badge/AI%20Cost-$7.50-yellow) ![AI Model](https://img.shields.io/badge/AI%20Model-openrouter%2Fqwen%2Fqwen3-coder-next-lightgrey)
 
-- 🤖 **LLM usage:** $7.5000 (127 commits)
-- 👤 **Human dev:** ~$2647 (26.5h @ $100/h, 30min dedup)
+This project uses AI-generated code. Total cost: **$7.5000** with **128** AI commits.
 
-Generated on 2026-05-06 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/qwen/qwen3-coder-next)
+Generated on 2026-05-08 using [openrouter/qwen/qwen3-coder-next](https://openrouter.ai/models/openrouter/qwen/qwen3-coder-next)
 
 ---
 

{fixos-2.2.28 → fixos-2.2.29}/fixos/__init__.py

@@ -1,2 +1,2 @@
 """fixos – AI-powered Linux/Windows diagnostics and repair."""
-__version__ = "2.2.28"
+__version__ = "2.2.29"

{fixos-2.2.28 → fixos-2.2.29}/fixos/agent/session_core.py

@@ -51,6 +51,31 @@ IMPORTANT RULES:
 - When disk usage is critically high (>90%), ALWAYS propose cleanup commands FIRST.
 - NEVER suggest package upgrades or installations BEFORE cleanup has freed sufficient space and been verified.
 
+PACKAGE ANALYSIS rules (when "packages" data is present):
+- For orphaned packages: propose `sudo dnf autoremove` or specific `sudo dnf remove <pkg>`.
+- For debug/devel packages on desktop: propose `sudo dnf remove '*-debuginfo*'` or specific removals.
+- For duplicate RPM+Flatpak apps: propose removing one version (prefer Flatpak for GUI apps).
+- For unused Flatpak runtimes: propose `flatpak uninstall --unused`.
+- For leaf packages not used in 90+ days: propose specific `sudo dnf remove <pkg>`.
+- Always warn user about dependencies that will be removed.
+
+STORAGE OPTIMIZATION rules (when "storage" data is present):
+- If unallocated disk space exists: propose `sudo growpart` or `sudo lvextend + resize2fs/xfs_growfs`.
+- For btrfs without compression: propose adding `compress=zstd:1` to fstab.
+- For old btrfs snapshots: propose `sudo snapper delete <id>` for specific old snapshots.
+- For swap/zram optimization: propose tuning swappiness or enabling zram.
+- If fstrim.timer is disabled on SSD: propose `sudo systemctl enable --now fstrim.timer`.
+
+FILE ANALYSIS rules (when "files" data is present):
+- For large files >200MB: list them and propose review/deletion commands.
+- For duplicate files: propose `fdupes -d` or `rdfind` commands for interactive dedup.
+- For media files (ebooks, mp3, mp4, images): propose organizing/archiving commands:
+  - `mkdir -p ~/Archive/{ebooks,muzyka,wideo,obrazy}` + `mv` commands.
+  - For compression: `tar czf ~/Archive/ebooks.tar.gz ~/path/to/ebooks/`.
+- For old downloads (>30 days): propose cleanup of ~/Downloads.
+- For trash: propose `rm -rf ~/.local/share/Trash/files/*`.
+- Always group suggestions by category (video, music, ebooks, archives, etc.).
+
 Always end with:
 ━━━ DOSTĘPNE AKCJE ━━━
 [1] Fix problem 1 – `command`
@@ -117,11 +142,9 @@ def _extract_co_robi(text: str) -> str:
     return m.group(1).strip() if m else ""
 
 
-def extract_fixes(reply: str) -> List[Tuple[str, str]]:
-    """Extract (command, comment) pairs from LLM reply."""
+def _pattern_strict_bold(reply: str) -> List[Tuple[str, str]]:
+    """Pattern 1: **Komenda:** `command` (strict: bold + backticks)."""
     fixes: List[Tuple[str, str]] = []
-
-    # Pattern 1: **Komenda:** `command` (strict: bold + backticks)
     for m in re.finditer(
         r"\*\*Komenda:\*\*\s*`([^`]+)`(?:[^\n]*?\*\*Co robi:\*\*\s*(.+?))?(?=\n|$)",
         reply, re.IGNORECASE,
@@ -129,45 +152,72 @@ def extract_fixes(reply: str) -> List[Tuple[str, str]]:
         cmd = m.group(1).strip()
         if cmd:
             fixes.append((cmd, (m.group(2) or "").strip()))
+    return fixes
 
-    # Pattern 2: Komenda: `command` (backticks, optional bold)
-    if not fixes:
-        for m in re.finditer(
-            r"\*{0,2}Komenda:\*{0,2}\s*`([^`]+)`",
-            reply, re.IGNORECASE,
-        ):
-            cmd = m.group(1).strip()
-            if cmd:
-                fixes.append((cmd, _extract_co_robi(reply[m.end():])))
-
-    # Pattern 3: Komenda: command (no backticks — command until Co robi:/next problem/section)
-    if not fixes:
-        for m in re.finditer(
-            r"\*{0,2}Komenda:\*{0,2}\s*"
-            r"(.+?)"
-            r"(?=\n\s*\*{0,2}Co robi:|\n[🔴🟡🟢]|\n━|\n─|\n\[[\dA-Z]|\Z)",
-            reply, re.IGNORECASE | re.DOTALL,
-        ):
-            cmd = re.sub(r"\s*\n\s*", " ", m.group(1)).strip()
-            if cmd:
-                fixes.append((cmd, _extract_co_robi(reply[m.end():])))
-
-    # Fallback: → Fix: `command`
-    if not fixes:
-        for m in re.finditer(r"→\s*Fix:\s*`([^`]+)`", reply, re.IGNORECASE):
-            fixes.append((m.group(1).strip(), ""))
-    # Fallback: [N] ... `command`
+
+def _pattern_backticks(reply: str) -> List[Tuple[str, str]]:
+    """Pattern 2: Komenda: `command` (backticks, optional bold)."""
+    fixes: List[Tuple[str, str]] = []
+    for m in re.finditer(
+        r"\*{0,2}Komenda:\*{0,2}\s*`([^`]+)`",
+        reply, re.IGNORECASE,
+    ):
+        cmd = m.group(1).strip()
+        if cmd:
+            fixes.append((cmd, _extract_co_robi(reply[m.end():])))
+    return fixes
+
+
+def _pattern_no_backticks(reply: str) -> List[Tuple[str, str]]:
+    """Pattern 3: Komenda: command (no backticks — until next section)."""
+    fixes: List[Tuple[str, str]] = []
+    for m in re.finditer(
+        r"\*{0,2}Komenda:\*{0,2}\s*"
+        r"(.+?)"
+        r"(?=\n\s*\*{0,2}Co robi:|\n[🔴🟡🟢]|\n━|\n─|\n\[[\dA-Z]|\Z)",
+        reply, re.IGNORECASE | re.DOTALL,
+    ):
+        cmd = re.sub(r"\s*\n\s*", " ", m.group(1)).strip()
+        if cmd:
+            fixes.append((cmd, _extract_co_robi(reply[m.end():])))
+    return fixes
+
+
+def _pattern_fallbacks(reply: str) -> List[Tuple[str, str]]:
+    """Fallback patterns: → Fix, [N] command, EXEC."""
+    fixes: List[Tuple[str, str]] = []
+    for m in re.finditer(r"→\s*Fix:\s*`([^`]+)`", reply, re.IGNORECASE):
+        fixes.append((m.group(1).strip(), ""))
     if not fixes:
         for m in re.finditer(r"\[(\d+)\][^`\n]+`([^`]+)`", reply):
             fixes.append((m.group(2).strip(), f"Fix #{m.group(1)}"))
-    # Fallback: EXEC: `command`
     if not fixes:
         for m in re.finditer(r"EXEC:\s*`([^`]+)`", reply, re.IGNORECASE):
             fixes.append((m.group(1).strip(), ""))
+    return fixes
+
 
-    # Keep only actionable commands in menu; diagnostic-only commands are noise.
+def _deduplicate(fixes: List[Tuple[str, str]]) -> List[Tuple[str, str]]:
+    """Remove diagnostic-only commands and deduplicate."""
     filtered = [(cmd, comment) for cmd, comment in fixes if not _is_diagnostic_only_command(cmd)]
-    return filtered
+    seen: set[str] = set()
+    unique: List[Tuple[str, str]] = []
+    for cmd, comment in filtered:
+        if cmd not in seen:
+            seen.add(cmd)
+            unique.append((cmd, comment))
+    return unique
+
+
+def extract_fixes(reply: str) -> List[Tuple[str, str]]:
+    """Extract (command, comment) pairs from LLM reply."""
+    fixes = (
+        _pattern_strict_bold(reply)
+        or _pattern_backticks(reply)
+        or _pattern_no_backticks(reply)
+        or _pattern_fallbacks(reply)
+    )
+    return _deduplicate(fixes)
 
 
 def extract_search_topic(llm_reply: str) -> str:

fixos-2.2.29/fixos/cli/_cleanup_flatpak.py

@@ -0,0 +1,229 @@
+"""Flatpak-specific cleanup CLI handlers."""
+from __future__ import annotations
+
+import click
+
+from fixos.cli._cleanup_utils import (
+    _format_bytes,
+    _parse_selection,
+    _parse_size_to_bytes,
+)
+
+
+def _cleanup_flatpak_detailed(scanner, json_output: bool, dry_run: bool) -> None:
+    """
+    Detailed interactive Flatpak cleanup with menu selection.
+
+    Wyświetla menu z opcjami i pokazuje korzyści na bazie rzeczywistych danych.
+    """
+    from fixos.diagnostics.flatpak_analyzer import FlatpakAnalyzer
+
+    analyzer = FlatpakAnalyzer()
+
+    # Najpierw wykonaj pełną analizę
+    click.echo(click.style("\n🔍 Analizuję Flatpak...", fg="cyan"))
+    analysis = analyzer.analyze()
+
+    # JSON output mode
+    if json_output:
+        import json
+        click.echo(json.dumps(analysis, indent=2, default=str))
+        return
+
+    # Wyświetl podsumowanie stanu
+    _display_flatpak_status(analysis)
+
+    # Pobierz rekomendacje
+    recommendations = analyzer.get_cleanup_recommendations()
+
+    if not recommendations:
+        click.echo(click.style("\n✅ Brak rekomendacji czyszczenia - Flatpak jest w dobrym stanie.", fg="green"))
+        return
+
+    # Wyświetl menu z opcjami
+    click.echo(f"\n{click.style('='*60, fg='cyan')}")
+    click.echo(click.style("📋 WYBIERZ OPCJE DO WYKONANIA", fg="cyan", bold=True))
+    click.echo(click.style(f"{'='*60}", fg="cyan"))
+
+    if dry_run:
+        click.echo(click.style("\n[TRYB DRY-RUN] - brak faktycznych zmian\n", fg="yellow"))
+
+    # Wyświetl każdą opcję z korzyściami
+    total_potential_savings = 0
+    for i, rec in enumerate(recommendations, 1):
+        priority_icon = {"critical": "💣", "high": "🔥", "medium": "⚠️", "low": "💡"}.get(rec['priority'], "•")
+        risk_color = {"none": "green", "low": "green", "medium": "yellow", "high": "red"}.get(rec['risk'], "white")
+
+        click.echo(f"\n{click.style(f'[{i}]', fg='cyan', bold=True)} {priority_icon} {click.style(rec['description'], fg='yellow', bold=True)}")
+        click.echo(f"    Komenda: {click.style(rec['action'], fg='white', dim=True)}")
+
+        # Korzyść na bazie rzeczywistych danych
+        savings = rec.get('estimated_savings', '0 B')
+        click.echo(f"    {click.style('Korzyść:', fg='green')} ~{savings}")
+        total_potential_savings += _parse_size_to_bytes(savings)
+
+        click.echo(f"    {click.style('Ryzyko:', fg='white')} {click.style(rec['risk'].upper(), fg=risk_color)}")
+
+        # Dodatkowe info
+        if rec.get('items'):
+            n_items = len(rec['items'])
+            click.echo(f"    {click.style(f'Elementów: {n_items}', fg='white', dim=True)}")
+
+    # Podsumowanie potencjalnych korzyści
+    click.echo(f"\n{click.style('-'*60, fg='cyan')}")
+    click.echo(f"💰 {click.style('ŁĄCZNA POTENCJALNA KORZYŚĆ:', fg='green', bold=True)} ~{_format_bytes(total_potential_savings)}")
+    click.echo(click.style(f"{'-'*60}", fg="cyan"))
+
+    # Menu wyboru
+    click.echo(f"\n{click.style('Dostępne opcje:', fg='white', bold=True)}")
+    click.echo(f"  {click.style('1,2,3...', fg='cyan')} - wybierz konkretne opcje (np. '1,3')")
+    click.echo(f"  {click.style('all', fg='green')}    - wykonaj wszystkie bezpieczne (ryzyko low/none)")
+    click.echo(f"  {click.style('critical', fg='red')} - wykonaj tylko krytyczne")
+    click.echo(f"  {click.style('none', fg='yellow')}   - pomiń wszystko")
+    click.echo(f"  {click.style('?', fg='white')}      - pokaż szczegóły każdej opcji")
+
+    # Pytaj o wybór
+    click.echo()
+    selection = click.prompt(
+        click.style("Twój wybór", fg="cyan"),
+        default="none",
+        show_default=False
+    )
+
+    # Obsłuż '?'
+    if selection.strip() == '?':
+        _display_detailed_recommendations(recommendations)
+        selection = click.prompt(
+            click.style("\nTwój wybór", fg="cyan"),
+            default="none",
+            show_default=False
+        )
+
+    # Parsuj wybór
+    selected_indices = _parse_selection(selection, len(recommendations))
+
+    if not selected_indices:
+        click.echo(click.style("\n⏭️ Nie wybrano żadnych akcji.", fg="yellow"))
+        return
+
+    # Wykonaj wybrane akcje
+    results = {
+        "executed": [],
+        "skipped": [],
+        "failed": [],
+        "space_reclaimed": 0,
+    }
+
+    click.echo(f"\n{click.style('='*60, fg='cyan')}")
+    click.echo(click.style("🚀 WYKONYWANIE WYBRANYCH AKCJI", fg="cyan", bold=True))
+    click.echo(f"{click.style('='*60, fg='cyan')}\n")
+
+    for idx in selected_indices:
+        rec = recommendations[idx]
+        click.echo(f"\n[{idx+1}/{len(recommendations)}] {rec['description']}")
+
+        if dry_run:
+            click.echo(click.style(f"   [DRY-RUN] Wykonano by: {rec['action']}", fg="cyan"))
+            results['executed'].append({"action": rec['action'], "dry_run": True})
+            savings_bytes = _parse_size_to_bytes(rec.get('estimated_savings', '0 B'))
+            results['space_reclaimed'] += savings_bytes
+        else:
+            click.echo(f"   🚀 Wykonuję: {rec['action']}")
+            result = analyzer._execute_cleanup_action(rec)
+
+            if result['success']:
+                results['executed'].append({
+                    "action": rec['action'],
+                    "output": result.get('output', ''),
+                })
+                results['space_reclaimed'] += result.get('bytes_reclaimed', 0)
+                click.echo(click.style("   ✅ Sukces", fg="green"))
+            else:
+                results['failed'].append({
+                    "action": rec['action'],
+                    "error": result.get('error', 'Unknown error'),
+                })
+                click.echo(click.style(f"   ❌ Błąd: {result.get('error', 'Unknown error')}", fg="red"))
+
+    # Podsumowanie końcowe
+    click.echo(f"\n{click.style('='*60, fg='cyan')}")
+    click.echo(click.style("📊 PODSUMOWANIE", fg="cyan", bold=True))
+    click.echo(click.style(f"{'='*60}", fg="cyan"))
+    click.echo(f"   ✅ Wykonano: {len(results['executed'])}")
+    click.echo(f"   ⏭️ Pominięto: {len(results['skipped'])}")
+    click.echo(f"   ❌ Błędy: {len(results['failed'])}")
+
+    freed_gb = results['space_reclaimed'] / (1024**3)
+    if dry_run:
+        click.echo(click.style(f"\n   💰 [DRY-RUN] Zwolniono by: {freed_gb:.2f} GB", fg="cyan"))
+    else:
+        click.echo(click.style(f"\n   💰 Odzyskano: {freed_gb:.2f} GB", fg="green"))
+
+    click.echo(click.style("="*60 + "\n", fg="cyan"))
+
+
+def _display_flatpak_status(analysis: dict) -> None:
+    """Wyświetl status Flatpak z rzeczywistymi danymi."""
+    click.echo(f"\n{click.style('='*60, fg='cyan')}")
+    click.echo(click.style("📊 STATUS FLATPAK", fg="cyan", bold=True))
+    click.echo(click.style(f"{'='*60}", fg="cyan"))
+
+    # Aplikacje
+    apps_count = len(analysis.get('installed_apps', []))
+    apps_size = sum(a.get('size_bytes', 0) for a in analysis.get('installed_apps', []))
+    click.echo(f"\n📱 Aplikacje: {click.style(str(apps_count), fg='yellow')} ({_format_bytes(apps_size)})")
+
+    # Runtimes
+    runtimes_count = len(analysis.get('installed_runtimes', []))
+    runtimes_size = sum(r.get('size_bytes', 0) for r in analysis.get('installed_runtimes', []))
+    click.echo(f"🔧 Runtime'y: {click.style(str(runtimes_count), fg='yellow')} ({_format_bytes(runtimes_size)})")
+
+    # Repo bloat
+    repo_bloat = analysis.get('repo_bloat', {})
+    if repo_bloat.get('bloat_detected'):
+        click.echo(f"\n{click.style('⚠️  PROBLEM: Repo zajmuje za dużo miejsca!', fg='red', bold=True)}")
+        click.echo(f"   Repo: {_format_bytes(repo_bloat.get('repo_total_size', 0))}")
+        click.echo(f"   Aplikacje+Runtime'y: {_format_bytes(repo_bloat.get('installed_size', 0))}")
+        click.echo(f"   Ratio: {repo_bloat.get('ratio', 0):.1f}x (powinno być ~1-1.5x)")
+        click.echo(f"   {click.style('Marnotrawstwo:', fg='red')} {_format_bytes(repo_bloat.get('wasted_size', 0))}")
+
+    # Duplikaty
+    duplicates = analysis.get('duplicate_apps', [])
+    if duplicates:
+        dup_size = sum(d.get('total_size', 0) for d in duplicates)
+        click.echo(f"\n🔄 Duplikaty aplikacji: {click.style(str(len(duplicates)), fg='yellow')} ({_format_bytes(dup_size)})")
+        for dup in duplicates[:3]:
+            click.echo(f"   • {dup.get('name', '?')} ({dup.get('count', 0)} wersje)")
+
+    # Nieużywane runtime'y
+    unused = analysis.get('unused_runtimes', [])
+    if unused:
+        unused_size = analysis.get('total_size_unused', 0)
+        click.echo(f"\n🗑️ Nieużywane runtime'y: {click.style(str(len(unused)), fg='yellow')} ({_format_bytes(unused_size)})")
+
+    # Leftover data
+    leftover = analysis.get('leftover_data', [])
+    if leftover:
+        leftover_size = analysis.get('total_size_leftover', 0)
+        click.echo(f"\n📁 Dane po odinstalowanych: {click.style(str(len(leftover)), fg='yellow')} ({_format_bytes(leftover_size)})")
+
+
+def _display_detailed_recommendations(recommendations: list) -> None:
+    """Wyświetl szczegółowe informacje o każdej rekomendacji."""
+    click.echo(f"\n{click.style('='*60, fg='cyan')}")
+    click.echo(click.style("📖 SZCZEGÓŁY REKOMENDACJI", fg="cyan", bold=True))
+    click.echo(click.style(f"{'='*60}", fg="cyan"))
+
+    for i, rec in enumerate(recommendations, 1):
+        click.echo(f"\n{click.style(f'[{i}]', fg='cyan', bold=True)} {rec['description']}")
+        click.echo(click.style(f"{'-'*50}", fg="white", dim=True))
+        click.echo(f"\n{rec['explanation']}")
+
+        if rec.get('items'):
+            click.echo(f"\nElementy do usunięcia ({len(rec['items'])}):")
+            for item in rec['items'][:10]:
+                name = item.get('name', '?')
+                size = item.get('size_human', '?')
+                click.echo(f"  • {name} ({size})")
+            if len(rec['items']) > 10:
+                click.echo(f"  ... i {len(rec['items']) - 10} więcej")

fixos-2.2.29/fixos/cli/_cleanup_home.py

@@ -0,0 +1,132 @@
+"""Home directory analysis and cleanup CLI handlers."""
+from __future__ import annotations
+
+import click
+
+from fixos.cli._cleanup_utils import _format_bytes, _parse_numeric_range_set
+from fixos.constants import MAX_HOME_LARGE_FILES_DISPLAY, MAX_HOME_LARGE_DIRS_DISPLAY
+
+
+def _display_home_items(large_files: list, large_dirs: list) -> None:
+    """Print large files and directories found in home."""
+    if large_files:
+        click.echo(f"\n{click.style('📄 DUŻE PLIKI (>200MB):', fg='red', bold=True)}")
+        for i, f in enumerate(large_files[:MAX_HOME_LARGE_FILES_DISPLAY], 1):
+            click.echo(f"  [{i:3d}] 📄 {click.style(f['path'], fg='cyan')}: {f['size_human']}")
+        if len(large_files) > MAX_HOME_LARGE_FILES_DISPLAY:
+            click.echo(f"  ... i {len(large_files) - MAX_HOME_LARGE_FILES_DISPLAY} więcej")
+    if large_dirs:
+        click.echo(f"\n{click.style('📁 DUŻE FOLDERY (>500MB):', fg='magenta', bold=True)}")
+        offset = len(large_files)
+        for i, d in enumerate(large_dirs[:MAX_HOME_LARGE_DIRS_DISPLAY], 1):
+            click.echo(f"  [{offset + i:3d}] 📁 {click.style(d['path'], fg='yellow')}: {d['size_human']}")
+        if len(large_dirs) > MAX_HOME_LARGE_DIRS_DISPLAY:
+            click.echo(f"  ... i {len(large_dirs) - MAX_HOME_LARGE_DIRS_DISPLAY} więcej")
+
+
+def _resolve_home_selection(nums: str, large_files: list, large_dirs: list) -> list:
+    """Convert index string into the list of selected home items."""
+    total_items = len(large_files) + len(large_dirs)
+    selected_indices = _parse_numeric_range_set(nums)
+    items = []
+    for i in selected_indices:
+        if 1 <= i <= len(large_files):
+            items.append(large_files[i - 1])
+        elif len(large_files) < i <= total_items:
+            items.append(large_dirs[i - len(large_files) - 1])
+    return items
+
+
+def _remove_home_items(items_to_remove: list) -> None:
+    """Delete files/directories and report result."""
+    import os
+    import shutil
+    click.echo(f"\n{click.style('🚀 USUWANIE ELEMENTÓW:', fg='cyan', bold=True)}")
+    for item in items_to_remove:
+        click.echo(f"\n• {item['path']}")
+        try:
+            if item.get('type') == 'file':
+                os.remove(item['path'])
+            else:
+                shutil.rmtree(item['path'])
+            click.echo(click.style("  ✅ Usunięto", fg="green"))
+        except Exception as e:
+            click.echo(click.style(f"  ❌ Błąd: {e}", fg="red"))
+
+
+def _show_home_item_info(nums: str, large_files: list, large_dirs: list, total_items: int) -> None:
+    """Display info about a single home item by index."""
+    import os
+    import mimetypes
+    try:
+        idx = int(nums[5:])
+        if 1 <= idx <= len(large_files):
+            f = large_files[idx - 1]
+            click.echo(f"\n{click.style('📦 SZCZEGÓŁY PLIKU:', fg='yellow', bold=True)}")
+            click.echo(f"  Ścieżka:   {f['path']}")
+            click.echo(f"  Rozmiar:   {f['size_human']}")
+            if os.path.exists(f['path']):
+                click.echo(click.style("  ✅ Istnieje", fg="green"))
+                mime_type, _ = mimetypes.guess_type(f['path'])
+                if mime_type:
+                    click.echo(f"  Typ:       {mime_type}")
+            else:
+                click.echo(click.style("  ⚠️ Nie istnieje", fg="yellow"))
+        elif len(large_files) < idx <= total_items:
+            d = large_dirs[idx - len(large_files) - 1]
+            click.echo(f"\n{click.style('📦 SZCZEGÓŁY FOLDERU:', fg='yellow', bold=True)}")
+            click.echo(f"  Ścieżka:   {d['path']}")
+            click.echo(f"  Rozmiar:   {d['size_human']}")
+        else:
+            click.echo(click.style(f"❌ Nieprawidłowy numer: {idx}", fg="red"))
+    except ValueError:
+        click.echo(click.style("❌ Format: info:N (np. info:5)", fg="red"))
+
+
+def _handle_home_analysis(analyzer, dry_run: bool) -> None:
+    """Handle home directory large-file analysis and removal."""
+    large_files = getattr(analyzer, 'home_large_files', [])
+    large_dirs = getattr(analyzer, 'home_large_dirs', [])
+
+    if not large_files and not large_dirs:
+        click.echo(click.style("\n❌ Brak dużych plików w home do analizy.", fg="red"))
+        return
+
+    click.echo(f"\n{click.style('🏠 ANALIZA HOME DIRECTORY:', fg='yellow', bold=True)}")
+    click.echo(click.style(f"Znaleziono {len(large_files)} dużych plików (>200MB) i {len(large_dirs)} folderów (>500MB)", fg="white"))
+    _display_home_items(large_files, large_dirs)
+
+    total_items = len(large_files) + len(large_dirs)
+    click.echo(f"\n{click.style('💡 Wybierz numery plików/folderów do usunięcia:', fg='cyan')}")
+    click.echo(click.style("  • Pliki: 1-{}, Foldery: {}-{}".format(len(large_files), len(large_files)+1, total_items), fg="white"))
+
+    nums = click.prompt(click.style("\nWybierz numery (np. 1,3,5-10) lub 'info:N' dla szczegółów", fg="cyan"), default="")
+    if not nums.strip():
+        click.echo(click.style("⏭️ Nie wybrano żadnych elementów.", fg="yellow"))
+        return
+
+    nums = nums.strip().lower()
+    if nums.startswith('info:'):
+        _show_home_item_info(nums, large_files, large_dirs, total_items)
+        return
+
+    items_to_remove = _resolve_home_selection(nums, large_files, large_dirs)
+    if not items_to_remove:
+        click.echo(click.style("❌ Nie wybrano żadnych elementów.", fg="red"))
+        return
+
+    click.echo(f"\n{click.style('📦 WYBRANE ELEMENTY DO USUNIĘCIA:', fg='red', bold=True)}")
+    for i, item in enumerate(items_to_remove, 1):
+        icon = "📄" if item.get('type') == 'file' else "📁"
+        click.echo(f"  {i:3d}. {icon} {click.style(item['path'], fg='cyan')}: {item['size_human']}")
+    total_size = sum(item['size'] for item in items_to_remove)
+    click.echo(f"\n{click.style('💰 Łącznie do usunięcia:', fg='red', bold=True)} {_format_bytes(total_size)}")
+
+    if dry_run:
+        click.echo(click.style("\n[DRY-RUN] - symulacja, nic nie zostanie usunięte", fg="cyan"))
+        return
+    if not click.confirm(click.style("\n⚠️ Potwierdzasz usunięcie tych elementów?", fg="yellow"), default=False):
+        click.echo(click.style("⏭️ Anulowano.", fg="yellow"))
+        return
+
+    _remove_home_items(items_to_remove)