npm - @ngocsangairvds/vsaf - Versions diffs - 3.2.14 → 3.2.16 - Mend

@ngocsangairvds/vsaf 3.2.14 → 3.2.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1442) hide show

package/tools/vds-scripts/lsp_orchestrator/COMMANDS.md DELETED Viewed

@@ -1,870 +0,0 @@
-# VDS LSP Orchestrator - Complete Command Reference
-Complete reference for all `vds-lsp` CLI commands with examples and options.
-## Global Options
-| Option | Short | Description |
-|--------|-------|-------------|
-| `--version` | `-V` | Show version and exit |
-| `--json-only` | `-j` | Output clean JSON only (automation-friendly) |
-| `--quiet` | `-q` | Suppress non-essential output |
-| `--verbose` | `-v` | Enable verbose output |
-| `--no-color` | | Disable colored output |
-| `--color` | | Force colored output |
-| `--output PATH` | `-o` | Write JSON output to a file |
-| `--include PATTERN` | `-i` | Only include files matching glob patterns |
-| `--exclude PATTERN` | `-x` | Exclude files matching glob patterns |
-| `--git-tracked` | | Restrict to git-tracked files only |
-| `--lsp-server CMD` | | Override LSP server command |
-| `--config-file FILE` | | Override pyright config file |
-| `--wsl-optimize/--no-wsl-optimize` | | Enable WSL2 filesystem optimization (Phase 11) |
-| `--docker` | | Run LSP server in Docker container (Phase 11) |
----
-## Commands
-### Navigation Commands
-#### `symbol` - Search for symbols
-Search workspace for symbols (classes, functions, variables) using tree-sitter AST parsing.
-```bash
-vds-lsp symbol QUERY [OPTIONS]
-```
-**Options:**
-- `--match {exact,fuzzy,regex}` - Match strategy (default: fuzzy)
-- `--limit N` - Maximum results (default: 20)
-- `--kind KIND` - Filter by symbol kind (Class, Function, Method, Variable)
-- `--container NAME` - Filter by container name
-**Examples:**
-```bash
-# Find all symbols named "DaemonManager"
-vds-lsp symbol "DaemonManager"
-# Fuzzy search for HTTP-related symbols
-vds-lsp symbol "http" --match fuzzy --limit 50
-# Regex search for test functions
-vds-lsp symbol "test_.*" --match regex
-# Find only classes
-vds-lsp symbol "Manager" --kind Class
-# JSON output for scripting
-vds-lsp --json-only symbol "Client" --limit 10
-```
-**Output:**
-```json
-{
-  "symbols": [
-    {
-      "name": "DaemonManager",
-      "kind": "Class",
-      "location": {"file": "...", "line": 29, "column": 7},
-      "container_name": null
-    }
-  ],
-  "meta": {...}
-}
-```
----
-#### `goto` - Go to definition
-Navigate to the definition of a symbol at a given location.
-```bash
-vds-lsp goto --file PATH:LINE:COL SYMBOL
-```
-**Options:**
-- `--file LOCATION` | `-f` - File location (format: `path:line:col`)
-**Examples:**
-```bash
-# Find definition of 'start' method
-vds-lsp goto --file "src/daemon.py:100:20" start
-# Short form
-vds-lsp goto -f "src/client.py:50:1" send_request
-# JSON output
-vds-lsp --json-only goto -f "src/core.py:25:1" build_router
-```
-**Important:** Always use `--file` flag. Omitting it treats the argument as a symbol name for AST search.
----
-#### `refs` - Find references
-Find all references to a symbol in the workspace.
-```bash
-vds-lsp refs --file PATH:LINE:COL [OPTIONS]
-```
-**Options:**
-- `--file LOCATION` | `-f` - File location (required)
-- `--context N` - Number of context lines (default: 2)
-**Examples:**
-```bash
-# Find all references
-vds-lsp refs --file "src/daemon.py:29:7" DaemonManager
-# With more context
-vds-lsp refs -f "src/client.py:20:1" send_request --context 5
-# JSON output
-vds-lsp --json-only refs -f "src/core.py:10:1" validate
-```
----
-#### `implementations` - Go to implementations
-Find all implementations of an interface or abstract class.
-```bash
-vds-lsp implementations --file PATH:LINE:COL
-```
-**Examples:**
-```bash
-vds-lsp implementations --file "src/interfaces.py:10:1" MyInterface
-```
----
-#### `highlight` - Highlight references
-Highlight all references to the symbol at the given location in the current file.
-```bash
-vds-lsp highlight --file PATH:LINE:COL
-```
-**Examples:**
-```bash
-vds-lsp highlight --file "src/daemon.py:77:1" is_running
-```
----
-#### `doc-links` - Find document links
-Find all clickable links in a document (URLs, imports, file references).
-```bash
-vds-lsp doc-links PATH
-```
-**What it detects:**
-- URLs (http/https) in comments and strings
-- Import statements that resolve to workspace files
-- Relative file paths in strings
-**Examples:**
-```bash
-# Find all links in a file
-vds-lsp doc-links src/app.py
-# JSON output
-vds-lsp --json-only doc-links src/app.py
-```
-**Output:**
-```
-┏━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
-┃ Line   ┃ Start Col ┃ End Col   ┃ Target                                  ┃ Kind                                   ┃
-┡━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
-│ 10     │ 0         │ 30        │ https://example.com                     ┃ import                                 │
-│ 25     │ 4         │ 20        │ src/utils.py                            ┃ file                                   │
-└────────┴───────────┴───────────┴─────────────────────────────────────────┴────────────────────────────────────────┘
-```
----
-#### `callers` - Find incoming calls
-Find all functions that call the given function (call hierarchy incoming).
-```bash
-vds-lsp callers SYMBOL [OPTIONS]
-```
-**Options:**
-- `--max-depth N` - Maximum depth (default: 1)
-- `--show-path` | `-p` - Show full call path
-- `--include-external` | `-e` - Include external library calls
-- `--format {tree,mermaid,json}` - Output format
-**Examples:**
-```bash
-# Find direct callers
-vds-lsp callers "DaemonManager.start"
-# With depth and paths
-vds-lsp callers "process_request" --max-depth 2 --show-path
-# Include external calls
-vds-lsp callers "validate" --include-external
-# Export as Mermaid diagram
-vds-lsp callers "handle_request" --format mermaid --output callgraph.mmd
-```
----
-#### `callees` - Find outgoing calls
-Find all functions called by the given function (call hierarchy outgoing).
-```bash
-vds-lsp callees SYMBOL [OPTIONS]
-```
-**Options:** Same as `callers`
-**Examples:**
-```bash
-# Find direct callees
-vds-lsp callees "DaemonManager.start"
-# With depth
-vds-lsp callees "main" --max-depth 3 --show-path
-```
----
-### Language Service Commands
-#### `hover` - Get hover information
-Display type information and documentation for a symbol.
-```bash
-vds-lsp hover PATH:LINE:COL
-```
-**Examples:**
-```bash
-# Get hover info
-vds-lsp hover src/daemon.py:29:7
-# JSON output
-vds-lsp --json-only hover src/core.py:50:1
-```
----
-#### `completion` - Get completions
-Get code completions at a given position.
-```bash
-vds-lsp completion PATH:LINE:COL
-```
-**Examples:**
-```bash
-vds-lsp completion src/daemon.py:77:15
-# JSON for scripting
-vds-lsp --json-only completion src/client.py:100:1
-```
----
-#### `signature-help` - Get signature help
-Display function signature information with parameter documentation.
-```bash
-vds-lsp signature-help PATH:LINE:COL
-```
-**Examples:**
-```bash
-vds-lsp signature-help src/daemon.py:77:15
-```
----
-#### `rename` - Rename symbol
-Rename a symbol across the entire workspace.
-```bash
-vds-lsp rename PATH:LINE:COL NEW_NAME [OPTIONS]
-```
-**Options:**
-- `--apply` | `-a` - Apply the rename (preview without)
-- `--yes` | `-y` - Skip confirmation
-**Examples:**
-```bash
-# Preview rename
-vds-lsp rename src/daemon.py:29:7 DaemonOrchestrator
-# Apply rename
-vds-lsp rename src/client.py:20:1 send_message --apply --yes
-```
----
-#### `suggest-imports` - Get import suggestions
-Get import suggestions for a location using BasedPyright auto-import.
-```bash
-vds-lsp suggest-imports PATH:LINE:COL [OPTIONS]
-```
-**Options:**
-- `--apply` | `-a` - Apply the first import suggestion
-- `--yes` | `-y` - Skip confirmation
-**Examples:**
-```bash
-# Get suggestions for undefined symbol
-vds-lsp suggest-imports src/app.py:10:5
-# Apply first suggestion
-vds-lsp suggest-imports src/app.py:10:5 --apply --yes
-# JSON output
-vds-lsp --json-only suggest-imports src/app.py:10:5
-```
-**Output:**
-```
-┏━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
-┃ # ┃ Suggestion                                ┃ Kind                         ┃ Preview                                 ┃
-┡━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
-│ 1 │ from typing import List                   ┃ import                       ┃ from typing import List                 │
-│ 2 │ from collections import defaultdict       ┃ import                       ┃ from collections import defaultdict   │
-└───┴──────────────────────────────────────────┴──────────────────────────────┴─────────────────────────────────────────┘
-```
----
-#### `ignore-comment` - Add type ignore comment
-Add a `# type: ignore` comment to suppress a diagnostic (BasedPyright).
-```bash
-vds-lsp ignore-comment PATH:LINE:COL [OPTIONS]
-```
-**Options:**
-- `--error-code` | `-e` - Specific error code to ignore (e.g., `reportOptionalMemberAccess`)
-- `--apply` | `-a` - Apply the type ignore comment
-- `--yes` | `-y` - Skip confirmation
-- `--confirm-annotations` - Allow edits that require change annotations
-**Examples:**
-```bash
-# Preview ignore comment
-vds-lsp ignore-comment src/app.py:10:5
-# Ignore specific error code
-vds-lsp ignore-comment src/app.py:10:5 --error-code reportOptionalMemberAccess
-# Apply the comment
-vds-lsp ignore-comment src/app.py:10:5 --apply --yes
-# JSON output
-vds-lsp --json-only ignore-comment src/app.py:10:5
-```
-**Output (preview):**
-```
-File: src/app.py
-Action: Suppress diagnostic (reportOptionalMemberAccess)
-Diff:
--         result = value.method()
-+         result = value.method()  # type: ignore[reportOptionalMemberAccess]
-Use --apply to add the ignore comment.
-```
----
-#### `inlay-hints` - Get inlay hints
-Display BasedPyright inlay hints (type annotations, parameter names).
-```bash
-vds-lsp inlay-hints PATH [OPTIONS]
-```
-**Options:**
-- `--variable-types` | `-vt` - Show variable type hints (default: true)
-- `--function-return-types` | `-fr` - Show function return types (default: true)
-- `--call-argument-names` | `-ca` - Show call argument names (default: true)
-- `--generic-types` | `-gt` - Show generic types (default: true)
-**Examples:**
-```bash
-vds-lsp inlay-hints src/daemon.py
-vds-lsp inlay-hints src/core.py --generic-types false
-```
----
-#### `semantic-tokens` - Get semantic tokens
-Display semantic tokens (syntax highlighting with semantic awareness).
-```bash
-vds-lsp semantic-tokens PATH
-```
-**Examples:**
-```bash
-vds-lsp semantic-tokens src/daemon.py
-# JSON output for tools
-vds-lsp --json-only semantic-tokens src/core.py
-```
----
-### Diagnostic Commands
-#### `diagnostics` - Get diagnostics
-Display diagnostics (errors, warnings, info) for specified files.
-```bash
-vds-lsp diagnostics PATHS [OPTIONS]
-```
-**Options:**
-- `--severity {error,warning,info}` - Filter by severity
-- `--code CODE` - Filter by diagnostic code
-- `--file PATTERN` - Filter by file pattern
-- `--fixable` - Only show fixable diagnostics
-- `--max-fixable N` - Maximum fixable to show
-- `--watch` - Watch mode for continuous updates
-- `--interval N` - Watch interval in seconds (default: 2)
-**Examples:**
-```bash
-# All diagnostics
-vds-lsp diagnostics src/
-# Only errors
-vds-lsp diagnostics src/ --severity error
-# Specific diagnostic code
-vds-lsp diagnostics . --code E501
-# Only fixable
-vds-lsp diagnostics src/ --fixable
-# Watch mode
-vds-lsp diagnostics src/ --watch
-# JSON output
-vds-lsp --json-only diagnostics src/
-```
----
-#### `type-check` - Run type checking
-Run BasedPyright type checking on specified paths.
-```bash
-vds-lsp type-check PATHS [OPTIONS]
-```
-**Options:**
-- `--mode {basic,standard,strict}` - Type checking mode (default: standard)
-- `--output FORMAT` - Output format (json, text)
-**Examples:**
-```bash
-vds-lsp type-check src/
-vds-lsp type-check . --mode strict
-vds-lsp type-check src/ --output json
-```
----
-#### `fix-errors` - Auto-fix errors
-Apply automatic fixes for diagnostics.
-```bash
-vds-lsp fix-errors PATHS [OPTIONS]
-```
-**Options:**
-- `--apply` | `-a` - Apply fixes (preview without)
-- `--yes` | `-y` - Skip confirmation
-- `--kinds KINDS` - Comma-separated action kinds
-- `--confirm-annotations` - Confirm before adding type annotations
-- `--patch-file PATH` - Save fixes as patch file
-**Examples:**
-```bash
-# Preview fixes
-vds-lsp fix-errors src/
-# Apply quick fixes
-vds-lsp fix-errors src/ --apply --yes --kinds quickfix
-# Organize imports
-vds-lsp fix-errors src/ --apply --kinds source.organizeImports
-# Create patch file
-vds-lsp fix-errors src/ --patch-file /tmp/fixes.patch
-```
----
-#### `code-actions` - Get code actions
-List available code actions for a location.
-```bash
-vds-lsp code-actions PATH:LINE:COL [OPTIONS]
-```
-**Options:**
-- `--index N` | `-i` - Select action by index
-- `--apply` | `-a` - Apply the selected action
-- `--yes` | `-y` - Skip confirmation
-- `--patch-file PATH` - Save as patch file
-**Examples:**
-```bash
-# List actions
-vds-lsp code-actions src/daemon.py:29:7
-# Apply action by index
-vds-lsp code-actions src/daemon.py:29:7 --index 1 --apply --yes
-```
----
-### Refactoring Commands
-#### `format` - Format document
-Format a file or range using Ruff LSP.
-```bash
-vds-lsp format PATH [OPTIONS]
-```
-**Options:**
-- `--apply` | `-a` - Apply formatting (preview without)
-- `--yes` | `-y` - Skip confirmation
-- `--range LINE:COL-END_LINE:END_COL` - Format specific range
-**Examples:**
-```bash
-# Preview formatting
-vds-lsp format src/daemon.py
-# Apply formatting
-vds-lsp format src/daemon.py --apply --yes
-# Format range
-vds-lsp format src/daemon.py --range 1:1-50:1 --apply
-```
----
-#### `organize-imports` - Organize imports
-Organize imports via Ruff LSP code actions.
-```bash
-vds-lsp organize-imports PATH [OPTIONS]
-```
-**Options:** Same as `format`
-**Examples:**
-```bash
-vds-lsp organize-imports src/daemon.py --apply --yes
-```
----
-#### `fix-all` - Apply fix-all
-Apply all auto-fixable actions via Ruff LSP.
-```bash
-vds-lsp fix-all PATH [OPTIONS]
-```
-**Options:** Same as `format`
-**Examples:**
-```bash
-vds-lsp fix-all src/daemon.py --apply --yes
-```
----
-### Batch Operations
-#### `batch-format` - Batch format multiple files
-Format multiple Python files.
-```bash
-vds-lsp batch-format PATHS [OPTIONS]
-```
-**Options:**
-- `--apply` | `-a` - Apply formatting
-- `--yes` | `-y` - Skip confirmation
-- `--atomic` | `-A` - Atomic mode (stop on first error)
-- `--include PATTERN` | `-i` - Include pattern
-- `--exclude PATTERN` | `-x` - Exclude pattern
-- `--parallel/--no-parallel` - Process files in parallel (default: True)
-- `--jobs N` | `-j` - Number of parallel jobs (default: auto-detect)
-- `--max-previews N` - Limit number of preview diffs (default: 5)
-**Examples:**
-```bash
-vds-lsp batch-format . --apply --atomic
-vds-lsp batch-format . --include "src/**" --exclude "tests/**" --apply
-# Phase 10: Parallel processing
-vds-lsp batch-format . --apply --parallel --jobs 8
-vds-lsp batch-format . --apply --no-parallel  # Sequential processing
-```
----
-#### `batch-organize-imports` - Batch organize imports
-Organize imports across multiple files.
-```bash
-vds-lsp batch-organize-imports PATHS [OPTIONS]
-```
-**Options:** Same as `batch-format` (including `--parallel`, `--jobs`)
-**Examples:**
-```bash
-vds-lsp batch-organize-imports . --apply --atomic
-vds-lsp batch-organize-imports . --apply --parallel --jobs 4
-```
----
-#### `batch-fix-all` - Batch fix-all
-Apply fix-all across multiple files.
-```bash
-vds-lsp batch-fix-all PATHS [OPTIONS]
-```
-**Options:** Same as `batch-format` (including `--parallel`, `--jobs`)
-**Examples:**
-```bash
-vds-lsp batch-fix-all . --apply --atomic
-vds-lsp batch-fix-all . --apply --parallel --jobs 6
-```
----
-### Utility Commands
-#### `doc-symbols` - Get document symbols
-List all symbols in a file (classes, functions, methods).
-```bash
-vds-lsp doc-symbols PATH
-```
-**Examples:**
-```bash
-vds-lsp doc-symbols src/daemon.py
-# JSON output
-vds-lsp --json-only doc-symbols src/daemon.py
-```
----
-#### `index-workspace` - Index workspace
-Generate and optionally save workspace index.
-```bash
-vds-lsp index-workspace [OPTIONS]
-```
-**Options:**
-- `--output PATH` | `-o` - Save index to file
-**Examples:**
-```bash
-vds-lsp index-workspace
-vds-lsp index-workspace --output workspace-index.json
-```
----
-#### `health` - Health check
-Report LSP server health status.
-```bash
-vds-lsp health
-```
-**Examples:**
-```bash
-vds-lsp health
-vds-lsp --json-only health
-```
----
-#### `rollback` - Rollback fixes
-Rollback applied fixes from a backup directory.
-```bash
-vds-lsp rollback BACKUP_DIR
-```
-**Examples:**
-```bash
-vds-lsp rollback .vds-lsp/backups/20260208-120000
-```
----
-### Daemon Management
-#### `daemon` - Manage LSP daemon
-Manage the persistent LSP daemon process.
-```bash
-vds-lsp daemon COMMAND [OPTIONS]
-```
-**Commands:**
-**`start`** - Start the daemon
-```bash
-vds-lsp daemon start [OPTIONS]
-```
-Options:
-- `--idle-timeout N` - Auto-shutdown after N seconds of inactivity (default: 300)
-- `--max-clients N` | `-m` - Maximum concurrent clients (default: 10)
-- `--hot-reload/--no-hot-reload` - Enable/disable config hot reload (default: enabled)
-**`stop`** - Stop the daemon
-```bash
-vds-lsp daemon stop
-```
-**`restart`** - Restart the daemon
-```bash
-vds-lsp daemon restart [OPTIONS]
-```
-Options: Same as `start`
-**`status`** - Show daemon status
-```bash
-vds-lsp daemon status
-```
-**Examples:**
-```bash
-# Start with default settings
-vds-lsp daemon start
-# Start with 10-minute idle timeout
-vds-lsp daemon start --idle-timeout 600
-# Phase 10: Allow more concurrent clients
-vds-lsp daemon start --max-clients 20
-# Phase 10: Disable hot reload
-vds-lsp daemon start --no-hot-reload
-# Check status
-vds-lsp daemon status
-# Restart with custom settings
-vds-lsp daemon restart --idle-timeout 600 --max-clients 20
-# Stop
-vds-lsp daemon stop
-```
-**Status Output:**
-```
-┏━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
-┃ Property  ┃ Value                                                            ┃
-┡━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
-│ Running   │ Yes                                                              │
-│ PID       │ 56158                                                            │
-│ Socket    │ /tmp/vds-lsp-daemon/vds-lsp-f1a67163077cb984.sock                │
-│ Uptime    │ 0:05:23                                                          │
-│ Clients   │ 1                                                                │
-│ Workspace │ /path/to/workspace                                               │
-└───────────┴───────────────────────────────────────────────────────────────────┘
-```
----
-## Exit Codes
-| Code | Meaning |
-|------|---------|
-| 0 | Success |
-| 1 | General error |
-| 2 | CLI usage error |
-| 124 | Timeout |
-| 130 | Interrupted (Ctrl+C) |
-## JSON Output Format
-All commands support `--json-only` for structured output:
-```json
-{
-  "result": {...},
-  "error": null,
-  "message": "OK",
-  "meta": {
-    "timestamp": "2026-02-08T07:40:29.665266+00:00",
-    "tool": {
-      "name": "vds-lsp-orchestrator",
-      "version": "0.1.0"
-    },
-    "python": "3.14.3"
-  }
-}
-```