feat: enhance monorepo support with multiple --sub-path options

- Add support for multiple --sub-path arguments to scan different directories within a single workspace
- Require --workspace-name when using --sub-path for proper workspace identification
- Optimize base_paths parameter to pass target_path for simplified SDK integration
- Update argument validation to enforce sub_paths and workspace_name pairing
- Add comprehensive README documentation with monorepo examples and usage patterns
- Include GitHub Actions workflow examples for monorepo CI/CD scenarios
- Extend parameter table with detailed descriptions of new CLI options

This enhancement enables scanning multiple directories (e.g., frontend, backend, services/api)
as a single workspace while preserving git context from the repository root, making it ideal
for organizations with monorepo structures.

Author: dacoburn

pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "socketsecurity"
-version = "2.2.10"
+version = "2.2.11"
 requires-python = ">= 3.10"
 license = {"file" = "LICENSE"}
 dependencies = [

socketsecurity/__init__.py

@@ -1,2 +1,2 @@
 __author__ = 'socket.dev'
-__version__ = '2.2.10'
+__version__ = '2.2.11'

socketsecurity/socketcli.py

@@ -149,7 +149,7 @@ def main_code():
 
     # Calculate the scan paths - combine target_path with sub_paths if provided
     scan_paths = []
-    base_paths = []
+    base_paths = [config.target_path]  # Always use target_path as the single base path
 
     if config.sub_paths:
         import os
@@ -160,11 +160,9 @@ def main_code():
             if not os.path.exists(full_scan_path):
                 raise Exception(f"Sub-path does not exist: {full_scan_path}")
             scan_paths.append(full_scan_path)
-            base_paths.append(sub_path)
     else:
         # Use the target path as the single scan path
         scan_paths = [config.target_path]
-        base_paths = ["."]
 
     # Modify repository name if workspace_name is provided
     if config.workspace_name and config.repo: