Replace --skip-system-scope with --skip-os-packages

Author: davidkopp

docs/guides/troubleshooting.md

@@ -208,7 +208,7 @@ python3 -m dependency_resolver host --debug
 # Docker analysis with debug
 python3 -m dependency_resolver docker container_name --debug
 
-# Skip system scope for faster testing
+# Skip OS Packages for faster testing
 python3 -m dependency_resolver --skip-os-packages --debug
 
 # Test specific working directory

performance-analysis/README.md

@@ -112,7 +112,7 @@ The detector-specific benchmark scripts are located in the `detectors/` subdirec
 
 Profiles dependency resolution on the host system with interface selection support:
 
-- Skip system scope (fast, ~40 packages)
+- Skip OS Packages (fast, ~40 packages)
 - Full system scan (slow, ~2700 packages)
 - CLI and programmatic interface support
 - System information collection (CPU, memory, versions)

performance-analysis/detector-benchmarks.sh

@@ -84,7 +84,7 @@ show_usage() {
     echo "OPTIONS:"
     echo "  -h, --help     Show this help message"
     echo "  --clean        Clean existing profiles before running"
-    echo "  --skip-system-check    Skip system dependency checks"
+    echo "  --skip-os-packages    Skip os packages checks"
     echo "  --skip-hash-collection Skip hash collection for faster execution"
     echo "  --profiling    Enable detailed profiling (slower, for analysis)"
     echo "  --interface TYPE       Interface type: 'cli' or 'programmatic' (default: cli)"
@@ -113,7 +113,7 @@ show_usage() {
 DETECTOR_TYPE="all"
 SPECIFIC_SCENARIO="all"
 CLEAN_PROFILES=false
-SKIP_SYSTEM_CHECK=false
+SKIP_OS_PACKAGES_CHECK=false
 SKIP_HASH_COLLECTION=false
 ENABLE_PROFILING=false
 INTERFACE="cli"
@@ -129,8 +129,8 @@ while [[ $# -gt 0 ]]; do
             CLEAN_PROFILES=true
             shift
             ;;
-        --skip-system-check)
-            SKIP_SYSTEM_CHECK=true
+        --skip-os-packages)
+            SKIP_OS_PACKAGES_CHECK=true
             shift
             ;;
         --skip-hash-collection)
@@ -384,7 +384,7 @@ main() {
     echo "Profiling enabled: ${ENABLE_PROFILING}"
     echo ""
 
-    if [[ "$SKIP_SYSTEM_CHECK" == false ]]; then
+    if [[ "$SKIP_OS_PACKAGES_CHECK" == false ]]; then
         check_prerequisites
     fi
 

performance-analysis/detectors/host-benchmarks.sh

@@ -69,15 +69,15 @@ fi
 case $SCENARIO_TYPE in
     "skip-system")
         if [[ "$INTERFACE" == "cli" ]]; then
-            cmd="cd '$PROJECT_ROOT' && python3 -m dependency_resolver host --skip-system-scope"
+            cmd="cd '$PROJECT_ROOT' && python3 -m dependency_resolver host --skip-os-packages"
             [[ -n "$HASH_FLAG" ]] && cmd="$cmd $HASH_FLAG"
             [[ -n "$SELECT_FLAG" ]] && cmd="$cmd $SELECT_FLAG"
-            host_benchmark_scenario "Host Skip System Scope ($INTERFACE)" \
+            host_benchmark_scenario "Host Skip OS Packages ($INTERFACE)" \
                 "$cmd" \
                 30
         else
-            host_benchmark_scenario "Host Skip System Scope ($INTERFACE)" \
-                "cd '$PROJECT_ROOT' && python3 -c 'import dependency_resolver; print(dependency_resolver.resolve_host_dependencies(skip_system_scope=True$HASH_ARG$SELECT_ARG))'" \
+            host_benchmark_scenario "Host Skip OS Packages ($INTERFACE)" \
+                "cd '$PROJECT_ROOT' && python3 -c 'import dependency_resolver; print(dependency_resolver.resolve_host_dependencies(skip_os_packages=True$HASH_ARG$SELECT_ARG))'" \
                 30
         fi
         ;;
@@ -97,10 +97,10 @@ case $SCENARIO_TYPE in
         ;;
     "all")
         if [[ "$INTERFACE" == "cli" ]]; then
-            cmd1="cd '$PROJECT_ROOT' && python3 -m dependency_resolver host --skip-system-scope"
+            cmd1="cd '$PROJECT_ROOT' && python3 -m dependency_resolver host --skip-os-packages"
             [[ -n "$HASH_FLAG" ]] && cmd1="$cmd1 $HASH_FLAG"
             [[ -n "$SELECT_FLAG" ]] && cmd1="$cmd1 $SELECT_FLAG"
-            host_benchmark_scenario "Host Skip System Scope ($INTERFACE)" \
+            host_benchmark_scenario "Host Skip OS Packages ($INTERFACE)" \
                 "$cmd1" \
                 30
 
@@ -112,8 +112,8 @@ case $SCENARIO_TYPE in
                 60
         else
             # Programmatic interface
-            host_benchmark_scenario "Host Skip System Scope ($INTERFACE)" \
-                "cd '$PROJECT_ROOT' && python3 -c 'import dependency_resolver; print(dependency_resolver.resolve_host_dependencies(skip_system_scope=True$HASH_ARG$SELECT_ARG))'" \
+            host_benchmark_scenario "Host Skip OS Packages ($INTERFACE)" \
+                "cd '$PROJECT_ROOT' && python3 -c 'import dependency_resolver; print(dependency_resolver.resolve_host_dependencies(skip_os_packages=True$HASH_ARG$SELECT_ARG))'" \
                 30
 
             host_benchmark_scenario "Host Full System ($INTERFACE)" \

performance-analysis/performance-optimization-analysis.md

@@ -17,7 +17,7 @@ Performance profiling using py-spy identified significant optimization opportuni
 - **Tool**: py-spy v0.4.1 with flame graph generation
 - **Environment**: Ubuntu 24.04 host system
 - **Test Cases**:
-  - Host with pip only (`--skip-system-scope`): 39 packages
+  - Host with pip only (`--skip-os-packages`): 39 packages
   - Host with full system: 2700+ dpkg packages
 
 ### Performance Measurements
@@ -26,7 +26,7 @@ Performance profiling using py-spy identified significant optimization opportuni
 
 | Configuration | Execution Time | Package Count | Primary Detector |
 |---------------|----------------|---------------|------------------|
-| `host --skip-system-scope` | **1.942s** | 39 pip packages | PipDetector |
+| `host --skip-os-packages` | **1.942s** | 39 pip packages | PipDetector |
 | `host` (full system) | **~20+ seconds** | 2700+ dpkg packages | DpkgDetector |
 
 #### Docker Environment
@@ -365,7 +365,7 @@ This implementation successfully achieves the predicted performance improvements
 
 | Configuration | Current Time | Package Count | Improvement vs Original |
 |---------------|--------------|---------------|------------------------|
-| `host --skip-system-scope` | **1.507s** | 39 pip packages | **22.4% faster** (vs 1.942s) |
+| `host --skip-os-packages` | **1.507s** | 39 pip packages | **22.4% faster** (vs 1.942s) |
 | `host` (full system) | **2.161s** | 870 dpkg packages | **~90% faster** (vs ~20+ seconds) |
 
 #### Package Manager Specific Performance (2025-08-18 Measurements)