@ngocsangairvds/vsaf 4.1.14 → 4.1.16

package/skills/vds-skill/runtime/grafana_orchestrator/README.md

@@ -76,13 +76,13 @@ VDS_QUICKWIT_INDEX=otel-logs-v0_7
 
 ```bash
 # Check connectivity
-./scripts/worktree_uv.sh run --project grafana_orchestrator ./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana health
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana health
 
 # List available datasources
-./scripts/worktree_uv.sh run --project grafana_orchestrator ./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana datasources
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana datasources
 
 # List available indexes
-./scripts/worktree_uv.sh run --project grafana_orchestrator ./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana indexes
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana indexes
 ```
 
 ## Environment Variables
@@ -112,7 +112,7 @@ VDS_QUICKWIT_INDEX=otel-logs-v0_7
 Check connectivity to Grafana and Quickwit datasource:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana health
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana health
 ```
 
 **Output:**
@@ -134,10 +134,10 @@ List available Grafana datasources:
 
 ```bash
 # List Quickwit datasources only (default)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana datasources
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana datasources
 
 # List all datasources
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana datasources --no-quickwit-only
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana datasources --no-quickwit-only
 ```
 
 ### List Indexes
@@ -145,7 +145,7 @@ List available Grafana datasources:
 List available Quickwit indexes:
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana indexes
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana indexes
 ```
 
 ### Show Index Fields
@@ -153,7 +153,7 @@ List available Quickwit indexes:
 Inspect fields in an index (via document sampling):
 
 ```bash
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana fields --index otel-logs-v0_7
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana fields --index otel-logs-v0_7
 ```
 
 ### Search Logs (Quickwit REST API)
@@ -162,18 +162,18 @@ Search logs using Quickwit's native query syntax:
 
 ```bash
 # Search all logs in last hour
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana search --index otel-logs-v0_7 --query "*" --since 1h
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana search --index otel-logs-v0_7 --query "*" --since 1h
 
 # Search for errors
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana search --index otel-logs-v0_7 --query "severity_text:ERROR" --limit 50
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana search --index otel-logs-v0_7 --query "severity_text:ERROR" --limit 50
 
 # Search with time range (Unix timestamps)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana search --query "service_name:api-gateway" --from 1705320000 --to 1705323600
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana search --query "service_name:api-gateway" --from 1705320000 --to 1705323600
 
 # Search with various time units
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana search --query "level:ERROR" --since 30m   # last 30 minutes
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana search --query "level:ERROR" --since 1d    # last day
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana search --query "level:ERROR" --since 1w    # last week
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana search --query "level:ERROR" --since 30m   # last 30 minutes
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana search --query "level:ERROR" --since 1d    # last day
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana search --query "level:ERROR" --since 1w    # last week
 ```
 
 **Time duration units:** `s` (seconds), `m` (minutes), `h` (hours), `d` (days), `w` (weeks)
@@ -184,26 +184,26 @@ Search using Elasticsearch-compatible Query DSL:
 
 ```bash
 # Simple match query
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana es-search --query '{"query": {"match": {"severity_text": "ERROR"}}}'
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana es-search --query '{"query": {"match": {"severity_text": "ERROR"}}}'
 
 # Query with size
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana es-search --query '{"query": {"bool": {"must": [{"match": {"service_name": "api"}}]}}}' --size 100
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana es-search --query '{"query": {"bool": {"must": [{"match": {"service_name": "api"}}]}}}' --size 100
 
 # Query from file
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana es-search --query-file query.json --size 100
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana es-search --query-file query.json --size 100
 ```
 
 ### Global Options
 
 ```bash
 # JSON-only mode (clean output for piping)
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana --json-only search --index otel-logs-v0_7 --query "*"
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana --json-only search --index otel-logs-v0_7 --query "*"
 
 # Override datasource
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana --datasource my-other-datasource search --query "*"
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana --datasource my-other-datasource search --query "*"
 
 # Show version
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana --version
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana --version
 ```
 
 ## VDS CLI Integration
@@ -212,46 +212,46 @@ Access Grafana Orchestrator through the unified VDS CLI:
 
 ```bash
 # Health check
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana -- health
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana -- health
 
 # List datasources
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana -- datasources
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana -- datasources
 
 # List indexes
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana -- indexes
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana -- indexes
 
 # Show fields
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana -- fields --index otel-logs-v0_7
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana -- fields --index otel-logs-v0_7
 
 # Search logs
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana -- search --index otel-logs-v0_7 --query "severity_text:ERROR" --since 1h
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana -- search --index otel-logs-v0_7 --query "severity_text:ERROR" --since 1h
 
 # ES-compatible search
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana -- es-search --query '{"query": {"match": {"severity_text": "ERROR"}}}'
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana -- es-search --query '{"query": {"match": {"severity_text": "ERROR"}}}'
 
 # JSON-only mode
-./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana -- --json-only search --query "*"
+uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana -- --json-only search --query "*"
 ```
 
 > **Note**: Use `--` to separate vds-cli options from grafana subcommand options.
 
 ## Audit Correlation Integration (Phase 68c)
 
-For audit-run diagnostics correlation, use `./scripts/worktree_uv.sh run --project vds_cli vds-cli audit doctor correlation` first to generate
+For audit-run diagnostics correlation, use `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli audit doctor correlation` first to generate
 deterministic command templates, then execute the emitted Grafana command.
 
 ```bash
 # Generate templates and preflight checks from audit orchestrator
-./scripts/worktree_uv.sh run --project audit_orchestrator \
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli audit --json-only doctor correlation \
+uv run --directory ~/.claude/vds-scripts --package audit_orchestrator \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli audit --json-only doctor correlation \
   --since 30m \
   --service "<SERVICE_NAME>" \
   --audit-id "<THREAD_OR_REQUEST_ID>" \
   --run-health
 
 # Direct Grafana command shape generated by doctor correlation
-./scripts/worktree_uv.sh run --project grafana_orchestrator \
-  ./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana --json-only search \
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator \
+  uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana --json-only search \
   --query "(service_name:\"<SERVICE_NAME>\" OR service.name:\"<SERVICE_NAME>\") AND (severity_text:ERROR OR severity_text:FATAL OR severity_text:CRITICAL) AND (audit_id:\"<THREAD_OR_REQUEST_ID>\" OR request_id:\"<THREAD_OR_REQUEST_ID>\" OR trace_id:\"<THREAD_OR_REQUEST_ID>\")" \
   --since 30m \
   --limit 200
@@ -454,7 +454,7 @@ curl -I http://10.207.58.64:8485/api/health
 **Solutions:**
 1. List available datasources:
    ```bash
-   ./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana datasources
+   uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana datasources
    ```
 
 2. Check `VDS_GRAFANA_DATASOURCE_UID` matches an existing datasource
@@ -504,17 +504,17 @@ curl -I http://10.207.58.64:8485/api/health
 **Solutions:**
 1. Verify index name is correct:
    ```bash
-   ./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana indexes
+   uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana indexes
    ```
 2. Check time range - data may be outside the search window
 3. Verify query syntax:
    ```bash
    # Simple wildcard to test
-   ./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana search --index otel-logs-v0_7 --query "*" --limit 1
+   uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana search --index otel-logs-v0_7 --query "*" --limit 1
    ```
 4. Check field names:
    ```bash
-   ./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana fields --index otel-logs-v0_7
+   uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana fields --index otel-logs-v0_7
    ```
 
 ## Development
@@ -525,35 +525,35 @@ curl -I http://10.207.58.64:8485/api/health
 cd WHO-project/vds-scripts/grafana_orchestrator
 
 # Run all tests
-./scripts/worktree_uv.sh run --project grafana_orchestrator pytest
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator pytest
 
 # Run with coverage
-./scripts/worktree_uv.sh run --project grafana_orchestrator pytest --cov
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator pytest --cov
 
 # Run specific test file
-./scripts/worktree_uv.sh run --project grafana_orchestrator pytest tests/test_client.py
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator pytest tests/test_client.py
 
 # Run verification tests (requires real credentials)
-./scripts/worktree_uv.sh run --project grafana_orchestrator pytest -m verification
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator pytest -m verification
 ```
 
 ### Linting
 
 ```bash
 # Check code style
-./scripts/worktree_uv.sh run --project grafana_orchestrator ruff check .
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator ruff check .
 
 # Auto-fix issues
-./scripts/worktree_uv.sh run --project grafana_orchestrator ruff check --fix .
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator ruff check --fix .
 
 # Format code
-./scripts/worktree_uv.sh run --project grafana_orchestrator ruff format .
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator ruff format .
 ```
 
 ### Type Checking
 
 ```bash
-./scripts/worktree_uv.sh run --project grafana_orchestrator mypy src/vds_grafana_orchestrator
+uv run --directory ~/.claude/vds-scripts --package grafana_orchestrator mypy src/vds_grafana_orchestrator
 ```
 
 ## Related Documentation

package/skills/vds-skill/runtime/grafana_orchestrator/src/vds_grafana_orchestrator/cli.py

@@ -8,8 +8,8 @@ Usage:
     uv run vds-grafana search --index "otel-logs-v0_7" --query "level:ERROR"
 
     # Via vds-cli router
-    ./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana -- health
-    ./scripts/worktree_uv.sh run --project vds_cli vds-cli grafana -- search --index "otel-logs-v0_7"
+    uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana -- health
+    uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli grafana -- search --index "otel-logs-v0_7"
 
     # JSON-only mode (clean JSON output, no headers/decoration)
     uv run vds-grafana --json search --index "otel-logs-v0_7"