@ngocsangairvds/vsaf 4.1.12 → 4.1.15

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 (141) hide show
  1. package/package.json +1 -1
  2. package/skills/vds-skill/install-deps.mjs +6 -6
  3. package/skills/vds-skill/runtime/AGENTS.md +10 -10
  4. package/skills/vds-skill/runtime/AGENTS.vi.md +6 -6
  5. package/skills/vds-skill/runtime/README.md +3 -3
  6. package/skills/vds-skill/runtime/bitbucket_orchestrator/BITBUCKET_API_PRACTICES.md +1 -1
  7. package/skills/vds-skill/runtime/bitbucket_orchestrator/FEATURES.md +75 -75
  8. package/skills/vds-skill/runtime/bitbucket_orchestrator/README.md +102 -102
  9. package/skills/vds-skill/runtime/brd_orchestrator/README.md +2 -2
  10. package/skills/vds-skill/runtime/confluence_orchestrator/README.md +97 -97
  11. package/skills/vds-skill/runtime/confluence_orchestrator/SYNC_SCRIPTS.md +12 -12
  12. package/skills/vds-skill/runtime/confluence_orchestrator/SYNC_STANDARDIZATION.md +6 -6
  13. package/skills/vds-skill/runtime/confluence_orchestrator/src/confluence_orchestrator/config.py +1 -1
  14. package/skills/vds-skill/runtime/diagram_generator/README.md +5 -5
  15. package/skills/vds-skill/runtime/docker/ROLLBACK.md +1 -1
  16. package/skills/vds-skill/runtime/docs/README.md +30 -30
  17. package/skills/vds-skill/runtime/docs/agents/explanation/runtime-verification-and-gap-reporting.md +4 -4
  18. package/skills/vds-skill/runtime/docs/agents/how-to/02-using-vds-ai-memory.md +1 -1
  19. package/skills/vds-skill/runtime/docs/agents/how-to/apply-phase3-migration.md +2 -2
  20. package/skills/vds-skill/runtime/docs/agents/how-to/first-audit-run.md +1 -1
  21. package/skills/vds-skill/runtime/docs/agents/how-to/install-and-bootstrap-who-scripts-and-skills.md +14 -14
  22. package/skills/vds-skill/runtime/docs/agents/how-to/orchestrator-workflows/analytics-pipeline-workflow.md +9 -9
  23. package/skills/vds-skill/runtime/docs/agents/how-to/orchestrator-workflows/code-quality-gate-workflow.md +5 -5
  24. package/skills/vds-skill/runtime/docs/agents/how-to/orchestrator-workflows/confluence-bitbucket-sync-workflow.md +9 -9
  25. package/skills/vds-skill/runtime/docs/agents/how-to/orchestrator-workflows/document-delivery-workflow.md +3 -3
  26. package/skills/vds-skill/runtime/docs/agents/how-to/orchestrator-workflows/memory-progress-workflow.md +9 -9
  27. package/skills/vds-skill/runtime/docs/agents/how-to/orchestrator-workflows/research-spec-audit-workflow.md +8 -8
  28. package/skills/vds-skill/runtime/docs/agents/how-to/phase131-all-project-preparation.md +13 -13
  29. package/skills/vds-skill/runtime/docs/agents/how-to/phase131-bounded-parallel-analysis.md +6 -6
  30. package/skills/vds-skill/runtime/docs/agents/how-to/phase131-confluence-upload-recovery.md +4 -4
  31. package/skills/vds-skill/runtime/docs/agents/how-to/run-ecosystem-daily-report.md +8 -8
  32. package/skills/vds-skill/runtime/docs/agents/reference/audit-triage-playbook.md +9 -9
  33. package/skills/vds-skill/runtime/docs/agents/reference/cli-commands.md +33 -33
  34. package/skills/vds-skill/runtime/docs/agents/reference/cli-help-matrix.md +6 -6
  35. package/skills/vds-skill/runtime/docs/agents/reference/ecosystem-daily-report.md +3 -3
  36. package/skills/vds-skill/runtime/docs/agents/reference/portable-paths-and-config.md +0 -0
  37. package/skills/vds-skill/runtime/docs/agents/reference/portable-paths-validation-matrix.md +2 -2
  38. package/skills/vds-skill/runtime/docs/agents/reference/vds-ai-memory-api.md +1 -1
  39. package/skills/vds-skill/runtime/docs/agents/tutorials/who-skills-and-scripts-onboarding.md +4 -4
  40. package/skills/vds-skill/runtime/docs/agents/tutorials/zero-to-productive-developer.md +14 -14
  41. package/skills/vds-skill/runtime/docs/vi/agents/explanation/runtime-verification-and-gap-reporting.md +4 -4
  42. package/skills/vds-skill/runtime/docs/vi/agents/how-to/02-using-vds-ai-memory.md +1 -1
  43. package/skills/vds-skill/runtime/docs/vi/agents/how-to/first-audit-run.md +1 -1
  44. package/skills/vds-skill/runtime/docs/vi/agents/how-to/install-and-bootstrap-who-scripts-and-skills.md +10 -10
  45. package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/analytics-pipeline-workflow.md +9 -9
  46. package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/code-quality-gate-workflow.md +5 -5
  47. package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/confluence-bitbucket-sync-workflow.md +9 -9
  48. package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/document-delivery-workflow.md +3 -3
  49. package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/memory-progress-workflow.md +9 -9
  50. package/skills/vds-skill/runtime/docs/vi/agents/how-to/orchestrator-workflows/research-spec-audit-workflow.md +8 -8
  51. package/skills/vds-skill/runtime/docs/vi/agents/how-to/phase131-all-project-preparation.md +13 -13
  52. package/skills/vds-skill/runtime/docs/vi/agents/how-to/phase131-bounded-parallel-analysis.md +6 -6
  53. package/skills/vds-skill/runtime/docs/vi/agents/how-to/phase131-confluence-upload-recovery.md +4 -4
  54. package/skills/vds-skill/runtime/docs/vi/agents/how-to/tips-and-tricks.md +1 -1
  55. package/skills/vds-skill/runtime/docs/vi/agents/reference/audit-triage-playbook.md +9 -9
  56. package/skills/vds-skill/runtime/docs/vi/agents/reference/cli-commands.md +33 -33
  57. package/skills/vds-skill/runtime/docs/vi/agents/reference/cli-help-matrix.md +6 -6
  58. package/skills/vds-skill/runtime/docs/vi/agents/reference/portable-paths-and-config.md +3 -3
  59. package/skills/vds-skill/runtime/docs/vi/agents/reference/portable-paths-validation-matrix.md +2 -2
  60. package/skills/vds-skill/runtime/docs/vi/agents/reference/vds-ai-memory-api.md +1 -1
  61. package/skills/vds-skill/runtime/docs/vi/agents/tutorials/who-skills-and-scripts-onboarding.md +4 -4
  62. package/skills/vds-skill/runtime/docs/vi/agents/tutorials/zero-to-productive-developer.md +4 -4
  63. package/skills/vds-skill/runtime/elastic_orchestrator/README.md +31 -31
  64. package/skills/vds-skill/runtime/elastic_orchestrator/src/vds_elastic_orchestrator/cli.py +2 -2
  65. package/skills/vds-skill/runtime/excel_orchestrator/README.md +22 -22
  66. package/skills/vds-skill/runtime/git_orchestrator/README.md +46 -46
  67. package/skills/vds-skill/runtime/google_sheets_orchestrator/README.md +15 -15
  68. package/skills/vds-skill/runtime/grafana_orchestrator/README.md +44 -44
  69. package/skills/vds-skill/runtime/grafana_orchestrator/src/vds_grafana_orchestrator/cli.py +2 -2
  70. package/skills/vds-skill/runtime/jira_orchestrator/README.md +119 -119
  71. package/skills/vds-skill/runtime/jira_viettelmoney_orchestrator/README.md +117 -117
  72. package/skills/vds-skill/runtime/markdown_orchestrator/README.md +9 -9
  73. package/skills/vds-skill/runtime/markdown_orchestrator/pyproject.toml +1 -1
  74. package/skills/vds-skill/runtime/pdf_orchestrator/README.md +4 -4
  75. package/skills/vds-skill/runtime/pdf_orchestrator/pyproject.toml +1 -1
  76. package/skills/vds-skill/runtime/pyproject.toml +3 -3
  77. package/skills/vds-skill/runtime/scripts/README.md +2 -2
  78. package/skills/vds-skill/runtime/scripts/move_audit_artifact_pages.py +1 -1
  79. package/skills/vds-skill/runtime/scripts/move_audit_artifact_pages_rest.py +1 -1
  80. package/skills/vds-skill/runtime/scripts/move_wrong_dept_pages.py +1 -1
  81. package/skills/vds-skill/runtime/scripts/uv-workspace-alignment-verification-2026-03-25.md +1 -1
  82. package/skills/vds-skill/runtime/sonarqube_orchestrator/IMPLEMENTATION_AUDIT.md +1 -1
  83. package/skills/vds-skill/runtime/sonarqube_orchestrator/README.md +11 -11
  84. package/skills/vds-skill/runtime/sonarqube_orchestrator/pyproject.toml +1 -1
  85. package/skills/vds-skill/runtime/sonarqube_orchestrator/src/vds_sonarqube_orchestrator/cli.py +3 -3
  86. package/skills/vds-skill/runtime/vds_agent_core/docs/embedding.md +3 -3
  87. package/skills/vds-skill/runtime/vds_agent_core/pyproject.toml +1 -1
  88. package/skills/vds-skill/runtime/vds_cli/README.md +48 -48
  89. package/skills/vds-skill/runtime/vds_cli/pyproject.toml +1 -1
  90. package/skills/vds-skill/runtime/vds_cli/src/vds_cli/cli.py +1 -1
  91. package/skills/vds-skill/runtime/vds_cli/src/vds_cli/confluence_sync.py +3 -3
  92. package/skills/vds-skill/runtime/diagram_generator/ci_validate.sh +0 -16
  93. package/skills/vds-skill/runtime/pdf_orchestrator/scripts/setup_team.sh +0 -324
  94. package/skills/vds-skill/runtime/scripts/audit-cli-patterns.sh +0 -135
  95. package/skills/vds-skill/runtime/scripts/audit-dashboard.sh +0 -525
  96. package/skills/vds-skill/runtime/scripts/backup.sh +0 -123
  97. package/skills/vds-skill/runtime/scripts/bootstrap_uv.sh +0 -69
  98. package/skills/vds-skill/runtime/scripts/ci/assert_no_openspace_commits.sh +0 -37
  99. package/skills/vds-skill/runtime/scripts/ci/verify_branch_protection.sh +0 -64
  100. package/skills/vds-skill/runtime/scripts/closure/phase1_check.sh +0 -483
  101. package/skills/vds-skill/runtime/scripts/closure/phase2_check.sh +0 -500
  102. package/skills/vds-skill/runtime/scripts/deploy-bootstrap.sh +0 -201
  103. package/skills/vds-skill/runtime/scripts/deployment/load_docker_images_offline.sh +0 -90
  104. package/skills/vds-skill/runtime/scripts/dev/cli_smoke.sh +0 -259
  105. package/skills/vds-skill/runtime/scripts/init-pgbouncer-userlist.sh +0 -154
  106. package/skills/vds-skill/runtime/scripts/openspace_bootstrap.sh +0 -56
  107. package/skills/vds-skill/runtime/scripts/openspace_common.sh +0 -75
  108. package/skills/vds-skill/runtime/scripts/openspace_doctor.sh +0 -61
  109. package/skills/vds-skill/runtime/scripts/openspace_sync_shadow.sh +0 -65
  110. package/skills/vds-skill/runtime/scripts/phase7-baseline.sh +0 -77
  111. package/skills/vds-skill/runtime/scripts/preflight/env_check.sh +0 -102
  112. package/skills/vds-skill/runtime/scripts/repair_autopay_reports.sh +0 -173
  113. package/skills/vds-skill/runtime/scripts/rollback_drill.sh +0 -659
  114. package/skills/vds-skill/runtime/scripts/run-audit-in-tmux.sh +0 -286
  115. package/skills/vds-skill/runtime/scripts/run-department-audit.sh +0 -495
  116. package/skills/vds-skill/runtime/scripts/run-project-audit.sh +0 -267
  117. package/skills/vds-skill/runtime/scripts/smoke-test-deploy.sh +0 -137
  118. package/skills/vds-skill/runtime/scripts/target-state-automation/confluence_sync_coordinator.sh +0 -27
  119. package/skills/vds-skill/runtime/scripts/target-state-automation/coordination.sh +0 -114
  120. package/skills/vds-skill/runtime/scripts/target-state-automation/diagram_coordinator.sh +0 -25
  121. package/skills/vds-skill/runtime/scripts/target-state-automation/docs_root.sh +0 -22
  122. package/skills/vds-skill/runtime/scripts/target-state-automation/generate_diagrams.sh +0 -22
  123. package/skills/vds-skill/runtime/scripts/target-state-automation/markdown_coordinator.sh +0 -25
  124. package/skills/vds-skill/runtime/scripts/target-state-automation/progress_dashboard.sh +0 -17
  125. package/skills/vds-skill/runtime/scripts/target-state-automation/schema_coordinator.sh +0 -25
  126. package/skills/vds-skill/runtime/scripts/target-state-automation/sync_confluence.sh +0 -30
  127. package/skills/vds-skill/runtime/scripts/target-state-automation/update_dependencies.sh +0 -19
  128. package/skills/vds-skill/runtime/scripts/target-state-automation/validate_links.sh +0 -86
  129. package/skills/vds-skill/runtime/scripts/target-state-automation/validate_markdown.sh +0 -52
  130. package/skills/vds-skill/runtime/scripts/target-state-automation/validate_schemas.sh +0 -26
  131. package/skills/vds-skill/runtime/scripts/target-state-automation/validate_structure.sh +0 -98
  132. package/skills/vds-skill/runtime/scripts/validate-cli-standardization.sh +0 -188
  133. package/skills/vds-skill/runtime/scripts/vds_sh_helpers.sh +0 -180
  134. package/skills/vds-skill/runtime/scripts/verification/phase2_portable_paths_ubuntu_docker.sh +0 -26
  135. package/skills/vds-skill/runtime/scripts/verify-memory-cli-e2e.sh +0 -598
  136. package/skills/vds-skill/runtime/scripts/verify-worktree-features.sh +0 -306
  137. package/skills/vds-skill/runtime/scripts/worktree-add.sh +0 -128
  138. package/skills/vds-skill/runtime/scripts/worktree-remove.sh +0 -112
  139. package/skills/vds-skill/runtime/scripts/worktree_compose.sh +0 -269
  140. package/skills/vds-skill/runtime/scripts/worktree_uv.sh +0 -77
  141. package/skills/vds-skill/runtime/sonarqube_orchestrator/scripts/ensure_symlink.sh +0 -38
@@ -10,7 +10,7 @@ This orchestrator provides CLI and programmatic access to the VDS Elasticsearch
10
10
 
11
11
  ```
12
12
  ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
13
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic CLI │ --> │ Kibana Console │ --> │ Elasticsearch │
13
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic CLI │ --> │ Kibana Console │ --> │ Elasticsearch │
14
14
  │ or Python API │ │ Proxy API │ │ Cluster (8.x) │
15
15
  └──────────────────┘ └──────────────────┘ └──────────────────┘
16
16
  │ │
@@ -74,76 +74,76 @@ VDS_ELASTIC_DEFAULT_SIZE="10" # Default result size
74
74
 
75
75
  ```bash
76
76
  # JSON-only mode (compact JSON, no decoration - ideal for scripting)
77
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic --json-only search --index "logs-*"
78
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic --json-only count
77
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic --json-only search --index "logs-*"
78
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic --json-only count
79
79
 
80
80
  # Structured logs to stderr
81
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic --structured-logs search --index "logs-*"
81
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic --structured-logs search --index "logs-*"
82
82
 
83
83
  # Show version
84
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic --version
84
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic --version
85
85
  ```
86
86
 
87
87
  ### Via Direct Script
88
88
 
89
89
  ```bash
90
90
  # Test connectivity
91
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic ping
91
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic ping
92
92
 
93
93
  # Check Kibana status
94
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic kibana-status
94
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic kibana-status
95
95
 
96
96
  # Show current user and roles
97
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic user-info
97
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic user-info
98
98
 
99
99
  # Search documents
100
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic search --index "logs-*" --size 5
101
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic search --query '{"match": {"message": "error"}}'
102
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic search --qs "level:ERROR AND timeout"
100
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic search --index "logs-*" --size 5
101
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic search --query '{"match": {"message": "error"}}'
102
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic search --qs "level:ERROR AND timeout"
103
103
 
104
104
  # Search with time range
105
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic search \
105
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic search \
106
106
  --index "logs-*" \
107
107
  --start "2025-01-15T00:00:00Z" \
108
108
  --end "2025-01-16T00:00:00Z" \
109
109
  --time-field "@timestamp"
110
110
 
111
111
  # Count documents
112
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic count --index "logs-*"
113
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic count --qs "level:ERROR"
112
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic count --index "logs-*"
113
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic count --qs "level:ERROR"
114
114
 
115
115
  # Export large datasets (scroll-based)
116
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic export --index "logs-*" -o export.ndjson
117
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic export --qs "level:ERROR" --max 10000 -o errors.ndjson
118
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic export --index "logs-*" --source-only -o data.ndjson
116
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic export --index "logs-*" -o export.ndjson
117
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic export --qs "level:ERROR" --max 10000 -o errors.ndjson
118
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic export --index "logs-*" --source-only -o data.ndjson
119
119
  ```
120
120
 
121
121
  ### Via vds-cli Router
122
122
 
123
123
  ```bash
124
124
  # After vds-cli integration
125
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic -- ping
126
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic -- search --index "logs-*"
127
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic -- count
125
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic -- ping
126
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic -- search --index "logs-*"
127
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic -- count
128
128
  ```
129
129
 
130
130
  ## Audit Correlation Integration (Phase 68c)
131
131
 
132
- Use `./scripts/worktree_uv.sh run --project vds_cli vds-cli audit doctor correlation` to generate deterministic Elastic/Kibana query templates
132
+ Use `uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli audit doctor correlation` to generate deterministic Elastic/Kibana query templates
133
133
  for one audit run, then execute the emitted `vds-elastic` command.
134
134
 
135
135
  ```bash
136
136
  # Generate runtime + Grafana + Elastic correlation templates
137
- ./scripts/worktree_uv.sh run --project audit_orchestrator \
138
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli audit --json-only doctor correlation \
137
+ uv run --directory ~/.claude/vds-scripts --package audit_orchestrator \
138
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli audit --json-only doctor correlation \
139
139
  --since 30m \
140
140
  --service "<SERVICE_NAME>" \
141
141
  --audit-id "<THREAD_OR_REQUEST_ID>" \
142
142
  --run-health
143
143
 
144
144
  # Direct Elastic command shape generated by doctor correlation
145
- ./scripts/worktree_uv.sh run --project elastic_orchestrator \
146
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic --json-only search \
145
+ uv run --directory ~/.claude/vds-scripts --package elastic_orchestrator \
146
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic --json-only search \
147
147
  --index "*" \
148
148
  --qs "(service_name:\"<SERVICE_NAME>\" OR service.name:\"<SERVICE_NAME>\") AND (level:ERROR OR log.level:ERROR OR severity_text:ERROR) AND (audit_id:\"<THREAD_OR_REQUEST_ID>\" OR request_id:\"<THREAD_OR_REQUEST_ID>\" OR trace_id:\"<THREAD_OR_REQUEST_ID>\" OR trace.id:\"<THREAD_OR_REQUEST_ID>\")" \
149
149
  --start "<START_ISO_UTC>" \
@@ -160,16 +160,16 @@ These commands may fail with 403 for users with `viewer` role:
160
160
 
161
161
  ```bash
162
162
  # Cluster info
163
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic info
163
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic info
164
164
 
165
165
  # Cluster health
166
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic health
166
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic health
167
167
 
168
168
  # List indices
169
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic indices --pattern "logs-*"
169
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic indices --pattern "logs-*"
170
170
 
171
171
  # List aliases
172
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic aliases --pattern "logs*"
172
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic aliases --pattern "logs*"
173
173
  ```
174
174
 
175
175
  ## Python API Usage
@@ -431,7 +431,7 @@ The VDS Kibana uses self-signed certificates. By default, SSL verification is di
431
431
  For `viewer` role users, certain operations like cluster health and indices listing are not available. Use `user-info` to check your current roles:
432
432
 
433
433
  ```bash
434
- uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic user-info
434
+ uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic user-info
435
435
  ```
436
436
 
437
437
  ### Timeout Errors
@@ -439,7 +439,7 @@ uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic user-info
439
439
  For large queries, increase the timeout:
440
440
 
441
441
  ```bash
442
- VDS_ELASTIC_REQUEST_TIMEOUT="60" uv run ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic search --index "logs-*" --size 1000
442
+ VDS_ELASTIC_REQUEST_TIMEOUT="60" uv run uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic search --index "logs-*" --size 1000
443
443
  ```
444
444
 
445
445
  ## Related Documentation
@@ -8,8 +8,8 @@ Usage:
8
8
  uv run vds-elastic search --index "logs-*" --size 10
9
9
 
10
10
  # Via vds-cli router
11
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic -- ping
12
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli elastic -- search --index "logs-*"
11
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic -- ping
12
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli elastic -- search --index "logs-*"
13
13
 
14
14
  # JSON-only mode (clean JSON output, no headers/decoration)
15
15
  uv run vds-elastic --json search --index "logs-*"
@@ -26,52 +26,52 @@ uv sync --project excel_orchestrator
26
26
 
27
27
  ```bash
28
28
  # List all sheets
29
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- sheet list --file data.xlsx
29
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- sheet list --file data.xlsx
30
30
 
31
31
  # Get cell value
32
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- cell get --file data.xlsx --sheet Sheet1 --cell A1
32
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- cell get --file data.xlsx --sheet Sheet1 --cell A1
33
33
 
34
34
  # Set cell value
35
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- cell set --file data.xlsx --sheet Sheet1 --cell A1 --value "Hello"
35
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- cell set --file data.xlsx --sheet Sheet1 --cell A1 --value "Hello"
36
36
 
37
37
  # Read range
38
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- range read --file data.xlsx --sheet Sheet1 --range A1:C10
38
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- range read --file data.xlsx --sheet Sheet1 --range A1:C10
39
39
 
40
40
  # Create sheet
41
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- sheet create --file data.xlsx --name "NewSheet"
41
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- sheet create --file data.xlsx --name "NewSheet"
42
42
 
43
43
  # Delete sheet
44
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- sheet delete --file data.xlsx --name "OldSheet"
44
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- sheet delete --file data.xlsx --name "OldSheet"
45
45
 
46
46
  # Rename sheet
47
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- sheet rename --file data.xlsx --old "OldName" --new "NewName"
47
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- sheet rename --file data.xlsx --old "OldName" --new "NewName"
48
48
 
49
49
  # Copy sheet
50
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- sheet copy --file data.xlsx --source "Sheet1" --target "CopySheet"
50
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- sheet copy --file data.xlsx --source "Sheet1" --target "CopySheet"
51
51
 
52
52
  # Apply formatting
53
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- format apply --file data.xlsx --sheet Sheet1 --cell A1 --bold --fill FFFF00
53
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- format apply --file data.xlsx --sheet Sheet1 --cell A1 --bold --fill FFFF00
54
54
 
55
55
  # Convert to JSON
56
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- convert --file data.xlsx --output data.json --format json
56
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- convert --file data.xlsx --output data.json --format json
57
57
 
58
58
  # Convert to CSV
59
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- convert --file data.xlsx --output data.csv --format csv
59
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- convert --file data.xlsx --output data.csv --format csv
60
60
 
61
61
  # Validate file
62
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- validate --file data.xlsx
62
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- validate --file data.xlsx
63
63
 
64
64
  # Generate target-state status workbook (Insurance defaults)
65
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- target-state-status
65
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- target-state-status
66
66
 
67
67
  # Generate VDS-owned ULNC aligned workbook (strict reference presentation)
68
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- ulnc-align \
68
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- ulnc-align \
69
69
  --strict-presentation \
70
70
  --coverage-policy warn \
71
71
  --json
72
72
 
73
73
  # Generate target-state status with custom paths
74
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- target-state-status \
74
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- target-state-status \
75
75
  --arch-root WHO-project/insurance-document/projects/INSURANCE/analysis/target-state/architecture \
76
76
  --output WHO-project/insurance-document/projects/INSURANCE/analysis/target-state/target-state-status.xlsx \
77
77
  --brd-report WHO-project/vds-scripts/scripts/brd_coverage_report.json
@@ -83,22 +83,22 @@ uv sync --project excel_orchestrator
83
83
 
84
84
  ```bash
85
85
  cd vds-scripts/excel_orchestrator
86
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel --help
86
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel --help
87
87
 
88
88
  # List sheets
89
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel sheet list data.xlsx
89
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel sheet list data.xlsx
90
90
 
91
91
  # Get cell
92
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel cell get data.xlsx --sheet Sheet1 --cell A1
92
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel cell get data.xlsx --sheet Sheet1 --cell A1
93
93
 
94
94
  # Create sheet
95
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel sheet create data.xlsx --name "NewSheet"
95
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel sheet create data.xlsx --name "NewSheet"
96
96
 
97
97
  # Generate target-state status workbook (Insurance defaults)
98
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel target-state-status
98
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel target-state-status
99
99
 
100
100
  # Generate VDS-owned ULNC aligned workbook
101
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel ulnc-align --strict-presentation --json
101
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel ulnc-align --strict-presentation --json
102
102
  ```
103
103
 
104
104
  ## API Usage
@@ -280,7 +280,7 @@ See the `examples/` directory for sample scripts demonstrating various use cases
280
280
  The Excel orchestrator is integrated with the unified VDS CLI. All commands are accessible via:
281
281
 
282
282
  ```bash
283
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli excel -- <command> [options]
283
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli excel -- <command> [options]
284
284
  ```
285
285
 
286
286
  ## License
@@ -19,15 +19,15 @@ The project uses [uv](https://docs.astral.sh/uv/) to manage Python environments.
19
19
  ```bash
20
20
  # Install and lock dependencies from the workspace root
21
21
  cd WHO-project/vds-scripts
22
- ./scripts/worktree_uv.sh sync --project git_orchestrator
22
+ uv sync --directory ~/.claude/vds-scripts --project git_orchestrator
23
23
 
24
24
  # Optional: run the CLI directly (or use unified vds-cli)
25
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git --help
26
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git --help
25
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git --help
26
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git --help
27
27
 
28
28
  # If vds-cli fails to import (ModuleNotFoundError: vds_cli),
29
29
  # reinstall vds_cli in non-editable mode:
30
- ./scripts/worktree_uv.sh sync --project vds_cli --no-editable
30
+ uv sync --directory ~/.claude/vds-scripts --project vds_cli --no-editable
31
31
 
32
32
  # Customize the manifest as needed
33
33
  cp repo-manifest.yaml repo-manifest.local.yaml
@@ -54,8 +54,8 @@ cd ../insurance-payment-service && git pull
54
54
 
55
55
  You simply run:
56
56
  ```bash
57
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git pull --match "*document-management"
58
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git pull --match "*payment*"
57
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git pull --match "*document-management"
58
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git pull --match "*payment*"
59
59
  ```
60
60
 
61
61
  All from a single location - no directory navigation required!
@@ -66,13 +66,13 @@ Filter by repository name using `--match` pattern:
66
66
 
67
67
  ```bash
68
68
  # Single repository by exact name
69
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git pull --match "document-management"
69
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git pull --match "document-management"
70
70
 
71
71
  # Single repository by pattern
72
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git status --match "*payment-service"
72
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git status --match "*payment-service"
73
73
 
74
74
  # Single repository checkout with tracking
75
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git checkout origin/release --match "*document-management"
75
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git checkout origin/release --match "*document-management"
76
76
  ```
77
77
 
78
78
  ### Group Operations
@@ -81,72 +81,72 @@ Filter by project, pattern, or tags:
81
81
 
82
82
  ```bash
83
83
  # All repositories in a project
84
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git pull --project insurance
84
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git pull --project insurance
85
85
 
86
86
  # Multiple repositories matching a pattern
87
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git pull --match "*notification*"
87
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git pull --match "*notification*"
88
88
 
89
89
  # Combined filters (project + pattern)
90
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git status --project insurance --match "*payment*"
90
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git status --project insurance --match "*payment*"
91
91
  ```
92
92
 
93
93
  ### Common Operations
94
94
 
95
95
  ```bash
96
96
  # Fast-forward every repo defined in the manifest
97
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git pull
97
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git pull
98
98
 
99
99
  # Preview the repo list without touching git
100
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git pull --match "*notification*" --dry-run
100
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git pull --match "*notification*" --dry-run
101
101
 
102
102
  # Fetch a tagged subset and emit JSON logs + reports
103
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git fetch --tag frontend --json-log
103
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git fetch --tag frontend --json-log
104
104
 
105
105
  # Show status deltas for EKYC services
106
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git status --project ekyc
106
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git status --project ekyc
107
107
 
108
108
  # Clone missing LEP repositories (retry falls back to default branch)
109
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git clone --project lep
109
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git clone --project lep
110
110
 
111
111
  # List repositories matching a pattern
112
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git list --match "*notification*"
112
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git list --match "*notification*"
113
113
 
114
114
  # Branch operations
115
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git branch list --project insurance
116
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git branch create --name feature/new-feature --project lep
115
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git branch list --project insurance
116
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git branch create --name feature/new-feature --project lep
117
117
 
118
118
  # Checkout operations (use origin/branch for automatic tracking)
119
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git checkout origin/release --project insurance
120
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git checkout feature/new --create --project lep
119
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git checkout origin/release --project insurance
120
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git checkout feature/new --create --project lep
121
121
 
122
122
  # Stage files
123
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git add --all --project insurance
124
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git add src/main.py README.md --project lep
123
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git add --all --project insurance
124
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git add src/main.py README.md --project lep
125
125
 
126
126
  # Commit changes
127
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git commit "Update documentation" --project insurance
127
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git commit "Update documentation" --project insurance
128
128
 
129
129
  # Push to remote
130
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git push --branch main --project insurance
130
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git push --branch main --project insurance
131
131
 
132
132
  # View commit history
133
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git log --limit 10 --oneline --project lep
133
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git log --limit 10 --oneline --project lep
134
134
 
135
135
  # Show differences
136
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git diff --staged --project insurance
137
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git diff src/main.py --project lep
136
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git diff --staged --project insurance
137
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git diff src/main.py --project lep
138
138
 
139
139
  # Stash operations
140
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git stash list --project insurance
141
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git stash save "WIP: feature work" --project lep
142
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git stash pop --project insurance
140
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git stash list --project insurance
141
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git stash save "WIP: feature work" --project lep
142
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git stash pop --project insurance
143
143
 
144
144
  # Tag operations
145
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git tag list --project insurance
146
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git tag create --name v1.0.0 --message "Release v1.0.0" --project lep
145
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git tag list --project insurance
146
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git tag create --name v1.0.0 --message "Release v1.0.0" --project lep
147
147
 
148
148
  # Remote operations
149
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git remote list --project insurance
149
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git remote list --project insurance
150
150
  ```
151
151
 
152
152
  Filter flags can be combined:
@@ -226,7 +226,7 @@ When Bitbucket throttles concurrent HTTP sessions, the orchestrator automaticall
226
226
 
227
227
  ## Integration with `vds-cli`
228
228
 
229
- The unified VDS CLI (`./scripts/worktree_uv.sh run --project vds_cli vds-cli git`) delegates all git operations to this
229
+ The unified VDS CLI (`uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git`) delegates all git operations to this
230
230
  orchestrator. The CLI automatically passes the default manifest and honours the `VDS_GIT_CONCURRENCY` environment
231
231
  variable when present. Set `VDS_GIT_CONCURRENCY_DEFAULT` to adjust the fallback concurrency, and
232
232
  `VDS_BITBUCKET_HTTP_BASE` if you need to target an alternate Bitbucket host.
@@ -235,18 +235,18 @@ Examples:
235
235
 
236
236
  ```bash
237
237
  # Individual repository operations (using --match)
238
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git pull --match "document-management"
239
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git status --match "*payment-service"
238
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git pull --match "document-management"
239
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git status --match "*payment-service"
240
240
 
241
241
  # Group operations (using --project, patterns, or tags)
242
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git pull --project lep --dry-run
243
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git status --project insurance
244
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git branch list --project ekyc
245
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git checkout origin/release --project lep
246
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git add --all --project insurance
247
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git commit "Update docs" --project lep
248
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git push --branch main --project insurance
249
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli git log --limit 10 --oneline --project ekyc
242
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git pull --project lep --dry-run
243
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git status --project insurance
244
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git branch list --project ekyc
245
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git checkout origin/release --project lep
246
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git add --all --project insurance
247
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git commit "Update docs" --project lep
248
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git push --branch main --project insurance
249
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli git log --limit 10 --oneline --project ekyc
250
250
  ```
251
251
 
252
252
  ## Hooks
@@ -12,7 +12,7 @@ VDS standalone orchestrator for Google Sheets automation. Use `vds-cli google-sh
12
12
 
13
13
  ```bash
14
14
  cd WHO-project/vds-scripts
15
- ./scripts/worktree_uv.sh sync --project google_sheets_orchestrator
15
+ uv sync --directory ~/.claude/vds-scripts --project google_sheets_orchestrator
16
16
  ```
17
17
 
18
18
  ## Authentication
@@ -24,7 +24,7 @@ cd WHO-project/vds-scripts
24
24
 
25
25
  CLI usage:
26
26
  ```bash
27
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets read --spreadsheet-url <url> --sheet-name Sheet1 \
27
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets read --spreadsheet-url <url> --sheet-name Sheet1 \
28
28
  --auth-method service_account --credentials-path "$HOME/.vds/google_credentials.json"
29
29
  ```
30
30
 
@@ -35,7 +35,7 @@ CLI usage:
35
35
 
36
36
  CLI usage:
37
37
  ```bash
38
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets read --spreadsheet-url <url> --sheet-name Sheet1 \
38
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets read --spreadsheet-url <url> --sheet-name Sheet1 \
39
39
  --auth-method oauth --oauth-credentials-path /path/to/shared-config/gspread_oauth.json
40
40
  ```
41
41
 
@@ -45,7 +45,7 @@ Set `VDS_GOOGLE_API_KEY` in the shared VDS env file, place the key under the sha
45
45
  or pass `--api-key`.
46
46
 
47
47
  ```bash
48
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets read --spreadsheet-url <url> --sheet-name Sheet1 \
48
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets read --spreadsheet-url <url> --sheet-name Sheet1 \
49
49
  --auth-method api_key --api-key "$VDS_GOOGLE_API_KEY"
50
50
  ```
51
51
 
@@ -98,7 +98,7 @@ vds-cli google-sheets --json-only read --spreadsheet-url <url> --sheet-name Shee
98
98
  ### List worksheets
99
99
 
100
100
  ```bash
101
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets list-worksheets --spreadsheet-url <url>
101
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets list-worksheets --spreadsheet-url <url>
102
102
 
103
103
  # JSON output
104
104
  vds-cli google-sheets --json-only list-worksheets --spreadsheet-url <url> | jq '.worksheets'
@@ -119,40 +119,40 @@ vds-cli google-sheets write --spreadsheet-url <url> --sheet-name Sheet1 --range
119
119
  ### Append rows
120
120
 
121
121
  ```bash
122
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets append --spreadsheet-url <url> --sheet-name Sheet1 \
122
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets append --spreadsheet-url <url> --sheet-name Sheet1 \
123
123
  --values-json '[["New","Row"]]'
124
124
  ```
125
125
 
126
126
  ### Update values (alias of write)
127
127
 
128
128
  ```bash
129
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets update --spreadsheet-url <url> --sheet-name Sheet1 --range A1:B2 \
129
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets update --spreadsheet-url <url> --sheet-name Sheet1 --range A1:B2 \
130
130
  --values-json '[["Updated","Values"]]'
131
131
  ```
132
132
 
133
133
  ### Clear range
134
134
 
135
135
  ```bash
136
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets clear --spreadsheet-url <url> --sheet-name Sheet1 --range A1:B10
136
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets clear --spreadsheet-url <url> --sheet-name Sheet1 --range A1:B10
137
137
  ```
138
138
 
139
139
  ### Create spreadsheet
140
140
 
141
141
  ```bash
142
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets create-spreadsheet --title "My New Spreadsheet"
142
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets create-spreadsheet --title "My New Spreadsheet"
143
143
  ```
144
144
 
145
145
  ### Create worksheet
146
146
 
147
147
  ```bash
148
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets create-worksheet --spreadsheet-url <url> --title "New Sheet" \
148
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets create-worksheet --spreadsheet-url <url> --title "New Sheet" \
149
149
  --rows 100 --cols 26
150
150
  ```
151
151
 
152
152
  ### Delete worksheet
153
153
 
154
154
  ```bash
155
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets delete-worksheet --spreadsheet-url <url> --sheet-name "Old Sheet"
155
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets delete-worksheet --spreadsheet-url <url> --sheet-name "Old Sheet"
156
156
  ```
157
157
 
158
158
  ### Export to file
@@ -185,7 +185,7 @@ vds-cli google-sheets --json-only read --spreadsheet-url <url> --sheet-name Shee
185
185
  Enable JSON logs for monitoring/debugging:
186
186
 
187
187
  ```bash
188
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets --structured-logs read --spreadsheet-url <url> 2> logs.json
188
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets --structured-logs read --spreadsheet-url <url> 2> logs.json
189
189
  ```
190
190
 
191
191
  ## VDS CLI Integration
@@ -193,12 +193,12 @@ Enable JSON logs for monitoring/debugging:
193
193
  Access via the unified `vds-cli` interface:
194
194
 
195
195
  ```bash
196
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets --help
197
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets read \
196
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets --help
197
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets read \
198
198
  --spreadsheet-url <url> --sheet-name Sheet1
199
199
 
200
200
  # Pass-through global options
201
- ./scripts/worktree_uv.sh run --project vds_cli vds-cli google-sheets -- --json-only read \
201
+ uv run --directory ~/.claude/vds-scripts --package vds_cli vds-cli google-sheets -- --json-only read \
202
202
  --spreadsheet-url <url> --sheet-name Sheet1 --range A1:F10
203
203
  ```
204
204