docs: sync v0.9.2 documentation to main

CHANGELOG.md

@@ -5,6 +5,36 @@ All notable changes to GRPM will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.9.2] - 2026-01-19
+
+### Emerge Installed Package Filtering
+
+Fixes inconsistency where `resolve` correctly filters installed packages but `emerge` showed full dependency tree.
+
+### Fixed
+- **emerge ignores installed packages** — `grpm emerge -p mc` now shows 1 package instead of 93 (#61)
+
+### Added
+- **Portage-compatible flags for emerge**:
+  - `--deep`, `-D` — Traverse dependencies of already-installed packages
+  - `--with-bdeps` — Include build-time dependencies for installed packages
+  - `--emptytree`, `-e` — Assume no packages installed (full dependency tree)
+  - `--vardb` — Custom path to installed packages database
+
+### Example
+```bash
+# Show only packages to install (default, Portage-compatible)
+grpm emerge -p mc                    # 1 package
+
+# Show full dependency tree
+grpm emerge -e -p mc                 # 93 packages
+
+# Deep update with build deps
+grpm emerge -D --with-bdeps @world
+```
+
+---
+
 ## [0.9.1] - 2026-01-19
 
 ### Enterprise CLI, Dependency Filtering & Mirror Fallback

docs/CLI_REFERENCE.md

@@ -216,6 +216,7 @@ grpm emerge [options] <package|@set>...
 | `--distdir <path>` | Directory for source tarballs | `/var/cache/distfiles` |
 | `--tmpdir <path>` | Temporary build directory | `/var/tmp/portage` |
 | `--root <path>` | Install to alternative root (chroot, stage tarball) | `/` |
+| `--vardb <path>` | Path to installed packages database | `/var/db/pkg` |
 | `--mock` | Use mock repository for testing | `false` |
 | `--pretend`, `-p` | Show build plan without building | `false` |
 | `--ask`, `-a` | Ask for confirmation before building | `false` |
@@ -224,6 +225,9 @@ grpm emerge [options] <package|@set>...
 | `--test` | Run test phase (make check/test) | `false` |
 | `--onlydeps`, `-o` | Build dependencies only, skip target | `false` |
 | `--check-tools` | Perform optional pre-build tool availability check | `false` |
+| `--deep`, `-D` | Traverse dependencies of already-installed packages | `false` |
+| `--with-bdeps` | Include build-time dependencies for installed packages | `false` |
+| `--emptytree`, `-e` | Assume no packages installed (full dependency tree) | `false` |
 
 **Build Phases:**
 
@@ -264,6 +268,12 @@ sudo grpm emerge --root /mnt/gentoo app-misc/hello
 
 # Build dependencies only (Docker layer caching)
 sudo grpm emerge --onlydeps app-misc/hello
+
+# Show full dependency tree (emptytree mode)
+grpm emerge -e -p app-misc/mc
+
+# Deep update - traverse installed package dependencies
+sudo grpm emerge -D @world
 ```
 
 **Work Directory Structure:**