sifty 0.6.0__tar.gz

sifty-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amine Zouaoui
+
+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.

sifty-0.6.0/PKG-INFO

@@ -0,0 +1,254 @@
+Metadata-Version: 2.4
+Name: sifty
+Version: 0.6.0
+Summary: Sifty — an AI-assisted Windows maintenance CLI/TUI: sift junk, analyze disks, manage apps, updates and files. Recycle Bin only, dry-run by default.
+Author: Amine Zouaoui
+License: MIT
+Project-URL: Homepage, https://github.com/Vortrix5/sifty
+Project-URL: Repository, https://github.com/Vortrix5/sifty
+Project-URL: Issues, https://github.com/Vortrix5/sifty/issues
+Project-URL: Changelog, https://github.com/Vortrix5/sifty/blob/main/CHANGELOG.md
+Keywords: windows,maintenance,cleaner,junk,disk-usage,duplicates,uninstaller,winget,tui,textual,ollama
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.7
+Requires-Dist: psutil>=5.9
+Requires-Dist: send2trash>=1.8
+Requires-Dist: pywin32>=306; sys_platform == "win32"
+Requires-Dist: winshell>=0.6; sys_platform == "win32"
+Requires-Dist: windows-toasts>=1.1; sys_platform == "win32"
+Requires-Dist: httpx>=0.27
+Requires-Dist: textual>=0.60
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.12; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: textual-dev>=1.5; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Dynamic: license-file
+
+# Sifty
+
+> An AI-assisted Windows maintenance CLI + TUI that **sifts the junk from the keep**.
+
+![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)
+![Windows](https://img.shields.io/badge/platform-Windows%2010%2F11-0078d4)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+![CI](https://github.com/Vortrix5/sifty/actions/workflows/ci.yml/badge.svg)
+
+Clean junk, analyze disks, find duplicates, manage apps and startup programs,
+apply updates, prune dev artifacts and git worktrees, and organize files — from
+a scriptable CLI or a full-screen terminal UI. The optional AI assistant runs
+**locally** via [Ollama]: nothing leaves your machine, and it only ever sees
+file *metadata* (names, sizes, paths), never file contents.
+
+<!-- TODO: add a demo GIF of `sifty tui` here — it sells the project better
+     than anything below. `textual run --dev` + any screen recorder works. -->
+
+## Safety first
+
+Sifty deletes files and changes system state, so it is built to be hard to misuse:
+
+- **Dry-run by default** — every destructive command previews what it would do.
+  Real changes need an explicit `--apply`.
+- **Recycle Bin, never permanent delete** — all removals go through one
+  `trash()` function backed by Send2Trash. `sifty undo` restores the last clean.
+- **Protected paths** — `C:\Windows`, `Program Files`, `ProgramData`, the drive
+  root and your profile root are refused even with `--apply --yes`.
+- **Audit log** — every applied deletion is recorded in `%APPDATA%\sifty\audit.log`.
+- **The AI never deletes anything** — it is advisory; high-risk tool calls
+  always require your approval.
+
+## How it compares
+
+| Feature | Sifty | CCleaner | Revo Uninstaller | WinDirStat |
+| --- | --- | --- | --- | --- |
+| Junk / cache cleaning | ✅ 11+ categories | ✅ | ➖ | ❌ |
+| Disk usage analysis | ✅ top-N + volumes | ➖ | ❌ | ✅ treemap |
+| Duplicate finder | ✅ SHA-256, NTFS-aware | ✅ (paid) | ❌ | ❌ |
+| App uninstall + leftover scan | ✅ winget + leftovers | ✅ | ✅ + leftovers | ❌ |
+| App updates | ✅ via winget | ✅ (paid) | ❌ | ❌ |
+| Startup manager | ✅ reversible | ✅ | ✅ | ❌ |
+| Dev artifact purge (node_modules, …) | ✅ | ❌ | ❌ | ❌ |
+| Git worktree / WSL2 VHD cleanup | ✅ | ❌ | ❌ | ❌ |
+| Local AI assistant | ✅ Ollama | ❌ | ❌ | ❌ |
+| Scriptable (JSON output) | ✅ | ❌ | ❌ | ❌ |
+| Recycle Bin + undo for everything | ✅ | ➖ | ➖ | n/a |
+| Price | Free, MIT | Freemium | Freemium | Free |
+
+Sifty is built **developer-first**: everything is scriptable, the engine is a
+reusable Python library, and it cleans the things developer machines actually
+accumulate (build artifacts, orphaned worktrees, bloated WSL2 disks).
+
+## Install
+
+```powershell
+# from source (recommended while pre-PyPI)
+git clone https://github.com/Vortrix5/sifty && cd sifty
+pipx install --editable .      # or: pip install .
+
+sifty doctor                   # check admin rights, winget, Ollama
+```
+
+For development:
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
+.\.venv\Scripts\python.exe -m pytest -q
+```
+
+## Usage
+
+```powershell
+sifty checkup                # one read-only scan of everything: junk, updates,
+                             # orphans, stale files, disk space, startup
+sifty tui                    # the full-screen interactive app
+
+# Junk
+sifty junk scan              # show reclaimable space per category
+sifty junk clean             # preview removal (dry-run)
+sifty junk clean --apply     # send junk to the Recycle Bin (asks first)
+
+# Disk
+sifty disk volumes           # used/free/total per volume
+sifty disk analyze C:\Users  # biggest folders/files under a path
+sifty disk duplicates D:\    # find duplicate files and wasted space
+
+# Apps & updates
+sifty apps list --by-size    # installed apps, largest first
+sifty apps orphans           # broken uninstall entries in the registry
+sifty apps uninstall "App"   # uninstall via winget (preview, then --apply)
+sifty apps leftovers "App"   # what the uninstaller left behind (then --apply)
+sifty update check           # available updates (winget)
+sifty update apply           # upgrade everything (asks first)
+
+# Developer cleanup
+sifty purge clean            # node_modules, dist, __pycache__, target, …
+sifty cleanup duplicates D:\Photos   # de-duplicate (keeps one copy each)
+sifty cleanup large C:\Users\you     # biggest files under a path
+sifty cleanup stale --days 180       # old items in Downloads
+
+# Startup & services
+sifty startup list                   # startup programs (enabled/disabled)
+sifty startup disable "Spotify"      # reversible (sifty startup enable …)
+sifty services list                  # curated optional services + state
+sifty --admin services disable DiagTrack   # toggle one (needs admin)
+
+# History & undo
+sifty history                # what was cleaned + total space reclaimed
+sifty undo                   # restore the most recent clean from the Recycle Bin
+
+# Organize files
+sifty organize preview C:\Users\you\Downloads --by type
+sifty organize apply   C:\Users\you\Downloads --by date
+sifty organize undo          # put the last organize's files back
+
+# Configuration
+sifty config                 # all settings + which ones you've overridden
+sifty config set ai.model "llama3.2:3b"
+sifty config edit            # open config.toml in your editor
+
+# AI (requires Ollama running)
+sifty ai status
+sifty ai ask "what can I safely delete on my C drive?" --path C:\
+
+# Scripting — JSON output on read-only commands (auto-enabled when piped)
+sifty --json checkup
+sifty --json disk volumes
+sifty --json apps list --by-size
+```
+
+Some operations (Windows temp, update cache, certain uninstalls) need an
+**Administrator** terminal — `sifty doctor` tells you if you're elevated, and
+`sifty --admin <cmd>` relaunches elevated via UAC.
+
+## The TUI
+
+`sifty tui` opens a full-screen app with a seven-section sidebar — Home,
+Clean, Disk, Apps, Monitor, Reports, AI:
+
+- **Home** — volume gauges and a **Run checkup** button that scans everything
+  at once; findings come with buttons that fix them right there (clean junk,
+  clean stale downloads, apply updates — each behind a confirm).
+- **Clean** — Junk / Purge / Optimize / Smart cleanup under one roof (tabs).
+- **Apps** — Installed / Updates / Startup / Services, with fuzzy filter,
+  sorting, bulk uninstall, and an automatic leftover scan after uninstalling.
+- **AI** — an agentic chat: tool runs it proposes show **Run/Skip buttons
+  inline in the conversation**, and scan results carry follow-up action
+  buttons.
+
+Press **Ctrl+P** for the command palette (jump to any screen), **F2** to
+elevate, **Space** to mark rows for bulk actions. The **Reports** screen shows
+space reclaimed over time with an **Undo last clean** button.
+
+## AI setup (optional)
+
+1. Install [Ollama] and start it.
+2. Pull the configured model: `ollama pull qwen2.5:3b`.
+3. `sifty ai status` should report "running".
+
+Configure in `%APPDATA%\sifty\config.toml`:
+
+```toml
+[ai]
+host = "http://localhost:11434"
+model = "qwen2.5:3b"
+
+[safety]
+extra_protected_paths = ["D:\\Important"]
+
+[junk]
+include_downloads_installers = false
+```
+
+## Architecture
+
+Layered — thin frontends over a reusable engine, OS specifics quarantined:
+
+```text
+src/sifty/
+├── cli/               # Typer entry point + one thin command module per group
+├── tui/               # Textual full-screen app (views call core, not cli)
+├── core/              # the engine: junk, disk, apps, updates, cleanup,
+│   │                  # startup, services, organize, checkup, history, …
+│   └── safety.py      # ★ protected paths, dry-run guard, trash(), audit log
+├── windows/           # OS primitives: winget, registry, UAC, Recycle Bin, DISM
+├── ai/                # Ollama client, advisor prompts, agentic tool loop
+└── infra/             # TOML config + rotating diagnostics log
+```
+
+Frontends depend on `core`; `core` depends on `windows`/`infra`; nothing
+imports upward. A GUI could call the same engine functions (`junk.scan`,
+`disk.find_duplicates`, `checkup.run_checkup`) without a rewrite. See
+[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for the design rationale.
+
+## Tests
+
+```powershell
+.\.venv\Scripts\python.exe -m pytest -q    # 160+ tests, ~20 s
+```
+
+The safety guardrails are the most heavily tested code in the repo; the Windows
+environment is mocked so the suite also runs on CI. See
+[CONTRIBUTING.md](CONTRIBUTING.md) to get involved.
+
+## License
+
+[MIT](LICENSE) © Amine Zouaoui
+
+[Ollama]: https://ollama.com

sifty-0.6.0/README.md

@@ -0,0 +1,211 @@
+# Sifty
+
+> An AI-assisted Windows maintenance CLI + TUI that **sifts the junk from the keep**.
+
+![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)
+![Windows](https://img.shields.io/badge/platform-Windows%2010%2F11-0078d4)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+![CI](https://github.com/Vortrix5/sifty/actions/workflows/ci.yml/badge.svg)
+
+Clean junk, analyze disks, find duplicates, manage apps and startup programs,
+apply updates, prune dev artifacts and git worktrees, and organize files — from
+a scriptable CLI or a full-screen terminal UI. The optional AI assistant runs
+**locally** via [Ollama]: nothing leaves your machine, and it only ever sees
+file *metadata* (names, sizes, paths), never file contents.
+
+<!-- TODO: add a demo GIF of `sifty tui` here — it sells the project better
+     than anything below. `textual run --dev` + any screen recorder works. -->
+
+## Safety first
+
+Sifty deletes files and changes system state, so it is built to be hard to misuse:
+
+- **Dry-run by default** — every destructive command previews what it would do.
+  Real changes need an explicit `--apply`.
+- **Recycle Bin, never permanent delete** — all removals go through one
+  `trash()` function backed by Send2Trash. `sifty undo` restores the last clean.
+- **Protected paths** — `C:\Windows`, `Program Files`, `ProgramData`, the drive
+  root and your profile root are refused even with `--apply --yes`.
+- **Audit log** — every applied deletion is recorded in `%APPDATA%\sifty\audit.log`.
+- **The AI never deletes anything** — it is advisory; high-risk tool calls
+  always require your approval.
+
+## How it compares
+
+| Feature | Sifty | CCleaner | Revo Uninstaller | WinDirStat |
+| --- | --- | --- | --- | --- |
+| Junk / cache cleaning | ✅ 11+ categories | ✅ | ➖ | ❌ |
+| Disk usage analysis | ✅ top-N + volumes | ➖ | ❌ | ✅ treemap |
+| Duplicate finder | ✅ SHA-256, NTFS-aware | ✅ (paid) | ❌ | ❌ |
+| App uninstall + leftover scan | ✅ winget + leftovers | ✅ | ✅ + leftovers | ❌ |
+| App updates | ✅ via winget | ✅ (paid) | ❌ | ❌ |
+| Startup manager | ✅ reversible | ✅ | ✅ | ❌ |
+| Dev artifact purge (node_modules, …) | ✅ | ❌ | ❌ | ❌ |
+| Git worktree / WSL2 VHD cleanup | ✅ | ❌ | ❌ | ❌ |
+| Local AI assistant | ✅ Ollama | ❌ | ❌ | ❌ |
+| Scriptable (JSON output) | ✅ | ❌ | ❌ | ❌ |
+| Recycle Bin + undo for everything | ✅ | ➖ | ➖ | n/a |
+| Price | Free, MIT | Freemium | Freemium | Free |
+
+Sifty is built **developer-first**: everything is scriptable, the engine is a
+reusable Python library, and it cleans the things developer machines actually
+accumulate (build artifacts, orphaned worktrees, bloated WSL2 disks).
+
+## Install
+
+```powershell
+# from source (recommended while pre-PyPI)
+git clone https://github.com/Vortrix5/sifty && cd sifty
+pipx install --editable .      # or: pip install .
+
+sifty doctor                   # check admin rights, winget, Ollama
+```
+
+For development:
+
+```powershell
+python -m venv .venv
+.\.venv\Scripts\python.exe -m pip install -e ".[dev]"
+.\.venv\Scripts\python.exe -m pytest -q
+```
+
+## Usage
+
+```powershell
+sifty checkup                # one read-only scan of everything: junk, updates,
+                             # orphans, stale files, disk space, startup
+sifty tui                    # the full-screen interactive app
+
+# Junk
+sifty junk scan              # show reclaimable space per category
+sifty junk clean             # preview removal (dry-run)
+sifty junk clean --apply     # send junk to the Recycle Bin (asks first)
+
+# Disk
+sifty disk volumes           # used/free/total per volume
+sifty disk analyze C:\Users  # biggest folders/files under a path
+sifty disk duplicates D:\    # find duplicate files and wasted space
+
+# Apps & updates
+sifty apps list --by-size    # installed apps, largest first
+sifty apps orphans           # broken uninstall entries in the registry
+sifty apps uninstall "App"   # uninstall via winget (preview, then --apply)
+sifty apps leftovers "App"   # what the uninstaller left behind (then --apply)
+sifty update check           # available updates (winget)
+sifty update apply           # upgrade everything (asks first)
+
+# Developer cleanup
+sifty purge clean            # node_modules, dist, __pycache__, target, …
+sifty cleanup duplicates D:\Photos   # de-duplicate (keeps one copy each)
+sifty cleanup large C:\Users\you     # biggest files under a path
+sifty cleanup stale --days 180       # old items in Downloads
+
+# Startup & services
+sifty startup list                   # startup programs (enabled/disabled)
+sifty startup disable "Spotify"      # reversible (sifty startup enable …)
+sifty services list                  # curated optional services + state
+sifty --admin services disable DiagTrack   # toggle one (needs admin)
+
+# History & undo
+sifty history                # what was cleaned + total space reclaimed
+sifty undo                   # restore the most recent clean from the Recycle Bin
+
+# Organize files
+sifty organize preview C:\Users\you\Downloads --by type
+sifty organize apply   C:\Users\you\Downloads --by date
+sifty organize undo          # put the last organize's files back
+
+# Configuration
+sifty config                 # all settings + which ones you've overridden
+sifty config set ai.model "llama3.2:3b"
+sifty config edit            # open config.toml in your editor
+
+# AI (requires Ollama running)
+sifty ai status
+sifty ai ask "what can I safely delete on my C drive?" --path C:\
+
+# Scripting — JSON output on read-only commands (auto-enabled when piped)
+sifty --json checkup
+sifty --json disk volumes
+sifty --json apps list --by-size
+```
+
+Some operations (Windows temp, update cache, certain uninstalls) need an
+**Administrator** terminal — `sifty doctor` tells you if you're elevated, and
+`sifty --admin <cmd>` relaunches elevated via UAC.
+
+## The TUI
+
+`sifty tui` opens a full-screen app with a seven-section sidebar — Home,
+Clean, Disk, Apps, Monitor, Reports, AI:
+
+- **Home** — volume gauges and a **Run checkup** button that scans everything
+  at once; findings come with buttons that fix them right there (clean junk,
+  clean stale downloads, apply updates — each behind a confirm).
+- **Clean** — Junk / Purge / Optimize / Smart cleanup under one roof (tabs).
+- **Apps** — Installed / Updates / Startup / Services, with fuzzy filter,
+  sorting, bulk uninstall, and an automatic leftover scan after uninstalling.
+- **AI** — an agentic chat: tool runs it proposes show **Run/Skip buttons
+  inline in the conversation**, and scan results carry follow-up action
+  buttons.
+
+Press **Ctrl+P** for the command palette (jump to any screen), **F2** to
+elevate, **Space** to mark rows for bulk actions. The **Reports** screen shows
+space reclaimed over time with an **Undo last clean** button.
+
+## AI setup (optional)
+
+1. Install [Ollama] and start it.
+2. Pull the configured model: `ollama pull qwen2.5:3b`.
+3. `sifty ai status` should report "running".
+
+Configure in `%APPDATA%\sifty\config.toml`:
+
+```toml
+[ai]
+host = "http://localhost:11434"
+model = "qwen2.5:3b"
+
+[safety]
+extra_protected_paths = ["D:\\Important"]
+
+[junk]
+include_downloads_installers = false
+```
+
+## Architecture
+
+Layered — thin frontends over a reusable engine, OS specifics quarantined:
+
+```text
+src/sifty/
+├── cli/               # Typer entry point + one thin command module per group
+├── tui/               # Textual full-screen app (views call core, not cli)
+├── core/              # the engine: junk, disk, apps, updates, cleanup,
+│   │                  # startup, services, organize, checkup, history, …
+│   └── safety.py      # ★ protected paths, dry-run guard, trash(), audit log
+├── windows/           # OS primitives: winget, registry, UAC, Recycle Bin, DISM
+├── ai/                # Ollama client, advisor prompts, agentic tool loop
+└── infra/             # TOML config + rotating diagnostics log
+```
+
+Frontends depend on `core`; `core` depends on `windows`/`infra`; nothing
+imports upward. A GUI could call the same engine functions (`junk.scan`,
+`disk.find_duplicates`, `checkup.run_checkup`) without a rewrite. See
+[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for the design rationale.
+
+## Tests
+
+```powershell
+.\.venv\Scripts\python.exe -m pytest -q    # 160+ tests, ~20 s
+```
+
+The safety guardrails are the most heavily tested code in the repo; the Windows
+environment is mocked so the suite also runs on CI. See
+[CONTRIBUTING.md](CONTRIBUTING.md) to get involved.
+
+## License
+
+[MIT](LICENSE) © Amine Zouaoui
+
+[Ollama]: https://ollama.com

sifty-0.6.0/pyproject.toml

@@ -0,0 +1,82 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sifty"
+version = "0.6.0"
+description = "Sifty — an AI-assisted Windows maintenance CLI/TUI: sift junk, analyze disks, manage apps, updates and files. Recycle Bin only, dry-run by default."
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [{ name = "Amine Zouaoui" }]
+license = { text = "MIT" }
+keywords = [
+    "windows", "maintenance", "cleaner", "junk", "disk-usage", "duplicates",
+    "uninstaller", "winget", "tui", "textual", "ollama",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: System :: Systems Administration",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "typer>=0.12",
+    "rich>=13.7",
+    "psutil>=5.9",
+    "send2trash>=1.8",
+    "pywin32>=306; sys_platform == 'win32'",
+    "winshell>=0.6; sys_platform == 'win32'",
+    "windows-toasts>=1.1; sys_platform == 'win32'",
+    "httpx>=0.27",
+    "textual>=0.60",
+]
+
+[project.urls]
+Homepage = "https://github.com/Vortrix5/sifty"
+Repository = "https://github.com/Vortrix5/sifty"
+Issues = "https://github.com/Vortrix5/sifty/issues"
+Changelog = "https://github.com/Vortrix5/sifty/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-mock>=3.12",
+    "pytest-asyncio>=0.23",
+    "textual-dev>=1.5",
+    "ruff>=0.4",
+]
+
+[project.scripts]
+sifty = "sifty.cli.app:entrypoint"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+sifty = ["tui/*.tcss"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B"]
+ignore = [
+    "E501",  # line length is advisory; Rich markup strings run long
+    "B008",  # `typer.Option(...)` in defaults is Typer's standard idiom
+]

sifty-0.6.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sifty-0.6.0/src/sifty/__init__.py

@@ -0,0 +1,3 @@
+"""Sifty — an AI-assisted Windows maintenance CLI that sifts the junk from the keep."""
+
+__version__ = "0.6.0"

sifty-0.6.0/src/sifty/__main__.py

@@ -0,0 +1,6 @@
+"""Enable ``python -m sifty`` as an alternative to the ``sifty`` console script."""
+
+from .cli.app import entrypoint
+
+if __name__ == "__main__":
+    entrypoint()

sifty-0.6.0/src/sifty/ai/__init__.py

@@ -0,0 +1 @@
+"""Local AI layer (Ollama) — advises, never acts on its own."""

sifty-0.6.0/src/sifty/ai/advisor.py

@@ -0,0 +1,71 @@
+"""AI advisory prompts.
+
+The advisor only ever receives *metadata* — names, sizes, paths, extensions,
+counts — never file contents. It explains and recommends; it never deletes.
+The calling command does the acting, with the usual dry-run/confirm safeguards.
+"""
+
+from __future__ import annotations
+
+from .client import OllamaClient, OllamaUnavailable
+
+SYSTEM_PROMPT = (
+    "You are Sifty, a careful Windows maintenance assistant embedded in a CLI/TUI "
+    "tool. You are given only file/app metadata, never file contents. Be concise, "
+    "practical, and cautious; when unsure whether something is safe to remove, say so. "
+    "Format answers in Markdown.\n\n"
+    "To remove an installed program, ALWAYS recommend a proper uninstall — Sifty's own "
+    "`apps` command (which uses winget under the hood), `winget uninstall`, or Windows "
+    "Settings > Apps. NEVER tell the user to manually delete a program's folder under "
+    "C:\\Program Files, C:\\Program Files (x86), or to hand-edit files in C:\\Windows, "
+    "ProgramData, or their personal documents — Sifty refuses those paths anyway, and "
+    "manual deletion leaves the registry and the system in a broken state. Do not "
+    "suggest `DISM` or `sfc /scannow` unless the user explicitly reports system file "
+    "corruption; they are not part of uninstalling an app.\n\n"
+    "Sifty deletes safely (to the Recycle Bin, dry-run by default), so point users at "
+    "Sifty's commands rather than destructive manual steps."
+)
+
+# Back-compat alias for internal callers.
+_SYSTEM = SYSTEM_PROMPT
+
+
+def _safe(client: OllamaClient, user_prompt: str) -> str | None:
+    """Run a prompt, returning None if the AI is unavailable."""
+    if not client.is_available():
+        return None
+    try:
+        return client.chat(_SYSTEM, user_prompt)
+    except OllamaUnavailable:
+        return None
+
+
+def explain_item(client: OllamaClient, name: str, path: str, size_human: str) -> str | None:
+    """Explain what an item is and whether it's safe to remove."""
+    return _safe(
+        client,
+        f"What is this Windows item, and is it generally safe to delete?\n"
+        f"Name: {name}\nPath: {path}\nSize: {size_human}\n"
+        f"Answer in 2-3 sentences.",
+    )
+
+
+def summarize_disk(client: OllamaClient, items: list[tuple[str, str]], question: str) -> str | None:
+    """Answer a natural-language question about the biggest disk items."""
+    listing = "\n".join(f"- {name}: {size}" for name, size in items)
+    return _safe(
+        client,
+        f"Here are the largest items in a directory:\n{listing}\n\n"
+        f"User question: {question}\n"
+        f"Give a brief, practical answer and flag anything risky to delete.",
+    )
+
+
+def suggest_organization(client: OllamaClient, sample_names: list[str]) -> str | None:
+    """Propose a folder scheme for a messy directory from sample filenames."""
+    listing = "\n".join(f"- {n}" for n in sample_names[:40])
+    return _safe(
+        client,
+        f"These are sample filenames from a cluttered folder:\n{listing}\n\n"
+        f"Suggest a simple folder structure to organize them. Be concise.",
+    )